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

動作原理

Tealium Customer Data HubのAdobe Analytics 2.0コネクタは、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認証はサポートされなくなり、利用できなくなります。

コネクタアクション

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

AdobeでクライアントIDとクライアントシークレットを生成する

Adobe Analytics 2.0コネクタを構成するには、Adobe Analytics 2.0 APIのクライアントID（APIキー）とクライアントシークレットが必要です。Adobe Developer Consoleで資格情報を作成し、Adobe Analytics 2.0 APIのクライアントID（APIキー）とクライアントシークレットを取得するには、次の手順に従ってください：

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

これらの資格情報をAdobe Analytics 2.0コネクタの構成時に入力し、接続をテストします。

コネクタの構成

インターフェースでAdobe Analyticsコネクタを構成するには、次の手順に従います：

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

この値はデータマッピングで構成することもできます。
メモフィールドに、このコネクタに関する関連するメモを入力します。
次へをクリックします。 アクションタブが表示されます。

アクション

Adobe Analytics 2.0コネクタには次のアクションがあります：

アナリティクスイベントを送信
アナリティクスイベントをバッチで送信

これら2つのアクションのパラメータは同じです。

バッチ制限

Adobe Analytics 2.0は、各呼び出しで圧縮ファイルのみを送信することが許可されているため、コネクタはリアルタイムアクションを実行することができません。代わりに、コネクタは20秒のマイクロバッチアクションを実行します。

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

最大リクエスト数：250,000
最古のリクエストからの最大時間：30分
リクエストの最大サイズ：圧縮ファイル100 MB、非圧縮ファイル1GB

アクションの構成

ドロップダウンリストからアナリティクスイベントを送信またはアナリティクスイベントをバッチで送信を選択し、次のパラメータを構成します：

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

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

一般属性

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

レポートスイートID

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

マップ元	マップ先	注意	サンプルコネクタ出力
永続的な訪問IDを含むカスタマーデータハブ属性（例：tealium_visitor_id）	visitorID*	これが訪問レベルの永続的な値であることを確認してください。例：Tealium Visitor ID	`<visitorID>01619ea9a91a001af7e29b75797104079005c07101008M</visitorID>`
ページ名/タイトルを含むカスタマーデータハブ属性	pageName	文字列値	`<pageName>Homepage</pageName>`
現在のURLを含むカスタマーデータハブ属性（例：組み込みの「現在のURL」属性）	pageURL	文字列値	`<pageURL>http://www.tealium.com</pageURL>`
Adobe Experience Cloud IDを含むカスタマーデータハブ属性	marketingCloudVisitorID*	通常、Visitor API JavaScriptタグを介して取得されます。 iQタグ管理で実装されています。	`<marketingCloudVisitorID></marketingCloudVisitorID>`
リンク名を含むカスタマーデータハブ属性	linkName	文字列値。例：tealium_event	`<linkName>Buy Now</linkName>`
クリックされたリンクのURLを含むカスタマーデータハブ属性	linkURL	文字列値	`<linkURL>https://www.tealium.com/products/widgets/buynow</linkURL>`
注文IDを含むカスタマーデータハブ属性	purchaseID	文字列値。電子商取引の注文ID	`<purchaseID>ORD12345</purchaseID>`
ドキュメントリファラーを含むカスタマーデータハブ属性	referrer	組み込みの「参照URL」属性の使用を推奨します。	`<referrer>https://www.tealium.com/shop</referrer>`
イベント発生時のタイムスタンプを含むカスタマーデータハブ属性	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ブラウザからのクライアントヒントは、デバイス固有の情報を提供します。このデータセットは、デバイス情報の主要な情報源としてユーザーエージェント文字列を置き換えます。

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

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

リンクタイプ

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

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

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

コンテキストデータ

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

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

Analytics 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</eVar75>`

分析プロパティ名 (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</prop4>`

イベント (s.events)

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

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

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

入力	サンプルコネクタ出力
イベントのリストを表すCustomer Data Hub属性	`<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	この起動/ウェイクイベント中にクラッシュが検出されたか。真の場合のみ記入。	ブール値	true
lifecycle_dayofweek_local	a.DayOfWeek	コールが行われたローカルの曜日 - 1=日曜日、2=月曜日など。	数値	13
lifecycle_dayssincelaunch	a.DaysSinceFirstUse	最初の起動からの日数（整数単位）。	数値	23
lifecycle_dayssinceupdate	a.DaysSinceLastUpgrade	最後に検出されたアプリバージョンの更新からの日数（整数単位）。	数値	46
lifecycle_dayssincelastwake	a.DaysSinceLastUse	最後に検出されたウェイクからの日数（整数単位）。	数値	1
lifecycle_firstlaunchdate_MMDDYYYY	a.InstallDate	GMTタイムスタンプ、MM/DD/YYYY形式。	文字列	01/18/2012
lifecycle_hourofday_local	a.HourOfDay	コールが行われたローカルの時間（24時間形式）。	文字列	true
lifecycle_isfirstlaunch	a.InstallEvent	コールが非常に最初の起動/ウェイクコールである場合のみ存在。	文字列	true
lifecycle_isfirstlaunchupdate	a.UpgradeEvent	コールが検出された更新後の最初の起動/ウェイクである場合のみ存在。	ブール値	true
lifecycle_isfirstwakemonth	a.MonthlyEngUserEvent	コールが月の最初の起動/ウェイクである場合のみ存在。	ブール値	true
lifecycle_priorsecondsawake	a.PrevSessionLength	最後の起動以来アプリが起動していた全秒数。起動時のlifecycle_typeコールでのみ送信。	数値	126
lifecycle_totalwakecount	a.Launches	インストール以来の起動+ウェイクの合計回数（アプリが削除されない限りリセットされない）。	数値	“563”
lifecycle_type	a.LaunchEvent if lifecycle_type == “launch”	ライフサイクルコールのタイプ	文字列	“launch”, “wake”, “sleep”
device (obj-c/android) or model_name (swift)	a.DeviceName	デバイスモデル	文字列	iPhone 7 Plus
carrier (obj-c/android) or network_name (swift)	a.CarrierName	ネットワークキャリア名	文字列	Verizon
device_resolution	a.Resolution	画面解像度	文字列	1080x1920
resolution	画面解像度	文字列	1080x1920
app_id	a.AppID	アプリID	文字列	Digital Velocity 1.0
device_os_version (obj-c/android) or os_version (swift)	a.OSVersion	オペレーティングシステムバージョン	文字列	11.1

詳細については、Adobe: Lifecycle Metricsを参照してください。

製品

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

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

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

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

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

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

マップ元	データタイプ	マップ先	入力値例	サンプルコネクタ出力
数値を含むカスタムテキスト値	文字列	トリガーするイベント名, 例: event8	“9.99” (カスタム値)	`<events>event8</events><products>Footwear;Running Shoes;1;99.99;event8=9.99,Apparel;T-Shirt;1;49.99;event8=9.99</products>`
数値配列を表すカスタマーデータハブ属性	配列	トリガーするイベント名, 例: event12	[“1.99”, “4.99”]	`<events>event8</events><products>Footwear;Running Shoes;1;99.99;event12=1.99,Apparel;T-Shirt;1;49.99;event12=4.99</products>`

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

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

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

マップ元	データタイプ	マップ先	入力値例	サンプルコネクタ出力
数値を含むカスタムテキスト値	文字列	トリガーするイベント名, 例: event8	“9.99” (カスタム値)	`<events>event8</events><products>Footwear;Running Shoes;1;99.99;event8=9.99,Apparel;T-Shirt;1;49.99;event8=9.99</products>`
数値データの配列を表すカスタマーデータハブ属性	配列	トリガーするイベント名, 例: event12	[“1.99”, “4.99”]	`<events>event8</events><products>Footwear;Running Shoes;1;99.99;event12=1.99,Apparel;T-Shirt;1;49.99;event12=4.99</products>`

階層データ

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

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

リストデータ

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

マップ元	データタイプ	マップ先	説明	例	サンプルコネクタ出力
ドロップダウンから任意の配列属性を選択	配列	list1, list2, list3 (ドロップダウン選択)	カスタマーデータハブ属性をAdobe Analyticsの指定されたリスト変数にマッピング	マップ: (カスタマーデータハブ属性) リファラーリストを “list1” に	`<list1>google.com</list1>`

顧客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.email.id` ↔︎ 顧客のメール。
`isMCSeed`	`customerID.[customerIDType].id`をヒットの識別子として使用するかどうかを示す整数ブール値。`1`をtrue、`0`をfalseとして使用します。
`authState`	Experience Cloud Identity Serviceの`setCustomerIDs`メソッドで使用される`authState`。文字列値は大文字小文字を区別しません。サポートされている値は次のとおりです： `0`または空文字列 - ログインしていない `1`または`AUTHENTICATED` - ログイン済み `2`または`LOGGED_OUT` - ログアウト済み

訪問IDとExperience Cloud ID

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

使用例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から移行するための次の手順を使用してください：

title: “Adobe Experience Cloud ID タグの構成方法” linktitle: “Adobe Experience Cloud ID タグの構成” description: “Adobe Experience Cloud ID タグを iQ Tag Management で構成し、タグを構成する手順について説明します。”

これらの指示に従って、Adobe Experience Cloud ID タグを構成し、iQ Tag Managementでタグを構成します。
このステップでは、Adobeの訪問IDをファーストパーティクッキーに保存します。これにより、セッションの期間中、値を再リクエストすることなく、各ヒットに値が送信されることが保証されます。
- iQ Tag Managementでデータレイヤータブに移動し、utag_main_adobe_mcid と utag_main_aa_vid という名前の新しいファーストパーティクッキー変数を2つ作成します。
  
  これらの変数の名前を変更することはできますが、クッキースペースを節約するために 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";
      // セッション期間中にAdobe IDを保存
      if (!mcID) {
        // 何か問題が発生しました - 訪問IDを取得できませんでした
        utag.DB("MCID could not be returned");
      } else {
        utag.loader.SC("utag_main",{"adobe_mcid" : mcID + sessionExpiry, "aa_vid" : analyticsID + sessionExpiry});
        // 必要に応じて、空の utag.link コールをトリガーして、クッキー値を UDH に送信
        // utag.track コールが省略された場合（デフォルト）、値は次の utag.link または utag.view コールで送信されます
        // utag.track は他のサードパーティタグを呼び出さないように使用されます。collect タグのみが応答する必要があります
        // utag.track("adobe_vid_updated", {});
      }
       },<br>
       u.clearEmptyKeys(u.data.config), u.data.customer_ids);
  }`
```
  これにより、Adobeのサーバーから訪問IDが正常に取得されたときに呼び出されるAdobe Visitor IDサービスへのコールバックが作成され、訪問IDとExperience Cloud IDがTealiumの独自のファーストパーティクッキー（utag_main）に保存されます。クッキーはセッションの終了時に期限切れになります。クッキーを永続的にするには、上記のコードで 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 Visitor 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）を取得し、それがボットトラフィックとして識別される可能性があります。