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 AudienceService. Chaque Audience doit avoir un nom unique. Cette audience réutilisable permet de combiner plusieurs dimensions d'audience :

Inspecter 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 le audience_id en analysant le 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 de groupe de composants

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

Critère du groupe d'annonces

Les campagnes Demand Gen 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 ressource de l'audience.

Voici comment 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 lorsque le groupe d'annonces est créé. 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 demande 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 avec 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 plus efficaces dans les campagnes Performance Max, Demand Gen et pour applications, où vous pouvez 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 ou lorsque vous n'avez besoin de cibler qu'un seul segment (comme une liste de remarketing), utilisez les segments d'audience au lieu des audiences.

Erreurs fréquentes

Lorsque vous créez ou mettez à jour un Audience, l'API Google Ads valide la requête et renvoie des erreurs à partir 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 Vous faites référence à un ID de segment qui n'existe pas ou qui est inaccessible.
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 que user_list pour les exclusions dans exclusion_dimension.
Conseils de prévention Assurez-vous que seul user_list est utilisé dans exclusion_dimension lorsque vous créez ou mettez à jour 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é Le nom de l'audience est déjà utilisé.
Causes courantes Vous avez tenté de créer plusieurs audiences portant le même nom.
Réponse Attribuez un nom unique à votre audience lorsque vous la créez.
Conseils de prévention Vérifiez si le nom d'une audience existe déjà avant d'en créer une.
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 Dépassement du nombre maximal de segments autorisés dans une audience.
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.