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

動作原理

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

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

コネクタアクション

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

コネクター構成

Adobe Analytics コネクターを構成するには、インターフェースで以下の手順に従ってください：

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

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

グループ	説明
イベントパラメータ	以下の「一般属性」を参照してください
モバイルデータソースのライフサイクルイベント属性の自動マッピング	このチェックボックスをオンにすると、イベントパラメータセクションからAdobeデータ要素への値の自動マッピングが行われます。自動マッピングはモバイルイベントストリームアプリのライフサイクルにのみ適用されます。詳細については、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 Product Implementationを参照してください。
製品eVars	製品eVarsの値を指定します。すべての配列は製品セクションのものと同じサイズである必要があります。空の値は無視されます。 eVarマッピングを数字で指定します。例として、`1`は`eVar1`にマッピングされます。
製品イベント	製品イベント値を指定します。すべての配列は製品セクションのものと同じサイズである必要があります。空の値は無視されます。イベントマッピングを数字で指定します。例として、`1`は`event1`にマッピングされます。
ブランド	ブランド属性を指定してください。利用可能な属性は brand と version です。すべての配列は同じサイズでなければなりません。

パラメータの構成が完了したら、保存をクリックし、変更を保存して公開してください。

一般属性

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

レポートスイート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>`
注文IDを含むCustomer Data Hub属性	purchaseID	文字列値。電子商取引の注文ID	`<purchaseID>ORD12345</purchaseID>`
ドキュメントリファラーを含むCustomer Data Hub属性	referrer	“Referring URL"属性を使用することをお勧めします。	`<referrer>[https://www.tealium.com/shop\](https://www.tealium.com/shop%5C)</referrer>`
イベント発生時のタイムスタンプを含むCustomer Data Hub属性	timestamp	オプション。 Unixエポック秒またはISO 8601形式。レポートスイートがタイムスタンプ付きヒットを明示的に受け入れるように構成されていない場合はマッピングしないでください。詳細については、タイムスタンプ実装ガイドを参照してください。	`<timestamp>1519207951063</timestamp>`
顧客データハブ属性で訪問のIPアドレスを含む	ipaddress	このオプション属性を使用するには、アカウントで訪問IP属性を有効にする必要があります。この機能が必要な場合は、アカウントマネージャーに連絡してください。	`<ipaddress>127.0.0.1</ipaddress>`
顧客データハブ属性でブラウザ/デバイスのユーザーエージェントを含む	userAgent	顧客データハブの組み込みユーザーエージェント属性の使用を推奨します	`<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>`
顧客データハブ属性でカスタムイベントのトランザクションID（注文IDではない）を含む	transactionID	これはpurchaseIDとは異なります。詳細については、Adobe Analyticsのドキュメントを参照してください。	`<transactionID>CMPSUMMER18</transactionID>`

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

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

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

マップ元	マップ先	備考	サンプルコネクタ出力
顧客データハブ属性でシステムアーキテクチャヒントを含む	`architecture`	文字列値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<architecture>x64</architecture>`
顧客データハブ属性でアプリケーションが使用するビット数を含む	`bitness`	文字列値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<bitness>64</bitness>`
顧客データハブ属性でブランドヒントを含む	`brands`	オブジェクトの配列として送信。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<brands><brand><name>Chromium</name><version>100</version></brand></brands>`
顧客データハブ属性でカスタムイベントがモバイル接続を通じて発生したかどうかを示す	`mobile`	ブール値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<mobile>true</mobile>`
顧客データハブ属性でプラットフォームヒントを含む	platform	文字列値。	`<platform>win</platform>`
顧客データハブ属性でプラットフォームバージョンヒントを含む	`platformVersion`	文字列値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<platformVersion>10</platformVersion>`
顧客データハブ属性でWindowsが32ビットサブシステムを実行していることを示す。詳細については、WoW64 at Wikipediaを参照してください	`wow64`	ブール値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<wow64>true</wow64>`

リンクタイプ

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

マップ元	マップ先	説明	例	サンプルコネクタ出力
ドロップダウンリストから任意の属性を選択するか、カスタム値を入力する	リンクタイプ: “d” - ダウンロードリンク “e” - エグジットリンク “o” - カスタム（その他）リンク	選択した属性に値がある場合のみ、Adobe Analyticsにリンクタイプを送信します*	マップ: (カスタム値): “true” to “o”	`<linkType>o</linkType>`

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

コンテキストデータ

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

マップ元	マップ先	説明	例	サンプルコネクタ出力
ドロップダウンから任意の属性を選択するか、カスタム値を入力する	companyname.someproperty	定義された顧客データハブ属性をコンテキストデータ属性にマッピングする	マップ: (顧客データハブ属性) キャンペーン名を “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 Tag Managementの拡張、エンリッチメント、またはデータレイヤー内で直接）で入力されたイベント名のリストを含む配列値をマッピングします。

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

特定のイベント番号にマッピングされる文字列値の配列を指定し、「カスタムイベントマッピング」セクションでイベント番号のマッピングを指定します：

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

イベント値マッピング

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

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

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

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

マップ元	データタイプ	マップ先	入力例	サンプルコネクタ出力
イベントIDを表す属性	文字列	イベント番号	「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属性には、製品変数を埋めるために配列データタイプのみが使用される可能性があります。すべての配列は同じ長さでなければなりません。たとえば、ページ上に5つの製品がある場合、製品ID、数量、価格、カテゴリはすべて5つの要素の長さでなければなりません。

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

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

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

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

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

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

マップ元	データタイプ	マップ先	入力例	コネクタ出力例
数値を含むカスタムテキスト値	文字列	トリガーするイベント名、例えば、event8	“9.99” (カスタム値)	<events>event8</events>``<products>フットウェア;ランニングシューズ;1;99.99;event8=9.99,アパレル;Tシャツ;1;49.99;event8=9.99
数値データの配列を表すCustomer Data Hub属性	配列	トリガーするイベント名、例えば、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値を含むカスタムテキスト値	文字列	トリガーする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`
eVar値の配列を表すCustomer Data Hub属性（例えば、製品カラー）	配列	トリガーするeVarの名前、例えば、eVar6	[“赤”, “緑”]	`<products>フットウェア;ランニングシューズ;1;99.99;event8=9.99;eVar6=赤,アパレル;Tシャツ;1;49.99;event8=9.99;eVar6=緑`

階層データ

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

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

リストデータ

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

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

訪問およびExperience Cloud ID

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

ユースケース1: Adobe Analyticsの実装が初めての場合

これが完全にサーバーサイドの新しいAdobe Analytics実装になる場合、独自の一意の訪問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つの新しいファーストパーティクッキー変数を作成します。
  
  これらの変数の名前を変更することはできますが、utag_main_プレフィックスを保持してください。これにより、utag_mainクッキーにスタックしてクッキースペースを節約できます。変数の名前を変更する場合は、以下のJavaScriptスニペットも更新する必要があります。
- Adobe Experience Cloud IDサービスタグにスコープされた新しい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」を追加します。これにより、このセッション中にコードが再度実行されるのを防ぎます。
Customer Data HubのAudienceStreamおよびEventStreamを構成します。
- 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値がすでにイベント属性に表示されています。
- Prodに公開していない場合は、手動でイベント属性を追加できます。ファーストパーティクッキー文字列属性タイプを使用してこれらの属性を定義します。これらの属性を定義したら、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はトレースセッションを実行しているときにのみ表示されます。
特定の実装によっては、Data Insertion Domainの値が異なる場合があります（例：sc.omtrdc.net）、しかし、名前空間は常にドメインの前に来るべきです（例：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）を取得し、それがボットトラフィックとして識別される可能性があります。