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

Adobe 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実装を検証する方法について説明します。