Campaign

Une campagne.

Représentation JSON
{
  "resourceName": string,
  "primaryStatus": enum (CampaignPrimaryStatus),
  "primaryStatusReasons": [
    enum (CampaignPrimaryStatusReason)
  ],
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "localServicesCampaignSettings": {
    object (LocalServicesCampaignSettings)
  },
  "travelCampaignSettings": {
    object (TravelCampaignSettings)
  },
  "demandGenCampaignSettings": {
    object (DemandGenCampaignSettings)
  },
  "videoCampaignSettings": {
    object (VideoCampaignSettings)
  },
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "hotelSetting": {
    object (HotelSettingInfo)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "targetingSetting": {
    object (TargetingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "localCampaignSetting": {
    object (LocalCampaignSetting)
  },
  "appCampaignSetting": {
    object (AppCampaignSetting)
  },
  "labels": [
    string
  ],
  "experimentType": enum (CampaignExperimentType),
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "videoBrandSafetySuitability": enum (BrandSafetySuitability),
  "vanityPharma": {
    object (VanityPharma)
  },
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "paymentMode": enum (PaymentMode),
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "excludedParentAssetSetTypes": [
    enum (AssetSetType)
  ],
  "performanceMaxUpgrade": {
    object (PerformanceMaxUpgrade)
  },
  "assetAutomationSettings": [
    {
      object (AssetAutomationSetting)
    }
  ],
  "keywordMatchType": enum (CampaignKeywordMatchType),
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "audienceSetting": {
    object (AudienceSetting)
  },
  "baseCampaign": string,
  "campaignBudget": string,
  "startDate": string,
  "campaignGroup": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "optimizationScore": number,
  "urlExpansionOptOut": boolean,
  "hotelPropertyAssetSet": string,
  "listingType": enum (ListingType),

  // Union field campaign_bidding_strategy can be only one of the following:
  "biddingStrategy": string,
  "commission": {
    object (Commission)
  },
  "manualCpa": {
    object (ManualCpa)
  },
  "manualCpc": {
    object (ManualCpc)
  },
  "manualCpm": {
    object (ManualCpm)
  },
  "manualCpv": {
    object (ManualCpv)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  },
  "percentCpc": {
    object (PercentCpc)
  },
  "targetCpm": {
    object (TargetCpm)
  },
  "fixedCpm": {
    object (FixedCpm)
  },
  "targetCpv": {
    object (TargetCpv)
  }
  // End of list of possible types for union field campaign_bidding_strategy.
}
Champs
resourceName

string

Immuable. Nom de ressource de la campagne. Les noms de ressources de campagne se présentent comme suit:

customers/{customerId}/campaigns/{campaignId}

primaryStatus

enum (CampaignPrimaryStatus)

Uniquement en sortie. État principal de la campagne.

Il fournit des insights sur les raisons pour lesquelles une campagne n'est pas diffusée ou n'est pas optimale. Les modifications apportées à la campagne et à ses entités associées peuvent mettre un certain temps à apparaître dans cet état.

primaryStatusReasons[]

enum (CampaignPrimaryStatusReason)

Uniquement en sortie. Principaux motifs d'état de la campagne.

Il fournit des insights sur les raisons pour lesquelles une campagne n'est pas diffusée ou n'est pas optimale. Ces motifs sont regroupés afin de déterminer un CampaignPrimaryStatus global.

status

enum (CampaignStatus)

État de la campagne.

Lorsqu'une campagne est ajoutée, l'état par défaut est ACTIVÉ.

servingStatus

enum (CampaignServingStatus)

Uniquement en sortie. État de diffusion des annonces de la campagne.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

Uniquement en sortie. État système de la stratégie d'enchères de la campagne.

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

État d'optimisation de la diffusion des annonces de la campagne.

advertisingChannelType

enum (AdvertisingChannelType)

Immuable. Cible de diffusion principale pour les annonces de la campagne. Vous pouvez affiner les options de ciblage dans networkSettings.

Ce champ est obligatoire. Il doit être renseigné lors de la création de campagnes.

Ne peut être défini que lors de la création de campagnes. Une fois la campagne créée, le champ ne peut plus être modifié.

advertisingChannelSubType

enum (AdvertisingChannelSubType)

Immuable. Affinement facultatif pour advertisingChannelType. Doit être un sous-type valide du type de canal parent.

Ne peut être défini que lors de la création de campagnes. Une fois la campagne créée, le champ ne peut plus être modifié.

urlCustomParameters[]

object (CustomParameter)

Liste des mappages utilisés pour remplacer les tags de paramètres personnalisés dans un élément trackingUrlTemplate, finalUrls ou mobile_final_urls.

localServicesCampaignSettings

object (LocalServicesCampaignSettings)

Paramètres associés à la campagne Local Services.

travelCampaignSettings

object (TravelCampaignSettings)

Paramètres de la campagne de voyage.

demandGenCampaignSettings

object (DemandGenCampaignSettings)

Paramètres de la campagne de génération de la demande.

videoCampaignSettings

object (VideoCampaignSettings)

Paramètres de la campagne vidéo.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

Paramètres des enchères en temps réel (fonctionnalité disponible uniquement pour les campagnes ciblant le réseau Ad Exchange).

networkSettings

object (NetworkSettings)

Paramètres des réseaux de la campagne.

hotelSetting

object (HotelSettingInfo)

Immuable. Paramètre d'hôtel pour la campagne.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Paramètre permettant de contrôler les annonces dynamiques du Réseau de Recherche (ADR).

shoppingSetting

object (ShoppingSetting)

Paramètre permettant de contrôler les campagnes Shopping.

targetingSetting

object (TargetingSetting)

Paramètre de ciblage des fonctionnalités associées.

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Paramètre de ciblage géographique des annonces.

localCampaignSetting

object (LocalCampaignSetting)

Paramètre de la campagne locale.

appCampaignSetting

object (AppCampaignSetting)

Paramètre lié à la campagne pour applications.

labels[]

string

Uniquement en sortie. Noms de ressource des étiquettes associées à cette campagne.

experimentType

enum (CampaignExperimentType)

Uniquement en sortie. Type de campagne: normale, brouillon ou test.

biddingStrategyType

enum (BiddingStrategyType)

Uniquement en sortie. Type de stratégie d'enchères.

Pour créer une stratégie d'enchères, vous pouvez définir soit le schéma d'enchères pour créer une stratégie d'enchères standard, soit le champ biddingStrategy pour créer une stratégie de portefeuille d'enchères.

Ce champ est en lecture seule.

accessibleBiddingStrategy

string

Uniquement en sortie. Nom de ressource de AccessibleBiddingStrategy, une vue en lecture seule des attributs non restreints de la stratégie de portefeuille d'enchères associée identifiée par "biddingStrategy". Vide si la campagne n'utilise pas de stratégie de portefeuille. Les attributs de stratégie sans restriction sont disponibles pour tous les clients avec lesquels la stratégie est partagée et sont lus à partir de la ressource AccessibleBiddingStrategy. En revanche, les attributs restreints ne sont disponibles que pour le client propriétaire de la stratégie et ses responsables. Les attributs restreints ne peuvent être lus qu'à partir de la ressource BiddingStrategy.

frequencyCaps[]

object (FrequencyCapEntry)

Liste qui limite la fréquence à laquelle chaque utilisateur verra les annonces de cette campagne.

videoBrandSafetySuitability

enum (BrandSafetySuitability)

Brand safety au niveau de chaque campagne. Permet de sélectionner un type d'inventaire pour diffuser vos annonces sur des contenus adaptés à votre marque. Consultez la page https://support.google.com/google-ads/answer/7515513.

vanityPharma

object (VanityPharma)

Décrit le mode d'affichage des annonces pour des produits pharmaceutiques sans marque.

selectiveOptimization

object (SelectiveOptimization)

Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion pour l'optimiser. Cette fonctionnalité ne s'applique qu'aux campagnes pour applications qui utilisent MULTI_CHANNEL comme AdvertisingChannelType et APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT comme AdvertisingChannelSubType.

optimizationGoalSetting

object (OptimizationGoalSetting)

Paramètre d'objectif d'optimisation pour cette campagne, qui inclut un ensemble de types d'objectifs d'optimisation.

trackingSetting

object (TrackingSetting)

Uniquement en sortie. Paramètres au niveau de la campagne pour les informations de suivi.

paymentMode

enum (PaymentMode)

Mode de paiement de la campagne.

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Types de champs de composants à exclure de cette campagne. Les liens d'asset avec ces types de champs ne seront pas hérités par cette campagne à partir du niveau supérieur.

excludedParentAssetSetTypes[]

enum (AssetSetType)

Types d'ensembles de composants à exclure de cette campagne. Les liens de l'ensemble de composants avec ces types ne seront pas hérités par cette campagne à partir du niveau supérieur. 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 pour ce champ, l'association de tous les ensembles d'éléments de groupe de zones géographiques à cette campagne n'est pas autorisée. De plus, les extensions de lieu et les extensions de lieu affilié ne seront pas diffusées dans cette campagne. Seul LOCATION_SYNC est actuellement pris en charge.

performanceMaxUpgrade

object (PerformanceMaxUpgrade)

Uniquement en sortie. Informations sur les campagnes migrées vers Performance Max.

assetAutomationSettings[]

object (AssetAutomationSetting)

Contient l'état d'activation/de désactivation de chaque AssetAutomationType. Consultez la documentation sur chaque énumération de type d'automatisation d'éléments pour connaître le comportement par défaut de l'activation et de la désactivation.

keywordMatchType

enum (CampaignKeywordMatchType)

Type de correspondance des mots clés de la campagne Définissez la valeur sur "LARGE" pour appliquer la requête large à tous les mots clés d'une campagne.

id

string (int64 format)

Uniquement en sortie. Identifiant de la campagne.

name

string

Nom de la campagne.

Ce champ est obligatoire. Il doit être renseigné lors de la création de campagnes.

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

trackingUrlTemplate

string

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

audienceSetting

object (AudienceSetting)

Immuable. Paramètre des fonctionnalités liées à l'audience.

baseCampaign

string

Uniquement en sortie. Nom de ressource de la campagne de base d'une campagne brouillon ou test. Pour les campagnes de base, cette valeur équivaut à resourceName.

Ce champ est en lecture seule.

campaignBudget

string

Budget de la campagne.

startDate

string

Date à laquelle la diffusion de la campagne a commencé dans le fuseau horaire du client au format AAAA-MM-JJ.

campaignGroup

string

Groupe de campagnes auquel appartient cette campagne.

endDate

string

Dernier jour de la campagne diffusée dans le fuseau horaire du client au format AAAA-MM-JJ. Lors de la création, la valeur par défaut est définie sur 2037-12-30, ce qui signifie que la campagne sera diffusée indéfiniment. Pour paramétrer une campagne existante afin qu'elle soit diffusée indéfiniment, configurez ce champ sur la valeur 2037-12-30.

finalUrlSuffix

string

Suffixe utilisé pour ajouter des paramètres de requête aux pages de destination diffusées avec le suivi en parallèle.

optimizationScore

number

Uniquement en sortie. Taux d'optimisation de la campagne.

Le score d'optimisation fournit une estimation des performances potentielles d'une campagne. Il est compris entre 0% (0,0) et 100% (1,0). Un taux de 100% indique que les performances de la campagne sont pleinement possibles. Ce champ est nul pour les campagnes non évaluées.

Voir "À propos du score d'optimisation" à l'adresse https://support.google.com/google-ads/answer/9061546.

Ce champ est en lecture seule.

urlExpansionOptOut

boolean

Représente la désactivation de l'extension d'URL pour des URL plus ciblées. Si cette option est désactivée (vrai), seules les URL finales du groupe d'assets ou les URL spécifiées dans les flux de données d'entreprise ou Google Merchant Center de l'annonceur sont ciblées. Si cette option est activée (false), le domaine entier sera ciblé. Ce champ ne peut être défini que pour les campagnes Performance Max, où la valeur par défaut est "false".

hotelPropertyAssetSet

string

Immuable. Ensemble d'établissements hôteliers pour les campagnes Performance Max pour les objectifs de voyage.

listingType

enum (ListingType)

Immuable. Type de fiche des annonces diffusées pour cette campagne. L'utilisation de ce champ est limitée aux campagnes Performance Max.

Champ d'union campaign_bidding_strategy. Stratégie d'enchères de la campagne.

Il doit s'agir d'un portefeuille (créé via le service BiddingStrategy) ou d'un portefeuille standard intégré à la campagne. campaign_bidding_strategy ne peut être qu'un des éléments suivants :

biddingStrategy

string

Stratégie de portefeuille d'enchères utilisée par la campagne.

commission

object (Commission)

Les commissions sont une stratégie d'enchères automatiques selon laquelle l'annonceur paie une partie spécifique de la valeur de conversion.

manualCpa

object (ManualCpa)

Stratégie d'enchères au CPA manuelles standard. Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère par action spécifiée par l'annonceur. Disponible uniquement pour les campagnes Local Services.

manualCpc

object (ManualCpc)

Stratégie d'enchères au CPC manuelles standard. Enchères manuelles basées sur les clics, où l'utilisateur paie par clic.

manualCpm

object (ManualCpm)

Stratégie d'enchères au CPM manuelles standard. Enchères manuelles basées sur les impressions, où l'utilisateur paie pour mille impressions

manualCpv

object (ManualCpv)

Il s'agit d'une stratégie d'enchères qui paie un montant configurable par visionnage de vidéo.

maximizeConversions

object (MaximizeConversions)

Stratégie d'enchères standard "Maximiser les conversions" qui maximise automatiquement le nombre de conversions tout en dépensant la totalité de votre budget.

maximizeConversionValue

object (MaximizeConversionValue)

Stratégie d'enchères standard "Maximiser la valeur de conversion" qui définit automatiquement les enchères pour maximiser les revenus tout en dépensant la totalité de votre budget.

targetCpa

object (TargetCpa)

Stratégie d'enchères standard au CPA cible, qui définit automatiquement vos enchères de sorte que vous enregistriez autant de conversions que possible pour le coût par acquisition (CPA) cible que vous spécifiez.

targetImpressionShare

object (TargetImpressionShare)

Stratégie d'enchères "Taux d'impressions cible". Il s'agit d'une stratégie d'enchères automatiques qui définit les enchères de façon à atteindre un pourcentage donné d'impressions.

targetRoas

object (TargetRoas)

Stratégie d'enchères standard au ROAS cible qui maximise automatiquement les revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) spécifique moyen.

targetSpend

object (TargetSpend)

Cette stratégie d'enchères standard définit automatiquement vos enchères de sorte que vous enregistriez autant de clics que possible dans les limites de votre budget.

percentCpc

object (PercentCpc)

Stratégie d'enchères au CPC standard au pourcentage, dans laquelle les enchères sont une fraction du prix annoncé d'un bien ou d'un service.

targetCpm

object (TargetCpm)

Il s'agit d'une stratégie d'enchères qui optimise automatiquement le coût pour mille impressions.

fixedCpm

object (FixedCpm)

Une stratégie d'enchères manuelles avec un CPM fixe.

targetCpv

object (TargetCpv)

Il s'agit d'une stratégie d'enchères automatiques qui définit vos enchères de façon à optimiser vos performances en fonction du CPV cible que vous avez défini.

CampaignPrimaryStatus

Énumération décrivant l'état principal possible de la campagne. Il fournit des insights sur les raisons pour lesquelles une campagne n'est pas diffusée ou n'est pas optimale. Les modifications apportées à la campagne et à ses entités associées peuvent mettre un certain temps à apparaître dans cet état.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ELIGIBLE La campagne peut être diffusée.
PAUSED L'état de campagne spécifié par l'utilisateur est "mis en veille".
REMOVED L'état de campagne spécifié par l'utilisateur est supprimé.
ENDED Le délai de fin spécifié par l'utilisateur pour cette campagne est écoulé.
PENDING La campagne est susceptible d'être diffusée à l'avenir.
MISCONFIGURED Les paramètres spécifiés par l'utilisateur de la campagne ou de ses entités associées sont incorrects.
LIMITED La campagne ou ses entités associées sont limitées par des paramètres spécifiés par l'utilisateur.
LEARNING Le système d'enchères automatiques s'ajuste aux modifications spécifiées par l'utilisateur au niveau de la campagne ou des entités associées.
NOT_ELIGIBLE La campagne ne peut pas être diffusée.

CampaignPrimaryStatusReason

Énumération décrivant les raisons possibles de l'état principal de la campagne. Il fournit des insights sur les raisons pour lesquelles une campagne n'est pas diffusée ou n'est pas optimale. Ces motifs sont regroupés afin de déterminer l'état général global d'une campagne.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
CAMPAIGN_REMOVED L'état de campagne spécifié par l'utilisateur est supprimé.
CAMPAIGN_PAUSED L'état de campagne spécifié par l'utilisateur est "mis en veille".
CAMPAIGN_PENDING L'heure de début de la campagne spécifiée par l'utilisateur se situe dans le futur.
CAMPAIGN_ENDED Le délai de fin spécifié par l'utilisateur pour cette campagne est écoulé.
CAMPAIGN_DRAFT La campagne est un brouillon.
BIDDING_STRATEGY_MISCONFIGURED Les paramètres spécifiés par l'utilisateur de la stratégie d'enchères sont incorrects.
BIDDING_STRATEGY_LIMITED La stratégie d'enchères est limitée par des paramètres spécifiés par l'utilisateur (par exemple, l'absence de données ou d'autres paramètres similaires).
BIDDING_STRATEGY_LEARNING Le système d'enchères automatiques s'adapte aux modifications de la stratégie d'enchères spécifiées par l'utilisateur.
BIDDING_STRATEGY_CONSTRAINED La campagne pourrait enregistrer une plus grande valeur de conversion en ajustant les CPA/ROAS cibles.
BUDGET_CONSTRAINED Le budget limite la capacité de la campagne à être diffusée.
BUDGET_MISCONFIGURED Les paramètres définis par l'utilisateur sont incorrects dans le budget.
SEARCH_VOLUME_LIMITED La campagne ne cible pas toutes les requêtes pertinentes.
AD_GROUPS_PAUSED Les états des groupes d'annonces spécifiés par l'utilisateur sont tous "mis en veille".
NO_AD_GROUPS Cette campagne ne comporte aucun groupe d'annonces éligible.
KEYWORDS_PAUSED Les états des mots clés spécifiés par l'utilisateur sont tous "mis en veille".
NO_KEYWORDS Cette campagne ne comporte aucun mot clé éligible.
AD_GROUP_ADS_PAUSED Tous les états d'annonces définis par l'utilisateur dans les groupes d'annonces ont été mis en veille.
NO_AD_GROUP_ADS Cette campagne ne contient aucune annonce de groupe d'annonces éligible.
HAS_ADS_LIMITED_BY_POLICY Au moins une annonce de cette campagne est limitée conformément au règlement.
HAS_ADS_DISAPPROVED Au moins une annonce de cette campagne a été refusée.
MOST_ADS_UNDER_REVIEW La plupart des annonces de cette campagne sont en attente d'examen.
MISSING_LEAD_FORM_EXTENSION La campagne a un objectif de formulaires pour prospects, et l'extension de formulaire pour prospects est manquante.
MISSING_CALL_EXTENSION La campagne a un objectif d'appels et l'extension d'appel est manquante.
LEAD_FORM_EXTENSION_UNDER_REVIEW L'extension de formulaire pour prospects est en cours d'examen.
LEAD_FORM_EXTENSION_DISAPPROVED L'extension pour prospects est refusée.
CALL_EXTENSION_UNDER_REVIEW L'extension d'appel est en cours d'examen.
CALL_EXTENSION_DISAPPROVED L'extension d'appel est refusée.
NO_MOBILE_APPLICATION_AD_GROUP_CRITERIA Cette campagne ne contient aucun critère de groupe d'annonces éligible pour les applications mobiles.
CAMPAIGN_GROUP_PAUSED L'état du groupe de campagnes spécifié par l'utilisateur est "mis en veille".
CAMPAIGN_GROUP_ALL_GROUP_BUDGETS_ENDED Les délais spécifiés par l'utilisateur pour tous les budgets de groupe associés au groupe de campagnes parent sont passés.
APP_NOT_RELEASED L'application associée à cette campagne pour applications axée sur les installations n'est pas disponible dans les pays cibles de la campagne.
APP_PARTIALLY_RELEASED L'application associée à cette campagne pour applications axée sur les installations est partiellement publiée dans les pays cibles de la campagne.
HAS_ASSET_GROUPS_DISAPPROVED Au moins un groupe d'assets a été refusé dans cette campagne.
HAS_ASSET_GROUPS_LIMITED_BY_POLICY Au moins un groupe d'assets de cette campagne est limité par le règlement.
MOST_ASSET_GROUPS_UNDER_REVIEW La plupart des groupes de composants de cette campagne sont en attente d'examen.
NO_ASSET_GROUPS Cette campagne ne comporte aucun groupe de composants éligible.
ASSET_GROUPS_PAUSED Tous les groupes d'assets de cette campagne ont été mis en veille.

CampaignStatus

États possibles d'une campagne.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED La campagne est active et peut diffuser des annonces.
PAUSED La campagne a été mise en veille par l'utilisateur.
REMOVED La campagne a été supprimée.

CampaignServingStatus

États de diffusion possibles d'une campagne.

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

La valeur reçue est inconnue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

SERVING Inférence.
NONE Aucun
ENDED Terminé.
PENDING En attente.
SUSPENDED Suspendu.

BiddingStrategySystemStatus

États système possibles d'une stratégie d'enchères.

Enums
UNSPECIFIED Indique qu'une erreur inattendue s'est produite (par exemple, aucun type de stratégie d'enchères n'a été trouvé ou aucune information sur l'état n'a été trouvée).
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED La stratégie d'enchères est active et le système AdWords ne détecte aucun problème particulier à son sujet.
LEARNING_NEW La stratégie d'enchères est en phase d'apprentissage, car elle a été créée ou réactivée récemment.
LEARNING_SETTING_CHANGE La stratégie d'enchères est en phase d'apprentissage en raison d'un changement récent de paramètre.
LEARNING_BUDGET_CHANGE La stratégie d'enchères est en phase d'apprentissage en raison d'une modification récente du budget.
LEARNING_COMPOSITION_CHANGE La stratégie d'enchères est en phase d'apprentissage en raison d'une modification récente du nombre de campagnes, de groupes d'annonces ou de mots clés associés.
LEARNING_CONVERSION_TYPE_CHANGE La stratégie d'enchères dépend des rapports sur les conversions et du client qui a récemment modifié les types de conversion pertinents pour la stratégie d'enchères.
LEARNING_CONVERSION_SETTING_CHANGE La stratégie d'enchères dépend des rapports sur les conversions, et le client a récemment modifié ses paramètres de conversion.
LIMITED_BY_CPC_BID_CEILING La stratégie d'enchères est limitée par son plafond d'enchères.
LIMITED_BY_CPC_BID_FLOOR La stratégie d'enchères est limitée par son prix plancher d'enchères.
LIMITED_BY_DATA La stratégie d'enchères est limitée, car le trafic de conversion n'a pas été suffisant au cours des dernières semaines.
LIMITED_BY_BUDGET Une part significative des mots clés de cette stratégie d'enchères est limitée par le budget.
LIMITED_BY_LOW_PRIORITY_SPEND La stratégie d'enchères ne peut pas atteindre son objectif de dépenses, car la priorité de ses dépenses a été inférieure.
LIMITED_BY_LOW_QUALITY Une part significative des mots clés de cette stratégie d'enchères présente un faible niveau de qualité.
LIMITED_BY_INVENTORY La stratégie d'enchères ne peut pas dépenser l'intégralité de son budget en raison d'un ciblage restreint.
MISCONFIGURED_ZERO_ELIGIBILITY Il manque le suivi des conversions (aucun ping présent) et/ou des listes de remarketing pour les CSI.
MISCONFIGURED_CONVERSION_TYPES La stratégie d'enchères dépend des rapports sur les conversions, et le client ne dispose pas de types de conversion qui pourraient être enregistrés avec cette stratégie.
MISCONFIGURED_CONVERSION_SETTINGS La stratégie d'enchères dépend des rapports sur les conversions, et les paramètres de conversion du client sont mal configurés.
MISCONFIGURED_SHARED_BUDGET Des campagnes externes à la stratégie d'enchères partagent un budget avec des campagnes incluses dans la stratégie.
MISCONFIGURED_STRATEGY_TYPE Le type de stratégie de la campagne n'est pas valide et n'est pas diffusée.
PAUSED La stratégie d'enchères n'est pas active. La stratégie d'enchères n'est associée à aucune campagne, aucun groupe d'annonces ni aucun mot clé actifs. ou aucun budget actif n'est associé à la stratégie d'enchères.
UNAVAILABLE Cette stratégie d'enchères ne permet actuellement pas la création de rapports d'état.
MULTIPLE_LEARNING Plusieurs états système LEARNING_* ont été associés à cette stratégie d'enchères au cours de la période en question.
MULTIPLE_LIMITED Plusieurs états système (LIMITED_*) ont été définis pour cette stratégie d'enchères pendant la période en question.
MULTIPLE_MISCONFIGURED Plusieurs états système MISCONFIGURED_* ont été associés à cette stratégie d'enchères pendant la période en question.
MULTIPLE Plusieurs états système ont été définis pour cette stratégie d'enchères au cours de la période concernée.

AdServingOptimizationStatus

Énumération décrivant les états de diffusion possibles.

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

La valeur reçue est inconnue dans cette version.

Il s'agit d'une valeur de réponse uniquement.

OPTIMIZE La diffusion des annonces est optimisée en fonction du CTR de la campagne.
CONVERSION_OPTIMIZE La diffusion des annonces est optimisée en fonction du CTR * conversion de la campagne. Si la campagne ne fait pas partie de la stratégie d'enchères de l'Optimiseur de conversion, elle est définie par défaut sur OPTIMISÉE.
ROTATE Les annonces sont alternées de manière régulière pendant 90 jours, puis optimisées pour les clics.
ROTATE_INDEFINITELY Diffuser les annonces moins performantes de manière plus régulière avec les plus performantes, sans optimisation
UNAVAILABLE L'état d'optimisation de la diffusion des annonces n'est pas disponible.

LocalServicesCampaignSettings

Paramètres de la sous-ressource LocalServicesCampaign.

Représentation JSON
{
  "categoryBids": [
    {
      object (CategoryBid)
    }
  ]
}
Champs
categoryBids[]

object (CategoryBid)

Enchères de niveau catégoriel associées à la stratégie d'enchères au CPA MANUAL.

CategoryBid

Enchères de catégorie dans LocalServicesReportingCampaignSettings.

Représentation JSON
{
  "categoryId": string,
  "manualCpaBidMicros": string
}
Champs
categoryId

string

Catégorie à laquelle l'enchère sera associée. Par exemple, xcat:service_area_business_plombier.

manualCpaBidMicros

string (int64 format)

Enchère au CPA manuelle pour la catégorie. L'enchère doit être supérieure au prix de réserve associé à cette catégorie. La valeur est exprimée en micro-unités et dans la devise de l'annonceur.

TravelCampaignSettings

Paramètres de la campagne de voyage.

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

string (int64 format)

Immuable. ID du compte de voyage associé à la campagne de voyage.

DemandGenCampaignSettings

Paramètres de la campagne de génération de la demande.

Représentation JSON
{
  "upgradedTargeting": boolean
}
Champs
upgradedTargeting

boolean

Immuable. Indique si cette campagne utilise les nouvelles options de ciblage. Lorsque ce champ est défini sur true, vous pouvez utiliser le ciblage géographique et linguistique au niveau du groupe d'annonces plutôt qu'un ciblage standard au niveau de la campagne. Ce champ est défini par défaut sur false et ne peut être défini que lors de la création d'une campagne.

VideoCampaignSettings

Paramètres de la campagne vidéo.

Représentation JSON
{
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Champs
videoAdInventoryControl

object (VideoAdInventoryControl)

Contrôle de l'inventaire pour les conteneurs d'annonces responsives dans les campagnes axées sur la couverture.

VideoAdInventoryControl

Pour les campagnes utilisant des conteneurs d'annonces responsives, les outils d'optimisation d'inventaire déterminent sur quels inventaires les annonces peuvent être diffusées. Cela ne s'applique qu'aux campagnes utilisant les stratégies d'enchères TARGET_CPM et FIXED_CPM.

Représentation JSON
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean
}
Champs
allowInStream

boolean

Déterminez si VideoResponsiveAds peut être utilisé pour les annonces vidéo InStream.

allowInFeed

boolean

Déterminez si VideoResponsiveAds peut être utilisé pour les annonces vidéo In-Feed.

allowShorts

boolean

Déterminez si VideoResponsiveAds peut être utilisé comme format Shorts.

RealTimeBiddingSetting

Paramètres des enchères en temps réel (fonctionnalité disponible uniquement pour les campagnes ciblant le réseau Ad Exchange).

Représentation JSON
{
  "optIn": boolean
}
Champs
optIn

boolean

Indique si les enchères en temps réel sont activées pour la campagne.

NetworkSettings

Paramètres des réseaux de la campagne.

Représentation JSON
{
  "targetGoogleSearch": boolean,
  "targetSearchNetwork": boolean,
  "targetContentNetwork": boolean,
  "targetPartnerSearchNetwork": boolean,
  "targetYoutube": boolean,
  "targetGoogleTvNetwork": boolean
}
Champs
targetSearchNetwork

boolean

Indique si les annonces seront diffusées sur les sites partenaires du Réseau de Recherche de Google (targetGoogleSearch doit également être défini sur true).

targetContentNetwork

boolean

Indique si les annonces seront diffusées ou non sur des emplacements spécifiés du Réseau Display de Google. Les emplacements sont spécifiés à l'aide du critère d'emplacement.

targetPartnerSearchNetwork

boolean

Indique si des annonces seront diffusées sur le réseau Google Partners. Cette option n'est disponible que pour certains comptes partenaires Google.

targetYoutube

boolean

Indique si les annonces seront diffusées sur YouTube.

targetGoogleTvNetwork

boolean

Indique si les annonces seront diffusées sur le réseau Google TV.

HotelSettingInfo

Paramètres au niveau de la campagne pour les annonces d'hôtels.

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

string (int64 format)

Immuable. Le compte Hotel Center associé.

DynamicSearchAdsSetting

Paramètre permettant de contrôler les annonces dynamiques du Réseau de Recherche (ADR).

Représentation JSON
{
  "domainName": string,
  "languageCode": string,
  "feeds": [
    string
  ],
  "useSuppliedUrlsOnly": boolean
}
Champs
domainName

string

Obligatoire. Nom de domaine Internet représenté par ce paramètre, par exemple "google.com". ou "www.google.com".

languageCode

string

Obligatoire. Code de langue spécifiant la langue du domaine (par exemple, "en").

feeds[]

string

Liste des flux de pages associés à la campagne.

useSuppliedUrlsOnly

boolean

Indique si la campagne utilise exclusivement les URL fournies par l'annonceur.

ShoppingSetting

Paramètre des campagnes Shopping. Définit l'ensemble des produits dont la campagne peut faire la promotion et la manière dont celle-ci interagit avec les autres campagnes Shopping.

Représentation JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "advertisingPartnerIds": [
    string
  ],
  "merchantId": string,
  "campaignPriority": integer,
  "enableLocal": boolean,
  "disableProductFeed": boolean
}
Champs
feedLabel

string

Libellé du flux des produits à inclure dans la campagne. Vous ne pouvez définir qu'un seul champ feedLabel ou sales_country. S'il est utilisé à la place de sales_country, le champ feedLabel accepte les codes pays au même format, par exemple : "XX". Sinon, il peut s'agir de n'importe quelle chaîne utilisée pour le libellé du flux dans Google Merchant Center.

useVehicleInventory

boolean

Immuable. Permet de cibler ou non l'inventaire des véhicules. Ce champ n'est compatible qu'avec les campagnes Shopping intelligentes. Pour définir un inventaire pour les annonces de véhicules dans des campagnes Performance Max, utilisez plutôt listingType.

advertisingPartnerIds[]

string (int64 format)

Immuable. ID des comptes publicitaires des partenaires publicitaires coopérant au sein de la campagne.

merchantId

string (int64 format)

ID du compte Merchant Center. Ce champ est obligatoire pour créer des opérations. Ce champ ne peut pas être modifié pour les campagnes Shopping.

campaignPriority

integer

Priorité de la campagne. Les campagnes dont le niveau de priorité est numériquement plus élevé prévalent sur celles dont le niveau de priorité est inférieur. Ce champ est obligatoire pour les campagnes Shopping et ses valeurs sont comprises entre 0 et 2 inclus. Ce champ est facultatif pour les campagnes Shopping intelligentes, mais sa valeur doit être égale à 3 s'il est défini.

enableLocal

boolean

Permet d'inclure ou non les produits en magasin.

disableProductFeed

boolean

Désactivez le flux de produits facultatif. Ce champ n'est actuellement disponible que pour les campagnes de génération de la demande. Pour en savoir plus sur cette fonctionnalité, consultez la page https://support.google.com/google-ads/answer/13721750.

AudienceSetting

Paramètres de ciblage d'audience.

Représentation JSON
{
  "useAudienceGrouped": boolean
}
Champs
useAudienceGrouped

boolean

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

GeoTargetTypeSetting

Représente un ensemble de paramètres liés au ciblage géographique des annonces.

Représentation JSON
{
  "positiveGeoTargetType": enum (PositiveGeoTargetType),
  "negativeGeoTargetType": enum (NegativeGeoTargetType)
}
Champs
positiveGeoTargetType

enum (PositiveGeoTargetType)

Paramètre utilisé pour le ciblage géographique à inclure dans cette campagne spécifique.

negativeGeoTargetType

enum (NegativeGeoTargetType)

Paramètre utilisé pour le ciblage géographique à exclure dans cette campagne.

PositiveGeoTargetType

Types de cibles géographiques à inclure possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
PRESENCE_OR_INTEREST Indique qu'une annonce est diffusée si l'utilisateur se trouve dans les zones ciblées par l'annonceur ou s'y intéresse.
SEARCH_INTEREST Indique qu'une annonce est diffusée si l'utilisateur recherche les zones ciblées par l'annonceur. Il ne peut être utilisé qu'avec les campagnes Shopping standards et sur le Réseau de Recherche.
PRESENCE Indique qu'une annonce est diffusée si l'utilisateur se trouve dans les zones ciblées par l'annonceur ou s'y rend régulièrement.

NegativeGeoTargetType

Types de cibles géographiques à exclure possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
PRESENCE_OR_INTEREST Indique qu'un utilisateur ne peut pas voir l'annonce s'il se trouve dans les zones exclues de l'annonceur ou s'y intéressent.
PRESENCE Indique qu'un utilisateur ne pourra pas voir l'annonce s'il se trouve dans les zones géographiques exclues de l'annonceur.

LocalCampaignSetting

Paramètre des campagnes locales.

Représentation JSON
{
  "locationSourceType": enum (LocationSourceType)
}
Champs
locationSourceType

enum (LocationSourceType)

Type de source de zones géographiques pour cette campagne locale.

LocationSourceType

Types de sources de localisation possibles.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
GOOGLE_MY_BUSINESS Établissements associés à la fiche d'établissement du client.
AFFILIATE Emplacements des magasins affiliés (chaînes) Par exemple, les adresses des magasins Best Buy.

AppCampaignSetting

Paramètres au niveau de la campagne pour les campagnes pour applications.

Représentation JSON
{
  "biddingStrategyGoalType": enum (AppCampaignBiddingStrategyGoalType),
  "appStore": enum (AppCampaignAppStore),
  "appId": string
}
Champs
biddingStrategyGoalType

enum (AppCampaignBiddingStrategyGoalType)

Représente l'objectif pour lequel la stratégie d'enchères de cette campagne pour applications doit être optimisée.

appStore

enum (AppCampaignAppStore)

Immuable. Plate-forme de téléchargement d'applications qui distribue cette application spécifique.

appId

string

Immuable. Chaîne qui identifie de manière unique une application mobile.

AppCampaignBiddingStrategyGoalType

Type d'objectif de la stratégie d'enchères de la campagne pour applications.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST Efforcez-vous de maximiser le nombre d'installations de votre application. L'enchère au CPA correspond au coût par installation cible.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST Essayez de maximiser le nombre à long terme des conversions d'application à partir des installations d'application sélectionnées. L'enchère au CPA correspond au coût par installation cible.
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST Essayez de maximiser le nombre à long terme des conversions d'application à partir des installations d'application sélectionnées. L'enchère au CPA correspond au coût par conversion dans l'application cible. Notez que le CPA réel peut sembler supérieur au CPA cible au premier abord, car les conversions à long terme ne se sont pas encore produites.
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND Objectif : maximiser toutes les conversions (par exemple, installation + conversions dans l'application sélectionnées tout en atteignant ou en dépassant l'objectif de retour sur les dépenses publicitaires).
OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME Efforcez-vous de maximiser le nombre de préinscriptions pour votre application.
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST Efforcez-vous de maximiser le nombre d'installations de l'application sans coût par installation cible.

AppCampaignAppStore

Énumération décrivant la plate-forme de téléchargement d'applications de la campagne pour applications.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
APPLE_APP_STORE App Store d'Apple.
GOOGLE_APP_STORE Google Play.

CampaignExperimentType

Indique s'il s'agit d'une campagne standard, d'une campagne brouillon ou d'une campagne test.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
BASE Il s'agit d'une campagne standard.
DRAFT Il s'agit de la version brouillon d'une campagne. Elle a quelques modifications par rapport à une campagne de base, mais elle ne diffuse ni ne génère de métriques.
EXPERIMENT Il s'agit de la version test d'une campagne. Elle a été modifiée par rapport à une campagne de base, et un pourcentage du trafic de la campagne BASE est redirigé vers cette campagne test.

FrequencyCapEntry

Règle spécifiant le nombre maximal de fois qu'une annonce (ou un ensemble d'annonces) peut être diffusée auprès d'un utilisateur au cours d'une période donnée.

Représentation JSON
{
  "key": {
    object (FrequencyCapKey)
  },
  "cap": integer
}
Champs
key

object (FrequencyCapKey)

Clé d'une limite du nombre d'expositions spécifique. Une même clé ne peut pas être associée à plusieurs limites du nombre d'expositions.

cap

integer

Nombre maximal d'événements autorisés pendant la période par cette limite.

FrequencyCapKey

Groupe de champs utilisés comme clés pour une limitation de la fréquence d'exposition. Une même clé ne peut pas être associée à plusieurs limites du nombre d'expositions.

Représentation JSON
{
  "level": enum (FrequencyCapLevel),
  "eventType": enum (FrequencyCapEventType),
  "timeUnit": enum (FrequencyCapTimeUnit),
  "timeLength": integer
}
Champs
level

enum (FrequencyCapLevel)

Niveau auquel la limite s'applique (par exemple, au niveau du groupe d'annonces ou du groupe d'annonces). La limitation s'applique à toutes les entités de ce niveau.

eventType

enum (FrequencyCapEventType)

Type d'événement auquel la limite s'applique (par exemple, une impression).

timeUnit

enum (FrequencyCapTimeUnit)

L'unité de temps à laquelle la limite est définie (par exemple, jour, semaine).

timeLength

integer

Nombre d'unités de temps de la limite.

FrequencyCapLevel

Niveau auquel la limite s'applique (par exemple, au niveau du groupe d'annonces ou du groupe d'annonces). La limite s'applique à toutes les ressources de ce niveau.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AD_GROUP_AD La limitation s'applique au niveau des annonces du groupe d'annonces.
AD_GROUP La limitation s'applique au niveau du groupe d'annonces.
CAMPAIGN La limite s'applique au niveau de la campagne.

FrequencyCapEventType

Type d'événement auquel la limite s'applique (par exemple, une impression).

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
IMPRESSION Cette limite s'applique aux impressions d'annonces.
VIDEO_VIEW Cette limite s'applique aux visionnages d'annonces vidéo.

VanityPharma

Décrit le mode d'affichage des annonces pour des produits pharmaceutiques sans marque.

Représentation JSON
{
  "vanityPharmaDisplayUrlMode": enum (VanityPharmaDisplayUrlMode),
  "vanityPharmaText": enum (VanityPharmaText)
}
Champs
vanityPharmaDisplayUrlMode

enum (VanityPharmaDisplayUrlMode)

Mode d'affichage des URL de pharmacies personnalisées.

vanityPharmaText

enum (VanityPharmaText)

Texte qui s'affiche dans l'URL à afficher de l'annonce textuelle lorsque le mode d'affichage sélectionné pour les URL de produits pharmaceutiques personnalisés est la description de site Web.

VanityPharmaDisplayUrlMode

Énumération décrivant les modes d'affichage possibles pour les URL de pharmacies personnalisées.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
MANUFACTURER_WEBSITE_URL Remplacez l'URL du produit pharmaceutique personnalisé par l'URL du site Web du fabricant.
WEBSITE_DESCRIPTION Remplacez l'URL du produit pharmaceutique personnalisé par la description du site Web.

VanityPharmaText

Énumération décrivant le texte possible.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
PRESCRIPTION_TREATMENT_WEBSITE_EN Site Web dédié aux traitements sur ordonnance, dont le contenu est en anglais.
PRESCRIPTION_TREATMENT_WEBSITE_ES Site Web dédié aux traitements sur ordonnance, dont le contenu est rédigé en espagnol (Sitio de tratamientos con receta).
PRESCRIPTION_DEVICE_WEBSITE_EN Site Web dédié aux dispositifs médicaux sur ordonnance, dont le contenu est en anglais.
PRESCRIPTION_DEVICE_WEBSITE_ES Site Web dédié aux dispositifs médicaux sur ordonnance, dont le contenu est rédigé en espagnol (Sitio de dispositivos con receta).
MEDICAL_DEVICE_WEBSITE_EN Site Web dédié aux dispositifs médicaux, dont le contenu est en anglais.
MEDICAL_DEVICE_WEBSITE_ES Site Web dédié aux dispositifs médicaux, dont le contenu est en espagnol (Sitio de dispositivos médicos).
PREVENTATIVE_TREATMENT_WEBSITE_EN Site Web dédié aux traitements préventifs, dont le contenu est en anglais.
PREVENTATIVE_TREATMENT_WEBSITE_ES Site Web dédié aux traitements préventifs, dont le contenu est rédigé en espagnol (Sitio de tratamientos preventivos).
PRESCRIPTION_CONTRACEPTION_WEBSITE_EN Site Web dédié à la contraception sur ordonnance, dont le contenu est en anglais.
PRESCRIPTION_CONTRACEPTION_WEBSITE_ES Site Web dédié à la contraception sur ordonnance, dont le contenu est rédigé en espagnol (Sitio de anticonceptivos con receta).
PRESCRIPTION_VACCINE_WEBSITE_EN Site Web dédié aux vaccins sur ordonnance, dont le contenu est en anglais.
PRESCRIPTION_VACCINE_WEBSITE_ES Site Web dédié aux vaccins sur ordonnance, dont le contenu est rédigé en espagnol (Sitio de vacunas con receta).

SelectiveOptimization

Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion pour l'optimiser. Cette fonctionnalité ne s'applique qu'aux campagnes pour applications qui utilisent MULTI_CHANNEL comme AdvertisingChannelType et APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT comme AdvertisingChannelSubType.

Représentation JSON
{
  "conversionActions": [
    string
  ]
}
Champs
conversionActions[]

string

Ensemble d'actions de conversion sélectionné pour optimiser cette campagne.

OptimizationGoalSetting

Paramètre d'objectif d'optimisation pour cette campagne, qui inclut un ensemble de types d'objectifs d'optimisation.

Représentation JSON
{
  "optimizationGoalTypes": [
    enum (OptimizationGoalType)
  ]
}
Champs
optimizationGoalTypes[]

enum (OptimizationGoalType)

Liste des types d'objectifs d'optimisation.

OptimizationGoalType

Type d'objectif d'optimisation

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisée uniquement comme valeur renvoyée. Représente une valeur inconnue dans cette version.
CALL_CLICKS Optimisez pour les clics d'appel. Les conversions après clic d'appel correspondent au nombre de fois où les utilisateurs ont sélectionné "Appeler" à contacter un magasin après avoir vu une annonce.
DRIVING_DIRECTIONS Optimiser pour les itinéraires routiers. Les conversions d'itinéraires correspondent au nombre de fois où les utilisateurs ont sélectionné "Itinéraire" pour se rendre dans un magasin après avoir vu une annonce.
APP_PRE_REGISTRATION Optimiser pour la préinscription. Les conversions de préinscription correspondent au nombre d'inscriptions à la préinscription qui recevront une notification lorsque l'application sera disponible.

TrackingSetting

Paramètres au niveau de la campagne pour les informations de suivi.

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

string

Uniquement en sortie. URL utilisée pour le suivi dynamique.

PaymentMode

Énumération décrivant les modes de paiement possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
CLICKS Paiement par interaction.
CONVERSION_VALUE Paiement par valeur de conversion. Ce mode n'est compatible qu'avec les campagnes utilisant AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION et BudgetType.STANDARD.
CONVERSIONS Paiement par conversion. Ce mode n'est compatible qu'avec les campagnes utilisant AdvertisingChannelType.DISPLAY (à l'exception de AdvertisingChannelSubType.DISPLAY_Gmail), BiddingStrategyType.TARGET_CPA et BudgetType.FIXED_CPA. Le client doit également être éligible à ce mode. Pour en savoir plus, consultez Customer.eligibility_failure_reasons.
GUEST_STAY Valeur du paiement par séjour Ce mode n'est compatible qu'avec les campagnes utilisant AdvertisingChannelType.HOTEL, BiddingStrategyType.COMMISSION et BudgetType.STANDARD.

PerformanceMaxUpgrade

Informations sur une campagne migrée vers Performance Max.

Représentation JSON
{
  "performanceMaxCampaign": string,
  "preUpgradeCampaign": string,
  "status": enum (PerformanceMaxUpgradeStatus)
}
Champs
performanceMaxCampaign

string

Uniquement en sortie. Indique à quelle campagne Performance Max la campagne est migrée.

preUpgradeCampaign

string

Uniquement en sortie. Indique une ancienne campagne migrée vers Performance Max.

status

enum (PerformanceMaxUpgradeStatus)

Uniquement en sortie. État de migration d'une campagne ayant demandé à migrer vers Performance Max.

PerformanceMaxUpgradeStatus

Énumération de l'état de la migration vers Performance Max pour la campagne.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
UPGRADE_IN_PROGRESS La migration vers une campagne Performance Max est en cours.
UPGRADE_COMPLETE La migration vers Performance Max est terminée.
UPGRADE_FAILED Échec de la migration vers Performance Max. La campagne continuera d'être diffusée comme avant la tentative de migration.
UPGRADE_ELIGIBLE La campagne peut être migrée vers Performance Max.

ListingType

Types de fiches possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
VEHICLES Cette campagne diffuse des annonces de véhicules.

AssetAutomationSetting

Le paramètre d'automatisation des composants contient une paire d'AssetAutomationType et l'état d'activation/de désactivation de l'automatisation des composants

Représentation JSON
{
  "assetAutomationType": enum (AssetAutomationType),
  "assetAutomationStatus": enum (AssetAutomationStatus)
}
Champs
assetAutomationType

enum (AssetAutomationType)

Type d'automatisation des composants que l'annonceur souhaite activer/désactiver.

assetAutomationStatus

enum (AssetAutomationStatus)

État d'activation/de désactivation du type d'automatisation des composants.

AssetAutomationType

Type d'automatisation des composants.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisée uniquement comme valeur renvoyée. Représente une valeur inconnue dans cette version.
TEXT_ASSET_AUTOMATION L'automatisation des composants texte inclut les titres et les descriptions. Par défaut, les annonceurs sont activés pour Performance Max et désactivés pour le Réseau de Recherche.

AssetAutomationStatus

État de l'automatisation des composants.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisée uniquement comme valeur renvoyée. Représente une valeur inconnue dans cette version.
OPTED_IN Cette option permet de générer et de diffuser un type d'automatisation des composants.
OPTED_OUT Si vous la désactivez, un type d'automatisation des composants ne sera plus généré ni diffusé.

CampaignKeywordMatchType

Énumération décrivant le type de correspondance des mots clés de la campagne.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
BROAD Requête large au niveau de la campagne.

Commission

Les commissions sont une stratégie d'enchères automatiques selon laquelle l'annonceur paie une partie spécifique de la valeur de conversion.

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

string (int64 format)

Le taux de commission définit la part de la valeur de conversion qui sera facturée à l'annonceur. Un taux de commission de x doit être transmis dans ce champ de la manière suivante : (x * 1 000 000). Par exemple, 106 000 correspond à un taux de commission de 0,106 (10,6%).

ManualCpa

Ce type ne comporte aucun champ.

Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère par action spécifiée par l'annonceur.

ManualCpc

Enchères manuelles basées sur les clics, où l'utilisateur paie par clic.

Représentation JSON
{
  "enhancedCpcEnabled": boolean
}
Champs
enhancedCpcEnabled

boolean

Indique si les enchères doivent être améliorées en fonction des données de l'Optimiseur de conversion.

ManualCpm

Ce type ne comporte aucun champ.

Enchères manuelles basées sur les impressions, où l'utilisateur paie pour mille impressions

ManualCpv

Ce type ne comporte aucun champ.

Enchères basées sur les vues, où l'utilisateur paie par visionnage de vidéo

PercentCpc

Il s'agit d'une stratégie d'enchères dans laquelle les enchères ne représentent qu'une fraction du prix annoncé d'un bien ou d'un service.

Représentation JSON
{
  "cpcBidCeilingMicros": string,
  "enhancedCpcEnabled": boolean
}
Champs
cpcBidCeilingMicros

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. Il s'agit d'un champ facultatif saisi par l'annonceur et spécifié en micros locaux. Remarque: Une valeur nulle est interprétée de la même manière que la valeur "enchère_plafond" n'est pas définie.

enhancedCpcEnabled

boolean

À la hausse ou à la baisse de chaque enchère, l'enchère est ajustée en fonction de la probabilité de conversion. Les enchères individuelles peuvent dépasser cpcBidCeilingMicros, mais pas le montant moyen de l'enchère pour une campagne.

TargetCpm

Le CPM cible (coût pour mille impressions) est une stratégie d'enchères automatiques qui définit des enchères pour optimiser vos performances en fonction du CPM cible que vous avez défini.

Représentation JSON
{

  // Union field goal can be only one of the following:
  "targetFrequencyGoal": {
    object (TargetCpmTargetFrequencyGoal)
  }
  // End of list of possible types for union field goal.
}
Champs
Champ d'union goal. Informations supplémentaires concernant l'objectif d'enchères. goal ne peut être qu'un des éléments suivants :
targetFrequencyGoal

object (TargetCpmTargetFrequencyGoal)

Détails de l'objectif de la stratégie d'enchères avec fréquence cible.

TargetCpmTargetFrequencyGoal

Détails de l'objectif de la stratégie d'enchères avec fréquence cible.

Représentation JSON
{
  "targetCount": string,
  "timeUnit": enum (TargetFrequencyTimeUnit)
}
Champs
targetCount

string (int64 format)

Nombre de fréquences cibles représentant le nombre de fois que vous souhaitez toucher un seul utilisateur.

timeUnit

enum (TargetFrequencyTimeUnit)

Fenêtre de temps exprimant la période sur laquelle vous souhaitez atteindre le nombre cible spécifié.

FixedCpm

Stratégie d'enchères au CPM (coût pour mille impressions) fixe. Une stratégie d'enchères manuelles avec un CPM fixe.

Représentation JSON
{
  "goal": enum (FixedCpmGoal),

  // Union field goal_info can be only one of the following:
  "targetFrequencyInfo": {
    object (FixedCpmTargetFrequencyGoalInfo)
  }
  // End of list of possible types for union field goal_info.
}
Champs
goal

enum (FixedCpmGoal)

Objectif d'enchères au CPM fixe. Détermine les paramètres exacts d'optimisation des enchères.

Champ d'union goal_info. Informations supplémentaires concernant l'objectif d'enchères. goal_info ne peut être qu'un des éléments suivants :
targetFrequencyInfo

object (FixedCpmTargetFrequencyGoalInfo)

Détails de l'objectif d'enchères avec fréquence cible.

FixedCpmGoal

Énumération décrivant l'objectif de la stratégie d'enchères au CPM fixe.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
REACH Maximiser la couverture, c'est-à-dire le nombre d'utilisateurs ayant vu les annonces de cette campagne.
TARGET_FREQUENCY Enchérisseur au CPM avec fréquence cible. Optimisez les enchères pour toucher un seul utilisateur à la fréquence demandée.

FixedCpmTargetFrequencyGoalInfo

Détails de l'objectif d'enchères avec fréquence cible pour la stratégie d'enchères au CPM fixe. Ne s'applique que si l'objectif de la stratégie d'enchères est TARGET_FREQUENCY.

Représentation JSON
{
  "targetCount": string,
  "timeUnit": enum (FixedCpmTargetFrequencyTimeUnit)
}
Champs
targetCount

string (int64 format)

Le nombre de fréquences cibles correspond au nombre de fois qu'un annonceur souhaite diffuser l'annonce pour cibler un seul utilisateur.

timeUnit

enum (FixedCpmTargetFrequencyTimeUnit)

Fenêtre de temps exprimant la période sur laquelle vous souhaitez atteindre le nombre cible spécifié.

FixedCpmTargetFrequencyTimeUnit

Énumération décrivant la période pendant laquelle les enchères sont optimisées pour atteindre la fréquence cible avec la stratégie d'enchères au CPM fixe.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
MONTHLY Optimisez les enchères pour atteindre la fréquence cible dans 30 jours.

TargetCpv

Ce type ne comporte aucun champ.

Stratégie d'enchères au CPV (coût par vue) cible. Il s'agit d'une stratégie d'enchères automatiques qui définit vos enchères de façon à optimiser vos performances en fonction du CPV cible que vous avez défini.