La nouvelle API Search Ads 360 Reporting est désormais disponible. Rejoignez le groupe Google searchads-api-announcements pour vous tenir informé des améliorations et versions à venir.

Cette page a été traduite par l'API Cloud Translation.

critère_groupe_annonces

Critère de groupe d'annonces Le rapport ad_group_criterion ne renvoie que les critères qui ont été explicitement ajoutés au groupe d'annonces.

Ressources attribuées
ad_group
campaign
clientèle
user_list

Les champs des ressources ci-dessus peuvent être sélectionnés avec cette ressource dans vos clauses SELECT et WHERE. Ces champs ne segmenteront pas les métriques de votre clause SELECT.

ad_group_criterion.ad_group
Description du champ	Groupe d'annonces auquel le critère appartient.
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Faux

ad_group_criterion.age_range.type
Description du champ	Type de tranche d'âge.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM AGE_RANGE_18_24 AGE_RANGE_25_34 AGE_RANGE_35_44 AGE_RANGE_45_54 AGE_RANGE_55_64 AGE_RANGE_65_UP AGE_RANGE_UNDETERMINED UNKNOWN UNSPECIFIED`
Saisissez l'URL.	`google.ads.searchads360.v0.enums.AgeRangeTypeEnum.AgeRangeType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.bid_modifier
Description du champ	Modificateur de l'enchère lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. La plupart des types de critères pouvant être ciblés sont compatibles avec les modificateurs.
Catégorie	`ATTRIBUTE`
Type de données	`DOUBLE`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.cpc_bid_micros
Description du champ	Enchère au CPC (coût par clic).
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.creation_time
Description du champ	Horodatage au moment de la création de ce critère de groupe d'annonces. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.criterion_id
Description du champ	ID du critère.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.effective_cpc_bid_micros
Description du champ	L'enchère au CPC (coût par clic) effective.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.effective_labels
Description du champ	Noms de ressource des étiquettes effectives associées à ce critère de groupe d'annonces. Un libellé efficace est un libellé hérité ou directement attribué à ce critère de groupe d'annonces.
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

ad_group_criterion.engine_id
Description du champ	ID du critère de groupe d'annonces dans le compte de moteur externe. Ce champ ne concerne que les comptes autres que Google Ads (par exemple, Yahoo! Japan, Microsoft, Baidu, etc.). Pour une entité Google Ads, utilisez plutôt "ad_group_criterion.criterion_id".
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.engine_status
Description du champ	État du moteur pour le critère de groupe d'annonces.
Catégorie	`ATTRIBUTE`
Type de données	ENUM AD_GROUP_CRITERION_ACCOUNT_PAUSED AD_GROUP_CRITERION_APPROVED AD_GROUP_CRITERION_DISAPPROVED AD_GROUP_CRITERION_ELIGIBLE AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH AD_GROUP_CRITERION_INVALID_PC_SEARCH AD_GROUP_CRITERION_INVALID_SEARCH AD_GROUP_CRITERION_LOW_SEARCH_VOLUME AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW AD_GROUP_CRITERION_NOT_REVIEWED AD_GROUP_CRITERION_ON_HOLD AD_GROUP_CRITERION_PARTIALLY_INVALID AD_GROUP_CRITERION_PAUSED AD_GROUP_CRITERION_PENDING_REVIEW AD_GROUP_CRITERION_REMOVED AD_GROUP_CRITERION_SERVING AD_GROUP_CRITERION_TO_BE_ACTIVATED AD_GROUP_CRITERION_UNDER_REVIEW UNKNOWN UNSPECIFIED
Saisissez l'URL.	`google.ads.searchads360.v0.enums.AdGroupCriterionEngineStatusEnum.AdGroupCriterionEngineStatus`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.final_url_suffix
Description du champ	Modèle d'URL permettant d'ajouter des paramètres à l'URL finale.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.final_urls
Description du champ	Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

ad_group_criterion.gender.type
Description du champ	Type de genre.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM FEMALE MALE UNDETERMINED UNKNOWN UNSPECIFIED`
Saisissez l'URL.	`google.ads.searchads360.v0.enums.GenderTypeEnum.GenderType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.keyword.match_type
Description du champ	Type de correspondance du mot clé.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM BROAD EXACT PHRASE UNKNOWN UNSPECIFIED`
Saisissez l'URL.	`google.ads.searchads360.v0.enums.KeywordMatchTypeEnum.KeywordMatchType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.keyword.text
Description du champ	Texte du mot clé (au maximum 80 caractères et 10 mots).
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.labels
Description du champ	Noms de ressource des étiquettes associées à ce critère de groupe d'annonces.
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

ad_group_criterion.last_modified_time
Description du champ	Date et heure de la dernière modification de ce critère de groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".
Catégorie	`ATTRIBUTE`
Type de données	`DATE`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.listing_group.type
Description du champ	Type du groupe de fiches.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM SUBDIVISION UNIT UNKNOWN UNSPECIFIED`
Saisissez l'URL.	`google.ads.searchads360.v0.enums.ListingGroupTypeEnum.ListingGroupType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.location.geo_target_constant
Description du champ	Nom de la ressource constante de ciblage géographique.
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Faux

ad_group_criterion.negative
Description du champ	Indique si le critère doit être ciblé (`false`) ou exclu (`true`). Ce champ est immuable. Pour remplacer un critère positif par un critère négatif, supprimez-le, puis ajoutez-le à nouveau.
Catégorie	`ATTRIBUTE`
Type de données	`BOOLEAN`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.position_estimates.top_of_page_cpc_micros
Description du champ	Estimation de l'enchère au CPC requise pour que l'annonce soit diffusée en haut de la première page des résultats de recherche.
Catégorie	`ATTRIBUTE`
Type de données	`INT64`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.quality_info.quality_score
Description du champ	Le niveau de qualité. Ce champ peut ne pas être renseigné si Google ne dispose pas d'informations suffisantes pour déterminer une valeur.
Catégorie	`ATTRIBUTE`
Type de données	`INT32`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.resource_name
Description du champ	Nom de ressource du critère du groupe d'annonces. Les noms de ressources des critères de groupe d'annonces se présentent sous la forme: `customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}`.
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Faux

ad_group_criterion.status
Description du champ	État du critère. Il s'agit de l'état de l'entité de critère du groupe d'annonces définie par le client. Remarque : Les rapports de l'interface utilisateur peuvent intégrer des informations supplémentaires qui déterminent si un critère peut être exécuté. Dans certains cas, un critère supprimé dans l'API peut encore apparaître comme activé dans l'interface utilisateur. Par exemple, les campagnes par défaut sont diffusées auprès des utilisateurs de toutes les tranches d'âge, sauf si elles sont exclues. Du fait qu'elle peut voir les annonces, l'interface utilisateur affiche chaque tranche d'âge comme étant activée, mais l'état AdGroupCriterion.status indique "supprimée", car aucun critère positif n'a été ajouté.
Catégorie	`ATTRIBUTE`
Type de données	`ENUM ENABLED PAUSED REMOVED UNKNOWN UNSPECIFIED`
Saisissez l'URL.	`google.ads.searchads360.v0.enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.tracking_url_template
Description du champ	Modèle d'URL permettant de créer une URL de suivi.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.type
Description du champ	Type du critère.
Catégorie	`ATTRIBUTE`
Type de données	ENUM AD_SCHEDULE AGE_RANGE APP_PAYMENT_MODEL AUDIENCE BRAND BRAND_LIST CARRIER COMBINED_AUDIENCE CONTENT_LABEL CUSTOM_AFFINITY CUSTOM_AUDIENCE CUSTOM_INTENT DEVICE GENDER INCOME_RANGE IP_BLOCK KEYWORD KEYWORD_THEME LANGUAGE LIFE_EVENT LISTING_GROUP LISTING_SCOPE LOCAL_SERVICE_ID LOCATION LOCATION_GROUP MOBILE_APPLICATION MOBILE_APP_CATEGORY MOBILE_DEVICE OPERATING_SYSTEM_VERSION PARENTAL_STATUS PLACEMENT PROXIMITY TOPIC UNKNOWN UNSPECIFIED USER_INTEREST USER_LIST WEBPAGE YOUTUBE_CHANNEL YOUTUBE_VIDEO
Saisissez l'URL.	`google.ads.searchads360.v0.enums.CriterionTypeEnum.CriterionType`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.user_list.user_list
Description du champ	Nom de laressource de la liste d'utilisateurs.
Catégorie	`ATTRIBUTE`
Type de données	`RESOURCE_NAME`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Faux
Répété	Faux

ad_group_criterion.webpage.conditions
Description du champ	Conditions ou expressions logiques pour le ciblage de pages Web. La liste des conditions de ciblage des pages Web est combinée lorsqu'elle est évaluée lors du ciblage. Une liste de conditions vide indique que toutes les pages du site Web de la campagne sont ciblées. Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.
Catégorie	`ATTRIBUTE`
Type de données	`MESSAGE`
Saisissez l'URL.	`google.ads.searchads360.v0.common.WebpageConditionInfo`
Filtrable	Faux
Sélectionnable	Vrai
Sortable	Faux
Répété	Vrai

ad_group_criterion.webpage.coverage_percentage
Description du champ	Pourcentage de couverture des critères de site Web. Il s'agit du pourcentage calculé de couverture de site Web en fonction de la cible de site Web, de la cible de site Web à exclure et des mots clés à exclure dans le groupe d'annonces et la campagne. Par exemple, lorsque la couverture est égale à 1, la couverture est de 100 %. Ce champ est en lecture seule.
Catégorie	`ATTRIBUTE`
Type de données	`DOUBLE`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

ad_group_criterion.webpage.criterion_name
Description du champ	Nom du critère défini par ce paramètre. La valeur du nom sera utilisée pour identifier, trier et filtrer les critères avec ce type de paramètres. Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.
Catégorie	`ATTRIBUTE`
Type de données	`STRING`
Saisissez l'URL.	`N/A`
Filtrable	Vrai
Sélectionnable	Vrai
Sortable	Vrai
Répété	Faux

critère_groupe_annonces

ad_group_criterion.ad_group

ad_group_criterion.age_range.type

ad_group_criterion.bid_modifier

ad_group_criterion.cpc_bid_micros

ad_group_criterion.creation_time

ad_group_criterion.criterion_id

ad_group_criterion.effective_cpc_bid_micros

ad_group_criterion.effective_labels

ad_group_criterion.engine_id

ad_group_criterion.engine_status

ad_group_criterion.final_url_suffix

ad_group_criterion.final_urls

ad_group_criterion.gender.type

ad_group_criterion.keyword.match_type

ad_group_criterion.keyword.text

ad_group_criterion.labels

ad_group_criterion.last_modified_time

ad_group_criterion.listing_group.type

ad_group_criterion.location.geo_target_constant

ad_group_criterion.negative

ad_group_criterion.position_estimates.top_of_page_cpc_micros

ad_group_criterion.quality_info.quality_score

ad_group_criterion.resource_name

ad_group_criterion.status

ad_group_criterion.tracking_url_template

ad_group_criterion.type

ad_group_criterion.user_list.user_list

ad_group_criterion.webpage.conditions

ad_group_criterion.webpage.coverage_percentage

ad_group_criterion.webpage.criterion_name