선택한 사용자에 대한 조기 액세스에서 Adobe Experience Platform Web SDK의 Offer decisioning을 사용할 수 있습니다. 일부 조직에서는 이 기능을 사용할 수 없습니다.
Adobe Experience Platform Web SDK 은 Offer Decisioning에서 관리되는 개인화된 오퍼를 제공하고 렌더링할 수 있습니다. offer decisioning UI(사용자 인터페이스) 또는 API를 사용하여 오퍼 및 기타 관련 개체를 만들 수 있습니다.
offer decisioning 작업 시 다음 용어를 이해하는 것이 중요합니다. 자세한 내용을 알고 추가 약관을 보려면 다음을 방문하십시오. Offer decisioning 용어집.
컨테이너: 용기는 서로 다른 문제를 분리하기 위한 격리 메커니즘입니다. 컨테이너 ID는 모든 저장소 API의 첫 번째 경로 요소입니다. 모든 의사 결정 개체는 컨테이너 내에 있습니다.
결정 범위: offer decisioning의 경우 결정 범위는 offer decisioning 서비스가 오퍼를 제안하는 데 사용할 활동 및 배치 ID가 포함된 JSON의 Base64로 인코딩된 문자열입니다.
결정 범위 JSON:
{
"activityId":"xcore:offer-activity:11cfb1fa93381aca",
"placementId":"xcore:offer-placement:1175009612b0100c"
}
결정 범위 Base64 인코딩 문자열:
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
다음에서 결정 범위 값을 복사할 수 있습니다. 활동 개요 UI의 페이지.
데이터스트림: 자세한 내용은 다음을 참조하십시오. 데이터스트림 설명서를 참조하십시오.
신원: 자세한 내용은 이 설명서 의 개요를 참조하십시오 Platform Web SDK에서 ID 서비스 사용.
offer decisioning을 활성화하려면 다음 단계를 수행하십시오.
에서 Adobe Experience Platform 활성화됨 데이터스트림 및 "Offer decisioning" 상자를 선택합니다.
다음 지침을 따르십시오 sdk 설치 (SDK는 독립 실행형 또는 UI를 통해 설치할 수 있습니다. 다음을 참조하십시오. 태그 빠른 시작 안내서)를 참조하십시오.
SDK 구성 offer decisioning. 추가적인 Offer decisioning 관련 단계는 아래에 나와 있습니다.
독립 실행형 SDK 설치
를 사용하여 "sendEvent" 작업 구성 decisionScopes
alloy("sendEvent", {
...
"decisionScopes": [
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
]
})
태그를 통해 SDK 설치
"데이터스트림" 드롭다운에서 구성을 선택하여 생성한 데이터스트림으로 Platform Web SDK 확장을 설치하고 구성합니다. 다음에서 설명서를 참조하십시오. 확장.
필요한 항목 만들기 데이터 요소. 최소한 Platform Web SDK ID 맵 및 Platform Web SDK XDM 개체 데이터 요소를 만들어야 합니다.
사용자 만들기 규칙.
Platform Web SDK 이벤트 보내기 작업 추가 및 관련 작업 추가 decisionScopes
해당 작업 구성에 추가
라이브러리 만들기 및 게시 사용자가 구성한 모든 관련 규칙, 데이터 요소 및 확장 포함
decisionScopes
값요청
{
"events": [
{
"xdm": {
"identityMap": {
"ECID": [
{
"id": "91133425615229052182584359620783097099"
}
]
}
},
"query": {
"personalization": {
"decisionScopes": [
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
]
}
}
}
]
}
속성 | 필수 여부 | 설명 | 제한 | 예 |
---|---|---|---|---|
identityMap |
예 | 다음을 참조하십시오. Identity Service 설명서. | 요청당 하나의 ID. | { "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } } 질문에 답합니다. 참고: 사용자는 다음을 포함할 필요가 없습니다 ECID API 호출의 매개 변수입니다. 이 매개 변수는 필요한 경우 호출에 자동으로 추가됩니다. |
decisionScopes |
예 | 활동 및 배치 ID가 포함된 JSON의 Base64 인코딩 문자열 배열입니다. | 최대 30 decisionScopes 요청에 따라. |
"decisionScopes": ["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="] |
응답
{
"requestId": "94c4f2f1-9218-43ce-afd3-eb0d853c5174",
"handle": [
{
"payload": [
{
"id": "2862bb89-5df2-4bc6-85c2-d8f7e1a091de",
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
"activity": {
"id": "xcore:offer-activity:11cfb1fa93381aca",
"etag": "2"
},
"placement": {
"id": "xcore:offer-placement:1175009612b0100c",
"etag": "1"
},
"items": [
{
"id": "xcore:personalized-offer:124cc332095cfa74",
"schema": "https://ns.adobe.com/experience/offer-management/content-component-html",
"etag": "1",
"data": {
"id": "xcore:personalized-offer:124cc332095cfa74",
"format": "text/html",
"language": [
"en-US"
],
"content": "<p>20% Off on shipping</p>",
"characteristics": {
"foo": "bar",
"foo1": "bar1"
}
}
}
]
}
],
"type": "personalization:decisions",
"eventIndex": 0
}
]
}
속성 | 설명 | 예 |
---|---|---|
scope |
제안된 오퍼의 원인이 되는 결정 범위입니다. | "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==" |
activity.id |
오퍼 활동에 대한 고유 ID. | "id": "xcore:offer-activity:11cfb1fa93381aca" |
placement.id |
오퍼 배치에 대한 고유 ID. | "id": "xcore:offer-placement:1175009612b0100c" |
items.id |
제안된 오퍼의 ID입니다. | "id": "xcore:personalized-offer:124cc332095cfa74" |
schema |
제안된 오퍼와 연관된 콘텐츠의 스키마. | "schema": "https://ns.adobe.com/experience/offer-management/content-component-html" |
data.id |
제안된 오퍼의 ID입니다. | "id": "xcore:personalized-offer:124cc332095cfa74" |
format |
제안된 오퍼와 연관된 콘텐츠의 형식입니다. | "format": "text/html" |
language |
제안된 오퍼의 콘텐츠와 연관된 언어의 배열입니다. | "language": [ "en-US" ] |
content |
문자열 형식으로 제안된 오퍼와 연결된 콘텐츠. | "content": "<p style="color:red;">20% Off on shipping</p>" |
deliveryUrl |
제안된 오퍼와 연결된 이미지 컨텐츠(URL 형식). | "deliveryURL": "https://image.jpeg" |
characteristics |
JSON 오브젝트 형식으로 제안된 오퍼와 연관된 특성입니다. | "characteristics": { "foo": "bar", "foo1": "bar1" } |
decisionScopes
값요청
{
"events": [
{
"xdm": {
"identityMap": {
"ECID": [
{
"id": "91133425615229052182584359620783097099"
}
]
}
},
"query": {
"personalization": {
"decisionScopes": [
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==",
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyYzkxMzg1Mjc2MDE4YyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMzMxZjU2MTYyYWEyZjcifQ=="
]
}
}
}
]
}
속성 | 필수 여부 | 설명 | 제한 | 예 |
---|---|---|---|---|
identityMap |
예 | 다음을 참조하십시오. Identity Service 설명서. | 요청당 하나의 ID. | { "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } } 질문에 답합니다. 참고: 사용자는 다음을 포함할 필요가 없습니다 ECID API 호출의 매개 변수입니다. 이 매개 변수는 필요한 경우 호출에 자동으로 추가됩니다. |
decisionScopes |
예 | 활동 및 배치 ID가 포함된 JSON의 Base64 인코딩 문자열 배열입니다. | 최대 30 decisionScopes 요청에 따라. |
"decisionScopes":["eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==", "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==" |
응답
{
"requestId": "94c4f2f1-9218-43ce-afd3-eb0d853c5174",
"handle": [
{
"payload": [
{
"id": "a2804dfb-a0ec-4df9-8311-59d3ecdeb642",
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MTEyMyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDExMjMifQ==",
"activity": {
"id": "xcore:offer-activity:11cfb1fa93381123",
"etag": "1"
},
"placement": {
"id": "xcore:offer-placement:1175009612b01123",
"etag": "3"
},
"items": [
{
"id": "xcore:personalized-offer:11e36d4a22954123",
"schema": "https://ns.adobe.com/experience/offer-management/content-component-text",
"etag": "2",
"data": {
"id": "xcore:personalized-offer:11e36d4a22954123",
"format": "text/text",
"language": [
"en"
],
"content": "20% Off on shipping",
"characteristics": {
"foo2": "bar2"
}
}
}
]
},
{
"id": "a2804dfb-a0ec-4df9-8311-59d3ecdeb642",
"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
"activity": {
"id": "xcore:offer-activity:11cfb1fa93381aca",
"etag": "2"
},
"placement": {
"id": "xcore:offer-placement:1175009612b0100c",
"etag": "1"
},
"items": [
{
"id": "xcore:personalized-offer:11e36d4a2295415d",
"schema": "https://ns.adobe.com/experience/offer-management/content-component-imagelink",
"etag": "1",
"data": {
"id": "xcore:personalized-offer:11e36d4a2295415d",
"format": "image/png",
"language": [
"en"
],
"deliveryURL": "https://image.jpeg",
"characteristics": {
"foo": "bar",
"foo1": "bar1"
}
}
}
]
}
],
"type": "personalization:decisions",
"eventIndex": 0
}
]
}
속성 | 설명 | 예 |
---|---|---|
scope |
제안된 오퍼의 원인이 되는 결정 범위입니다. | "scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==" |
activity.id |
오퍼 활동에 대한 고유 ID. | "id": "xcore:offer-activity:11cfb1fa93381123" |
placement.id |
오퍼 배치에 대한 고유 ID. | "xcore:offer-placement:1175009612b01123" |
items.id |
제안된 오퍼의 ID입니다. | "id": "xcore:personalized-offer:11e36d4a22954123" |
schema |
제안된 오퍼와 연관된 콘텐츠의 스키마. | "schema": "https://ns.adobe.com/experience/offer-management/content-component-text" |
data.id |
제안된 오퍼의 ID입니다. | "id": "xcore:personalized-offer:11e36d4a22954123" |
format |
제안된 오퍼와 연관된 콘텐츠의 형식입니다. | "format": "text/text" |
language |
제안된 오퍼의 콘텐츠와 연관된 언어의 배열입니다. | "language": [ "en-US" ] |
content |
문자열 형식으로 제안된 오퍼와 연결된 콘텐츠. | "content": "<p style="color:red;">20% Off on shipping</p>" |
deliveryUrl |
제안된 오퍼와 연결된 이미지 컨텐츠(URL 형식). | "deliveryURL": "https://image.jpeg" |
characteristics |
JSON 오브젝트 형식으로 제안된 오퍼와 연관된 특성입니다. | "characteristics": { "foo": "bar", "foo1": "bar1" } |
일부 오퍼 제한 사항은 현재 모바일 Edge Network 워크플로에서 지원되지 않습니다(예: 한도). 한도 필드 값은 모든 사용자에게 오퍼를 제공할 수 있는 횟수를 지정합니다. 자세한 내용은 오퍼 자격 규칙 및 제한 설명서.