SDK の初期化
SDK の初期化 の図に示す手順に従って、Adobe Target at.js JavaScript ライブラリの読み込みに必要なすべてのタスクが正しい順序で実行されていることを確認します。
SDK 図の初期化 diagram
複数ページアプリケーションの場合、このフローは、ページがリロードされるか、訪問者が web サイト上の新しいページに移動するたびに発生します。
{width="600" modal="regular"}
次のリンクをクリックして、目的のセクションに移動します。
- 1.1:訪問者 API SDK の読み込み
- 1.2:顧客 ID の設定
- 1.3:自動ページ読み込みリクエストの設定
- 1.4:ちらつき処理の設定
- 1.5:データマッピングの設定
- 1.6:プロモーション
- 1.7:買い物かごベースの条件
- 1.8:人気に基づく基準
- 1.9:品目ベースの基準
- 1.10:ユーザーベースの条件
- 1.11:カスタム条件
- 1.12:インクルージョンルールで使用する属性を指定する
- 1.13:excludedIds の指定
- 1.14: entity.event.detailsOnly=true パラメーターを渡す
- 1.15: リモートデータマッピングの設定
- 1.16: at.js の読み込み
1.1:訪問者 API SDK の読み込み load
この手順は、VisitorAPI.js
ライブラリが正しく読み込まれ、設定および初期化されていることを確認するのに役立ちます。
{width="400" modal="regular"}
前提条件
- 訪問者 ID/API サービスを使用するには、Adobe Experience Cloud に対して会社が有効になっており、Organization ID が付与されている必要があります。 詳しくは、{ID サービスのヘルプ 🔗 ガイドの {0 Experience Cloud要件:組織 ID を参照してください。
VisitorAPI.js
ファイルが必要です。 既に実装されている場合は、このファイルが既に存在しているはず Adobe Analytics す。 このファイルは、Adobe Experience Platform tags extension を使用して追加することも、Adobe Analytics Code Manager からダウンロードすることもできます。
VisitorAPI.js の設定と参照
詳しくは、Target のExperience Cloudサービスを実装するを参照してください。
読み取り
- Experience Cloud ID サービスの概要
- ID サービスについて
- Cookie とExperience CloudID サービス
- Experience CloudID サービスによる ID のリクエスト方法と設定方法
- ID 同期と一致率について
アクション
VisitorAPI.js
ファイルを Web ページに埋め込みます。- 詳しくは、 訪問者 ID/API サービスで使用可能な設定を参照してください。
VisitorAPI.js
ファイルが読み込まれたら、Visitor.getInstance
メソッドを使用して、必要な設定を使用して初期化します。- 使用可能なメソッドを理解します。
1.2:顧客 ID の設定 set
この手順は、訪問者の既知の ID (CRM ID、ユーザー ID など)を Adobe の匿名 ID に結び付けて、クロスデバイスパーソナライゼーションを確実に行うのに役立ちます。
{width="400" modal="regular"}
前提条件
- 訪問者の既知の ID は、データレイヤーで利用できる必要があります。
顧客 ID を設定
詳しくは、「setCustomerIDs」を参照してください。
読み取り
アクション
visitor.setCustomerIDs
を使用して、訪問者の既知の ID を設定します。
1.3:自動ページ読み込みリクエストの設定 automatic
この手順により、at.js は、at.js JavaScript ライブラリファイルの読み込み中に、ページ上でレンダリングする必要があるすべてのエクスペリエンスを取得できます。
{width="400" modal="regular"}
前提条件
- データレイヤー内のすべてのデータを Target に送信する必要があるわけではありません。 ビジネスチーム(デジタルマーケティングチーム)に問い合わせて、実験、最適化、パーソナライゼーションにとって価値のあるデータを判断します。 このデータのみを Target に送信する必要があります。
- 個人を特定できる情報(PII)のデータを Target に送信しないようにしてください。
自動ページ読み込みリクエストを設定
詳しくは、targetGlobalSettings() を参照してください。
読み取り
targetGlobalSettings ()の pageLoadEnabled
設定について説明します。
アクション
window.targetGlobalSettings
オブジェクトを変更して、自動ページ読み込みリクエストを有効にします。
1.4:ちらつき処理の設定 flicker
この手順は、エクスペリエンスの配信時にページのちらつきを回避するのに役立ちます。
{width="400" modal="regular"}
前提条件
- at.js で使用されるデフォルトの方法を使用してちらつきの制御に関するメリットとデメリットについて、web ページのパフォーマンスを担当するチームと話し合います。 ローダーアニメーションなど、カスタムのちらつき処理ソリューションを使用できるデザインパターンを検索できます。 パターンが見つからない場合は、新しいパターンをリクエストできます。
ちらつき処理の設定
詳しくは、targetGlobalSettings() を参照してください。
bodyHidingEnabled
を true
に設定すると、ページ読み込みリクエストの処理中に、ページ本文全体が非表示になります。 何らかの理由で自動ページ読み込みリクエストを有効にしていない場合(後でデータの準備が整っていない場合など)、この設定を false
に設定することをお勧めします。
APLR を実行せずに後でページ リクエストを実行するために bodyHidingEnabled
を無効にした場合、またはちらつき処理を必要としない場合は、独自のちらつき処理を実装する必要があります。 ちらつきの処理には、テスト中のセクションを非表示にする方法と、テスト中のセクションに絞り込みを表示する方法の 2 つがあります。
読み取り
- at.js によるちらつきの制御方法
- targetGlobalSettings ()の bodyHiddenStyle オブジェクトと bodyHidingEnabled オブジェクトについて説明します。
アクション
bodyHiddenStyle
およびbodyHidingEnabled
を設定するようにwindow.targetGlobalSettings
オブジェクトを修正します。
1.5:データマッピングの設定 data-mapping
この手順は、Target に送信する必要があるすべてのデータが設定されていることを確認するのに役立ちます。
{width="400" modal="regular"}
前提条件
-
データレイヤーには、Target に送信する必要のあるすべてのデータが準備されているはずです。
-
Recommendations: プロファイルを強化します。
- 最後に閲覧された製品に基づく条件に基づいて、最近閲覧された条件および項目のデータをキャプチャする
entity.id
を渡します。 - お気に入りのカテゴリに基づいて、人気度条件のデータをキャプチャする
entity.id
を渡します。 - カスタム条件がプロファイル属性に基づいている場合、または任意の条件の包含ルールフィルタリングで使用されている場合は、プロファイル属性を渡します。
- 最後に閲覧された製品に基づく条件に基づいて、最近閲覧された条件および項目のデータをキャプチャする
-
Recommendations:商品データの取り込み。
- その他のエンティティパラメーター(予約済みおよびカスタム)を渡して、Recommendations で商品カタログを取得または更新できます。
- 製品カタログは、Target UI または API を使用したエンティティフィードを使用して更新することもできます。
データをTarget にマッピングする
詳しくは、targetPageParams ()を参照してください。
読み取り
アクション
targetPageParams()
関数を使用して、Target に送信する必要のあるすべての必要なデータを設定します。
1.6:プロモーション promotion
昇格された項目を追加し、Target Recommendations ージでの配置を制御します デザイン。
1.7:買い物かごベースの条件 cart
ユーザーの買い物かごの中身に基づいてお勧めを紹介します。
利用可能な条件
- People Who Viewed These, Viewed Those
- People Who Viewed These, Bought Those
- People Who Bought These, Bought Those
必要なエンティティ パラメーター
- cartIds
読み取り
1.8:人気に基づく基準 popularity
サイト全体でのアイテムの全体的な人気度に基づいて、またはユーザーのお気に入りのカテゴリや最も多く閲覧されたカテゴリ、ブランド、ジャンルなどのアイテムの人気度に基づいて、レコメンデーションを作成します。
利用可能な条件
- Most Viewed Across the Site
- Most Viewed by Category
- Most Viewed by Item Attribute
- Top Sellers Across the Site
- Top Sellers by Category
- Top Sellers by Item Attribute
- Top by Analytics Metric
必要なエンティティ パラメーター
- 基準が現在の項目または項目属性に基づいている場合は、人気度の
entity.categoryId
または項目属性。 - サイト全体で最も多く閲覧/トップの販売に対して何も渡さない
読み取り
1.9:品目ベースの基準 item
ユーザーが表示している項目または最近表示した項目に類似した項目を見つけることに基づいてお勧めを紹介します。
利用可能な条件
- People Who Viewed This, Viewed That
- People Who Viewed This, Bought That
- People Who Bought This, Bought That
- Items with Similar Attributes
必要なエンティティ パラメーター
- キーとして使用される
entity.id
または任意のプロファイル属性
読み取り
1.10:ユーザーベースの条件 user
ユーザーの行動に基づいてお勧めを紹介します。
1.11:カスタム条件 custom
アップロードしたカスタムファイルに基づいてお勧めを紹介します。
1.12:インクルージョンルールで使用する属性を指定する inclusion
1.13:excludedIds の指定 exclude
レコメンデーションから除外したいエンティティのエンティティ ID を渡します。 例えば、既に買い物かごにある項目は除外した方がよいでしょう。
1.14: entity.event.detailsOnly=true
パラメーターを渡す true
エンティティ属性を使用して、製品またはコンテンツの情報を Target Recommendations に渡します。
読み取り
1.15: リモートデータマッピングの設定(remote)
この手順により、Target に送信する必要があるすべてのデータが設定されます。
{width="400" modal="regular"}
前提条件
- データレイヤーは、Target に送信する必要があるすべてのデータで準備が整っている必要があります。
データプロバイダーの設定
詳しくは、 データプロバイダーを参照してください。
読み取り
アクション
targetPageParams()
関数を使用して、Target に送信する必要のあるすべての必要なデータを設定します。
1.16: at.js の読み込み web
この手順では、at.js JavaScript ライブラリが読み込まれ、初期化されるようにします。
{width="400" modal="regular"}
前提条件
at.js 2.*x*
JavaScript ライブラリファイルをダウンロードするか、デジタルマーケティングチームに問い合わせます。
読み取り
アクション
at.js ファイルは、実験、最適化、パーソナライゼーション、データ収集が行われる必要があるすべての web ページに埋め込みます。
手順 2: データ収集の設定に進みます。