SDKの初期化
SDKの初期化図の手順に従って、Adobe Target at.js JavaScript ライブラリの読み込みに必要なすべてのタスクが正しい順序で実行されるようにします。
SDK ダイアグラムの初期化 diagram
複数ページアプリケーションの場合、このフローは、ページが再読み込みされるか、訪問者がweb サイト上の新しいページに移動するたびに発生します。
次のリンクをクリックして、目的のセクションに移動します。
1.1:訪問者API SDKの読み込み load
この手順は、VisitorAPI.js ライブラリが正しく読み込まれ、設定され、初期化されていることを確認するのに役立ちます。
前提条件
- 訪問者ID/API サービスを使用するには、会社がAdobe Experience Cloudに対して有効になっており、Organization IDが設定されている必要があります。 詳しくは、Identity Service ヘルプ ガイドの「Experience Cloud要件:組織ID」を参照してください。
VisitorAPI.jsファイルが必要です。 Adobe Analyticsが実装されている場合は、このファイルを既に用意しておく必要があります。 このファイルは、Adobe Experience Platform tags拡張機能を通じて追加することも、Adobe Analytics Code Managerからダウンロードすることもできます。
VisitorAPI.jsの設定と参照
詳しくは、Target用Experience Cloud サービスの実装を参照してください。
読み取り
- Experience Cloud Identity Serviceの概要
- ID サービスについて
- Cookies および Experience Cloud ID サービス
- Experience Cloud Identity ServiceがIDをリクエストおよび設定する方法
- IDの同期と一致率について
アクション
- Web ページに
VisitorAPI.jsファイルを埋め込みます。 - 訪問者ID/API サービス 🔗で使用できる構成について説明します。
VisitorAPI.jsファイルが読み込まれたら、Visitor.getInstanceメソッドを使用して、必要な構成を使用して初期化します。- 使用可能なメソッド について説明します。
1.2:顧客IDの設定 set
この手順は、訪問者の既知のID (CRM ID、ユーザーIDなど)をクロスデバイスのパーソナライゼーション用にAdobeの匿名IDに関連付けるのに役立ちます。
前提条件
- 訪問者の既知のIDは、データレイヤーで利用できる必要があります。
顧客IDを設定
詳しくは、setCustomerIDsを参照してください。
読み取り
アクション
visitor.setCustomerIDsを使用して、訪問者の既知のIDを設定します。
1.3:自動ページ読み込みリクエストの設定 automatic
この手順により、at.jsは、at.js JavaScript ライブラリファイルの読み込み中にページ上でレンダリングする必要があるすべてのエクスペリエンスを取得できます。
前提条件
- データ レイヤー内のすべてのデータをTargetに送信する必要はありません。 ビジネスチーム(デジタルマーケティングチーム)と相談して、どのデータが実験、最適化、パーソナライゼーションに役立つかを判断してください。 このデータのみをTargetに送信する必要があります。
- 個人を特定できる情報(PII) データをTargetに送信しないでください。
自動ページ読み込み要求の設定
詳しくは、targetGlobalSettings() を参照してください。
読み取り
targetGlobalSettings () のpageLoadEnabled設定について説明します。
アクション
- 自動ページ読み込み要求を有効にするには、
window.targetGlobalSettingsオブジェクトを変更します。
1.4:ちらつき処理の設定 flicker
このステップは、エクスペリエンスの配信時にページのちらつきが発生しないようにするのに役立ちます。
前提条件
- at.jsで使用されるデフォルトのメソッドを使用してフリッカーを制御する長所と短所について、web ページのパフォーマンスを担当するチームと話し合います。 ローダーアニメーションなどのカスタムフリッカー処理ソリューションを使用できるデザインパターンを検索できます。 パターンが見つからない場合は、新しいパターンをリクエストできます。
ちらつき処理の設定
詳しくは、targetGlobalSettings() を参照してください。
bodyHidingEnabledをtrueに設定すると、ページ読み込み要求の処理中にページ本文全体が非表示になります。 何らかの理由で自動ページ読み込み要求を有効にしていない場合(データの準備が整っていない場合など)、この設定をfalseに設定することをお勧めします。
APLRを実行したくなく、後でページリクエストを実行する必要がある場合、またはフリッカー処理が不要な場合は、独自のフリッカー処理を実装する必要があります。 bodyHidingEnabledフリッカーは、テスト中のセクションを非表示にするか、テスト中のセクションにスロバーを表示することで、2つの方法で処理できます。
読み取り
- at.js によるちらつきの制御方法
- targetGlobalSettings () のbodyHiddenStyle オブジェクトとbodyHidingEnabled オブジェクトについて説明します。
アクション
window.targetGlobalSettingsオブジェクトを変更してbodyHiddenStyleとbodyHidingEnabledを設定します。
1.5: データマッピングの設定 data-mapping
この手順を実行すると、Targetに送信する必要があるすべてのデータが設定されます。
前提条件
-
データ レイヤーは、Targetに送信する必要があるすべてのデータで準備できなければなりません。
-
推奨事項:プロファイルの強化。
entity.idを渡すと、最近閲覧した商品に基づいて、最近閲覧した基準と項目のデータが取得されます。entity.idを渡して、お気に入りのカテゴリに基づく人気条件のデータを取得します。- カスタム基準が基準に基づいている場合、または任意の基準での包含ルールのフィルタリングで使用される場合は、プロファイル属性を渡します。
-
推奨事項:商品データを取り込みます。
- その他のエンティティ パラメーター(予約済みおよびカスタム)を渡して、製品カタログを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:除外Idを指定する exclude
レコメンデーションから除外するエンティティのエンティティ IDを渡します。 例えば、既に買い物かごにある項目は除外した方がよいでしょう。
読み取り
1.14: entity.event.detailsOnly=true パラメーターを渡します true
エンティティ属性を使用して、製品情報またはコンテンツ情報を Target Recommendations に渡します。
読み取り
1.15: リモートデータマッピングの設定(リモート)
この手順により、Targetに送信する必要のあるすべてのデータが設定されます。
前提条件
- データ層は、Targetに送信する必要があるすべてのデータで準備できなければなりません。
データプロバイダーの設定
詳しくは、 データプロバイダーを参照してください。
読み取り
アクション
targetPageParams()関数を使用して、Targetに送信する必要があるすべての必須データを設定します。
1.16: at.jsの読み込み web
この手順により、at.js JavaScript ライブラリが読み込まれ、初期化されます。
前提条件
at.js 2.*x*JavaScript ライブラリファイルをダウンロードするか、デジタルマーケティング部門に問い合わせます。
読み取り
アクション
テスト、最適化、パーソナライゼーション、データ収集が必要なあらゆるweb ページにat.js ファイルを埋め込むことができます。
手順2: データ収集の設定に進みます。