Analytics データの収集とマッピング
モバイルデータをAdobe Analyticsにマッピングする方法を説明します。
The イベント 以前のレッスンで収集し、Platform Edge Network に送信したデータは、Adobe Analyticsを含む、データストリームで設定されたサービスに転送されます。 データをレポートスイート内の正しい変数にマッピングします。
前提条件
- ExperienceEvent 追跡について理解します。
- サンプルアプリに XDM データが正常に送信されました。
- このレッスンで使用できるAdobe Analyticsレポートスイート。
学習内容
このレッスンでは、次の操作を実行します。
- データストリームをAdobe Analyticsサービスで設定します。
- Analytics 変数の自動マッピングについて説明します。
- XDM データを Analytics 変数にマッピングする処理ルールを設定します。
Adobe Analytics Datastream サービスの追加
XDM データを Edge ネットワークからAdobe Analyticsに送信するには、Adobe Analyticsサービスを、 データストリームの作成.
-
データ収集 UI で、「 」を選択します。 データストリーム お使いのデータストリーム。
-
次に、 サービスを追加.
-
追加 Adobe Analytics から サービス リスト
-
Adobe Analyticsで使用するレポートスイートの名前を入力します。 レポートスイート ID.
-
切り替えてサービスを有効にする 有効 オン。
-
「保存」を選択します。
自動マッピング
標準 XDM フィールドの多くは、Analytics 変数に自動的にマッピングされます。 完全なリストについては、こちらを参照してください。
例#1 - s.products
好例は products 変数 処理ルールを使用して入力できない XDM 実装を使用すると、必要なデータをすべてに渡すことができます productListItems
および s.products
は、Analytics マッピングを使用して自動的に入力されます。
このオブジェクト:
"productListItems": [
[
"name": "Yoga Mat",
"SKU": "5829",
"priceTotal": "49.99",
"quantity": 1
],
[
"name": "Water Bottle",
"SKU": "9841",
"priceTotal": "30.00",
"quantity": 3
]
]
結果:
s.products = ";5829;1;49.99,9841;3;30.00"
productListItems[].SKU
および productListItems[].name
両方にデータが含まれ、 productListItems[].SKU
が使用されます。 詳しくは、 Analytics Experience Edge での Analytics 変数のマッピングAdobe を参照してください。例#2 - scAdd
よく見ると、すべてのイベントには 2 つのフィールドがあります value
(必須)および id
(オプション)。 The value
フィールドを使用して、イベント数を増分します。 The id
フィールドはシリアル化に使用されます。
このオブジェクト:
"commerce" : {
"productListAdds" : {
"value" : 1
}
}
結果:
s.events = "scAdd"
このオブジェクト:
"commerce" : {
"productListAdds" : {
"value" : 1,
"id": "321435"
}
}
結果:
s.events = "scAdd:321435"
アシュランスで検証
の使用 アシュランス エクスペリエンスイベントの送信中で、XDM データが正しく、Analytics のマッピングが期待どおりにおこなわれていることを確認できます。
-
以下を確認します。 設定手順 シミュレーターまたはデバイスを Assurance に接続するには、「 」セクションを参照してください。
-
を送信します。 productListAdds イベント(製品をバスケットに追加)を追加します。
-
ExperienceEvent ヒットを表示します。
-
JSON の XDM の部分を確認します。
code language-json "xdm" : { "productListItems" : [ { "SKU" : "LLWS05.1-XS", "name" : "Desiree Fitness Tee", "priceTotal" : 24 } ], "timestamp" : "2023-08-04T12:53:37.662Z", "eventType" : "commerce.productListAdds", "commerce" : { "productListAdds" : { "value" : 1 } } // ...
-
以下を確認します。 analytics.mapping イベント。
Analytics マッピングでは、次の点に注意してください。
- イベント が
scAdd
基準:commerce.productListAdds
. - pl (products 変数)は、
productListItems
. - このイベントには、すべてのコンテキストデータを含む他の興味深い情報が含まれています。
コンテキストデータを使用したマッピング
Analytics に転送された XDM データは、 コンテキストデータ 標準フィールドとカスタムフィールドの両方を含む。
コンテキストデータキーは、次の構文に従って生成されます。
a.x.[xdm path]
以下に例を示します。
// Standard Field
a.x.commerce.saveforlaters.value
// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname
_techmarketingdemos
は組織の一意の値に置き換えられます。この XDM コンテキストデータをレポートスイートの Analytics データにマッピングするには、次の操作を実行します。
フィールドグループを使用
-
次を追加: Adobe Analytics ExperienceEvent Full 拡張機能 フィールドグループをスキーマに追加します。
-
Adobe Analytics ExperienceEvent Full Extension フィールドグループに従って、アプリで XDM ペイロードを作成します。これは、 イベントデータの追跡 レッスンまたは
-
ルールアクションを使用してAdobe Analytics ExperienceEvent Full Extension フィールドグループにデータを添付または変更する、Tags プロパティでルールを作成します。 詳細は、を参照してください。 SDK イベントへのデータのアタッチ または SDK イベントのデータを変更する.
マーチャンダイジング eVar
を使用している場合、 マーチャンダイジング eVar を使用して、例えば &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60
の場合は、で定義した XDM ペイロードを拡張する必要があります イベントデータの追跡 を使用してマーチャンダイジング情報を取り込みます。
-
JSON の場合:
code language-json { "productListItems": [ { "SKU": "LLWS05.1-XS", "name": "Desiree Fitness Tee", "priceTotal": 24, "_experience": { "analytics": { "events1to100": { "event10": { "value": 50 } }, "customDimensions": { "eVars": { "eVar1": "red", } } } } } ], "eventType": "commerce.productListAdds", "commerce": { "productListAdds": { "value": 1 } } }
-
コード内:
code language-swift var xdmData: [String: Any] = [ "productListItems": [ [ "name": productName, "SKU": sku, "priceTotal": priceString, "_experience" : [ "analytics": [ "events1to100": [ "event10": [ "value:": value ] ], "customDimensions": [ "eVars": [ "eVar1": color ] ] ] ] ] ], "eventType": "commerce.productViews", "commerce": [ "productViews": [ "value": 1 ] ] ]
処理ルールの使用
このデータを使用する処理ルールは次のようになります。
-
あなた の値を上書き 1) アプリの画面名 (eVar2) (2) a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3) a.x._techmarketingdemo.appinformation.appstatedetails.screenname 4) 設定済み (5)
-
あなた イベントを設定 (6) ウィッシュリストに追加(イベント 3) (7) から a.x.commerce.saveForLaters.value(Context) (8) a.x.commerce.saveForLaters.value(Context) (9) 設定済み (10).
処理ルールとコンテキストデータに関する追加情報が見つかりました ここ.
screenName
チュートリアルのフィールドでは、画面名を ページ名 」と表示されます。Adobe Experience Platform Mobile SDK の学習に時間を割いていただき、ありがとうございます。 ご質問がある場合、一般的なフィードバックを共有する場合、または今後のコンテンツに関する提案がある場合は、このドキュメントで共有します Experience Leagueコミュニティディスカッション投稿.
次へ: データをExperience Platformに送信