Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

フィールドマッピング

テーブルのマッピングを使用して、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`	Measurement Protocol 検証サーバーと同様に、データを取り込まずにイベントを検証するには、`validate_only` を `true` に設定します。
同等のものはありません	`encoding`	`UserData` のアップロードに必要です。`Encoding` 値に使用される `UserIdentifier` に設定します。

宛先フィールド

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 つのクーポンのみを指定してください。これは `Item` レベルのクーポンとは独立しています。`cart_data.items.additional_item_parameters` は、個々のアイテムのクーポンを設定できます。
`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`

アップグレードの手順

フィールド マッピング コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

リクエスト フィールド