offer decisioning을 통한 개인화
개요 overview
Edge Network Server API는에서 관리하는 개인화된 경험을 제공할 수 있습니다. Offer decisioning 웹 채널에 연결합니다.
Offer Decisioning 은 활동 및 개인화 경험을 만들고, 활성화하고, 제공하기 위한 시각적이지 않은 인터페이스를 지원합니다.
전제 조건 prerequisites
을 통한 개인화 Offer Decisioning 은(는) 다음에 대한 액세스 권한이 있어야 합니다. Adobe Journey Optimizer 통합을 구성하기 전에
데이터 스트림 구성 configure-your-datastream
Server API를 Offer Decisioning과 함께 사용하려면 먼저 데이터 스트림 구성에서 Adobe Experience Platform 개인화를 활성화하고 Offer decisioning 옵션을 선택합니다.
다음을 참조하십시오. 데이터스트림에 서비스 추가 가이드를 참조하십시오. Offer decisioning 활성화 방법에 대한 자세한 내용은
대상자 생성 audience-creation
Offer Decisioning 은 대상자 생성을 위해 Adobe Experience Platform 세그멘테이션 서비스를 사용합니다. 다음에 대한 설명서를 찾을 수 있습니다. Segmentation Service 여기.
결정 범위 정의 creating-decision-scopes
다음 Offer Decision Engine Adobe Experience Platform 데이터 및 실시간 고객 프로필와 함께 Offer Library를 사용하여 적절한 고객과 채널에 적시에 오퍼를 제공할 수 있습니다.
에 대해 자세히 알아보려면 Offer Decisioning Engine, 전용 참조 설명서.
다음 이후 데이터 스트림 구성, 개인화 캠페인에 사용할 결정 범위를 정의해야 합니다.
결정 범위 는 원하는 활동 및 배치 ID가 포함된 Base64로 인코딩된 JSON 문자열입니다. Offer Decisioning Service 오퍼를 제안할 때 사용합니다.
결정 범위 JSON
{
"activityId":"xcore:offer-activity:11cfb1fa93381aca",
"placementId":"xcore:offer-placement:1175009612b0100c"
}
결정 범위 Base64로 인코딩된 문자열
"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
오퍼 및 컬렉션을 만든 후에는 다음을 정의해야 합니다 결정 범위.
Base64로 인코딩된 결정 범위를 복사합니다. 다음에서 사용합니다. query 서버 API 요청의 개체입니다.
"query":{
"personalization":{
"decisionScopes":[
"eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE0ZWZjYTg5NDE4OTUxODEiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTJkNTQ0YWU1NGU3ZTdkYiJ9"
]
}
}
API 호출 예 api-example
API 형식
POST /ee/v2/interact
요청 request
전체 XDM 개체, 데이터 개체 및 Offer decisioning 쿼리를 포함하는 전체 요청은 아래에 요약되어 있습니다.
xdm 및 data 객체는 선택 사항이며, 이러한 객체에서 필드를 사용하는 조건으로 세그먼트를 만든 경우에만 Offer decisioning에 필요합니다.curl -X POST 'https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}' \
--header 'x-api-key: {API_KEY}' \
--header 'x-gw-ims-org: {ORG_ID}' \
--header 'Authorization: Bearer {TOKEN}' \
--header 'Content-Type: application/json' \
--data-raw '{
"event": {
"xdm": {
"eventType": "web.webpagedetails.pageViews",
"identityMap": {
"ECID": [
{
"id": "05907638112924484241029082405297151763",
"authenticatedState": "ambiguous",
"primary": true
}
]
},
"web": {
"webPageDetails": {
"URL": "https://alloystore.dev",
"name": "Home Page"
},
"webReferrer": {
"URL": ""
}
},
"device": {
"screenHeight": 1440,
"screenWidth": 3440,
"screenOrientation": "landscape"
},
"environment": {
"type": "browser",
"browserDetails": {
"viewportWidth": 3440,
"viewportHeight": 1440
}
},
"placeContext": {
"localTime": "2022-03-22T22:45:21.193-06:00",
"localTimezoneOffset": 360
},
"timestamp": "2022-03-23T04:45:21.193Z",
"implementationDetails": {
"name": "https://ns.adobe.com/experience/alloy/reactor",
"version": "1.0",
"environment": "serverapi"
}
},
"data": {
"page": {
"pageInfo": {
"pageName": "Promotions",
"siteSection": "Home"
},
"promos": {
"heroPromos": "purse,shoes,sunglasses"
},
"customVariables": {
"testGroup": "orange/black theme"
},
"events": {
"homePage": true
},
"products": [
{
"productSKU": "abc123",
"productName": "shirt"
}
]
},
"__adobe.target": {
"profile.eyeColor": "brown",
"profile.hairColor": "brown"
}
}
},
"query": {
"personalization": {
"decisionScopes": [
"eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE0ZWZjYTg5NDE4OTUxODEiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTJkNTQ0YWU1NGU3ZTdkYiJ9"
]
}
}
}'
응답 response
Edge Network는 아래 응답과 유사한 응답을 반환합니다.
{
"requestId":"b375077d-7e1d-4c18-b7d3-e4da0fb4fbc5",
"handle":[
{
"payload":[
],
"type":"personalization:decisions",
"eventIndex":0
},
{
"payload":[
{
"id":"120d5db7-181c-42c5-8653-88b3cd3e1e69",
"scope":"eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE0ZWZjYTg5NDE4OTUxODEiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTJkNTQ0YWU1NGU3ZTdkYiJ9",
"activity":{
"id":"xcore:offer-activity:14efca8941895181",
"etag":"1"
},
"placement":{
"id":"xcore:offer-placement:12d544ae54e7e7db",
"etag":"1"
},
"items":[
{
"id":"xcore:personalized-offer:14efc848a3577d92",
"etag":"2",
"schema":"https://ns.adobe.com/experience/offer-management/content-component-json",
"data":{
"id":"xcore:personalized-offer:14efc848a3577d92",
"format":"application/json",
"language":[
"en-us"
],
"content":"{\n\t\"ODEFirstTest\" : \"Personalizaton Content\"\n}",
"characteristics":{
"reporting":"testRequest"
}
}
}
]
}
],
"type":"personalization:decisions",
"eventIndex":0
},
{
"payload":[
{
"key":"kndctr_53A16ACB5CC1D3760A495C99_AdobeOrg_identity",
"value":"CiYwNTkwNzYzODExMjkyNDQ4NDI0MTAyOTA4MjQwNTI5NzE1MTc2M1IOCLr6xb39LxgBKgNPUjLwAbr6xb39Lw==",
"maxAge":34128000
}
],
"type":"state:store"
}
]
}
방문자가에 전송된 데이터를 기반으로 개인화 활동을 수행할 수 있는 경우 Offer Decisioning, 관련 활동 콘텐츠는 handle 객체. 여기서 유형은 입니다. personalization:decisions.
다른 콘텐츠는 아래에 반환됩니다. handle 대상도 마찬가지입니다. 다른 콘텐츠 유형은 와 관련이 없습니다. Offer Decisioning 개인화. 방문자가 여러 활동을 수행할 수 있는 경우 배열에 포함됩니다.
아래 표는 응답의 해당 부분에 대한 주요 요소를 설명합니다.
scope"scope": "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="activity.id"id": "xcore:offer-activity:11cfb1fa93381aca"placement.id"id": "xcore:offer-placement:1175009612b0100c"items.id"id": "xcore:personalized-offer:124cc332095cfa74"schema"schema": "https://ns.adobe.com/experience/offer-management/content-component-html"data.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"deliveryURL": "https://image.jpeg"characteristics"characteristics": { "foo": "bar", "foo1": "bar1" }