Platform Web SDK の互換性に合わせた Target オーディエンスとプロファイルスクリプトの更新

Target を Platform Web SDK に移行する技術的な更新を完了した後、スムーズな移行を確保するために、オーディエンス、プロファイルスクリプト、アクティビティの一部を更新する必要が生じる場合があります。

すべての Target mbox パラメーターは、Platform Web SDK 実装を使用して、XDM 形式で渡す必要があります。 変更を実稼動環境に公開する前に、次を行う必要があります。

オーディエンスの調整

カスタム mbox パラメーターを使用するオーディエンスは、新しい XDM パラメーター名を使用するように更新してください。 例えば、page_name のカスタムパラメーターは、web.webpagedetails.pageName にマッピングされる可能性があります。

at.js と Platform Web SDK の両方との互換性を確保する 1 つのアプローチは、以下に示すように、関連するオーディエンスを更新して、OR の条件が使用されるようにすることです。

{modal="regular"}

プロファイルスクリプトの編集

プロファイルスクリプトは、オーディエンスに類似した新しい XDM パラメーター名を参照するように更新する必要があります。 mbox パラメーター名の変更以外に、at.js と Platform Web SDK 実装の間でプロファイルスクリプトの動作方法に違いはありません。

互換性を確保する 1 つのアプローチは、プロファイルスクリプトコードで OR 条件を使用することです。

プロファイルスクリプトの例：

if(mbox.param('pageName') == 'Product Details'){
  return true
}

Platform Web SDK 互換性のための更新されたプロファイルスクリプト：

if((mbox.param('pageName') == 'Product Details') || (mbox.param('web.webPageDetails.pageName') =='Product Details')){
  return true
}

詳細とベストプラクティスについては、 プロファイルスクリプトに関する専用ドキュメントを参照してください。

動的コンテンツのパラメータートークンの更新

動的コンテンツ置換を使用するオファー、レコメンデーションデザインまたはアクティビティがある場合は、新しい XDM パラメーター名を考慮して、それに応じて更新する必要がある場合があります。

mbox パラメーターのトークン置き換えの使用方法によっては、古いパラメーター名と新しいパラメーター名の両方が考慮されるように、既存の設定を強化できる場合があります。 ただし、JSON オファーなど、カスタム JavaScript コードが利用できない状況では、移行が完了して実稼動サイトに移行した後、コピーを作成して更新を行う必要があります。

JSON オファーの例：

{
  "pageName" : "${mbox.page_name}",
  "layoutVariation" : "grid"
}

Platform Web SDK パラメーター名を使用した JSON オファーの例：

{
  "pageName" : "${mbox.web.webPagedDetails.pageName}",
  "layoutVariation" : "grid"
}

移行後に調整を行って新しい XDM mbox パラメーター名を考慮する場合は、影響を受けるアクティビティを移行イベント中に一時停止して、訪問者にアクティビティ表示エラーが表示されないようにしてください。

次に、Target 実装の検証方法を説明します。