Créer et gérer des audiences

Un Audience est un ensemble 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 standards 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 autorise une combinaison de 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é. Vous pouvez également inspecter les champs modifiables (tels que name) dans 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 plusieurs manières, en fonction du 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 de AudienceInfo critères sur AdGroupCriterion.audience en définissant le champ AudienceInfo.audience (ad_group_criterion.audience.audience) sur le nom de ressource de l'audience.

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

Activer le ciblage d'audience dans le AdGroup

Vous devez activer le ciblage d'audience dans le 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 visant à cibler l'audience échouera.

Créer un AdGroupCriterion

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

Facultatif : Activer le ciblage d'audience dans la Campaign

Vous pouvez également définir use_audience_grouped sur true lors de la création de la campagne. Avec ce paramètre, vous recevez une erreur 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

  • Utiliser des audiences pour créer des personas Les audiences sont plus efficaces 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.
  • Utiliser 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 des segments d'audience plutôt que 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 de l'enum AudienceError si la validation échoue.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Résumé Un segment d'audience de la requête n'a pas été trouvé.
Causes courantes 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 Inclure 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 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é Le nom de l'audience est déjà utilisé.
Causes courantes Tenter de créer 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 si des audiences portant le même nom existent 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épasser le nombre maximal de segments autorisé dans une audience.
Réponse Réduisez le nombre de segments dans la définition de l'audience.
Conseils de prévention Consultez la documentation pour connaître les limites du nombre de segments par audience.
Précédent
Aperçu
Suivant
Premiers pas avec les segments d'audience