Adobe Analytics 1.4 コネクタ構成ガイド | サーバーサイドコネクター

動作原理

Tealium Customer Data HubのAdobe Analytics 1.4コネクタは、AdobeのData Insertion APIを使用して、ウェブページやモバイルアプリのJavaScriptビーコンを使用する代わりに、アナリティクスデータをサーバーサイドから送信します。これにより、クライアントサイドから送信されるデータ量が削減され、さらにEventStreamやAudienceStreamからAdobe Analyticsへのオーディエンスデータと訪問データを渡すことができる利点があります。

2026年8月12日：Adobe Analytics 1.4 APIおよびWSSE認証のサポート終了日は2026年8月12日です。この日以降、Adobe Analytics 1.4 APIおよびWSSE認証はサポートされなくなり、利用できなくなります。代わりにAdobe Analytics 2コネクタを使用できます。

コネクタアクション

アクション名	AudienceStream	EventStream
アナリティクスイベント送信	✓	✓

コネクタ構成

インターフェースで以下の手順に従ってAdobe Analyticsコネクタを構成します：

コネクタマーケットプレイスにアクセスし、Adobe Analyticsコネクタを追加します。
コネクタ概要の記事で、コネクタを追加する一般的な手順について読むことができます。
タイトルフィールドにコネクタのタイトルを入力します。
データ挿入ドメインフィールドに、Adobe Analyticsデータ収集サーバーのドメインを入力します。例えば、namespace.122.2o7.netです。
レポートスイートIDフィールドに、レポートスイートIDを入力します。
このレポートスイートはデータを送信するために使用されます。複数の宛先にデータを送信する場合は、レポートスイートのリストをコンマで区切って使用します。

この値はデータマッピングでも構成できます。
メモフィールドに、このコネクタに関する関連するメモを入力します。
次へをクリックします。
これでアクションタブに移動します。
アクションドロップダウンリストからアナリティクスイベント送信を選択し、以下のパラメータを構成します：

グループ	説明
イベントパラメータ	以下の「一般属性」を参照
モバイルデータソースのライフサイクルイベント属性の自動マッピング	このチェックボックスをオンにすると、イベントパラメータセクションからAdobeデータ要素への値の自動マッピングが行われます。自動マッピングはモバイルEventStreamアプリライフサイクルにのみ適用されます。詳細については、Adobe Analytics Connector Lifecycle Mappingsを参照してください。
コンテキストデータ	ドット形式を使用してキーを指定します。例：`my.a`。複数のキーと値のペアを指定できます。
eVars	属性を数字にマッピングしてイベントeVarsを指定します。例：`event_count`を`1`にマッピングしてeVar1。有効な範囲は`1`から`100`、プレミアムアカウントの場合は`250`です
階層	階層文字列。 `1`から`5`を選択します。
リスト	変数に渡され、個々のラインアイテムとして報告される値のリストです `1`から`3`を選択します。データレイヤーには配列タイプが必要です。 Tealiumはデータを正しくフォーマットして渡します
プロパティ	アナリティクスプロパティ名。属性を数字にマッピングして名前を指定します。例：`lifetime_value`を`1`にマッピングしてprop1。
イベント	イベントのリスト、またはカンマ区切りのカスタム値を指定します。 Adobe Analytics Configure Events Implementationを参照してください
イベントマッピング	上記で構成したイベント配列に含まれる潜在的な値をAdobe Analyticsカスタムイベント名にマッピングします。例えば、`registration`を`event3`にマッピングすると、イベントペイロード内の`registration`が`event3`に置き換わります。
イベント値	`Counter`、`Numeric`、`Currency`イベントの値を指定します。イベントを指定するには数字を使用します。例として、1は`event1`として送信されます。
製品	製品属性（`Id`, `Category`, `Quantity`, `Price`）を指定します。すべての配列は同じサイズで、順序が揃っている必要があります。追加情報については、Adobe Analytics 製品実装を参照してください。
製品 eVars	製品 eVars の値を指定します。すべての配列は製品セクションと同じサイズである必要があります。空の値は無視されます。 eVar マッピングを数字で指定します。例として、`1`は`eVar1`にマッピングされます。
製品イベント	製品イベントの値を指定します。すべての配列は製品セクションと同じサイズである必要があります。空の値は無視されます。イベントマッピングを数字で指定します。例として、`1`は`event1`にマッピングされます。
ブランド	ブランド属性を指定します。利用可能な属性はbrandとversionです。すべての配列は同じサイズである必要があります。

パラメータの構成が完了したら、Saveをクリックし、変更を保存して公開します。

一般属性

すべての属性の完全なリファレンスについては、AdobeのAPIドキュメントおよびこの記事のVisitor & Experience Cloud IDsセクションを参照してください。

レポートスイートID

レポートスイートIDを指定し、コネクタ構成UIで以前に入力された値を上書きします。その値を上書きする必要がない場合は、このフィールドを空白のままにできます。データレイヤー変数またはカスタム値を使用できます。複数のレポートスイートにデータを送信する場合は、カンマ区切りリストを使用できます。
構成タブで定義された値を上書きします
データを送信したいレポートスイートを指定します。URLに含まれています
データレイヤー属性を指定する場合は、行ごとに単純な属性タイプを使用します。データを正しくフォーマットして渡すことができます

Map From	Map To	Notes	Sample Connector Output
永続的な訪問IDを含むCustomer Data Hub属性、例えば、tealium_visitor_id	visitorID*	これが訪問レベルの永続的な値であることを確認してください。例: Tealium Visitor ID	`<visitorID>01619ea9a91a001af7e29b75797104079005c07101008M</visitorID>`
ページ名/タイトルを含むCustomer Data Hub属性	pageName	文字列値	`<pageName>Homepage</pageName>`
現在のURLを含むCustomer Data Hub属性（例えば、組み込みの"Current URL"属性）	pageURL	文字列値	`<pageURL>[http://www.tealium.com](http://www.tealium.com%5C)</pageURL>`
Adobe Experience Cloud IDを含むCustomer Data Hub属性	marketingCloudVisitorID*	通常、Visitor API JavaScriptタグを介して取得されます。 iQタグ管理で実装されています。	`<marketingCloudVisitorID></marketingCloudVisitorID>`
リンク名を含むCustomer Data Hub属性	linkName	文字列値。例: tealium_event	`<linkName>Buy Now</linkName>`
クリックされたリンクのURLを含むCustomer Data Hub属性	linkURL	文字列値	`<linkURL>[https://www.tealium.com/products/widgets/buynow\](https://www.tealium.com/products/widgets/buynow%5C)</linkURL>`
Customer Data Hub属性に含まれる文書参照元	referrer	組み込みの「参照URL」属性の使用を推奨。	`<referrer>[https://www.tealium.com/shop\](https://www.tealium.com/shop%5C)</referrer>`
Customer Data Hub属性に含まれるイベント発生時のタイムスタンプ	timestamp	オプション。 Unixエポック秒またはISO 8601形式。レポートスイートがタイムスタンプ付きヒットを明示的に受け入れるように構成されていない場合はマッピングしない。詳細については、タイムスタンプ実装ガイドを参照。	`<timestamp>1519207951063</timestamp>`
Customer Data Hub属性に含まれる訪問のIPアドレス	ipaddress	このオプション属性を使用するには、アカウントで訪問IP属性を有効にする必要があります。この機能が必要な場合はアカウントマネージャーに連絡してください。	`<ipaddress>127.0.0.1</ipaddress>`
Customer Data Hub属性に含まれるブラウザ/デバイスのユーザーエージェント	userAgent	Customer Data Hubの組み込みユーザーエージェント属性の使用を推奨。	`<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</userAgent>`
Customer Data Hub属性に含まれるカスタムイベント（注文IDではない）のトランザクションID	transactionID	これはpurchaseIDと同じではありません。詳細については、Adobe Analyticsのドキュメントを参照してください。	`<transactionID>CMPSUMMER18</transactionID>`

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

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

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

Map From	Map To	Notes	Sample Connector Output
Customer Data Hub属性に含まれるシステムアーキテクチャヒント。	`architecture`	文字列値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<architecture>x64</architecture>`
Customer Data Hub属性に含まれるアプリケーションが使用するビット数。	`bitness`	文字列値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<bitness>64</bitness>`
Customer Data Hub属性に含まれるブランドヒント。	`brands`	オブジェクトの配列として送信。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<brands><brand><name>Chromium</name><version>100</version></brand></brands>`
Customer Data Hub属性がモバイル接続を通じてカスタムイベントが発生したかどうかを示す。	`mobile`	ブール値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<mobile>true</mobile>`
Customer Data Hub属性に含まれるプラットフォームヒント。	platform	文字列値。	`<platform>win</platform>`
Customer Data Hub属性に含まれるプラットフォームバージョンヒント。	`platformVersion`	文字列値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<platformVersion>10</platformVersion>`
Customer Data Hub属性に含まれるWindowsが32ビットサブシステムを実行していることを示す指標。詳細については、WoW64 at Wikipediaを参照してください。	`wow64`	ブール値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<wow64>true</wow64>`

リンクタイプ

このフィールドはリンク追跡に使用され、リンクタイプの構成を可能にします。

Map From	Map To	Description	Example	Sample Connector Output
ドロップダウンリストから任意の属性を選択するか、カスタム値を入力	リンクタイプ: “d” - ダウンロードリンク “e” - エグジットリンク “o” - カスタム（その他）リンク	選択した属性に値がある場合のみAdobe Analyticsにリンクタイプを送信*	Map: (カスタム値): “true” to “o”	`<linkType>o</linkType>`

選択した属性の値がnull、undefined、または""（空文字）の場合、リンクタイプは送信されません。

コンテキストデータ

コンテキストデータは、propsやeVarsに代わるよりユーザーフレンドリーな代替手段として使用できます。Adobe Analyticsでイベント属性や訪問属性をコンテキストデータ変数にマッピングできます。コンテキストデータ変数は任意の名前を持つことができますが、Adobeのベストプラクティスとして、すべての変数に会社名などのユニークキーを接頭辞として付けることが推奨されています。一部の変数は予約されており、ライフサイクルメトリクスなどの事前に定義された機能にのみ使用できます。これらの変数は a. で接頭辞が付けられます。

マップ元	マップ先	説明	例	サンプルコネクタ出力
ドロップダウンから任意の属性を選択、またはカスタム値を入力	companyname.someproperty	Customer Data Hub属性をコンテキストデータ属性にマッピングします	マップ: (Customer Data Hub属性) キャンペーン名を “tealium.productColor” に	`<contextData><tealium.productColor>Red</tealium.productColor>`

アナリティクス eVars

このフィールドは、Customer Data Hub属性をeVarsにマッピングするために使用されます。eVarsは、「eVar」という単語（大文字小文字を区別しない）とeVarの番号を指定して使用します。例えば、「eVar11」などです。有効な範囲は1から250です。

マップ元	マップ先	説明	例	サンプルコネクタ出力
ドロップダウンから任意の属性を選択、またはカスタム値を入力	eVarX, Xは1 - 250の範囲の整数	Customer Data Hub属性をアナリティクスレポートのeVarにマッピングします	マップ: (Customer Data Hub属性) キャンペーン名を “eVar75” に	`<eVar75>Summer2018`

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

このフィールドは、Customer Data Hub属性をpropsにマッピングするために使用されます。Propsは、「prop」という単語とpropの番号を指定して使用します。例えば、「prop4」などです。有効な範囲は1から75です。リストpropsもサポートされていますが、これにはAdobe Analytics Report Suite管理インターフェースで事前に構成が必要です。

マップ元	マップ先	説明	例	サンプルコネクタ出力
ドロップダウンから任意の属性を選択、またはカスタム値を入力	propX, Xは1 - 75の範囲の整数	Customer Data Hub属性をアナリティクスレポートのpropにマッピングします	マップ: (Customer Data Hub属性) リンク名を “prop4” に	`<prop4>Buy Now`

イベント (s.events)

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

Adobe Analyticsコネクタでは、イベントを指定するために次の2つの方法が使用されます：

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

マップ元	データタイプ	例の入力	サンプルコネクタ出力
イベントのリストを表すCustomer Data Hub属性	配列	[“event1”, “event5”, “event9”]	`<events>event1,event5,event9</events>`

特定のイベント番号にマッピングされる文字列値の配列を指定し、“Custom Event Mapping"セクションでイベント番号のマッピングを指定します：

マップ元	マップ先	例のイベント配列	例の入力	サンプルコネクタ出力
イベント配列で検索する文字列を含むカスタムテキスト値	トリガーするイベントの名前、例えば、event8	[“newsletter_registration”, “homepage_viewed”]	“newsletter_registration”	`<events>event8</events>` (文字列 “newsletter_registration” がイベント配列に含まれていたため)

イベント値マッピング

このフィールドでは、イベントに数値を割り当てることができます。このフィールドは「Custom Event Mapping」フィールドとは関連していません。つまり、「event2」が「Custom Event Mapping」で指定されていても、「Value」イベントとして指定されている場合、イベント変数には値なしで1回、値ありで1回、合計2回含まれます。

マップ元	データタイプ	マップ先	例の入力	サンプルコネクタ出力
数値を表す属性	数値	eventX, Xはイベントの番号	“9"を"event5"にマップ	`<events>event5=9</events>`

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

イベントIDを含む属性をマッピングして、イベントを指定する番号を構成します。例えば、「ABC123」を「2」にマッピングすると、「event2=ABC123」と送信されます。

| マップ元 | データタイプ | マップ先 | 例の入力 | サンプルコネクタ出力 | |:———————————–|:————|:—————–|:—————————————|:—————————————————–|| 属性はイベントIDを表します | String | イベント番号 | “ABC123"を"1"にマッピング、
“ABC123"を"2"にマッピング | <events>event1=ABC123,event2:ABC123</events> |

ライフサイクルイベント

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

製品

製品変数は、特定のページ上の1つ以上の製品に関するeコマース情報をキャプチャするために必要な場所で使用されます（カテゴリ、製品ID、価格、数量）。

Customer Data Hub属性には、製品変数を埋めるためにArrayデータタイプのみが使用されることができます。すべての配列は長さが等しくなければなりません。たとえば、ページ上に5つの製品がある場合、製品ID、数量、価格、カテゴリはすべて5つの要素の長さでなければなりません。

マップ元	データタイプ	マップ先	入力例データ	サンプルコネクタ出力
製品カテゴリを表すCustomer Data Hub属性	Array	製品カテゴリ	[“靴”, “シャツ”]	`<products>Shoes;;;,Shirts;;;`
製品IDを表すCustomer Data Hub属性	Array	製品ID	[“ABC123”, “EFG234”]	`<products>;ABC123;;,;EFG234;;`
数量を表すCustomer Data Hub属性	Array	製品数量	[“1”, “2”]	`<products>;;1;,;;2;;`
価格を表すCustomer Data Hub属性	Array	製品価格	[“149.99”, “79.80”]	`<products>;;;149.99,;;;79.80`

製品イベント値マッピング

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

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

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

製品カテゴリ: ["フットウェア", "アパレル"] 製品ID: ["ランニングシューズ", "Tシャツ"] 数量: ["1", "1"] 価格: ["99.99", "49.99"]

マップ元	データタイプ	マップ先	入力例値	サンプルコネクタ出力
数値を含むカスタムテキスト値	String	トリガーするイベントの名前、例えば、event8	“9.99” (カスタム値)	<events>event8</events>``<products>フットウェア;ランニングシューズ;1;99.99;event8=9.99,アパレル;Tシャツ;1;49.99;event8=9.99
数値データの配列を表すCustomer Data Hub属性	Array	トリガーするイベントの名前、例えば、event12	[“1.99”, “4.99”]	<events>event8</events>``<products>フットウェア;ランニングシューズ;1;99.99;event12=1.99,アパレル;Tシャツ;1;49.99;event12=4.99

製品マーチャンダイジングeVars

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

これは上記の「製品イベント値マッピング」フィールドと同じ方法で機能します。

マップ元	データタイプ	マップ先	入力例値	サンプルコネクタ出力
eVar値を含むカスタムテキスト値	String	トリガーするeVarの名前、例えば、eVar4	“my_custom_value”	`<products>フットウェア;ランニングシューズ;1;99.99;event8=9.99;eVar4=my\_custom\_value,アパレル;Tシャツ;1;49.99;event8=9.99;eVar4=my\_custom\_value`

階層データ

ページ階層は、サイト/アプリのナビゲーション構造内でページを分類するのに役立ちます。利用可能なスロットは五つ（hier1 - hier5）です。階層変数として使用できる唯一のサポートされているCustomer Data Hub属性タイプは配列です。

マッピング元	データタイプ	マッピング先	説明	例	サンプルコネクタ出力
ドロップダウンから任意の属性を選択、またはカスタム値を入力	配列	hier1 - hier5（ドロップダウン選択）	Customer Data Hub属性を配列形式でAdobe Analyticsの指定された階層変数にマッピングします	マップ：（Customer Data Hub属性）ページ分類を「hier1」に	`<hier1>Article`

リストデータ

リスト変数は、複数の値を含む区切り文字列で、しばしば帰属目的で使用されます。各レポートスイートには最大3つのリスト変数が利用可能です。リスト変数として使用できる唯一のサポートされているCustomer Data Hub属性タイプは配列です。

マッピング元	データタイプ	マッピング先	説明	例	サンプルコネクタ出力
ドロップダウンから任意の配列属性を選択	配列	list1, list2, list3（ドロップダウン選択）	Customer Data Hub属性を配列形式でAdobe Analyticsの指定されたリスト変数にマッピングします	マップ：（Customer Data Hub属性）リファラーリストを「list1」に	`<list1>google.com`

訪問とExperience Cloud ID

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

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

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

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

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

このユースケースで説明されているように、既存のAdobe AnalyticsクライアントサイドJavaScriptから移行するための次の手順に従ってください：

これらの指示に従ってAdobe Experience Cloud IDタグを構成し、iQ Tag Managementでタグを構成します。
このステップでは、Adobe訪問IDをファーストパーティクッキーに保存します。このクッキーは、セッションの期間中、値を再リクエストする必要なく、各ヒットでCustomer Data Hubに値が送信されることを保証します。
- iQ Tag Managementで、utag_main_adobe_mcid と utag_main_aa_vid という名前の2つの新しいファーストパーティクッキー変数をData Layerタブで作成します。
  
  これらの変数の名前を変更することはできますが、utag_main_ 接頭辞を保持してください。これにより、utag_mainクッキーに積み重ねることでクッキースペースを節約できます。変数の名前を変更する場合は、以下のJavaScriptスニペットも更新する必要があります。
- 新しいJavaScript Code拡張を作成し、Adobe Experience Cloud ID Serviceタグにスコープを構成し、以下のコードを貼り付けます：
```
`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を""に構成してください。
- JavaScript拡張に条件を追加します：“utag_main_adobe_mcid is not defined AND utag_main_aa_vid is not defined”. これにより、このセッション中にコードが再度実行されるのを防ぎます。
AudienceStreamとEventStreamのためのCustomer Data Hubを構成します。
- AudienceStream構成 - AudienceStreamをお持ちの場合、Adobe訪問IDとExperience Cloud IDを訪問レベルの文字列属性として保存できます。訪問ID属性としては保存しないでください。オーディエンスイベントによってトリガーされる任意のアクションの場合、新しい属性をコネクタ構成のvisitorIDおよびmarketingCloudVisitorIDにマッピングすることができます。
- EventStream構成 - EventStreamのみをお持ちの場合、訪問ID変数を保存する機能がないため、値をクッキーに保存しました。前のステップのiQ Tag Management構成をProdに公開している場合、新しいutag_main_adobe_mcidおよびutag_main_aa_vidの値がEvent Attributesにすでに存在していることがわかります。Prodに公開していない場合、First Party Cookie 文字列属性タイプを使用してイベント属性を手動で追加することができます。これらの属性を定義した後、Adobe Analyticsコネクタでそれらを選択し、それぞれ marketingCloudVisitorID と visitorID にマッピングすることができます。

一般的な問題のデバッグ

コネクタをテストするには、traceの使用をお勧めします。トレースを実行する際には、「HTTP Request Body」フィールドを確認し、Adobeに送信されたフォーマットされたXMLを表示します。このXML出力を上記の表の「Sample Connector Output」フィールドと比較して出力を確認します。
Adobeから返されるレスポンスコードにエラーがないか確認します。HTTPレスポンスステータス：200/成功以外のものは、リクエストにエラーがあったことを示します。
Data Insertion APIの完全なURL構造は http://namespace.112.2o7.net/b/ss//6 の形式に従います。ここでの二重スラッシュは意図的で有効です（JavaScriptのAdobe Analytics実装では、ここにレポートスイートIDが存在します）。/6 はXMLペイロードが送信されていることを示し、reportSuite値はXMLペイロードの一部として送信されます。これは、traceセッションを実行するときに表示される値です。

コネクタ構成に完全なURL値を入力する必要はありません。TealiumはData Insertion Domain値に基づいてURLを自動生成します。完全なURLはTraceセッションを実行しているときにのみ表示されます。
特定の実装によっては、Data Insertion Domainの値が異なる場合があります（例：sc.omtrdc.net）、しかしnamespaceは常にドメインの前に来るべきです（例：namespace.sc.omtrdc.net）、独自のファーストパーティトラッキングドメインを持っている場合を除きます（例：smetrics.acme.com）。
Adobe Analyticsにデータが受信されていない場合は、レポートスイートのTimestamps Optionalセクションを確認してください。タイムスタンプがオプションでない場合は、有効なタイムスタンプをマッピングすることが重要です。
User AgentまたはClient Hintsにマッピングすることを強くお勧めします。この値をマッピングしないと、AdobeはサーバーのUser Agent（例：Apache-HttpClient/4.5.5(Java/11.0.17）を取得し、それがボットトラフィックとして識別される可能性があります。