使用Adobe Target和Web SDK進行個人化

Adobe Experience Platform Web SDK可以傳送並轉譯在Adobe Target中管理的個人化體驗至Web Channel。 您可以使用稱為視覺化體驗撰寫器 (VEC)的WYSIWYG編輯器，或是非視覺化介面表單式體驗撰寫器，來建立、啟用及傳遞您的活動和個人化體驗。

下列功能已經過測試，目前在Target中支援：

Web SDK系統圖表

下圖可協助您瞭解Target和Web SDK邊緣決策的工作流程。

正在啟用Adobe Target

若要啟用Target，請執行下列動作：

然後，您也可選擇新增下列選項：

使用Adobe Target VEC

若要搭配Web SDK實作使用VEC，請安裝並啟動Firefox或Chrome VEC Helper擴充功能。

如需詳細資訊，請參閱​ Adobe Target指南 ​中的視覺化體驗撰寫器Helper擴充功能。

呈現個人化內容

如需詳細資訊，請參閱呈現個人化內容。

XDM中的受眾

為透過Web SDK傳遞的Target活動定義對象時，必須定義並使用XDM。 定義XDM結構描述、類別和結構描述欄位群組後，您可以建立由XDM資料定義的Target對象規則以用於目標定位。 在Target內，XDM資料會在對象產生器中顯示為自訂引數。 XDM是使用點標籤法序列化（例如，web.webPageDetails.name）。

如果您有Target個活動，其中包含使用自訂引數或使用者設定檔的預先定義對象，則無法透過SDK正確傳送這些對象。 您必須改用XDM，而不是使用自訂引數或使用者設定檔。 不過，有透過Web SDK支援的現成受眾目標定位欄位不需要XDM。 這些欄位可在Target UI中使用，不需要XDM：

如需詳細資訊，請參閱​ Adobe Target指南 ​中的對象類別。

回應Token

回應Token可用來傳送中繼資料給第三方，例如Google或Facebook。 傳回回應Token
在propositions -> items內的meta欄位中。 範例如下：

{
  "id": "AT:eyJhY3Rpdml0eUlkIjoiMTI2NzM2IiwiZXhwZXJpZW5jZUlkIjoiMCJ9",
  "scope": "__view__",
  "scopeDetails": ...,
  "renderAttempted": true,
  "items": [
    {
      "id": "0",
      "schema": "https://ns.adobe.com/personalization/dom-action",
      "meta": {
        "experience.id": "0",
        "activity.id": "126736",
        "offer.name": "Default Content",
        "offer.id": "0"
      }
    }
  ]
}

若要收集回應Token，您必須訂閱alloy.sendEvent Promise、透過propositions反複運算，並從items -> meta擷取詳細資料。

每個proposition都有一個renderAttempted布林值欄位，指出proposition是否已轉譯。 請參閱下列範例：

alloy("sendEvent",
  {
    "renderDecisions": true,
    "decisionScopes": [
      "hero-container"
    ]
  }).then(result => {
    const { propositions } = result;

    // filter rendered propositions
    const renderedPropositions = propositions.filter(proposition => proposition.renderAttempted === true);

    // collect the item metadata that represents the response tokens
    const collectMetaData = (items) => {
      return items.filter(item => item.meta !== undefined).map(item => item.meta);
    }

    const pageLoadResponseTokens = renderedPropositions
      .map(proposition => collectMetaData(proposition.items))
      .filter(e => e.length > 0)
      .flatMap(e => e);
  });

啟用自動轉譯時，主張陣列包含：

在頁面載入時：

檢視上 — 變更（針對快取檢視）：

停用自動轉譯時，主張陣列包含：

在頁面載入時：

檢視上 — 變更（針對快取檢視）：

單一設定檔更新

Web SDK可讓您將設定檔更新為Target設定檔，並更新為Web SDK做為體驗事件。

若要更新Target設定檔，請確定設定檔資料是以下列方式傳遞：

延遲儲存設定檔或實體引數，直到內容顯示給一般使用者

若要將設定檔中的錄製屬性延遲到內容顯示為止，請在您的要求中設定data.adobe.target._save=false。

例如，您的網站包含三個決定範圍，分別對應至網站上的三個類別連結（「男性、女性和兒童」），而您想要追蹤使用者最後造訪的類別。 傳送這些請求，並將__save旗標設為false，以避免在請求內容時保留類別。 內容視覺化之後，針對要記錄的對應屬性，傳送適當的裝載（包括eventToken和stateToken）。

以下範例會傳送trackEvent樣式訊息、執行設定檔指令碼、儲存屬性，並立即記錄事件。

alloy("sendEvent", {
    "renderDecisions": true,
    "data": {
        "xdm": { // Experience Event XDM data },
            "__adobe": {
                "target": {
                    " __save": true|false,
                    //defaults to true if omitted
                    "profile.gender": "female",
                    "profile.age": 30,
                    "entity.name": "T-shirt",
                    "entity.id": "1234"
                }
            }
        }
    }
})

要求建議

下表列出Recommendations屬性，以及是否透過Web SDK支援每個屬性：

如何將Recommendations屬性傳送至Adobe Target：

alloy("sendEvent", {
  "renderDecisions": true,
  "data": {
    "__adobe": {
      "target": {
        "entity.id": "123",
        "entity.genre": "Drama"
      }
    }
  }
});

顯示mbox轉換量度 display-mbox-conversion-metrics

以下範例說明如何追蹤顯示mbox轉換並傳送設定檔引數至Adobe Target，而不需要符合任何內容或活動的資格。

alloy("sendEvent", {
    "xdm": {
        "_experience": {
            "decisioning": {
                "propositions": [{
                    "scope": "conversion-step-1" //example scope name
                }],
                "propositionEventType": {
                    "display": 1
                }
            }
        },
        "eventType": "decisioning.propositionDisplay"
    }
});

偵錯

已棄用mboxTrace和mboxDebug。 請改用Web SDK偵錯的方法。

術語

主張： ​在Adobe Target中，主張與從活動選取的體驗相關。

結構描述： ​決定的結構描述是Adobe Target中的優惠型別。

範圍： ​決定的範圍。 在Adobe Target中，範圍是mBox。 全域mBox是__view__範圍。

XDM： XDM已序列化為點標籤法，然後以mBox引數的形式放入Adobe Target中。