フィールド マッピング

表のマッピングを使用して、Measurement Protocol のデータの収集リクエスト（/mp/collect）を Data Manager API の同等の IngestEventsRequest にマッピングします。

リクエスト フィールド

/mp/collect リクエスト（Measurement Protocol） IngestEventsRequest（Data Manager API） メモ
measurement_id（クエリ パラメータ） destinations ウェブ イベントの product_destination_id へのマッピング。詳細については、エクスポート先のフィールドをご覧ください。
firebase_app_id（クエリ パラメータ） destinations アプリイベントの product_destination_id にマッピングします。詳細については、エクスポート先のフィールドをご覧ください。
api_secret（クエリ パラメータ） 同等のものはありません Data Manager API でリクエストを認証する方法については、API アクセスを設定するをご覧ください。
consent consent Consent オブジェクトに設定します。
events events Event リソースのリストに設定します。詳しくは、イベント フィールドのセクションをご覧ください。
client_id events.client_id ウェブ イベントで必須です。
app_instance_id events.app_instance_id アプリイベントで必須です。
user_id events.user_id 省略可。ユーザーの一意の識別子。
timestamp_micros events.event_timestamp Measurement Protocol では、リクエスト レベルまたは個々のイベントで指定できます。Data Manager API には、リクエスト レベルのタイムスタンプはありません。各イベントの event_timestamp をイベントが発生した時刻に設定します。
  • JSON 形式を使用する場合は、RFC 3339 形式の値に設定します。
  • プロトコル バッファを使用する場合は、Timestamp を使用して、seconds フィールドと（必要に応じて）nanoseconds フィールドを設定します。

詳細については、タイムスタンプの形式をご覧ください。
user_properties events.user_properties UserProperties オブジェクトに設定します。Data Manager API では、個々のユーザー プロパティのタイムスタンプの設定はサポートされていません。ユーザー プロパティの変更に関連付けられたタイムスタンプは、イベントのタイムスタンプ（event_timestamp）から推測されます。
user_data events.user_data UserData オブジェクトに設定します。詳しくは、ユーザー識別子フィールドをご覧ください。
non_personalized_ads events.consent.ad_personalization non_personalized_ads が true の場合、ad_personalization を DENIED に設定します。
user_location events.event_location 詳しくは、ユーザーの所在地フィールドをご覧ください。
ip_override events.event_device_info.ip_address
device events.event_device_info 詳しくは、デバイス フィールドをご覧ください。
user_agent events.event_device_info.user_agent
validation_behavior 同等のものはありません 診断を使用して、アップロードのステータスと、ダウンストリーム処理中の個々のイベントのエラーと警告を取得します。IngestEventsRequest が失敗した場合（必須フィールドが欠落している場合など）、イベントは処理されません。エラーを解決してリクエストを再試行する必要があります。詳細については、API エラーについてをご覧ください。
/debug/mp/collect validate_only validate_only を true に設定すると、Measurement Protocol 検証サーバーと同様に、データを取得せずにイベントを検証できます。
同等のものはありません encoding UserData のアップロードに必須です。UserIdentifier 値に使用される Encoding に設定します。

宛先フィールド

Measurement Protocol は、measurement_id または firebase_app_id クエリ パラメータを使用して、特定のデータ ストリームにイベントを直接送信します。

Data Manager API は、Destination オブジェクトを使用してデータの送信先を指定します。宛先の詳細については、宛先を構成するをご覧ください。

Measurement Protocol のフィールドを Destination の同等のフィールドにマッピングする方法は次のとおりです。

Measurement Protocol Destination（Data Manager API） メモ
measurement_id（クエリ パラメータ） product_destination_id Google アナリティクスのウェブデータ ストリームの測定 ID に設定します。
firebase_app_id（クエリ パラメータ） product_destination_id Google アナリティクスのアプリデータ ストリームの Firebase アプリ ID に設定します。
同等のものはありません operating_account account_id を Google アナリティクスのプロパティ ID に設定します。account_type を GOOGLE_ANALYTICS_PROPERTY に設定します。
同等のものはありません login_account account_id を Google アナリティクスのプロパティ ID に設定します。account_type を GOOGLE_ANALYTICS_PROPERTY に設定します。

イベント フィールド

Measurement Protocol events[] Event（Data Manager API） メモ
name event_name event_name が予約済みの名前を使用している場合、API は INVALID_EVENT_NAME エラーでイベントを拒否します。
同等のものはありません event_source イベントがウェブブラウザから生成された場合は WEB、アプリから生成された場合は APP に設定します。
同等のものはありません destination_references リクエストレベルの destinations リストに複数の Google アナリティクス Destination が含まれている場合は必須です。イベントの送信先を指定するエントリを追加します。
timestamp_micros event_timestamp
  • JSON 形式を使用する場合は、RFC 3339 形式の値に設定します。
  • プロトコル バッファを使用する場合は、Timestamp を使用して、seconds フィールドと（必要に応じて）nanoseconds フィールドを設定します。

詳細については、タイムスタンプの形式をご覧ください。
params.currency currency
params.value conversion_value
params.customer_type user_properties.customer_type Measurement Protocol では、customer_type パラメータはイベント パラメータとして設定されます。Data Manager API では、イベントの UserProperties オブジェクトの customer_type フィールドで設定します。
params.transaction_id transaction_id 一部のイベントとユースケースで必須です。詳細については、データを Event オブジェクトに変換するをご覧ください。
params.items cart_data.items 詳しくは、カートデータのアイテム フィールドをご覧ください。
params.coupon cart_data.coupon_codes coupon_codes フィールドを使用して、カートに適用されたクーポンを指定します。Google アナリティクス用のクーポンは 1 つのみ提供してください。これは、個々の商品アイテムに cart_data.items.additional_item_parameters を使用して設定できる Item レベルのクーポンとは異なります。
params.session_id additional_event_parameters parameter_name が session_id に設定されているエントリにマッピングします。
params.engagement_time_msec additional_event_parameters parameter_name が engagement_time_msec に設定されているエントリにマッピングします。
その他 params additional_event_parameters

他のパラメータは、parameter_name と value を含むオブジェクトのリストとしてマッピングします。

注: ここに transaction_id、currency、value のエントリを追加しないでください。代わりに Event の最上位フィールドを使用してください。

ユーザー識別子フィールド

Measurement Protocol user_data UserIdentifier（Data Manager API） メモ
sha256_email_address[] email_address 形式設定とハッシュ化されたメールアドレスに設定します。ハッシュ化されたメールアドレスを暗号化することもできます。
sha256_phone_number[] phone_number 形式設定とハッシュ化された電話番号に設定します。ハッシュ化された電話番号を暗号化することもできます。
address[] address AddressInfo オブジェクトに設定します。形式とハッシュ化のガイドラインに沿って操作します。
address[].sha256_first_name address.given_name フォーマットされハッシュ化された名に設定します。ハッシュ化された名前を暗号化することもできます。
address[].sha256_last_name address.family_name フォーマットされてハッシュ化されたファミリー名に設定します。ハッシュ化されたファミリー名を暗号化することもできます。
address[].country address.region_code
address[].postal_code address.postal_code
address[].city 同等のものはありません 現在のバージョンの Data Manager API ではサポートされていません。
address[].region 同等のものはありません 現在のバージョンの Data Manager API ではサポートされていません。
address[].sha256_street 同等のものはありません 現在のバージョンの Data Manager API ではサポートされていません。

カートのデータのアイテム フィールド

Measurement Protocol items[] Item（Data Manager API） メモ
item_id item_id 必須。
item_name additional_item_parameters parameter_name が item_name に設定されているエントリにマッピングします。
quantity quantity 必須。
price unit_price 必須。
その他の商品アイテム フィールド additional_item_parameters

他の商品パラメータ（discount、affiliation、item_brand など）を、parameter_name と value を含むオブジェクトのリストとしてマッピングします。

注: ここに quantity、price、item_id のエントリを追加しないでください。代わりに Item の最上位フィールドを使用してください。

ユーザーの所在地フィールド

Measurement Protocol user_location EventLocation（Data Manager API） メモ
city city イベントが発生した都市の名前。
country_id region_code 2 文字の CLDR 地域コードに設定します。
region_id subdivision_code ISO 3166-2 区分コードに設定します。
continent_id continent_code 国連 M49 形式の地域コードに設定します。
subcontinent_id subcontinent_code 国連 M49 形式の亜大陸コードに設定します。

デバイス フィールド

Measurement Protocol device DeviceInfo（Data Manager API） メモ
category category
language language_code
screen_resolution screen_height、screen_width Measurement Protocol では、screen_resolution は文字列（"1280x720"）として提供されます。Data Manager API では、screen_height と screen_width を個別の整数値として送信します。
operating_system operating_system
operating_system_version operating_system_version
model model
brand brand
browser browser
browser_version browser_version
前へ
アップグレードの手順