Adobe Analytics 2.0 コネクタ構成ガイド

仕組み

Adobe Analytics 2.0 コネクタは、Web ページやモバイルアプリで JavaScript ビーコンを使用する代わりに、Adobe Bulk Data Insertion API を使用して分析データを送信します。これにより、クライアント側から送信されるデータ量を削減できるほか、オーディエンスデータと訪問データを Adobe Analytics に渡せるという利点もあります。

Adobe Analytics 2.0 コネクタの相違点

Adobe Bulk Data Insertion API には、リアルタイムまたは準リアルタイムのコネクタアクションをサポートしないレート制限があります。このため、Adobe Analytics 2.0 コネクタでは、分析イベントを送信アクションが非推奨になっています。ユースケースでリアルタイムのコネクタアクションが不要な場合は、**分析イベントを送信（バッチ）**アクションに移行してください。ユースケースでリアルタイムのコネクタアクションが必要な場合は、Adobe Analytics 1.4 コネクタを使用してください。

Adobe Analytics 1.4 コネクタの以下の機能は、Adobe Analytics 2.0 コネクタでは使用できません。

• カスタムフィールドマッピング（詳細）
• モバイルデータソースのライフサイクルイベント属性の自動マッピングを有効化

次の表に示すように、Adobe Analytics 1.4 の一部のパラメータは Adobe Analytics 2.0 コネクタでは使用できません。Adobe Analytics 2.0 パラメータ列の ✗ は、そのパラメータが 2.0 コネクタでは使用できないことを示します。

Adobe Analytics 1.4 コネクタから Adobe Analytics 2.0 コネクタへの移行については、移行ツールを参照してください。

構成

Adobe Analytics 2.0 コネクタを構成するには、Adobe Analytics 2.0 API のクライアント ID（API キー）とクライアントシークレットが必要です。Adobe Developer Console で認証情報を作成し、Adobe Analytics 2.0 API のクライアント ID とクライアントシークレットを取得するには、次の手順を実行します。

1. Adobe Developer Console に移動し、Adobe ID でログインします。
2. 新しいプロジェクトを作成をクリックします。
3. プロジェクトの名前を入力し、保存をクリックします。
4. プロジェクトダッシュボードで、API を追加をクリックします。
5. 使用可能な API の一覧から、Adobe Analytics を選択します。
6. 認証タイプで、サーバー間認証を選択します。
7. 統合タイプとして、OAuth サーバー間を選択します。
8. アクセス権を付与する製品プロファイルを選択します。
9. クライアント ID とクライアントシークレットを取得するには、プロジェクトの認証情報セクションに移動します。
10. クライアント ID とクライアントシークレットを表示してコピーするには、クライアントシークレットを取得をクリックします。

クライアント ID とクライアントシークレットを取得したら、インターフェイスで次の手順を実行して Adobe Analytics コネクタを構成します。

1. コネクタマーケットプレイスに移動し、Adobe Analytics コネクタを追加します。
   詳細については、コネクタについてを参照してください。
2. オーディエンスとトリガーを選択し、続行をクリックします。
3. コネクタを追加をクリックします。
4. コネクタの名前を入力します。
5. クライアント ID とクライアントシークレットを入力します。
6. （任意）接続をテストをクリックします。
7. 完了をクリックしてから、続行をクリックします。

次の手順は、アクションの構成です。

アクション

分析イベントを送信（バッチ）

バッチ制限

このコネクタでは、ベンダーへの大容量データ転送をサポートするために、バッチリクエストを使用します。詳細については、バッチアクションを参照してください。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに保持されます。

• リクエストの最大数：250,000
• 最も古いリクエストからの最大経過時間：30 分（1～60 分の範囲で構成可能）
• リクエストの最大サイズ：300 MB

パラメータ

イベントパラメータについては、一般属性を参照してください。

Analytics イベントの送信（非推奨）

This action is deprecated and can no longer be added. Use Send Analytics Event (Batch) instead.

バッチ制限

このアクションにはバッチアクションというラベルが付いていませんが、リクエストはリアルタイムでは送信されません。次のいずれかのしきい値に達するか、プロファイルがパブリッシュされるまで、リクエストはキューに格納されます。

• リクエストの最大数：250,000
• 最も古いリクエストからの最大経過時間：45 秒
• リクエストの最大サイズ：100 MB

一般属性

各フィールドに含める内容の詳細を含む、すべての属性の完全なリファレンスについては、Adobe：API ドキュメントおよびこの記事の訪問 ID と Experience Cloud IDセクションを参照してください。

ユーザーエージェントのクライアントヒント

Google Chrome や Microsoft Edge などの Chromium ブラウザーから提供されるクライアントヒントには、デバイス固有の情報が含まれています。このデータセットは、デバイス情報の主要なソースとしてユーザーエージェント文字列に代わるものです。

これらのマッピングの選択肢は、イベントパラメータセクションに表示されます。

コンテキストデータ

コンテキストデータは、props と eVar に代わる、より使いやすい選択肢として使用できます。任意のイベント属性または訪問属性を、Adobe Analytics のコンテキストデータ変数にマッピングできます。コンテキストデータ変数には任意の名前を付けられますが、会社名などの一意のキーをすべての変数の先頭に付けることが、Adobe のベストプラクティスです。一部の変数は予約されており、ライフサイクル指標など、あらかじめ定められた機能にのみ使用できます。これらの変数には、接頭辞 a. が付いています。

Analytics eVar

このフィールドは、サーバーサイド属性を eVar にマッピングするために使用します。eVar は、属性を数値にマッピングして指定する必要があります。有効な範囲は 1～250 です。

Analytics プロパティ名（s.props）

このフィールドは、サーバーサイド属性を prop にマッピングするために使用します。prop は、prop という語に prop 番号を加えて指定する必要があります（例：prop4）。prop は、属性を数値にマッピングして指定する必要があります。有効な範囲は 1～75 です。リスト propもサポートされていますが、Adobe Analytics レポートスイートの管理インターフェイスで事前に構成する必要があります。

イベント（s.events）

イベントを使用すると、特定のイベントが Web サイトまたはアプリで発生する頻度を測定できます。events 変数は、特定の Analytics イベントについてカウントする必要があるすべてのイベントを列挙した、コンマ区切りの文字列です。定義済みイベントとカスタムイベントは、同じ文字列で送信されます。

別の場所（たとえば、タグ管理の拡張機能、エンリッチメント、またはデータレイヤー内）で構成されたイベント名のリストを含む配列値をマッピングします。

イベントのマッピング

上記のイベント名を event X に変更する必要がある場合は、マッピングによって変更できます。

たとえば、purchase を 4 にマッピングすると、purchase が event4 に置き換えられます。そのため、Analytics イベントの送信（バッチ）セクションのイベントマッピング例に基づく最終出力は、event1,event2,event3,purchase から event1,event2,event3,event4 に変わります。

イベント値

このフィールドでは、イベントに数値を割り当てることができます。

イベントのシリアル化

イベント ID を含む属性を、イベントを指定する番号にマッピングして、イベントのシリアル化を構成します。

製品

Products 変数は、特定のページ上にある 1 つ以上の製品に関する e コマース情報（カテゴリ、製品 ID、価格、数量）を取得する必要がある場合に使用します。

Products 変数への入力には、配列データ型のサーバーサイド属性のみを使用できます。すべての配列の長さが同じである必要があります。たとえば、ページ上に 5 つの製品がある場合、製品 ID、数量、価格、およびカテゴリは、すべて要素数が 5 である必要があります。

製品イベント

このフィールドでは、Products 変数内の各製品にカスタムコンバージョンイベントを割り当て、各イベントに数値を割り当てることができます。

単純な変数（単一の値またはカスタムテキスト値）をマッピングした場合、リスト内のすべての製品に同じ値が適用されます。リスト（配列）値をマッピングした場合、その配列は他の製品配列と同じ長さである必要があり、配列内の各項目には、配列内の位置に応じて異なる値が構成されます。

以下の例では、次の製品配列がイベント属性として存在するものとします。

Product Category: ["Footwear", "Apparel"] Product ID: ["Running Shoes", "T-Shirt"] Quantity: ["1", "1"] Price: ["99.99", "49.99"]

製品 eVar

このフィールドでは、Products 変数内の各製品に eVar を割り当てることができます。

これは、前述の「製品イベント」フィールドと同じように機能します。

階層

ページの階層は、サイトまたはアプリのナビゲーション構造内でページを分類するのに役立ちます。使用可能なスロットは、hier1～hier5 の 5 つです。

リストデータ

リスト変数は、複数の値を含む区切り文字付き文字列であり、アトリビューションの目的でよく使用されます。各レポートスイートでは、最大3つのリスト変数を使用できます。配列変数はカンマ区切りの文字列に変換されます。

カスタムID値

Adobeでは、Adobe Experience Cloud Identity Serviceで使用される識別子の生成プロセスを簡素化する方法を提供しています。Adobeは、setCustomerIDsメソッドの顧客IDのいずれかをシードとして使用し、Adobe Experience Cloud訪問IDを生成できます。

詳細については、Adobe Analytics 2.0 APIを参照してください。

フィールド

• customerIDType：値を指定する顧客IDのタイプを指定します。例：email。
• id：Experience Cloud Identity ServiceのsetCustomerIDsメソッドで使用されるIDです。customerID.[customerIDType].idにマッピングされます。例：customerID.email.id ↔︎ 顧客のメールアドレス。
• isMCSeed：customerID.[customerIDType].idをヒットの識別子として使用できるようにする整数のブール値です。trueの場合は1、falseの場合は0を使用します。
• authState：Experience Cloud Identity ServiceのsetCustomerIDsメソッドで使用されるauthStateです。文字列値では大文字と小文字が区別されません。サポートされている値は次のとおりです。
  • 0または空の文字列：未ログイン
  • 1またはAUTHENTICATED：ログイン済み
  • 2またはLOGGED_OUT：ログアウト済み

メソッドのパラメーター

訪問IDとExperience Cloud ID

訪問ID、および複数のIDが指定された場合の優先順位については、Adobe Analyticsのドキュメントを参照してください。

ユースケース1：既存のAdobe Analytics実装がない場合

これが完全に新規の100%サーバーサイドのAdobe Analytics実装である場合は、独自の一意な訪問IDを使用し、コネクタのvisitorID属性に渡すことができます。Adobeが定めた制約の範囲内で、何を適切な訪問IDとするかを決定する必要があります。

ユースケース2：既存のAdobe AnalyticsクライアントサイドJavaScriptからの移行

JavaScriptベースのAdobe Analyticsタグからサーバーサイドコネクタへ移行する場合、完全移行時に訪問を「失う」ことがないよう、一貫した訪問IDを維持する必要があります。また、Adobe Analyticsコネクタを二次的なデータ収集メカニズムとして実装する場合（引き続きWebページやアプリでJavaScriptタグを主要なデータ収集メカニズムとして使用する場合）にも、訪問IDを移行する必要があります。

既存のAdobe AnalyticsクライアントサイドJavaScriptから移行するには、次の手順を実行します。

手順1：Adobe Experience Cloud IDタグを構成する

/ja/client-side-tags/adobe-experience-cloud-id-service-tag/に従ってAdobe Experience Cloud IDタグを構成し、Tag Managementでタグをセットアップします。

手順2：Adobe訪問IDをファーストパーティCookieに保存する

Adobe訪問IDをファーストパーティCookieに保存すると、セッション中に値を再リクエストすることなく、各ヒットで値がサーバーサイドプラットフォームに送信されます。

1. Tag Managementで「Data Layer」タブに移動し、utag_main_adobe_mcidとutag_main_aa_vidという2つの新しいファーストパーティCookie変数を作成します。

   You may rename these variables if you want to, but be sure to retain the utag_main_ prefix, which will save cookie space by stacking into the utag_main cookie. If you rename the variables, you will need to also update the JavaScript snippet below

2. Adobe Experience Cloud ID ServiceタグをスコープとするJavaScript Code拡張機能を作成し、次のコードを貼り付けます。

   if (typeof vAPI !== "undefined") {
     vAPI.getInstance(u.data.adobe_org_id,
       function (visitor) {
         var mcID = visitor.getMarketingCloudVisitorID(),
         analyticsID = visitor.getAnalyticsVisitorID(),
         sessionExpiry = ";exp-session";
         // store Adobe IDs for the session duration
         if (!mcID) {
           // something went wrong - the visitor IDs could not be retrieved
           utag.DB("MCID could not be returned");
         } else {
           utag.loader.SC("utag_main",{"adobe_mcid" : mcID + sessionExpiry, "aa_vid" : analyticsID + sessionExpiry});
           // optionally, trigger an empty utag.link call to trigger sending the cookie values to UDH
           // if utag.track call is omitted (default), values will be sent on the next utag.link or utag.view call anyway
           // utag.track is used to avoid calling other third-party tags; only the collect tag should respond
           // utag.track("adobe_vid_updated", {});
         }
       },
       u.clearEmptyKeys(u.data.config), u.data.customer_ids);
   }
   

   これにより、Adobeのサーバーから訪問IDが正常に取得されたときに呼び出されるAdobe Visitor IDサービスへのコールバックが作成され、訪問IDとExperience Cloud IDがTealium独自のファーストパーティCookie（utag_main）に保存されます。訪問IDが今後更新される可能性を考慮し、Cookieはセッション終了時に期限切れになります。Cookieを永続化（無期限化）するには、上記のコードでsessionExpiryを""に構成します。

3. このセッション中にコードが再実行されないようにするため、JavaScript拡張機能に次の条件を追加します。

   utag_main_adobe_mcid IS NOT DEFINED

   AND

   utag_main_aa_vid IS NOT DEFINED

ステップ3：CDPおよびEvent Streamingのサーバーサイド構成を行う

• CDP：CDPを使用している場合、Adobe Visitor IDとExperience Cloud IDを訪問レベルの文字列属性として保存できます。Visitor ID属性として保存しないでください。オーディエンスイベントによってトリガーされるアクションでは、コネクタ構成で新しい属性をvisitorIDおよびmarketingCloudVisitorIDにマッピングできます。
• Event Streaming：Event Streamingのみを使用している場合、訪問ID変数を保存できないため、値をCookieに保存します。
  • 前のステップのタグ管理構成をすでにProdにパブリッシュしている場合、新しいutag_main_adobe_mcidとutag_main_aa_vidの値がイベント属性にすでに存在しています。
  • Prodにパブリッシュしていない場合は、文字列属性タイプとしてFirst Party Cookieを使用し、イベント属性を手動で追加できます。これらの属性を定義した後、Adobe Analyticsコネクタでそれらを選択し、それぞれmarketingCloudVisitorIDとvisitorIDにマッピングできます。

一般的な問題のデバッグ

• コネクタをテストするには、トレースの使用をお勧めします。トレースの実行中に、HTTP Request Bodyフィールドを確認してください。このフィールドには、バッチ呼び出しの実行時にAdobeへ送信されるCSVヘッダーと最初の行のサンプルが表示されます。CSV出力を上記の表にあるSample Connector Outputフィールドと比較して、出力を検証できます。

• Adobeから返されるレスポンスコードにエラーがないか確認します。「HTTP Response Status: 200/Successful」以外の場合は、リクエストでエラーが発生したことを示します。

  コネクタ構成に完全なURL値を入力する必要はありません。Tealiumは、Data Insertion Domainの値に基づいてURLを自動生成します。完全なURLは、トレースセッションの実行中にのみ表示されます。

• Adobe Analyticsがデータを受信していない場合は、Admin > Report suites > Edit Settings > General > Timestamp configurationに移動し、TimestampsオプションをTimestamps not allowedからTimestamps optionalまたはTimestamps requiredに変更します。タイムスタンプが必須の場合は、有効なタイムスタンプを必ずマッピングしてください。

• User AgentまたはClient Hintsへのマッピングを強くお勧めします。この値をマッピングしないと、AdobeはサーバーのUser Agent（例：Apache-HttpClient/4.5.5(Java/11.0.17）を取得するため、ボットトラフィックとして識別される可能性があります。

Migratorツール

Adobe Analytics 2.0 Migratorツールを使用すると、既存のAdobe Analytics 1.4コネクタをAdobe Analytics 2.0コネクタに移行できます。Adobe Analytics 1.4コネクタは非推奨ではなく、移行は必須ではありません。**Send Analytics Event (Batch)**アクションを使用する必要があり、ユースケースでリアルタイムのコネクタアクションを必要としない場合にのみ、1.4コネクタのアクションを移行してください。

Migratorツールを使用する前に、次の制限事項に注意してください。

• このツールでは、バージョン2.0で利用できない1.4の属性は移行されません。詳細については、Adobe Analytics 2.0コネクタの相違点セクションにある1.4と2.0の属性の表を参照してください。
• モバイルデータソース属性のLifecycle Event Attributesは2.0 APIでは利用できないため、これらの属性の自動マッピングは移行されません。
• Adobe Analytics 2.0はカスタム属性をサポートしていません。そのため、1.4コネクタのこのセクションにある属性は移行されません。

Adobe Analytics 1.4コネクタを移行するには、次の手順を実行します。

1. Server-Sideに移動し、Google Chrome用のTealium Tools拡張機能を開きます。
2. Tealium ToolsでTool Catalogueタブをクリックし、Adobe Analytics 2.0 Migratorをクリックします。詳細については、Tealium Toolsを参照してください。
3. アクションの移行方法を選択します。
   • 移行の一環として既存のAdobe Analytics 1.4アクションを無効にするには、Disable existing actionを選択します。
   • アクティブなアクションのみを移行するには、Migrate only active actionsを選択します。
4. リストから移行範囲を選択します。
   • すべてのAdobe Analytics 1.4アクション
   • 特定のAdobe Analytics 1.4アクション
   • 特定のAdobe Analytics 1.4コネクタ
5. プロジェクトのAdobe Analytics Client IDとClient secretを入力します。
6. Startをクリックします。
   Migratorツールにより、既存のAdobe Analytics 1.4コネクタが新しいAdobe Analytics 2.0コネクタへ自動的に移行されます。コネクタ名は元の名前と同じで、末尾に「2.0 (Migrated)」が追加されます。
7. 新しいコネクタの構成とアクションを確認します。
8. プロファイルを保存してパブリッシュします。