フィールド マッピング

表のマッピングを使用して、Google Ads API の UploadClickConversionRequestを Data Manager API の同等の IngestEventsRequestにマッピングします。

リクエスト フィールド

UploadClickConversionRequest （Google Ads API） IngestEventsRequest （Data Manager API） メモ
  • customer_id
  • developer-token リクエスト ヘッダー
  • login-customer_id リクエスト ヘッダー
  • linked-customer-id リクエスト ヘッダー
  • conversion_action
 destinations お客様とコンバージョン アクションのフィールドをご覧ください。
同等のものはありません consent リクエスト内のイベントのデフォルトの同意設定（省略可）。個々のイベントでこの値をオーバーライドするには、Event の consent フィールドを設定します。
同等のものはありません encoding 必須: UserIdentifier 値に使用される Encoding に設定します。
同等のものはありません encryption_info リクエストに暗号化された値が含まれている場合は設定します。詳しくは、暗号化をご覧ください。
job_id 同等のものはありません レスポンスで返された request_id を使用して 診断情報を取得します。
partial_failure 同等のものはありません Data Manager API は部分的な失敗をサポートしていません。IngestEventsRequest のいずれかのフィールドの検証に失敗した場合、Data Manager API はリクエスト全体を拒否します。
validate_only validate_only
conversions events コンバージョンまたはイベントのリスト。詳しくは、コンバージョン フィールドのセクションをご覧ください。

お客様とコンバージョン アクションのフィールド

Google Ads API では developer-token リクエスト ヘッダーが必要であり、さまざまな認証シナリオで login-customer-id と linked-customer-id リクエスト ヘッダー を設定します。

Data Manager API では開発者トークンは必要ありません。リクエスト ヘッダーではなく、Destination のフィールドを使用してログインとリンクされた顧客情報を指定します。宛先の詳細については、宛先を構成するをご覧ください。

単一の conversion_action の Google Ads API フィールドを Destination の同等のフィールドにマッピングする方法は次のとおりです。

Google Ads API Destination （Data Manager API） メモ
リクエストの customer_id operating_account account_id を Google 広告コンバージョン アカウントのお客様 ID に設定します。operating_account の account_type を GOOGLE_ADS に設定します。
developer-token リクエスト ヘッダー 同等のものはありません Data Manager API には開発者トークンは必要ありません。
login-customer-id リクエスト ヘッダー login_account account_id をログイン アカウントのお客様 ID に設定します。ログイン アカウントが Google 広告アカウントの場合は account_type を GOOGLE_ADS に、ログイン アカウントがデータ パートナー アカウントの場合は DATA_PARTNER に設定します。
linked-customer-id リクエスト ヘッダー linked_account パートナー リンクを使用して operating_account にアクセスする場合は、リンクされたアカウントのお客様 ID に account_id を設定し、account_type を DATA_PARTNER に設定します。それ以外の場合は、linked_account フィールドを設定しないでください。
ClickConversion の conversion_action product_destination_id コンバージョン アクションの数値 ID に設定します。ConversionAction のリソース名は使用しないでください。
同等のものはありません reference Destination のユーザー定義の ID。単一のリクエストで複数のコンバージョン アクションのコンバージョンを送信する場合は、このフィールドを設定します。

コンバージョン フィールド

ClickConversion （Google Ads API） Event （Data Manager API） メモ
cart_data cart_data 詳しくは、カートデータのフィールドをご覧ください。
consent consent どちらの API も同様の Consent オブジェクト（ad_user_data、ad_personalization）を使用します。
Data Manager API では、リクエスト レベルの consent フィールドを設定することで、 リクエスト内のすべてのイベントの同意を設定することもできます。
conversion_action destination_references 単一のリクエストで複数のコンバージョン アクションのコンバージョンを送信する場合は、このフィールドをreferenceの宛先に対応する設定します。
conversion_date_time event_timestamp
  • JSON 形式を使用する場合は、RFC 3339 形式の値に設定します。これは、Google Ads API の日付と時刻の形式とは 若干異なります。
  • プロトコル バッファを使用する場合は、Timestamp を使用して、seconds フィールドと nanoseconds フィールド（省略可）を設定します。

詳しくは、タイムスタンプの形式をご覧ください。
conversion_environment 同等のものはありません
conversion_value conversion_value マイクロ単位の値ではなく、通貨の値に設定します。たとえば、コンバージョン値が $5.23 の場合は、値 5.23 を使用します。
currency_code currency
custom_variables custom_variables 詳しくは、カスタム変数のフィールドをご覧ください。
customer_type
同等のものはありません event_source
同等のものはありません event_device_info
external_attribution_data 同等のものはありません
gbraid ad_identifiers.gbraid
gclid ad_identifiers.gclid
同等のものはありません last_updated_timestamp
order_id transaction_id
session_attributes_encoded ad_identifiers.session_attributes 詳しくは、セッション属性を追加するをご覧ください。
session_attributes_key_value_pairs experimental_fields 詳しくは、セッション属性を追加するをご覧ください。
user_identifiers user_data.user_identifiers 詳しくは、ユーザー識別子フィールドをご覧ください。
user_ip_address landing_page_device_info.ip_address
wbraid ad_identifiers.wbraid

カートデータのフィールド

CartData （Google Ads API） CartData （Data Manager API） メモ
feed_country_code merchant_feed_label フィードラベルに設定します。
feed_language_code merchant_feed_language_code
items items
local_transaction_cost transaction_discount
merchant_id merchant_id

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

Item （Google Ads API） Item （Data Manager API） メモ
product_id merchant_product_id
quantity quantity
unit_price unit_price
同等のものはありません item_id
同等のものはありません additional_item_parameters

カスタム変数のフィールド

CustomVariable （Google Ads API） CustomVariable （Data Manager API） メモ
同等のものはありません destination_references Google Ads API では、コンバージョン アクションごとに個別のリクエストが必要です。Data Manager API では、単一のリクエストで複数のコンバージョン アクションのコンバージョンを送信できます。また、この destination_references フィールドを使用して、特定のカスタム変数を受け取る宛先を指定することもできます。
conversion_custom_variable variable リソース名ではなく、変数の名前に設定します。
value value

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

UserIdentifier （Google Ads API） UserIdentifier （Data Manager API）
address_info address フォーマットとハッシュ化のガイドラインに従ってください。アドレスのハッシュ化された属性を暗号化することもできます。
hashed_email email_address フォーマットしてハッシュ化したメールアドレスに設定します。ハッシュ化したメールアドレスを暗号化することもできます。
hashed_phone_number phone_number フォーマットしてハッシュ化した電話番号に設定します。ハッシュ化した電話番号を暗号化することもできます。
その他のフィールド:
  • mobile_id
  • third_party_user_id
  • user_identifier_source
 関連なし どちらの API も、オフライン コンバージョンまたはリードの拡張コンバージョンでこれらの ID をサポートしていません。また、Data Manager API は、コンバージョン イベントを追加のデータソースとして送信する場合にこれらの ID をサポートしていません。

レスポンスのフィールド

UploadClickConversionResponse （Google Ads API） IngestEventsResponse （Data Manager API） メモ
job_id 同等のものはありません レスポンスで返された request_id を使用して 診断情報を取得します。
partial_failure_error 同等のものはありません Data Manager API は部分的な失敗をサポートしていません。IngestEventsRequest のいずれかのフィールドの検証に失敗した場合、Data Manager API はリクエスト全体を拒否します。
request-id レスポンス ヘッダー request_id リクエスト ID は、レスポンス ヘッダーではなく、Data Manager API のレスポンス フィールドとして返されます。
results 同等のものはありません Data Manager API はイベントを非同期で処理します。診断を使用して処理結果を確認します。
前へ
アップグレードの手順