Platform Web SDKを使用したTargetへのパラメーターの送信
サイトのアーキテクチャ、ビジネス要件、使用される機能により、ターゲット実装はweb サイトによって異なります。 Adobe Targetの実装の多くは、コンテキスト情報、オーディエンス、コンテンツレコメンデーションのために様々なパラメーターを渡すことを含んでいます。
シンプルな商品詳細ページと注文確認ページを使用して、パラメーターをTargetに渡す際のライブラリの違いを示します。
at.jsを使用した次の2つのサンプルページを想定します。
| code language-html |
|---|
|
| code language-html |
|---|
|
パラメーターマッピングの概要
これらのページのTarget パラメーターは、Platform Web SDKを使用して異なる方法で送信されます。 at.jsを使用してTargetにパラメーターを渡すには、複数の方法があります。
- ページ読み込みイベントの
targetPageParams()関数で設定(このページの例で使用) - ページ上のすべてのTarget リクエストに
targetPageParamsAll()関数で設定 - 1か所の
getOffer()関数でパラメーターを直接送信する - 1つ以上の場所の
getOffers()関数でパラメーターを直接送信する
Platform Web SDKは、追加機能を必要とせずにデータを送信するための一貫した唯一の方法を提供します。 すべてのパラメーターは、sendEvent コマンドを使用してペイロードで渡す必要があり、次の2つのカテゴリに分類されます。
xdmオブジェクトから自動的にマッピングされますdata.__adobe.targetオブジェクトを使用して手動で渡されました
次の表は、Platform Web SDKを使用してパラメーターの例をどのように再マッピングするかを示しています。
pageNamexdm.web.webPageDetails.namexdm オブジェクトの一部として渡し、XDM ExperienceEvent クラスを使用してスキーマに準拠させる必要があります。 Mbox パラメーターをdata オブジェクトの一部として渡すことはできません。profile.genderdata.__adobe.target.profile.genderdata オブジェクトの一部として渡し、適切にマッピングするにはprofile.というプレフィックスを付ける必要があります。user.categoryIddata.__adobe.target.user.categoryIddata オブジェクトの一部として渡す必要があります。entity.iddata.__adobe.target.entity.idまたは
xdm.productListItems[0].SKUdata オブジェクトの一部として渡されるか、実装がそのフィールドグループを使用する場合は、xdm.productListItems配列内の最初の項目から自動的にマッピングされます。entity.categoryIddata.__adobe.target.entity.categoryIddata オブジェクトの一部として渡すことができます。entity.customEntitydata.__adobe.target.entity.customEntitydata オブジェクトの一部として渡す必要があります。cartIdsdata.__adobe.target.cartIdsexcludedIdsdata.__adobe.target.excludedIdsmbox3rdPartyIdxdm.identityMap オブジェクトに設定orderIdxdm.commerce.order.purchaseIDorderTotalxdm.commerce.order.priceTotalproductPurchasedIddata.__adobe.target.productPurchasedIdまたは
xdm.productListItems[0-n].SKUカスタムパラメーター
カスタム mbox パラメーターは、sendEvent コマンドを使用してXDM データとして渡す必要があります。 XDM スキーマに、Targetの実装に必要なすべてのフィールドが含まれていることを確認することが重要です。
targetPageParams()を使用したat.jsの例:
targetPageParams = function() {
return {
"pageName": "product detail"
};
};
sendEvent コマンドを使用したPlatform Web SDK JavaScriptの例:
| code language-javascript |
|---|
|
タグでは、まずXDM オブジェクト データ要素を使用してXDM フィールドにマッピングします。
次に、XDM オブジェクト を送信イベント アクション に含めます(複数のXDM オブジェクト は結合できます)。
xdm オブジェクトの一部であるため、新しい名前を使用して、これらのmbox パラメーターを参照するオーディエンス、アクティビティ、またはプロファイル スクリプトを更新する必要があります。 詳しくは、このチュートリアルの「Platform Web SDK互換のターゲットオーディエンスとプロファイルスクリプトの更新」ページを参照してください。プロファイルパラメーター
Target プロファイルパラメーターは、Platform Web SDK sendEvent コマンドペイロードのdata.__adobe.target オブジェクトに渡す必要があります。
at.jsと同様に、値を永続的なTarget プロファイル属性として適切に保存するには、すべてのプロファイルパラメーターにprofile.というプレフィックスを付ける必要があります。 Targetのカテゴリアフィニティ機能に対する予約されたuser.categoryId パラメーターには、user.が先頭に付けられます。
targetPageParams()を使用したat.jsの例:
targetPageParams = function() {
return {
"profile.gender": "male",
"user.categoryId": "clothing"
};
};
sendEvent コマンドを使用したPlatform Web SDKの例:
| code language-javascript |
|---|
|
タグで、まずデータ要素を作成してdata.__adobe.target オブジェクトを定義します。
そして、データオブジェクトを送信イベント アクション に含めます(複数の オブジェクト は結合できます)。
エンティティのパラメーター
エンティティパラメーターは、Target Recommendationsの行動データと追加カタログ情報を渡すために使用されます。 at.jsでサポートされているすべての エンティティパラメーターは、Platform Web SDKでもサポートされています。 プロファイルパラメーターと同様に、すべてのエンティティパラメーターは、Platform Web SDK sendEvent コマンドペイロードのdata.__adobe.target オブジェクトに渡す必要があります。
適切なデータキャプチャを行うには、特定の項目のエンティティパラメーターの先頭にentity.を付ける必要があります。 レコメンデーションアルゴリズム用に予約されているcartIdsおよびexcludedIds パラメーターにはプレフィックスを付けず、それぞれの値にはエンティティ IDのコンマ区切りリストを含める必要があります。
targetPageParams()を使用したat.jsの例:
targetPageParams = function() {
return {
"entity.id": "SKU-00001-LARGE",
"entity.categoryId": "clothing,shirts",
"entity.customEntity": "some value",
"cartIds": "SKU-00002,SKU-00003",
"excludedIds": "SKU-00001-SMALL"
};
};
sendEvent コマンドを使用したPlatform Web SDKの例:
| code language-javascript |
|---|
|
タグで、まずデータ要素を作成してdata.__adobe.target オブジェクトを定義します。
そして、データオブジェクトを送信イベント アクション に含めます(複数の オブジェクト は結合できます)。
commerce フィールドグループが使用され、productListItems配列がXDM ペイロードに含まれている場合、この配列内の最初のSKU値は、製品ビューを増分する目的でentity.idにマッピングされます。購入パラメーター
購入パラメーターは、注文が成功した後に注文確認ページで渡され、ターゲットのコンバージョンと最適化の目標に使用されます。 Platform Web SDKの実装では、これらのパラメーターとパラメーターは、commerce フィールドグループの一部として渡されたXDM データから自動的にマッピングされます。
targetPageParams()を使用したat.jsの例:
targetPageParams = function() {
return {
"orderId": "ABC123",
"productPurchasedId": "SKU-00002,SKU-00003"
"orderTotal": 1337.89
};
};
commerce フィールドグループのpurchases.valueが1に設定されている場合、購入情報がTargetに渡されます。 注文IDと注文合計は、order オブジェクトから自動的にマッピングされます。 productListItems配列が存在する場合、SKU値がproductPurchasedIdに使用されます。
sendEventを使用したPlatform Web SDKの例:
| code language-javascript |
|---|
|
タグでは、まずXDM オブジェクト データ要素を使用して、必須のXDM フィールド(JavaScriptの例を参照)とオプションのカスタムスコープにマッピングします。
次に、XDM オブジェクト を送信イベント アクション に含めます(複数のXDM オブジェクト は結合できます)。
_experience.decisioning.propositionEventTypeをdisplay: 1に設定する必要があります。orderConfirmPage)を使用する場合は、上記の例のように、_experience.decisioning.propositions配列にカスタムスコープを入力します。productPurchasedId値は、data オブジェクトの下のエンティティ IDのコンマ区切りリストとして渡すこともできます。顧客Id (mbox3rdPartyId)
Adobe Targetでは、単一の顧客IDを使用して、デバイスやシステムをまたいでプロファイルを同期できます。 at.jsでは、これはTarget リクエストのmbox3rdPartyIdとして設定することも、Experience Cloud ID サービスに送信される最初の顧客IDとして設定することもできます。 at.jsとは異なり、Platform Web SDKの実装では、複数の場合にmbox3rdPartyIdとして使用する顧客IDを指定できます。 例えば、ビジネスがグローバル顧客IDを持ち、事業部門ごとに個別の顧客IDを使用している場合、どのIDをTargetで使用するかを設定できます。
クロスデバイスと顧客属性のユースケースに対してID同期を設定するには、いくつかの手順があります。
- データ収集またはプラットフォームの ID 画面で、顧客IDの ID名前空間 を作成します
- 顧客属性の エイリアス が、名前空間の ID シンボル と一致していることを確認してください
- データストリームのターゲット設定で ID シンボル を ターゲットサードパーティ ID名前空間 として指定します
identityMapフィールドグループを使用してsendEventコマンドを実行します
targetPageParams()を使用したat.jsの例:
targetPageParams = function() {
return {
"mbox3rdPartyId": "TT8675309"
};
};
sendEvent コマンドを使用したPlatform Web SDKの例:
| code language-javascript |
|---|
|
ID値、認証状態および名前空間は、ID マップ データ要素でキャプチャされます。
次に、ID マップ データ要素を使用して、XDM オブジェクト データ要素のidentityMap フィールドを設定します。
次に、XDM オブジェクト は、ルールの イベントを送信 アクションに含まれます。
データストリームのAdobe Target サービスで、必ずTarget サードパーティ ID名前空間をID マップ データ要素で使用されているのと同じ名前空間に設定してください。
Platform Web SDKの例
様々なTarget パラメーターがPlatform Web SDKを使用してマッピングされる方法を理解したところで、次に示すように、2つのサンプルページをat.jsからPlatform Web SDKに移行できます。 サンプルページには、次の内容が含まれます。
- 非同期ライブラリ実装の事前非表示スニペットをターゲットにする
- Platform Web SDKのベースコード
- Platform Web SDK JavaScript ライブラリ
- ライブラリを初期化する
configureコマンド - データを送信し、レンダリングするTarget コンテンツを要求する
sendEventコマンド
| code language-html |
|---|
|
| code language-html |
|---|
|
次に、Platform Web SDKを使用してTarget コンバージョンイベント 🔗を追跡する方法について説明します。