SearchAds360Row

Ligne renvoyée par la requête.

Représentation JSON
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupLabel": {
    object (AdGroupLabel)
  },
  "ageRangeView": {
    object (AgeRangeView)
  },
  "asset": {
    object (Asset)
  },
  "assetGroupAsset": {
    object (AssetGroupAsset)
  },
  "assetGroupSignal": {
    object (AssetGroupSignal)
  },
  "assetGroupListingGroupFilter": {
    object (AssetGroupListingGroupFilter)
  },
  "assetGroupTopCombinationView": {
    object (AssetGroupTopCombinationView)
  },
  "assetGroup": {
    object (AssetGroup)
  },
  "assetSetAsset": {
    object (AssetSetAsset)
  },
  "assetSet": {
    object (AssetSet)
  },
  "biddingStrategy": {
    object (BiddingStrategy)
  },
  "campaignBudget": {
    object (CampaignBudget)
  },
  "campaign": {
    object (Campaign)
  },
  "campaignAsset": {
    object (CampaignAsset)
  },
  "campaignAssetSet": {
    object (CampaignAssetSet)
  },
  "campaignAudienceView": {
    object (CampaignAudienceView)
  },
  "campaignCriterion": {
    object (CampaignCriterion)
  },
  "campaignLabel": {
    object (CampaignLabel)
  },
  "cartDataSalesView": {
    object (CartDataSalesView)
  },
  "audience": {
    object (Audience)
  },
  "conversionAction": {
    object (ConversionAction)
  },
  "conversionCustomVariable": {
    object (ConversionCustomVariable)
  },
  "customer": {
    object (Customer)
  },
  "customerAsset": {
    object (CustomerAsset)
  },
  "customerAssetSet": {
    object (CustomerAssetSet)
  },
  "accessibleBiddingStrategy": {
    object (AccessibleBiddingStrategy)
  },
  "customerManagerLink": {
    object (CustomerManagerLink)
  },
  "customerClient": {
    object (CustomerClient)
  },
  "dynamicSearchAdsSearchTermView": {
    object (DynamicSearchAdsSearchTermView)
  },
  "genderView": {
    object (GenderView)
  },
  "geoTargetConstant": {
    object (GeoTargetConstant)
  },
  "keywordView": {
    object (KeywordView)
  },
  "label": {
    object (Label)
  },
  "languageConstant": {
    object (LanguageConstant)
  },
  "locationView": {
    object (LocationView)
  },
  "productBiddingCategoryConstant": {
    object (ProductBiddingCategoryConstant)
  },
  "productGroupView": {
    object (ProductGroupView)
  },
  "shoppingPerformanceView": {
    object (ShoppingPerformanceView)
  },
  "userList": {
    object (UserList)
  },
  "webpageView": {
    object (WebpageView)
  },
  "visit": {
    object (Visit)
  },
  "conversion": {
    object (Conversion)
  },
  "metrics": {
    object (Metrics)
  },
  "segments": {
    object (Segments)
  },
  "customColumns": [
    {
      object (Value)
    }
  ]
}
Champs
adGroup

object (AdGroup)

Groupe d'annonces référencé dans la requête.

adGroupAd

object (AdGroupAd)

Annonce référencée dans la requête.

adGroupAdLabel

object (AdGroupAdLabel)

Libellé d'annonce du groupe d'annonces référencé dans la requête.

adGroupAsset

object (AdGroupAsset)

Composant du groupe d'annonces référencé dans la requête.

adGroupAssetSet

object (AdGroupAssetSet)

Ensemble de composants du groupe d'annonces référencé dans la requête.

adGroupAudienceView

object (AdGroupAudienceView)

Vue d'audience du groupe d'annonces référencée dans la requête.

adGroupBidModifier

object (AdGroupBidModifier)

Modificateur d'enchères référencé dans la requête.

adGroupCriterion

object (AdGroupCriterion)

Critère référencé dans la requête.

adGroupCriterionLabel

object (AdGroupCriterionLabel)

Libellé du critère du groupe d'annonces référencé dans la requête.

adGroupLabel

object (AdGroupLabel)

Libellé du groupe d'annonces référencé dans la requête.

ageRangeView

object (AgeRangeView)

Vue de la tranche d'âge référencée dans la requête.

asset

object (Asset)

Élément référencé dans la requête.

assetGroupAsset

object (AssetGroupAsset)

Asset du groupe de composants référencé dans la requête.

assetGroupSignal

object (AssetGroupSignal)

Signal du groupe d'assets référencé dans la requête.

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Filtre de groupe de fiches (groupe de composants) référencé dans la requête.

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Vue des meilleures combinaisons de groupes d'assets référencée dans la requête.

assetGroup

object (AssetGroup)

Groupe d'assets référencé dans la requête.

assetSetAsset

object (AssetSetAsset)

Asset de l'ensemble d'assets référencé dans la requête.

assetSet

object (AssetSet)

Ensemble de composants référencé dans la requête.

biddingStrategy

object (BiddingStrategy)

Stratégie d'enchères référencée dans la requête.

campaignBudget

object (CampaignBudget)

Budget de la campagne référencé dans la requête.

campaign

object (Campaign)

Campagne référencée dans la requête.

campaignAsset

object (CampaignAsset)

Composant de campagne référencé dans la requête.

campaignAssetSet

object (CampaignAssetSet)

Ensemble de composants de la campagne référencé dans la requête.

campaignAudienceView

object (CampaignAudienceView)

Vue d'audience de la campagne référencée dans la requête.

campaignCriterion

object (CampaignCriterion)

Critère de campagne référencé dans la requête.

campaignLabel

object (CampaignLabel)

Libellé de la campagne référencé dans la requête.

cartDataSalesView

object (CartDataSalesView)

Vue des ventes des données du panier référencée dans la requête.

audience

object (Audience)

Audience référencée dans la requête.

conversionAction

object (ConversionAction)

Action de conversion référencée dans la requête.

conversionCustomVariable

object (ConversionCustomVariable)

Variable personnalisée de conversion référencée dans la requête.

customer

object (Customer)

Client référencé dans la requête.

customerAsset

object (CustomerAsset)

Asset client référencé dans la requête.

customerAssetSet

object (CustomerAssetSet)

Ensemble de composants client référencé dans la requête.

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

Stratégie d'enchères accessible référencée dans la requête.

customerClient

object (CustomerClient)

CustomerClient référencé dans la requête.

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

Vue des termes de recherche des annonces dynamiques du Réseau de Recherche référencée dans la requête.

genderView

object (GenderView)

Vue par genre référencée dans la requête.

geoTargetConstant

object (GeoTargetConstant)

Constante de cible géographique référencée dans la requête.

keywordView

object (KeywordView)

Vue des mots clés référencée dans la requête.

label

object (Label)

Étiquette référencée dans la requête.

languageConstant

object (LanguageConstant)

Constante de langue référencée dans la requête.

locationView

object (LocationView)

Vue de l'établissement référencée dans la requête.

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

Catégorie d'enchères pour les produits référencée dans la requête.

productGroupView

object (ProductGroupView)

Vue du groupe de produits référencée dans la requête.

shoppingPerformanceView

object (ShoppingPerformanceView)

Vue des performances Shopping référencée dans la requête.

userList

object (UserList)

Liste d'utilisateurs référencée dans la requête.

webpageView

object (WebpageView)

Vue de la page Web référencée dans la requête.

visit

object (Visit)

Visite au niveau de l'événement référencée dans la requête.

conversion

object (Conversion)

Conversion au niveau de l'événement référencée dans la requête.

metrics

object (Metrics)

Les métriques.

segments

object (Segments)

Les segments.

customColumns[]

object (Value)

Colonnes personnalisées

AdGroup

Un groupe d'annonces.

Représentation JSON
{
  "resourceName": string,
  "status": enum (AdGroupStatus),
  "type": enum (AdGroupType),
  "adRotationMode": enum (AdGroupAdRotationMode),
  "creationTime": string,
  "targetingSetting": {
    object (TargetingSetting)
  },
  "labels": [
    string
  ],
  "engineId": string,
  "startDate": string,
  "endDate": string,
  "languageCode": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus)
}
Champs
resourceName

string

Nom de ressource du groupe d'annonces. Les noms de ressources d'un groupe d'annonces se présentent comme suit:

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

État du groupe d'annonces.

type

enum (AdGroupType)

Type de groupe d'annonces.

adRotationMode

enum (AdGroupAdRotationMode)

Mode de rotation des annonces du groupe d'annonces.

creationTime

string

Le code temporel de la création de ce groupe d'annonces. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

targetingSetting

object (TargetingSetting)

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

labels[]

string

Noms de ressource des étiquettes associées à ce groupe d'annonces.

engineId

string

ID du 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 "adGroup.id".

startDate

string

Date à laquelle ce groupe d'annonces commence à diffuser des annonces. Par défaut, le groupe d'annonces commence maintenant ou à la date de début de celui-ci, selon la date la plus tardive. Si ce champ est défini, le groupe d'annonces commence au début de la date spécifiée dans le fuseau horaire du client. Ce champ n'est disponible que pour les comptes de passerelle Microsoft Advertising et Facebook.

Format : AAAA-MM-JJ, exemple : 2019-03-14

endDate

string

Date à laquelle le groupe d'annonces cesse de diffuser des annonces. Par défaut, le groupe d'annonces se termine à la date de fin du groupe d'annonces. Si ce champ est défini, le groupe d'annonces se termine à la date spécifiée dans le fuseau horaire du client. Ce champ n'est disponible que pour les comptes de passerelle Microsoft Advertising et Facebook.

Format : AAAA-MM-JJ, exemple : 2019-03-14

languageCode

string

Langue des annonces et des mots clés d'un groupe d'annonces. Ce champ n'est disponible que pour les comptes Microsoft Advertising. Pour en savoir plus: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

lastModifiedTime

string

Date et heure de la dernière modification de ce groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

id

string (int64 format)

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

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

État du moteur pour le groupe d'annonces.

AdGroupStatus

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

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

ENABLED Le groupe d'annonces est activé.
PAUSED Le groupe d'annonces est 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.

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

SEARCH_STANDARD Type de groupe d'annonces par défaut pour les campagnes sur le Réseau de Recherche.
DISPLAY_STANDARD 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.
SHOPPING_SHOWCASE_ADS Type de groupe d'annonces qui se limite à la diffusion d'annonces Showcase ou Merchant Center dans les résultats Shopping.
HOTEL_ADS Type de groupe d'annonces par défaut pour les campagnes d'hôtel.
SHOPPING_SMART_ADS Type de groupes d'annonces dans les campagnes Shopping intelligentes.
VIDEO_BUMPER Annonces vidéo InStream courtes non désactivables.
VIDEO_TRUE_VIEW_IN_STREAM Annonces vidéo InStream TrueView (désactivables).
VIDEO_TRUE_VIEW_IN_DISPLAY Les annonces vidéo TrueView InDisplay
VIDEO_NON_SKIPPABLE_IN_STREAM 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 associé aux groupes d'annonces dans les campagnes Shopping 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és 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.

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

OPTIMIZE Optimisez les annonces d'un groupe d'annonces en fonction des clics ou des conversions.
ROTATE_FOREVER Alterner de manière régulière et indéfiniment.

AdGroupEngineStatus

État du moteur du groupe d'annonces.

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

Obsolète. Ne pas utiliser.

AD_GROUP_EXPIRED Aucune annonce n'est diffusée pour ce groupe d'annonces, car sa date de fin est passée.
AD_GROUP_REMOVED Le groupe d'annonces a été supprimé.
AD_GROUP_DRAFT Aucune annonce n'est diffusée pour ce groupe d'annonces, car le groupe d'annonces associé est encore à l'état de brouillon.
AD_GROUP_PAUSED Le groupe d'annonces a été mis en veille.
AD_GROUP_SERVING Le groupe d'annonces est actif et ses annonces sont diffusées.
AD_GROUP_SUBMITTED Le groupe d'annonces a été envoyé (ancien état Microsoft Bing Ads).
CAMPAIGN_PAUSED Aucune annonce n'est diffusée pour ce groupe d'annonces, car la campagne a été mise en veille.
ACCOUNT_PAUSED Aucune annonce n'est diffusée pour ce groupe d'annonces, car le compte a été mis en veille.

TargetingSetting

Paramètres des fonctionnalités de ciblage, au niveau de la campagne et du groupe d'annonces. Pour en savoir plus sur le paramètre de ciblage, consultez la page https://support.google.com/google-ads/answer/7365594.

Représentation JSON
{
  "targetRestrictions": [
    {
      object (TargetRestriction)
    }
  ]
}
Champs
targetRestrictions[]

object (TargetRestriction)

Paramètre par dimension de ciblage afin de restreindre la couverture de votre campagne ou de votre groupe d'annonces.

TargetRestriction

Liste des paramètres de ciblage par dimension de ciblage.

Représentation JSON
{
  "targetingDimension": enum (TargetingDimension),
  "bidOnly": boolean
}
Champs
targetingDimension

enum (TargetingDimension)

Dimension de ciblage à laquelle ces paramètres s'appliquent.

bidOnly

boolean

Indique si vous souhaitez limiter la diffusion de vos annonces pour qu'elles ne soient diffusées qu'en fonction des critères que vous avez sélectionnés pour cette dimension ciblée, ou si vous souhaitez cibler toutes les valeurs de cette dimension et diffuser des annonces en fonction de votre ciblage dans d'autres dimensions ciblées. La valeur true signifie que ces critères n'appliqueront que les modificateurs d'enchères, et n'auront pas d'incidence sur le ciblage. La valeur false signifie que ces critères limitent le ciblage et appliquent des modificateurs d'enchères.

TargetingDimension

Énumération décrivant les dimensions de ciblage possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
KEYWORD Critères de mot clé, par exemple "croisière sur mars". KEYWORD peut être utilisé comme dimension d'enchère personnalisée. Les mots clés constituent toujours une dimension de ciblage. Par conséquent, ils ne peuvent pas être définis comme une dimension "TOUTES" cible avec TargetRestriction.
AUDIENCE Critères d'audience, parmi lesquels la liste d'utilisateurs, le centre d'intérêt des utilisateurs, l'audience d'affinité personnalisée et le ciblage personnalisé sur le marché.
TOPIC Critères thématiques pour cibler des catégories de contenu (par exemple, "catégorie::Animaux>Animaux de compagnie") (utilisé pour le ciblage vidéo et display).
GENDER Critères de ciblage par genre.
AGE_RANGE Critères de ciblage des tranches d'âge.
PLACEMENT Les critères d'emplacement, qui incluent des sites Web tels que "www.fleurs4vente.com", ainsi que des applications mobiles, des catégories d'applications mobiles, des vidéos YouTube et des chaînes YouTube
PARENTAL_STATUS Critères de ciblage par statut parental.
INCOME_RANGE Critères de ciblage par tranche de revenus.

AdGroupAd

Annonce d'un groupe d'annonces.

Représentation JSON
{
  "resourceName": string,
  "status": enum (AdGroupAdStatus),
  "ad": {
    object (Ad)
  },
  "creationTime": string,
  "labels": [
    string
  ],
  "engineId": string,
  "engineStatus": enum (AdGroupAdEngineStatus),
  "lastModifiedTime": string
}
Champs
resourceName

string

Nom de ressource de l'annonce. Les noms de ressources d'annonces d'un groupe d'annonces se présentent comme suit:

customers/{customerId}/adGroupAds/{ad_group_id}~{adId}

status

enum (AdGroupAdStatus)

État de l'annonce.

ad

object (Ad)

L'annonce.

creationTime

string

Date et heure de création de l'annonce adGroupAd. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

labels[]

string

Noms de ressource des étiquettes associées à cette annonce de groupe d'annonces.

engineId

string

ID de l'annonce dans le compte de moteur externe. Ce champ ne concerne que les comptes Search Ads 360, par exemple Yahoo! Japan, Microsoft, Baidu, etc. Pour une entité autre que Search Ads 360, utilisez plutôt "adGroupAd.ad.id".

engineStatus

enum (AdGroupAdEngineStatus)

État supplémentaire de l'annonce dans le compte de moteur externe. Les états possibles (selon le type de compte externe) sont les suivants : actif, éligible, en attente d'examen, etc.

lastModifiedTime

string

Date et heure de la dernière modification de l'annonce de ce groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

AdGroupAdStatus

Les différents états possibles d'un objet GroupAd.

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 L'annonce du groupe d'annonces est activée.
PAUSED L'annonce du groupe d'annonces a été mise en veille.
REMOVED L'annonce du groupe d'annonces est supprimée.

AdType

Types d'annonces possibles.

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.

TEXT_AD L'annonce est une annonce textuelle.
EXPANDED_TEXT_AD Il s'agit d'une annonce textuelle agrandie.
CALL_ONLY_AD L'annonce est une annonce Appel uniquement.
EXPANDED_DYNAMIC_SEARCH_AD L'annonce est une annonce dynamique agrandie du Réseau de Recherche.
HOTEL_AD L'annonce est une annonce d'hôtel.
SHOPPING_SMART_AD Il s'agit d'une annonce Shopping intelligente.
SHOPPING_PRODUCT_AD Il s'agit d'une annonce Shopping standard.
VIDEO_AD L'annonce est une annonce vidéo.
GMAIL_AD Cette annonce est une annonce Gmail.
IMAGE_AD Cette annonce est une annonce illustrée.
RESPONSIVE_SEARCH_AD L'annonce est responsive sur le Réseau de Recherche.
LEGACY_RESPONSIVE_DISPLAY_AD L'annonce est une ancienne annonce display responsive.
APP_AD L'annonce est une annonce pour une application.
LEGACY_APP_INSTALL_AD L'annonce est une ancienne annonce incitant à installer une application.
RESPONSIVE_DISPLAY_AD L'annonce est une annonce display responsive.
LOCAL_AD L'annonce est une annonce locale.
HTML5_UPLOAD_AD L'annonce est une annonce display importée avec le type de produit HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD L'annonce est une annonce display à importer avec l'un des types de produits DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Il s'agit d'une annonce ciblant l'engagement avec une application.
SHOPPING_COMPARISON_LISTING_AD L'annonce est une annonce comparateur de prix Shopping.
VIDEO_BUMPER_AD Annonce vidéo bumper.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Annonce vidéo InStream non désactivable.
VIDEO_OUTSTREAM_AD Annonce vidéo OutStream.
VIDEO_TRUEVIEW_DISCOVERY_AD Annonce vidéo TrueView InDisplay.
VIDEO_TRUEVIEW_IN_STREAM_AD Annonce vidéo TrueView InStream.
VIDEO_RESPONSIVE_AD Annonce vidéo responsive.
SMART_CAMPAIGN_AD Annonce pour une campagne intelligente.
APP_PRE_REGISTRATION_AD Annonce universelle de préinscription à une application.
DISCOVERY_MULTI_ASSET_AD Annonce multi-élément Discovery.
TRAVEL_AD Annonce de voyage
DISCOVERY_VIDEO_RESPONSIVE_AD Annonce vidéo responsive pour Discovery.

SearchAds360TextAdInfo

Annonce textuelle Search Ads 360.

Représentation JSON
{
  "headline": string,
  "description1": string,
  "description2": string,
  "displayUrl": string,
  "displayMobileUrl": string,
  "adTrackingId": string
}
Champs
headline

string

Titre de l'annonce.

description1

string

Première ligne de la description de l'annonce.

description2

string

Deuxième ligne de description de l'annonce.

displayUrl

string

URL de l'annonce à afficher

displayMobileUrl

string

URL mobile affichée de l'annonce.

adTrackingId

string (int64 format)

ID de suivi de l'annonce.

SearchAds360ExpandedTextAdInfo

Annonce textuelle agrandie Search Ads 360.

Représentation JSON
{
  "headline": string,
  "headline2": string,
  "headline3": string,
  "description1": string,
  "description2": string,
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Champs
headline

string

Titre de l'annonce.

headline2

string

Deuxième titre de l'annonce.

headline3

string

Troisième titre de l'annonce.

description1

string

Première ligne de la description de l'annonce.

description2

string

Deuxième ligne de description de l'annonce.

path1

string

Texte ajouté à l'URL visible générée automatiquement avec un délimiteur.

path2

string

Texte ajouté au chemin 1 avec un délimiteur.

adTrackingId

string (int64 format)

ID de suivi de l'annonce.

SearchAds360ResponsiveSearchAdInfo

Annonce responsive sur le Réseau de Recherche Search Ads 360.

Représentation JSON
{
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Champs
path1

string

Texte ajouté à l'URL visible générée automatiquement avec un délimiteur.

path2

string

Texte ajouté au chemin 1 avec un délimiteur.

adTrackingId

string (int64 format)

ID de suivi de l'annonce.

SearchAds360ProductAdInfo

Ce type ne comporte aucun champ.

Annonce produit Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Annonce dynamique agrandie du Réseau de Recherche.

Représentation JSON
{
  "description1": string,
  "description2": string,
  "adTrackingId": string
}
Champs
description1

string

Première ligne de la description de l'annonce.

description2

string

Deuxième ligne de description de l'annonce.

adTrackingId

string (int64 format)

ID de suivi de l'annonce.

AdGroupAdEngineStatus

Énumère les états du moteur GroupAd.

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

Obsolète. Ne pas utiliser.

AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu: la création n'a pas été approuvée.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu: URL mobile en cours d'examen.
AD_GROUP_AD_PARTIALLY_INVALID Baidu: la création n'est pas valide sur les appareils mobiles, mais elle est valide sur les ordinateurs.
AD_GROUP_AD_TO_BE_ACTIVATED Baidu: la création est prête à être activée.
AD_GROUP_AD_NOT_REVIEWED Baidu: la création n'a pas été examinée.
AD_GROUP_AD_ON_HOLD

Obsolète. Ne pas utiliser. Utilisé précédemment par Gemini

AD_GROUP_AD_PAUSED La création a été mise en veille.
AD_GROUP_AD_REMOVED La création a été supprimée.
AD_GROUP_AD_PENDING_REVIEW La création est en attente d'examen.
AD_GROUP_AD_UNDER_REVIEW La création est en cours d'examen.
AD_GROUP_AD_APPROVED La création a été approuvée.
AD_GROUP_AD_DISAPPROVED La création a été refusée.
AD_GROUP_AD_SERVING La création est en cours de diffusion.
AD_GROUP_AD_ACCOUNT_PAUSED La création a été mise en veille, car le compte a été mis en veille.
AD_GROUP_AD_CAMPAIGN_PAUSED La création a été mise en veille, car la campagne a été mise en veille.
AD_GROUP_AD_AD_GROUP_PAUSED La création a été mise en veille, car le groupe d'annonces a été mis en veille.

AdGroupAdLabel

Relation entre une annonce d'un groupe d'annonces et un libellé.

Représentation JSON
{
  "resourceName": string,
  "adGroupAd": string,
  "label": string
}
Champs
resourceName

string

Nom de ressource du libellé d'annonce du groupe d'annonces. Les noms des ressources de libellé d'annonce du groupe d'annonces se présentent comme suit: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}

adGroupAd

string

Annonce du groupe d'annonces à laquelle le libellé est associé.

label

string

Libellé attribué à l'annonce du groupe d'annonces.

AdGroupAsset

Association entre un groupe d'annonces et un composant.

Représentation JSON
{
  "resourceName": string,
  "adGroup": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Champs
resourceName

string

Nom de ressource du composant du groupe d'annonces. Les noms de ressources GroupAsset se présentent comme suit:

customers/{customerId}/adGroupAssets/{ad_group_id}~{assetId}~{fieldType}

adGroup

string

Obligatoire. Groupe d'annonces auquel l'élément est associé.

asset

string

Obligatoire. L'élément associé au groupe d'annonces.

status

enum (AssetLinkStatus)

État du composant du groupe d'annonces.

AssetLinkStatus

Énumération décrivant les états d'un lien d'élément.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED Le lien vers l'asset est activé.
REMOVED Le lien vers l'élément a été supprimé.
PAUSED Le lien vers l'asset est en veille.

AdGroupAssetSet

Un groupe d'annonces et un ensemble de composants sont associés. La création d'un objet GroupAssetSet permet d'associer un ensemble de composants à un groupe d'annonces.

Représentation JSON
{
  "resourceName": string,
  "adGroup": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Champs
resourceName

string

Nom de ressource de l'ensemble de composants du groupe d'annonces. Les noms de ressources de l'ensemble de composants d'un groupe d'annonces se présentent comme suit:

customers/{customerId}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

adGroup

string

Groupe d'annonces auquel cet ensemble de composants est associé.

assetSet

string

Ensemble de composants associé au groupe d'annonces.

status

enum (AssetSetLinkStatus)

État de l'ensemble de composants du groupe d'annonces. Lecture seule.

AssetSetLinkStatus

Les états possibles de l'association entre l'ensemble d'assets et son conteneur.

Enums
UNSPECIFIED L'état n'a pas été spécifié.
UNKNOWN La valeur reçue n'est pas connue dans cette version. Il s'agit d'une valeur de réponse uniquement.
ENABLED L'association entre l'ensemble d'assets et son conteneur est activée.
REMOVED L'ensemble d'assets n'est plus associé à son conteneur.

AdGroupAudienceView

Vue d'audience d'un groupe d'annonces. Elles incluent les données de performances issues des centres d'intérêt et des listes de remarketing pour les annonces sur les Réseaux Display et YouTube, et les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), cumulées au niveau de l'audience.

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

string

Nom de ressource de la vue d'audience du groupe d'annonces. Le nom des ressources de vue d'audience d'un groupe d'annonces se présente sous la forme suivante:

customers/{customerId}/adGroupAudienceViews/{ad_group_id}~{criterionId}

AdGroupBidModifier

Représente un modificateur d'enchères de groupe d'annonces.

Représentation JSON
{
  "resourceName": string,
  "bidModifier": number,

  // Union field criterion can be only one of the following:
  "device": {
    object (DeviceInfo)
  }
  // End of list of possible types for union field criterion.
}
Champs
resourceName

string

Nom de ressource du modificateur d'enchères de groupe d'annonces. Les noms de ressources du modificateur d'enchères de groupe d'annonces se présentent comme suit:

customers/{customerId}/adGroupBidModifiers/{ad_group_id}~{criterionId}

bidModifier

number

Modificateur de l'enchère lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. La plage est de 1,0 à 6,0 pour PreferredContent. Indiquez 0 pour désactiver un type d'appareil.

Champ d'union criterion. Critère de ce modificateur d'enchère de groupe d'annonces.

Obligatoire pour les opérations de création à partir de la version 5. criterion ne peut être qu'un des éléments suivants :

device

object (DeviceInfo)

Critère d'appareil.

DeviceInfo

Critère d'appareil.

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

enum (Device)

Type d'appareil.

Appareil

Énumère les appareils Google Ads disponibles pour le ciblage.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
MOBILE Mobiles dotés d'un navigateur Internet complet
TABLET Tablettes dotées d'un navigateur Internet complet
DESKTOP Ordinateurs.
CONNECTED_TV Smart TV et consoles de jeu.
OTHER Autres types d'appareils

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,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "listingGroup": {
    object (ListingGroupInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "location": {
    object (LocationInfo)
  }
  // End of list of possible types for union field criterion.
}
Champs
resourceName

string

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/{ad_group_id}~{criterionId}

creationTime

string

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

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)

Informations concernant la qualité du critère.

type

enum (CriterionType)

Type du critère.

labels[]

string

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

positionEstimates

object (PositionEstimates)

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.

engineId

string

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 "adGroupCritère.criterion_id".

lastModifiedTime

string

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

criterionId

string (int64 format)

ID du critère.

adGroup

string

Groupe d'annonces auquel appartient le critère.

negative

boolean

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

effectiveCpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupCriterionEngineStatus)

État du moteur pour le critère de groupe d'annonces.

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)

Mot clé.

listingGroup

object (ListingGroupInfo)

Groupe de fiches.

ageRange

object (AgeRangeInfo)

Tranche d'âge.

gender

object (GenderInfo)

Gender.

userList

object (UserListInfo)

Liste d'utilisateurs.

webpage

object (WebpageInfo)

Page Web

location

object (LocationInfo)

Localisation.

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
{
  "qualityScore": integer
}
Champs
qualityScore

integer

Le niveau de qualité.

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

CriterionType

Énumération décrivant les types de critères possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
KEYWORD Mot clé (par exemple, "croisière sur mars").
PLACEMENT Emplacement (ou site Web), par exemple "www.fleurs4vente.com"
MOBILE_APP_CATEGORY Catégories d'applications mobiles à cibler.
MOBILE_APPLICATION Applications mobiles à cibler.
DEVICE Appareils à cibler.
LOCATION Zones géographiques à cibler.
LISTING_GROUP Liste des groupes à cibler.
AD_SCHEDULE Calendrier de diffusion des annonces.
AGE_RANGE Tranche d'âge.
GENDER Gender.
INCOME_RANGE Plage de revenus
PARENTAL_STATUS Statut parental.
YOUTUBE_VIDEO Vidéo YouTube.
YOUTUBE_CHANNEL Chaîne YouTube.
USER_LIST Liste d'utilisateurs.
PROXIMITY Proximité.
TOPIC Un thème cible sur le Réseau Display (par exemple, "Animaux et animaux de compagnie").
LISTING_SCOPE Champ d'application de la liste à cibler.
LANGUAGE HashiCorp.
IP_BLOCK IpBlock.
CONTENT_LABEL Libellé de contenu pour l'exclusion de catégories.
CARRIER Opérateur.
USER_INTEREST Catégorie qui intéresse l'utilisateur.
WEBPAGE Critère de page Web pour les annonces dynamiques du Réseau de Recherche.
OPERATING_SYSTEM_VERSION La version du système d'exploitation.
APP_PAYMENT_MODEL Modèle de paiement de l'application.
MOBILE_DEVICE Appareil mobile.
CUSTOM_AFFINITY Affinité personnalisée.
CUSTOM_INTENT Intention personnalisée
LOCATION_GROUP Groupe de zones géographiques.
CUSTOM_AUDIENCE Audience personnalisée
COMBINED_AUDIENCE Audience combinée
KEYWORD_THEME Thème de mot clé des campagnes intelligentes
AUDIENCE Audience
LOCAL_SERVICE_ID ID du service Annonces Local Services.
BRAND Marque
BRAND_LIST Liste de marques
LIFE_EVENT Événement de la vie

PositionEstimates

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

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

string (int64 format)

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.

AdGroupCriterionEngineStatus

Énumère les états du moteur intégré.

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

Obsolète. Ne pas utiliser.

AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: l'enchère ou la qualité sont trop faibles pour être affichées.
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: mis en veille par Baidu en raison du faible volume de recherche
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL mobile en cours d'examen.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: la page de destination d'un appareil n'est pas valide, tandis que celle de l'autre appareil est valide.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: le mot clé a été créé et mis en veille par l'équipe de gestion du compte Baidu. Vous pouvez maintenant l'activer.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: en cours d'examen par l'équipe Baidu. Gemini: critère en cours d'examen.
AD_GROUP_CRITERION_NOT_REVIEWED Baidu: critère à examiner.
AD_GROUP_CRITERION_ON_HOLD

Obsolète. Ne pas utiliser. Utilisé précédemment par Gemini

AD_GROUP_CRITERION_PENDING_REVIEW Y!J : critère en attente d'examen
AD_GROUP_CRITERION_PAUSED Le critère a été mis en veille.
AD_GROUP_CRITERION_REMOVED Le critère a été supprimé.
AD_GROUP_CRITERION_APPROVED Le critère a été approuvé.
AD_GROUP_CRITERION_DISAPPROVED Le critère a été refusé.
AD_GROUP_CRITERION_SERVING Le critère est actif et diffusé.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Le critère a été mis en veille, car le compte a été mis en veille.

KeywordInfo

Critère de mot clé.

Représentation JSON
{
  "matchType": enum (KeywordMatchType),
  "text": string
}
Champs
matchType

enum (KeywordMatchType)

Type de correspondance du mot clé.

text

string

Texte du mot clé (au maximum 80 caractères et 10 mots).

KeywordMatchType

Types de correspondance des mots clés possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
EXACT Mot clé exact
PHRASE Expression exacte.
BROAD Requête large.

ListingGroupInfo

Critère de groupe de fiches.

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

enum (ListingGroupType)

Type du 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.

AgeRangeInfo

Critère de tranche d'âge.

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

enum (AgeRangeType)

Type de tranche d'âge.

AgeRangeType

Type de tranches d'âge démographiques (par exemple, entre 18 et 24 ans).

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AGE_RANGE_18_24 Entre 18 et 24 ans
AGE_RANGE_25_34 Entre 25 et 34 ans
AGE_RANGE_35_44 Entre 35 et 44 ans
AGE_RANGE_45_54 Entre 45 et 54 ans
AGE_RANGE_55_64 Entre 55 et 64 ans
AGE_RANGE_65_UP 65 ans et plus.
AGE_RANGE_UNDETERMINED Tranche d'âge indéterminée.

GenderInfo

Critère de genre.

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

enum (GenderType)

Type de genre.

GenderType

Type de genre démographique (par exemple, femme).

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
MALE Homme.
FEMALE Une femme.
UNDETERMINED Genre indéterminé.

UserListInfo

Un critère de liste d'utilisateurs. Représente une liste d'utilisateurs définie par l'annonceur à cibler.

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

string

Nom de laressource de la liste d'utilisateurs.

WebpageInfo

Représente un critère de ciblage des pages Web du site Web d'un annonceur.

Représentation JSON
{
  "conditions": [
    {
      object (WebpageConditionInfo)
    }
  ],
  "coveragePercentage": number,
  "criterionName": string
}
Champs
conditions[]

object (WebpageConditionInfo)

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.

coveragePercentage

number

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.

criterionName

string

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 associés à ce type de paramètres.

Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.

WebpageConditionInfo

Expression logique permettant de cibler les pages Web du site Web d'un annonceur.

Représentation JSON
{
  "operand": enum (WebpageConditionOperand),
  "operator": enum (WebpageConditionOperator),
  "argument": string
}
Champs
operand

enum (WebpageConditionOperand)

Opérande de la condition de ciblage de page Web.

operator

enum (WebpageConditionOperator)

Opérateur de la condition de ciblage de la page Web.

argument

string

Argument de la condition de ciblage de la page Web.

WebpageConditionOperand

Opérande de condition de page Web dans le critère de page Web.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
URL Opérande représentant une condition de ciblage par URL de page Web.
CATEGORY Opérande représentant une condition de ciblage par catégorie de page Web.
PAGE_TITLE Opérande représentant une condition de ciblage par titre de page Web.
PAGE_CONTENT Opérande représentant une condition de ciblage de contenu de page Web.
CUSTOM_LABEL Opérande représentant une condition de ciblage par étiquette personnalisée de page Web.

WebpageConditionOperator

Opérateur de condition de page Web dans le critère de page Web.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
EQUALS La condition Web de l'argument est égale à la condition Web comparée.
CONTAINS L'argument "condition Web" fait partie de la condition Web comparée.

LocationInfo

Un critère géographique.

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

string

Nom de la ressource constante de ciblage géographique.

AdGroupCriterionLabel

Relation entre un critère de groupe d'annonces et un libellé.

Représentation JSON
{
  "resourceName": string,
  "adGroupCriterion": string,
  "label": string
}
Champs
resourceName

string

Nom de ressource du libellé du critère de groupe d'annonces. Les noms de ressources de libellé du critère de groupe d'annonces ont le format suivant: customers/{customerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}

adGroupCriterion

string

Critère du groupe d'annonces auquel le libellé est associé.

label

string

Libellé attribué au critère du groupe d'annonces.

AdGroupLabel

Relation entre un groupe d'annonces et un libellé.

Représentation JSON
{
  "resourceName": string,
  "adGroup": string,
  "label": string
}
Champs
resourceName

string

Nom de ressource du libellé du groupe d'annonces. Les noms des ressources de libellé du groupe d'annonces ont le format suivant: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}

adGroup

string

Groupe d'annonces auquel le libellé est associé.

label

string

Libellé attribué au groupe d'annonces.

AgeRangeView

Vue par tranche d'âge.

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

string

Nom de ressource de la vue de tranche d'âge. Le nom des ressources de la vue par tranche d'âge se présente sous la forme suivante:

customers/{customerId}/ageRangeViews/{ad_group_id}~{criterionId}

Élément

Le composant est une partie d'une annonce qui peut être partagée entre plusieurs annonces. Il peut s'agir d'une image (ImageAsset), d'une vidéo (YouTubeVideoAsset), etc. Les assets sont immuables et ne peuvent pas être supprimés. Pour arrêter la diffusion d'un composant, supprimez-le de l'entité qui l'utilise.

Représentation JSON
{
  "resourceName": string,
  "type": enum (AssetType),
  "finalUrls": [
    string
  ],
  "status": enum (AssetStatus),
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "engineStatus": enum (AssetEngineStatus),

  // Union field asset_data can be only one of the following:
  "youtubeVideoAsset": {
    object (YoutubeVideoAsset)
  },
  "imageAsset": {
    object (ImageAsset)
  },
  "textAsset": {
    object (TextAsset)
  },
  "calloutAsset": {
    object (UnifiedCalloutAsset)
  },
  "sitelinkAsset": {
    object (UnifiedSitelinkAsset)
  },
  "pageFeedAsset": {
    object (UnifiedPageFeedAsset)
  },
  "mobileAppAsset": {
    object (MobileAppAsset)
  },
  "callAsset": {
    object (UnifiedCallAsset)
  },
  "callToActionAsset": {
    object (CallToActionAsset)
  },
  "locationAsset": {
    object (UnifiedLocationAsset)
  }
  // End of list of possible types for union field asset_data.
}
Champs
resourceName

string

Nom de ressource de l'élément. Les noms de ressources de l'asset se présentent sous la forme suivante:

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Type de l'élément.

finalUrls[]

string

Liste des URL finales possibles après toutes les redirections interdomaines.

status

enum (AssetStatus)

État de l'élément.

creationTime

string

Horodatage lors de la création de cette annonce. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

lastModifiedTime

string

Date et heure de la dernière modification de cet élément. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

id

string (int64 format)

ID de l'élément.

name

string

Nom facultatif de l'élément.

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

État d'un élément dans le moteur.

Champ d'union asset_data. Type spécifique de l'élément. asset_data ne peut être qu'un des éléments suivants :
youtubeVideoAsset

object (YoutubeVideoAsset)

Asset vidéo YouTube.

imageAsset

object (ImageAsset)

Un composant Image.

textAsset

object (TextAsset)

Un composant texte.

calloutAsset

object (UnifiedCalloutAsset)

Un composant Accroche unifié.

pageFeedAsset

object (UnifiedPageFeedAsset)

Un élément de flux de pages unifié.

mobileAppAsset

object (MobileAppAsset)

Un composant Application mobile.

callAsset

object (UnifiedCallAsset)

Un composant Appel unifié.

callToActionAsset

object (CallToActionAsset)

Un composant Incitation à l'action.

locationAsset

object (UnifiedLocationAsset)

Un composant Lieu unifié.

AssetType

Énumération décrivant les types d'éléments possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
YOUTUBE_VIDEO asset vidéo YouTube.
MEDIA_BUNDLE Élément du kit média.
IMAGE Composant Image.
TEXT Composant texte.
LEAD_FORM Composant Formulaire pour prospects.
BOOK_ON_GOOGLE Élément Réserver sur Google.
PROMOTION Composant Promotion.
CALLOUT Composant Accroche.
STRUCTURED_SNIPPET Composant Extrait structuré.
PAGE_FEED Asset de flux de pages.
DYNAMIC_EDUCATION Asset dynamique sur l'enseignement.
MOBILE_APP Composant Application mobile.
HOTEL_CALLOUT Composant Accroche pour hôtel.
CALL Composant Appel.
PRICE Composant Prix.
CALL_TO_ACTION Composant Incitation à l'action.
DYNAMIC_REAL_ESTATE Asset immobilier dynamique.
DYNAMIC_CUSTOM Asset personnalisé dynamique.
DYNAMIC_HOTELS_AND_RENTALS Asset dynamique pour les hôtels et les locations.
DYNAMIC_FLIGHTS Asset dynamique sur les vols.
DYNAMIC_TRAVEL Asset dynamique sur les voyages.
DYNAMIC_LOCAL Asset local dynamique.
DYNAMIC_JOBS Asset dynamique "Emplois".
LOCATION Composant Lieu.
HOTEL_PROPERTY Composant d'établissement hôtelier.

AssetStatus

États possibles d'un composant.

Enums
UNSPECIFIED L'état n'a pas été spécifié.
UNKNOWN La valeur reçue n'est pas connue dans cette version. Il s'agit d'une valeur de réponse uniquement.
ENABLED Le composant est activé.
REMOVED Le composant est supprimé.
ARCHIVED L'asset est archivé.
PENDING_SYSTEM_GENERATED Le composant est généré par le système en attente d'examen par l'utilisateur.

AssetEngineStatus

Identifiant suivant = 11

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SERVING Le composant est actif.
SERVING_LIMITED Le composant est actif (diffusion limitée).
DISAPPROVED Le composant a été refusé (non éligible).
DISABLED L'asset est inactif (en attente).
REMOVED Le composant a été supprimé.

YoutubeVideoAsset

Un élément YouTube.

Représentation JSON
{
  "youtubeVideoTitle": string,
  "youtubeVideoId": string
}
Champs
youtubeVideoTitle

string

Titre de la vidéo YouTube.

youtubeVideoId

string

ID vidéo YouTube Il s'agit de la valeur de la chaîne de 11 caractères utilisée dans l'URL de la vidéo YouTube.

ImageAsset

Un composant Image.

Représentation JSON
{
  "mimeType": enum (MimeType),
  "fullSize": {
    object (ImageDimension)
  },
  "fileSize": string
}
Champs
mimeType

enum (MimeType)

Type MIME du composant Image.

fullSize

object (ImageDimension)

Métadonnées de cette image dans leur taille d'origine.

fileSize

string (int64 format)

Taille du fichier du composant Image en octets.

MimeType

Type MIME

Enums
UNSPECIFIED Le type MIME n'a pas été spécifié.
UNKNOWN

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

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

IMAGE_JPEG Type MIME de l'image/jpeg.
IMAGE_GIF Type MIME de l'image ou du GIF.
IMAGE_PNG Type MIME de l'image/png.
FLASH Type MIME de l'application/x-shockwave-flash.
TEXT_HTML Type MIME de text/html.
PDF Type MIME de l'application/pdf.
MSWORD Type MIME de l'application/msword.
MSEXCEL Type MIME de l'application application/vnd.ms-excel.
RTF Type MIME de l'application/rtf.
AUDIO_WAV Type MIME de l'audio/wav.
AUDIO_MP3 Type MIME de l'audio/mp3.
HTML5_AD_ZIP Type MIME de l'application application/x-html5-ad-zip.

ImageDimension

Métadonnées d'une image dans une certaine taille, originale ou redimensionnée.

Représentation JSON
{
  "heightPixels": string,
  "widthPixels": string,
  "url": string
}
Champs
heightPixels

string (int64 format)

Hauteur de l'image.

widthPixels

string (int64 format)

Largeur de l'image.

url

string

URL qui renvoie l'image avec cette hauteur et cette largeur.

TextAsset

Un composant texte.

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

string

Contenu textuel de l'asset texte.

UnifiedCalloutAsset

Un composant Accroche unifié.

Représentation JSON
{
  "calloutText": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "useSearcherTimeZone": boolean
}
Champs
calloutText

string

Texte de l'accroche. La longueur de cette chaîne doit être comprise entre 1 et 25, inclus.

startDate

string

Date de début à laquelle cet élément est effectif et peut commencer à être diffusé, au format aaaa-MM-jj.

endDate

string

Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.

adScheduleTargets[]

object (AdScheduleInfo)

Liste des calendriers sans chevauchement spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Vous pouvez programmer jusqu'à 6 programmations par jour, soit 42 au total.

useSearcherTimeZone

boolean

Indique si l'élément doit s'afficher dans le fuseau horaire de l'utilisateur de la recherche. S'applique aux annonces Microsoft.

AdScheduleInfo

Représente un critère AdSchedule.

Le calendrier de diffusion des annonces correspond au jour de la semaine et à l'intervalle de temps au cours duquel les annonces seront diffusées.

Vous ne pouvez pas ajouter plus de six calendriers de diffusion pour une même journée.

Représentation JSON
{
  "startMinute": enum (MinuteOfHour),
  "endMinute": enum (MinuteOfHour),
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer
}
Champs
startMinute

enum (MinuteOfHour)

Minutes après l'heure de début à laquelle la programmation commence.

Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.

endMinute

enum (MinuteOfHour)

Minutes après l'heure de fin à laquelle la planification se termine. La planification n'inclut pas la minute de fin.

Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.

dayOfWeek

enum (DayOfWeek)

Jour de la semaine auquel le calendrier s'applique.

Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.

startHour

integer

Heure de début, au format 24 heures. Ce champ doit contenir une valeur comprise entre 0 et 23 inclus.

Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.

endHour

integer

Heure de fin, au format 24 heures. Le chiffre 24 indique la fin de la journée. Ce champ doit contenir une valeur comprise entre 0 et 24 inclus.

Ce champ est obligatoire pour les opérations CREATE et est interdit sur les opérations UPDATE.

MinuteOfHour

Énumérations de quarts d'heure. Par exemple, « FIFTEEN »

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
ZERO 0 minute après l'heure.
FIFTEEN Quinze minutes après l'heure.
THIRTY 30 minutes après l'heure.
FORTY_FIVE Quarante-cinq minutes après l'heure.

DayOfWeek

Énumère les jours de la semaine, par exemple "Monday".

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
MONDAY lundi.
TUESDAY mardi.
WEDNESDAY mercredi.
THURSDAY jeudi.
FRIDAY Vendredi
SATURDAY samedi).
SUNDAY dimanche.

UnifiedSitelinkAsset

Un composant Lien annexe unifié.

Représentation JSON
{
  "linkText": string,
  "description1": string,
  "description2": string,
  "startDate": string,
  "endDate": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "trackingId": string,
  "useSearcherTimeZone": boolean,
  "mobilePreferred": boolean
}
Champs
description1

string

Première ligne de la description du lien annexe. Si ce paramètre est défini, la longueur doit être comprise entre 1 et 35 inclus, et la valeur description2 doit également être définie.

description2

string

Deuxième ligne de description du lien annexe. Si ce paramètre est défini, la longueur doit être comprise entre 1 et 35 inclus, et la valeur description1 doit également être définie.

startDate

string

Date de début à laquelle cet élément est effectif et peut commencer à être diffusé, au format aaaa-MM-jj.

endDate

string

Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.

adScheduleTargets[]

object (AdScheduleInfo)

Liste des calendriers sans chevauchement spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Vous pouvez programmer jusqu'à 6 programmations par jour, soit 42 au total.

trackingId

string (int64 format)

ID utilisé pour suivre les clics du composant Lien annexe. Il s'agit d'un compte Yahoo! Japan uniquement.

useSearcherTimeZone

boolean

Indique si le composant Lien annexe doit être affiché dans le fuseau horaire de l'utilisateur du Réseau de Recherche. S'applique aux annonces Microsoft.

mobilePreferred

boolean

Indique si la préférence d'affichage du composant Lien annexe sur les appareils mobiles est définie. S'applique aux annonces Microsoft.

UnifiedPageFeedAsset

Un élément de flux de pages unifié.

Représentation JSON
{
  "pageUrl": string,
  "labels": [
    string
  ]
}
Champs
pageUrl

string

Page Web que les annonceurs souhaitent cibler.

labels[]

string

Libellés utilisés pour regrouper les URL des pages.

MobileAppAsset

Asset représentant une application mobile.

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

string

Obligatoire. Chaîne identifiant de façon unique une application mobile. Il ne doit contenir que l'ID natif de la plate-forme, comme "com.android.ebay" pour Android ou "12345689" pour iOS.

appStore

enum (MobileAppVendor)

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

MobileAppVendor

Le type de fournisseur d'applications mobiles

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
APPLE_APP_STORE Fournisseur d'applications mobiles pour l'App Store d'Apple.
GOOGLE_APP_STORE Fournisseur d'applications mobiles pour la plate-forme de téléchargement d'applications Google.

UnifiedCallAsset

Un composant Appel unifié.

Représentation JSON
{
  "countryCode": string,
  "phoneNumber": string,
  "callConversionReportingState": enum (CallConversionReportingState),
  "callConversionAction": string,
  "adScheduleTargets": [
    {
      object (AdScheduleInfo)
    }
  ],
  "callOnly": boolean,
  "callTrackingEnabled": boolean,
  "useSearcherTimeZone": boolean,
  "startDate": string,
  "endDate": string
}
Champs
countryCode

string

Code pays à deux lettres correspondant au numéro de téléphone. Exemples: "US", "us".

phoneNumber

string

Numéro de téléphone brut de l'annonceur. Exemples: "1234567890", "(123)456-7890"

callConversionReportingState

enum (CallConversionReportingState)

Indique si ce composant Appel doit utiliser son propre paramètre de conversion par appel, suivre le paramètre au niveau du compte ou désactiver la conversion par appel.

callConversionAction

string

Action de conversion à laquelle attribuer une conversion par appel. Si cette règle n'est pas configurée, l'action de conversion par défaut est utilisée. Ce champ n'a d'effet que si callConversionReportingState est défini sur USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION.

adScheduleTargets[]

object (AdScheduleInfo)

Liste des calendriers sans chevauchement spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Vous pouvez programmer jusqu'à 6 programmations par jour, soit 42 au total.

callOnly

boolean

Indique si l'appel n'affiche que le numéro de téléphone, sans lien vers le site Web. S'applique aux annonces Microsoft.

callTrackingEnabled

boolean

Activer ou non l'appel dans le cadre du suivi des appels. S'applique aux annonces Microsoft.

useSearcherTimeZone

boolean

Indique si l'extension d'appel doit s'afficher dans le fuseau horaire de l'utilisateur du Réseau de Recherche. S'applique aux annonces Microsoft.

startDate

string

Date de début à laquelle cet élément est effectif et peut commencer à être diffusé, au format aaaa-MM-jj.

endDate

string

Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.

CallConversionReportingState

Types de données possibles pour un état d'action de conversion par appel.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DISABLED L'action de conversion par appel est désactivée.
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION L'action de conversion par appel utilisera le type de conversion par appel défini au niveau du compte.
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION L'action de conversion par appel utilisera le type de conversion par appel défini au niveau de la ressource (annonces Appel uniquement/extensions d'appel).

CallToActionAsset

Un composant Incitation à l'action.

Représentation JSON
{
  "callToAction": enum (CallToActionType)
}
Champs
callToAction

enum (CallToActionType)

Incitation à l'action.

CallToActionType

Énumération décrivant les différents types d'incitation à l'action.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
LEARN_MORE Le type d'incitation à l'action est "En savoir plus".
GET_QUOTE Le type d'incitation à l'action est "Obtenir un devis".
APPLY_NOW Le type d'incitation à l'action est "Appliquer".
SIGN_UP Le type d'incitation à l'action est "S'inscrire".
CONTACT_US Le type d'incitation à l'action est "Nous contacter".
SUBSCRIBE Le type d'incitation à l'action est "S'abonner".
DOWNLOAD Le type d'incitation à l'action est "Téléchargement".
BOOK_NOW Le type d'incitation à l'action est "Réserver".
SHOP_NOW L'incitation à l'action est de type "Acheter".
BUY_NOW Le type d'incitation à l'action est "Acheter maintenant".
DONATE_NOW L'incitation à l'action est de type "Faire un don".
ORDER_NOW Le type d'incitation à l'action est désormais "commander".
PLAY_NOW L'incitation à l'action est de type "Lire".
SEE_MORE Le type d'incitation à l'action est "Voir plus".
START_NOW Le type d'incitation à l'action est "Commencer maintenant".
VISIT_SITE Le type d'incitation à l'action est "Visiter le site".
WATCH_NOW Le type d'incitation à l'action est "Regarder maintenant".

UnifiedLocationAsset

Un composant Lieu unifié.

Représentation JSON
{
  "placeId": string,
  "businessProfileLocations": [
    {
      object (BusinessProfileLocation)
    }
  ],
  "locationOwnershipType": enum (LocationOwnershipType)
}
Champs
placeId

string

Les ID de lieu identifient de façon unique un lieu dans la base de données Google Places et sur Google Maps. Ce champ est unique pour un numéro client et un type de composant donnés. Pour en savoir plus sur les ID de lieu, consultez la page https://developers.google.com/places/web-service/place-id.

businessProfileLocations[]

object (BusinessProfileLocation)

Liste des établissements pour le client. Il ne s'affiche que si le composant Lieu est synchronisé à partir du compte de fiches d'établissement. Un même compte peut contenir plusieurs fiches d'établissement qui pointent vers le même ID de lieu.

locationOwnershipType

enum (LocationOwnershipType)

Type de propriété de l'établissement. Si le type est BUSINESS_OWNER, l'annonce est diffusée en tant qu'extension de lieu. Si le type est AFFILIÉ, il sera diffusé en tant que lieu affilié.

BusinessProfileLocation

Données sur l'établissement synchronisées depuis le compte de fiches d'établissement associé.

Représentation JSON
{
  "labels": [
    string
  ],
  "storeCode": string,
  "listingId": string
}
Champs
labels[]

string

Libellé spécifié par l'annonceur pour l'établissement dans le compte de fiches d'établissement. Cette opération est synchronisée à partir du compte de fiche d'établissement.

storeCode

string

Code de magasin de la fiche d'établissement associé à cet établissement. Cette opération est synchronisée à partir du compte de fiche d'établissement.

listingId

string (int64 format)

ID de la fiche associée à cette adresse d'établissement. Elle est synchronisée à partir du compte de fiche d'établissement associé.

LocationOwnershipType

Types possibles de propriété d'un établissement.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
BUSINESS_OWNER Propriétaire de l'établissement(ancienne extension de lieu - LE).
AFFILIATE Lieu affilié(extension de lieu tierce - ALE).

AssetGroupAsset

L'élément AssetGroupAsset représente le lien entre un élément et un groupe d'assets. Lorsque vous ajoutez un élément AssetGroupAsset, un élément est associé à un groupe d'éléments.

Représentation JSON
{
  "resourceName": string,
  "assetGroup": string,
  "asset": string,
  "fieldType": enum (AssetFieldType),
  "status": enum (AssetLinkStatus)
}
Champs
resourceName

string

Nom de ressource de l'élément du groupe d'assets. Le nom de la ressource d'élément du groupe d'assets se présente sous la forme suivante:

customers/{customerId}/assetGroupAssets/{asset_group_id}~{assetId}~{fieldType}

assetGroup

string

Groupe d'assets auquel cet asset est associé.

asset

string

Composant associé à ce composant du groupe de composants.

fieldType

enum (AssetFieldType)

Description de l'emplacement de l'asset dans le groupe d'assets. Exemples: TITRE, VIDÉO_YOUTUBE, etc.

status

enum (AssetLinkStatus)

État de l'association entre un composant et un groupe d'assets.

AssetFieldType

Énumération décrivant les emplacements possibles d'un élément.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
HEADLINE Le composant est associé pour être utilisé comme titre.
DESCRIPTION L'élément est associé pour être utilisé comme description.
MANDATORY_AD_TEXT Le lien vers le composant peut être utilisé comme texte d'annonce obligatoire.
MARKETING_IMAGE L'asset est associé pour être utilisé en tant qu'image marketing.
MEDIA_BUNDLE L'élément est associé pour être utilisé en tant que kit média.
YOUTUBE_VIDEO L'élément est associé pour être utilisé en tant que vidéo YouTube.
BOOK_ON_GOOGLE Le composant est associé pour indiquer que l'option "Réserver sur Google" est activée pour une campagne d'hôtel.
LEAD_FORM Le composant est associé afin de pouvoir être utilisé comme extension de formulaire pour prospects.
PROMOTION Le composant est associé pour être utilisé en tant qu'extension de promotion.
CALLOUT Le composant est associé pour être utilisé en tant qu'extension d'accroche.
STRUCTURED_SNIPPET Le composant est associé pour être utilisé en tant qu'extension d'extrait structuré.
MOBILE_APP L'asset est associé pour être utilisé en tant qu'extension d'application pour mobile.
HOTEL_CALLOUT Le composant est associé afin d'être utilisé comme extension d'accroche pour hôtel.
CALL Le composant est associé afin de pouvoir être utilisé comme extension d'appel.
PRICE Le composant est associé pour être utilisé en tant qu'extension de prix.
LONG_HEADLINE L'asset est associé pour servir de titre long.
BUSINESS_NAME Le composant est associé pour être utilisé comme nom d'entreprise.
SQUARE_MARKETING_IMAGE Le lien vers le composant peut être utilisé en tant qu'image marketing carrée.
PORTRAIT_MARKETING_IMAGE Le lien vers l'asset est destiné à être utilisé en tant qu'image marketing en mode portrait.
VIDEO L'élément est associé à un lien permettant d'être utilisé en tant que logo autre que YouTube.
CALL_TO_ACTION_SELECTION Le composant est associé pour permettre de sélectionner une incitation à l'action.
AD_IMAGE Le composant est associé pour permettre de sélectionner une image d'annonce.
HOTEL_PROPERTY Le composant est associé pour être utilisé en tant qu'établissement hôtelier dans une campagne Performance Max pour les objectifs de voyage.

AssetGroupSignal

AssetGroupSignal représente un signal dans un groupe d'assets. L'existence d'un signal indique à la campagne Performance Max qui est la plus susceptible d'effectuer une conversion. Performance Max utilise ce signal pour rechercher de nouvelles personnes ayant une intention similaire ou plus forte afin de générer des conversions sur les Réseaux de Recherche et Display, dans les vidéos, etc.

Représentation JSON
{
  "resourceName": string,
  "assetGroup": string,

  // Union field signal can be only one of the following:
  "audience": {
    object (AudienceInfo)
  }
  // End of list of possible types for union field signal.
}
Champs
resourceName

string

Nom de ressource du signal du groupe d'assets. Le nom de la ressource du signal de groupe d'assets se présente sous la forme suivante:

customers/{customerId}/assetGroupSignals/{asset_group_id}~{signal_id}

assetGroup

string

Groupe d'assets auquel ce signal de groupe d'assets appartient.

Champ d'union signal. Signal du groupe d'assets. signal ne peut être qu'un des éléments suivants :
audience

object (AudienceInfo)

Signal d'audience à utiliser par la campagne Performance Max.

AudienceInfo

Un critère d'audience.

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

string

Nom de la ressource d'audience.

AssetGroupListingGroupFilter

AssetGroupListingGroupFilter représente un nœud d'arborescence de filtre de groupe de fiches dans un groupe d'éléments.

Représentation JSON
{
  "resourceName": string,
  "assetGroup": string,
  "id": string,
  "type": enum (ListingGroupFilterType),
  "vertical": enum (ListingGroupFilterVertical),
  "caseValue": {
    object (ListingGroupFilterDimension)
  },
  "parentListingGroupFilter": string,
  "path": {
    object (ListingGroupFilterDimensionPath)
  }
}
Champs
resourceName

string

Nom de ressource du filtre de groupe de fiches (groupe de composants). Le nom de la ressource de filtre de groupe de fiches (groupe d'assets) se présente sous la forme suivante:

customers/{customerId}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

assetGroup

string

Groupe de composants auquel appartient ce filtre de groupe de fiches de groupes de composants.

id

string (int64 format)

ID du ListingGroupFilter.

type

enum (ListingGroupFilterType)

Type de nœud de filtre de groupe de fiches.

vertical

enum (ListingGroupFilterVertical)

Secteur représenté par l'arborescence de nœuds actuelle. Tous les nœuds de la même arborescence doivent appartenir au même secteur.

caseValue

object (ListingGroupFilterDimension)

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

parentListingGroupFilter

string

Nom de ressource de la subdivision du groupe de fiches parent. Valeur Null pour le nœud de filtre de groupe de fiches racine.

path

object (ListingGroupFilterDimensionPath)

Chemin des dimensions définissant ce filtre de groupe de fiches.

ListingGroupFilterType

Type de filtre de 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 selon certaines dimensions de fiche.
UNIT_INCLUDED Nœud feuille de filtre de groupe de fiches inclus.
UNIT_EXCLUDED Nœud feuille feuille de filtre de groupe de fiches exclus.

ListingGroupFilterVertical

Type de secteur du filtre de groupe de fiches.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SHOPPING Représente le secteur du shopping. Le secteur n'est autorisé que dans les campagnes Performance Max pour le commerce.

ListingGroupFilterDimension

Dimensions de la fiche pour le filtre de groupe de fiches de groupe d'assets.

Représentation JSON
{

  // Union field dimension can be only one of the following:
  "productBiddingCategory": {
    object (ProductBiddingCategory)
  },
  "productBrand": {
    object (ProductBrand)
  },
  "productChannel": {
    object (ProductChannel)
  },
  "productCondition": {
    object (ProductCondition)
  },
  "productCustomAttribute": {
    object (ProductCustomAttribute)
  },
  "productItemId": {
    object (ProductItemId)
  },
  "productType": {
    object (ProductType)
  }
  // End of list of possible types for union field dimension.
}
Champs
Champ d'union dimension. La dimension de l'un des types ci-dessous est toujours présente. dimension ne peut être qu'un des éléments suivants :
productBiddingCategory

object (ProductBiddingCategory)

Catégorie d'enchères d'une offre de produit.

productBrand

object (ProductBrand)

Marque d'une offre de produit.

productChannel

object (ProductChannel)

Localité d'une offre de produit.

productCondition

object (ProductCondition)

État d'une offre de produit.

productCustomAttribute

object (ProductCustomAttribute)

Attribut personnalisé d'une offre de produit.

productItemId

object (ProductItemId)

ID de l'article d'une offre.

productType

object (ProductType)

Type d'offre de produit.

ProductBiddingCategory

Un élément d'une catégorie d'enchères à un certain niveau. Les catégories de premier niveau se situent au niveau 1, les enfants au niveau 2, et ainsi de suite. Nous acceptons actuellement jusqu'à cinq niveaux. L'utilisateur doit spécifier un type de dimension qui indique le niveau de la catégorie. Tous les cas d'une même subdivision doivent avoir le même type de dimension (au niveau de la catégorie).

Représentation JSON
{
  "level": enum (ListingGroupFilterBiddingCategoryLevel),
  "id": string
}
Champs
level

enum (ListingGroupFilterBiddingCategoryLevel)

Indique le niveau de la catégorie dans la taxonomie.

id

string (int64 format)

ID de la catégorie d'enchères de produit.

Cet identifiant équivaut à l'identifiant google_product_category [catégorie_de_produits_google], tel que décrit dans cet article: https://support.google.com/merchants/answer/6324436.

ListingGroupFilterBiddingCategoryLevel

Niveau de la catégorie d'enchères du filtre de groupe de fiches.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
LEVEL1 Niveau 1.
LEVEL2 Niveau 2.
LEVEL3 Niveau 3.
LEVEL4 Niveau 4.
LEVEL5 Niveau 5.

ProductBrand

Marque du produit.

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

string

Valeur de chaîne de la marque du produit.

ProductChannel

Localité d'une offre de produit.

Représentation JSON
{
  "channel": enum (ListingGroupFilterProductChannel)
}
Champs
channel

enum (ListingGroupFilterProductChannel)

Valeur de la localité.

ListingGroupFilterProductChannel

Énumération décrivant la localité d'une offre de produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ONLINE L'article est vendu en ligne.
LOCAL L'article est vendu dans des magasins à proximité.

ProductCondition

État d'une offre de produit.

Représentation JSON
{
  "condition": enum (ListingGroupFilterProductCondition)
}
Champs
condition

enum (ListingGroupFilterProductCondition)

Valeur de la condition.

ListingGroupFilterProductCondition

Énumération décrivant l'état d'une offre de produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
NEW Le produit est neuf.
REFURBISHED Le produit est reconditionné.
USED L'état du produit est utilisé.

ProductCustomAttribute

Attribut personnalisé d'une offre de produit.

Représentation JSON
{
  "index": enum (ListingGroupFilterCustomAttributeIndex),
  "value": string
}
Champs
index

enum (ListingGroupFilterCustomAttributeIndex)

Indique l'index de l'attribut personnalisé.

value

string

Valeur de chaîne de l'attribut personnalisé du produit.

ListingGroupFilterCustomAttributeIndex

Index des attributs des clients.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
INDEX0 Premier attribut personnalisé du filtre de groupe de fiches.
INDEX1 Deuxième attribut personnalisé du filtre de groupe de fiches.
INDEX2 Troisième attribut personnalisé du filtre de groupe de fiches.
INDEX3 Quatrième attribut personnalisé du filtre de groupe de fiches.
INDEX4 Cinquième attribut personnalisé du filtre de groupe de fiches.

ProductItemId

ID de l'article d'une offre.

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

string

Valeur de l'ID.

ProductType

Type d'offre de produit.

Représentation JSON
{
  "level": enum (ListingGroupFilterProductTypeLevel),
  "value": string
}
Champs
level

enum (ListingGroupFilterProductTypeLevel)

Niveau du type.

value

string

Valeur du type.

ListingGroupFilterProductTypeLevel

Énumération décrivant le niveau du type d'une offre de produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
LEVEL1 Niveau 1.
LEVEL2 Niveau 2.
LEVEL3 Niveau 3.
LEVEL4 Niveau 4.
LEVEL5 Niveau 5.

ListingGroupFilterDimensionPath

Chemin définissant les dimensions définissant un filtre de groupe de fiches.

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

object (ListingGroupFilterDimension)

Chemin complet des dimensions via la hiérarchie des filtres de groupe de fiches (à l'exclusion du nœud racine) vers ce filtre de groupe de fiches.

AssetGroupTopCombinationView

Aperçu de l'utilisation de la combinaison de composants d'un groupe d'annonces.

Représentation JSON
{
  "resourceName": string,
  "assetGroupTopCombinations": [
    {
      object (AssetGroupAssetCombinationData)
    }
  ]
}
Champs
resourceName

string

Nom de ressource de la vue de la combinaison la plus performante du groupe d'assets. Les noms des ressources de la vue AssetGroup Top Combination respectent le format suivant : "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Meilleures combinaisons d'éléments diffusés ensemble.

AssetGroupAssetCombinationData

Données sur la combinaison de composants du groupe d'assets

Représentation JSON
{
  "assetCombinationServedAssets": [
    {
      object (AssetUsage)
    }
  ]
}
Champs
assetCombinationServedAssets[]

object (AssetUsage)

Composants diffusés.

AssetUsage

Contient les informations d'utilisation de l'asset.

Représentation JSON
{
  "asset": string,
  "servedAssetFieldType": enum (ServedAssetFieldType)
}
Champs
asset

string

Nom de ressource de l'élément.

servedAssetFieldType

enum (ServedAssetFieldType)

Type de champ de diffusion de l'élément.

ServedAssetFieldType

Types de champs d'éléments possibles.

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.

HEADLINE_1 Le composant est utilisé dans le titre 1.
HEADLINE_2 Le composant est utilisé dans le titre 2.
HEADLINE_3 Le composant est utilisé dans le titre 3.
DESCRIPTION_1 L'élément est utilisé dans la description 1.
DESCRIPTION_2 L'asset est utilisé dans la description 2.
HEADLINE Le composant a été utilisé dans un titre. N'utilisez cette option que si l'annonce ne comporte qu'un seul titre. Sinon, utilisez les énumérations HEADLINE_1, HEADLINE_2 ou HEADLINE_3.
HEADLINE_IN_PORTRAIT L'asset a été utilisé comme titre dans une image en mode portrait.
LONG_HEADLINE L'asset a été utilisé dans un titre long (utilisé dans MultiAssetResponsiveAd).
DESCRIPTION L'asset a été utilisé dans une description. N'utilisez cette option que si l'annonce ne comporte qu'une seule description. Sinon, utilisez les énumérations DESCRIPTION_1 ou DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT L'asset a été utilisé comme description dans une image en mode portrait.
BUSINESS_NAME_IN_PORTRAIT Le composant a été utilisé comme nom de l'entreprise dans une image en mode portrait.
BUSINESS_NAME Le composant a été utilisé comme nom de l'entreprise.
MARKETING_IMAGE L'asset a été utilisé comme image marketing.
MARKETING_IMAGE_IN_PORTRAIT L'asset a été utilisé comme image marketing en image en mode portrait.
SQUARE_MARKETING_IMAGE L'asset a été utilisé comme image marketing carrée.
PORTRAIT_MARKETING_IMAGE L'asset a été utilisé comme image marketing en mode portrait.
CALL_TO_ACTION Le composant a été utilisé comme incitation à l'action.
YOU_TUBE_VIDEO L'élément a été utilisé comme vidéo YouTube.
CALL Ce composant est utilisé pour un appel.
MOBILE_APP Ce composant est utilisé en tant qu'application mobile.
CALLOUT Ce composant est utilisé en tant qu'accroche.
STRUCTURED_SNIPPET Ce composant est utilisé comme extrait structuré.
PRICE Ce composant est utilisé comme prix.
PROMOTION Ce composant est utilisé comme promotion.
AD_IMAGE Ce composant est utilisé en tant qu'image.
LEAD_FORM Le composant est utilisé comme formulaire pour prospects.

AssetGroup

Un groupe d'assets L'élément AssetGroupAsset permet d'associer un élément au groupe d'assets. AssetGroupSignal permet d'associer un signal à un groupe d'assets.

Représentation JSON
{
  "resourceName": string,
  "id": string,
  "campaign": string,
  "name": string,
  "finalUrls": [
    string
  ],
  "finalMobileUrls": [
    string
  ],
  "status": enum (AssetGroupStatus),
  "path1": string,
  "path2": string,
  "adStrength": enum (AdStrength)
}
Champs
resourceName

string

Nom de ressource du groupe d'assets. Le nom des ressources d'un groupe d'assets se présente sous la forme suivante:

customers/{customerId}/assetGroups/{asset_group_id}

id

string (int64 format)

ID du groupe d'assets.

campaign

string

Campagne à laquelle ce groupe de composants est associé. Asset associé au groupe d'assets.

name

string

Obligatoire. Nom du groupe d'assets. Obligatoire. Il doit comporter entre 1 et 128 caractères. Il doit être unique au sein d'une campagne.

finalUrls[]

string

Liste des URL finales après toutes les redirections vers un autre domaine. Dans Performance Max, l'extension peut être appliquée par défaut aux URL, sauf si cette option a été désactivée.

finalMobileUrls[]

string

Une liste des URL finales pour mobile après toutes les redirections vers un autre domaine. Dans Performance Max, l'extension peut être appliquée par défaut aux URL, sauf si cette option a été désactivée.

status

enum (AssetGroupStatus)

État du groupe d'assets.

path1

string

Première partie de texte susceptible d'être ajoutée à la fin de l'URL affichée dans l'annonce.

path2

string

Deuxième partie de texte susceptible d'être ajoutée à la fin de l'URL affichée dans l'annonce. Ce champ ne peut être défini que lorsque path1 est défini.

adStrength

enum (AdStrength)

Efficacité globale de l'annonce pour ce groupe de composants.

AssetGroupStatus

États possibles d'un groupe d'assets.

Enums
UNSPECIFIED L'état n'a pas été spécifié.
UNKNOWN La valeur reçue n'est pas connue dans cette version.
ENABLED Le groupe de composants est activé.
PAUSED Le groupe de composants est en veille.
REMOVED Le groupe de composants est supprimé.

AdStrength

Énumération répertoriant les différents points d'efficacité de l'annonce.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
PENDING L'efficacité de l'annonce est actuellement en attente.
NO_ADS Aucune annonce n'a pu être générée.
POOR Faible force.
AVERAGE Force moyenne.
GOOD Bonne force.
EXCELLENT Excellente force.

AssetSetAsset

"AssetSetAsset" correspond au lien entre un asset et un ensemble d'assets. L'ajout d'un élément AssetSetAsset associe un élément à un ensemble d'éléments.

Représentation JSON
{
  "resourceName": string,
  "assetSet": string,
  "asset": string,
  "status": enum (AssetSetAssetStatus)
}
Champs
resourceName

string

Nom de ressource de l'élément de l'ensemble d'assets. Les noms de ressources d'éléments de l'ensemble d'assets se présentent comme suit:

customers/{customerId}/assetSetAssets/{asset_set_id}~{assetId}

assetSet

string

Ensemble d'éléments auquel cet élément d'ensemble d'éléments est associé.

asset

string

Élément auquel l'ensemble d'éléments est associé.

status

enum (AssetSetAssetStatus)

État du composant de l'ensemble d'assets. Lecture seule.

AssetSetAssetStatus

États possibles d'un composant Ensemble de composants.

Enums
UNSPECIFIED L'état n'a pas été spécifié.
UNKNOWN La valeur reçue n'est pas connue dans cette version. Il s'agit d'une valeur de réponse uniquement.
ENABLED L'asset de l'ensemble de composants est activé.
REMOVED L'asset de l'ensemble de composants est supprimé.

AssetSet

Ensemble d'éléments représentant un ensemble d'éléments. Utilisez AssetSetAsset pour associer un élément à l'ensemble de composants.

Représentation JSON
{
  "id": string,
  "resourceName": string
}
Champs
id

string (int64 format)

ID de l'ensemble de composants.

resourceName

string

Nom de ressource de l'ensemble de composants. Les noms de ressources de l'ensemble d'éléments se présentent comme suit:

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Une stratégie d'enchères.

Représentation JSON
{
  "resourceName": string,
  "status": enum (BiddingStrategyStatus),
  "type": enum (BiddingStrategyType),
  "currencyCode": string,
  "id": string,
  "name": string,
  "effectiveCurrencyCode": string,
  "campaignCount": string,
  "nonRemovedCampaignCount": string,

  // Union field scheme can be only one of the following:
  "enhancedCpc": {
    object (EnhancedCpc)
  },
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetOutrankShare": {
    object (TargetOutrankShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Champs
resourceName

string

Nom de ressource de la stratégie d'enchères. Les noms des ressources de stratégie d'enchères se présentent de la façon suivante:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

État de la stratégie d'enchères.

Ce champ est en lecture seule.

type

enum (BiddingStrategyType)

Type de stratégie d'enchères. Créez une stratégie d'enchères en définissant le schéma d'enchères.

Ce champ est en lecture seule.

currencyCode

string

Devise utilisée par la stratégie d'enchères (code à trois lettres ISO 4217).

Pour les stratégies d'enchères des clients administrateur, cette devise peut être définie lors de la création et sera définie par défaut sur celle du client administrateur. Pour les clients diffusant des annonces, vous ne pouvez pas définir ce champ. Toutes les stratégies définies pour un client actif utilisent implicitement sa devise. Dans tous les cas, le champ "effectiveCurrencyCode" renvoie la devise utilisée par la stratégie.

id

string (int64 format)

ID de la stratégie d'enchères.

name

string

Nom de la stratégie d'enchères. Toutes les stratégies d'enchères d'un compte doivent être nommées séparément.

La longueur de cette chaîne doit être comprise entre 1 et 255 caractères inclus, en octets UTF-8 (tronquée).

effectiveCurrencyCode

string

Devise utilisée par la stratégie d'enchères (code à trois lettres ISO 4217).

Pour les stratégies d'enchères chez les clients administrateur, il s'agit de la devise définie par l'annonceur lors de la création de la stratégie. Pour diffuser des annonces auprès des clients, il s'agit du code de devise du client.

Les métriques de la stratégie d'enchères sont indiquées dans cette devise.

Ce champ est en lecture seule.

campaignCount

string (int64 format)

Nombre de campagnes associées à cette stratégie d'enchères.

Ce champ est en lecture seule.

nonRemovedCampaignCount

string (int64 format)

Nombre de campagnes non supprimées associées à cette stratégie d'enchères.

Ce champ est en lecture seule.

Champ d'union scheme. Système d'enchères.

Vous ne pouvez en définir qu'une seule. scheme ne peut être qu'un des éléments suivants :

enhancedCpc

object (EnhancedCpc)

Il s'agit d'une stratégie d'enchères qui augmente les enchères pour les clics qui semblent plus susceptibles de générer une conversion et les réduit pour les clics qui semblent moins susceptibles de générer une conversion.

maximizeConversionValue

object (MaximizeConversionValue)

Cette stratégie d'enchères automatiques vous permet d'enregistrer la meilleure valeur de conversion possible pour vos campagnes tout en exploitant la totalité de votre budget.

maximizeConversions

object (MaximizeConversions)

Cette stratégie d'enchères automatiques vous permet d'enregistrer le plus grand nombre de conversions possible pour vos campagnes tout en exploitant la totalité de votre budget.

targetCpa

object (TargetCpa)

Il s'agit d'une stratégie d'enchères qui définit vos enchères pour générer un maximum de conversions en fonction du coût par acquisition (CPA) cible que vous spécifiez.

targetImpressionShare

object (TargetImpressionShare)

Stratégie d'enchères qui optimise automatiquement les campagnes en fonction d'un pourcentage d'impressions donné.

targetOutrankShare

object (TargetOutrankShare)

Il s'agit d'une stratégie qui définit les enchères en fonction de la fraction cible des enchères pour laquelle l'annonceur doit surclasser un concurrent spécifique. Ce champ a été abandonné. La création d'une stratégie d'enchères avec ce champ ou l'association de stratégies d'enchères avec ce champ à une campagne échoueront. Les modifications apportées aux stratégies pour lesquelles ce schéma est déjà renseigné sont autorisées.

targetRoas

object (TargetRoas)

Stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant en moyenne un ROAS cible spécifique.

targetSpend

object (TargetSpend)

Il s'agit d'une stratégie d'enchères qui définit vos enchères de sorte que vous enregistriez autant de clics que possible dans les limites de votre budget.

BiddingStrategyStatus

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

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 La stratégie d'enchères est activée.
REMOVED La stratégie d'enchères est supprimée.

BiddingStrategyType

Énumération décrivant les types de stratégies d'enchères possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
COMMISSION Avec la stratégie d'enchères automatiques "Commissions", l'annonceur paie une partie spécifique de la valeur de conversion.
ENHANCED_CPC Le CPC optimisé est une stratégie d'enchères qui augmente les enchères pour les clics qui semblent plus susceptibles de générer une conversion et les réduit pour les clics qui semblent moins susceptibles de générer une conversion.
INVALID Utilisé pour la valeur renvoyée uniquement. Indique qu'une campagne n'a pas de stratégie d'enchères. Cela empêche la diffusion de la campagne. Par exemple, une campagne peut être associée à une stratégie d'enchères administrateur, et le compte de diffusion est ensuite dissocié du compte administrateur. Dans ce cas, la campagne sera automatiquement dissociée de la stratégie d'enchères administrateur, désormais inaccessible, et passera au type de stratégie d'enchères "NON VALIDE".
MANUAL_CPA Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère pour chaque action qu'il spécifie.
MANUAL_CPC Enchères manuelles basées sur les clics, où l'utilisateur paie par clic.
MANUAL_CPM Système d'enchères manuel basé sur les impressions, où l'utilisateur paie pour mille impressions.
MANUAL_CPV Il s'agit d'une stratégie d'enchères qui paie un montant configurable par visionnage de vidéo.
MAXIMIZE_CONVERSIONS Stratégie d'enchères qui maximise automatiquement le nombre de conversions en fonction d'un budget quotidien.
MAXIMIZE_CONVERSION_VALUE Il s'agit d'une stratégie d'enchères automatiques qui définit automatiquement les enchères pour maximiser les revenus tout en dépensant la totalité de votre budget.
PAGE_ONE_PROMOTED Schéma d'enchères sponsorisées de 1re page, qui définit des enchères au CPC max. pour cibler les impressions sur les emplacements sponsorisés de la première ou de la première page sur google.com. Cette valeur d'énumération est obsolète.
PERCENT_CPC Il s'agit de la stratégie d'enchères avec laquelle les enchères ne représentent qu'une fraction du prix annoncé pour un produit ou un service.
TARGET_CPA Le CPA cible est une stratégie d'enchères automatiques qui définit automatiquement vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous spécifiez.
TARGET_CPM Le CPM cible est une stratégie d'enchères automatiques qui définit automatiquement vos enchères afin de générer autant d'impressions que possible pour le coût pour mille impressions (CPM) cible que vous avez défini.
TARGET_IMPRESSION_SHARE Il s'agit d'une stratégie d'enchères automatiques qui définit les enchères de sorte qu'un certain pourcentage d'annonces sur le Réseau de Recherche soit diffusé en haut de la première page (ou d'une autre zone ciblée).
TARGET_OUTRANK_SHARE La stratégie d'enchères "Taux de surclassement cible" définit automatiquement les enchères en fonction de la fraction cible des mises aux enchères pour laquelle l'annonceur doit surclasser un concurrent spécifique. Cette valeur d'énumération est obsolète.
TARGET_ROAS Le ROAS cible est une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant, en moyenne, un ROAS cible spécifique.
TARGET_SPEND L'objectif de dépenses est une stratégie d'enchères automatiques qui définit vos enchères de sorte que vous enregistriez autant de clics que possible dans les limites de votre budget.

EnhancedCpc

Ce type ne comporte aucun champ.

Il s'agit d'une stratégie d'enchères automatiques qui augmente les enchères pour les clics qui semblent plus susceptibles de générer une conversion et les réduit pour les clics qui semblent moins susceptibles de générer une conversion.

Cette stratégie d'enchères est obsolète et ne peut plus être créée. Utilisez ManualCpc avecenhancedCpcEnabled défini sur "true" pour obtenir des fonctionnalités équivalentes.

MaximizeConversionValue

Cette stratégie d'enchères automatiques vous permet d'enregistrer la meilleure valeur de conversion possible pour vos campagnes tout en exploitant la totalité de votre budget.

Représentation JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetRoas": number
}
Champs
cpcBidCeilingMicros

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Non modifiable uniquement pour les stratégies de portefeuille d'enchères.

cpcBidFloorMicros

string (int64 format)

Limite d'enchère minimale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Non modifiable uniquement pour les stratégies de portefeuille d'enchères.

targetRoas

number

Option de retour sur les dépenses publicitaires (ROAS) cible Si elle est définie, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, l'objectif de retour sur les dépenses publicitaires. Si le ROAS cible est élevé, il est possible que la stratégie d'enchères ne puisse pas dépenser la totalité du budget. Si aucun ROAS cible n'est défini, la stratégie d'enchères essaie d'atteindre le ROAS le plus élevé possible en fonction du budget.

MaximizeConversions

Cette stratégie d'enchères automatiques vous permet d'enregistrer le plus grand nombre de conversions possible pour vos campagnes tout en exploitant la totalité de votre budget.

Représentation JSON
{
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string,
  "targetCpaMicros": string
}
Champs
cpcBidCeilingMicros

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Non modifiable uniquement pour les stratégies de portefeuille d'enchères.

cpcBidFloorMicros

string (int64 format)

Limite d'enchère minimale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Non modifiable uniquement pour les stratégies de portefeuille d'enchères.

targetCpaMicros

string (int64 format)

L'option "Coût par action (CPA)" cible. Il s'agit du montant moyen que vous souhaitez dépenser par action de conversion, spécifié en micro-unités de la devise de la stratégie d'enchères. Si elle est définie, la stratégie d'enchères générera autant de conversions que possible pour un coût par action cible égal ou inférieur. Si le CPA cible n'est pas défini, la stratégie d'enchères essaie d'atteindre le CPA le plus faible possible en fonction du budget.

TargetCpa

Il s'agit d'une stratégie d'enchères automatiques qui définit vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous spécifiez.

Représentation JSON
{
  "targetCpaMicros": string,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Champs
targetCpaMicros

string (int64 format)

CPA cible moyen. Cette cible doit être supérieure ou égale à l'unité facturable minimale, en fonction de la devise utilisée pour le compte.

cpcBidCeilingMicros

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Ce paramètre ne doit être défini que pour les stratégies de portefeuille d'enchères.

cpcBidFloorMicros

string (int64 format)

Limite d'enchère minimale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Ce paramètre ne doit être défini que pour les stratégies de portefeuille d'enchères.

TargetImpressionShare

Il s'agit d'une stratégie d'enchères automatiques qui définit les enchères de sorte qu'un certain pourcentage d'annonces sur le Réseau de Recherche soit diffusé en haut de la première page (ou d'une autre zone ciblée).

Représentation JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Champs
location

enum (TargetImpressionShareLocation)

Zone ciblée sur la page des résultats de recherche.

locationFractionMicros

string (int64 format)

Fraction choisie d'annonces à diffuser dans la zone ciblée en micros. Par exemple, 1% équivaut à 10 000.

cpcBidCeilingMicros

string (int64 format)

L'enchère au CPC la plus élevée que le système d'enchères automatiques est autorisée à spécifier. Il s'agit d'un champ obligatoire saisi par l'annonceur qui définit le plafond, spécifié en micro-unités locales.

TargetImpressionShareLocation

Énumération décrivant les objectifs possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ANYWHERE_ON_PAGE N'importe quel emplacement sur la page Web.
TOP_OF_PAGE Zone d'annonces supérieure.
ABSOLUTE_TOP_OF_PAGE Emplacement supérieur dans la zone d'annonces supérieure.

TargetOutrankShare

Il s'agit d'une stratégie d'enchères automatiques qui définit les enchères en fonction de la fraction cible des enchères pour laquelle l'annonceur doit surclasser un concurrent spécifique. Cette stratégie est obsolète.

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

string (Int64Value format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie.

TargetRoas

Cette stratégie d'enchères automatiques vous aide à maximiser vos revenus tout en atteignant en moyenne un ROAS cible spécifique.

Représentation JSON
{
  "targetRoas": number,
  "cpcBidCeilingMicros": string,
  "cpcBidFloorMicros": string
}
Champs
targetRoas

number

Obligatoire. Revenu choisi (sur la base des données de conversion) par unité de dépense. Doit être compris entre 0.01 et 1000 inclus.

cpcBidCeilingMicros

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Ce paramètre ne doit être défini que pour les stratégies de portefeuille d'enchères.

cpcBidFloorMicros

string (int64 format)

Limite d'enchère minimale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Ce paramètre ne doit être défini que pour les stratégies de portefeuille d'enchères.

TargetSpend

Il s'agit d'une stratégie d'enchères automatiques qui définit vos enchères pour vous aider à enregistrer autant de clics que possible dans les limites de votre budget.

Représentation JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Champs
targetSpendMicros
(deprecated)

string (int64 format)

Objectif de dépenses en dessous duquel optimiser les clics. Un enchérisseur TargetSpend tentera de dépenser la plus petite de cette valeur ou le montant normal de limitation des dépenses. S'il n'est pas spécifié, le budget est utilisé comme cible de dépenses. Ce champ est obsolète et ne doit plus être utilisé. Pour en savoir plus, consultez la page https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpcBidCeilingMicros

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie.

CampaignBudget

Un budget de campagne.

Représentation JSON
{
  "resourceName": string,
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "amountMicros": string
}
Champs
resourceName

string

Nom de la ressource associée au budget de la campagne. Le nom des ressources du budget de la campagne se présente comme suit:

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

Mode de diffusion qui détermine la fréquence à laquelle le budget de la campagne est dépensé.

La valeur par défaut est STANDARD si elle n'est pas spécifiée lors d'une opération de création.

period

enum (BudgetPeriod)

Période au cours de laquelle dépenser le budget. En l'absence de spécification, la valeur par défaut est DAILY.

amountMicros

string (int64 format)

Montant du budget, dans la devise locale du compte. Le montant est exprimé en micro-unités, où un million équivaut à une unité de devise. Les dépenses mensuelles sont limitées à 30,4 fois ce montant.

BudgetDeliveryMethod

Modes de diffusion possibles d'un budget.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
STANDARD Le serveur du budget limitera la diffusion de manière uniforme sur toute la période.
ACCELERATED Le serveur du budget ne limitera pas la diffusion, et les annonces seront diffusées le plus rapidement possible.

BudgetPeriod

Période possible d'un budget.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DAILY Budget quotidien.
FIXED_DAILY Budget quotidien fixe.
CUSTOM_PERIOD Vous pouvez utiliser un budget personnalisé avec "total_amount" pour spécifier une limite de budget pour la durée de vie.

Priorité de la

Une campagne

Représentation JSON
{
  "resourceName": string,
  "status": enum (CampaignStatus),
  "servingStatus": enum (CampaignServingStatus),
  "biddingStrategySystemStatus": enum (BiddingStrategySystemStatus),
  "adServingOptimizationStatus": enum (AdServingOptimizationStatus),
  "advertisingChannelType": enum (AdvertisingChannelType),
  "advertisingChannelSubType": enum (AdvertisingChannelSubType),
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "realTimeBiddingSetting": {
    object (RealTimeBiddingSetting)
  },
  "networkSettings": {
    object (NetworkSettings)
  },
  "dynamicSearchAdsSetting": {
    object (DynamicSearchAdsSetting)
  },
  "shoppingSetting": {
    object (ShoppingSetting)
  },
  "geoTargetTypeSetting": {
    object (GeoTargetTypeSetting)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

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

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

État de la campagne.

Lorsqu'une nouvelle campagne est ajoutée, la valeur par défaut de l'état est ACTIVÉE.

servingStatus

enum (CampaignServingStatus)

État de diffusion des annonces de la campagne.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

État du 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)

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)

Affinement facultatif à 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 balises de paramètres personnalisés dans trackingUrlTemplate, finalUrls ou mobile_final_urls.

realTimeBiddingSetting

object (RealTimeBiddingSetting)

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

networkSettings

object (NetworkSettings)

Paramètres des réseaux de la campagne.

dynamicSearchAdsSetting

object (DynamicSearchAdsSetting)

Paramètre de contrôle des annonces dynamiques du Réseau de Recherche (ADR).

shoppingSetting

object (ShoppingSetting)

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

geoTargetTypeSetting

object (GeoTargetTypeSetting)

Paramètre du ciblage géographique des annonces.

labels[]

string

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

biddingStrategyType

enum (BiddingStrategyType)

Type de stratégie d'enchères.

Vous pouvez créer une stratégie d'enchères en définissant le schéma d'enchères pour créer une stratégie d'enchères standard ou le champ biddingStrategy pour créer une stratégie de portefeuille d'enchères.

Ce champ est en lecture seule.

accessibleBiddingStrategy

string

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". Ce champ est 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 peuvent être lus à partir de la ressource AccessibleBiddingStrategy. En revanche, les attributs soumis à des restrictions 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 voit les annonces de cette campagne.

selectiveOptimization

object (SelectiveOptimization)

Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion à utiliser pour optimiser cette campagne. 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 comprend un ensemble de types d'objectifs d'optimisation.

trackingSetting

object (TrackingSetting)

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

engineId

string

ID de la campagne dans le compte de moteur externe. Ce champ concerne uniquement les comptes autres que Google Ads. Par exemple, Yahoo Japan, Microsoft, Baidu, etc. Pour l'entité Google Ads, utilisez plutôt "campaign.id".

excludedParentAssetFieldTypes[]

enum (AssetFieldType)

Types de champs de composants à exclure de cette campagne. Cette campagne n'héritera pas des liens d'éléments associés à ces types de champs à partir du niveau supérieur.

createTime

string

Horodatage lors de la création de cette annonce. L'horodatage est exprimé dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss". La fonction createTime sera abandonnée dans la version 1. Utilisez la date et l'heure de création à la place.

creationTime

string

Horodatage lors de la création de cette annonce. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

lastModifiedTime

string

Date et heure de la dernière modification de la campagne. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

id

string (int64 format)

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.

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.

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 permettant d'ajouter des paramètres de requête aux pages de destination diffusées avec le suivi en parallèle.

urlExpansionOptOut

boolean

Indique la désactivation de l'extension d'URL pour les URL plus ciblées. Si cette option est désactivée (vrai), seules les URL finales du groupe d'assets ou celles spécifiées dans le flux Google Merchant Center ou les flux de données d'entreprise de l'annonceur sont ciblées. Si cette option est activée (false), l'ensemble du domaine sera ciblé. Vous ne pouvez définir ce champ que pour les campagnes Performance Max, dont la valeur par défaut est "false".

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.

manualCpa

object (ManualCpa)

Stratégie d'enchères standards au CPA manuelles. Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère pour chaque action qu'il spécifie. Disponible uniquement pour les campagnes Local Services.

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

Stratégie d'enchères standards au CPM manuelles. Système d'enchères manuel basé sur les impressions, où l'utilisateur paie pour mille impressions.

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

Cette stratégie d'enchères standard au CPA cible définit automatiquement vos enchères pour générer un maximum de conversions en fonction du 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 des enchères pour atteindre un pourcentage d'impressions donné.

targetRoas

object (TargetRoas)

Cette stratégie d'enchères standard au ROAS cible maximise automatiquement les revenus tout en atteignant en moyenne un ROAS cible spécifique.

targetSpend

object (TargetSpend)

La stratégie d'enchères "Objectif de dépenses 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)

Il s'agit de la stratégie d'enchères standard au CPC au pourcentage, où les enchères ne représentent qu'une fraction du prix annoncé pour un produit ou un service.

targetCpm

object (TargetCpm)

Stratégie d'enchères qui optimise automatiquement le coût pour mille impressions.

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 n'est pas connue dans cette version.

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

SERVING Diffusion.
NONE Aucune
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 récemment ou récemment réactivée.
LEARNING_SETTING_CHANGE La stratégie d'enchères est en phase d'apprentissage en raison de la modification récente d'un 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 apprentissage, car le nombre de campagnes, de groupes d'annonces ou de mots clés qui lui est associé a récemment changé.
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é des 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.
LIMITED_BY_DATA La stratégie d'enchères est limitée, car le trafic de conversions 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é modifiée.
LIMITED_BY_LOW_QUALITY Une part significative des mots clés de cette stratégie d'enchères est associée à un faible niveau de qualité.
LIMITED_BY_INVENTORY La stratégie d'enchères ne peut pas dépenser entièrement son budget en raison d'un ciblage restreint.
MISCONFIGURED_ZERO_ELIGIBILITY Il manque le suivi des conversions (aucun ping) et/ou les 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 comporte pas de types de conversion susceptibles d'ê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 ne faisant pas partie de la stratégie d'enchères partagent un budget avec des campagnes incluses dans la stratégie.
MISCONFIGURED_STRATEGY_TYPE La campagne n'est pas diffusée, car son type de stratégie n'est pas valide.
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 pas de créer des rapports sur l'état pour le moment.
MULTIPLE_LEARNING Plusieurs états système de LEARNING_* étaient associés à cette stratégie d'enchères au cours de la période en question.
MULTIPLE_LIMITED Plusieurs états système de LIMITED_* ont été associés à cette stratégie d'enchères au cours de la période en question.
MULTIPLE_MISCONFIGURED Plusieurs états système de MISCONFIGURED_* ont été associés à cette stratégie d'enchères au cours de la période en question.
MULTIPLE Plusieurs états système étaient associés à cette stratégie d'enchères au moment en question.

AdServingOptimizationStatus

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

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.

OPTIMIZE La diffusion des annonces est optimisée en fonction du CTR de la campagne.
CONVERSION_OPTIMIZE La diffusion des annonces est optimisée sur la base du CTR * conversion pour la campagne. Si la campagne ne fait pas partie de la stratégie d'enchères de l'Optimiseur de conversion, la valeur par défaut est OPTIMISÉ.
ROTATE Les annonces sont alternées de manière régulière pendant 90 jours, puis optimisées pour les clics.
ROTATE_INDEFINITELY Diffusez 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.

AdvertisingChannelType

Énumération décrivant les différents types de canaux publicitaires.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SEARCH Réseau de Recherche. Inclut les campagnes display groupées et les campagnes sur le Réseau de Recherche.
DISPLAY Réseau Display de Google uniquement.
SHOPPING Les campagnes Shopping sont diffusées sur la propriété Shopping et dans les résultats de recherche google.com.
HOTEL pour vos campagnes Hotel Ads.
VIDEO Campagnes vidéo.
MULTI_CHANNEL campagnes pour applications et campagnes pour applications axées sur l'engagement diffusées sur plusieurs canaux.
LOCAL Les campagnes d'annonces locales
SMART Campagnes intelligentes
PERFORMANCE_MAX Performance Max.
LOCAL_SERVICES les campagnes Local Services.
DISCOVERY Campagnes Discovery.
TRAVEL les campagnes de voyage

AdvertisingChannelSubType

Énumération décrivant les différents sous-types de canaux.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisée comme valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SEARCH_MOBILE_APP Campagnes d'applications mobiles pour le Réseau de Recherche
DISPLAY_MOBILE_APP Campagnes d'applications mobiles pour le Réseau Display
SEARCH_EXPRESS AdWords Express pour le Réseau de Recherche
DISPLAY_EXPRESS AdWords Express pour le Réseau Display
SHOPPING_SMART_ADS les campagnes Shopping intelligentes.
DISPLAY_GMAIL_AD les campagnes d'annonces Gmail.
DISPLAY_SMART_CAMPAIGN Campagnes intelligentes sur le Réseau Display : Impossible de créer des campagnes de ce sous-type.
VIDEO_OUTSTREAM Campagnes vidéo OutStream.
VIDEO_ACTION les campagnes vidéo TrueView pour l'action.
VIDEO_NON_SKIPPABLE Les campagnes vidéo avec des annonces vidéo non désactivables.
APP_CAMPAIGN Les campagnes pour applications vous permettent de promouvoir facilement votre application Android ou iOS sur les principales propriétés de Google, dont le Réseau de Recherche, Play, YouTube et le Réseau Display de Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Campagne pour applications axée sur l'engagement, axée sur la réengagement avec l'application sur plusieurs des principales propriétés de Google, dont le Réseau de Recherche, YouTube et le Réseau Display de Google.
LOCAL_CAMPAIGN Il s'agit de campagnes spécialisées pour la publicité locale.
SHOPPING_COMPARISON_LISTING_ADS les campagnes Shopping comparateur de prix.
SMART_CAMPAIGN les campagnes intelligentes standards.
VIDEO_SEQUENCE Les campagnes vidéo avec des annonces vidéo de séquencement.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Une campagne pour applications axée sur la préinscription, qui cible plusieurs canaux publicitaires sur Google Play, YouTube et le Réseau Display.
VIDEO_REACH_TARGET_FREQUENCY Campagne vidéo axée sur la couverture avec la stratégie d'enchères "Fréquence cible".
TRAVEL_ACTIVITIES campagnes d'activités de voyage.

CustomParameter

Mappage pouvant être utilisé par les balises de paramètres personnalisés dans trackingUrlTemplate, finalUrls ou mobile_final_urls.

Représentation JSON
{
  "key": string,
  "value": string
}
Champs
key

string

Clé correspondant au nom du tag du paramètre.

value

string

Valeur à remplacer.

RealTimeBiddingSetting

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

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

boolean

Indique si la campagne utilise les enchères en temps réel.

NetworkSettings

Paramètres des réseaux de la campagne.

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

boolean

Indique si les annonces seront diffusées sur des sites partenaires du Réseau de Recherche de Google (la valeur de targetGoogleSearch doit être définie 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.

DynamicSearchAdsSetting

Paramètre de contrôle des annonces dynamiques du Réseau de Recherche (ADR).

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

string

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

languageCode

string

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

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

Paramètre des campagnes Shopping. Définit l'univers des produits pouvant être promus par la campagne, ainsi que la manière dont cette campagne interagit avec les autres campagnes Shopping.

Représentation JSON
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "merchantId": string,
  "salesCountry": string,
  "campaignPriority": integer,
  "enableLocal": boolean
}
Champs
feedLabel

string

Libellé du flux des produits à inclure dans la campagne. Vous ne pouvez définir qu'un seul élément feedLabel ou salesCountry. S'il est utilisé à la place de salesCountry, le champ feedLabel accepte les codes pays dans le 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

Permet de cibler ou non l'inventaire des fiches de véhicules.

merchantId

string (int64 format)

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

salesCountry

string

Pays de vente des produits à inclure dans la campagne.

campaignPriority

integer

Priorité de la campagne. Les campagnes associées à une priorité numérique plus élevée prévalent sur celles dont la priorité est plus faible. Ce champ est obligatoire pour les campagnes Shopping dont les valeurs sont comprises entre 0 et 2 inclus. Ce champ est facultatif pour les campagnes Shopping intelligentes, mais il doit être égal à 3 s'il est défini.

enableLocal

boolean

Permet d'inclure ou non les produits en magasin.

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 positif dans cette campagne spécifique.

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

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 déclenché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 déclenchée si l'utilisateur recherche les zones ciblées par l'annonceur. Elle ne peut être utilisée 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 rendent 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 géographiques exclues de l'annonceur ou s'il s'y intéressent.
PRESENCE Indique qu'un utilisateur ne peut pas voir l'annonce s'il se trouve dans les zones géographiques exclues de l'annonceur.

FrequencyCapEntry

Ce type ne comporte aucun champ.

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.

SelectiveOptimization

Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion à utiliser pour optimiser cette campagne. 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 comprend 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 comme valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
CALL_CLICKS Optimiser pour les clics d'appel Les conversions après clic par appel correspondent à la fréquence à laquelle les utilisateurs ont sélectionné "Appeler" pour contacter un magasin après avoir vu une annonce.
DRIVING_DIRECTIONS Optimiser pour les itinéraires. Une conversion d'itinéraire correspond au nombre de fois qu'un utilisateur a sélectionné "Itinéraire" pour se rendre dans un magasin après avoir vu une annonce.
APP_PRE_REGISTRATION Optimisez la préinscription. Les conversions de préinscription correspondent au nombre d'inscriptions en préinscription auxquelles une notification est envoyée lorsqu'une application est lancée.

TrackingSetting

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

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

string

URL utilisée pour le suivi dynamique.

ManualCpa

Ce type ne comporte aucun champ.

Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère pour chaque action qu'il spécifie.

ManualCpc

Système d'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 optimisées en fonction des données de l'Optimiseur de conversion.

ManualCpm

Ce type ne comporte aucun champ.

Système d'enchères manuel basé sur les impressions, où l'utilisateur paie pour mille impressions.

PercentCpc

Il s'agit d'une stratégie d'enchères selon 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 locales. Remarque: Une valeur nulle est interprétée de la même manière que si le champ "bid_padding" n'est pas défini.

enhancedCpcEnabled

boolean

Augmente ou réduit l'enchère lors de chaque mise aux enchères, en fonction de la probabilité de conversion. Les enchères individuelles peuvent être supérieures à cpcBidCeilingMicros, mais pas le montant moyen des enchères d'une campagne.

TargetCpm

Ce type ne comporte aucun champ.

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

CampaignAsset

Lien entre une campagne et un élément.

Représentation JSON
{
  "resourceName": string,
  "status": enum (AssetLinkStatus),
  "campaign": string,
  "asset": string
}
Champs
resourceName

string

Nom de ressource du composant de la campagne. Les noms de ressources CampaignAsset ont le format suivant:

customers/{customerId}/campaignAssets/{campaign_id}~{assetId}~{fieldType}

status

enum (AssetLinkStatus)

État du composant de la campagne.

campaign

string

La campagne à laquelle l'élément est associé.

asset

string

L'élément associé à la campagne.

CampaignAssetSet

CampaignAssetSet correspond à l'association entre une campagne et un ensemble de composants. L'ajout d'un CampaignAssetSet associe un ensemble de composants à une campagne.

Représentation JSON
{
  "resourceName": string,
  "campaign": string,
  "assetSet": string,
  "status": enum (AssetSetLinkStatus)
}
Champs
resourceName

string

Nom de ressource de l'ensemble de composants de la campagne. Les noms de ressources d'éléments de l'ensemble d'assets se présentent comme suit:

customers/{customerId}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Campagne à laquelle cet ensemble de composants est associé.

assetSet

string

Ensemble de composants associé à la campagne.

status

enum (AssetSetLinkStatus)

État du composant de l'ensemble de composants de la campagne. Lecture seule.

CampaignAudienceView

Une vue d'audience de la campagne. Elles incluent les données de performances issues des centres d'intérêt et des listes de remarketing pour les annonces sur les Réseaux Display et YouTube, et les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), regroupées par critère de campagne et d'audience. Cette vue n'inclut que les audiences associées au niveau de la campagne.

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

string

Nom de ressource de la vue d'audience de la campagne. Les noms des ressources de vue d'audience de la campagne se présentent comme suit:

customers/{customerId}/campaignAudienceViews/{campaign_id}~{criterionId}

CampaignCriterion

Un critère de campagne.

Représentation JSON
{
  "resourceName": string,
  "displayName": string,
  "type": enum (CriterionType),
  "status": enum (CampaignCriterionStatus),
  "lastModifiedTime": string,
  "criterionId": string,
  "bidModifier": number,
  "negative": boolean,

  // Union field criterion can be only one of the following:
  "keyword": {
    object (KeywordInfo)
  },
  "location": {
    object (LocationInfo)
  },
  "device": {
    object (DeviceInfo)
  },
  "ageRange": {
    object (AgeRangeInfo)
  },
  "gender": {
    object (GenderInfo)
  },
  "userList": {
    object (UserListInfo)
  },
  "language": {
    object (LanguageInfo)
  },
  "webpage": {
    object (WebpageInfo)
  },
  "locationGroup": {
    object (LocationGroupInfo)
  }
  // End of list of possible types for union field criterion.
}
Champs
resourceName

string

Nom de ressource du critère de campagne. Les noms de ressources du critère de campagne se présentent comme suit:

customers/{customerId}/campaignCriteria/{campaign_id}~{criterionId}

displayName

string

Le nom à afficher du critère.

Ce champ est ignoré pour les objets mutate.

type

enum (CriterionType)

Type du critère.

status

enum (CampaignCriterionStatus)

État du critère.

lastModifiedTime

string

Date et heure de la dernière modification de ce critère de campagne. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

criterionId

string (int64 format)

ID du critère.

Ce champ est ignoré lors d'une opération mutate.

bidModifier

number

Modificateur des enchères 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. Indiquez 0 pour désactiver un type d'appareil.

negative

boolean

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

Champ d'union criterion. Le critère de la campagne.

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

keyword

object (KeywordInfo)

Mot clé.

location

object (LocationInfo)

Localisation.

device

object (DeviceInfo)

appareil.

ageRange

object (AgeRangeInfo)

Tranche d'âge.

gender

object (GenderInfo)

Gender.

userList

object (UserListInfo)

Liste d'utilisateurs.

language

object (LanguageInfo)

HashiCorp.

webpage

object (WebpageInfo)

Page Web.

locationGroup

object (LocationGroupInfo)

Groupe de zones géographiques

CampaignCriterionStatus

États possibles d'un critère de campagne.

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 de campagne est activé.
PAUSED Le critère de campagne est mis en veille.
REMOVED Le critère de campagne a été supprimé.

LanguageInfo

Un critère de langue.

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

string

Nom de ressource de la constante de langue.

LocationGroupInfo

Rayon autour d'une liste de lieux spécifiés via un flux.

Représentation JSON
{
  "geoTargetConstants": [
    string
  ],
  "radiusUnits": enum (LocationGroupRadiusUnits),
  "feedItemSets": [
    string
  ],
  "radius": string
}
Champs
geoTargetConstants[]

string

Constantes des cibles géographiques limitant la portée de la zone géographique dans le flux. Actuellement, une seule constante de cible géographique est autorisée.

radiusUnits

enum (LocationGroupRadiusUnits)

Unité du rayon. Les miles et les mètres sont acceptés pour les constantes de cibles géographiques. Les millisecondes et mètres sont acceptés pour les ensembles d'éléments de flux. Cette étape est obligatoire et doit être définie dans les opérations CREATE.

feedItemSets[]

string

Ensembles d'éléments de flux dont les éléments de flux sont ciblés. Si plusieurs ID sont spécifiés, tous les éléments qui figurent dans au moins un ensemble sont ciblés. Ce champ ne peut pas être utilisé avec geoTargetConstants. Cette étape est facultative et ne peut être définie que dans les opérations CREATE.

radius

string (int64 format)

Distance en unités spécifiant le rayon autour des zones ciblées. Cette étape est obligatoire et doit être définie dans les opérations CREATE.

LocationGroupRadiusUnits

Unité de la distance par rayon dans le groupe de zones géographiques (par exemple, MILES)

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
METERS Mètres
MILES Miles
MILLI_MILES Millièmes miles

CampaignLabel

Représente une relation entre une campagne et un libellé.

Représentation JSON
{
  "resourceName": string,
  "campaign": string,
  "label": string
}
Champs
resourceName

string

Nom de la ressource. Les noms des ressources de libellé de campagne se présentent comme suit: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Campagne à laquelle le libellé est associé.

label

string

Libellé attribué à la campagne.

CartDataSalesView

Vue des ventes des données du panier.

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

string

Nom de ressource de la vue des ventes de données relatives au panier. Le nom des ressources de la vue "Ventes" des données du panier se présente sous la forme suivante: customers/{customerId}/cartDataSalesView

Audience

L'audience est une option de ciblage efficace qui vous permet de croiser différents attributs de segment, tels que les données démographiques détaillées et les affinités, afin de créer des audiences qui représentent des sections de vos segments cibles.

Représentation JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "description": string
}
Champs
resourceName

string

Nom de ressource de l'audience. Les noms d'audience se présentent de la façon suivante:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

ID de l'audience.

name

string

Obligatoire. Nom de l'audience. Elle doit être unique pour tous les publics. Il doit comporter entre 1 et 255 caractères.

description

string

Description de cette audience.

ConversionAction

Une action de conversion.

Représentation JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (ConversionActionStatus),
  "type": enum (ConversionActionType),
  "category": enum (ConversionActionCategory),
  "valueSettings": {
    object (ValueSettings)
  },
  "attributionModelSettings": {
    object (AttributionModelSettings)
  },
  "floodlightSettings": {
    object (FloodlightSettings)
  },
  "id": string,
  "name": string,
  "primaryForGoal": boolean,
  "ownerCustomer": string,
  "includeInClientAccountConversionsMetric": boolean,
  "includeInConversionsMetric": boolean,
  "clickThroughLookbackWindowDays": string,
  "appId": string
}
Champs
resourceName

string

Nom de ressource de l'action de conversion. Le nom des ressources de l'action de conversion se présente sous la forme suivante:

customers/{customerId}/conversionActions/{conversion_action_id}

creationTime

string

Horodatage de la création de l'activité Floodlight, au format ISO 8601.

status

enum (ConversionActionStatus)

État de cette action de conversion pour le décompte des événements de conversion.

type

enum (ConversionActionType)

Type d'action de conversion.

category

enum (ConversionActionCategory)

Catégorie de conversions enregistrée pour cette action de conversion.

valueSettings

object (ValueSettings)

Paramètres liés à la valeur des événements de conversion associés à cette action de conversion.

attributionModelSettings

object (AttributionModelSettings)

Paramètres associés au modèle d'attribution de cette action de conversion.

floodlightSettings

object (FloodlightSettings)

Paramètres Floodlight pour les types de conversion Floodlight

id

string (int64 format)

ID de l'action de conversion.

name

string

Nom de l'action de conversion.

Ce champ est obligatoire. Il doit être renseigné lors de la création d'actions de conversion.

primaryForGoal

boolean

Si le bit "primaryForGoal" d'une action de conversion est défini sur "false", vous ne pouvez pas définir une enchère pour toutes les campagnes, quel que soit l'objectif de conversion du client ou de la campagne. Toutefois, les objectifs de conversion personnalisés ne respectent pas "primaryForGoal". Par conséquent, si une campagne comporte un objectif de conversion personnalisé configuré avec une action de conversion "primaryForGoal = false", celle-ci peut toujours être enchérissable. Par défaut, primaryForGoal est défini sur true si ce champ n'est pas défini. Dans V9, primaryForGoal ne peut être défini sur "false" qu'après sa création par le biais d'une opération de mise à jour, car il n'est pas déclaré comme facultatif.

ownerCustomer

string

Nom de ressource du client propriétaire de l'action de conversion, ou valeur "null" s'il s'agit d'une action de conversion définie par le système.

includeInClientAccountConversionsMetric

boolean

Indique si cette action de conversion doit être incluse dans la métrique "clientAccountConversions".

includeInConversionsMetric

boolean

Indique si cette action de conversion doit être incluse dans la métrique "Conversions".

clickThroughLookbackWindowDays

string (int64 format)

Nombre maximal de jours pouvant s'écouler entre une interaction (un clic, par exemple) et un événement de conversion.

appId

string

ID d'application pour une action de conversion d'application.

ConversionActionStatus

États possibles d'une action de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED Les conversions seront enregistrées.
REMOVED Les conversions ne seront pas enregistrées.
HIDDEN Les conversions ne seront pas enregistrées et l'action de conversion n'apparaîtra pas dans l'interface utilisateur.

ConversionActionType

Types possibles d'une action de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AD_CALL Conversions enregistrées lorsqu'un utilisateur clique sur l'extension d'appel d'une annonce.
CLICK_TO_CALL Conversions enregistrées lorsqu'un utilisateur clique sur un numéro de téléphone à partir d'un appareil mobile.
GOOGLE_PLAY_DOWNLOAD Conversions enregistrées lorsqu'un utilisateur télécharge une application mobile sur le Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions enregistrées lorsqu'un utilisateur effectue un achat dans une application via la facturation Android.
UPLOAD_CALLS Conversions par appel dont le suivi est effectué par l'annonceur et qui sont importées.
UPLOAD_CLICKS Conversions suivies par l'annonceur et importées avec les clics attribués.
WEBPAGE Conversions se produisant sur une page Web.
WEBSITE_CALL Conversions enregistrées lorsqu'un utilisateur appelle un numéro de téléphone généré dynamiquement à partir du site Web d'un annonceur.
STORE_SALES_DIRECT_UPLOAD Conversion "ventes en magasin" basée sur les importations de données first party ou tierces. Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types d'importation directe "Ventes en magasin".
STORE_SALES Conversion des ventes en magasin basée sur les importations de données first party ou tierces de marchands et/ou sur les achats en magasin effectués à l'aide de cartes de réseaux de paiement. Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types de ventes en magasin. Lecture seule.
FIREBASE_ANDROID_FIRST_OPEN Conversions de type "première ouverture" d'une application Android suivies via Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Suivi des conversions d'achat via une application Android via Firebase
FIREBASE_ANDROID_CUSTOM Suivi des conversions personnalisées pour les applications Android via Firebase.
FIREBASE_IOS_FIRST_OPEN Conversions de type "première ouverture" d'une application iOS suivies via Firebase
FIREBASE_IOS_IN_APP_PURCHASE Suivi des conversions d'achat via une application iOS via Firebase
FIREBASE_IOS_CUSTOM Les conversions personnalisées liées aux applications iOS sont suivies via Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversions de type "première ouverture" d'une application Android suivies via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Suivi des conversions d'achat via une application Android à l'aide d'une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Suivi des conversions personnalisées pour les applications Android à l'aide d'une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversions de type "première ouverture" d'une application iOS suivies via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversions d'achat via une application iOS suivies à l'aide d'une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Les conversions personnalisées pour les applications iOS sont suivies à l'aide d'une solution d'analyse d'applications tierce.
ANDROID_APP_PRE_REGISTRATION Conversions enregistrées lorsqu'un utilisateur préinscrit une application mobile sur le Google Play Store. Lecture seule.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions effectuant le suivi de tous les téléchargements Google Play qui ne font pas l'objet d'un suivi selon un type spécifique à l'application. Lecture seule.
FLOODLIGHT_ACTION Activité Floodlight qui comptabilise le nombre de fois où les internautes ont consulté une page Web spécifique après avoir vu l'une des annonces d'un annonceur ou cliqué dessus. Lecture seule.
FLOODLIGHT_TRANSACTION Activité Floodlight effectuant le suivi du nombre de ventes réalisées ou du nombre d'articles achetés. Vous pouvez également obtenir la valeur totale de chaque vente. Lecture seule.
GOOGLE_HOSTED Conversions qui suivent les actions locales dans les produits et services Google après une interaction avec une annonce. Lecture seule.
LEAD_FORM_SUBMIT Conversions comptabilisées lorsqu'un utilisateur envoie un formulaire pour prospects. Lecture seule.
SALESFORCE Conversions provenant de Salesforce. Lecture seule.
SEARCH_ADS_360 Conversions importées à partir des données Floodlight Search Ads 360. Lecture seule.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversions par appel générées via les annonces d'une campagne intelligente sans configuration du suivi des appels, à l'aide des critères personnalisés de cette campagne. Lecture seule.
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL L'utilisateur clique sur un élément d'appel dans Google Maps. Campagne intelligente uniquement. Lecture seule.
SMART_CAMPAIGN_MAP_DIRECTIONS L'utilisateur demande l'itinéraire vers un établissement dans Google Maps. Campagne intelligente uniquement. Lecture seule.
SMART_CAMPAIGN_TRACKED_CALLS Conversions par appel générées via les annonces d'une campagne intelligente avec suivi des appels configuré et en utilisant les critères personnalisés de cette campagne. Lecture seule.
STORE_VISITS Conversions enregistrées lorsqu'un utilisateur se rend dans le magasin d'un annonceur. Lecture seule.
WEBPAGE_CODELESS Conversions créées à partir d'événements sur le site Web (envois de formulaires ou chargements de pages, par exemple) qui n'utilisent pas d'extraits d'événement codés individuellement. Lecture seule.
UNIVERSAL_ANALYTICS_GOAL Conversions provenant d'objectifs Universal Analytics associés.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions provenant de transactions Universal Analytics associées.
GOOGLE_ANALYTICS_4_CUSTOM Conversions provenant des conversions d'événement personnalisé Google Analytics 4 associées.
GOOGLE_ANALYTICS_4_PURCHASE Conversions provenant des conversions d'achat Google Analytics 4 associées.

ConversionActionCategory

Catégorie de conversions associées à une action de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DEFAULT Catégorie par défaut.
PAGE_VIEW Utilisateur visitant une page.
PURCHASE Événement d'achat, de vente ou de commande
SIGNUP Action d'inscription de l'utilisateur.
LEAD Action de génération de prospects.
DOWNLOAD Action de téléchargement de logiciel (comme pour une application).
ADD_TO_CART Ajout d'articles à un panier sur le site d'un annonceur
BEGIN_CHECKOUT Lorsqu'un utilisateur commence le processus de paiement sur le site d'un annonceur.
SUBSCRIBE_PAID Début d'un abonnement payant à un produit ou à un service.
PHONE_CALL_LEAD Appel pour indiquer votre intérêt pour l'offre d'un annonceur
IMPORTED_LEAD Une conversion de prospect importée dans Google Ads à partir d'une source externe.
SUBMIT_LEAD_FORM Envoi d'un formulaire sur le site d'un annonceur indiquant un intérêt pour une entreprise.
BOOK_APPOINTMENT Prise de rendez-vous avec l'entreprise d'un annonceur.
REQUEST_QUOTE Une demande de devis ou d'estimation de prix.
GET_DIRECTIONS Recherche de l'établissement d'un annonceur dans l'intention de s'y rendre
OUTBOUND_CLICK Clic vers le site du partenaire d'un annonceur.
CONTACT Contacter un annonceur par téléphone, SMS, e-mail, chat ou autre type de contact
ENGAGEMENT Un événement d'engagement avec le site Web, comme une longue durée sur le site ou un objectif intelligent Google Analytics (GA). Destiné à être utilisé pour les importations d'objectifs GA, Firebase et Gold.
STORE_VISIT Une visite dans un magasin physique.
STORE_SALE Vente dans un magasin physique.
QUALIFIED_LEAD Conversion de prospect importée dans Google Ads à partir d'une source externe, et davantage qualifiée par l'annonceur (équipe marketing/commerciale). Dans le parcours entre le prospect et la vente, les annonceurs obtiennent des prospects, puis agissent en conséquence en touchant le consommateur. Si le consommateur est intéressé et risque d'acheter son produit, l'annonceur marque les prospects comme des "prospects qualifiés".
CONVERTED_LEAD Conversion de prospect importée dans Google Ads à partir d'une source externe et ayant terminé une étape définie par l'annonceur chargé de la génération de prospects.

ValueSettings

Paramètres liés à la valeur des événements de conversion associés à cette action de conversion.

Représentation JSON
{
  "defaultValue": number,
  "defaultCurrencyCode": string,
  "alwaysUseDefaultValue": boolean
}
Champs
defaultValue

number

Valeur à utiliser lorsque les événements de conversion associés à cette action de conversion sont envoyés avec une valeur non valide, non autorisée ou manquante, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut.

defaultCurrencyCode

string

Code de devise à utiliser lorsque les événements de conversion associés à cette action de conversion sont envoyés avec un code de devise non valide ou manquant, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut.

alwaysUseDefaultValue

boolean

Détermine si la valeur et le code de devise par défaut sont utilisés à la place de la valeur et du code de devise spécifiés dans les événements de conversion pour cette action de conversion.

AttributionModelSettings

Paramètres associés au modèle d'attribution de cette action de conversion.

Représentation JSON
{
  "attributionModel": enum (AttributionModel),
  "dataDrivenModelStatus": enum (DataDrivenModelStatus)
}
Champs
attributionModel

enum (AttributionModel)

Type de modèle d'attribution de cette action de conversion.

dataDrivenModelStatus

enum (DataDrivenModelStatus)

État du modèle d'attribution basée sur les données pour l'action de conversion.

AttributionModel

Le modèle d'attribution qui décrit comment répartir le crédit d'une conversion spécifique entre de nombreuses interactions antérieures (potentiellement)

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
EXTERNAL Utilise une attribution externe.
GOOGLE_ADS_LAST_CLICK Attribue tout le crédit d'une conversion à son dernier clic.
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK Attribue tout le crédit d'une conversion à son premier clic via l'attribution sur le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Accorde le crédit d'une conversion de manière égale entre tous ses clics à l'aide de l'attribution sur le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attribue un crédit exponentiellement plus élevé d'une conversion aux clics les plus récents via l'attribution sur le Réseau de Recherche de Google (la demi-vie correspond à une semaine).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attribue 40% du crédit d'une conversion à ses premier et dernier clics. Les 20% restants sont répartis uniformément entre tous les autres clics. Elle utilise l'attribution sur le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN Modèle flexible qui utilise le machine learning pour déterminer la répartition appropriée du crédit entre les clics à l'aide de l'attribution sur le Réseau de Recherche Google.

DataDrivenModelStatus

Énumère les états des modèles basés sur les données.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AVAILABLE Le modèle basé sur les données est disponible.
STALE Le modèle basé sur les données est obsolète. Elle n'a pas été mise à jour depuis au moins sept jours. Il est toujours utilisé, mais expirera s'il n'est pas mis à jour pendant 30 jours.
EXPIRED Le modèle basé sur les données a expiré. Il n'a pas été mis à jour depuis au moins 30 jours et ne peut pas être utilisé. Le plus souvent, c'est parce qu'il n'y a pas eu le nombre d'événements requis au cours des 30 derniers jours.
NEVER_GENERATED Le modèle basé sur les données n'a jamais été généré. Le plus souvent, c'est parce qu'il n'y a jamais eu le nombre d'événements requis sur une période de 30 jours.

FloodlightSettings

Paramètres associés à une action de conversion Floodlight.

Représentation JSON
{
  "activityGroupTag": string,
  "activityTag": string,
  "activityId": string
}
Champs
activityGroupTag

string

Chaîne permettant d'identifier un groupe d'activités Floodlight lors de la création de rapports sur les conversions.

activityTag

string

Chaîne permettant d'identifier une activité Floodlight lors de la création de rapports sur les conversions.

activityId

string (int64 format)

ID de l'activité Floodlight dans DoubleClick Campaign Manager (DCM).

ConversionCustomVariable

Variable personnalisée de conversion. Consultez "À propos des métriques et des dimensions Floodlight personnalisées dans la nouvelle interface Search Ads 360" sur https://support.google.com/sa360/answer/13567857.

Représentation JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "tag": string,
  "status": enum (ConversionCustomVariableStatus),
  "ownerCustomer": string,
  "family": enum (ConversionCustomVariableFamily),
  "cardinality": enum (ConversionCustomVariableCardinality),
  "floodlightConversionCustomVariableInfo": {
    object (FloodlightConversionCustomVariableInfo)
  },
  "customColumnIds": [
    string
  ]
}
Champs
resourceName

string

Nom de ressource de la variable personnalisée de conversion. Les noms des ressources de variables personnalisées de conversion se présentent comme suit:

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

ID de la variable personnalisée de conversion.

name

string

Obligatoire. Nom de la variable personnalisée de conversion. Le nom doit être unique. La longueur maximale du nom est de 100 caractères. N'ajoutez pas d'espace avant et après.

tag

string

Obligatoire. Balise de la variable personnalisée de conversion. Le tag doit être unique et se composer d'un caractère "u" directement suivi d'un nombre inférieur à 100. Exemple: "u4".

status

enum (ConversionCustomVariableStatus)

État de la variable personnalisée de conversion pour le cumul des événements de conversion.

ownerCustomer

string

Nom de la ressource du client qui possède la variable personnalisée de conversion.

family

enum (ConversionCustomVariableFamily)

Famille de la variable personnalisée de conversion.

cardinality

enum (ConversionCustomVariableCardinality)

Cardinalité de la variable personnalisée de conversion.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

Champs pour les variables personnalisées de conversion Floodlight Search Ads 360.

customColumnIds[]

string (int64 format)

ID des colonnes personnalisées qui utilisent cette variable personnalisée de conversion.

ConversionCustomVariableStatus

États possibles d'une variable personnalisée de conversion.

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

La variable personnalisée de conversion est en attente d'activation. Elle ne générera pas de statistiques tant qu'elle n'est pas activée.

Cet état ne peut pas être utilisé dans les requêtes CREATE et UPDATE.

ENABLED La variable personnalisée de conversion est activée et génère des statistiques.
PAUSED La variable personnalisée de conversion est mise en veille. Elle ne générera plus de statistiques tant qu'elle n'aura pas été de nouveau activée.

ConversionCustomVariableFamily

Famille d'une variable personnalisée de conversion

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
STANDARD Variable personnalisée de conversion standard. Les clients doivent l'activer avant de l'utiliser.
FLOODLIGHT Variable personnalisée de conversion importée à partir d'une variable Floodlight personnalisée.

ConversionCustomVariableCardinality

Cardinalité d'une variable personnalisée de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
BELOW_ALL_LIMITS La cardinalité de la variable personnalisée de conversion est inférieure à toutes les limites. Vous pouvez l'utiliser pour la segmentation, et les statistiques peuvent être cumulées pour les nouvelles valeurs si la variable est activée.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT La cardinalité de la variable personnalisée de conversion dépasse la limite de segmentation, mais ne dépasse pas la limite des statistiques. La segmentation sera désactivée, mais les statistiques pourront être cumulées pour de nouvelles valeurs si la variable est activée.
APPROACHES_STATS_LIMIT La variable personnalisée de conversion a dépassé les limites de segmentation et approche les limites des statistiques (> 90%). La segmentation sera désactivée, mais les statistiques pourront être cumulées pour de nouvelles valeurs si la variable est activée.
EXCEEDS_STATS_LIMIT La variable personnalisée de conversion a dépassé les limites de segmentation et de statistiques. La segmentation sera désactivée, et les statistiques des variables activées ne pourront être générées que si les valeurs existantes n'augmentent plus la cardinalité de la variable.

FloodlightConversionCustomVariableInfo

Informations concernant les variables personnalisées de conversion Floodlight dans Search Ads 360.

Représentation JSON
{
  "floodlightVariableType": enum (FloodlightVariableType),
  "floodlightVariableDataType": enum (FloodlightVariableDataType)
}
Champs
floodlightVariableType

enum (FloodlightVariableType)

Type de variable Floodlight défini dans Search Ads 360.

floodlightVariableDataType

enum (FloodlightVariableDataType)

Type de données de variable Floodlight défini dans Search Ads 360

FloodlightVariableType

Type de la variable Floodlight, tel qu'il est défini dans Search Ads 360. Pour en savoir plus, consultez la page https://support.google.com/searchads/answer/4397154?hl=en.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DIMENSION Type de variable Floodlight de dimension.
METRIC Type de variable Floodlight de métrique.
UNSET Le type de variable Floodlight n'est pas défini.

FloodlightVariableDataType

Type de données de la variable Floodlight, tel que défini dans Search Ads 360. Pour en savoir plus, consultez la page https://support.google.com/searchads/answer/4397154?hl=en.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
NUMBER Représente une variable Floodlight de type "Nombre". Cette variable peut être attribuée aux variables Floodlight de type DIMENSION ou METRIC.
STRING Représente une variable Floodlight de type "String" (Chaîne). Cette variable peut être attribuée aux variables Floodlight de type DIMENSION.

Client

Un client.

Représentation JSON
{
  "resourceName": string,
  "conversionTrackingSetting": {
    object (ConversionTrackingSetting)
  },
  "accountType": enum (AccountType),
  "doubleClickCampaignManagerSetting": {
    object (DoubleClickCampaignManagerSetting)
  },
  "accountStatus": enum (AccountStatus),
  "lastModifiedTime": string,
  "engineId": string,
  "status": enum (CustomerStatus),
  "creationTime": string,
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Champs
resourceName

string

Nom de ressource du client. Le nom des ressources client se présente sous la forme suivante:

customers/{customerId}

conversionTrackingSetting

object (ConversionTrackingSetting)

Paramètre de suivi des conversions d'un client.

accountType

enum (AccountType)

Type de compte de moteur (par exemple, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Suivi de moteur).

doubleClickCampaignManagerSetting

object (DoubleClickCampaignManagerSetting)

Paramètre DoubleClick Campaign Manager (Campaign Manager) pour un client administrateur.

accountStatus

enum (AccountStatus)

L'état du compte ("Activé", "Mis en veille", "Supprimé", etc.)

lastModifiedTime

string

Date et heure de la dernière modification du client. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

engineId

string

ID du compte dans le compte de moteur externe.

status

enum (CustomerStatus)

État du client.

creationTime

string

Horodatage lors de la création de ce client. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

id

string (int64 format)

ID du client.

descriptiveName

string

Nom descriptif facultatif et non unique du client.

currencyCode

string

Devise de fonctionnement du compte. Accepte un sous-ensemble de codes de devise ISO 4217.

timeZone

string

ID du fuseau horaire local du client.

trackingUrlTemplate

string

Modèle d'URL permettant de créer une URL de suivi à partir de paramètres.

finalUrlSuffix

string

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

autoTaggingEnabled

boolean

Indique si le taggage automatique est activé pour le client.

manager

boolean

Indique si le client est un gestionnaire.

ConversionTrackingSetting

Ensemble de paramètres concernant le client concernant le suivi des conversions Search Ads 360.

Représentation JSON
{
  "acceptedCustomerDataTerms": boolean,
  "conversionTrackingStatus": enum (ConversionTrackingStatus),
  "enhancedConversionsForLeadsEnabled": boolean,
  "googleAdsConversionCustomer": string,
  "conversionTrackingId": string,
  "googleAdsCrossAccountConversionTrackingId": string,
  "crossAccountConversionTrackingId": string
}
Champs
acceptedCustomerDataTerms

boolean

Indique si le client a accepté les conditions d'utilisation des données client. Si vous utilisez le suivi des conversions multicomptes, cette valeur est héritée de l'administrateur. Ce champ est en lecture seule. Pour en savoir plus, consultez la page https://support.google.com/adspolicy/answer/7475709.

conversionTrackingStatus

enum (ConversionTrackingStatus)

État du suivi des conversions. Elle indique si le client utilise le suivi des conversions et qui en est le propriétaire. Si le client utilise le suivi des conversions multicomptes, la valeur renvoyée diffère en fonction de l'login-customer-id de la requête.

enhancedConversionsForLeadsEnabled

boolean

Indique si le client a activé le suivi avancé des conversions pour les prospects. Si vous utilisez le suivi des conversions multicomptes, cette valeur est héritée de l'administrateur. Ce champ est en lecture seule.

googleAdsConversionCustomer

string

Nom de la ressource du client dans laquelle les conversions sont créées et gérées. Ce champ est en lecture seule.

conversionTrackingId

string (int64 format)

ID de suivi des conversions utilisé pour ce compte. Cet identifiant n'indique pas si le client utilise le suivi des conversions (contrairement à conversionTrackingStatus). Ce champ est en lecture seule.

googleAdsCrossAccountConversionTrackingId

string (int64 format)

ID de suivi des conversions du responsable du client. Ce paramètre est défini lorsque le client a activé le suivi des conversions et remplace conversionTrackingId. Ce champ ne peut être géré que via l'interface utilisateur de Google Ads. Ce champ est en lecture seule.

crossAccountConversionTrackingId

string (int64 format)

ID de suivi des conversions du responsable du client. Ce paramètre est défini lorsque le client a activé le suivi des conversions multicomptes et remplace conversionTrackingId.

ConversionTrackingStatus

État du suivi des conversions du client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
NOT_CONVERSION_TRACKED Le Client n'utilise aucun suivi des conversions.
CONVERSION_TRACKING_MANAGED_BY_SELF Les actions de conversion sont créées et gérées par ce client.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Les actions de conversion sont créées et gérées par l'administrateur spécifié dans l'login-customer-id de la demande.
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER Les actions de conversion sont créées et gérées par un administrateur différent du client ou de l'administrateur spécifié dans l'login-customer-id de la demande.

AccountType

Types de comptes de moteur possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
BAIDU compte Baidu.
ENGINE_TRACK Compte de suivi de moteur.
FACEBOOK Compte Facebook.
FACEBOOK_GATEWAY Compte Facebook géré via une passerelle.
GOOGLE_ADS votre compte Google Ads.
MICROSOFT compte Microsoft Advertising.
SEARCH_ADS_360 votre compte administrateur Search Ads 360.
YAHOO_JAPAN compte Yahoo! Japan.

DoubleClickCampaignManagerSetting

Paramètre DoubleClick Campaign Manager (Campaign Manager) pour un client administrateur.

Représentation JSON
{
  "advertiserId": string,
  "networkId": string,
  "timeZone": string
}
Champs
advertiserId

string (int64 format)

Numéro de l'annonceur Campaign Manager associé à ce client.

networkId

string (int64 format)

ID du réseau Campaign Manager associé à ce client.

timeZone

string

Fuseau horaire du réseau Campaign Manager associé à ce client, au format de la base de données des fuseaux horaires IANA, tel que America/New_York.

AccountStatus

États possibles d'un compte.

Enums
UNSPECIFIED Valeur par défaut.
UNKNOWN Valeur inconnue.
ENABLED Ce compte peut diffuser des annonces.
PAUSED L'utilisateur a désactivé le compte.
SUSPENDED Le compte a été désactivé par un processus interne.
REMOVED Le compte est désactivé de manière irrévocable.
DRAFT Le compte est toujours en cours de configuration et n'est pas encore ACTIVÉ.

CustomerStatus

États possibles d'un client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED Indique un compte actif capable de diffuser des annonces.
CANCELED Indique qu'un compte désactivé ne peut pas diffuser d'annonces. Elle peut être réactivée par un administrateur.
SUSPENDED Indique qu'un compte suspendu ne peut pas diffuser d'annonces. Ne peut être activé que par l'assistance Google.
CLOSED Indique qu'un compte clôturé ne peut pas diffuser d'annonces. Le compte de test sera également associé à l'état FERMÉ. L'état est définitif et ne peut pas être rouvert.

CustomerAsset

Lien entre un client et un élément.

Représentation JSON
{
  "resourceName": string,
  "asset": string,
  "status": enum (AssetLinkStatus)
}
Champs
resourceName

string

Nom de ressource de l'élément client. Les noms de ressources CustomerAsset ont le format suivant:

customers/{customerId}/customerAssets/{assetId}~{fieldType}

asset

string

Obligatoire. Élément associé au client.

status

enum (AssetLinkStatus)

État du composant client.

CustomerAssetSet

CustomerAssetSet est le lien entre un client et un ensemble de composants. L'ajout d'un CustomerAssetSet permet d'associer un ensemble de composants à un client.

Représentation JSON
{
  "resourceName": string,
  "assetSet": string,
  "customer": string,
  "status": enum (AssetSetLinkStatus)
}
Champs
resourceName

string

Nom de ressource de l'ensemble de composants du client. Les noms de ressources d'éléments de l'ensemble d'assets se présentent comme suit:

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

Ensemble de composants associé au client.

customer

string

Client auquel cet ensemble de composants est associé.

status

enum (AssetSetLinkStatus)

État du composant de l'ensemble de composants client. Lecture seule.

AccessibleBiddingStrategy

Représente une vue des stratégies d'enchères détenue par le client et partagée avec celui-ci.

Contrairement à BiddingStrategy, cette ressource inclut les stratégies détenues par les responsables du client et partagées avec ce client, en plus des stratégies détenues par ce client. Cette ressource ne fournit pas de métriques et n'affiche qu'un sous-ensemble limité des attributs BiddingStrategy.

Représentation JSON
{
  "resourceName": string,
  "id": string,
  "name": string,
  "type": enum (BiddingStrategyType),
  "ownerCustomerId": string,
  "ownerDescriptiveName": string,

  // Union field scheme can be only one of the following:
  "maximizeConversionValue": {
    object (MaximizeConversionValue)
  },
  "maximizeConversions": {
    object (MaximizeConversions)
  },
  "targetCpa": {
    object (TargetCpa)
  },
  "targetImpressionShare": {
    object (TargetImpressionShare)
  },
  "targetRoas": {
    object (TargetRoas)
  },
  "targetSpend": {
    object (TargetSpend)
  }
  // End of list of possible types for union field scheme.
}
Champs
resourceName

string

Nom de ressource de la stratégie d'enchères accessible. Les noms des ressources AccessibleBiddingStrategy se présentent sous la forme suivante:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

ID de la stratégie d'enchères.

name

string

Nom de la stratégie d'enchères.

type

enum (BiddingStrategyType)

Type de stratégie d'enchères.

ownerCustomerId

string (int64 format)

Identifiant du client auquel appartient la stratégie d'enchères.

ownerDescriptiveName

string

descriptiveName du client auquel appartient la stratégie d'enchères.

Champ d'union scheme. Système d'enchères.

Vous ne pouvez en définir qu'une seule. scheme ne peut être qu'un des éléments suivants :

maximizeConversionValue

object (MaximizeConversionValue)

Cette stratégie d'enchères automatiques vous permet d'enregistrer la meilleure valeur de conversion possible pour vos campagnes tout en exploitant la totalité de votre budget.

maximizeConversions

object (MaximizeConversions)

Cette stratégie d'enchères automatiques vous permet d'enregistrer le plus grand nombre de conversions possible pour vos campagnes tout en exploitant la totalité de votre budget.

targetCpa

object (TargetCpa)

Il s'agit d'une stratégie d'enchères qui définit vos enchères pour générer un maximum de conversions en fonction du coût par acquisition (CPA) cible que vous spécifiez.

targetImpressionShare

object (TargetImpressionShare)

Stratégie d'enchères qui optimise automatiquement les campagnes en fonction d'un pourcentage d'impressions donné.

targetRoas

object (TargetRoas)

Stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant en moyenne un ROAS cible spécifique.

targetSpend

object (TargetSpend)

Il s'agit d'une stratégie d'enchères qui définit vos enchères de sorte que vous enregistriez autant de clics que possible dans les limites de votre budget.

MaximizeConversionValue

Cette stratégie d'enchères automatiques vous permet d'enregistrer la meilleure valeur de conversion possible pour vos campagnes tout en exploitant la totalité de votre budget.

Représentation JSON
{
  "targetRoas": number
}
Champs
targetRoas

number

Option de retour sur les dépenses publicitaires (ROAS) cible Si elle est définie, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, l'objectif de retour sur les dépenses publicitaires. Si le ROAS cible est élevé, il est possible que la stratégie d'enchères ne puisse pas dépenser la totalité du budget. Si aucun ROAS cible n'est défini, la stratégie d'enchères essaie d'atteindre le ROAS le plus élevé possible en fonction du budget.

MaximizeConversions

Cette stratégie d'enchères automatiques vous permet d'enregistrer le plus grand nombre de conversions possible pour vos campagnes tout en exploitant la totalité de votre budget.

Représentation JSON
{
  "targetCpa": string,
  "targetCpaMicros": string
}
Champs
targetCpa

string (int64 format)

L'option de coût par acquisition (CPA) cible. Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.

targetCpaMicros

string (int64 format)

L'option de coût par acquisition (CPA) cible. Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.

TargetCpa

Il s'agit d'une stratégie d'enchères automatiques qui définit vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous spécifiez.

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

string (int64 format)

CPA cible moyen. Cette cible doit être supérieure ou égale à l'unité facturable minimale, en fonction de la devise utilisée pour le compte.

TargetImpressionShare

Il s'agit d'une stratégie d'enchères automatiques qui définit les enchères de sorte qu'un certain pourcentage d'annonces sur le Réseau de Recherche soit diffusé en haut de la première page (ou d'une autre zone ciblée).

Représentation JSON
{
  "location": enum (TargetImpressionShareLocation),
  "locationFractionMicros": string,
  "cpcBidCeilingMicros": string
}
Champs
location

enum (TargetImpressionShareLocation)

Zone ciblée sur la page des résultats de recherche.

locationFractionMicros

string (int64 format)

Fraction choisie d'annonces à diffuser dans la zone ciblée en micros. Par exemple, 1% équivaut à 10 000.

cpcBidCeilingMicros

string (int64 format)

L'enchère au CPC la plus élevée que le système d'enchères automatiques est autorisée à spécifier. Il s'agit d'un champ obligatoire saisi par l'annonceur qui définit le plafond, spécifié en micro-unités locales.

TargetRoas

Cette stratégie d'enchères automatiques vous aide à maximiser vos revenus tout en atteignant en moyenne un ROAS cible spécifique.

Représentation JSON
{
  "targetRoas": number
}
Champs
targetRoas

number

Revenu choisi (sur la base des données de conversion) par unité de dépense.

TargetSpend

Il s'agit d'une stratégie d'enchères automatiques qui définit vos enchères pour vous aider à enregistrer autant de clics que possible dans les limites de votre budget.

Représentation JSON
{
  "targetSpendMicros": string,
  "cpcBidCeilingMicros": string
}
Champs
targetSpendMicros
(deprecated)

string (int64 format)

Objectif de dépenses en dessous duquel optimiser les clics. Un enchérisseur TargetSpend tentera de dépenser la plus petite de cette valeur ou le montant normal de limitation des dépenses. S'il n'est pas spécifié, le budget est utilisé comme cible de dépenses. Ce champ est obsolète et ne doit plus être utilisé. Pour en savoir plus, consultez la page https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html.

cpcBidCeilingMicros

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie.

ManagerLinkStatus

États possibles d'une association.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ACTIVE Indique la relation en vigueur.
INACTIVE Indique que la relation a été interrompue
PENDING Indique qu'une relation a été demandée par un responsable, mais que le client n'a pas encore accepté.
REFUSED Le responsable a demandé la relation, mais le client a refusé.
CANCELED Indique que la relation a été demandée par le responsable, mais qu'il l'a annulée.

CustomerClient

Lien entre le client donné et un client. Les CustomerClients n'existent que pour les clients gestionnaires. Tous les clients directs et indirects sont inclus, ainsi que le gestionnaire lui-même.

Représentation JSON
{
  "resourceName": string,
  "appliedLabels": [
    string
  ],
  "status": enum (CustomerStatus),
  "clientCustomer": string,
  "hidden": boolean,
  "level": string,
  "timeZone": string,
  "testAccount": boolean,
  "manager": boolean,
  "descriptiveName": string,
  "currencyCode": string,
  "id": string
}
Champs
resourceName

string

Nom de ressource du client client. Les noms de ressources CustomerClient ont le format suivant: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

Noms de ressources des libellés appartenant au client demandeur et appliqués au client client. Les noms des ressources d'étiquette ont le format suivant:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

État du client. Lecture seule.

clientCustomer

string

Nom de ressource du client-client lié au client donné. Lecture seule.

hidden

boolean

Indique s'il s'agit d'un compte masqué.

Lecture seule.

level

string (int64 format)

Distance entre le client donné et le client. Pour les liens auto, la valeur du niveau est 0. Lecture seule.

timeZone

string

Chaîne CLDR (Common Locale Data Repository) représentant le fuseau horaire du client, par exemple America/Los_Angeles. Lecture seule.

testAccount

boolean

Détermine si le client est un compte de test. Lecture seule.

manager

boolean

Détermine si le client est un gestionnaire. Lecture seule.

descriptiveName

string

Nom descriptif du client. Lecture seule.

currencyCode

string

Code de devise (par exemple, "USD" ou "EUR") pour le client. Lecture seule.

id

string (int64 format)

Identifiant du client client. Lecture seule.

DynamicSearchAdsSearchTermView

Un affichage des termes de recherche pour les annonces dynamiques du Réseau de Recherche.

Représentation JSON
{
  "resourceName": string,
  "landingPage": string
}
Champs
resourceName

string

Nom de ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Le nom des ressources de la vue des termes de recherche pour les annonces dynamiques du Réseau de Recherche se présente comme suit:

customers/{customerId}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landingPage

string

URL de la page de destination sélectionnée dynamiquement pour l'impression.

Ce champ est en lecture seule.

GenderView

Une vue par genre. La ressource "genderView" reflète l'état de diffusion effectif, plutôt que les critères ajoutés. Par défaut, un groupe d'annonces sans critères de genre est diffusé auprès de tous les sexes. Par conséquent, l'ensemble des sexes apparaît dans genderView avec des statistiques.

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

string

Nom de ressource de la vue par sexe. Le nom des ressources de la vue Sexe se présente sous la forme suivante:

customers/{customerId}/genderViews/{ad_group_id}~{criterionId}

GeoTargetConstant

Constante de cible géographique

Représentation JSON
{
  "resourceName": string,
  "status": enum (GeoTargetConstantStatus),
  "id": string,
  "name": string,
  "countryCode": string,
  "targetType": string,
  "canonicalName": string,
  "parentGeoTarget": string
}
Champs
resourceName

string

Nom de ressource de la constante de cible géographique. Les noms des ressources constantes des cibles géographiques se présentent sous la forme suivante:

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

État constant de la cible géographique.

id

string (int64 format)

ID de la constante de cible géographique.

name

string

Nom anglais constant de la cible géographique.

countryCode

string

Code pays ISO-3166-1 alpha-2 associé à la cible.

targetType

string

Type de cible constante de la cible géographique.

canonicalName

string

Nom complet anglo-saxon composé du nom de la cible, de celui du parent et du pays.

parentGeoTarget

string

Nom de ressource de la constante de cible géographique parente. Les noms des ressources constantes des cibles géographiques se présentent sous la forme suivante:

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

États possibles d'une constante de cible géographique.

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 La constante de la cible géographique est valide.
REMOVAL_PLANNED La constante de cible géographique est obsolète et sera supprimée.

KeywordView

Une vue de mot clé.

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

string

Nom de ressource de la vue des mots clés. Les noms des ressources de la vue des mots clés se présentent comme suit:

customers/{customerId}/keywordViews/{ad_group_id}~{criterionId}

Étiquette

Un libellé.

Représentation JSON
{
  "resourceName": string,
  "status": enum (LabelStatus),
  "textLabel": {
    object (TextLabel)
  },
  "id": string,
  "name": string
}
Champs
resourceName

string

Nom de la ressource. Les noms des ressources d'étiquette ont le format suivant: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

État du libellé. Lecture seule.

textLabel

object (TextLabel)

Type de libellé affichant du texte sur un arrière-plan coloré.

id

string (int64 format)

ID du libellé. Lecture seule.

name

string

Nom du libellé.

Ce champ est obligatoire et ne doit pas être vide lors de la création d'un libellé.

La longueur de cette chaîne doit être comprise entre 1 et 80, inclus.

LabelStatus

États possibles d'un libellé.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED Le libellé est activé.
REMOVED Le libellé a été supprimé.

TextLabel

Type de libellé affichant du texte sur un arrière-plan coloré.

Représentation JSON
{
  "backgroundColor": string,
  "description": string
}
Champs
backgroundColor

string

Couleur d'arrière-plan du libellé au format RVB. Cette chaîne doit correspondre à l'expression régulière "^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$". Remarque: Il est possible que la couleur d'arrière-plan ne soit pas visible dans les comptes administrateur.

description

string

Brève description du libellé. La longueur ne doit pas dépasser 200 caractères.

LanguageConstant

Une langue.

Représentation JSON
{
  "resourceName": string,
  "id": string,
  "code": string,
  "name": string,
  "targetable": boolean
}
Champs
resourceName

string

Nom de ressource de la constante de langue. Les noms des ressources de constantes de langage se présentent sous la forme suivante:

languageConstants/{criterionId}

id

string (int64 format)

ID de la constante de langue.

code

string

Code de langue, par exemple "en_US", "en_AU", "es", "fr", etc.

name

string

Nom complet de la langue en anglais, par exemple "Anglais (États-Unis)", "Espagnol", etc.

targetable

boolean

Indique si la langue peut être ciblée.

LocationView

Une vue par zone géographique récapitule les performances des campagnes en fonction d'un critère géographique.

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

string

Nom de ressource de la vue de l'établissement. Les noms des ressources de vue d'emplacement se présentent comme suit:

customers/{customerId}/locationViews/{campaign_id}~{criterionId}

ProductBiddingCategoryConstant

Une catégorie d'enchères de produits.

Représentation JSON
{
  "resourceName": string,
  "level": enum (ProductBiddingCategoryLevel),
  "status": enum (ProductBiddingCategoryStatus),
  "id": string,
  "countryCode": string,
  "productBiddingCategoryConstantParent": string,
  "languageCode": string,
  "localizedName": string
}
Champs
resourceName

string

Nom de ressource de la catégorie d'enchères du produit. Les noms des ressources de catégorie d'enchères de produit se présentent comme suit:

productBiddingCategoryConstants/{countryCode}~{level}~{id}

level

enum (ProductBiddingCategoryLevel)

Niveau de la catégorie d'enchères de produits.

status

enum (ProductBiddingCategoryStatus)

État de la catégorie d'enchères du produit.

id

string (int64 format)

ID de la catégorie d'enchères de produit.

Cet identifiant équivaut à l'identifiant google_product_category [catégorie_de_produits_google], tel que décrit dans cet article: https://support.google.com/merchants/answer/6324436.

countryCode

string

Code pays à deux lettres en majuscules de la catégorie d'enchères du produit.

productBiddingCategoryConstantParent

string

Nom de ressource de la catégorie d'enchères du produit parent.

languageCode

string

Code de langue de la catégorie d'enchères du produit.

localizedName

string

La valeur d'affichage de la catégorie d'enchères associée au produit est localisée selon languageCode.

ProductBiddingCategoryLevel

Énumération décrivant le niveau de la catégorie d'enchères du produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
LEVEL1 Niveau 1.
LEVEL2 Niveau 2.
LEVEL3 Niveau 3.
LEVEL4 Niveau 4.
LEVEL5 Niveau 5.

ProductBiddingCategoryStatus

Énumération décrivant l'état de la catégorie d'enchères du produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ACTIVE La catégorie est active et peut être utilisée pour les enchères.
OBSOLETE La catégorie est obsolète. Utilisé uniquement pour la création de rapports.

ProductGroupView

Affichage d'un groupe de produits.

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

string

Nom de ressource de la vue du groupe de produits. Les noms des ressources d'affichage de groupe de produits se présentent comme suit:

customers/{customerId}/productGroupViews/{ad_group_id}~{criterionId}

ShoppingPerformanceView

Vue des performances Shopping. Fournit des statistiques sur les campagnes Shopping agrégées à plusieurs niveaux de dimensions de produit. Les valeurs des dimensions de produit issues de Merchant Center (marque, catégorie, attributs personnalisés, état du produit et type de produit, par exemple) reflètent l'état de chaque dimension à la date et à l'heure d'enregistrement de l'événement correspondant.

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

string

Nom de ressource de la vue des performances Shopping. Le nom des ressources de la vue des performances Shopping se présente sous la forme suivante: customers/{customerId}/shoppingPerformanceView

UserList

Une liste d'utilisateurs Il s'agit d'une liste d'utilisateurs qu'un client peut cibler.

Représentation JSON
{
  "resourceName": string,
  "type": enum (UserListType),
  "id": string,
  "name": string
}
Champs
resourceName

string

Nom de ressource de la liste d'utilisateurs. Les noms des ressources de la liste d'utilisateurs se présentent sous la forme suivante:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Type de cette liste.

Ce champ est en lecture seule.

id

string (int64 format)

Identifiant de la liste d'utilisateurs.

name

string

Nom de cette liste d'utilisateurs. En fonction de son motif d'accès (access_reason), le nom de la liste d'utilisateurs peut ne pas être unique (par exemple, si access_reason=SHARED).

UserListType

Énumération contenant les types de listes d'utilisateurs possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
REMARKETING UserList représenté par un ensemble de types de conversion.
LOGICAL UserList représenté par une combinaison d'autres listes d'utilisateurs/centres d'intérêt.
EXTERNAL_REMARKETING Liste d'utilisateurs créée sur la plate-forme Google Ad Manager.
RULE_BASED UserList associé à une règle.
SIMILAR UserList avec des utilisateurs semblables à ceux d'une autre UserList.
CRM_BASED UserList de données CRM first party fournies par l'annonceur sous forme d'e-mails ou d'autres formats.

WebpageView

Affichage d'une page Web.

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

string

Nom de ressource de la vue de la page Web. Le nom des ressources de la vue Page Web se présente sous la forme suivante:

customers/{customerId}/webpageViews/{ad_group_id}~{criterionId}

Accéder à la page

Une visite.

Représentation JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitDateTime": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Champs
resourceName

string

Nom de ressource de la visite. Les noms des ressources de visite se présentent comme suit:

customers/{customerId}/visits/{ad_group_id}~{criterionId}~{ds_visit_id}

id

string (int64 format)

ID de la visite.

criterionId

string (int64 format)

Identifiant de mot clé Search Ads 360 La valeur 0 indique que le mot clé n'est pas attribué.

merchantId

string (int64 format)

ID de compte de l'inventaire Search Ads 360 contenant le produit ayant fait l'objet d'un clic. Search Ads 360 génère cet identifiant lorsque vous associez un compte d'inventaire dans Search Ads 360.

adId

string (int64 format)

Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée.

clickId

string

Chaîne unique pour chaque visite, transmise à la page de destination en tant que paramètre d'URL d'ID de clic.

visitDateTime

string

Code temporel de l'événement de visite. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

productId

string

Identifiant du produit ayant fait l'objet d'un clic.

productChannel

enum (ProductChannel)

Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin.

productLanguageCode

string

Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit.

productStoreId

string

Magasin associé à l'annonce produit en magasin ayant fait l'objet d'un clic. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin.

productCountryCode

string

Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic.

assetId

string (int64 format)

ID du composant avec lequel l'utilisateur a interagi lors de l'événement de visite.

assetFieldType

enum (AssetFieldType)

Type de champ de composant de l'événement de visite.

ProductChannel

Énumération décrivant la localité d'une offre de produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ONLINE L'article est vendu en ligne.
LOCAL L'article est vendu dans des magasins à proximité.

Conversion

Une conversion.

Représentation JSON
{
  "resourceName": string,
  "id": string,
  "criterionId": string,
  "merchantId": string,
  "adId": string,
  "clickId": string,
  "visitId": string,
  "advertiserConversionId": string,
  "productId": string,
  "productChannel": enum (ProductChannel),
  "productLanguageCode": string,
  "productStoreId": string,
  "productCountryCode": string,
  "attributionType": enum (AttributionType),
  "conversionDateTime": string,
  "conversionLastModifiedDateTime": string,
  "conversionVisitDateTime": string,
  "conversionQuantity": string,
  "conversionRevenueMicros": string,
  "floodlightOriginalRevenue": string,
  "floodlightOrderId": string,
  "status": enum (ConversionStatus),
  "assetId": string,
  "assetFieldType": enum (AssetFieldType)
}
Champs
resourceName

string

Nom de ressource de la conversion. Le nom des ressources de conversion se présente sous la forme suivante:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

Identifiant de la conversion

criterionId

string (int64 format)

ID du critère Search Ads 360. Une valeur de 0 indique que le critère n'est pas attribué.

merchantId

string (int64 format)

ID de compte de l'inventaire Search Ads 360 contenant le produit ayant fait l'objet d'un clic. Search Ads 360 génère cet identifiant lorsque vous associez un compte d'inventaire dans Search Ads 360.

adId

string (int64 format)

Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée.

clickId

string

Chaîne unique, pour la visite à laquelle la conversion est attribuée, transmise à la page de destination en tant que paramètre d'URL d'ID de clic.

visitId

string (int64 format)

ID de la visite Search Ads 360 à laquelle la conversion est attribuée.

advertiserConversionId

string

Pour les conversions hors connexion, il s'agit d'un identifiant fourni par les annonceurs. Si un annonceur ne spécifie pas un tel identifiant, Search Ads 360 en génère un. Pour les conversions en ligne, elle correspond à la colonne "ID" ou à la colonne "FloodlightOrderId" selon les instructions Floodlight de l'annonceur.

productId

string

Identifiant du produit ayant fait l'objet d'un clic.

productChannel

enum (ProductChannel)

Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin.

productLanguageCode

string

Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit.

productStoreId

string

Magasin associé à l'annonce produit en magasin ayant fait l'objet d'un clic. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin.

productCountryCode

string

Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic.

attributionType

enum (AttributionType)

Élément auquel la conversion est attribuée : visite ou mot clé + annonce.

conversionDateTime

string

Code temporel de l'événement de conversion.

conversionLastModifiedDateTime

string

Code temporel de la dernière modification de la conversion.

conversionVisitDateTime

string

Code temporel de la visite à laquelle la conversion est attribuée.

conversionQuantity

string (int64 format)

Quantité d'articles enregistrés par la conversion, telle que déterminée par le paramètre d'URL qty. L'annonceur est responsable du remplissage dynamique du paramètre (par exemple avec le nombre d'articles vendus dans le cadre de la conversion). Sinon, la valeur par défaut est définie sur 1.

conversionRevenueMicros

string (int64 format)

Revenus ajustés en micro-unités pour l'événement de conversion. Cette valeur est toujours dans la devise du compte de diffusion.

floodlightOriginalRevenue

string (int64 format)

Revenus initiaux non modifiés associés à l'événement Floodlight (dans la devise du rapport actuel), avant la modification des instructions de devise Floodlight.

floodlightOrderId

string

ID de commande Floodlight fourni par l'annonceur pour la conversion.

status

enum (ConversionStatus)

État de la conversion (ACTIVÉ ou SUPPRIMÉ)

assetId

string (int64 format)

ID du composant avec lequel vous avez interagi lors de l'événement de conversion.

assetFieldType

enum (AssetFieldType)

Type de champ de composant de l'événement de conversion.

AttributionType

Type d'attribution des conversions dans SearchAds360

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
VISIT La conversion est attribuée à une visite.
CRITERION_AD La conversion est attribuée à un critère et à une paire d'annonces.

ConversionStatus

États possibles d'une conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ENABLED La conversion est activée.
REMOVED La conversion a été supprimée.

Métriques

Données de métriques.

Représentation JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Champs
allConversionsValueByConversionDate

number

Valeur de toutes les conversions. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "date" correspondent à la date de conversion. Vous trouverez des informations détaillées sur les colonnes "by_conversion_date" à l'adresse https://support.google.com/sa360/answer/9250611.

allConversionsByConversionDate

number

Nombre total de conversions. Toutes les conversions sont incluses, quelle que soit la valeur includeInConversionsMetric. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "date" correspondent à la date de conversion. Vous trouverez des informations détaillées sur les colonnes "by_conversion_date" à l'adresse https://support.google.com/sa360/answer/9250611.

conversionCustomMetrics[]

object (Value)

Les métriques personnalisées de conversion.

conversionsValueByConversionDate

number

Somme des conversions enchérissables par date de conversion. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "date" correspondent à la date de conversion.

conversionsByConversionDate

number

Somme des conversions par date de conversion pour les types de conversions enchérissables. Peut être fractionnaire en raison de la modélisation de l'attribution. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "date" correspondent à la date de conversion.

historicalCreativeQualityScore

enum (QualityScoreBucket)

Historique du niveau de qualité de la création.

historicalLandingPageQualityScore

enum (QualityScoreBucket)

la qualité de l'historique de l'expérience sur la page de destination ;

historicalSearchPredictedCtr

enum (QualityScoreBucket)

L'historique du taux de clics (CTR) prévu des recherches.

interactionEventTypes[]

enum (InteractionEventType)

Types d'interactions payantes et sans frais.

rawEventConversionMetrics[]

object (Value)

Métriques brutes sur les conversions d'événements.

absoluteTopImpressionPercentage

number

Le taux d'impressions en première position absolue sur le Réseau de Recherche correspond au pourcentage d'impressions de vos annonces diffusées à la position la plus proéminente sur le Réseau de Recherche.

allConversionsFromInteractionsRate

number

Nombre total de conversions générées par les interactions (et non par les conversions après affichage) divisé par le nombre d'interactions avec l'annonce.

allConversionsValue

number

Valeur de toutes les conversions.

allConversions

number

Nombre total de conversions. Toutes les conversions sont incluses, quelle que soit la valeur includeInConversionsMetric.

allConversionsValuePerCost

number

Valeur de toutes les conversions divisée par le coût total des interactions avec vos annonces (clics pour les annonces textuelles, visionnages pour les annonces vidéo, etc.).

allConversionsFromClickToCall

number

Nombre de fois où les utilisateurs ont cliqué sur le bouton "Appeler" pour contacter un magasin pendant ou après avoir cliqué sur une annonce. Ce nombre n'indique pas si les appels ont réussi ou non, ni leur durée.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromDirections

number

Nombre de fois où les internautes ont cliqué sur le bouton "Itinéraire" pour se rendre dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromInteractionsValuePerInteraction

number

Valeur de toutes les conversions issues des interactions divisée par le nombre total d'interactions.

allConversionsFromMenu

number

Nombre de fois où les internautes ont cliqué sur un lien vers le menu d'un établissement après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromOrder

number

Nombre de fois où les utilisateurs ont passé une commande dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromOtherEngagement

number

Nombre de conversions autres (par exemple, la publication d'un avis ou l'enregistrement de l'adresse du magasin) effectuées par les utilisateurs après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromStoreVisit

number

Estimation du nombre de fois où les utilisateurs se sont rendus dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

visits

number

Clics que Search Ads 360 a bien enregistrés et transférés vers la page de destination d'un annonceur.

allConversionsFromStoreWebsite

number

Nombre de fois où les internautes ont été redirigés vers l'URL d'un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

averageCost

number

Montant moyen que vous payez par interaction. Cette somme correspond au coût total de vos annonces divisé par le nombre total d'interactions.

averageCpc

number

Coût total de tous les clics divisé par le nombre total de clics reçus. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

averageCpm

number

Coût moyen pour mille impressions (CPM). Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

string (int64 format)

Nombre de clics.

contentBudgetLostImpressionShare

number

Estimation, en pourcentage, du nombre de fois où votre annonce était susceptible d'être diffusée sur le Réseau Display, mais ne l'a pas été en raison d'un budget trop faible. Remarque: Le taux d'impressions perdues en raison du budget de contenu est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

contentImpressionShare

number

Il s'agit du nombre d'impressions enregistrées sur le Réseau Display, divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Remarque : le taux d'impressions du contenu est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

contentRankLostImpressionShare

number

Estimation du pourcentage d'impressions que vos annonces n'ont pas reçues sur le Réseau Display en raison d'un mauvais classement. Remarque : le taux d'impressions perdues dans le classement du contenu est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

conversionsFromInteractionsRate

number

Nombre moyen de conversions enchérissables (à partir d'une interaction) par interaction éligible à la conversion. Indique la fréquence moyenne à laquelle une interaction avec une annonce génère une conversion enchérissable.

clientAccountConversionsValue

number

Valeur des conversions de compte client. Cela n'inclut que les actions de conversion pour lesquelles l'attribut includeInClientAccountConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

conversionsValuePerCost

number

Valeur d'une conversion enchérissable divisée par le coût total des interactions éligibles à la conversion.

conversionsFromInteractionsValuePerInteraction

number

Valeur des conversions issues des interactions divisée par le nombre d'interactions avec l'annonce. Cela n'inclut que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

clientAccountConversions

number

Nombre de conversions de comptes client. Cela n'inclut que les actions de conversion pour lesquelles l'attribut includeInClientAccountConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

costMicros

string (int64 format)

Somme du coût par clic (CPC) et du coût par mille impressions (CPM) enregistrés au cours de la période concernée. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

costPerAllConversions

number

Coût des interactions avec les annonces divisé par le nombre total de conversions.

costPerConversion

number

Coût moyen éligible à la conversion par conversion enchérissable.

costPerCurrentModelAttributedConversion

number

Coût des interactions avec une annonce divisé par le nombre de conversions attribuées par le modèle actuel. Cela n'inclut que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

crossDeviceConversions

number

Conversions enregistrées lorsqu'un client clique sur une annonce sur un appareil, puis effectue une conversion sur un autre appareil ou navigateur. Les conversions multi-appareils sont déjà incluses dans "Toutes les conversions".

crossDeviceConversionsValue

number

Somme de la valeur des conversions multi-appareils.

ctr

number

Nombre de clics sur votre annonce (clics) divisé par le nombre d'affichages de celle-ci (impressions).

conversions

number

Nombre de conversions Cela n'inclut que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

conversionsValue

number

Somme des valeurs de conversion incluses dans le champ "Conversions". Cette métrique n'est utile que si vous avez associé une valeur à vos actions de conversion.

historicalQualityScore

string (int64 format)

Historique du niveau de qualité.

impressions

string (int64 format)

Fréquence à laquelle votre annonce a été diffusée sur une page de résultats de recherche ou sur un site Web du Réseau Google.

interactionRate

number

Il s'agit de la fréquence à laquelle les utilisateurs interagissent avec votre annonce une fois qu'ils l'ont vue. Il s'agit du nombre d'interactions divisé par le nombre de fois où votre annonce est diffusée.

interactions

string (int64 format)

Nombre d'interactions. Une interaction correspond à la principale action effectuée par l'utilisateur en fonction du format de l'annonce : clics pour les annonces textuelles et Shopping, visionnages pour les annonces vidéo, etc.

invalidClickRate

number

Pourcentage de clics filtrés par rapport au nombre total de clics (clics filtrés et non filtrés) au cours de la période de référence.

invalidClicks

string (int64 format)

Nombre de clics que Google considère comme étant illicites et ne vous sont donc pas facturés.

mobileFriendlyClicksPercentage

number

Pourcentage de clics sur mobile redirigeant vers une page adaptée aux mobiles.

searchAbsoluteTopImpressionShare

number

Pourcentage d'impressions d'annonces Shopping ou sur le Réseau de Recherche du client diffusées à la position la plus visible (Shopping). Pour en savoir plus, consultez la page https://support.google.com/sa360/answer/9566729. Toute valeur inférieure à 0,1 est signalée à 0,0999.

searchBudgetLostAbsoluteTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée en toute première position parmi les annonces les plus performantes dans les résultats de recherche en raison d'un budget trop faible. Remarque: Le taux d'impressions perdues en première position absolue pour le budget sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchBudgetLostImpressionShare

number

Estimation du pourcentage de fois où votre annonce était susceptible d'être diffusée sur le Réseau de Recherche, mais ne l'a pas été en raison d'un budget trop faible. Remarque : le taux d'impressions perdues sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchBudgetLostTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée à côté des meilleurs résultats de recherche naturels en raison d'un budget faible. Remarque: Le taux d'impressions perdues en première position (budget) sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchClickShare

number

Nombre de clics générés sur le Réseau de Recherche divisé par le nombre estimé de clics susceptibles d'avoir été enregistrés. Remarque: La part de clics sur le Réseau de Recherche est comprise entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

searchExactMatchImpressionShare

number

Nombre d'impressions enregistrées par vos annonces, divisé par le nombre estimé d'impressions qu'elles étaient susceptibles d'enregistrer sur le Réseau de Recherche pour des termes de recherche correspondant exactement à vos mots clés (ou correspondant à des variantes proches), quels que soient les types de correspondance de vos mots clés. Remarque: Le taux d'impressions pour les mots clés exacts sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

searchImpressionShare

number

Il s'agit du nombre d'impressions enregistrées sur le Réseau de Recherche, divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Remarque : le taux d'impressions sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce n'a pas été en première position parmi les annonces les plus performantes dans les résultats de recherche en raison de son mauvais classement. Remarque: Le taux d'impressions perdues en première position absolue sur le classement sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchRankLostImpressionShare

number

Estimation du pourcentage d'impressions que vos annonces n'ont pas reçues sur le Réseau de Recherche en raison d'un mauvais classement. Remarque : le taux d'impressions perdues pour le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchRankLostTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée à côté des meilleurs résultats de recherche naturels en raison de son mauvais classement. Remarque: Le taux d'impressions perdues en première position dans le classement sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchTopImpressionShare

number

Il s'agit du nombre d'impressions enregistrées par vos annonces les plus performantes par rapport au nombre estimé d'impressions que vous auriez pu enregistrer avec ces annonces. Remarque: Le taux d'impressions en première position sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

Les meilleures annonces apparaissent généralement au-dessus des premiers résultats naturels, même si pour certaines requêtes, elles peuvent s'afficher en dessous des résultats naturels en haut de page.

topImpressionPercentage

number

Pourcentage de vos impressions d'annonces diffusées à côté des meilleurs résultats de recherche naturels.

valuePerAllConversions

number

Valeur de toutes les conversions divisée par le nombre total de conversions.

valuePerAllConversionsByConversionDate

number

Valeur de toutes les conversions divisée par le nombre total de conversions. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "date" correspondent à la date de conversion. Vous trouverez des informations détaillées sur les colonnes "by_conversion_date" à l'adresse https://support.google.com/sa360/answer/9250611.

valuePerConversion

number

Valeur d'une conversion enchérissable divisée par le nombre de conversions enchérissables. Indique la valeur moyenne de chacune des conversions enchérissables.

valuePerConversionsByConversionDate

number

Valeur des conversions enchérissables par date de conversion divisée par les conversions enchérissables par date de conversion. Indique la valeur moyenne de chacune des conversions enchérissables (par date de conversion). Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "date" correspondent à la date de conversion.

clientAccountViewThroughConversions

string (int64 format)

Nombre total de conversions après affichage Cela se produit lorsqu'un client voit une annonce illustrée ou rich media, puis effectue ultérieurement une conversion sur votre site sans interagir avec une autre annonce (par exemple, en cliquant dessus).

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Le prix de revient des ventes croisées du compte client correspond au coût total des produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Le prix de revient des ventes croisées correspond au coût total des produits vendus dont vous n'avez pas fait la promotion. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 € et celui de la chemise est de 5 €. Le prix de revient des ventes croisées pour cette commande est de 5 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellCostOfGoodsSoldMicros

string (int64 format)

Le prix de revient des ventes croisées correspond au coût total des produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Le prix de revient des ventes croisées correspond au coût total des produits vendus dont vous n'avez pas fait la promotion. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 € et celui de la chemise est de 5 €. Le prix de revient des ventes croisées pour cette commande est de 5 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellGrossProfitMicros

string (int64 format)

La marge brute des ventes croisées du compte client correspond aux bénéfices générés par les produits vendus suite à la promotion d'un autre produit, moins le prix de revient. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. La marge brute des ventes croisées correspond au revenu généré par la vente croisée attribuée à vos annonces, moins le prix de revient. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La chemise coûte 20 $, et son prix de revient est de 5 $. La marge brute de la vente croisée de cette commande est égale à 20 $ - 5 $, soit 15 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellGrossProfitMicros

string (int64 format)

La marge brute des ventes croisées correspond aux bénéfices générés par les produits vendus suite à la promotion d'un autre produit, moins le prix de revient. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. La marge brute des ventes croisées correspond au revenu généré par la vente croisée attribuée à vos annonces, moins le prix de revient. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La chemise coûte 20 $, et son prix de revient est de 5 $. La marge brute de la vente croisée de cette commande est égale à 20 $ - 5 $, soit 15 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellRevenueMicros

string (int64 format)

Les revenus des ventes croisées du compte client correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les revenus des ventes croisées correspondent à la valeur totale des ventes croisées attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus de la vente croisée pour cette commande sont de 20 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

crossSellRevenueMicros

string (int64 format)

Les revenus des ventes croisées correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les revenus des ventes croisées correspondent à la valeur totale des ventes croisées attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus de la vente croisée pour cette commande sont de 20 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountCrossSellUnitsSold

number

Les unités vendues via les ventes croisées du compte client correspondent au nombre total de produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les unités vendues via les ventes croisées correspondent au nombre total de produits vendus par vente croisée issus de toutes les commandes attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues via les ventes croisées dans cette commande est de 2. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

crossSellUnitsSold

number

La métrique "Unités vendues via les ventes croisées" correspond au nombre total de produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les unités vendues via les ventes croisées correspondent au nombre total de produits vendus par vente croisée issus de toutes les commandes attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues via les ventes croisées dans cette commande est de 2. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

Le coût de vente lié aux prospects dans le compte client correspond au coût total des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, leur coût est comptabilisé comme coût de vente lié aux prospects. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 € et celui de la chemise est de 5 €. Le coût de vente lié aux prospects pour cette commande est de 3 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadCostOfGoodsSoldMicros

string (int64 format)

Le coût de vente lié aux prospects correspond au coût total des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, leur coût est comptabilisé comme coût de vente lié aux prospects. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 € et celui de la chemise est de 5 €. Le coût de vente lié aux prospects pour cette commande est de 3 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadGrossProfitMicros

string (int64 format)

La marge brute des prospects dans le compte client correspond aux bénéfices générés par les produits vendus suite à la promotion de ces mêmes produits, moins le prix de revient. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, votre marge brute des prospects est calculée comme suit : revenus générés par ces ventes moins le prix de revient. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 € et a une valeur de 3 € pour le prix de revient. La marge brute des prospects pour cette commande est égale à 7 €, soit 10 € - 3 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadGrossProfitMicros

string (int64 format)

La marge brute des prospects correspond aux bénéfices générés par les produits vendus suite à la promotion de ces mêmes produits, moins le prix de revient. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, votre marge brute des prospects est calculée comme suit : revenus générés par ces ventes moins le prix de revient. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 € et a une valeur de 3 € pour le prix de revient. La marge brute des prospects pour cette commande est égale à 7 €, soit 10 € - 3 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadRevenueMicros

string (int64 format)

Les revenus des prospects du compte client correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, la valeur totale des ventes de ces produits s'affiche sous "Revenus des prospects". Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus des prospects pour cette commande sont de 10 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

leadRevenueMicros

string (int64 format)

Les revenus des prospects correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, la valeur totale des ventes de ces produits s'affiche sous "Revenus des prospects". Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus des prospects pour cette commande sont de 10 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clientAccountLeadUnitsSold

number

La métrique "Unités vendues aux prospects dans le compte client" correspond au nombre total de produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, le nombre total de ces produits vendus s'affiche sous "Unités vendues aux prospects". Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues aux prospects dans cette commande est de 1. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

leadUnitsSold

number

La métrique "Unités du prospect vendues" correspond au nombre total de produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, le nombre total de ces produits vendus s'affiche sous "Unités vendues aux prospects". Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues aux prospects dans cette commande est de 1. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

Valeur

Conteneur de données générique

Représentation JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. une valeur. value ne peut être qu'un des éléments suivants :
booleanValue

boolean

Valeur booléenne.

int64Value

string (int64 format)

Un int64.

floatValue

number

Flottant.

doubleValue

number

Valeur double.

stringValue

string

Chaîne.

QualityScoreBucket

Énumération répertoriant les ensembles de niveaux de qualité possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
BELOW_AVERAGE La qualité de la création est inférieure à la moyenne.
AVERAGE La qualité de la création est moyenne.
ABOVE_AVERAGE La qualité de la création est supérieure à la moyenne.

InteractionEventType

Énumération décrivant les types possibles d'interactions payantes et sans frais.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
CLICK Cliquez pour accéder au site. Dans la plupart des cas, cette interaction conduit à un emplacement externe, généralement la page de destination de l'annonceur. Il s'agit également de l'InteractionEventType par défaut pour les événements de clic.
ENGAGEMENT L'intention de l'utilisateur d'interagir avec l'annonce sur place.
VIDEO_VIEW Un utilisateur a visionné une annonce vidéo.
NONE InteractionEventType par défaut pour les événements de conversion d'annonce. Ce type de conversion est utilisé lorsqu'une ligne de conversion d'annonce n'indique PAS que les interactions sans frais (par exemple, les conversions d'annonces) doivent être "sponsorisées" et comptabilisées dans les métriques principales. Il s'agit simplement d'autres conversions (d'annonces).

Segments

Champs "Segmenter uniquement"

Représentation JSON
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Champs
adNetworkType

enum (AdNetworkType)

Type de réseau publicitaire.

conversionActionCategory

enum (ConversionActionCategory)

Catégorie d'action de conversion.

conversionCustomDimensions[]

object (Value)

Dimensions personnalisées de conversion

dayOfWeek

enum (DayOfWeek)

Jour de la semaine (par exemple, MONDAY).

device

enum (Device)

Appareil auquel les métriques s'appliquent.

keyword

object (Keyword)

Critère de mot clé.

productChannel

enum (ProductChannel)

Canal du produit.

productChannelExclusivity

enum (ProductChannelExclusivity)

Exclusivité de canal du produit.

productCondition

enum (ProductCondition)

État du produit.

productSoldCondition

enum (ProductCondition)

État du produit vendu.

rawEventConversionDimensions[]

object (Value)

Dimensions brutes pour les conversions d'événements.

conversionAction

string

Nom de ressource de l'action de conversion.

conversionActionName

string

Nom de l'action de conversion

date

string

Date à laquelle les métriques s'appliquent, au format aaaa-MM-jj, par exemple 2018-04-17.

month

string

Mois, représenté par la date du premier jour du mois. Format aaaa-MM-jj.

productBiddingCategoryLevel1

string

Catégorie d'enchères (niveau 1) du produit.

productBiddingCategoryLevel2

string

Catégorie d'enchères (niveau 2) du produit.

productBiddingCategoryLevel3

string

Catégorie d'enchères (niveau 3) du produit.

productBiddingCategoryLevel4

string

Catégorie d'enchères (niveau 4) du produit.

productBiddingCategoryLevel5

string

Catégorie d'enchères (niveau 5) du produit.

productBrand

string

Marque du produit.

productCountry

string

Nom de ressource de la constante de ciblage géographique pour le pays de vente du produit.

productCustomAttribute0

string

Attribut personnalisé 0 du produit.

productCustomAttribute1

string

Attribut personnalisé 1 du produit.

productCustomAttribute2

string

Attribut personnalisé 2 du produit.

productCustomAttribute3

string

Attribut personnalisé 3 du produit.

productCustomAttribute4

string

Attribut personnalisé 4 du produit.

productItemId

string

ID d'article du produit.

productLanguage

string

Nom de ressource de la constante de langue du produit.

productSoldBiddingCategoryLevel1

string

Catégorie d'enchères (niveau 1) du produit vendu.

productSoldBiddingCategoryLevel2

string

Catégorie d'enchères (niveau 2) du produit vendu.

productSoldBiddingCategoryLevel3

string

Catégorie d'enchères (niveau 3) du produit vendu.

productSoldBiddingCategoryLevel4

string

Catégorie d'enchères (niveau 4) du produit vendu.

productSoldBiddingCategoryLevel5

string

Catégorie d'enchères (niveau 5) du produit vendu.

productSoldBrand

string

Marque du produit vendu.

productSoldCustomAttribute0

string

Attribut personnalisé 0 du produit vendu.

productSoldCustomAttribute1

string

Attribut personnalisé 1 du produit vendu.

productSoldCustomAttribute2

string

Attribut personnalisé 2 du produit vendu.

productSoldCustomAttribute3

string

Attribut personnalisé 3 du produit vendu.

productSoldCustomAttribute4

string

Attribut personnalisé 4 du produit vendu.

productSoldItemId

string

ID d'article du produit vendu.

productSoldTitle

string

Titre du produit vendu.

productSoldTypeL1

string

Type (niveau 1) du produit vendu.

productSoldTypeL2

string

Type (niveau 2) du produit vendu.

productSoldTypeL3

string

Type (niveau 3) du produit vendu.

productSoldTypeL4

string

Type (niveau 4) du produit vendu.

productSoldTypeL5

string

Type (niveau 5) du produit vendu.

productStoreId

string

ID de magasin associé au produit.

productTitle

string

Titre du produit.

productTypeL1

string

Type (niveau 1) du produit.

productTypeL2

string

Type (niveau 2) du produit.

productTypeL3

string

Type (niveau 3) du produit.

productTypeL4

string

Type (niveau 4) du produit.

productTypeL5

string

Type (niveau 5) du produit.

quarter

string

Trimestre représenté par la date du premier jour du trimestre. Utilise l'année civile pour les trimestres. Par exemple, le deuxième trimestre 2018 commence le 01/04/2018. Format aaaa-MM-jj.

week

string

Semaine, correspondant à la période du lundi au dimanche, et représentée par le lundi. Format aaaa-MM-jj.

year

integer

Année, au format aaaa.

assetInteractionTarget

object (AssetInteractionTarget)

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et GroupAsset. Indique si les métriques d'interaction concernent le composant lui-même, ou un autre composant ou bloc d'annonces. Les interactions (par exemple, les clics) sont comptabilisées à travers toutes les parties de l'annonce diffusée (par exemple, l'annonce elle-même et d'autres composants tels que les liens annexes) lorsqu'elles sont diffusées ensemble. Lorsque interactionOnThisAsset est défini sur "true", cela signifie que les interactions ont lieu sur cet élément spécifique. Si interactionOnThisAsset a la valeur "false", cela signifie que les interactions ont lieu non sur cet élément spécifique, mais sur d'autres parties de l'annonce diffusée avec cet élément.

AdNetworkType

Énumère les types de réseaux Google Ads.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
SEARCH Recherche Google
SEARCH_PARTNERS Partenaires du Réseau de Recherche
CONTENT Réseau Display
YOUTUBE_WATCH Vidéos YouTube
MIXED Multiréseau.

Mot clé

Un segment de critère de mot-clé.

Représentation JSON
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Champs
info

object (KeywordInfo)

Informations sur le mot clé.

adGroupCriterion

string

Nom de la ressource Critère.

ProductChannelExclusivity

Énumération décrivant la disponibilité d'une offre de produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SINGLE_CHANNEL Cet article est vendu via un seul canal, soit en magasin, soit en ligne, comme indiqué par son ProductChannel.
MULTI_CHANNEL L'article est mis en correspondance avec son équivalent en ligne ou dans les magasins locaux, ce qui indique qu'il est disponible à l'achat sur les deux canaux ShoppingProductChannel.

ProductCondition

Énumération décrivant l'état d'une offre de produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
OLD L'état du produit est ancien.
NEW Le produit est neuf.
REFURBISHED Le produit est reconditionné.
USED L'état du produit est utilisé.

AssetInteractionTarget

Un segment AssetInteractionTarget.

Représentation JSON
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Champs
asset

string

Nom de la ressource de l'élément.

interactionOnThisAsset

boolean

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et GroupAsset. Indique si les métriques d'interaction concernent le composant lui-même, ou un autre composant ou bloc d'annonces.