at.js を使用して Analytics for Target（A4T）を実装する前に

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Analytics for Target（A4T）

Adobe Target（A4T）のレポートソースとして Adobe Analytics を有効にすると、データ収集プロセスでいくつかの変更が発生します。

この統合の使用を決定する前に、以降の節を確認し、レポートプロセスへの影響を検討してください。

NOTE

この記事は、at.js 実装のみを対象としています。

実装の必要システム構成 section_A0D2EF18033D4C3997B08A6EBB34C17A

IMPORTANT

A4T の使用を開始する前に、事前にアカウントで統合のプロビジョニングを依頼しておく必要があります。Marketing Cloud 統合プロビジョニングフォームを使用して、プロビジョニングを依頼します。

この A4T 統合では、A4T でリダイレクトオファーを使用するかどうかに応じて、次のバージョン以降のライブラリを実装する必要があります。

NOTE

次の要件は、A4T を実装するために必要な at.js の最小バージョンを表示します。Target チームがサポートを提供しているのは、at.js の最新バージョンとその 1 つ前のバージョンの 2 つのみです。必要に応じて at.js をアップグレードし、サポート対象のバージョンを使用するようにしてください。各バージョンについて詳しくは、at.js のバージョンの詳細を参照してください。

A4T でリダイレクトオファーを使用しない場合に必要な要件

この統合で、A4T でのリダイレクトオファーを使用しない場合は、次のバージョン以降のライブラリを実装する必要があります。リストされている順序は、操作の順序です。

Experience Cloud Visitor ID Service：visitorAPI.js バージョン 1.8.0
Adobe Target: at.js バージョン 0.9.1
Adobe Analytics：appMeasurement.js バージョン 1.7.0

Platform Web SDK を使用した A4T の実装については、Adobe Experience Platform Web SDK を参照してください。

A4T でリダイレクトオファーを使用する場合に必要な要件

A4T でリダイレクトオファーを使用する場合は、次のバージョン以降のライブラリを実装する必要があります。リストされている順序は、操作の順序です。

Experience Cloud Visitor ID Service：visitorAPI.js バージョン 2.3.0

note note
NOTE
at.js 1.8.0+ および at.js 2.x+ は、Adobe Audience Manager（AAM）パラメーターを渡す際、2.5.0 よりも古いバージョンの訪問者 API では動作しなくなりました。

Adobe Target: at.js バージョン 1.6.2
Adobe Analytics：appMeasurement.js バージョン 2.1

ダウンロードおよびデプロイメントの手順については、Analytics for Target 実装に記載されています。

Platform Web SDK を使用した A4T の実装については、Adobe Experience Platform Web SDK を参照してください。

実装の前に知っておくべきこと section_50D49CC52E11414089C89FB67F9B88F5

Analytics をレポートソースとして使用することを選択すると、新しいアクティビティで統合が有効になります。この文書に書かれた実装の変更をおこなっても、既存のアクティビティは影響を受けません。
Analytics を Target のレポートソースとして設定するプロセスには、いくつかの実装ステップと、それに続くプロビジョニングのステップが含まれます。実装前に、以下の手順をすべて読んでおくことをお勧めします。これらの手順を完了すると、Analytics が有効になったときにレポートソースとして使用できるようになります。プロビジョニングのプロセスには、最大で 5 営業日かかる場合があります。
Visitor ID service は、Adobe Experience Cloud をまたいで共有 Visitor ID を作成します。Target mboxPC ID や Audience Manager UUID は置き換えませんが、Analytics が新しい訪問者を識別する方法を置き換えます。適切に設定されている場合、Analytics の再訪問者も古い Analytics ID で識別される必要があります。同様に、Target mboxPCid は元の状態のままなので、Visitor ID service にアップグレードしても Target 訪問者プロファイルデータは失われません。
Visitor ID service は、Analytics および Target ページコードの前に実行する必要があります。他のすべての Experience Cloud ソリューションのタグの上に VisitorAPI.js が表示されていることを確認してください。

遅延 section_9489BE6FD21641A4844E591711E3F813

この統合を有効にすると、Analytics で 5～10 分の待ち時間が追加で発生します。この追加の待ち時間により、Analytics と Target のデータを同じヒットに格納できるため、ページおよびサイトセクションによってアクティビティを分類できるようになりました。

この追加の待ち時間は、ライブストリームやリアルタイムレポートなど、すべての Analytics サービスおよびツールに反映され、以下のシナリオで適用されます。

ライブストリーム、リアルタイムのレポートと API リクエスト、トラフィック変数の現在のデータでは、追加のデータ ID が設定されたヒットのみが遅延します。
コンバージョン指標の現在のデータ、ファイナライズされたデータ、データフィードでは、すべてのヒットが追加で 5～7 分遅延します。

この統合を完全に実装していなくても、Experience Cloud 訪問者 ID サービスを実装すると追加の待ち時間が発生します。

追加の ID section_2C1F745A2B7D41FE9E30915539226E3A

コンテンツを配信したり目標指標を記録したりするために A4T アクティビティで使用されるすべての Target 呼び出しには、A4T が正しく機能するための補足 ID を共有する、対応する Analytics ヒットが必要です。

Analytics および Target からのデータを含むヒットには、追加のデータ ID が含まれています。この ID は、Adobe Experience Cloud Debugger で sdid パラメーターとして確認できます。例えば、sdid=2F3C18E511F618CC-45F83E994AEE93A0 のようになります。この ID は、次の条件が満たされると常に生成されます。

訪問者 ID サービスが導入されている

トラブルシューティングを行う場合は、Analytics のヒットに追加の ID が存在することを確認してください。

クライアントサイド分析ログ client-side

at.js、Experience Cloud Visitor ID Service および appMeasurement.js がページ上にある場合、ページから正しい追加の ID が含まれている限り、Analytics および Target は、レポートおよび分析目的で、バックエンドでイベントを正しくスティッチします。A4T が正しく機能するための、追加の操作を管理および実行する必要はありません。

レポートの目的で、Target に関連する分析データをいつどのように Analytics に送信するかを、より詳細に制御したい場合があります。内部目的で使用する社内分析ツールがある場合があります。ただし、組織の他のメンバーがビジュアルレポートソースとして Analytics を引き続き使用できるように、社内の分析製品経由で Analytics に分析データを送信したい場合もあります。詳しくは、Analytics for Target 実装 のステップ 7：サイトのすべてのページから at.js を参照を参照してください。