オフライン イベントデータについて
オフライン イベントは、インターネット接続が利用できない場合や、SDK または Measurement Protocol を経由したリアルタイムでのイベント収集がサポートされていない場合に、ソースからインポートできます。イベントをアップロードすると、関連するタイムスタンプ、またはタイムスタンプがない場合はアップロード時刻を使用して、SDK 経由で収集された場合と同様に処理されます。
自動的に収集されるイベントのほか、業種ごとの推奨イベント、または正しい形式のカスタム イベント、パラメータ、ユーザー プロパティをインポートできます。詳細
このデータを削除するには、データ削除をリクエストするかユーザーを削除する必要があります。
オフライン イベントデータのインポートの仕組み
オフライン イベントをインポートするには、アナリティクスのイベント スキーマに一致する CSV ファイルを作成します。以下のテンプレートの例をご覧ください。
カスタム ディメンションを作成する
アナリティクスにまだ存在していないディメンションの値をインポートして、そのデータをレポートに表示する場合、データをアップロードする前にそれらのディメンションを作成する必要があります。詳細
カスタム ディメンションの作成後、インポートするデータを認識できるようになるまでには、最大で 4 時間ほどかかります(カスタム ディメンションが処理されていることを確認するには、データ探索を開き、ディメンション選択ツールでディメンションが表示されるかどうかを確認します)。
CSV ファイルを作成する
以下のテンプレートを参考にして、イベントデータの CSV ファイルを作成します。
データをアップロードする
アップロードの一般的な手順については、データ インポートについてに記載されています。
データソースを作成する際は、[オフライン イベントデータ] を選択します。
オフライン イベントでは、インポートしたフィールドがアナリティクス フィールドに自動的にマッピングされます。
データをアップロードしてから、レポート、オーディエンス、データ探索でそのデータを使用できるようになるまでには、最大 24 時間ほどかかります。
データ アップロード サービスからデータソースを削除しても、アップロードされたデータは削除されません。データ インポートでアップロードしたデータを完全に削除するには、他の収集手法の場合と同様に、データ削除が必要となることもあります。
データソースの詳細
凡例
範囲 | イベント |
---|---|
必須項目 |
client_id または app_instance_id [いずれか 1 つ] tag_id または firebase_app_id [いずれか 1 つ] (tag_id と client_id)または(firebase_app_id と app_instance_id) event_name |
インポートしたデータ |
イベント、パラメータ、商品、ユーザー プロパティのデータは、次のヘッダー形式でアップロードできます。
|
メモ | オフライン イベントのインポートで、個人情報をアップロードしたり統合したりすることは許可されません。詳細 |
テンプレート
以下は、イベントデータの CSV テンプレートのサンプルです。アップロード用のファイルを手作業で作成する際の参考にお使いください。
measurement_id | client_id | user_id | timestamp_micros | ad_personalization | ad_user_data | event_name | event_param.page_location | event_param.page_referrer | event_param.page_title | event_param.screen_resolution | user_property.color_score | event_param.foo | item1.item_id | item1.item_name | item1.category | item1.item_list_id | item1.item_list_name | item1.index | item1.quantity | item1.price | item2.item_id | item2.item_name | item2.quantity | item2.price | event_param.transaction_id | event_param.value | event_param.tax | event_param.shipping | event_param.currency |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ignored12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488000000000 | 許可 | 拒否 | page_view | /home | referrer.com | ホームページ | 1600x900 | 青 | 1~2 | |||||||||||||||||
ignored12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488060000000 | 拒否 | 拒否 | page_view | /video_detail | 動画ビューア | 1600x900 | 青 | 1~4 | ||||||||||||||||||
ignored12345ABCDE | 1234567890.0987654321 | 1000001 | 1609488120000000 | 拒否 | 許可 | video_play | /video_detail | 動画ビューア | 1600x900 | 青 | |||||||||||||||||||
ignored67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574400000000 | 拒否 | 許可 | page_view | /home | referrer.com | ホームページ | 2560x1440 | 緑 | 2-2 | |||||||||||||||||
ignored67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574460000000 | 拒否 | 許可 | page_view | /product_detail | 商品の詳細 | 2560x1440 | 緑 | 2-16 | ||||||||||||||||||
ignored67890ABCDE | 2345678901.9876543210 | 1000002 | 1609574520000000 | 許可 | 許可 | page_view | /product_detail | 商品の詳細 | 2560x1440 | 緑 | |||||||||||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609574520000000 | 許可 | 許可 | page_view | /camp_lp_1 | referrer.com | サマーセール! | 2560x1440 | 青 | 3-1 | |||||||||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660801000000 | 許可 | 拒否 | view_item_list | /camp_lp_1 | サマーセール! | 2560x1440 | 青 | 123abc | red_shoe | 靴 | list_123 | colorful_shoes | 1 | 1 | 234bcd | blue_shoe | 1 | 30.00 | ||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660860000000 | 許可 | 許可 | select_item | /camp_lp_1 | サマーセール! | 2560x1440 | 青 | 234bcd | blue_shoe | 靴 | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660870000000 | 許可 | 許可 | page_view | /product_detail | 商品の詳細 | 2560x1440 | 青 | 3~5 | 234bcd | blue_shoe | 靴 | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660930000000 | 拒否 | 許可 | view_item | /product_detail | 商品の詳細 | 2560x1440 | 青 | 3-17 | 234bcd | blue_shoe | 靴 | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660950000000 | 拒否 | 拒否 | add_to_cart | /product_detail | 商品の詳細 | 2560x1440 | 青 | 234bcd | blue_shoe | 靴 | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660970000000 | 許可 | 拒否 | begin_checkout | /product_detail | 商品の詳細 | 2560x1440 | 青 | 234bcd | blue_shoe | 靴 | list_123 | colorful_shoes | 2 | 1 | 30.00 | |||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660975000000 | 許可 | 拒否 | page_view | /purchase_confirmation | おめでとうございます! | 2560x1440 | 青 | 3-21 | 234bcd | blue_shoe | 靴 | list_123 | colorful_shoes | 2 | 1 | 30.00 | ||||||||||
ignored67890ABCDE | 121212.3434 | 1000003 | 1609660980000000 | 許可 | 拒否 | purchase | /purchase_confirmation | おめでとうございます! | 2560x1440 | 紫 | 3-21 | 234bcd | blue_shoe | 靴 | list_123 | colorful_shoes | 2 | 1 | 30.00 | t12345 | 37.49 | 2.50 | 4.99 | USD |
上限
予約済みの名前を使用したイベント、パラメータ、ユーザー プロパティは承認されません。
値のないアイテムのイベント パラメータ(item_list_name など)は拒否されます。アイテムのイベント パラメータは、推奨イベントのサブセット(例: e コマース、求人、旅行)でサポートされています。
イベント名とパラメータ名は、次のルールに従う必要があります。
- イベントに指定できるパラメータの数は 25 個までです。
- イベント内で指定できるユーザー プロパティは 25 個までです。
- ユーザー プロパティ名は半角 24 文字(全角 12 文字)以下にする必要があります。
- ユーザー プロパティ値は 36 文字以下で指定する必要があります。
- イベント名は 40 文字以下で指定し、英数字とアンダースコアのみを含め、先頭を英字にする必要があります。
- パラメータ名(アイテム パラメータを含む)は 40 文字以下で指定し、英数字とアンダースコアのみを含め、先頭を英字にする必要があります。
- アイテム パラメータなどのパラメータ値は、半角 100 文字(全角 50 文字)以下にする必要があります。
オフライン イベントデータのインポートに関する制限事項
オフライン イベントデータ用のデータソースは最大 10 個作成できます。