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

はじめに

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

コネクタのアクション

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

コネクタの構成

Adobe Analyticsコネクタを構成するために、次の手順をインターフェースで実行します。

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

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

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

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

一般属性

すべての属性の完全なリファレンスについては、AdobeのAPIドキュメントとこの記事の訪問とエクスペリエンスクラウドIDセクションを参照してください。

レポートスイートID

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

マップ元	マップ先	ノート	サンプルコネクタの出力
永続的な訪問IDを含むCustomer Data Hub属性（例: tealium_visitor_id）	visitorID*	これが訪問レベルの永続的な値であることを確認してください。例: Tealium Visitor ID	`<visitorID>01619ea9a91a001af7e29b75797104079005c07101008M</visitorID>`
ページ名/タイトルを含むCustomer Data Hub属性	pageName	文字列値	`<pageName>ホームページ</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 Tag Managementで実装されます。	`<marketingCloudVisitorID></marketingCloudVisitorID>`
リンク名を含むCustomer Data Hub属性	linkName	文字列値。例: tealium_event	`<linkName>今すぐ購入</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アドレスを含むCustomer Data Hub属性	ipaddress	このオプション属性を使用するには、アカウントでVisitor IP属性を有効にする必要があります。この機能が必要な場合は、アカウントマネージャに連絡してください。	`<ipaddress>127.0.0.1</ipaddress>`
ブラウザ/デバイスのユーザーエージェントを含むCustomer Data Hub属性	userAgent	Customer Data Hubの組み込みのUser Agent属性を使用することをお勧めします。	`<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を含むCustomer Data Hub属性	transactionID	これはpurchaseIDとは異なります。詳細については、Adobe Analyticsのドキュメントを参照してください。	`<transactionID>CMPSUMMER18</transactionID>`

User Agent Client Hints

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

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

マップ元	マップ先	ノート	サンプルコネクタの出力
システムアーキテクチャヒントを含む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>`
Windowsが32ビットサブシステムを実行していることを示す指標を含むCustomer Data Hub属性。詳細については、WikipediaのWoW64を参照してください。	`wow64`	ブール値。詳細については、Adobeのユーザーエージェントクライアントヒントを参照してください。	`<wow64>true</wow64>`

リンクタイプ

このフィールドはリンクトラッキングに使用され、リンクタイプを構成することができます。

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

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

コンテキストデータ

コンテキストデータは、プロップやeVarよりもユーザーフレンドリーな代替手段として使用できます。Adobe Analyticsのコンテキストデータ変数には任意の名前を付けることができますが、Adobeのベストプラクティスとして、会社名などの一意のキーで変数の接頭辞を付けることが推奨されています。一部の変数は予め定義された機能にのみ使用できます。たとえば、ライフサイクルメトリクスでは、これらの変数はa.で始まります。

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

Analytics eVar

このフィールドは、Customer Data Hub属性をイベントeVarにマッピングするために使用されます。eVarは、“eVar"という単語（大文字小文字を区別しない）とeVarの番号（例: “eVar11”）を使用して指定する必要があります。有効な範囲は1から250です。

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

Analyticsプロパティ名（s.props）

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

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

イベント（s.events）

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

Adobe Analyticsコネクタでは、次の2つの方法を使用してイベントを指定します。

他の場所で構成されたイベント名のリストを含む配列値をマッピングする（例: iQ Tag Managementの拡張機能、Enrichment、またはデータレイヤーで直接構成されたもの）。

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

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

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

イベント値マッピング

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

マップ元	データ型	マップ先	例の入力	サンプルコネクタの出力
数値を表す属性	数値	eventX、Xはイベントの番号	“9” (カスタム値)	`<events>event8</events>`

イベントシリアル化

イベントシリアル化を構成するには、イベントIDが含まれる属性を番号にマッピングし、イベントを指定します。たとえば、「ABC123」を「2」にマッピングすると、「event2=ABC123」として「event2