通过Offer decisioning进行个性化

概述

边缘网络服务器API可以提供在 offer decisioning 到web渠道。

Offer Decisioning 支持一个非可视化界面,用于创建、激活和提供活动和个性化体验。

配置数据流

在将服务器API与Offer decisioning结合使用之前,必须对数据流配置启用Adobe Experience Platform个性化,并启用 offer decisioning 选项。

请参阅 向数据流添加服务的指南,以了解有关如何启用Offer decisioning的详细信息。

显示数据流服务配置屏幕的UI图像,并选择Offer decisioning

受众创建

Offer Decisioning 依赖于Adobe Experience Platform分段服务来创建受众。 您可以在 Segmentation Service 此处.

定义决策范围

的 Offer Decision Engine 使用Adobe Experience Platform数据和 实时客户用户档案,以及 Offer Library,以便在适当的时间向适当的客户和渠道提供优惠。

要进一步了解 Offer Decisioning Engine,请参阅 文档.

之后 配置数据流,则必须定义要在个性化营销活动中使用的决策范围。

决策范围 是包含所需活动ID和版面ID的Base64编码JSON字符串 Offer Decisioning Service 在建议选件时使用。

决策范围JSON

{
   "activityId":"xcore:offer-activity:11cfb1fa93381aca",
   "placementId":"xcore:offer-placement:1175009612b0100c"
}

决策范围Base64编码的字符串

"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="

创建选件和收藏集后,您需要定义 决策范围.

复制Base64编码的决策范围。 您将在 query 服务器API请求的对象。

显示Offer decisioningUI的UI图像,突出显示决策范围。

"query":{
   "personalization":{
      "decisionScopes":[
         "eyJ4ZG06YWN0aXZpdHlJZCI6Inhjb3JlOm9mZmVyLWFjdGl2aXR5OjE0ZWZjYTg5NDE4OTUxODEiLCJ4ZG06cGxhY2VtZW50SWQiOiJ4Y29yZTpvZmZlci1wbGFjZW1lbnQ6MTJkNTQ0YWU1NGU3ZTdkYiJ9"
      ]
   }
}

API调用示例

API格式

POST /ee/v2/interact

请求

下面概述了包含完整XDM对象、数据对象和Offer decisioning查询的完整请求。

注意

xdmdata 对象是可选的,并且仅当您创建的区段具有使用其中任一对象中字段的条件时,才需要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"
            ]
        }
    }
}'

响应

边缘网络将返回与下面类似的响应。

{
   "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。 "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" }

在此页面上