在Platform Web SDK中使用Offer Decisioning

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

NOTE

可在Adobe Experience Platform Web SDK中使用Offer decisioning提前访问选定的用户。此功能并非对所有组织都可用。

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

先决条件

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

术语

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

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

决策范围JSON：

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

决策范围Base64编码字符串：

code language-json
`"eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="`

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

决策副本设置。

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

启用Offer decisioning

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

已在数据流中启用Adobe Experience Platform并选中“Offer decisioning”框
按照安装SDK的说明进行操作（SDK可以独立安装，也可以通过UI进行安装）。有关详细信息，请参阅标记快速入门指南。

配置SDK以使用personalization.decisionScopes进行Offer decisioning。下面提供了其他特定于Offer decisioning的步骤。

安装独立SDK

使用personalization.decisionScopes配置“sendEvent”操作

code language-javascript

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

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

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

示例请求和响应

一个`decisionScopes`值

请求

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

属性

必需

描述

限制

示例

identityMap

是

请参阅此Identity Service文档。

每个请求一个身份。

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

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

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文档。

每个请求一个身份。

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

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636

在Platform Web SDK中使用Offer Decisioning

先决条件

术语

启用Offer decisioning

示例请求和响应

一个decisionScopes值

多个decisionScopes值

限制

一个`decisionScopes`值

多个`decisionScopes`值