搭配Platform Web SDK使用Offer Decisioning

Last update: Thu Apr 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Web SDK

建立對象：

Developer

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使用Identity Service.

啟用Offer decisioning

若要啟用Offer Decisioning，請執行下列步驟：

在您的中啟用Adobe Experience Platform 資料流並勾選「Offer decisioning」方塊
依照指示進行安裝SDK (SDK可獨立安裝或透過UI安裝。請參閱標籤快速入門手冊)以取得詳細資訊。

設定SDK以便Offer decisioning，使用 personalization.decisionScopes. 以下提供其他Offer decisioning特定步驟。

安裝獨立SDK

設定"sendEvent"動作，包含 personalization.decisionScopes

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

注意：使用者不需要包含 ECID API呼叫中的引數如有需要，此引數會自動新增至呼叫。

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` 值