フィールド マッピング

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

認証

Data Manager API には、Google Ads API とは異なるスコープの認証情報が必要です。API アクセスを設定するの手順に沿って、Data Manager API スコープを含む新しい認証情報を生成します。

リクエスト フィールド

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 のフィールドを使用して指定します。宛先の詳細については、宛先を構成するをご覧ください。

1 つの conversion_action の Google Ads API フィールドを Destination の対応するフィールドにマッピングする方法は次のとおりです。

Google Ads API Destination（Data Manager API） メモ
リクエストの customer_id operating_account account_id を Google 広告コンバージョン アカウントのお客様 ID に設定します。これは、Google Ads API リクエストの customer_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 にアクセスする場合は、account_id をリンクされたアカウントのお客様 ID に設定し、account_type を DATA_PARTNER に設定します。それ以外の場合は、linked_account フィールドを設定しないでください。
ClickConversion の conversion_action product_destination_id コンバージョン アクションの数値 ID に設定します。ConversionAction のリソース名は使用しないでください。
同等のものはありません reference Destination のユーザー定義 ID。1 つのリクエストで複数のコンバージョン アクションのコンバージョンを送信する場合は、このフィールドを設定します。

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

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 1 つのリクエストで複数のコンバージョン アクションのコンバージョンを送信する場合は、このフィールドをリンク先の対応する 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 user_properties.customer_type CustomerType 列挙型の値に設定します。
同等のものはありません 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 は、1 つのリクエストで複数のコンバージョン アクションのコンバージョンを送信することと、この 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 も、オフライン コンバージョンまたはリードの拡張コンバージョンでこれらの識別子をサポートしていません。また、Data Manager API は、コンバージョン イベントを追加のデータソースとして送信する際にこれらの識別子をサポートしていません。

レスポンスのフィールド

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 はイベントを非同期で処理します。診断を使用して処理結果を確認します。
前へ
アップグレードの手順