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

動作原理

Adobe Analytics 2.0 コネクタは、ウェブページやモバイルアプリ上のJavaScriptビーコンを使用する代わりに、Adobe Bulk Data Insertion APIを利用してアナリティクスデータを送信します。これにより、クライアント側から送信されるデータ量が削減され、オーディエンスや訪問データをAdobe Analyticsに渡すことが可能になるという利点があります。

Adobe Analytics 2.0 コネクタの違い

Adobe Bulk Data Insertion APIは、リアルタイムまたはほぼリアルタイムのコネクタアクションをサポートしないレート制限があります。このため、Send Analytics Event アクションはAdobe Analytics 2.0 コネクタで非推奨となりました。リアルタイムのコネクタアクションが必要ない場合は、Send Analytics Event (Batch) アクションに移行してください。リアルタイムのコネクタアクションが必要な場合は、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 コネクタへの移行に関する情報は、Migrator Toolを参照してください。

構成

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コネクタを追加します。 一般的なコネクタの追加方法については、Connector Overviewを参照してください。
2. オーディエンスとトリガーを選択し、続行をクリックします。
3. コネクタを追加をクリックします。
4. コネクタの名前を入力します。
5. クライアントIDとクライアントシークレットを入力します。
6. （オプション）接続テストをクリックします。
7. 完了をクリックし、続行をクリックします。

次のステップは、configuring an actionです。

アクション

Send Analytics Event (Batch)

バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、Batched Actionsを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：250,000
• 最古のリクエストからの最大時間：30分（1-60分から構成可能）
• リクエストの最大サイズ：300 MB

パラメータ

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

Send Analytics Event (非推奨)

このアクションは非推奨であり、新たに追加することはできません。代わりに Send Analytics Event (Batch) を使用してください。

バッチ制限

このアクションはバッチアクションとしてラベル付けされていませんが、リアルタイムでリクエストを送信するわけではありません。次のいずれかの閾値が達成されるか、プロファイルが公開されるまでリクエストはキューに入れられます：

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

一般属性

すべての属性の完全なリファレンスについては、各フィールドが何を含むべきかの詳細を含む Adobe: API documentation およびこの記事の Visitor & Experience Cloud IDs セクションを参照してください。

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

Google ChromeやMicrosoft EdgeなどのChromiumブラウザからのClient Hintsは、デバイス固有の情報を提供します。このデータセットは、デバイス情報の主要な情報源としてユーザーエージェント文字列を置き換えます。

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

コンテキストデータ

Context Data は、propsやeVarsに代わるよりユーザーフレンドリーな代替手段として使用できます。任意のイベント属性または訪問属性をAdobe AnalyticsのContext Data変数にマッピングできます。Context Data変数には任意の名前を付けることができますが、すべての変数に一意のキー（たとえば会社名）を接頭辞として付けることがAdobeのベストプラクティスです。一部の変数は予約されており、Lifecycle Metricsなどの予定された機能のみに使用できます。これらの変数は a. で接頭辞が付けられます。

アナリティクス eVars

このフィールドは、サーバーサイドの属性を eVars にマッピングするために使用されます。eVarsは、属性を数字にマッピングすることで指定する必要があります。有効な範囲は 1 から 250 です。

アナリティクスプロパティ名 (s.props)

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

イベント (s.events)

イベント は、ウェブサイトやアプリで特定のイベントがどれだけ頻繁に発生しているかを測定するために使用されます。イベント変数は、特定のアナリティクスイベントに対してカウントされるべきすべてのイベントをリストするコンマ区切りの文字列です。事前定義されたイベント と カスタムイベント は同じ文字列で送信されます。

他の場所（例えば、iQ Tag Managementの拡張機能、エンリッチメント、またはデータレイヤー内で直接）で入力されたイベント名のリストを含む配列値をマッピングします。

イベントマッピング

上記のイベント名をイベントXにリネームする必要がある場合、マッピングによってリネームできます。

例えば、purchase を 4 にマッピングすると、purchase は event4 に置き換えられ、Send Analytics Event (Batch) セクションのイベントマッピング例に基づいて最終出力は event1,event2,event3,purchase から event1,event2,event3,event4 に変更されます。

イベント値

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

イベントシリアライゼーション

イベントIDを含む属性をイベントの番号を指定する数値にマッピングすることでイベントシリアライゼーションを構成します。

製品

製品 変数は、特定のページ上の一つまたは複数の製品に関するeコマース情報をキャプチャするために使用されます。

製品変数を入力するためには、配列データタイプを持つサーバーサイド属性のみが使用可能です。すべての配列は長さが等しくなければなりません。例えば、ページ上に5つの製品がある場合、製品ID、数量、価格、カテゴリはすべて5要素の長さでなければなりません。

製品イベント

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

単一の変数（単一の値またはカスタムテキスト値）がマッピングされた場合、同じ値がリスト内のすべての製品に適用されます。リスト（配列）値がマッピングされた場合、配列は他の製品配列と同じ長さでなければならず、配列内の各アイテムはその位置に応じて異なる値を持ちます。

これらの例では、次の製品配列がイベント属性として存在していると仮定します：

製品カテゴリ: ["Footwear", "Apparel"] 製品ID: ["Running Shoes", "T-Shirt"] 数量: ["1", "1"] 価格: ["99.99", "49.99"]

製品 eVars

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

これは上記の 製品イベント フィールドと同じ方法で動作します。

階層

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

リストデータ

リスト変数は、複数の値を含む区切り文字列であり、しばしば帰属目的で使用されます。各レポートスイートには最大3つのリスト変数が利用可能です。配列変数はコンマ区切りの文字列に変換されます。

カスタムID値

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

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

フィールド

• customerIDType: 提供する顧客IDのタイプを指定します。例えば、email。
• id: Experience Cloud Identity ServiceのsetCustomerIDsメソッドで使用されるID。customerID.[customerIDType].idにマッピングされます。例えば、customerID.email.id ↔︎ 顧客のメール。
• isMCSeed: customerID.[customerIDType].idをヒットの識別子として使用することを許可する整数ブール値。1を真として、0を偽として使用します。
• authState: Experience Cloud Identity ServiceのsetCustomerIDsメソッドで使用されるauthState。文字列の値は大文字と小文字を区別しません。サポートされる値は以下の通りです：
  • 0または空文字列：ログインしていない
  • 1またはAUTHENTICATED：ログイン済み
  • 2またはLOGGED_OUT：ログアウト済み。

メソッドパラメータ

訪問とエクスペリエンスクラウドID

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

ユースケース1: Adobe Analyticsの実装がこれまでない場合

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

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

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

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

ステップ1: Adobe Experience Cloud IDタグを構成する

これらの指示に従ってAdobe Experience Cloud IDタグを構成し、iQ Tag Managementでタグを構成します。

ステップ2: Adobe訪問IDをファーストパーティクッキーに保存する

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

1. iQ Tag Managementでデータレイヤータブに移動し、utag_main_adobe_mcidおよびutag_main_aa_vidという2つの新しいファーストパーティクッキー変数を作成します。

   これらの変数の名前を変更することはできますが、utag_mainクッキーにスタックしてクッキースペースを節約するためにutag_main_プレフィックスを保持することを確認してください。変数の名前を変更する場合は、以下のJavaScriptスニペットも更新する必要があります

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の独自のファーストパーティクッキー(utag_main)に保存されます。クッキーはセッションの終了時に期限切れになります。訪問IDが将来更新される場合を考慮して、クッキーを永続的にする（期限切れにしない）場合は、上記のコードでsessionExpiryを""に構成します。

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

   utag_main_adobe_mcid IS NOT DEFINED

   AND

   utag_main_aa_vid IS NOT DEFINED

ステップ3: AudienceStreamとEventStreamのサーバーサイドを構成する

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

一般的な問題のデバッグ

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

• Adobeから返される応答コードにエラーがないか確認してください。HTTP応答ステータス: 200/成功以外は、リクエストに問題があったことを示します。

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

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

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

マイグレータツール

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

マイグレータツールを使用する前に、次の制限事項に注意してください：

• このツールは、バージョン2.0で利用できない1.4の属性を移行しません。詳細については、Adobe Analytics 2.0コネクタの違いセクションの1.4と2.0の属性の表を参照してください。
• モバイルデータソース属性のライフサイクルイベント属性は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をクリックします。 マイグレータツールは、既存のAdobe Analytics 1.4コネクタを新しいAdobe Analytics 2.0コネクタに自動的に移行します。コネクタの名前は同じで、サフィックスに"2.0 (Migrated)“が付きます。
7. 新しいコネクタ構成とアクションを確認します。
8. プロファイルを保存して公開します。