Adobe Analytics コネクタ構成ガイド
この記事では、Adobe Analyticsコネクタの構成方法について説明します。
仕組み
Tealium Customer Data HubのAdobe Analyticsコネクタは、AdobeのData Insertion APIを使用して、ウェブページやモバイルアプリのJavaScriptビーコンの代わりにサーバーサイドで分析データを送信します。これにより、クライアントサイドから送信されるデータ量が減少し、EventStreamやAudienceStreamからAdobe Analyticsに視聴者や訪問のデータを渡すことができるという利点があります。
コネクタアクション
アクション名 | AudienceStream | EventStream |
---|---|---|
分析イベントを送信 | ✓ | ✓ |
コネクタ構成
インターフェースで以下の手順を使用して、Adobe Analyticsコネクタを構成します:
-
コネクタマーケットプレイスに移動し、Adobe Analyticsコネクタを追加します。
コネクタ概要の記事を読んで、コネクタの追加方法の一般的な指示を確認してください。 -
タイトルフィールドに、コネクタのタイトルを入力します。
-
Data Insertion Domainフィールドに、Adobe Analyticsデータ収集サーバーのドメインを入力します。例えば、
namespace.122.2o7.net
。 -
Report Suite IDフィールドに、レポートスイートIDを入力します。
これは、データを送信するために使用するレポートスイートです。複数の宛先にデータを送信するには、レポートスイートのカンマ区切りリストを使用します。この値はデータマッピングでも構成できます。
-
Notesフィールドに、このコネクタに関する関連ノートを入力します。
-
Nextをクリックします。
これでActionsタブに移動します。 -
ActionsドロップダウンリストからSend Analytics Eventを選択し、以下のパラメータを構成します:
グループ | 説明 |
---|---|
イベントパラメータ |
|
モバイルデータソースのライフサイクルイベント属性の自動マッピング |
|
コンテキストデータ |
|
eVars |
|
階層 |
|
リスト |
|
プロパティ |
|
イベント |
|
イベントマッピング |
|
イベント値 |
|
製品 |
|
Product eVars |
|
Product Events |
|
ブランド |
|
パラメータの構成が完了したら、Saveをクリックし、変更を保存して公開します。
一般的な属性
すべての属性の完全なリファレンス、各フィールドが具体的に何を含むべきかの詳細については、AdobeのAPI documentationとこの記事のVisitor & Experience Cloud IDsセクションを参照してください。
レポートスイートID
- レポートスイートIDを指定します。これは、Connector Configuration UIで以前に入力された値を上書きします。その値を上書きする必要がない場合は、このフィールドを空白にしておくことができます。データレイヤー変数またはCustom Valueを使用することができます。複数のレポートスイートにデータを送信する場合は、カンマで区切ったリストを使用することができます。
- これはConfiguration Tabで定義された値を上書きします
- データを送信したいレポートスイートを指定します。URLに含まれています
- データレイヤー属性を指定する場合は、行ごとに単純な属性タイプを使用します。データは正しくフォーマットされて渡されます
Map From | Map To | ノート | サンプルコネクタ出力 |
---|---|---|---|
永続的な訪問IDを含むCustomer Data Hub属性(例:tealium_visitor_id) | visitorID* |
|
<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* |
|
<marketingCloudVisitorID></marketingCloudVisitorID> |
リンク名を含むCustomer Data Hub属性 | linkName |
|
<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 |
|
<purchaseID>ORD12345</purchaseID> |
ドキュメントリファラーを含むCustomer Data Hub属性 | referrer |
|
<referrer>[https://www.tealium.com/shop\](https://www.tealium.com/shop%5C)</referrer> |
イベントが発生した時間からのタイムスタンプを含むCustomer Data Hub属性 | timestamp |
|
<timestamp>1519207951063</timestamp> |
訪問のIPアドレスを含むCustomer Data Hub属性 | ipaddress |
|
<ipaddress>127.0.0.1</ipaddress> |
ブラウザー/デバイスのユーザーエージェントを含むCustomer Data Hub属性 | 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を含むCustomer Data Hub属性 (注文IDではありません) | transactionID |
|
<transactionID>CMPSUMMER18</transactionID> |
User Agent Client Hints
Client Hintsは、Google ChromeやMicrosoft EdgeなどのChromiumブラウザから提供され、デバイス固有の情報を提供します。このデータセットは、デバイス情報の主要な情報源としてユーザーエージェント文字列を置き換えます。
これらのマッピング選択肢は、イベントパラメータセクションに表示されます。
マップ元 | マップ先 | ノート | サンプルコネクタ出力 |
---|---|---|---|
システムアーキテクチャヒントを含むCustomer Data Hub属性。 | architecture |
|
<architecture>x64</architecture> |
アプリケーションが使用するビット数を含むCustomer Data Hub属性。 | bitness |
|
<bitness>64</bitness> |
ブランドヒントを含むCustomer Data Hub属性。 | brands |
|
<brands><brand><name>Chromium</name><version>100</version></brand></brands> |
カスタムイベントがモバイル接続を通じて発生したかどうかを示すCustomer Data Hub属性。 | mobile |
|
<mobile>true</mobile> |
プラットフォームヒントを含むCustomer Data Hub属性。 | platform |
|
<platform>win</platform> |
プラットフォームバージョンヒントを含むCustomer Data Hub属性。 | platformVersion |
|
<platformVersion>10</platformVersion> |
Windowsが32ビットサブシステムを実行していることを示す指標を含むCustomer Data Hub属性。詳細については、WoW64 at Wikipediaを参照してください。 | wow64 |
|
<wow64>true</wow64> |
リンクタイプ
このフィールドはリンクトラッキングに使用され、Link Typeの構成を可能にします。
マップ元 | マップ先 | 説明 | 例 | サンプルコネクタ出力 |
---|---|---|---|---|
ドロップダウンリストから任意の属性を選択するか、カスタム値を入力する | リンクタイプ: “d” - ダウンロードリンク “e” - エキジットリンク “o” - カスタム(その他)リンク | 選択した属性に値がある場合のみ、Adobe Analyticsにリンクタイプを送信します* | マップ: (カスタム値): “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>赤</tealium.productColor> |
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>夏2018 |
Analytics Property Name (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>今すぐ購入 |
Events (s.events)
イベントは、あなたのウェブサイトやアプリで特定のイベントがどれだけ頻繁に発生しているかを測定するために使用します。イベント変数は、特定の分析イベントに対してカウントされるべきすべてのイベントを列挙したカンマ区切りの文字列です。事前定義されたイベントとカスタムイベントは同じ文字列で送信されます。
Adobe Analyticsコネクタでは、以下の2つの方法がイベントの指定に使用されます:
- 他の場所(例えば、iQタグ管理の拡張機能、エンリッチメント、または直接あなたのデータレイヤー内)で事前に構成されたイベント名のリストを含む配列値をマッピングします。
マップ元 | データタイプ | 例の入力 | サンプルコネクタ出力 |
---|---|---|---|
イベントのリストを表すCustomer Data Hub属性 | 配列 | [“event1”, “event5”, “event9”] | <events>event1,event5,event9</events> |
- 特定のイベント番号にマッピングする文字列の配列を指定し、“カスタムイベントマッピング"セクションでイベント番号のマッピングを指定します。
マップ元 | マップ先 | 例のイベント配列 | 例の入力 | サンプルコネクタ出力 |
---|---|---|---|---|
イベント配列で検索する文字列を含むカスタムテキスト値 | トリガーするイベントの名前、例えば、event8 | [“newsletter_registration”, “homepage_viewed”] | “newsletter_registration” | <events>event8</events> (文字列 “newsletter_registration"がイベント配列に存在するため) |
Event Value Mapping
このフィールドでは、数値をイベントに割り当てることができます。このフィールドは"カスタムイベントマッピング"フィールドとは関連しておらず、つまり、“event2"が"カスタムイベントマッピング"で指定され、また"Value"イベントとして指定された場合、それはイベント変数に2回含まれます - 一度は値なしで、もう一度は値とともに。
マップ元 | データタイプ | マップ先 | 例の入力 | サンプルコネクタ出力 |
---|---|---|---|---|
数値を表す属性 | 数値 | eventX, Xはイベントの番号 | “9"を “event5"にマッピング | <events>event5=9</events> |
Event Serialization
イベント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 | 最後の起動以降、アプリが起動していた全秒数。すべての前回のウェイクからの合計を送信します。lifecycle_type: launch callsのみで送信されます。 | 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: ライフサイクルメトリクスを参照してください。
製品
Products変数は、特定のページ上の1つ以上の製品についてのeコマース情報をキャプチャする必要がある場所で使用されます(カテゴリ、製品ID、価格、数量)。
Products変数を充実させるためには、配列データタイプを持つCustomer Data Hub属性のみが使用できます。すべての配列は長さが等しくなければなりません。例えば、ページ上に5つの製品がある場合、製品ID、数量、価格、カテゴリはすべて5つの要素の長さでなければなりません。
マップ元 | データタイプ | マップ先 | 入力データの例 | コネクタ出力のサンプル |
---|---|---|---|---|
製品カテゴリを表すCustomer Data Hub属性 | 配列 | Products Category | [“Shoes”, “Shirts”] | <products>Shoes;;;,Shirts;;; |
製品IDを表すCustomer Data Hub属性 | 配列 | Products ID | [“ABC123”, “EFG234”] | <products>;ABC123;;,;EFG234;; |
数量を表すCustomer Data Hub属性 | 配列 | Products Quantity | [“1”, “2”] | <products>;;1;,;;2;; |
価格を表すCustomer Data Hub属性 | 配列 | Products Price | [“149.99”, “79.80”] | <products>;;;149.99,;;;79.80 |
製品イベント値マッピング
このフィールドでは、Products変数内の各製品にカスタム変換イベントを割り当て、各イベントに数値を割り当てることができます。
“シンプル"な変数がマップされている場合(単一の値、またはカスタムテキスト値)、同じ値がリスト内のすべての製品に適用されます。リスト(配列)値がマップされている場合、配列は他の製品配列と同じ長さでなければならず、配列内の各アイテムは異なる値を持つことになります(配列内の位置による)。
これらの例では、以下の製品配列がイベント属性として存在すると仮定します:
製品カテゴリ: ["Footwear", "Apparel"] 製品ID: ["Running Shoes", "T-Shirt"] 数量: ["1", "1"] 価格: ["99.99", "49.99"]
マップ元 | データタイプ | マップ先 | 入力値の例 | コネクタ出力のサンプル |
---|---|---|---|---|
数値を含むカスタムテキスト値 | String | トリガーするイベントの名前、例えば、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** |
数値データの配列を表すCustomer Data Hub属性 | 配列 | トリガーするイベントの名前、例えば、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** |
製品マーチャンダイジングeVars
このフィールドでは、Products変数内の各製品にeVarsを割り当てることができます。
これらは、上記の"Product Event Value Mapping"フィールドと同様に動作します。
マップ元 | データタイプ | マップ先 | 入力値の例 | コネクタ出力のサンプル |
---|---|---|---|---|
eVar値を含むカスタムテキスト値 | String | トリガーするeVarの名前、例えば、eVar4 | “my_custom_value” | <products>Footwear;Running Shoes;1;99.99;event8=9.99;**eVar4=my\_custom\_value**,Apparel;T-Shirt;1;49.99;event8=9.99;**eVar4=my\_custom\_value** |
Customer Data Hub属性が表すeVar値の配列(例:製品の色) | 配列 | トリガーするeVarの名前、例えば、eVar6 | [“赤”, “緑”] | <products>フットウェア;ランニングシューズ;1;99.99;event8=9.99;**eVar6=赤**,アパレル;T-シャツ;1;49.99;event8=9.99;**eVar6=緑** |
階層データ
ページ階層は、サイト/アプリのナビゲーション構造内でページを分類するのに役立ちます。利用可能なスロットは5つ(hier1 - hier5)です。階層varとして使用できる唯一のCustomer Data Hub属性タイプは配列です。
マップ元 | データタイプ | マップ先 | 説明 | 例 | サンプルコネクタ出力 |
---|---|---|---|---|---|
ドロップダウンから任意の属性を選択、またはカスタム値を入力 | 配列 | hier1 - hier5 (ドロップダウン選択) | 定義されたCustomer Data Hub属性を配列形式でAdobe Analyticsの指定された階層varにマップします | マップ:(Customer Data Hub属性) ページ分類を “hier1"に | <hier1>記事 |
リストデータ
リスト変数は、複数の値を含む区切り文字列で、通常は帰属目的で使用されます。各レポートスイートには最大3つのリスト変数が利用可能です。リストvarとして使用できる唯一のCustomer Data Hub属性タイプは配列です。
マップ元 | データタイプ | マップ先 | 説明 | 例 | サンプルコネクタ出力 |
---|---|---|---|---|---|
ドロップダウンから任意の配列属性を選択 | 配列 | list1, list2, list3 (ドロップダウン選択) | 定義されたCustomer Data Hub属性を配列形式でAdobe Analyticsの指定されたリストvarにマップします | マップ:(Customer Data Hub属性) リファラーリストを “list1"に | <list1>google.com |
ビジターとExperience Cloud ID
Adobe AnalyticsのドキュメントVisitor IDsを参照し、複数のIDが提供された場合の優先順位を確認してください。
ユースケース1:Adobe Analyticsの実装が初めての場合
これが新たなAdobe Analyticsの実装で、100%サーバーサイドの場合、独自の一意のビジターIDを使用し、それをコネクタのvisitorID属性に渡すことができます。適切なビジターIDとは何かを決定する必要があります。これはAdobeが構成した制約の範囲内で行ってください。
ユースケース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スニペットも更新する必要があります
- 新しい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", {});
}
},<br>
u.clearEmptyKeys(u.data.config), u.data.customer_ids);
}`
これにより、AdobeのサーバーからビジターIDが正常に取得されたときに呼び出されるAdobe Visitor IDサービスへのコールバックが作成され、Visitor IDとExperience Cloud IDがTealiumの独自のファーストパーティクッキー(utag_main)に保存されます。クッキーはセッションの終了時に期限切れとなり、将来Visitor IDが更新される場合に備えます。クッキーを永続的に(期限切れにしない)にしたい場合は、上記のコードでsessionExpiry
を""
に構成できます。
- JavaScript拡張に条件 “utag_main_adobe_mcid
is not defined
AND utag_main_aa_vidis not defined
“を追加します。これにより、このセッション中にコードが再度実行されるのを防ぎます。
- AudienceStreamとEventStreamのCustomer Data Hubを構成します。
-
AudienceStream構成 - AudienceStreamを持っている場合、Adobe Visitor IDとExperience Cloud IDをビジターレベルの文字列属性として保存できます。これらをVisitor ID属性として保存しないでください。オーディエンスイベントによってトリガーされる任意のアクションでは、新しい属性をコネクタ構成の
visitorID
とmarketingCloudVisitorID
にマップできます。 -
EventStream構成 - EventStreamのみを持っている場合、ビジターID変数を保存する能力はありません。これが、値をクッキーに保存した理由です。前のステップのiQ Tag Management構成をProdに公開していれば、新しい
utag_main_adobe_mcid
とutag_main_aa_vid
の値がすでにイベント属性に存在しているはずです。
Prodに公開していない場合は、First Party Cookie文字列属性タイプを使用してイベント属性を手動で追加できます。これらの属性を定義したら、Adobe Analyticsコネクタでそれらを選択し、それぞれmarketingCloudVisitorID
とvisitorID
にマップできます。
一般的な問題のデバッグ
-
コネクタのテストには、トレースの使用をお勧めします。トレースを実行するときには、「HTTPリクエストボディ」フィールドを探し、Adobeに送信されたフォーマットされたXMLを表示します。XML出力を上記の表の「サンプルコネクタ出力」フィールドと比較して出力を確認できます。
-
Adobeから返されるレスポンスコードにエラーがないかを確認します。HTTPレスポンスステータス: 200/成功以外のものは、リクエストに問題があったことを示しています。
-
データ挿入APIの完全なURL構造は、
http://namespace.112.2o7.net/b/ss//6
の形式に従います。ダブルスラッシュは意図的で有効です(JavaScriptのAdobe Analytics実装では、ここにレポートスイートIDが存在します)。/6
はXMLペイロードが送信されていることを示し、reportSuiteの値はXMLペイロードの一部として送信されます。これは、トレースセッションを実行したときに表示される値です。コネクタの構成に完全なURL値を入力する必要はありません。Tealiumは、データ挿入ドメイン値に基づいてURLを自動生成します。完全なURLは、トレースセッションを実行したときにのみ表示されます。
-
特定の実装によっては、データ挿入ドメイン(例えば、
sc.omtrdc.net
)の値が異なる場合がありますが、ネームスペースは常にドメイン(例えば、namespace.sc.omtrdc.net
)の前にあるべきです。ただし、自分自身のファーストパーティトラッキングドメイン(例えば、smetrics.acme.com
)を持っている場合を除きます。 -
Adobe Analyticsがデータを受信していない場合は、レポートスイートのタイムスタンプオプションセクションを確認してください。タイムスタンプがオプションでない場合は、有効なタイムスタンプをマップすることを確認してください。
-
User AgentまたはClient Hintsにマップすることを強くお勧めします。この値をマップしないと、AdobeがサーバーのUser Agent(例えば、
Apache-HttpClient/4.5.5(Java/11.0.17
)を取得し、ボットトラフィックとして識別される可能性があります。
最終更新日 :: 2021年September月8日