フィールド マッピング

フィールド マッピングを使用して、カスタマー マッチ ワークフローの各ステップを Google Ads API から Data Manager API にアップグレードします。

オーディエンス管理のフィールド マッピング

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

UserList（Google Ads API） UserList（Data Manager API） メモ
resource_name name 詳細については、リソース名をご覧ください。
id id
read_only read_only
name display_name 必須
description description 必須
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

オーディエンス メンバーがリストに追加されてからリストに残る期間。値は整数の日数に対応している必要があります。設定しない場合、デフォルトは最大値になります。

タイムスタンプ形式を使用して値をフォーマットします。
size_for_display size_info.display_network_members_count
size_range_for_display 同等のものはありません。 サイズ情報には size_info.display_network_members_count を使用します。
size_for_search size_info.search_network_members_count
size_range_for_search 同等のものはありません。 サイズ情報には size_info.search_network_members_count を使用します。
type 同等のものはありません。
access_reason access_reason
account_user_list_status account_access_status
closing_reason closing_reason
eligible_for_search target_network_info.eligible_for_search
eligible_for_display target_network_info.eligible_for_display
match_rate_percentage ingested_user_list_info.contact_id_info.match_rate_percentage
basic_user_list ingested_user_list_info.pseudonymous_id_info カスタマー マッチには使用されません。
crm_based_user_list ingested_user_list_info 必須。カスタマー マッチのオーディエンス情報を参照してください。
同等のものはありません。 ingested_user_list_info.pair_id_info カスタマー マッチには使用されません。
同等のものはありません。 ingested_user_list_info.partner_audience_info カスタマー マッチには使用されません。
logical_user_list 同等のものはありません。 カスタマー マッチには使用されません。
logical_user_list 同等のものはありません。 カスタマー マッチには使用されません。
lookalike_user_list 同等のものはありません。 カスタマー マッチには使用されません。
rule_based_user_list 同等のものはありません。 カスタマー マッチには使用されません。
similar_user_list 同等のものはありません。 カスタマー マッチには使用されません。

カスタマー マッチ オーディエンスの情報

Google Ads API では、カスタマー マッチ オーディエンスを作成する際に crm_based_user_list フィールドが必要です。

Data Manager API で、ingested_user_list_info フィールドを IngestedUserListInfo に設定して同等の属性を設定し、カスタマー マッチに必要なフィールドとユーザーデータの種類を設定します。

連絡先情報

upload_key_types
CONTACT_INFO を含むリストに設定します。
contact_id_info

ContactIdInfo に設定します。

data_source_type を DATA_SOURCE_TYPE_FIRST_PARTY に設定します。

モバイル ID

upload_key_types
MOBILE_ID を含むリストに設定します。
mobile_id_info

MobileIdInfo に設定します。

  • data_source_type を DATA_SOURCE_TYPE_FIRST_PARTY に設定します。
  • key_space を IOS または ANDROID に設定します。
  • app_id を、データの収集元であるモバイル アプリケーションを一意に識別する文字列に設定します。Google Ads API でアプリ ID に使用するのと同じ形式を使用します。

ユーザー ID

upload_key_types
USER_ID を含むリストに設定します。
user_id_info

UserIdInfo に設定します。

data_source_type を DATA_SOURCE_TYPE_FIRST_PARTY に設定します。

リソース名

データ マネージャー API では、Google Ads API とは異なるリソース名形式が使用されます。

Google Ads API

Google Ads API では、UserList リソース名には次の形式が使用されます。

customers/{customer_id}/userLists/{user_list_id}

Data Manager API

Data Manager API では、UserList リソース名に次の形式を使用します。

accountTypes/{accountType}/accounts/{account}/userLists/{userList}

フィールド マッピングをアップロードする

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

リクエスト フィールド

AddOfflineUserDataJobOperationsRequest （Google Ads API） IngestAudienceMembersRequest （Data Manager API） メモ
  • customer_id フィールド
  • OfflineUserDataJob の customer_match_user_list_metadata フィールド
  • developer-token リクエスト ヘッダー
  • login-customer_id リクエスト ヘッダー
  • linked-customer-id リクエスト ヘッダー
 destinations 顧客とオーディエンスのフィールドをご覧ください。
OfflineUserDataJob の customer_match_user_list_metadata から consent consent リクエスト内のオーディエンス メンバーのデフォルトの同意設定（省略可）。個々のオーディエンス メンバーに対してこの値をオーバーライドするには、AudienceMember の consent フィールドを設定します。
同等のものはありません encoding 必須: UserIdentifier 値に使用される Encoding に設定します。
同等のものはありません encryption_info リクエストに暗号化された値が含まれているかどうかを設定します。詳細については、暗号化をご覧ください。
job_id 同等のものはありません レスポンスで返された request_id を使用して、診断を取得します。
enable_partial_failure 同等のものはありません Data Manager API は部分的な障害をサポートしていません。IngestAudienceMembersRequest のフィールドのいずれかの検証に失敗した場合、Data Manager API はリクエスト全体を拒否します。診断を使用して処理エラーを取得します。
enable_warnings 同等のものはありません データマネージャー API は、レスポンスで警告を報告しません。診断を使用して処理上の警告を取得します。
validate_only validate_only
operations audience_members オーディエンス メンバーのリスト。詳しくは、オーディエンス メンバーのフィールドのセクションをご覧ください。
同等のものはありません terms_of_service 必須。ユーザーが顧客データの照合の利用規約に同意したか拒否したかを示すように設定します。

顧客とオーディエンスのフィールド

Google Ads API では、ジョブごとに 1 つのオーディエンスにのみオーディエンス メンバーをアップロードできます。また、developer-token リクエスト ヘッダーが必要です。さまざまな認証シナリオに合わせて login-customer-id と linked-customer-id のリクエスト ヘッダーを設定します。

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

データ マネージャー API では、オーディエンスのすべてのメンバーを削除することはできません。Google Ads API では、OfflineUserDataJobOperation の remove_all フィールドを true に設定することで、オーディエンスのすべてのメンバーを削除できます。

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

Google Ads API Destination （Data Manager API） メモ
リクエストの customer_id operating_account account_id をオーディエンスの顧客 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 account_id をリンクされたアカウントのお客様 ID に設定します。account_type を DATA_PARTNER に設定します。
OfflineUserDataJob の customer_match_user_list_metadata から user_list product_destination_id 必須。オーディエンスの数値 ID に設定します。UserList のリソース名は使用しないでください。
同等のものはありません reference Destination のユーザー定義の識別子。1 回のリクエストで複数のオーディエンスのオーディエンス メンバーを送信する場合は、このフィールドを設定します。

オーディエンス メンバーのフィールド

UserData （Google Ads API） AudienceMember （Data Manager API） メモ
consent consent

オーディエンス メンバーの同意を指定するために設定します。

どちらの API も同様の Consent オブジェクト（ad_user_data、ad_personalization）を使用します。

Data Manager API の場合、リクエスト レベルの consent フィールドを設定することで、リクエスト内のすべてのオーディエンス メンバーの同意を設定することもできます。
transaction_attribute 同等のものはありません。 カスタマー マッチには適用されません。
user_attribute 同等のものはありません。 カスタマー マッチには適用されません。
user_identifiers
  • mobile_id_data
  • user_id_data
  • user_identifiers

オーディエンス メンバーに送信するデータの種類に対応するフィールドに入力します。詳しくは、ユーザー識別子フィールドをご覧ください。

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

Google Ads API では、連絡先情報、モバイル ID、ユーザー ID のいずれを送信する場合でも、UserIdentifier を使用します。Data Manager API は、データ型ごとに異なるフィールドを使用する異なるアプローチを採用しています。

Data Manager API で、送信するデータのタイプに対応するフィールドに入力します。

連絡先情報

メールアドレス、電話番号、住所情報などの連絡先情報を使用する場合は、user_data を UserData に設定し、user_identifiers に連絡先情報項目ごとに個別のエントリを設定します。

UserIdentifier （Google Ads API） UserIdentifier （Data Manager API） メモ
address_info address 詳しくは、住所フィールドをご覧ください。
hashed_email email_address 形式設定とハッシュ化されたメールアドレスに設定します。ハッシュ化されたメールアドレスを暗号化することもできます。
hashed_phone_number phone_number 形式設定とハッシュ化された電話番号に設定します。ハッシュ化された電話番号を暗号化することもできます。
user_identifier_source 同等のものはありません。

住所フィールド

Google Ads API の OfflineUserAddressInfo とデータ マネージャー API の AddressInfo のフィールド マッピングは次のとおりです。連絡先情報を使用して顧客一致のオーディエンスを設定する場合は、これらのマッピングを使用します。

OfflineUserAddressInfo （Google Ads API） AddressInfo （Data Manager API） メモ
city 同等のものはありません。
country_code region_code
hashed_first_name given_name

フォーマットされハッシュ化された名に設定します。ハッシュ化された名前を暗号化することもできます。
hashed_last_name family_name

フォーマットされてハッシュ化されたファミリー名に設定します。ハッシュ化されたファミリー名を暗号化することもできます。
hashed_street_address 同等のものはありません。
postal_code postal_code
state 同等のものはありません。

モバイル ID

モバイル ID を使用する場合は、mobile_data を MobileData に設定し、各 ID の mobile_ids にエントリを追加します。

UserIdentifier （Google Ads API） MobileData （Data Manager API） メモ
mobile_id mobile_ids オーディエンス メンバーのモバイル ID のリストに設定します。

Google Ads API では、オーディエンス メンバーのモバイル ID ごとに、mobile_id を含む個別の UserIdentifier を追加します。Data Manager API で、mobile_ids がオーディエンス メンバーのすべてのモバイル ID のリストに設定された 単一の MobileData を追加します。
user_identifier_source 同等のものはありません。

ユーザー ID

ユーザー ID を使用する場合は、user_id_data を UserIdData に設定し、user_id をオーディエンス メンバーのユーザー ID に設定します。

UserIdentifier （Google Ads API） UserIdData （Data Manager API） メモ
third_party_user_id user_id

Google Ads API では、オーディエンス メンバーのユーザー ID ごとに、third_party_user_id を含む個別の UserIdentifier を追加します。

データマネージャー API で、user_id_data フィールドを UserIdData に設定し、その user_id フィールドをオーディエンス メンバーのユーザー ID に設定します。同じオーディエンス メンバーに複数のユーザー ID を送信することはできません。
user_identifier_source 同等のものはありません。
前へ
アップグレードの手順