使用 Adobe Target 和 Platform Web SDK

Adobe Experience Platform Web SDK 可以提供和呈現管理的個性化體驗 Adobe Target 到Web頻道。 您可以使用WYSIWYG編輯器 視覺體驗作曲家 (VEC)或非可視介面 基於表單的體驗作曲家、建立、激活和提供活動和個性化體驗。

以下功能已經測試，目前支援 Target:

• A/BTest
• A4T印象和轉換報告
• Automated Personalization活動
• 針對經驗的活動
• 多元Test
• Recommendations活動
• 本機目標印象和轉換報告
• VEC支援

Platform Web SDK 系統圖

下圖幫助您瞭解 Target 和 Platform Web SDK 邊緣判別。

啟用 Adobe Target

啟用 Target，執行以下操作：

1. 啟用 Target 在 資料流 和相應的客戶端代碼。
2. 添加 renderDecisions 頁籤

然後，您也可以添加以下選項：

• decisionScopes:通過將此選項添加到事件中來檢索特定活動（對於使用基於表單的作曲家建立的活動非常有用）。
• 預隱藏代碼段:僅隱藏頁面的某些部分。

使用Adobe TargetVEC

將VEC與 Platform Web SDK 實施、安裝和激活 火狐 或 鉻 VEC幫助程式擴展。

有關詳細資訊，請參見 Visual Experience Composer幫助程式擴展 的 Adobe Target指南。

呈現個性化內容

請參閱 呈現個性化內容 的子菜單。

XDM中的受眾

為您定義受眾時 Target 通過 Platform Web SDK。 XDM 必須定義和使用。 定義XDM架構、類和架構欄位組後，可以建立 Target 由XDM資料定義的目標用戶規則。 在 Target, XDM資料顯示在 受眾構建器 自定義參數。 XDM使用點符號進行序列化(例如， web.webPageDetails.name)。

如果 Target 使用自定義參數或用戶配置檔案的預定義受眾的活動，無法通過SDK正確提供。 您必須改用XDM，而不是使用自定義參數或用戶配置檔案。 但是，通過 Platform Web SDK 不需要XDM的。 這些欄位在 Target 不需要XDM的UI:

• Target 資料庫
• 地理
• 網路
• 作業系統
• 網頁
• 瀏覽器
• 流量來源
• 時間段

有關詳細資訊，請參見 受眾類別 的 Adobe Target指南。

回應 Token

響應令牌主要用於向第三方發送元資料，如Google、Facebook等。 在 meta 欄位 propositions -> items。 下面是一個示例：

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

要收集響應令牌，您必須訂閱 alloy.sendEvent 承諾，迭代 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);
  });

啟用自動呈現後，命題陣列包含：

在頁面載入上：

• 基於表單的作曲家 propositions 與 renderAttempted 標誌設定為 false
• 基於Visual Experience Composer的命題 renderAttempted 標誌設定為 true
• 基於Visual Experience Composer的命題，用於單頁應用程式視圖 renderAttempted 標誌設定為 true

在視圖上 — 更改（對於快取視圖）:

• 基於Visual Experience Composer的命題，用於單頁應用程式視圖 renderAttempted 標誌設定為 true

禁用自動呈現後，命題陣列包含：

在頁面載入上：

• 基於表單的作曲家 propositions 與 renderAttempted 標誌設定為 false
• 基於Visual Experience Composer的命題 renderAttempted 標誌設定為 false
• 基於Visual Experience Composer的命題，用於單頁應用程式視圖 renderAttempted 標誌設定為 false

在視圖上 — 更改（對於快取視圖）:

• 基於Visual Experience Composer的命題，用於單頁應用程式視圖 renderAttempted 標誌設定為 false

單個配置檔案更新

的 Platform Web SDK 允許您將配置檔案更新到 Target 和 Platform Web SDK 作為體驗活動。

更新 Target 配置檔案，確保通過以下方式傳遞配置檔案資料：

• 在 “data {“ 底下。
• 在 “__adobe.target” 底下。
• 前置詞 “profile.” 例如，如下

典型 Platform Web SDK 使用此命令的代碼如下所示：

sendEvent使用配置檔案資料

alloy("sendEvent", {
   renderDecisions: true|false,
   xdm: { // Experience Event XDM data },
   data: { // Freeform data }
});

如何將配置檔案屬性發送到Adobe Target:

alloy("sendEvent", {
  renderDecisions: true,
  data: {
    __adobe: {
      target: {
        "profile.gender": "female",
        "profile.age": 30
      }
    }
  }
});

請求建議

下表列出 Recommendations 屬性以及是否通過 Platform Web SDK:

如何將Recommendations屬性發送到Adobe Target:

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

為 除錯

已棄用mboxTrace和mboxDebug。 使用 Platform Web SDK 調試。

術語

建議： 在 Target，命題與從活動中選擇的體驗相關。

架構： 決策的模式是中的要約類型 Target。

範圍： 決定的範圍。 在 Target，範圍為mBox。 全局mBox是 __view__ 範圍。

XDM: 將XDM序列化為點表示法，然後將其放入 Target 框參數。