Critères

Les critères de ciblage peuvent être définis à trois niveaux différents :

• Au niveau de la campagne.
• Au niveau du groupe d'annonces.
• Au niveau du client.

Tous les types de critères ne peuvent pas être définis à tous les niveaux. Par exemple, certains ne peuvent être définis qu'au niveau de la campagne. De plus, certains critères ne peuvent être utilisés que pour le ciblage par exclusion, et d'autres uniquement pour le ciblage par inclusion.

Critères acceptés par niveau

Le tableau suivant décrit l'utilisation autorisée de tous les types de critères :

Différences entre les versions

Plusieurs types de critères et comportements de validation diffèrent selon les versions de l'API Google Ads compatibles :

• v26 et versions ultérieures :
  • Accepte require_eu_political_advertising_declaration sur CampaignCriterion et AdGroupCriterion pour déterminer si un critère nécessite une déclaration de publicité à caractère politique dans l'UE au niveau de la campagne.
  • Utilise des dimensions de voyage indépendantes du secteur dans AdGroupBidModifier et des motifs d'erreur indépendants du secteur dans CriterionError (en remplacement des critères et codes d'erreur spécifiques aux hôtels dans la v25 et les versions antérieures).
• v25 et versions ultérieures : accepte le critère EntityBid (entity_bid) sur AdGroupCriterion avec le type de critère VERTICAL_ADS_ITEM_BID pour définir des enchères au niveau des articles pour les entités de voyage dans les annonces verticales.
• v24 et versions ultérieures :
  • Compatible avec RetailFilterBundle (AdGroupCriterion.retail_filter_bundle et AssetGroupListingGroupFilter.Dimension.retail_filter_bundle) et RetailFilter (SharedCriterion.retail_filter) pour le filtrage des produits basé sur des tags (comptes sur liste d'autorisation uniquement).
  • Compatible avec les dimensions de règle user_rating, venue et event_participant_display_name sur VerticalAdsItemGroupRuleInfo dans SharedCriterion.
  • Compatible avec AssetGroupSignal.local_services_id et AssetGroupSignal.vertical_ads_item_group_rule_list (sur liste d'autorisation) pour les signaux de groupe de composants Performance Max.
  • Renvoie CriterionError.CANNOT_EXCLUDE_ALL_TARGETS lorsque vous tentez d'exclure toutes les cibles d'une dimension démographique (AgeRangeInfo, GenderInfo, IncomeRangeInfo ou ParentalStatusInfo).
  • Renvoie CriterionError.CANNOT_TARGET_LANGUAGE lorsque vous tentez de cibler une langue non autorisée.
  • Renvoie CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN lorsque vous tentez de supprimer tous les emplacements d'une campagne Performance Max Local Services.

Critères de ciblage des informations sur l'audience

Vous pouvez cibler des audiences au niveau du groupe d'annonces à l'aide des critères AudienceInfo sur AdGroupCriterion.audience. Définissez ad_group_criterion.audience.audience sur le nom de ressource de l'objet Audience que vous souhaitez cibler. Pour utiliser les critères AudienceInfo sur un AdGroupCriterion, vous devez définir ad_group.audience_setting.use_audience_grouped = true lors de la création du groupe d'annonces (ce paramètre est immuable après la création). Vous pouvez également définir campaign.audience_setting.use_audience_grouped = true lors de la création de la campagne pour empêcher les exclusions de segments et les exclusions démographiques au niveau de la campagne.

Inspecter MutateAudienceResult

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 :

# Inspect MutateAudienceResult to get audience_id.
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}")

Critères de ciblage linguistique

Vous pouvez cibler des langues de manière positive à l'aide des critères LanguageInfo au niveau de la campagne (CampaignCriterion.language) ou du groupe d'annonces (AdGroupCriterion.language) en définissant language_constant sur un nom de ressource LanguageConstant pouvant être ciblé (au format languageConstants/{criterion_id} ; consultez les codes de langue acceptés). Dans la v24 et les versions ultérieures, toute tentative de cibler une langue non autorisée ou non ciblable renvoie l'erreur CriterionError.CANNOT_TARGET_LANGUAGE.

La compatibilité avec LanguageInfo dépend du type de campagne :

• Types de campagnes compatibles : vous pouvez cibler des langues dans les types de campagnes éligibles, comme les campagnes display, vidéo, Performance Max (au niveau de la campagne ; s'applique aux canaux autres que le Réseau de Recherche), les campagnes pour applications (au niveau de la campagne) et les campagnes Demand Gen (au niveau du groupe d'annonces par défaut ou au niveau de la campagne selon DemandGenCampaignSettings.upgraded_targeting).
• Campagnes sur le Réseau de Recherche (AdvertisingChannelType.SEARCH), AI Max pour les campagnes sur le Réseau de Recherche et annonces Performance Max dans la recherche Google : le ciblage linguistique manuel n'est pas disponible. À la place, les annonces diffusées dans la recherche Google sont automatiquement mises en correspondance avec les utilisateurs en fonction de la langue de vos créations et de vos pages de destination, ainsi que des préférences linguistiques des utilisateurs :
  • Création ou mise à jour de critères : toute tentative de création ou de mise à jour d'un critère LanguageInfo dans une campagne sur le Réseau de Recherche échoue avec une erreur ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT.
  • Interroger et supprimer les anciens critères : les critères CampaignCriterion.language existants des campagnes sur le Réseau de Recherche sont toujours renvoyés dans les réponses aux requêtes, même s'ils ne sont pas utilisés pour la diffusion des annonces. Bien que l'UI Google Ads ne fournisse pas de champ de ciblage linguistique pour les campagnes sur le Réseau de Recherche, vous pouvez supprimer les anciens critères CampaignCriterion.language à l'aide de CampaignCriterionService.