AdGroupCriterion

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

Représentation JSON 
{
  "resourceName": string,
  "displayName": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "systemServingStatus": enum (CriterionSystemServingStatus),
  "approvalStatus": enum (AdGroupCriterionApprovalStatus),
  "disapprovalReasons": [
    string
  ],
  "labels": [
    string
  ],
  "effectiveCpcBidSource": enum (BiddingSource),
  "effectiveCpmBidSource": enum (BiddingSource),
  "effectiveCpvBidSource": enum (BiddingSource),
  "effectivePercentCpcBidSource": enum (BiddingSource),
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "cpmBidMicros": string,
  "cpvBidMicros": string,
  "percentCpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "effectiveCpmBidMicros": string,
  "effectiveCpvBidMicros": string,
  "effectivePercentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "placement": {
    object (PlacementInfo)
  },
  "mobileAppCategory": {
    object (MobileAppCategoryInfo)
  },
  "mobileApplication": {
    object (MobileApplicationInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "incomeRange": {
    object (IncomeRangeInfo)
  },
  "parentalStatus": {
    object (ParentalStatusInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "youtubeVideo": {
    object (YouTubeVideoInfo)
  },
  "youtubeChannel": {
    object (YouTubeChannelInfo)
  },
  "topic": {
    object (TopicInfo)
  },
  "userInterest": {
    object (UserInterestInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "appPaymentModel": {
    object (AppPaymentModelInfo)
  },
  "customAffinity": {
    object (CustomAffinityInfo)
  },
  "customIntent": {
    object (CustomIntentInfo)
  },
  "customAudience": {
    object (CustomAudienceInfo)
  },
  "combinedAudience": {
    object (CombinedAudienceInfo)
  },
  "audience": {
    object (AudienceInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "language": {
    object (LanguageInfo)
  }
  // End of list of possible types for union field criterion.
}
Champs
resourceName

string

Immuable. Nom de ressource du critère du groupe d'annonces. Les noms de ressources des critères du groupe d'annonces ont le format suivant:

customers/{customerId}/adGroupCriteria/{adGroupId}~{criterionId}
displayName

string

Uniquement en sortie. Le nom à afficher du critère.

Ce champ est ignoré pour les objets mutate.
status

enum (AdGroupCriterionStatus)

É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é.
qualityInfo

object (QualityInfo)

Uniquement en sortie. Informations concernant la qualité du critère.
type

enum (CriterionType)

Uniquement en sortie. Type du critère.
systemServingStatus

enum (CriterionSystemServingStatus)

Uniquement en sortie. État de diffusion du critère.
approvalStatus

enum (AdGroupCriterionApprovalStatus)

Uniquement en sortie. État d'approbation du critère.
disapprovalReasons[]

string

Uniquement en sortie. Liste des motifs de refus du critère.

Les différents motifs de refus d'un critère sont disponibles à l'adresse suivante: https://support.google.com/adspolicy/answer/6008942.

Ce champ est en lecture seule.
labels[]

string

Uniquement en sortie. Noms de ressource des étiquettes associées à ce critère de groupe d'annonces.
effectiveCpcBidSource

enum (BiddingSource)

Uniquement en sortie. Source de l'enchère au CPC effective.
effectiveCpmBidSource

enum (BiddingSource)

Uniquement en sortie. Source de l'enchère au CPM effectif.
effectiveCpvBidSource

enum (BiddingSource)

Uniquement en sortie. Source de l'enchère au CPV effectif.
effectivePercentCpcBidSource

enum (BiddingSource)

Uniquement en sortie. Source de l'enchère au CPC en pourcentage effective.
positionEstimates

object (PositionEstimates)

Uniquement en sortie. Estimations des enchères associées au critère à différentes positions.
finalUrls[]

string

Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce.
finalMobileUrls[]

string

Liste des URL finales pour mobile possibles après toutes les redirections vers un autre domaine.
urlCustomParameters[]

object (CustomParameter)

Liste des mappages utilisés pour remplacer les balises de paramètres personnalisés dans trackingUrlTemplate, finalUrls ou mobile_final_urls.
criterionId

string (int64 format)

Uniquement en sortie. ID du critère.

Ce champ est ignoré pour les objets mutate.
adGroup

string

Immuable. Groupe d'annonces auquel appartient le critère.
negative

boolean

Immuable. Permet de spécifier si le critère doit être ciblé (false) ou exclu (true).

Ce champ est immuable. Pour transformer un critère positif en critère négatif, supprimez-le, puis ajoutez-le à nouveau.
bidModifier

number

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.
cpcBidMicros

string (int64 format)

Enchère au CPC (coût par clic).
cpmBidMicros

string (int64 format)

L'enchère au CPM (coût pour mille impressions visibles).
cpvBidMicros

string (int64 format)

Il s'agit de l'enchère au CPV (coût par vue).
percentCpcBidMicros

string (int64 format)

Montant de l'enchère au CPC, exprimé en tant que fraction du prix annoncé pour un bien ou un service. La plage valide pour la fraction est [0,1) et la valeur stockée ici est 1 000 000 * [fraction].
effectiveCpcBidMicros

string (int64 format)

Uniquement en sortie. L'enchère au CPC (coût par clic) effective.
effectiveCpmBidMicros

string (int64 format)

Uniquement en sortie. Enchère au CPM effectif (coût pour mille impressions visibles).
effectiveCpvBidMicros

string (int64 format)

Uniquement en sortie. Enchère au CPV (coût par vue) effectif.
effectivePercentCpcBidMicros

string (int64 format)

Uniquement en sortie. Montant effectif de l'enchère au CPC en pourcentage.
finalUrlSuffix

string

Modèle d'URL permettant d'ajouter des paramètres à l'URL finale.
trackingUrlTemplate

string

Modèle d'URL permettant de créer une URL de suivi.

Champ d'union criterion. Critère du groupe d'annonces.

Vous ne devez en définir qu'un. criterion ne peut être qu'un des éléments suivants :
keyword

object (KeywordInfo)

Immuable. Mot clé.
placement

object (PlacementInfo)

Immuable. Emplacement.
mobileAppCategory

object (MobileAppCategoryInfo)

Immuable. Catégorie d'application mobile.
mobileApplication

object (MobileApplicationInfo)

Immuable. Application mobile.
listingGroup

object (ListingGroupInfo)

Immuable. Groupe de fiches.
ageRange

object (AgeRangeInfo)

Immuable. Tranche d'âge.
gender

object (GenderInfo)

Immuable. Gender.
incomeRange

object (IncomeRangeInfo)

Immuable. Plage de revenus.
parentalStatus

object (ParentalStatusInfo)

Immuable. Statut parental.
userList

object (UserListInfo)

Immuable. Liste d'utilisateurs.
youtubeVideo

object (YouTubeVideoInfo)

Immuable. Vidéo YouTube.
youtubeChannel

object (YouTubeChannelInfo)

Immuable. Chaîne YouTube.
topic

object (TopicInfo)

Immuable. Sujet.
userInterest

object (UserInterestInfo)

Immuable. Centres d'intérêt des utilisateurs.
webpage

object (WebpageInfo)

Immuable. Page Web
appPaymentModel

object (AppPaymentModelInfo)

Immuable. Modèle de paiement de l'application.
customAffinity

object (CustomAffinityInfo)

Immuable. Audience d'affinité personnalisée.
customIntent

object (CustomIntentInfo)

Immuable. Intention personnalisée.
customAudience

object (CustomAudienceInfo)

Immuable. Audience personnalisée.
combinedAudience

object (CombinedAudienceInfo)

Immuable. Audience combinée.
audience

object (AudienceInfo)

Immuable. Audience.
location

object (LocationInfo)

Immuable. Localisation.
language

object (LanguageInfo)

Immuable. HashiCorp.

AdGroupCriterionStatus

Les statuts possibles d'un critère de recherche.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN

La valeur reçue n'est pas connue dans cette version.

Il s'agit d'une valeur de réponse uniquement.
ENABLED Le critère du groupe d'annonces est activé.
PAUSED Le critère du groupe d'annonces a été mis en veille.
REMOVED Le critère du groupe d'annonces est supprimé.

QualityInfo

Conteneur des informations sur la qualité du critère de groupe d'annonces.

Représentation JSON 
{
  "creativeQualityScore": enum (QualityScoreBucket),
  "postClickQualityScore": enum (QualityScoreBucket),
  "searchPredictedCtr": enum (QualityScoreBucket),
  "qualityScore": integer
}
Champs
creativeQualityScore

enum (QualityScoreBucket)

Uniquement en sortie. Performances de l'annonce comparées à celles d'autres annonceurs.
postClickQualityScore

enum (QualityScoreBucket)

Uniquement en sortie. Niveau de qualité de la page de destination.
searchPredictedCtr

enum (QualityScoreBucket)

Uniquement en sortie. Taux de clics par rapport à celui des autres annonceurs.
qualityScore

integer

Uniquement en sortie. Le niveau de qualité.

Ce champ peut ne pas être renseigné si Google ne dispose pas d'informations suffisantes pour déterminer une valeur.

CriterionSystemServingStatus

Énumère les états de diffusion du système pour le critère.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
ELIGIBLE Éligible.
RARELY_SERVED Volume de recherche faible

AdGroupCriterionApprovalStatus

Énumère les statuts d'approbation de INPUT.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
APPROVED Approuvé.
DISAPPROVED Refusé.
PENDING_REVIEW En attente d'examen.
UNDER_REVIEW En cours d'examen.

PositionEstimates

Estimations des enchères associées au critère à différentes positions.

Représentation JSON 
{
  "firstPageCpcMicros": string,
  "firstPositionCpcMicros": string,
  "topOfPageCpcMicros": string,
  "estimatedAddClicksAtFirstPositionCpc": string,
  "estimatedAddCostAtFirstPositionCpc": string
}
Champs
firstPageCpcMicros

string (int64 format)

Uniquement en sortie. Estimation de l'enchère au CPC nécessaire pour que votre annonce soit diffusée sur la première page des résultats de recherche.
firstPositionCpcMicros

string (int64 format)

Uniquement en sortie. Estimation de l'enchère au CPC nécessaire pour que votre annonce soit diffusée en première position, en haut de la première page des résultats de recherche.
topOfPageCpcMicros

string (int64 format)

Uniquement en sortie. Estimation de l'enchère au CPC nécessaire pour que l'annonce soit diffusée en haut de la première page des résultats de recherche.
estimatedAddClicksAtFirstPositionCpc

string (int64 format)

Uniquement en sortie. Estimation du nombre de clics que vous pourriez obtenir par semaine en remplaçant votre enchère de mot clé par la valeur firstPositionCpcMicros.
estimatedAddCostAtFirstPositionCpc

string (int64 format)

Uniquement en sortie. Estimation de l'évolution de votre coût par semaine si vous remplacez votre enchère de mot clé par la valeur de firstPositionCpcMicros.

ListingGroupInfo

Critère de groupe de fiches.

Représentation JSON 
{
  "type": enum (ListingGroupType),
  "caseValue": {
    object (ListingDimensionInfo)
  },
  "parentAdGroupCriterion": string,
  "path": {
    object (ListingDimensionPath)
  }
}
Champs
type

enum (ListingGroupType)

Type du groupe de fiches.
caseValue

object (ListingDimensionInfo)

Valeur de la dimension avec laquelle ce groupe de fiches affine son parent. Non défini pour le groupe racine.
parentAdGroupCriterion

string

Nom de ressource du critère de groupe d'annonces qui est la subdivision du groupe de fiches parent. Null pour le groupe racine.
path

object (ListingDimensionPath)

Chemin des dimensions définissant ce groupe de fiches.

ListingGroupType

Type du groupe de fiches.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SUBDIVISION Subdivision des produits avec une dimension de fiche. Ces nœuds ne sont pas utilisés pour la diffusion pour cibler des entrées de liste, mais servent uniquement à définir la structure de l'arborescence.
UNIT Unité de groupe de fiches qui définit une enchère.

ListingDimensionPath

Chemin des dimensions définissant un groupe de fiches.

Représentation JSON 
{
  "dimensions": [
    {
      object (ListingDimensionInfo)
    }
  ]
}
Champs
dimensions[]

object (ListingDimensionInfo)

Chemin complet des dimensions via la hiérarchie du groupe de fiches, de la racine (à l'exception de la racine elle-même) à ce groupe de fiches.

AppPaymentModelInfo

Critère du modèle de paiement de l'application.

Représentation JSON 
{
  "type": enum (AppPaymentModelType)
}
Champs
type

enum (AppPaymentModelType)

Type de modèle de paiement de l'application.

AppPaymentModelType

Énumération décrivant les modèles de paiement d'applications possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
PAID Représente les applications payantes.

CustomIntentInfo

Critère d'intention personnalisé. Un critère de ce type peut uniquement être ciblé.

Représentation JSON 
{
  "customIntent": string
}
Champs
customIntent

string

Nom de la ressource CustomInterest.