--- title: Adobe Analytics 1.4 コネクタ構成ガイド description: この記事では、Adobe Analytics 1.4 コネクタの構成方法について説明します。 url: https://docs.tealium.com/ja/server-side-connectors/adobe-analytics-connector/ --- ## 動作原理 Tealium Customer Data HubのAdobe Analytics 1.4コネクタは、Adobeの[Data Insertion API](https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/data-insertion-api/index.md)を使用して、ウェブページやモバイルアプリのJavaScriptビーコンを使用する代わりに、アナリティクスデータをサーバーサイドから送信します。これにより、クライアントサイドから送信されるデータ量が削減され、さらに、EventStreamやAudienceStreamからAdobe Analyticsへのオーディエンスおよび訪問データを渡すことができる利点があります。
Adobe Analytics 1.4のサポート終了日は2026年8月12日で、WSSE認証も含まれます。Data Insertion APIはその日付を超えてアクセス可能ですが、更新やアクティブなサポートは受けられません。AdobeはAdobe Analytics 2.0への移行を強く推奨しており、私たちも[Adobe Analytics 2コネクタ](https://docs.tealium.com/adobe-analytics-2-connector/)の使用への移行をお勧めします。
## コネクタアクション | **アクション名** | **AudienceStream** | **EventStream** | |:---------------------|:-------------------|:----------------| | アナリティクスイベントを送信 | ✓ | ✓ | ## コネクター構成 Adobe Analytics コネクターを構成するには、インターフェースで以下の手順に従ってください： 1. **コネクターマーケットプレイス**にアクセスし、Adobe Analytics コネクターを追加します。 [コネクター概要](https://docs.tealium.com/about-connectors/)の記事を読んで、コネクターを追加する一般的な手順について確認してください。 1. **タイトル**フィールドにコネクターのタイトルを入力します。 1. **データ挿入ドメイン**フィールドに、Adobe Analytics データ収集サーバーのドメインを入力します。例えば、`namespace.122.2o7.net`です。 1. **レポートスイートID**フィールドにレポートスイートIDを入力します。 これはデータを送信するレポートスイートです。複数の宛先にデータを送信する場合は、レポートスイートのリストをコンマで区切って入力します。
この値はデータマッピングでも構成できます。
1. **ノート**フィールドに、このコネクターに関する関連するメモを入力します。 1. **次へ**をクリックします。 これで**アクション**タブに移動します。 1. **アクション**ドロップダウンリストから**Send Analytics Event**を選択し、以下のパラメーターを構成します： | **グループ** | **説明** | |:-------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | イベントパラメーター | | | モバイルデータソースのライフサイクルイベント属性の自動マッピング | | | コンテキストデータ | | | eVars | | | 階層 | | | リスト | | | プロパティ | | | イベント | | | イベントマッピング | | | イベント値 | | | 製品 | | | 製品eVars | | | 製品イベント | | | ブランド | | パラメータの構成が完了したら、**保存**をクリックし、変更を保存して公開してください。 ## 一般属性 すべての属性の完全なリファレンスについては、各フィールドに何を含めるべきかの詳細とともに、Adobeの[APIドキュメント](https://github.com/AdobeDocs/analytics-1.4-apis/blob/master/docs/data-insertion-api/reference/r_supported_tags.md)およびこの記事の[訪問およびエクスペリエンスクラウドID](#visitor-and-experience-cloud-ids)セクションを参照してください。 #### レポートスイートID * レポートスイートIDを指定することで、コネクタ構成UIで以前に入力された値を上書きすることができます。その値を上書きする必要がない場合は、このフィールドを空白のままにしておくことができます。データレイヤー変数、または**カスタム値**を使用することができます。複数のレポートスイートにデータを送信する場合は、カンマ区切りリストを使用することができます。 * この構成は構成タブで定義された値を上書きします * データを送信したいレポートスイートを指定します。URLに含まれています * データレイヤー属性を指定する場合は、行ごとに単純な属性タイプを使用してください。データを正しくフォーマットして渡すことができます | Map From | Map To | Notes | Sample Connector Output | |:-------------------------------------------------------------------------------------------------------|:--------------------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------------------------------| | 永続的な訪問IDを含むCustomer Data Hub属性、例えば、tealium\_visitor\_id | visitorID\* | | `01619ea9a91a001af7e29b75797104079005c07101008M` | | ページ名/タイトルを含むCustomer Data Hub属性 | pageName | | `Homepage` | | 現在のURLを含むCustomer Data Hub属性（例えば、組み込みの"Current URL"属性） | pageURL | | `[http://www.tealium.com](http://www.tealium.com%5C)` | | Adobe Experience Cloud IDを含むCustomer Data Hub属性 | marketingCloudVisitorID\* | | `` | | リンク名を含むCustomer Data Hub属性 | linkName | | `Buy Now` | | クリックされたリンクのURLを含むCustomer Data Hub属性 | linkURL | | `[https://www.tealium.com/products/widgets/buynow\](https://www.tealium.com/products/widgets/buynow%5C)` | | 注文IDを含むCustomer Data Hub属性 | purchaseID | | `ORD12345` | | ドキュメントリファラーを含むCustomer Data Hub属性 | referrer | | `[https://www.tealium.com/shop\](https://www.tealium.com/shop%5C)` | | イベント発生時のタイムスタンプを含むCustomer Data Hub属性 | timestamp | | `1519207951063` | | 顧客データハブ属性に含まれる訪問のIPアドレス | ipaddress | | `127.0.0.1` | | 顧客データハブ属性に含まれるブラウザ/デバイスのユーザーエージェント | userAgent | | `Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/64.0.3282.167 Safari/537.36` | | 顧客データハブ属性に含まれるカスタムイベントのトランザクションID（注文IDではない） | transactionID | | `CMPSUMMER18` | #### ユーザーエージェントクライアントヒント Google ChromeやMicrosoft EdgeなどのChromiumブラウザからのクライアントヒントは、デバイス固有の情報を提供します。このデータセットは、デバイス情報の主要な情報源としてユーザーエージェント文字列を置き換えます。 これらのマッピング選択は**イベントパラメーター**セクションに表示されます。 |マップ元|マップ先|備考|サンプルコネクタ出力| |----|----|----|----| | 顧客データハブ属性に含まれるシステムアーキテクチャヒント。 | `architecture` | | `x64` | | 顧客データハブ属性に含まれるアプリケーションが使用するビット数。 | `bitness` | | `64` | | 顧客データハブ属性に含まれるブランドヒント。 | `brands` | | `Chromium100` | | 顧客データハブ属性がモバイル接続を通じてカスタムイベントが発生したかどうかを示します。 | `mobile` | | `true` | | 顧客データハブ属性に含まれるプラットフォームヒント。 | platform | | `win` | | 顧客データハブ属性に含まれるプラットフォームバージョンヒント。 | `platformVersion` | | `10` | | 顧客データハブ属性に含まれる、Windowsが32ビットサブシステムを実行していることを示す指標。詳細については、[WoW64 at Wikipedia](https://en.wikipedia.org/wiki/WoW64)を参照してください。 | `wow64` | | `true` | ### リンクタイプ このフィールドはリンク追跡に使用され、[Link Type](https://experienceleague.adobe.com/docs/analytics/components/dimensions/custom-link.html?lang=en)の構成を可能にします。 | マップ元 | マップ先 | 説明 | 例 | サンプルコネクタ出力 | |:----|:----|:----|:----|:----| | ドロップダウンリストから任意の属性を選択するか、カスタム値を入力 | リンクタイプ: "d" - ダウンロードリンク "e" - エグジットリンク "o" - カスタム（その他）リンク | 選択した属性に値がある場合のみ、Adobe Analyticsにリンクタイプを送信します\* | マップ: (カスタム値): "true" to "o" | `o` |
選択した属性の値が `null`、`undefined`、または `""`（空文字列）の場合、リンクタイプは送信されません。
### コンテキストデータ [Context Data](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/contextdata.html?lang=en)は、propsやeVarsの代わりによりユーザーフレンドリーな代替手段として使用できます。任意のイベント属性または訪問属性をAdobe Analyticsのコンテキストデータ変数にマッピングできます。コンテキストデータ変数には任意の名前を付けることができますが、Adobeのベストプラクティスでは、すべての変数に会社名などの一意のキーを接頭辞として付けることが推奨されています。一部の変数は予め定められた機能のためにのみ使用され、これらの変数は `a.` で接頭辞が付けられます。 | マップ元 | マップ先 | 説明 | 例 | サンプルコネクタ出力 | |:----|:----|:----|:----|:----| | ドロップダウンから任意の属性を選択するか、カスタム値を入力 | companyname.someproperty | 定義された顧客データハブ属性をコンテキストデータ属性にマッピング | マップ: (顧客データハブ属性) キャンペーン名を "tealium.productColor" に | `<tealium.productColor>Red</tealium.productColor>` | ### アナリティクス eVars このフィールドは、Customer Data Hubの属性を[eVars](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/evar.html?lang=en)にマッピングするために使用されます。eVarsは、「eVar」という単語とeVarの番号を使用して指定する必要があります。例えば、「eVar11」です。有効な範囲は1から250です。 | マップ元 | マップ先 | 説明 | 例 | サンプルコネクタ出力 | |:----------------------------------------------------------|:--------------------------------------------------|:--------------------------------------------------------------------------------|:-------------------------------------------------------------|:----------------------------------------| | ドロップダウンから任意の属性を選択、またはカスタム値を入力 | eVarX（Xは1〜250の整数） | Customer Data Hubの定義済み属性をアナリティクスレポートのeVarにマッピングします | マップ：(Customer Data Hub属性) キャンペーン名を「eVar75」に | `Summer2018` | ### アナリティクスプロパティ名 (s.props) このフィールドは、Customer Data Hubの属性を[props](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/prop.html?lang=en)にマッピングするために使用されます。Propsは、`prop`という単語とpropの番号を使用して指定する必要があります。例えば、「prop4」です。有効な範囲は1から75です。[リストprops](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/prop.html?lang=en#list-props)もサポートされていますが、これにはAdobe Analytics Report Suite管理インターフェースで事前に構成が必要です。 | マップ元 | マップ先 | 説明 | 例 | サンプルコネクタ出力 | |:----------------------------------------------------------|:-------------------------------------------------|:--------------------------------------------------------------------------------|:--------------------------------------------------------|:-----------------------------------| | ドロップダウンから任意の属性を選択、またはカスタム値を入力 | propX（Xは1〜75の整数） | Customer Data Hubの定義済み属性をアナリティクスレポートのpropにマッピングします | マップ：(Customer Data Hub属性) リンク名を「prop4」に | `Buy Now` | ### イベント (s.events) [イベント](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/events/events-overview.html?lang=en)は、ウェブサイトやアプリで特定のイベントがどれだけ頻繁に発生しているかを測定するために使用されます。イベント変数は、特定のアナリティクスイベントに対してカウントされるべきすべてのイベントをリストするコンマ区切りの文字列です。[事前定義されたイベント](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/events/events-overview.html?lang=en)と[カスタムイベント](https://experienceleague.adobe.com/docs/analytics/components/metrics/custom-events.html?lang=en)は同じ文字列で送信されます。 Adobe Analyticsコネクタでは、イベントを指定するために次の2つの方法が使用されます： * 他の場所（例えば、Tag Managementの拡張機能、エンリッチメント、またはデータレイヤー内で直接）で入力されたイベント名のリストを含む配列値をマッピングします。 | マップ元 | データタイプ | 例の入力 | サンプルコネクタ出力 | |:----------------------------------------------------------|:----------|:-------------------------------|:--------------------------------------------------| | イベントのリストを表すCustomer Data Hub属性 | 配列 | ["event1", "event5", "event9"] | `event1,event5,event9` | * 特定のイベント番号にマッピングされる文字列値の配列を指定し、「カスタムイベントマッピング」セクションでイベント番号のマッピングを指定します： | マップ元 | マップ先 | 例のイベント配列 | 例の入力 | サンプルコネクタ出力 | |:---------------------------------------------------------------------|:----------------------------------------------|:-------------------------------------------------|:---------------------------|:-------------------------------------------------------------------------------------------------------------| | イベント配列で検索する文字列を含むカスタムテキスト値 | トリガーするイベント名、例えば、event8 | ["newsletter\_registration", "homepage\_viewed"] | "newsletter\_registration" | `event8`（文字列"newsletter\_registration"がイベント配列にあったため） | ### イベント値マッピング このフィールドでは、イベントに数値を割り当てることができます。このフィールドは「カスタムイベントマッピング」フィールドとは関連していません。つまり、「event2」が「カスタムイベントマッピング」で指定されていても、「値」イベントとして指定されている場合、イベント変数には値なしで1回、値ありで1回、合計2回含まれます。 | マップ元 | データタイプ | マップ先 | 例の入力 | サンプルコネクタ出力 | |:-----------------------------------------|:----------|:-------------------------------------------|:--------------------|:--------------------------------------| | 数値を表す属性 | 数値 | eventX（Xはイベントの番号） | 「9」を「event5」にマップ | `event5=9` | ### イベントシリアライゼーション イベントIDを含む属性をマッピングして、イベントを指定する番号を構成することでイベントシリアライゼーションを構成します。例えば、「ABC123」を「2」にマッピングすると、「event2=ABC123」と送信されます。 | マップ元 | データタイプ | マップ先 | 例の入力 | サンプルコネクタ出力 | |:-----------------------------------|:----------|:-----------------|:---------------------------------------------|:---------------------------------------------------------| | イベントIDを表す属性 | 文字列 | イベント番号 | 「ABC123」を「1」にマップ、
「ABC123」を「2」にマップ | `event1=ABC123,event2:ABC123` | ### ライフサイクルイベント Adobe Analyticsは、アプリケーションのライフサイクルイベントを追跡する機能を持っています。Tealiumのモバイルライブラリには、この機能をサポートするためのオプショナルモジュールが用意されており、Adobe Analyticsに必要なデータを自動的に生成します。 | Tealium属性 | Adobe変数 | 説明 | データタイプ | 例 | | --- | --- | --- | --- | --- | | lifecycle\_diddetect\_crash | a.CrashEvent | この起動/ウェイクイベント中にクラッシュが検出されたか。真の場合のみ記入。 | Boolean | true | | lifecycle\_dayofweek\_local | a.DayOfWeek | 呼び出しが行われた地元の曜日（1=日曜日、2=月曜日など） | Number | 13 | | lifecycle\_dayssincelaunch | a.DaysSinceFirstUse | 初回起動からの日数（整数で増加） | Number | 23 | | lifecycle\_dayssinceupdate | a.DaysSinceLastUpgrade | 最後に検出されたアプリバージョン更新からの日数（整数で増加） | Number | 46 | | lifecycle\_dayssincelastwake | a.DaysSinceLastUse | 最後に検出されたウェイクからの日数（整数で増加） | Number | 1 | | lifecycle\_firstlaunchdate\_MMDDYYYY | a.InstallDate | GMTタイムスタンプがMM/DD/YYYY形式でフォーマットされる | String | 01/18/2012 | | lifecycle\_hourofday\_local | a.HourOfDay | 呼び出しが行われた地元の時間（24時間表記） | String | true | | lifecycle\_isfirstlaunch | a.InstallEvent | 呼び出しが最初の起動/ウェイクの場合のみ存在 | String | true | | lifecycle\_isfirstlaunchupdate | a.UpgradeEvent | 呼び出しが検出された更新後の最初の起動/ウェイクの場合のみ存在 | Boolean | true | | lifecycle\_isfirstwakemonth | a.MonthlyEngUserEvent | 呼び出しが月の最初の起動/ウェイクの場合のみ存在 | Boolean | true | | lifecycle\_priorsecondsawake | a.PrevSessionLength | 最後の起動以来アプリが起動していた全秒数。以前のすべてのウェイクからの合計。ライフサイクルタイプ：起動呼び出しのみで送信。 | Number | 126 | | lifecycle\_totalwakecount | a.Launches | インストール以来の起動+ウェイクの総数（アプリが削除されない限りリセットされない） | Number | "563" | | lifecycle\_type | a.LaunchEvent if lifecycle\_type == "launch" | ライフサイクル呼び出しのタイプ | String | "launch", "wake", "sleep" | | device (obj-c/android) or model\_name (swift) | a.DeviceName | デバイスモデル | String | iPhone 7 Plus | | carrier (obj-c/android) or network\_name (swift) | a.CarrierName | ネットワークキャリア名 | String | Verizon | | device\_resolution | a.Resolution | 画面解像度 | String | 1080x1920 | | resolution | 画面解像度 | String | 1080x1920 | | app\_id | a.AppID | アプリID | String | Digital Velocity 1.0 | | device\_os\_version (obj-c/android) or os\_version (swift) | a.OSVersion | オペレーティングシステムバージョン | String | 11.1 | 詳細については、[Adobe: Lifecycle Metrics](https://marketing.adobe.com/resources/help/en_US/mobile/android/metrics.html)を参照してください。 ### 製品 [製品](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/products.html?lang=en)変数は、特定のページ上の1つ以上の製品に関するeコマース情報をキャプチャするために使用されます（カテゴリ、製品ID、価格、数量）。 製品変数を埋めるためには、配列データタイプを持つCustomer Data Hub属性のみが使用可能です。すべての配列は長さが等しくなければなりません。たとえば、ページ上に5つの製品がある場合、製品ID、数量、価格、カテゴリはすべて5要素の長さでなければなりません。 | マップ元 | データタイプ | マップ先 | 入力データ例 | コネクタ出力例 | |:----------------------------------------------------------|:----------|:------------------|:---------------------|:-----------------------------------------------------| | 製品カテゴリを表すCustomer Data Hub属性 | 配列 | 製品カテゴリ | ["靴", "シャツ"] | `靴;;;,シャツ;;;` | | 製品IDを表すCustomer Data Hub属性 | 配列 | 製品ID | ["ABC123", "EFG234"] | `;ABC123;;,;EFG234;;` | | 数量を表すCustomer Data Hub属性 | 配列 | 製品数量 | ["1", "2"] | `;;1;,;;2;;` | | 価格を表すCustomer Data Hub属性 | 配列 | 製品価格 | ["149.99", "79.80"] | `;;;149.99,;;;79.80` | ### 製品イベント値マッピング このフィールドでは、[製品](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/products.html?lang=en)変数の各製品にカスタム変換イベントを割り当て、各イベントに数値を割り当てることができます。 「シンプル」変数（単一値またはカスタムテキスト値）がマッピングされる場合、同じ値がリスト内のすべての製品に適用されます。リスト（配列）値がマッピングされる場合、配列は他の製品配列と同じ長さでなければならず、配列内の各アイテムには異なる値が割り当てられます（配列内の位置に応じて）。 これらの例では、次の製品配列がイベント属性として存在すると仮定します： ``` 製品カテゴリ: ["フットウェア", "アパレル"] 製品ID: ["ランニングシューズ", "Tシャツ"] 数量: ["1", "1"] 価格: ["99.99", "49.99"] ``` | マップ元 | データタイプ | マップ先 | 入力値例 | コネクタ出力例 | |:-----------------------------------------------------------------|:----------|:-----------------------------------------------|:----------------------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------| | 数値を含むカスタムテキスト値 | 文字列 | トリガーするイベント名、例：event8 | "9.99" (カスタム値) | `event8``フットウェア;ランニングシューズ;1;99.99;**event8=9.99**,アパレル;Tシャツ;1;49.99;**event8=9.99**` | | 数値データの配列を表すCustomer Data Hub属性 | 配列 | トリガーするイベント名、例：event12 | ["1.99", "4.99"] | `event8``フットウェア;ランニングシューズ;1;99.99;**event12=1.99**,アパレル;Tシャツ;1;49.99;**event12=4.99**` | ### 製品マーチャンダイジングeVars このフィールドでは、[製品](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/products.html?lang=en)変数の各製品にeVarsを割り当てることができます。 これは上記の「製品イベント値マッピング」フィールドと同じ方法で機能します。 | マップ元 | データタイプ | マップ先 | 入力値例 | コネクタ出力例 | |:-------------------------------------------------------------------------------------------|:----------|:--------------------------------------------|:--------------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | eVar値を含むカスタムテキスト値 | 文字列 | トリガーするeVarの名前、例：eVar4 | "my\_custom\_value" | `フットウェア;ランニングシューズ;1;99.99;event8=9.99;**eVar4=my\_custom\_value**,アパレル;Tシャツ;1;49.99;event8=9.99;**eVar4=my\_custom\_value**` | | eVar値の配列を表すCustomer Data Hub属性（例：製品カラー） | 配列 | トリガーするeVarの名前、例：eVar6 | ["赤", "緑"] | `フットウェア;ランニングシューズ;1;99.99;event8=9.99;**eVar6=赤**,アパレル;Tシャツ;1;49.99;event8=9.99;**eVar6=緑**` | ### 階層データ ページ[階層](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/hier.html?lang=en)は、サイト/アプリのナビゲーション構造内でページを分類するのに役立ちます。利用可能なスロットは5つ（hier1 - hier5）です。階層変数として使用できる唯一のサポートされているCustomer Data Hub属性タイプは配列です。 | マップ元 | データタイプ | マップ先 | 説明 | 例 | サンプルコネクタ出力 | |:----------------------------------------------------------|:------------|:--------------------------------------|:-----------------------------------------------------------------------------------------------------|:----------------------------------------------------------------|:-------------------------------| | ドロップダウンから任意の属性を選択、またはカスタム値を入力 | 配列 | hier1 - hier5 (ドロップダウン選択) | Customer Data Hubの配列形式の属性をAdobe Analyticsの指定された階層変数にマッピングします | マップ：(Customer Data Hub属性) ページ分類を「hier1」にマッピング | `Article` | ### リストデータ [リスト変数](https://experienceleague.adobe.com/docs/analytics/implementation/vars/page-vars/list.html?lang=en)は、複数の値を含む区切り文字列で、しばしば帰属目的で使用されます。各レポートスイートには最大3つのリスト変数が利用可能です。リスト変数として使用できる唯一のサポートされているCustomer Data Hub属性タイプは配列です。 | マップ元 | データタイプ | マップ先 | 説明 | 例 | サンプルコネクタ出力 | |:-----------------------------------------|:------------|:-------------------------------------------|:--------------------------------------------------------------------------------------------------|:------------------------------------------------------------|:----------------------------------| | ドロップダウンから任意の配列属性を選択 | 配列 | list1, list2, list3 (ドロップダウン選択) | Customer Data Hubの配列形式の属性をAdobe Analyticsの指定されたリスト変数にマッピングします | マップ：(Customer Data Hub属性) リファラーリストを「list1」にマッピング | `google.com` | ## 訪問およびExperience Cloud ID [訪問ID](https://experienceleague.adobe.com/docs/analytics/components/metrics/unique-visitors.html?lang=en)に関するAdobe Analyticsのドキュメントと、複数のIDが提供された場合の優先順位を参照してください。 ### ユースケース1: Adobe Analyticsの実装が初めての場合 これが完全にサーバーサイドの新しいAdobe Analytics実装である場合、独自の一意の訪問IDを使用し、コネクタのvisitorID属性に渡すことができます。訪問IDに適したものを決定する必要があります。Adobeによって構成された[制約](https://marketing.adobe.com/resources/help/en_US/sc/implement/visitorID.html)の範囲内で。 ### ユースケース2: 既存のAdobe AnalyticsクライアントサイドJavaScriptからの移行 JavaScriptベースのAdobe Analyticsタグからサーバーサイドコネクタへ移行する場合、完全に移行する際に「訪問を失う」ことを避けるために一貫した訪問IDを維持する必要があります。また、Adobe Analytics Customer Data Hubコネクタを二次的な収集メカニズムとして実装する場合（ウェブページやアプリで引き続きJavaScriptタグを主要な収集メカニズムとして使用している場合）、訪問IDを移行する必要があります。 このユースケースで説明されているように、既存のAdobe AnalyticsクライアントサイドJavaScriptから移行するための次の手順に従ってください： 1. [これらの指示](https://docs.tealium.com/adobe-experience-cloud-id-service-tag/)に従ってAdobe Experience Cloud IDタグを構成し、Tag Managementでタグを構成します。 1. このステップでは、Adobe訪問IDをファーストパーティクッキーに保存します。このクッキーは、セッションの期間中、値を再リクエストする必要なく、Customer Data Hubに値が送信されることを保証します。 * Tag Managementでデータレイヤータブに移動し、`utag_main_adobe_mcid` と `utag_main_aa_vid` という2つの新しいファーストパーティクッキー変数を作成します。
これらの変数の名前を変更することはできますが、`utag_main_` 接頭辞を保持してください。これにより、`utag_main`クッキーにスタックしてクッキースペースを節約できます。変数の名前を変更する場合は、以下のJavaScriptスニペットも更新する必要があります。
* Adobe Experience Cloud ID Serviceタグにスコープされた新しいJavaScriptコード拡張を作成し、次のコードを貼り付けます： ``` `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訪問IDサービスへのコールバックを作成し、訪問IDとExperience Cloud IDをTealiumの独自のファーストパーティクッキー(`utag_main`)に保存します。クッキーはセッションの終了時に期限切れになりますが、将来訪問IDが更新される場合に備えています。クッキーを永続的にする（期限切れにしない）場合は、上記のコードで`sessionExpiry`を`""`に構成します。 * JavaScript拡張に条件 "utag\_main\_adobe\_mcid `is not defined` AND utag\_main\_aa\_vid `is not defined`" を追加します。これにより、このセッション中にコードが再度実行されるのを防ぎます。 1. Customer Data HubのAudienceStreamとEventStreamを構成します。 * AudienceStream構成 - AudienceStreamをお持ちの場合、Adobe訪問IDとExperience Cloud IDを訪問レベルの文字列属性として保存できます。訪問ID属性としては保存しないでください。オーディエンスイベントによってトリガーされるアクションの場合、新しい属性をコネクタ構成の`visitorID`および`marketingCloudVisitorID`にマッピングできます。 * EventStream構成 - EventStreamのみをお持ちの場合、訪問ID変数を保存する機能がないため、値をクッキーに保存しました。前のステップのTag Management構成をProdに公開している場合は、新しい`utag_main_adobe_mcid`および`utag_main_aa_vid`の値がすでに[イベント属性](https://docs.tealium.com/add-enrichment/)に表示されています。 * Prodに公開していない場合は、手動でイベント属性を追加できます。**ファーストパーティクッキー**文字列属性タイプを使用してこれらの属性を定義します。これらの属性を定義したら、Adobe Analyticsコネクタでそれらを選択し、それぞれ`marketingCloudVisitorID`および`visitorID`にマッピングできます。 ## 一般的な問題のデバッグ * コネクタのテストには、[trace](https://docs.tealium.com/about-trace/)の使用をお勧めします。トレースを実行する際には、「HTTP Request Body」フィールドを確認し、Adobeに送信された整形済みのXMLを表示します。上記の表の「Sample Connector Output」フィールドとXML出力を比較して、出力を検証してください。 * Adobeから返されるレスポンスコードにエラーがないかを確認してください。HTTPレスポンスステータス：200/成功以外は、リクエストにエラーがあったことを示します。 * Data Insertion APIの完全なURL構造は、`http://namespace.112.2o7.net/b/ss//6`の形式に従います。ここで、二重スラッシュは意図的で有効です（JavaScriptのAdobe Analytics実装では、ここにレポートスイートIDが存在します）。`/6`はXMLペイロードが送信されていることを示し、reportSuiteの値はXMLペイロードの一部として送信されます。これは、[trace](https://docs.tealium.com/about-trace/)セッションを実行するときに表示される値です。
コネクタ構成に完全なURL値を入力する必要はありません。TealiumはData Insertion Domainの値に基づいてURLを自動生成します。完全なURLはトレースセッションを実行するときにのみ表示されます。
* 特定の実装によっては、Data Insertion Domainの値が異なる場合があります（例：`sc.omtrdc.net`）、しかし、名前空間は常にドメインの前に来るべきです（例：`namespace.sc.omtrdc.net`）、独自のファーストパーティトラッキングドメインを持っている場合を除きます（例：`smetrics.acme.com`）。 * Adobe Analyticsにデータが受信されていない場合は、レポートスイートの[**Timestamps Optional**](https://experienceleague.adobe.com/docs/analytics/technotes/timestamps-optional.html?lang=en)セクションを確認してください。タイムスタンプがオプションでない場合は、有効なタイムスタンプをマッピングすることが重要です。 * User AgentまたはClient Hintsにマッピングすることを強くお勧めします。この値をマッピングしない場合、AdobeはサーバーのUser Agent（例：`Apache-HttpClient/4.5.5(Java/11.0.17`）を取得し、それがボットトラフィックとして識別される可能性があります。