SDKの初期化

SDKの初期化​図の手順に従って、Adobe Target at.js JavaScript ライブラリの読み込みに必要なすべてのタスクが正しい順序で実行されるようにします。

TIP
このトピックの画像をクリックして、フルスクリーンに展開します。

SDK ダイアグラムの初期化 diagram

複数ページアプリケーションの場合、このフローは、ページが再読み込みされるか、訪問者がweb サイト上の新しいページに移動するたびに発生します。

NOTE
次の図の手順の番号は、以下の節に対応しています。 ステップ番号は特定の順序ではなく、アクティビティの作成中にTarget UIで実行されたステップの順序は反映されません。

SDK ダイアグラムの初期化 {width="600" modal="regular"}

次のリンクをクリックして、目的のセクションに移動します。

1.1:訪問者API SDKの読み込み load

この手順は、VisitorAPI.js ライブラリが正しく読み込まれ、設定され、初期化されていることを確認するのに役立ちます。

詳細を見る

訪問者API SDK ダイアグラムの読み込み {width="400" modal="regular"}

前提条件

  • 訪問者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 サービスの実装を参照してください。

読み取り

アクション

  • Web ページにVisitorAPI.js ファイルを埋め込みます。
  • 訪問者ID/API サービス 🔗で使用できる構成について説明します。
  • VisitorAPI.js ファイルが読み込まれたら、Visitor.getInstance メソッドを使用して、必要な構成を使用して初期化します。
  • 使用可能なメソッド ​について説明します。

このページの上部にある図に戻ります。

1.2:顧客IDの設定 set

この手順は、訪問者の既知のID (CRM ID、ユーザーIDなど)をクロスデバイスのパーソナライゼーション用にAdobeの匿名IDに関連付けるのに役立ちます。

詳細を見る

顧客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() を参照してください。

bodyHidingEnabledtrueに設定すると、ページ読み込み要求の処理中にページ本文全体が非表示になります。 何らかの理由で自動ページ読み込み要求を有効にしていない場合(データの準備が整っていない場合など)、この設定をfalseに設定することをお勧めします。

APLRを実行したくなく、後でページリクエストを実行する必要がある場合、またはフリッカー処理が不要な場合は、独自のフリッカー処理を実装する必要があります。 bodyHidingEnabledフリッカーは、テスト中のセクションを非表示にするか、テスト中のセクションにスロバーを表示することで、2つの方法で処理できます。

読み取り

アクション

  • window.targetGlobalSettings オブジェクトを変更してbodyHiddenStylebodyHidingEnabledを設定します。

このページの上部にある図に戻ります。

1.5: データマッピングの設定 data-mapping

この手順を実行すると、Targetに送信する必要があるすべてのデータが設定されます。

詳細を見る

​ データマッピング図 {width="400" modal="regular"}

前提条件

  • データ レイヤーは、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

利用者の行動にもとづいてレコメンデーションする:

詳細を見る

使用可能な条件

  • Recently Viewed Items
  • Recommended for You

エンティティ パラメーターが必要

  • entity.id

読み取り

このページの上部にある図に戻ります。

1.11: カスタム基準 custom

アップロードしたカスタムファイルにもとづいて、レコメンデーションを作成できます。

詳細を見る

使用可能な条件

  • Custom algorithm

エンティティ パラメーターが必要

entity.idまたはカスタムアルゴリズムのキーとして使用される属性

読み取り

このページの上部にある図に戻ります。

1.12:包含ルールで使用される属性を指定する inclusion

このページの上部にある図に戻ります。

1.13:除外Idを指定する exclude

レコメンデーションから除外するエンティティのエンティティ IDを渡します。 例えば、既に買い物かごにある項目は除外した方がよいでしょう。

このページの上部にある図に戻ります。

1.14: entity.event.detailsOnly=true パラメーターを渡します true

エンティティ属性を使用して、製品情報またはコンテンツ情報を Target Recommendations に渡します。

詳細を見る

読み取り

このページの上部にある図に戻ります。

1.15: リモートデータマッピングの設定(リモート)

この手順により、Targetに送信する必要のあるすべてのデータが設定されます。

詳細を見る

​ リモートデータマッピング図 {width="400" modal="regular"}

前提条件

  • データ層は、Targetに送信する必要があるすべてのデータで準備できなければなりません。

データプロバイダーの設定

詳しくは、​ データプロバイダーを参照してください。

読み取り

targetPageParams関数

アクション

targetPageParams()関数を使用して、Targetに送信する必要があるすべての必須データを設定します。

このページの上部にある図に戻ります。

1.16: at.jsの読み込み web

この手順により、at.js JavaScript ライブラリが読み込まれ、初期化されます。

詳細を見る

Adobe Target at.js ダイアグラムを読み込む {width="400" modal="regular"}

前提条件

  • at.js 2.*x* JavaScript ライブラリファイルをダウンロードするか、デジタルマーケティング部門に問い合わせます。

読み取り

アクション

テスト、最適化、パーソナライゼーション、データ収集が必要なあらゆるweb ページにat.js ファイルを埋め込むことができます。

このページの上部にある図に戻ります。

手順2: ​ データ収集の設定に進みます。

recommendation-more-help
target-dev-help-dev