Créer et gérer des audiences

Une Audience est une collection réutilisable de segments ciblés, de ciblage démographique et d'exclusions. Le ciblage d'audience est disponible pour les campagnes Performance Max, Demand Gen et pour applications. Si vous souhaitez cibler directement des segments d'audience dans une campagne display, vidéo, d'hôtel, Shopping standard ou sur le Réseau de Recherche, consultez Segments d'audience.

Créer des audiences

Créez et mettez à jour une audience à l'aide de la méthode AudienceService. Chaque Audience doit avoir un nom unique. Cette audience réutilisable permet de combiner plusieurs dimensions d'audience :

Inspectez MutateAudienceResult pour audience_id.

Lorsque vous créez une audience avec AudienceService.MutateAudiences, chaque opération renvoie un MutateAudienceResult. Vous pouvez inspecter MutateAudienceResult pour obtenir audience_id en analysant l'élément resource_name renvoyé, et vous pouvez inspecter les champs modifiables (tels que name) sur l'objet audience renvoyé lorsque response_content_type est défini sur MUTABLE_RESOURCE :

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

Récupérer des audiences

Comme pour les autres ressources, vous pouvez utiliser GoogleAdsService.SearchStream pour récupérer les attributs des audiences.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Audiences cibles

Les audiences peuvent être ciblées de différentes manières selon le type de campagne.

Signaux du groupe de composants

Les campagnes Performance Max utilisent un AssetGroupSignal pour cibler les audiences. Consultez le guide Signaux de groupe de composants pour savoir comment cibler des audiences à l'aide de signaux de groupe de composants.

Critère du groupe d'annonces

Les campagnes de génération de la demande et pour applications permettent d'ajouter un critère de groupe d'annonces d'audience à l'aide de AdGroupCriterion pour cibler des audiences ou fournir des signaux d'audience. Vous pouvez cibler des audiences au niveau du groupe d'annonces à l'aide des critères AudienceInfo sur AdGroupCriterion.audience en définissant le champ AudienceInfo.audience (ad_group_criterion.audience.audience) sur le nom de la ressource d'audience.

Voici la procédure à suivre pour configurer le ciblage d'audience :

Activez le ciblage d'audience dans AdGroup.

Vous devez activer le ciblage d'audience dans AdGroup en définissant use_audience_grouped sur true lors de la création du groupe d'annonces. Ce paramètre ne peut pas être modifié une fois le groupe d'annonces créé.

Cela vous permet d'ajouter AdGroupCriterion avec des audiences. Si cette valeur n'est pas définie sur true, votre requête ultérieure de ciblage de l'audience échouera.

Créer un AdGroupCriterion

Créez un AdGroupCriterion et définissez le champ AudienceInfo.audience sur AdGroupCriterion.audience sur le nom de ressource de l'audience créée dans Créer des audiences.

Facultatif : Activez le ciblage d'audience dans Campaign.

Vous pouvez éventuellement définir use_audience_grouped sur true lors de la création de la campagne. Avec ce paramètre, un message d'erreur s'affiche si vous essayez d'ajouter des critères qui excluraient des segments et des données démographiques au niveau de la campagne.

Bonnes pratiques

  • Utilisez les audiences pour créer des personas. Les audiences sont particulièrement utiles dans les campagnes Performance Max, Demand Gen et pour applications, où vous souhaitez superposer plusieurs segments et critères démographiques pour cibler un persona spécifique.
  • Utilisez des segments d'audience pour le ciblage direct. Pour les campagnes display, vidéo, d'hôtel, Shopping standards et sur le Réseau de Recherche, ou lorsque vous n'avez besoin de cibler qu'un seul segment (comme une liste de remarketing), utilisez des segments d'audience au lieu d'audiences.

Erreurs fréquentes

Lors de la création ou de la mise à jour d'un Audience, l'API Google Ads valide la requête et renvoie des erreurs de l'énumération AudienceError en cas d'échec de la validation.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Résumé Un segment d'audience de la requête est introuvable.
Causes courantes Référence à un ID de segment qui n'existe pas ou n'est pas accessible.
Réponse Assurez-vous que tous les ID de segment existent et sont accessibles avant de créer ou de mettre à jour une audience.
Conseils de prévention Validez les ID de segment avant de les inclure dans une audience.
DIMENSION_INVALID
Résumé Une dimension d'audience n'est pas valide.
Causes courantes Y compris detailed_demographic dans exclusion_dimension.
Réponse N'utilisez user_list que pour les exclusions dans exclusion_dimension.
Conseils de prévention Assurez-vous que seul user_list est utilisé dans exclusion_dimension lors de la création ou de la mise à jour d'une audience.
DUPLICATE_AUDIENCE_SEGMENT
Résumé L'audience contient des segments en double.
Causes courantes Ajouter plusieurs fois le même segment à la même audience.
Réponse Supprimez les segments en double de la définition d'audience.
Conseils de prévention Assurez-vous que tous les segments d'une audience sont uniques.
NAME_ALREADY_IN_USE
Résumé Ce nom d'audience est déjà utilisé.
Causes courantes Tentative de création de plusieurs audiences portant le même nom.
Réponse Utilisez un nom unique lorsque vous créez une audience.
Conseils de prévention Vérifiez les noms d'audience existants avant d'en créer un autre.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Résumé L'audience contient trop de dimensions du même type.
Causes courantes Inclure plusieurs dimensions du même type (par exemple, plusieurs dimensions d'âge) dans une même audience.
Réponse Assurez-vous que la définition d'audience ne contient qu'une seule dimension de chaque type.
Conseils de prévention Examinez la définition d'audience pour vous assurer qu'aucun type de dimension en double n'est inclus.
TOO_MANY_SEGMENTS
Résumé L'audience contient trop de segments.
Causes courantes Le nombre maximal de segments autorisé dans une audience a été dépassé.
Réponse Réduisez le nombre de segments dans la définition d'audience.
Conseils de prévention Consultez la documentation pour connaître les limites du nombre de segments par audience.