使用Offer decisioning與平台Web SDK

注意

在Adobe Experience PlatformWeb SDK中使用Offer decisioning可以提前訪問選定用戶。 此功能並非所有IMS組織都可用。

Adobe Experience Platform Web SDK 可以交付和呈現以Offer decisioning管理的個性化優惠。 您可以使用Offer decisioning用戶介面(UI)或API建立您的優惠和其他相關對象。

先決條件

  • IMS組織已啟用邊緣判別
  • 優惠、建立的活動
  • 資料流已發佈

術語

在使用Offer decisioning時,必須瞭解以下術語。 如欲瞭解更多資訊並查看其他條款,請訪問 offer decisioning辭彙表

  • 容器: 容器是一種隔離機構,用於將不同的問題分開。 容器ID是所有儲存庫API的第一個路徑元素。 所有決策對象都駐留在容器中。

  • 決策範圍: 對於Offer decisioning,決策作用域是JSON的Base64編碼字串,包含希望offer decisioning服務用於建議優惠的活動和位置ID。

    決策範圍JSON:

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

    決策範圍Base64編碼字串:

    "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTFjZmIxZmE5MzM4MWFjYSIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjExNzUwMDk2MTJiMDEwMGMifQ=="
    
    秘訣

    您可以從 活動概述 的子菜單。

  • 資料流: 有關詳細資訊,請閱讀 資料流 文檔。

  • 身份:有關詳細資訊,請閱讀本文檔,概述如何 平台Web SDK使用Identity Service

啟用Offer decisioning

要啟用Offer decisioning,請執行以下步驟:

  1. 已啟用您的Adobe Experience Platform 資料流 選中「Offer decisioning」框

    提供決策邊緣配置

  2. 按照說明 安裝SDK (SDK可以單獨安裝,也可以通過 資料收集UI。 查看 標籤快速入門手冊)。

  3. 配置SDK offer decisioning。 下面提供了其他Offer decisioning特定步驟。

    • 安裝獨立SDK

      1. 使用 decisionScopes

         alloy("sendEvent", {
            ...
            "decisionScopes": [
                "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIwOWMxM2JkZDIyNCIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMDZhODRkMDViMTEifQ==",
                "eyJhY3Rpdml0eUlkIjoieGNvcmU6b2ZmZXItYWN0aXZpdHk6MTIxYWIyNWI5NTUwNWIxZiIsInBsYWNlbWVudElkIjoieGNvcmU6b2ZmZXItcGxhY2VtZW50OjEyMWFiMjFmOTQzMDE0MmIifQ=="
            ]
         })
        
    • 通過標籤安裝SDK

      1. 建立標籤屬性

      2. 添加嵌入代碼

      3. 從「Datastream」下拉清單中選擇配置,使用您建立的Datastream安裝和配置平台Web SDK擴展。 請參閱 擴展

        install-aep-web-sdk — 擴展

        configure-aep-web-sdk — 擴展

      4. 建立必要 資料元素。 至少,必須建立平台Web SDK標識映射和平台Web SDK XDM對象資料元素。

        標識 — 映射 — 資料元

        xdm對象資料元

      5. 建立 規則

        • 添加平台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" } ] } }

注:用戶不需要包括 ECID API調用中的參數。 如果需要,此參數將自動添加到調用中。
decisionScopes 包含活動和位置ID的Base64編碼的JSON字串陣列。 最多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" } ] } }

注:用戶不需要包括 ECID API調用中的參數。 如果需要,此參數將自動添加到調用中。
decisionScopes 包含活動和位置ID的Base64編碼的JSON字串陣列。 最多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" }

限制

移動體驗邊緣工作流當前不支援某些服務約束,例如封頂。 「上限設定」欄位值指定可在所有用戶間顯示優惠的次數。 有關詳細資訊,請參閱 提供資格規則和約束文檔

本頁內容