Mappages de champs

Utilisez les mappages de champs pour migrer chaque étape de votre workflow de ciblage par liste de clients de l'API Google Ads vers l'API Data Manager :

Mappages des champs de gestion des audiences

Utilisez les mappages dans les tableaux pour mapper un UserList dans l'API Google Ads à son équivalent UserList dans l'API du Gestionnaire de données.

UserList (API Google Ads) UserList (API Data Manager) Remarques
resource_name name Pour en savoir plus, consultez Noms de ressources.
id id
read_only read_only
name display_name Obligatoire
description description Obligatoire
membership_status membership_status
integration_code integration_code
membership_life_span membership_duration

Durée pendant laquelle un membre de l'audience reste dans la liste après y avoir été ajouté. La valeur doit correspondre à des jours entiers. Si ce champ n'est pas défini, la valeur par défaut est la valeur maximale.

Mettez en forme la valeur à l'aide du format d'horodatage.
size_for_display size_info.display_network_members_count
size_range_for_display Aucun équivalent. Utilisez size_info.display_network_members_count pour obtenir des informations sur la taille.
size_for_search size_info.search_network_members_count
size_range_for_search Aucun équivalent. Utilisez size_info.search_network_members_count pour obtenir des informations sur la taille.
type Aucun équivalent.
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 Non utilisé pour le ciblage par liste de clients.
crm_based_user_list ingested_user_list_info Obligatoire. Consultez les informations sur les audiences de ciblage par liste de clients.
Aucun équivalent. ingested_user_list_info.pair_id_info Non utilisé pour le ciblage par liste de clients.
Aucun équivalent. ingested_user_list_info.partner_audience_info Non utilisé pour le ciblage par liste de clients.
logical_user_list Aucun équivalent. Non utilisé pour le ciblage par liste de clients.
logical_user_list Aucun équivalent. Non utilisé pour le ciblage par liste de clients.
lookalike_user_list Aucun équivalent. Non utilisé pour le ciblage par liste de clients.
rule_based_user_list Aucun équivalent. Non utilisé pour le ciblage par liste de clients.
similar_user_list Aucun équivalent. Non utilisé pour le ciblage par liste de clients.

Informations sur les audiences de ciblage par liste de clients

Dans l'API Google Ads, le champ crm_based_user_list est obligatoire lors de la création d'une audience de ciblage par liste de clients.

Dans l'API Data Manager, définissez les attributs équivalents en définissant le champ ingested_user_list_info sur IngestedUserListInfo, puis définissez les champs requis pour le ciblage par liste de clients et le type de données utilisateur.

Coordonnées

upload_key_types
Définissez une liste contenant CONTACT_INFO.
contact_id_info

Définissez-le sur ContactIdInfo.

Définissez data_source_type sur DATA_SOURCE_TYPE_FIRST_PARTY.

ID mobiles

upload_key_types
Définissez une liste contenant MOBILE_ID.
mobile_id_info

Définissez-le sur MobileIdInfo.

  • Définissez data_source_type sur DATA_SOURCE_TYPE_FIRST_PARTY.
  • Définissez key_space sur IOS ou ANDROID.
  • Définissez app_id sur la chaîne qui identifie de manière unique l'application mobile à partir de laquelle les données ont été collectées. Utilisez le même format que celui de l'ID d'application dans l'API Google Ads.

ID utilisateur

upload_key_types
Définissez une liste contenant USER_ID.
user_id_info

Définissez-le sur UserIdInfo.

Définissez data_source_type sur DATA_SOURCE_TYPE_FIRST_PARTY.

Noms de ressources

L'API Data Manager utilise un format de nom de ressource différent de celui de l'API Google Ads.

API Google Ads

Dans l'API Google Ads, un nom de ressource UserList utilise le format suivant :

customers/{customer_id}/userLists/{user_list_id}

API Data Manager

Dans l'API Data Manager, un nom de ressource UserList utilise le format suivant :

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

Importer des mappages de champs

Utilisez les mappages dans les tableaux pour mapper un AddOfflineUserDataJobOperationsRequest dans l'API Google Ads à son équivalent IngestAudienceMembersRequest dans l'API du Gestionnaire de données.

Champs des demandes

AddOfflineUserDataJobOperationsRequest (API Google Ads) IngestAudienceMembersRequest (API Data Manager) Remarques
  • Champ customer_id
  • Champ customer_match_user_list_metadata de OfflineUserDataJob
  • developer-token en-tête de requête
  • login-customer_id en-tête de requête
  • linked-customer-id en-tête de requête
 destinations Consultez Champs client et audience.
consent de l' customer_match_user_list_metadata de OfflineUserDataJob consent Paramètres de consentement par défaut facultatifs pour les membres de l'audience dans la demande. Vous pouvez remplacer cette valeur pour un membre d'audience individuel en définissant le champ consent de AudienceMember.
Aucun équivalent encoding Obligatoire : définissez sur le Encoding utilisé pour les valeurs UserIdentifier.
Aucun équivalent encryption_info Indique si la requête contient des valeurs chiffrées. Pour en savoir plus, consultez Chiffrement.
job_id Aucun équivalent Utilisez le request_id renvoyé dans la réponse pour récupérer les diagnostics.
enable_partial_failure Aucun équivalent L'API Gestionnaire de données n'est pas compatible avec les échecs partiels. Si la validation d'un champ d'un IngestAudienceMembersRequest échoue, l'API Data Manager rejette l'intégralité de la requête. Récupérez les erreurs de traitement à l'aide de la section Diagnostics.
enable_warnings Aucun équivalent L'API Gestionnaire de données ne signale pas d'avertissements dans la réponse. Récupérez les avertissements de traitement à l'aide de diagnostics.
validate_only validate_only
operations audience_members Liste des membres de l'audience. Pour en savoir plus, consultez la section Champs des membres de l'audience.
Aucun équivalent terms_of_service Obligatoire. Indique si l'utilisateur a accepté ou refusé les conditions d'utilisation du ciblage par liste de clients.

Champs client et audience

L'API Google Ads n'accepte l'importation de membres d'audience que dans une seule audience par job.De plus, l'en-tête de requête developer-token est obligatoire, et vous devez définir les en-têtes de requête login-customer-id et linked-customer-id pour différents scénarios d'authentification.

L'API Data Manager permet d'envoyer les membres de plusieurs audiences dans une seule requête. L'API Data Manager ne nécessite pas de jeton de développeur. Vous spécifiez les informations de connexion et les informations client associées à l'aide des champs d'un Destination au lieu des en-têtes de requête. Pour en savoir plus sur les destinations, consultez Configurer des destinations.

L'API Gestionnaire de données ne permet pas de supprimer tous les membres d'une audience. Dans l'API Google Ads, vous pouvez supprimer tous les membres d'une audience en définissant le champ remove_all d'un OfflineUserDataJobOperation sur true.

Voici comment mapper les champs de l'API Google Ads pour une seule audience avec les champs équivalents dans un Destination :

API Google Ads Destination (API Data Manager) Remarques
customer_id de la demande operating_account Définissez account_id sur l'ID client de l'audience. Définissez le account_type de operating_account sur GOOGLE_ADS.
developer-token en-tête de requête Aucun équivalent Un jeton de développeur n'est pas requis pour l'API Gestionnaire de données.
login-customer-id en-tête de requête login_account Définissez account_id sur le numéro client du compte de connexion. Définissez account_type sur GOOGLE_ADS si le compte de connexion est un compte Google Ads, ou sur DATA_PARTNER s'il s'agit d'un compte de partenaire de données.
linked-customer-id en-tête de requête linked_account Définissez account_id sur le numéro client du compte associé. Définissez account_type sur DATA_PARTNER.
user_list à partir de customer_match_user_list_metadata sur OfflineUserDataJob product_destination_id Obligatoire. Définissez l'ID numérique de l'audience. N'utilisez pas le nom de ressource de UserList.
Aucun équivalent reference Identifiant défini par l'utilisateur pour Destination. Définissez ce champ si vous envoyez des membres d'audience pour plusieurs audiences dans une même demande.

Champs des membres de l'audience

UserData (API Google Ads) AudienceMember (API Data Manager) Remarques
consent consent

Défini pour spécifier le consentement du membre de l'audience.

Les deux API utilisent un objet Consent similaire (ad_user_data, ad_personalization).

Pour l'API Data Manager, vous pouvez également définir le consentement pour tous les membres d'une audience dans une requête en définissant le champ consent au niveau de la requête.
transaction_attribute Aucun équivalent. Non applicable au ciblage par liste de clients.
user_attribute Aucun équivalent. Non applicable au ciblage par liste de clients.
user_identifiers
  • mobile_id_data
  • user_id_data
  • user_identifiers

Renseignez le champ qui correspond au type de données que vous envoyez pour les membres de l'audience. Pour en savoir plus, consultez Champs d'identifiant utilisateur.

Champs d'identifiant utilisateur

Dans l'API Google Ads, que vous envoyiez des coordonnées, des ID mobiles ou des ID utilisateur, vous utilisez UserIdentifier. L'API Data Manager utilise une approche différente, avec des champs différents pour chaque type de données.

Dans l'API Data Manager, renseignez le champ qui correspond au type de données que vous envoyez :

Coordonnées

Si vous utilisez des coordonnées telles qu'une adresse e-mail, un numéro de téléphone ou une adresse postale, définissez user_data sur UserData avec une entrée distincte dans user_identifiers pour chaque élément de coordonnées.

UserIdentifier (API Google Ads) UserIdentifier (API Data Manager) Remarques
address_info address Pour en savoir plus, consultez Champs d'adresse.
hashed_email email_address Définissez l'adresse e-mail mise en forme et hachée. Vous pouvez également chiffrer l'adresse e-mail hachée.
hashed_phone_number phone_number Définissez le numéro de téléphone mis en forme et haché. Vous pouvez également chiffrer le numéro de téléphone haché.
user_identifier_source Aucun équivalent.

Champs d'adresse

Voici les mappages de champs entre OfflineUserAddressInfo dans l'API Google Ads et AddressInfo dans l'API Data Manager. Utilisez ces mappages si vous utilisez des coordonnées pour remplir votre audience de ciblage par liste de clients.

OfflineUserAddressInfo (API Google Ads) AddressInfo (API Data Manager) Remarques
city Aucun équivalent.
country_code region_code
hashed_first_name given_name

Définissez le nom donné mis en forme et haché. Vous pouvez également chiffrer le nom donné haché.
hashed_last_name family_name

Défini sur le nom de famille mis en forme et haché. Vous pouvez également chiffrer le nom de famille haché.
hashed_street_address Aucun équivalent.
postal_code postal_code
state Aucun équivalent.

ID mobiles

Si vous utilisez des ID mobiles, définissez mobile_data sur MobileData avec une entrée dans mobile_ids pour chaque ID.

UserIdentifier (API Google Ads) MobileData (API Data Manager) Remarques
mobile_id mobile_ids Définissez la liste des ID mobiles pour le membre de l'audience.

Dans l'API Google Ads, vous ajoutez un UserIdentifier avec mobile_id pour chaque ID mobile du membre de l'audience. Dans l'API Data Manager, ajoutez un seul MobileData avec mobile_ids défini sur la liste de tous les ID mobiles du membre de l'audience.

user_identifier_source Aucun équivalent.

ID utilisateur

Si vous utilisez des ID utilisateur, définissez user_id_data sur UserIdData et user_id sur l'ID utilisateur du membre de l'audience.

UserIdentifier (API Google Ads) UserIdData (API Data Manager) Remarques
third_party_user_id user_id

Dans l'API Google Ads, vous ajoutez un UserIdentifier avec third_party_user_id pour chaque ID utilisateur du membre de l'audience.

Dans l'API Data Manager, définissez le champ user_id_data sur UserIdData et son champ user_id sur l'ID utilisateur du membre de l'audience. Vous ne pouvez pas envoyer plusieurs ID utilisateur pour le même membre de l'audience.

user_identifier_source Aucun équivalent.
Précédent
Procédure de mise à jour