通过Offer decisioning进行个性化
概述 overview
Edge Network服务器API可以提供在中管理的个性化体验 offer decisioning 到Web渠道。
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,请参阅 文档.
之后 配置数据流,您必须定义要在个性化营销活动中使用的决策范围。
决策范围 是经过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" }