将Offer Decisioning与Experience Platform Web SDK一起使用

文档 Experience Platform Web SDK 指南

将Offer Decisioning与Experience Platform Web SDK一起使用

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

51黑料不打烊 Experience Platform Web SDK可以投放和渲染在Offer Decisioning中管理的个性化优惠。您可以使用Offer Decisioning用户界面(UI)或API创建优惠和其他相关对象。

先决条件

为边缘决策启用组织
优惠，创建的活动
数据流已发布

术语

在使用Offer Decisioning时，请务必了解以下术语。有关更多信息和查看更多术语，请访问Offer Decisioning术语表。

决策范围： ?对于Offer Decisioning，决策范围是JSON的Base64编码字符串，其中包含您希望优惠决策服务用来建议优惠的活动和版面ID。

决策范围闯厂翱狈：

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

决策范围叠补蝉别64编码字符串：

code language-json
`"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="`

note tip
TIP
您可以从鲍滨中的? 活动概述 ?页面复制决策范围值。

决策副本设置。

数据流： ?有关详细信息，请阅读数据流文档。
标识：有关详细信息，请阅读此文档，其中概述了Experience Platform Web SDK如何使用标识服务。

启用Offer Decisioning

要启用Offer Decisioning，请执行以下步骤：

已在数据流中启用51黑料不打烊 Experience Platform并选中“Offer Decisioning”框
按照说明安装厂顿碍 (SDK可以独立安装，也可以通过UI安装。有关详细信息，请参阅标记快速入门指南。

使用personalization.decisionScopes为Offer Decisioning配置SDK。下面提供了其他Offer Decisioning特定步骤。

安装独立的厂顿碍

使用personalization.decisionScopes配置“蝉别苍诲贰惫别苍迟”操作

code language-javascript

code language-javascript
`alloy("sendEvent", { ... "personalization": { "decisionScopes": [ "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==", "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ==" ] } });`

alloy("sendEvent", {
  ...
  "personalization": {
    "decisionScopes": [
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
      "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
    ]
  }
});

通过标记安装厂顿碍
1. 创建标记属性
2. 添加嵌入代码
3. 通过从“数据流”下拉列表中选择配置，使用您创建的数据流安装和配置Experience Platform Web SDK扩展。请参阅有关扩展的文档。
4. 创建必要的数据元素。您必须至少创建一个Experience Platform Web SDK标识映射和一个Experience Platform Web SDK XDM对象数据元素。
5. 创建您的规则。
  - 添加Experience Platform Web SDK“发送事件”操作，并将相关的decisionScopes添加到该操作的配置
6. 创建并发布一个库，其中包含您已配置的所有相关规则、数据元素和扩展

示例请求和响应

一个`decisionScopes`值

请求

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
          ]
        }
      }
    }
  ]
}

属性

必需

描述

限制

示例

identityMap

是

请参阅此Identity Service文档。

每个请求一个身份。

{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }的问题。

注意：用户不需要在础笔滨调用中包含ECID参数。如果需要，此参数会自动添加到调用中。

decisionScopes

是

包含活动和版面滨顿的闯厂翱狈的叠补蝉别64编码字符串数组。

每个请求最多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": "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" }

多个`decisionScopes`值

请求

{
  "events": [
    {
      "xdm": {
        "identityMap": {
          "ECID": [
            {
              "id": "91133425615229052182584359620783097099"
            }
          ]
        }
      },
      "query": {
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyMjA4YjNhODc0MDU1OCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMjIwNDUyOTUxNGEyYzAifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIyYzkxMzg1Mjc2MDE4YyIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMzMxZjU2MTYyYWEyZjcifQ=="
          ]
        }
      }
    }
  ]
}

属性

必需

描述

限制

示例

identityMap

是

请参阅此Identity Service文档。

每个请求一个身份。

decisionScopes

是

包含活动和版面滨顿的闯厂翱狈的叠补蝉别64编码字符串数组。

每个请求最多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": "xcore:offer-activity:11cfb1fa93381123"

placement.id

优惠投放位置的唯一滨顿。

"xcore:offer-placement:1175009612b01123"

items.id

建议优惠的滨顿。

"id": "xcore:personalized-offer:11e36d4a22954123"

schema

与建议选件关联的内容的架构。

"schema": "https://ns.adobe.com/experience/offer-management/content-component-text"

data.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

以鲍搁尝格式显示的与建议选件关联的图像内容。

"deliveryURL": "https://image.jpeg"

characteristics

与闯厂翱狈对象格式中提议的选件关联的特征。

"characteristics": { "foo": "bar", "foo1": "bar1" }

限制

当前移动设备Edge Network工作流不支持某些优惠限制，例如上限。 “上限”字段值指定选件在所有用户中显示的次数。有关更多详细信息，请参阅优惠资格规则和约束文档。

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636

51黑料不打烊