呈現個人化內容

Last update: Mon Apr 01 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
Web SDK

建立對象：

Developer

Adobe Experience Platform Web SDK支援從Adobe個人化解決方案擷取個人化內容，包括 Adobe Target， offer decisioning 和 Adobe Journey Optimizer.

此外，Web SDK透過Adobe Experience Platform個人化目的地，提供相同頁面和下一頁個人化功能，例如 Adobe Target 和自訂個人化連線. 若要瞭解如何設定相同頁面和下一頁個人化的Experience Platform，請參閱專用指南.

在Adobe Target中建立的內容視覺化體驗撰寫器以及Adobe Journey Optimizer的 Web Campaign UI 可由SDK自動擷取及轉譯。在Adobe Target中建立的內容表單式體驗撰寫器， Adobe Journey Optimizer的程式碼型Experience Channel 或Offer decisioning無法由SDK自動轉譯。相反地，您必須使用SDK請求此內容，然後自行手動轉譯內容。

自動呈現內容 automatic

將事件傳送至伺服器時，您可以設定 renderDecisions 選項至 true. 這麼做會強制SDK自動轉譯任何符合自動轉譯條件的個人化內容。

alloy("sendEvent", {
  "renderDecisions": true,
  "xdm": {
    "commerce": {
      "order": {
        "purchaseID": "a8g784hjq1mnp3",
        "purchaseOrderNumber": "VAU3123",
        "currencyCode": "USD",
        "priceTotal": 999.98
      }
    }
  }
});

個人化內容的呈現是非同步的，因此您不應就特定內容何時將完成呈現做出假設。

手動呈現內容 manual

若要存取任何個人化內容，您可以提供回呼函式，SDK從伺服器收到成功回應後，就會呼叫此函式。系統會提供您的回呼 result 物件，其中可能包含 propositions 包含任何傳回的個人化內容的屬性。以下範例說明在傳送事件時，如何提供回呼函式。

alloy("sendEvent", {
    "xdm": {}
  }).then(function(result) {
    if (result.propositions) {
      // Manually render propositions and send "display" event
    }
  });

在此範例中， result.propositions，如果存在的話，是包含與事件相關之個人化主張的陣列。依預設，它僅包含符合自動演算資格的主張。

此 propositions 陣列看起來可能類似於此範例：

[
  {
    "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
    "scope": "__view__",
    "items": [
      {
        "id": "11223344",
        "schema": "https://ns.adobe.com/personalization/dom-action",
        "data": {
          "content": "<h2 style=\"color: yellow\">An HTML proposition.</h2>",
          "selector": "#hero",
          "type": "setHtml"
        },
        "meta": {}
      }
    ],
    "scopeDetails": {
      ...
    },
    "renderAttempted": false
  },
  {
    "id": "AT:PyJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ8",
    "scope": "__view__",
    "items": [
      {
        "id": "11223345",
        "schema": "https://ns.adobe.com/personalization/dom-action",
        "data": {
          "content": "<h2 style=\"color: yellow\">Another HTML proposition.</h2>",
          "selector": "#sidebar",
          "type": "setHtml"
        },
        "meta": {}
      }
    ],
    "scopeDetails": {
      ...
    },
    "renderAttempted": false
  }
]

在此範例中， renderDecisions 選項未設定為 true 當 sendEvent 命令已執行，因此SDK不會嘗試自動轉譯任何內容。不過，SDK仍會自動擷取符合自動轉譯條件的內容，並會在您想要這麼做時，提供此內容給您以手動轉譯。請注意，每個主張物件都有 renderAttempted 屬性設定為 false.

如果您改為設定 renderDecisions 選項至 true 傳送事件時，SDK會嘗試轉譯任何符合自動轉譯條件的提案（如先前所述）。因此，每個主張物件都會有其 renderAttempted 屬性設定為 true. 在此情況下，不需要手動轉譯這些主張。

到目前為止，我們僅討論適用於自動轉譯的個人化內容(亦即在Adobe Target的視覺化體驗撰寫器或Adobe Journey Optimizer的Web Campaign UI中建立的任何內容)。擷取任何個人化內容非符合自動呈現的條件，您需要透過填入 decisionScopes 選項。範圍是字串，可識別您要從伺服器擷取的特定主張。

其範例如下：

alloy("sendEvent", {
    "xdm": {},
    "decisionScopes": ['salutation', 'discount']
  }).then(function(result) {
    if (result.propositions) {
      // Manually render propositions and send "display" event
    }
  });

在此範例中，如果在伺服器上找到與相符的主張 salutation 或 discount 範圍，它們會傳回並包含在 result.propositions 陣列。請注意，符合自動轉譯資格的主張將繼續包含在 propositions 陣列，無論您如何設定 renderDecisions 或 decisionScopes 選項。此 propositions 在此範例中，陣列看起來與此範例類似：

[
  {
    "id": "AT:cZJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ2",
    "scope": "salutation",
    "items": [
      {
        "schema": "https://ns.adobe.com/personalization/json-content-item",
        "data": {
          "id": "4433221",
          "content": {
            "salutation": "Welcome, esteemed visitor!"
          }
        },
        "meta": {}
      }
    ],
    "scopeDetails": {
      "id": "AT:cZJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ2",
      "activity": {
        "id": "384456"
      }
    },
    "renderAttempted": false
  },
  {
    "id": "AT:FZJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ0",
    "scope": "discount",
    "items": [
      {
        "schema": "https://ns.adobe.com/personalization/html-content-item",
        "data": {
          "id": "4433222",
          "content": "<div>50% off your order!</div>",
          "format": "text/html"
        },
        "meta": {}
      }
    ],
    "scopeDetails": {
      "id": "AT:FZJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ0",
      "activity": {
        "id": "384457"
      }
    },
    "renderAttempted": false
  },
  {
    "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
    "scope": "__view__",
    "items": [
      {
        "id": "11223344",
        "schema": "https://ns.adobe.com/personalization/dom-action",
        "data": {
          "content": "<h2 style=\"color: yellow\">An HTML proposition.</h2>",
          "selector": "#hero",
          "type": "setHtml"
        },
        "meta": {}
      }
    ],
    "scopeDetails": {
      "id": "AT:PyJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ8",
      "activity": {
        "id": "384459"
      }
    },
    "renderAttempted": false
  },
  {
    "id": "AT:PyJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ8",
    "scope": "__view__",
    "items": [
      {
        "id": "11223345",
        "schema": "https://ns.adobe.com/personalization/dom-action",
        "data": {
          "content": "<h2 style=\"color: yellow\">Another HTML proposition.</h2>",
          "selector": "#sidebar",
          "type": "setHtml"
        },
        "meta": {}
      }
    ],
    "scopeDetails": {
      "id": "AT:PyJhY3Rpdml0eUlkIjoiMTI3MDE5IiwiZXhwZXJpZW5jZUlkIjoiMCJ8",
      "activity": {
        "id": "384459"
      }
    },
    "renderAttempted": false
  }
]

此時，您可以視需要演算主張內容。在此範例中，主張符合 discount scope是使用Adobe Target的表單式體驗撰寫器建立的HTML主張。假設您的頁面上有一個元素，其ID為 daily-special 並希望轉譯以下專案的內容： discount 中的主張 daily-special 元素，請執行下列動作：

從擷取主張 result 物件。
循環瀏覽每個主張，尋找具有範圍的主張 discount.
如果您找到主張，會在主張中的每個專案中進行回圈，尋找是HTML內容的專案。（檢查勝於假設）。
如果您找到包含HTML內容的專案，請找到 daily-special 元素，並以個人化內容取代其HTML。
呈現內容後，傳送 display 事件。

您的程式碼如下所示：

alloy("sendEvent", {
  "xdm": {},
  "decisionScopes": ['salutation', 'discount']
}).then(function(result) {
  var propositions = result.propositions;

  var discountProposition;
  if (propositions) {
    // Find the discount proposition, if it exists.
    for (var i = 0; i < propositions.length; i++) {
      var proposition = propositions[i];
      if (proposition.scope === "discount") {
        discountProposition = proposition;
        break;
      }
    }
  }

  var discountHtml;
  if (discountProposition) {
    // Find the item from proposition that should be rendered.
    // Rather than assuming there a single item that has HTML
    // content, find the first item whose schema indicates
    // it contains HTML content.
    for (var j = 0; j < discountProposition.items.length; j++) {
      var discountPropositionItem = discountProposition.items[i];
      if (discountPropositionItem.schema === "https://ns.adobe.com/personalization/html-content-item") {
        discountHtml = discountPropositionItem.data.content;
        // Render the content
        var dailySpecialElement = document.getElementById("daily-special");
        dailySpecialElement.innerHTML = discountHtml;

        // For this example, we assume there is only a signle place to update in the HTML.
        break;
      }
    }
      // Send a "display" event
    alloy("sendEvent", {
      "xdm": {
        "eventType": "decisioning.propositionDisplay",
        "_experience": {
          "decisioning": {
            "propositions": [
              {
                "id": discountProposition.id,
                "scope": discountProposition.scope,
                "scopeDetails": discountProposition.scopeDetails
              }
            ]
          }
        }
      }
    });
  }
});

TIP

如果您使用Adobe Target，領域會對應至伺服器上的mbox，只是所有領域會一次要求完成，而非個別要求。一律會傳回全域mbox。

管理忽隱忽現情形

SDK提供的設施可以管理忽隱忽現情形進行個人化程式期間。

在不增加量度的情況下在單頁應用程式中轉譯主張 applypropositions

此 applyPropositions 命令可讓您從以下位置呈現或執行主張陣列 Target 或Adobe Journey Optimizer轉換為單頁應用程式，而不增加 Analytics 和 Target 量度。這會提高報表的正確性。

IMPORTANT

如果的建議 __view__ 範圍（或網頁表面）已在頁面載入時轉譯，其 renderAttempted 標幟將設為 true. 此 applyPropositions 命令將不會重新呈現 __view__ 具有下列專案的範圍（或網頁表面）主張： renderAttempted: true 標幟。

使用案例1：重新呈現單頁應用程式檢視主張

下列範例中說明的使用案例會重新呈現先前擷取和轉譯的購物車檢視主張，而不會傳送顯示通知。

在以下範例中， sendEvent 指令會在檢視變更時觸發，並將產生的物件儲存為常數。

接下來，當檢視或元件更新時， applyPropositions 呼叫命令，並使用上一個命令中的建議 sendEvent 指令，以重新呈現檢視主張。

var cartPropositions = alloy("sendEvent", {
    "renderDecisions": true,
    "xdm": {
        "web": {
            "webPageDetails": {
                "viewName": "cart"
            }
        }
    }
}).then(function(result) {
    var propositions = result.propositions;

    // Collect response tokens, etc.
    return propositions;
});

// Call applyPropositions to re-render the view propositions from the previous sendEvent command.
alloy("applyPropositions", {
    "propositions": cartPropositions
});

使用案例2：沒有選擇器的演算主張

此使用案例適用於透過編寫的體驗 Target Form-based Experience Composer 或Adobe Journey Optimizer的程式碼型Experience Channel.

您必須在「」中提供選取器、動作和範圍 applyPropositions 呼叫。

支援 actionTypes 為：

setHtml
replaceHtml
appendHtml

// Retrieve propositions for salutation and discount scopes
alloy("sendEvent", {
    "decisionScopes": ["salutation", "discount"]
}).then(function(result) {
    var retrievedPropositions = result.propositions;
    // Render propositions on the page by providing additional metadata

    return alloy("applyPropositions", {
        "propositions": retrievedPropositions,
        "metadata": {
            "salutation": {
                "selector": "#first-form-based-offer",
                "actionType": "setHtml"
            },
            "discount": {
                "selector": "#second-form-based-offer",
                "actionType": "replaceHtml"
            }
        }
    }).then(function(applyPropositionsResult) {
        var renderedPropositions = applyPropositionsResult.propositions;

        // Send the display notifications via sendEvent command
        function sendDisplayEvent(proposition) {
            const {
                id,
                scope,
                scopeDetails = {}
            } = proposition;

            alloy("sendEvent", {
                xdm: {
                    eventType: "decisioning.propositionDisplay",
                    _experience: {
                        decisioning: {
                            propositions: [{
                                id: id,
                                scope: scope,
                                scopeDetails: scopeDetails,
                            }, ],
                            propositionEventType: {
                                display: 1
                            },
                        },
                    },
                },
            });
        }
    });
});

如果您沒有為決定範圍提供中繼資料，將不會轉譯關聯的提議。

recommendation-more-help

ad108910-6329-42f1-aa1d-5920a2b13636