[GA4] オフライン イベントをインポートする

オフライン イベントデータについて

オフライン イベントは、インターネット接続が利用できない場合や、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

インポートしたデータ

イベント、パラメータ、商品、ユーザー プロパティのデータは、次のヘッダー形式でアップロードできます。

  • timestamp_micros(省略可。イベントから 72 時間以内で指定可能で、タイムスタンプがない場合はアップロードの時刻を使用する)
  • user_id(省略可。ただし、使用可能であれば推奨される)
  • 同意シグナル(省略可。ただし、使用可能であれば強く推奨される: 詳細
  • event_param.<xxxxx>(任意の名前の任意のパラメータをインポートする)
  • user_property.<yyyyy>(任意の名前のユーザー プロパティをインポートする)
  • item<x>.<item_param>(例: item2.item_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
G-12345ABCDE 1234567890.0987654321 1000001 1609488000000000 許可 拒否 page_view /home referrer.com ホームページ 1600x900 blue 1-2                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488060000000 拒否 拒否 page_view /video_detail   動画ビューア 1600x900 blue 1-4                                  
G-12345ABCDE 1234567890.0987654321 1000001 1609488120000000 拒否 許可 video_play /video_detail   動画ビューア 1600x900 blue                                    
G-67890ABCDE 2345678901.9876543210 1000002 1609574400000000 拒否 許可 page_view /home referrer.com ホームページ 2560x1440 green 2-2                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574460000000 拒否 許可 page_view /product_detail   商品の詳細 2560x1440 green 2-16                                  
G-67890ABCDE 2345678901.9876543210 1000002 1609574520000000 許可 許可 page_view /product_detail   商品の詳細 2560x1440 green                                    
G-67890ABCDE 121212.3434 1000003 1609574520000000 許可 許可 page_view /camp_lp_1 referrer.com サマーセール! 2560x1440 blue 3-1                                  
G-67890ABCDE 121212.3434 1000003 1609660801000000 許可 拒否 view_item_list /camp_lp_1   サマーセール! 2560x1440 blue   123abc red_shoe shoe list_123 colorful_shoes 1 1   234bcd blue_shoe 1 30.00          
G-67890ABCDE 121212.3434 1000003 1609660860000000 許可 許可 select_item /camp_lp_1   サマーセール! 2560x1440 blue   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660870000000 許可 許可 page_view /product_detail   商品の詳細 2560x1440 blue 3-5 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660930000000 拒否 許可 view_item /product_detail   商品の詳細 2560x1440 blue 3-17 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660950000000 拒否 拒否 add_to_cart /product_detail   商品の詳細 2560x1440 blue   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660970000000 許可 拒否 begin_checkout /product_detail   商品の詳細 2560x1440 blue   234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660975000000 許可 拒否 page_view /purchase_confirmation   お疲れさまでした 2560x1440 blue 3-21 234bcd blue_shoe shoe list_123 colorful_shoes 2 1 30.00                  
G-67890ABCDE 121212.3434 1000003 1609660980000000 許可 拒否 purchase /purchase_confirmation   お疲れさまでした 2560x1440 purple 3-21 234bcd blue_shoe 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 文字以下で指定する必要があります。

この情報は役に立ちましたか?

改善できる点がありましたらお聞かせください。
検索
検索をクリア
検索を終了
メインメニュー
8952152647556012667
true
ヘルプセンターを検索
true
true
true
true
true
69256
false
false