フィールド マッピング

表のマッピングを使用して、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 のフィールドを使用して、ログイン情報とリンクされた顧客情報を指定します。宛先の詳細については、宛先を構成するをご覧ください。

単一の 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 リクエスト ヘッダー 同等のものはありません データマネージャー 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 のユーザー定義の識別子。単一のリクエストで複数のコンバージョン アクションのコンバージョンを送信する場合は、このフィールドを設定します。

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

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 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 も、オフライン コンバージョンやリードの拡張コンバージョンでこれらの 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 はイベントを非同期で処理します。診断を使用して処理結果を確認します。
前へ
アップグレードの手順