搭配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

是

一個JSON的Base64編碼字串陣列，包含活動和位置ID。

每個請求最多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

是

一個JSON的Base64編碼字串陣列，包含活動和位置ID。

每個請求最多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`值