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 de champs de gestion des audiences contient les mappages de champs permettant de créer, de mettre à jour et de récupérer des audiences.

• Mappages de champs d'ingestion contient des mappages de champs pour ajouter ou supprimer des membres de l'audience.

Authentification

L'API Data Manager nécessite des identifiants avec un champ d'application différent de celui de l'API Google Ads. Suivez la procédure décrite dans Configurer l'accès à l'API pour générer de nouveaux identifiants incluant le champ d'application de l'API Data Manager.

Mappages de champs de gestion des audiences

Utilisez les correspondances dans les tableaux pour mapper un UserList dans l'API Google Ads à son équivalent UserList dans l'API Data Manager.

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 le maximum. Mettez en forme la valeur à l'aide du format de code temporel.
size_for_display	size_info.display_network_members_count
size_range_for_display	Aucun équivalent.	Utilisez l'attribut size_info.display_network_members_count pour indiquer la taille.
size_for_search	size_info.search_network_members_count
size_range_for_search	Aucun équivalent.	Utilisez l'attribut size_info.search_network_members_count pour indiquer 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 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 l'audience de ciblage par liste de clients

Dans l'API Google Ads, vous devez définir le champ crm_based_user_list sur CrmBasedUserListInfo lorsque vous créez 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 un IngestedUserListInfo, puis définissez les champs obligatoires pour le ciblage par liste de clients et le type de données utilisateur.

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, le nom d'une ressource UserList utilise le format suivant :

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

Importer des mappages de champs

Utilisez les mappages des tableaux pour mapper un AddOfflineUserDataJobOperationsRequest dans l'API Google Ads à sa requête IngestionService équivalente dans l'API Data Manager.

Champs des demandes

Ces mappages utilisent IngestAudienceMembersRequest dans l'API Data Manager comme référence, mais vous pouvez également les utiliser si vous convertissez votre requête API Google Ads en RemoveAudienceMembersRequest ou en RemoveAllAudienceMembersRequest.

AddOfflineUserDataJobOperationsRequest (API Google Ads)	IngestAudienceMembersRequest (API Data Manager)	Remarques
Champ customer_id Champ customer_match_user_list_metadata de OfflineUserDataJob En-tête de requête developer-token En-tête de requête login-customer_id En-tête de requête linked-customer-id	destinations	Consultez Champs de client et d'audience.
consent de la customer_match_user_list_metadata de OfflineUserDataJob	consent	Paramètres de consentement par défaut facultatifs pour les membres de l'audience dans la requête. 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	Définissez 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 Data Manager utilise un modèle d'erreur à échec rapide. 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 diagnostics.
enable_warnings	Aucun équivalent	L'API Data Manager ne signale pas d'avertissements dans la réponse. Récupérez les avertissements de traitement à l'aide des diagnostics.
validate_only	validate_only
operations	audience_members	Liste des membres de l'audience à ajouter ou à supprimer. Pour en savoir plus, consultez la section Champs d'opération.
Aucun équivalent	terms_of_service	Obligatoire. Définissez ce champ pour indiquer que 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 des membres d'une audience que pour une 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 des membres d'audience pour 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 du client associé à 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.

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.

Dans l'API Data Manager, vous pouvez le faire en envoyant un RemoveAllAudienceMembersRequest. Pour en savoir plus, consultez le guide Supprimer tous les membres.

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 la propriété account_type de l'élément operating_account sur GOOGLE_ADS.
En-tête de requête developer-token	Aucun équivalent	Vous n'avez pas besoin de jeton de développeur pour l'API Data Manager.
En-tête de requête login-customer-id	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 pour les données.
En-tête de requête linked-customer-id	linked_account	Si vous accédez à operating_account à l'aide d'un lien partenaire, définissez account_id sur le numéro client du compte associé et définissez account_type sur DATA_PARTNER. Sinon, ne définissez pas le champ linked_account.
user_list de l'customer_match_user_list_metadata de 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 l'Destination. Définissez ce champ si vous envoyez des membres d'audience pour plusieurs audiences dans une même requête.

Champs d'opération

L'API Data Manager contient des méthodes distinctes pour ajouter et supprimer des membres d'une audience. En revanche, l'objet AddOfflineUserDataJobOperationsRequest de l'API Google Ads contient une liste de operations, qui ajoutent un membre, suppriment un membre ou suppriment tous les membres en fonction du type d'opération. Voici la mise en correspondance de chaque type d'opération avec la méthode correspondante dans l'API Data Manager :

OfflineUserDataJobOperation (API Google Ads)	Méthode IngestionService (API Data Manager)	Remarques
create	IngestAudienceMembers	Pour en savoir plus, consultez la section Champs des membres de l'audience.
remove	RemoveAudienceMembers	Pour en savoir plus, consultez la section Champs des membres de l'audience.
remove_all	RemoveAllAudienceMembers	Pour en savoir plus, consultez Supprimer tous les membres de l'audience.

Champs des membres de l'audience

UserData (API Google Ads)	AudienceMember (API Data Manager)	Remarques
consent	consent	Définissez cette option pour spécifier le consentement du membre de l'audience. Les deux API utilisent un objet Consent semblable (ad_user_data, ad_personalization). Pour l'API Data Manager, vous pouvez également définir le consentement pour tous les membres de l'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_data user_id_data composite_data user_data ip_data	Renseignez le champ correspondant 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 d'appareil mobile 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 correspondant au type de données que vous envoyez :