Attention:Vous consultez la documentation de l'interface REST de l'API. La plupart de nos bibliothèques clientes officielles utilisent gRPC. Pour en savoir plus, consultez la présentation de REST.

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

AdGroup

Représentation JSON
AdGroupStatus
AdGroupType
AdGroupAdRotationMode
AudienceSetting
- Représentation JSON

Un groupe d'annonces

Représentation JSON

Représentation JSON
{ "resourceName": string, "status": enum (`AdGroupStatus`), "type": enum (`AdGroupType`), "adRotationMode": enum (`AdGroupAdRotationMode`), "urlCustomParameters": [ { object (`CustomParameter`) } ], "optimizedTargetingEnabled": boolean, "displayCustomBidDimension": enum (`TargetingDimension`), "targetingSetting": { object (`TargetingSetting`) }, "audienceSetting": { object (`AudienceSetting`) }, "effectiveTargetCpaSource": enum (`BiddingSource`), "effectiveTargetRoasSource": enum (`BiddingSource`), "labels": [ string ], "excludedParentAssetFieldTypes": [ enum (`AssetFieldType`) ], "excludedParentAssetSetTypes": [ enum (`AssetSetType`) ], "id": string, "name": string, "baseAdGroup": string, "trackingUrlTemplate": string, "campaign": string, "cpcBidMicros": string, "effectiveCpcBidMicros": string, "cpmBidMicros": string, "targetCpaMicros": string, "cpvBidMicros": string, "targetCpmMicros": string, "targetRoas": number, "percentCpcBidMicros": string, "finalUrlSuffix": string, "effectiveTargetCpaMicros": string, "effectiveTargetRoas": number }

{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "optimizedTargetingEnabled": boolean,
  "displayCustomBidDimension": enum (TargetingDimension),
  "targetingSetting": {
    object (TargetingSetting)
  },
  "audienceSetting": {
    object (AudienceSetting)
  },
  "effectiveTargetCpaSource": enum (BiddingSource),
  "effectiveTargetRoasSource": enum (BiddingSource),
  "labels": [
    string
  ],
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "baseAdGroup": string,
  "trackingUrlTemplate": string,
  "campaign": string,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "cpmBidMicros": string,
  "targetCpaMicros": string,
  "cpvBidMicros": string,
  "targetCpmMicros": string,
  "targetRoas": number,
  "percentCpcBidMicros": string,
  "finalUrlSuffix": string,
  "effectiveTargetCpaMicros": string,
  "effectiveTargetRoas": number
}

Champs
`resourceName`	`string` Immuable. Nom de ressource du groupe d'annonces. Les noms de ressources d'un groupe d'annonces se présentent sous la forme suivante: `customers/{customerId}/adGroups/{adGroupId}`
`status`	`enum (AdGroupStatus)` État du groupe d'annonces.
`type`	`enum (AdGroupType)` Immuable. Type du groupe d'annonces.
`adRotationMode`	`enum (AdGroupAdRotationMode)` Mode de rotation des annonces du groupe d'annonces.
`urlCustomParameters[]`	`object (CustomParameter)` Liste des mises en correspondance utilisées pour remplacer les balises de paramètres personnalisés dans un élément `trackingUrlTemplate`, `finalUrls` ou `mobile_final_urls`.
`optimizedTargetingEnabled`	`boolean` "True" si le ciblage optimisé est activé. Le ciblage optimisé remplace l'élargissement de l'audience.
`displayCustomBidDimension`	`enum (TargetingDimension)` Permet aux annonceurs de spécifier une dimension de ciblage sur laquelle placer des enchères absolues. Cela ne s'applique qu'aux campagnes qui ciblent uniquement le Réseau Display, et non le Réseau de Recherche.
`targetingSetting`	`object (TargetingSetting)` Paramètre des fonctionnalités associées au ciblage.
`audienceSetting`	`object (AudienceSetting)` Immuable. Paramètre des fonctionnalités liées à l'audience.
`effectiveTargetCpaSource`	`enum (BiddingSource)` Uniquement en sortie. Source du CPA cible effectif. Ce champ est en lecture seule.
`effectiveTargetRoasSource`	`enum (BiddingSource)` Uniquement en sortie. Source du ROAS cible effectif. Ce champ est en lecture seule.
`labels[]`	`string` Uniquement en sortie. Noms de ressource des étiquettes associées à ce groupe d'annonces.
`excludedParentAssetFieldTypes[]`	`enum (AssetFieldType)` Types de champs de composants à exclure de ce groupe d'annonces. Ce groupe d'annonces n'héritera pas des associations de composants associées à ces types de champs à partir des niveaux supérieurs.
`excludedParentAssetSetTypes[]`	`enum (AssetSetType)` Types d'ensembles de composants à exclure de ce groupe d'annonces. Ce groupe d'annonces n'héritera pas des associations d'ensembles d'assets de ces types issus des niveaux supérieurs. Les types de groupes d'établissements (GMB_DYNAMIC_LOCATION_GROUP, CHAIN_DYNAMIC_LOCATION_GROUP et STATIC_LOCATION_GROUP) sont des types enfants de LOCATION_SYNC. Par conséquent, si LOCATION_SYNC est défini dans ce champ, aucun ensemble de composants de groupe de zones géographiques ne peut être associé à ce groupe d'annonces, et aucune extension de lieu (LE) ni aucune extension de lieu affilié (ALE) ne seront pas diffusées dans ce groupe d'annonces. Seul LOCATION_SYNC est actuellement pris en charge.
`id`	`string (int64 format)` Uniquement en sortie. Identifiant du groupe d'annonces.
`name`	`string` Nom du groupe d'annonces. Ce champ est obligatoire. Il ne doit pas être vide lors de la création de groupes d'annonces. Il doit contenir moins de 255 caractères UTF-8 en pleine largeur. Il ne doit contenir aucun caractère nul (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD).
`baseAdGroup`	`string` Uniquement en sortie. Pour les groupes d'annonces brouillons ou tests, ce champ correspond au nom de ressource du groupe d'annonces de base à partir duquel ce groupe d'annonces a été créé. Si un groupe d'annonces brouillon ou test n'a pas de groupe d'annonces de base, ce champ est nul. Pour les groupes d'annonces de base, ce champ correspond au nom de ressource du groupe d'annonces. Ce champ est en lecture seule.
`trackingUrlTemplate`	`string` Modèle d'URL permettant de créer une URL de suivi.
`campaign`	`string` Immuable. Campagne à laquelle appartient le groupe d'annonces.
`cpcBidMicros`	`string (int64 format)` Enchère au CPC (coût par clic) maximal.
`effectiveCpcBidMicros`	`string (int64 format)` Uniquement en sortie. La valeur est identique à celle de l'enchère au CPC (coût par clic) si la stratégie d'enchères correspond à une stratégie d'enchères : cpc manuel, CPC optimisé, page 1 promue ou taux de surclassement cible. Sinon, la valeur est nulle.
`cpmBidMicros`	`string (int64 format)` Enchère au CPM (coût pour mille impressions visibles) maximale.
`targetCpaMicros`	`string (int64 format)` Le CPA (coût par acquisition) cible. Si la stratégie d'enchères du groupe d'annonces pour la campagne est "CiblageCpa" ou "Maximiser les conversions" (avec le champ "CPA cible" défini), ce champ remplace le CPA cible spécifié dans la stratégie d'enchères de la campagne. Sinon, cette valeur est ignorée.
`cpvBidMicros`	`string (int64 format)` Enchère au CPV (coût par vue).
`targetCpmMicros`	`string (int64 format)` Montant moyen (en micro-unités) que l'annonceur est prêt à payer pour mille diffusions de son annonce.
`targetRoas`	`number` Remplacement du ROAS (retour sur les dépenses publicitaires) cible. Si la stratégie d'enchères du groupe d'annonces de la campagne est "TargetRoas" ou "MaximiserConversionValue" (avec le champ "targetRoas" défini), ce champ remplace le ROAS cible spécifié dans la stratégie d'enchères de la campagne. Sinon, cette valeur est ignorée.
`percentCpcBidMicros`	`string (int64 format)` Montant de l'enchère au CPC (en %), exprimé sous la forme d'une 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].
`finalUrlSuffix`	`string` Modèle d'URL pour ajouter des paramètres à l'URL finale
`effectiveTargetCpaMicros`	`string (int64 format)` Uniquement en sortie. Le CPA (coût par acquisition) cible effectif. Ce champ est en lecture seule.
`effectiveTargetRoas`	`number` Uniquement en sortie. ROAS cible effectif (retour sur les dépenses publicitaires). Ce champ est en lecture seule.

AdGroupStatus

Les différents états possibles d'un groupe d'annonces.

Enums
`UNSPECIFIED`	L'état n'a pas été spécifié.
`UNKNOWN`	La valeur reçue n'est pas connue dans cette version. Cette valeur ne peut être fournie qu'à partir d'une réponse.
`ENABLED`	Le groupe d'annonces est activé.
`PAUSED`	Le groupe d'annonces est mis en veille.
`REMOVED`	Le groupe d'annonces est supprimé.

AdGroupType

Énumération répertoriant les types possibles d'un groupe d'annonces.

Enums
`UNSPECIFIED`	Le type n'a pas été spécifié.
`UNKNOWN`	La valeur reçue n'est pas connue dans cette version. Cette valeur ne peut être fournie qu'à partir d'une réponse.
`SEARCH_STANDARD`	Type de groupe d'annonces par défaut pour les campagnes sur le Réseau de Recherche.
`DISPLAY_STANDARD`	Il s'agit du type de groupe d'annonces par défaut pour les campagnes display.
`SHOPPING_PRODUCT_ADS`	Type de groupe d'annonces pour les campagnes Shopping diffusant des annonces produit standards.
`HOTEL_ADS`	Il s'agit du type de groupe d'annonces par défaut pour les campagnes d'hôtel.
`SHOPPING_SMART_ADS`	Type des groupes d'annonces dans les campagnes Shopping intelligentes.
`VIDEO_BUMPER`	Annonces vidéo InStream non désactivables courtes.
`VIDEO_TRUE_VIEW_IN_STREAM`	Annonces vidéo InStream TrueView (désactivables).
`VIDEO_TRUE_VIEW_IN_DISPLAY`	Annonces vidéo TrueView InDisplay
`VIDEO_NON_SKIPPABLE_IN_STREAM`	Les annonces vidéo InStream non désactivables.
`VIDEO_OUTSTREAM`	Annonces vidéo OutStream.
`SEARCH_DYNAMIC_ADS`	Type de groupe d'annonces pour les groupes d'annonces dynamiques du Réseau de Recherche.
`SHOPPING_COMPARISON_LISTING_ADS`	Type des groupes d'annonces dans les campagnes de type "Fiche du service de comparateur de prix".
`PROMOTED_HOTEL_ADS`	Type de groupe d'annonces pour les groupes d'annonces "Hôtels sponsorisés".
`VIDEO_RESPONSIVE`	Groupes d'annonces vidéo responsives.
`VIDEO_EFFICIENT_REACH`	Groupes d'annonces vidéo axées sur la couverture efficace.
`SMART_CAMPAIGN_ADS`	Type de groupe d'annonces pour les campagnes intelligentes.
`TRAVEL_ADS`	Type de groupe d'annonces pour les campagnes de voyage.

AdGroupAdRotationMode

Modes de rotation des annonces possibles au sein d'un groupe d'annonces.

Enums
`UNSPECIFIED`	Le mode de rotation des annonces n'a pas été spécifié.
`UNKNOWN`	La valeur reçue n'est pas connue dans cette version. Cette valeur ne peut être fournie qu'à partir d'une réponse.
`OPTIMIZE`	Optimisez les annonces du groupe d'annonces en fonction des clics ou des conversions.
`ROTATE_FOREVER`	Alterner de manière régulière et indéfiniment

AudienceSetting

Paramètres du ciblage d'audience.

Représentation JSON
{ "useAudienceGrouped": boolean }

Champs

Champs
`useAudienceGrouped`	`boolean` Immuable. Si la valeur est "true", ce groupe d'annonces utilise une ressource d'audience pour le ciblage d'audience. Si la valeur est "false", ce groupe d'annonces peut utiliser des critères de segment d'audience à la place.

useAudienceGrouped

boolean

Immuable. Si la valeur est "true", ce groupe d'annonces utilise une ressource d'audience pour le ciblage d'audience. Si la valeur est "false", ce groupe d'annonces peut utiliser des critères de segment d'audience à la place.