搭配Platform Web SDK使用Offer Decisioning

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,請執行下列步驟:

  1. 在您的資料流中啟用Adobe Experience Platform,並勾選「Offer decisioning」方塊

    offer-decisioning-edge-config

  2. 請依照指示安裝SDK (SDK可以獨立安裝,也可以透過UI安裝。 如需詳細資訊,請參閱標籤快速入門手冊)。

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

    • 安裝獨立SDK

      1. 使用personalization.decisionScopes設定「sendEvent」動作
      code language-javascript
      alloy("sendEvent", {
        ...
        "personalization": {
          "decisionScopes": [
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
            "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
          ]
        }
      });
      
    • 透過標籤安裝SDK

      1. 建立標籤屬性

      2. 新增內嵌程式碼

      3. 透過從「資料流」下拉式選單中選取設定,使用您建立的資料流安裝並設定Platform Web SDK擴充功能。 請參閱有關擴充功能的檔案。

        install-aep-web-sdk-extension

        configure-aep-web-sdk-extension

      4. 建立必要的資料元素。 您至少必須建立Platform Web SDK身分對應和Platform Web SDK XDM物件資料元素。

        identity-map-data-element

        xdm-object-data-element

      5. 建立您的規則

        • 新增Platform Web SDK傳送事件動作,並將相關的decisionScopes新增至該動作的設定

        send-event-action-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檔案
每個請求一個身分。
{ "identityMap": { "ECID": [ { "id": "91133425615229052182584359620783097099" } ] } }

注意:使用者不需要在API呼叫中包含ECID引數。 如有需要,此引數會自動新增至呼叫。
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