SearchAds360Row

Une ligne renvoyée par la requête.

Représentation JSON 
{
  "adGroup": {
    object (AdGroup)
  },
  "adGroupAd": {
    object (AdGroupAd)
  },
  "adGroupAdEffectiveLabel": {
    object (AdGroupAdEffectiveLabel)
  },
  "adGroupAdLabel": {
    object (AdGroupAdLabel)
  },
  "adGroupAsset": {
    object (AdGroupAsset)
  },
  "adGroupAssetSet": {
    object (AdGroupAssetSet)
  },
  "adGroupAudienceView": {
    object (AdGroupAudienceView)
  },
  "adGroupBidModifier": {
    object (AdGroupBidModifier)
  },
  "adGroupCriterion": {
    object (AdGroupCriterion)
  },
  "adGroupCriterionEffectiveLabel": {
    object (AdGroupCriterionEffectiveLabel)
  },
  "adGroupCriterionLabel": {
    object (AdGroupCriterionLabel)
  },
  "adGroupEffectiveLabel": {
    object (AdGroupEffectiveLabel)
  },
  "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)
  },
  "campaignEffectiveLabel": {
    object (CampaignEffectiveLabel)
  },
  "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)
  },
  "userLocationView": {
    object (UserLocationView)
  },
  "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.
adGroupAdEffectiveLabel

object (AdGroupAdEffectiveLabel)

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

object (AdGroupAdLabel)

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

object (AdGroupAsset)

Élément 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.
adGroupCriterionEffectiveLabel

object (AdGroupCriterionEffectiveLabel)

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

object (AdGroupCriterionLabel)

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

object (AdGroupEffectiveLabel)

Libellé effectif 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'asset référencé dans la requête.
assetGroupAsset

object (AssetGroupAsset)

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

object (AssetGroupSignal)

Signal du groupe d'éléments référencé dans la requête.
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

Filtre de groupe de fiches de groupe d'assets référencé dans la requête.
assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

Vue de la combinaison de composants la plus performante du groupe de composants 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 d'assets 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 de l'audience de la campagne référencée dans la requête.
campaignCriterion

object (CampaignCriterion)

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

object (CampaignEffectiveLabel)

Libellé de la campagne effective 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)

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

object (CustomerAssetSet)

Ensemble d'assets 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 du terme de recherche des annonces dynamiques du Réseau de Recherche référencée dans la requête.
genderView

object (GenderView)

Vue sur le genre référencée dans la requête.
geoTargetConstant

object (GeoTargetConstant)

Constante de ciblage 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 des utilisateurs référencés dans la requête.
userLocationView

object (UserLocationView)

Vue de l'emplacement de l'utilisateur 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
  ],
  "effectiveLabels": [
    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 de groupe d'annonces se présentent sous la forme suivante:

customers/{customerId}/adGroups/{ad_group_id}
status

enum (AdGroupStatus)

État du groupe d'annonces.
type

enum (AdGroupType)

Type du groupe d'annonces.
adRotationMode

enum (AdGroupAdRotationMode)

Mode de rotation des annonces du groupe d'annonces.
creationTime

string

Horodatage 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 pour les fonctionnalités liées au ciblage.
labels[]

string

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

string

Noms de ressources des libellés effectifs associés à ce groupe d'annonces. Un libellé efficace est un libellé hérité ou directement attribué à 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 réservée aux réponses.
ENABLED Le groupe d'annonces est activé.
PAUSED Le groupe d'annonces est mis en veille.
REMOVED Le groupe d'annonces est supprimé.

AdGroupType

Enumération listant 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 réservée aux réponses.
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 Shopping pour un produit standards.
SHOPPING_SHOWCASE_ADS Type de groupes d'annonces limités à la diffusion d'annonces Showcase ou de marchands 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 des groupes d'annonces dans les campagnes Shopping intelligentes.
VIDEO_BUMPER Annonces vidéo InStream courtes et non désactivables
VIDEO_TRUE_VIEW_IN_STREAM Annonces vidéo TrueView InStream désactivables
VIDEO_TRUE_VIEW_IN_DISPLAY Annonces vidéo TrueView InDisplay
VIDEO_NON_SKIPPABLE_IN_STREAM Les annonces vidéo InStream non désactivables.
VIDEO_OUTSTREAM Les 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 de groupes d'annonces dans les campagnes Shopping "Fiches comparateur de prix".
PROMOTED_HOTEL_ADS Type de groupe d'annonces pour les groupes d'annonces pour la promotion d'hôtels.
VIDEO_RESPONSIVE Groupes d'annonces vidéo responsives
VIDEO_EFFICIENT_REACH Groupes d'annonces vidéo "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 pour 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 réservée aux réponses.
OPTIMIZE Optimisez les annonces de votre groupe d'annonces en fonction des clics ou des conversions.
ROTATE_FOREVER Alternez de manière régulière sans interruption.

AdGroupEngineStatus

État du moteur du groupe d'annonces.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 toujours en brouillon.
AD_GROUP_PAUSED Le groupe d'annonces a été mis en veille.
AD_GROUP_SERVING Le groupe d'annonces est actif et diffuse actuellement des annonces.
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 liées au 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 vos annonces doivent être diffusées uniquement pour les critères que vous avez sélectionnés pour cette targetingDimension, ou si vous devez cibler toutes les valeurs de cette targetingDimension et diffuser des annonces en fonction de votre ciblage dans d'autres targetingDimensions. La valeur true signifie que ces critères n'appliqueront que les modificateurs d'enchères et n'auront aucune incidence sur le ciblage. La valeur false signifie que ces critères limiteront le ciblage et l'application de 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 la valeur inconnue dans cette version.
KEYWORD Critères de mots clés (par exemple, "croisière mars"). KEYWORD peut être utilisé comme dimension d'enchère personnalisée. Les mots clés sont toujours une dimension de ciblage. Ils ne peuvent donc pas être définis comme dimension cible "TOUT" avec TargetRestriction.
AUDIENCE Critères d'audience, y compris la liste d'utilisateurs, les centres d'intérêt des utilisateurs, l'affinité personnalisée et les audiences personnalisées sur le marché
TOPIC Critères de thème pour cibler des catégories de contenu (par exemple, "category::Animals>Pets"). Utilisés pour le ciblage display et vidéo.
GENDER Critères de ciblage par genre.
AGE_RANGE Critères de ciblage des tranches d'âge.
PLACEMENT Critères d'emplacement, y compris les sites Web tels que "www.flowers4sale.com", ainsi que les applications mobiles, les catégories d'applications mobiles, les vidéos YouTube et les chaînes YouTube.
PARENTAL_STATUS Critères de ciblage par statut parental.
INCOME_RANGE Critères de ciblage par tranche de revenus.

AdGroupAd

Annonce intégrée à un groupe

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

string

Nom de ressource de l'annonce. Les noms de ressources d'annonces de groupe d'annonces se présentent sous la forme suivante:

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

enum (AdGroupAdStatus)

État de l'annonce.
ad

object (Ad)

Annonce.
creationTime

string

Horodatage de la création de cet 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.
effectiveLabels[]

string

Noms de ressource des étiquettes effectives associées à cette annonce. Un libellé efficace est un libellé hérité ou directement attribué à cette annonce.
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 les entités autres 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 états possibles d'un 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 est 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 réservée aux réponses.
TEXT_AD L'annonce est une annonce textuelle.
EXPANDED_TEXT_AD L'annonce est 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 sur le 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 L'annonce est 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 Il s'agit d'une annonce 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 Il s'agit d'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 importée 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 en magasin.
VIDEO_BUMPER_AD Annonce vidéo bumper.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Annonce InStream vidéo 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 de campagne intelligente.
APP_PRE_REGISTRATION_AD Annonce de préinscription à une application universelle.
DISCOVERY_MULTI_ASSET_AD Annonce Discovery avec plusieurs composants
TRAVEL_AD Annonce de voyage.
DISCOVERY_VIDEO_RESPONSIVE_AD Annonce vidéo Discovery responsive
MULTIMEDIA_AD Annonce multimédia.

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 affichée de l'annonce
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 séparateur.
path2

string

Texte ajouté à path1 avec un délimiteur.
adTrackingId

string (int64 format)

Identifiant de suivi de l'annonce.

SearchAds360ResponsiveSearchAdInfo

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

Représentation JSON 
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string,
  "adTrackingId": string
}
Champs
headlines[]

object (AdTextAsset)

Liste des composants texte pour les titres. Lors de la diffusion de l'annonce, les titres sont sélectionnés dans cette liste.
descriptions[]

object (AdTextAsset)

Liste des composants texte pour les descriptions. Lorsque l'annonce est diffusée, les descriptions sont sélectionnées dans cette liste.
path1

string

Texte ajouté à l'URL visible générée automatiquement avec un séparateur.
path2

string

Texte ajouté à path1 avec un délimiteur.
adTrackingId

string (int64 format)

Identifiant de suivi de l'annonce.

AdTextAsset

Composant texte utilisé dans une annonce.

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

string

Texte de l'élément.

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)

Identifiant de suivi de l'annonce.

AdGroupAdEngineStatus

Énumère les états du moteur AdGroupAd.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 un appareil mobile, 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 diffusée.
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 l'est également.
AD_GROUP_AD_AD_GROUP_PAUSED La création a été mise en veille, car le groupe d'annonces l'est également.

AdGroupAdEffectiveLabel

Relation entre une annonce de groupe d'annonces et un libellé efficace. Un libellé efficace est un libellé hérité ou directement attribué à cette annonce de groupe d'annonces.

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

string

Nom de la ressource de l'étiquette efficace de l'annonce du groupe d'annonces. Les noms de ressources des libellés efficaces des annonces de groupe d'annonces se présentent sous la forme suivante: customers/{customerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}.
adGroupAd

string

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

string

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

string (int64 format)

Identifiant du client propriétaire du libellé effectif.

AdGroupAdLabel

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

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

string

Nom de la ressource du libellé de l'annonce du groupe d'annonces. Les noms de ressources des libellés d'annonces de groupe d'annonces se présentent sous la forme: customers/{customerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}.
adGroupAd

string

Annonce du groupe d'annonces à laquelle l'étiquette est associée.
label

string

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

string (int64 format)

ID du client propriétaire du libellé.

AdGroupAsset

Lien 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 de l'élément du groupe d'annonces. Les noms de ressources AdGroupAsset se présentent sous la forme suivante:

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'asset.

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

AdGroupAssetSet

AdGroupAssetSet est l'association entre un groupe d'annonces et un ensemble d'assets. La création d'un GroupAssetSet associe un ensemble d'assets à 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 d'assets du groupe d'annonces. Les noms de ressources des ensembles d'assets de groupe d'annonces ont la forme suivante:

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

string

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

string

Ensemble d'éléments associé au groupe d'annonces.
status

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

É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 réservée aux réponses.
ENABLED L'association entre l'ensemble d'assets et son conteneur est activée.
REMOVED L'association entre l'ensemble d'éléments et son conteneur est supprimée.

AdGroupAudienceView

Vue de l'audience d'un groupe d'annonces. Inclut les données sur les performances des centres d'intérêt et des listes de remarketing pour les annonces du Réseau Display et du Réseau YouTube, ainsi que des listes de remarketing pour les annonces du Réseau de Recherche (RLSA), agrégées au niveau de l'audience.

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

string

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

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 la ressource du modificateur d'enchère du groupe d'annonces. Les noms des ressources de 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 dans 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 Appareils mobiles dotés d'un navigateur complet
TABLET Tablettes avec navigateurs complets
DESKTOP Ordinateurs.
CONNECTED_TV Smart TV et consoles de jeu
OTHER Autres types d'appareils.

AdGroupCriterion

Un critère de groupe d'annonces. Le rapport "adGroupCriterion" 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
  ],
  "effectiveLabels": [
    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 des ressources des critères du groupe d'annonces se présentent comme suit:

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 sur 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.
effectiveLabels[]

string

Noms de ressources des libellés effectifs associés à ce critère de groupe d'annonces. Un libellé efficace est un libellé hérité ou directement attribué à ce critère de groupe d'annonces.
positionEstimates

object (PositionEstimates)

Estimations pour les enchères des critères à 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 concerne uniquement les comptes autres que Google Ads (par exemple, Yahoo Japan, Microsoft, Baidu, etc.). Pour l'entité Google Ads, utilisez plutôt "adGroupCriterion.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

Indique si le critère doit être ciblé (false) ou exclu (true).

Ce champ est immuable. Pour remplacer un critère positif par un critère négatif, supprimez-le, puis ajoutez-le à nouveau.
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 devez définir un seul de ces champs. 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 des utilisateurs.
webpage

object (WebpageInfo)

Page Web
location

object (LocationInfo)

Localisation.

AdGroupCriterionStatus

États possibles d'un AdGroupCriterion.

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 réservée aux réponses.
ENABLED Le critère du groupe d'annonces est activé.
PAUSED Le critère du groupe d'annonces est mis en veille.
REMOVED Le critère du groupe d'annonces est supprimé.

QualityInfo

Conteneur pour les 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 la valeur inconnue dans cette version.
KEYWORD Mot clé (par exemple, "croisière mars")
PLACEMENT Emplacement, également appelé "Site Web" (par exemple, "www.flowers4sale.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 Groupes de fiches à 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 ciblage par thème sur le Réseau Display (par exemple, "Animaux de compagnie et animaux").
LISTING_SCOPE Portée de la fiche à 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 Intent personnalisé.
LOCATION_GROUP Groupe de zones géographiques.
CUSTOM_AUDIENCE Audience personnalisée
COMBINED_AUDIENCE Audience combinée
KEYWORD_THEME Thème de mots clés de la campagne intelligente
AUDIENCE Audience
LOCAL_SERVICE_ID ID de service Annonces Local Services
BRAND Marque
BRAND_LIST Liste de marques
LIFE_EVENT Événement de la vie

PositionEstimates

Estimations des enchères basées sur des critères à différentes positions.

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

string (int64 format)

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

AdGroupCriterionEngineStatus

Énumère les états du moteur Critère de recherche.

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

Obsolète. Ne pas utiliser.
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN Baidu: enchère ou niveau de qualité trop faible pour permettre l'affichage
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 est non valide, tandis que celle de l'autre est valide.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: le mot clé a été créé et mis en veille par le responsable du compte Baidu. Il est maintenant prêt à être activé.
AD_GROUP_CRITERION_UNDER_REVIEW Baidu: en cours d'examen par 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 l'est.

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 du 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 la valeur inconnue dans cette version.
SUBDIVISION Subdivision des produits en fonction d'une dimension de fiche. Ces nœuds ne sont pas utilisés par la diffusion pour cibler les fiches, mais uniquement pour définir la structure de l'arborescence.
UNIT Unité de groupe d'annonces 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 la 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 à partir de 65 ans.
AGE_RANGE_UNDETERMINED Tranche d'âge indéterminée.

GenderInfo

Un critère de genre.

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

enum (GenderType)

Type de genre.

GenderType

Type de données démographiques concernant le genre (par exemple, "femme").

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

UserListInfo

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

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 avec 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 pour 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 des pages Web.

WebpageConditionOperand

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 la valeur inconnue dans cette version.
URL Operande désignant une condition de ciblage d'URL de page Web.
CATEGORY Operande désignant une condition de ciblage de catégorie de pages Web.
PAGE_TITLE Operande indiquant une condition de ciblage du titre d'une page Web.
PAGE_CONTENT Opérande indiquant une condition de ciblage par contenu d'une page Web.
CUSTOM_LABEL Operande indiquant une condition de ciblage par étiquette personnalisée sur une 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 la valeur inconnue dans cette version.
EQUALS La condition Web de l'argument est égale à la condition Web comparée.
CONTAINS L'argument "web condition" fait partie de la condition Web comparée.

LocationInfo

Critère de zone géographique.

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

string

Nom de la ressource constante de ciblage géographique.

AdGroupCriterionEffectiveLabel

Relation entre un critère de groupe d'annonces et un libellé effectif. Un libellé efficace est un libellé hérité ou directement attribué à ce critère de groupe d'annonces.

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

string

Nom de la ressource de l'étiquette efficace du critère de groupe d'annonces. Les noms de ressources des libellés efficaces des critères de groupe d'annonces se présentent sous la forme: customers/{customerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}.
adGroupCriterion

string

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

string

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

string (int64 format)

Identifiant du client propriétaire du libellé effectif.

AdGroupCriterionLabel

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

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

string

Nom de la ressource du libellé du critère du groupe d'annonces. Les noms de ressources du libellé du critère de groupe d'annonces sont au 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.
ownerCustomerId

string (int64 format)

Identifiant du client propriétaire du libellé.

AdGroupEffectiveLabel

Relation entre un groupe d'annonces et un libellé efficace. Un libellé efficace est un libellé hérité ou directement attribué à ce groupe d'annonces.

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

string

Nom de ressource du libellé effectif du groupe d'annonces. Les noms de ressources des libellés efficaces des groupes d'annonces se présentent sous la forme suivante: customers/{customerId}/adGroupEffectiveLabels/{ad_group_id}~{label_id}.
adGroup

string

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

string

Libellé effectif attribué au groupe d'annonces.
ownerCustomerId

string (int64 format)

ID du client propriétaire du libellé effectif.

AdGroupLabel

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

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

string

Nom de la ressource du libellé du groupe d'annonces. Les noms de ressources des libellés de groupe d'annonces se présentent sous la forme: customers/{customerId}/adGroupLabels/{ad_group_id}~{label_id}.
adGroup

string

Groupe d'annonces auquel l'étiquette est associée.
label

string

Libellé attribué au groupe d'annonces.
ownerCustomerId

string (int64 format)

ID du client propriétaire du libellé.

AgeRangeView

Vue par tranche d'âge.

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

string

Nom de ressource de la vue de la tranche d'âge. Les noms de ressources de la vue par tranche d'âge ont la forme suivante:

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

Élément

Un 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 composants 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 la ressource de l'asset. Les noms de ressources d'éléments ont la forme suivante:

customers/{customerId}/assets/{assetId}
type

enum (AssetType)

Type de l'asset.
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 du composant.
trackingUrlTemplate

string

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

enum (AssetEngineStatus)

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

object (YoutubeVideoAsset)

Un élément vidéo YouTube.
imageAsset

object (ImageAsset)

Un composant Image.
textAsset

object (TextAsset)

Un composant texte.
calloutAsset

object (UnifiedCalloutAsset)

Composant Accroche unifié.
pageFeedAsset

object (UnifiedPageFeedAsset)

Élément de flux de pages unifié.
mobileAppAsset

object (MobileAppAsset)

Un composant Application mobile.
callAsset

object (UnifiedCallAsset)

Composant Appel unifié.
callToActionAsset

object (CallToActionAsset)

Composant d'incitation à l'action.
locationAsset

object (UnifiedLocationAsset)

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 Élément 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 Asset Réserver sur Google.
PROMOTION Composant Promotion
CALLOUT Composant Accroche
STRUCTURED_SNIPPET Composant Extrait structuré
PAGE_FEED Élément de flux de pages.
DYNAMIC_EDUCATION Élément d'enseignement dynamique.
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 Composant immobilier dynamique
DYNAMIC_CUSTOM Élément personnalisé dynamique.
DYNAMIC_HOTELS_AND_RENTALS Asset dynamique pour les hôtels et les locations.
DYNAMIC_FLIGHTS Composant dynamique sur les vols.
DYNAMIC_TRAVEL Composant dynamique sur les voyages
DYNAMIC_LOCAL Asset local dynamique.
DYNAMIC_JOBS Composant dynamique sur les emplois
LOCATION Composant Lieu.
HOTEL_PROPERTY Asset 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 réservée aux réponses.
ENABLED L'élément est activé.
REMOVED L'élément est supprimé.
ARCHIVED L'élément est archivé.
PENDING_SYSTEM_GENERATED Le composant est généré par le système et 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 la valeur inconnue dans cette version.
SERVING L'asset est actif.
SERVING_LIMITED L'asset est actif, mais limité.
DISAPPROVED Le composant a été refusé (non éligible).
DISABLED L'asset est inactif (en attente).
REMOVED L'élément a été supprimé.

YoutubeVideoAsset

Élément YouTube

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

string

Titre de la vidéo YouTube.
youtubeVideoId

string

ID de la 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

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 sa 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 réservée aux réponses.
IMAGE_JPEG Type MIME image/jpeg.
IMAGE_GIF Type MIME de l'image/gif.
IMAGE_PNG Type MIME de l'image/png.
FLASH Type MIME application/x-shockwave-flash.
TEXT_HTML Type MIME de text/html.
PDF Type MIME application/pdf.
MSWORD Type MIME application/msword.
MSEXCEL Type MIME application/vnd.ms-excel.
RTF Type MIME application/rtf.
AUDIO_WAV Type MIME d'audio/wav.
AUDIO_MP3 Type MIME audio/mp3.
HTML5_AD_ZIP Type MIME application/x-html5-ad-zip.

ImageDimension

Métadonnées d'une image dans une certaine taille, qu'elle soit d'origine 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 du composant texte.

UnifiedCalloutAsset

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 entre en vigueur et peut commencer à être diffusé, au format aaaa-MM-jj.
endDate

string

Dernière date à laquelle cet élément est actif et diffusé, au format AAAA-MM-JJ.
adScheduleTargets[]

object (AdScheduleInfo)

Liste des calendriers sans chevauchement spécifiant tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Vous pouvez créer jusqu'à six calendriers par jour, soit 42 au total.
useSearcherTimeZone

boolean

Indique si l'asset doit être affiché dans le fuseau horaire de l'utilisateur de la recherche. S'applique à Microsoft Advertising.

AdScheduleInfo

Représente un critère AdSchedule.

AdSchedule est spécifié en tant que jour de la semaine et intervalle de temps pendant lequel les annonces seront diffusées.

Vous ne pouvez pas ajouter plus de six AdSchedules 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 cette programmation se termine. La minute de fin n'est pas incluse dans l'horaire.

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 la programmation 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 (24 signifie 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ération des quarts d'heure. Exemple : "FIFTEEN"

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

DayOfWeek

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

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

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
linkText

string

Texte à afficher pour le lien annexe. La longueur de cette chaîne doit être comprise entre 1 et 25, inclus.
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 de la diffusion de cet asset, au format AAAA-MM-JJ.
endDate

string

Dernière date à laquelle cet élément est actif et diffusé, au format AAAA-MM-JJ.
adScheduleTargets[]

object (AdScheduleInfo)

Liste des calendriers de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Vous pouvez créer jusqu'à six calendriers par jour, soit 42 au total.
trackingId

string (int64 format)

ID utilisé pour suivre les clics sur le composant Lien annexe. Il s'agit d'un compte Yahoo! Champ "Japon uniquement".
useSearcherTimeZone

boolean

Indique si le composant Lien annexe doit s'afficher dans le fuseau horaire de l'utilisateur de la recherche. S'applique à Microsoft Advertising.
mobilePreferred

boolean

Indique si le composant Lien annexe doit s'afficher sur les appareils mobiles. S'applique à Microsoft Advertising.

UnifiedPageFeedAsset

É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

Composant représentant une application mobile.

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

string

Obligatoire. Chaîne qui identifie de manière 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

Type de fournisseur d'applications mobiles

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la valeur inconnue dans cette version.
APPLE_APP_STORE Fournisseur d'applications mobiles pour l'App Store d'Apple.
GOOGLE_APP_STORE Fournisseur de l'application mobile 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 du 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 cet élément CallAsset 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 aucune valeur n'est spécifié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 de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Vous pouvez créer jusqu'à six calendriers 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 à Microsoft Advertising.
callTrackingEnabled

boolean

Indique si l'appel doit être activé dans le suivi des appels. S'applique à Microsoft Ads.
useSearcherTimeZone

boolean

Permet d'afficher ou non l'extension d'appel dans le fuseau horaire de l'utilisateur associé à la recherche. S'applique à Microsoft Advertising.
startDate

string

Date de début de la diffusion de cet asset, au format AAAA-MM-JJ.
endDate

string

Dernière date à laquelle cet élément est actif et 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 la 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 types d'incitations à l'action possibles.

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 "Envoyer une demande".
SIGN_UP Le type d'incitation à l'action est "S'inscrire".
CONTACT_US Le type d'incitation à l'action est "Contactez-nous".
SUBSCRIBE L'incitation à l'action est de type "S'abonner".
DOWNLOAD Le type d'incitation à l'action est "Télécharger".
BOOK_NOW Le type d'incitation à l'action est "Réserver maintenant".
SHOP_NOW Le type d'incitation à l'action est "Acheter maintenant".
BUY_NOW Le type d'incitation à l'action est "Acheter maintenant".
DONATE_NOW Le type d'incitation à l'action est "Faire un don maintenant".
ORDER_NOW Le type d'incitation à l'action est "commander maintenant".
PLAY_NOW Le type d'incitation à l'action est "Jouer maintenant".
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

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 ID client et un type d'élément donnés. Pour en savoir plus sur les identifiants de lieu, consultez la page https://developers.google.com/places/web-service/place-id.
businessProfileLocations[]

object (BusinessProfileLocation)

Liste des établissements du client. Cette valeur ne s'affiche que si le composant Lieu est synchronisé à partir du compte de fiche d'établissement. Il est possible d'avoir plusieurs fiches d'établissement dans un même compte qui pointent vers le même identifiant de lieu.
locationOwnershipType

enum (LocationOwnershipType)

Type de droits détenus sur l'établissement. Si le type est BUSINESS_OWNER, il sera diffusé en tant qu'extension de lieu. Si le type est AFFILIÉ, il sera diffusé en tant que lieu affilié.

BusinessProfileLocation

Données de localisation de la fiche d'établissement synchronisées à partir du compte de fiche 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 fiche d'établissement. Cette information est synchronisée à partir du compte de la fiche d'établissement.
storeCode

string

Code de magasin de la fiche d'établissement de cet établissement. Cette information est synchronisée à partir du compte de la fiche d'établissement.
listingId

string (int64 format)

ID de la fiche de cet établissement. Ces informations sont synchronisées à 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)
AFFILIATE Lieu affilié(extension de lieu tiers)

AssetGroupAsset

AssetGroupAsset est le lien entre un composant et un groupe de composants. L'ajout d'un AssetGroupAsset associe un composant à un groupe de composants.

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'un composant de groupe de composants 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

Élément auquel cet élément de groupe de composants est associé.
fieldType

enum (AssetFieldType)

Description de l'emplacement du composant dans le groupe de composants. Par exemple: HEADLINE, YOUTUBE_VIDEO, etc.
status

enum (AssetLinkStatus)

État de l'association entre un élément 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 la valeur inconnue dans cette version.
HEADLINE L'asset est associé pour être utilisé comme titre.
DESCRIPTION Le lien de l'asset peut être utilisé comme description.
MANDATORY_AD_TEXT Le composant est associé pour être utilisé comme texte d'annonce obligatoire.
MARKETING_IMAGE L'élément est associé pour être utilisé comme 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é comme 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 L'asset est associé et peut être utilisé comme extension de formulaire pour prospects.
PROMOTION Le composant est associé et peut être utilisé comme extension de promotion.
CALLOUT Le composant est associé pour être utilisé comme extension d'accroche.
STRUCTURED_SNIPPET L'asset est associé pour être utilisé en tant qu'extension d'extrait structuré.
MOBILE_APP Le composant est associé pour être utilisé en tant qu'extension d'application mobile.
HOTEL_CALLOUT L'asset est associé pour être utilisé en tant qu'extension d'accroche pour hôtel.
CALL L'asset est associé pour être utilisé comme extension d'appel.
PRICE L'asset est associé pour être utilisé en tant qu'extension de prix.
LONG_HEADLINE L'asset est associé pour être utilisé comme titre long.
BUSINESS_NAME L'élément est associé pour être utilisé comme nom d'entreprise.
SQUARE_MARKETING_IMAGE L'élément est associé pour être utilisé en tant qu'image marketing carrée.
PORTRAIT_MARKETING_IMAGE L'élément est associé pour être utilisé en tant qu'image marketing en mode portrait.
VIDEO L'asset est associé pour être utilisé en tant que logo autre que YouTube.
CALL_TO_ACTION_SELECTION L'élément est associé pour sélectionner une incitation à l'action.
AD_IMAGE Un lien vers le composant permet de sélectionner une image d'annonce.
HOTEL_PROPERTY Le composant est associé pour être utilisé comme établissement hôtelier dans une campagne Performance Max pour les objectifs de voyage.

AssetGroupSignal

AssetGroupSignal représente un signal dans un groupe de composants. L'existence d'un signal indique à la campagne Performance Max qui est le plus susceptible d'effectuer une conversion. Performance Max utilise ce signal pour rechercher d'autres personnes ayant une intention similaire ou plus forte afin de générer des conversions sur le Réseau de Recherche, sur le 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 comme suit:

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 de composants. 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 Audience.

AssetGroupListingGroupFilter

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

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 la ressource du filtre de groupe de fiches (groupe de composants). Le nom de la ressource du filtre de groupe de fiches du groupe d'assets se présente comme suit:

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

string

Groupe de composants auquel appartient ce filtre de groupe de fiches (groupe d'assets).
id

string (int64 format)

ID du ListingGroupFilter.
type

enum (ListingGroupFilterType)

Type d'un nœud de filtre de groupe de fiches.
vertical

enum (ListingGroupFilterVertical)

Verticale que l'arborescence du nœud actuel représente. Tous les nœuds d'un même arbre doivent appartenir au même secteur.
caseValue

object (ListingGroupFilterDimension)

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

string

Nom de la ressource de la subdivision du groupe d'annonces parent. "Null" pour le nœud de filtre de groupe de fiches racine.
path

object (ListingGroupFilterDimensionPath)

Chemin des dimensions qui définissent ce filtre de groupe de fiches.

ListingGroupFilterType

Type du filtre de groupe de fiches.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la valeur inconnue dans cette version.
SUBDIVISION Subdivision des produits selon certaines dimensions de fiche.
UNIT_INCLUDED Nœud de feuille de filtre de groupe de fiches inclus.
UNIT_EXCLUDED Nœud feuille de filtre de groupe de fiches exclus.

ListingGroupFilterVertical

Type de secteur du filtre de groupes de fiches.

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

ListingGroupFilterDimension

Dimensions de fiches pour le filtre de groupe de fiches (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)

Identifiant de l'article d'une offre.
productType

object (ProductType)

Type d'offre de produit.

ProductBiddingCategory

Élément d'une catégorie d'enchères à un niveau donné. Les catégories de niveau supérieur sont au niveau 1, leurs enfants au niveau 2, et ainsi de suite. Pour le moment, nous acceptons 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 (niveau de 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 du produit.

Cet ID est équivalent à l'ID google_product_category 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 la 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 la 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 la valeur inconnue dans cette version.
ONLINE L'article est vendu en ligne.
LOCAL L'article est vendu dans des magasins locaux.

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 la valeur inconnue dans cette version.
NEW L'état du produit est neuf.
REFURBISHED L'état du produit est "Reconditionné".
USED L'état du produit est "d'occasion".

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 la 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 la valeur inconnue dans cette version.
INDEX0 Premier attribut personnalisé de filtre de groupe de fiches.
INDEX1 Deuxième attribut personnalisé de filtre de groupe de fiches.
INDEX2 Troisième attribut personnalisé de filtre de groupe de fiches.
INDEX3 Quatrième attribut personnalisé de filtre de groupe de fiches.
INDEX4 Cinquième attribut personnalisé de filtre de groupe de fiches.

ProductItemId

ID de l'article d'une offre de produit.

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'offre de produit.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 à travers la hiérarchie des filtres de groupe de fiches (à l'exception du nœud racine) jusqu'à ce filtre de groupe de fiches.

AssetGroupTopCombinationView

Vue sur l'utilisation d'une combinaison de composants d'annonce 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 de composants. Les noms de ressources des vues "Meilleure combinaison de groupes d'assets" se présentent sous la forme "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Combinaisons d'assets les plus populaires diffusées ensemble.

AssetGroupAssetCombinationData

Données sur les combinaisons d'éléments de groupe de composants

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 diffusé 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 réservée aux réponses.
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'asset est utilisé dans la description 1.
DESCRIPTION_2 L'asset est utilisé dans la description 2.
HEADLINE L'asset 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'élément 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'élément a été utilisé comme description dans l'image en mode portrait.
BUSINESS_NAME_IN_PORTRAIT L'élément a été utilisé comme nom d'entreprise dans une image en mode portrait.
BUSINESS_NAME L'élément a été utilisé comme nom d'entreprise.
MARKETING_IMAGE L'élément a été utilisé comme image marketing.
MARKETING_IMAGE_IN_PORTRAIT L'élément a été utilisé comme image marketing en mode portrait.
SQUARE_MARKETING_IMAGE L'élément a été utilisé comme image marketing carrée.
PORTRAIT_MARKETING_IMAGE Le composant a été utilisé comme image marketing en mode portrait.
CALL_TO_ACTION L'asset a été utilisé comme incitation à l'action.
YOU_TUBE_VIDEO L'asset a été utilisé comme vidéo YouTube.
CALL Cet élément est utilisé comme appel.
MOBILE_APP Ce composant est utilisé comme application mobile.
CALLOUT Ce composant est utilisé comme accroche.
STRUCTURED_SNIPPET Cet élément est utilisé comme extrait structuré.
PRICE Cet élément est utilisé comme prix.
PROMOTION Cet asset est utilisé comme promotion.
AD_IMAGE Cet élément est utilisé en tant qu'image.
LEAD_FORM L'asset est utilisé comme formulaire pour prospects.

AssetGroup

Un groupe d'assets AssetGroupAsset permet d'associer un composant à un groupe de composants. AssetGroupSignal permet d'associer un signal à un groupe de composants.

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 la ressource du groupe de composants. Les noms de ressources de groupe de composants se présentent 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 d'assets est associé. Élément associé au groupe d'éléments.
name

string

Obligatoire. Nom du groupe d'assets. Obligatoire. Il doit comporter au moins un caractère et au maximum 128 caractères. Il doit être unique dans une campagne.
finalUrls[]

string

Liste des URL finales après toutes les redirections interdomaines. Dans Performance Max, les URL peuvent être étendues par défaut, sauf si vous les désactivez.
finalMobileUrls[]

string

Liste des URL finales pour mobile après toutes les redirections interdomaines. Dans Performance Max, les URL peuvent être étendues par défaut, sauf si vous les désactivez.
status

enum (AssetGroupStatus)

État du groupe de composants.
path1

string

Première partie du texte qui peut être ajoutée à l'URL affichée dans l'annonce.
path2

string

Deuxième partie de texte susceptible d'être ajoutée à 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 des annonces de ce groupe d'assets.

AssetGroupStatus

États possibles d'un groupe de composants.

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 listant les niveaux d'efficacité des annonces possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 Efficacité faible.
AVERAGE Force moyenne.
GOOD Bonne force.
EXCELLENT Excellente résistance.

AssetSetAsset

AssetSetAsset est le lien entre un élément et un ensemble d'éléments. Ajouter un AssetSetAsset permet d'associer 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 la ressource de l'élément de l'ensemble d'éléments. Les noms de ressources des éléments d'un ensemble d'éléments ont la forme suivante :

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 de l'élément de l'ensemble d'assets. Lecture seule.

AssetSetAssetStatus

États possibles d'un composant d'ensemble d'assets.

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'élément de l'ensemble d'éléments est activé.
REMOVED L'élément de l'ensemble d'éléments est supprimé.

AssetSet

Ensemble d'assets représentant une collection d'assets. Utilisez AssetSetAsset pour associer un élément à l'ensemble d'assets.

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

string (int64 format)

ID de l'ensemble de composants.
resourceName

string

Nom de la ressource de l'ensemble d'assets. Les noms de ressources d'ensemble d'assets ont la forme suivante :

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 de ressources de stratégie d'enchères ont la forme 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 dans les comptes client administrateur, cette devise peut être définie lors de la création et est définie par défaut sur la devise du compte client administrateur. Pour les clients diffuseurs, ce champ ne peut pas être défini. Toutes les stratégies d'un client diffuseur utilisent implicitement la devise du client diffuseur. Dans tous les cas, le champ effectiveCurrencyCode affiche 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 ISO 4217 à trois lettres).

Pour les stratégies d'enchères des clients gestionnaires, il s'agit de la devise définie par l'annonceur lors de la création de la stratégie. Pour les clients actifs, il s'agit du codecurrencyCode du client.

Les métriques de la stratégie d'enchères sont exprimé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. Schéma d'enchères.

Vous ne pouvez en définir qu'un seul. 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 diminue pour les clics qui semblent moins probables.
maximizeConversionValue

object (MaximizeConversionValue)

Stratégie d'enchères automatiques qui vous aide à maximiser la valeur de conversion de vos campagnes tout en dépensant votre budget.
maximizeConversions

object (MaximizeConversions)

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

object (TargetCpa)

Stratégie d'enchères 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 avez défini.
targetImpressionShare

object (TargetImpressionShare)

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

object (TargetOutrankShare)

Il s'agit d'une stratégie qui définit des enchères en fonction de la fraction cible d'enchères pour lesquelles 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 mutations de 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 (retour sur les dépenses publicitaires) cible spécifique.
targetSpend

object (TargetSpend)

Stratégie d'enchères qui définit vos enchères pour vous aider à enregistrer un maximum de clics 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 réservée aux réponses.
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 la valeur inconnue dans cette version.
COMMISSION La stratégie d'enchères automatiques "Commissions" permet à l'annonceur de payer une certaine partie de la valeur de conversion.
ENHANCED_CPC Le CPC (coût par clic) optimisé est une stratégie d'enchères qui augmente les enchères pour les clics qui semblent les plus susceptibles de générer une conversion, et les diminue pour les clics qui semblent les moins susceptibles d'entraîner des conversions.
INVALID Utilisé pour la valeur renvoyée uniquement. Indique qu'une campagne n'a pas de stratégie d'enchères. Dans ce cas, la campagne ne peut pas être diffusée. Par exemple, une campagne peut être associée à une stratégie d'enchères administrateur, puis le compte de diffusion est 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 en fonction d'une action spécifiée par l'annonceur.
MANUAL_CPC Enchères manuelles basées sur les clics, où l'utilisateur paie par clic.
MANUAL_CPM Enchères manuelles basées sur les impressions, où l'utilisateur paie pour mille impressions.
MANUAL_CPV Stratégie d'enchères qui verse un montant configurable par vue 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 Stratégie d'enchères automatisées qui définit automatiquement les enchères pour maximiser les revenus tout en dépensant votre budget.
PAGE_ONE_PROMOTED Stratégie d'enchères pour les annonces sponsorisées de la première page, qui définit les enchères au CPC max. pour cibler les impressions sur la première page ou les emplacements sponsorisés de la première page sur google.com. Cette valeur d'énumération est obsolète.
PERCENT_CPC Le CPC en pourcentage est une stratégie d'enchères dans laquelle les enchères correspondent à une fraction du prix annoncé pour un bien ou un service.
TARGET_CPA Le CPA cible est 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.
TARGET_CPM Le CPM cible est une stratégie d'enchères automatiques qui définit vos enchères afin de générer autant d'impressions que possible pour le coût pour mille impressions (CPM) cible que vous spécifiez.
TARGET_IMPRESSION_SHARE Stratégie d'enchères automatiques qui définit les enchères afin qu'un certain pourcentage d'annonces sur le Réseau de Recherche soit diffusé en haut de la première page (ou à un autre emplacement ciblé).
TARGET_OUTRANK_SHARE La stratégie d'enchères automatiques "Taux de surclassement cible" définit les enchères en fonction de la fraction cible des enchères pour lesquelles l'annonceur doit surclasser un concurrent spécifique. Cette valeur d'énumération est obsolète.
TARGET_ROAS La stratégie d'enchères "ROAS cible" est une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant la moyenne d'un ROAS cible spécifique.
TARGET_SPEND La stratégie d'enchères "Dépenses cibles" définit automatiquement vos enchères pour vous aider à enregistrer autant de clics que possible dans les limites de votre budget.

EnhancedCpc

Ce type ne comporte aucun champ.

Stratégie d'enchères automatisée qui augmente les enchères pour les clics qui semblent le plus susceptibles de générer une conversion et les diminue pour les clics pour lesquels cette probabilité est faible.

Cette stratégie d'enchères est obsolète et ne peut plus être créée. Utilisez ManualCpc avec enhancedCpcEnabled défini sur "true" pour une fonctionnalité équivalente.

MaximizeConversionValue

Stratégie d'enchères automatiques qui vous aide à maximiser la valeur de conversion de vos campagnes tout en dépensant 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. Peut être modifié uniquement pour les stratégies d'enchères de portefeuille.
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. Cette valeur ne peut être modifiée que pour les stratégies de portefeuille d'enchères.
targetRoas

number

L'option "Objectif de ROAS cible" Si vous définissez cette option, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, votre objectif de retour sur les dépenses publicitaires. Si le ROAS cible est élevé, la stratégie d'enchères risque de ne pas pouvoir dépenser la totalité du budget. Si vous ne définissez pas de ROAS cible, la stratégie d'enchères s'efforcera d'atteindre le ROAS le plus élevé possible pour le budget.

Maximiser les conversions

Stratégie d'enchères automatiques qui vous aide à enregistrer un maximum de conversions pour vos campagnes tout en dépensant 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. Peut être modifié uniquement pour les stratégies d'enchères de portefeuille.
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. Cette valeur ne peut être modifiée que pour les stratégies de portefeuille d'enchères.
targetCpaMicros

string (int64 format)

Option "Coût par action (CPA) cible". Il s'agit du montant moyen que vous souhaitez dépenser pour chaque action de conversion spécifiée en micro-unités de la devise de la stratégie d'enchères. Si vous définissez cette stratégie, elle générera autant de conversions que possible pour un coût par action cible égal ou inférieur. Si vous ne définissez pas de CPA cible, la stratégie d'enchères s'efforcera d'obtenir le CPA le plus bas possible compte tenu du budget.

TargetCpa

Cette stratégie d'enchères automatiques 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 avez défini.

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

Stratégie d'enchères automatiques qui définit les enchères afin qu'un certain pourcentage d'annonces sur le Réseau de Recherche soit diffusé en haut de la première page (ou à un autre emplacement ciblé).

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

enum (TargetImpressionShareLocation)

Emplacement ciblé sur la page de résultats de recherche.
locationFractionMicros

string (int64 format)

Fraction d'annonces à diffuser dans la zone géographique ciblée, en micros. Par exemple, 1% correspond à 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 la valeur inconnue dans cette version.
ANYWHERE_ON_PAGE N'importe quel emplacement sur la page Web.
TOP_OF_PAGE Zone d'annonces la plus visible.
ABSOLUTE_TOP_OF_PAGE Meilleur emplacement dans la zone d'annonces la plus visible.

TargetOutrankShare

Stratégie d'enchères automatiques qui définit les enchères en fonction de la fraction cible des enchères pour lesquelles l'annonceur doit devancer 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

Il s'agit d'une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen 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

La stratégie d'enchères "Maximiser les clics" définit automatiquement vos enchères pour que vous enregistriez autant de clics que possible dans les limites de votre budget.

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

string (int64 format)

Obsolète : 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 du budget de la campagne. Les noms de ressources de budget de campagne se présentent sous la forme suivante:

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 la valeur inconnue dans cette version.
STANDARD Le serveur de budget limite la diffusion de manière uniforme sur toute la période.
ACCELERATED Le serveur de budget ne limite pas la diffusion, et les annonces sont diffusées aussi vite que 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 la limite de budget sur toute la durée de vie.

Campagne

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)
  },
  "effectiveLabels": [
    string
  ],
  "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 la ressource de la campagne. Les noms de ressources de campagne se présentent sous la forme suivante :

customers/{customerId}/campaigns/{campaign_id}
status

enum (CampaignStatus)

État de la campagne.

Lorsque vous ajoutez une campagne, son état est défini par défaut sur "ACTIVE".
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 de l'optimisation de la diffusion d'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)

Filtre facultatif de 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ées dans un trackingUrlTemplate, finalUrls ou mobile_final_urls.
realTimeBiddingSetting

object (RealTimeBiddingSetting)

Paramètres des enchères en temps réel, une fonctionnalité disponible uniquement 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 permettant de contrôler les annonces dynamiques du Réseau de Recherche (ADR).
shoppingSetting

object (ShoppingSetting)

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

object (GeoTargetTypeSetting)

Paramètre du ciblage géographique des annonces.
effectiveLabels[]

string

Noms de ressource des étiquettes effectives associées à cette campagne. Un libellé efficace est un libellé hérité ou directement attribué à cette campagne.
labels[]

string

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

enum (BiddingStrategyType)

Type de stratégie d'enchères.

Pour créer une stratégie d'enchères, vous pouvez utiliser le schéma d'enchères afin de 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 la ressource AccessibleBiddingStrategy, une vue en lecture seule des attributs sans restriction de la stratégie d'enchères de portefeuille associée, identifiée par "biddingStrategy". Vide, si la campagne n'utilise pas de stratégie de portefeuille. Les attributs de stratégie sans restriction sont disponibles pour tous les clients avec lesquels la stratégie est partagée et sont lus à partir de la ressource AccessibleBiddingStrategy. En revanche, les attributs limités ne sont disponibles que pour le client propriétaire de la stratégie et ses responsables. Les attributs limités ne peuvent être lus que depuis la ressource BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

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

object (SelectiveOptimization)

Paramètre d'optimisation sélective pour cette campagne, qui comprend un ensemble d'actions de conversion à optimiser pour 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 d'assets à exclure de cette campagne. Les associations d'assets avec ces types de champs ne seront pas héritées par cette campagne à partir du niveau supérieur.
createTime

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". createTime sera abandonné dans la version 1. Utilisez plutôt creationTime.
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

Nom de la ressource du 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 utilisé pour ajouter des paramètres de requête aux pages de destination diffusées avec le suivi en parallèle.
urlExpansionOptOut

boolean

Indique si l'expansion des URL est désactivée pour obtenir des URL plus ciblées. Si elle est désactivée (valeur "true"), seules les URL finales du groupe de composants ou les URL spécifiées dans les flux Google Merchant Center ou de données d'entreprise de l'annonceur sont ciblées. Si l'option est activée (false), l'intégralité du domaine sera ciblée. Ce champ ne peut être défini que pour les campagnes Performance Max, où la valeur par défaut est "false".

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

Doit être une stratégie de portefeuille (créée via le service BiddingStrategy) ou standard, intégrée à la campagne. campaign_bidding_strategy ne peut être qu'un des éléments suivants :
biddingStrategy

string

Nom de la ressource de la stratégie d'enchères de portefeuille utilisée par la campagne.
manualCpa

object (ManualCpa)

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

object (ManualCpc)

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

object (ManualCpm)

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

object (MaximizeConversions)

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

object (MaximizeConversionValue)

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

object (TargetCpa)

Stratégie d'enchères au CPA cible standard qui 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 les enchères de façon à atteindre un pourcentage donné d'impressions.
targetRoas

object (TargetRoas)

Stratégie d'enchères "ROAS cible" standard qui maximise automatiquement les revenus tout en atteignant la moyenne d'un ROAS cible spécifique.
targetSpend

object (TargetSpend)

Stratégie d'enchères basée sur l'objectif de dépenses standard qui définit automatiquement vos enchères pour vous aider à enregistrer autant de clics que possible dans les limites de votre budget.
percentCpc

object (PercentCpc)

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

object (TargetCpm)

Il s'agit d'une 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 réservée aux réponses.
SERVING de 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 d'état n'a été trouvée).
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la valeur inconnue dans cette version.
ENABLED La stratégie d'enchères est active et le système AdWords ne détecte aucun problème particulier à son sujet.
LEARNING_NEW La stratégie d'enchères est en phase d'apprentissage, car elle a été créée ou réactivée récemment.
LEARNING_SETTING_CHANGE La stratégie d'enchères est en apprentissage en raison d'un changement de paramètre récent.
LEARNING_BUDGET_CHANGE La stratégie d'enchères est en apprentissage en raison d'une modification récente du budget.
LEARNING_COMPOSITION_CHANGE La stratégie d'enchères est en apprentissage en raison d'une modification récente du nombre de campagnes, de groupes d'annonces ou de mots clés qui lui sont associés.
LEARNING_CONVERSION_TYPE_CHANGE La stratégie d'enchères dépend des rapports sur les conversions et du client qui a récemment modifié les types de conversion pertinents pour la stratégie d'enchères.
LEARNING_CONVERSION_SETTING_CHANGE La stratégie d'enchères dépend des rapports sur les conversions, et le client a récemment modifié ses paramètres de conversion.
LIMITED_BY_CPC_BID_CEILING La stratégie d'enchères est limitée par son plafond d'enchères.
LIMITED_BY_CPC_BID_FLOOR La stratégie d'enchères est limitée par son prix plancher.
LIMITED_BY_DATA La stratégie d'enchères est limitée, car le trafic de conversion n'a pas été suffisant au cours des dernières semaines.
LIMITED_BY_BUDGET Une part significative des mots clés de cette stratégie d'enchères est limitée par le budget.
LIMITED_BY_LOW_PRIORITY_SPEND La stratégie d'enchères ne peut pas atteindre son budget cible, car ses dépenses ont été dépriorisées.
LIMITED_BY_LOW_QUALITY Une partie importante des mots clés de cette stratégie d'enchères présentent un faible niveau de qualité.
LIMITED_BY_INVENTORY La stratégie d'enchères ne peut pas dépenser l'intégralité de son budget en raison d'un ciblage trop restreint.
MISCONFIGURED_ZERO_ELIGIBILITY Le suivi des conversions (aucun ping) et/ou les listes de remarketing sont manquants pour les CSI.
MISCONFIGURED_CONVERSION_TYPES La stratégie d'enchères dépend des rapports sur les conversions, et le client ne dispose pas de types de conversion qui pourraient être enregistrés avec cette stratégie.
MISCONFIGURED_CONVERSION_SETTINGS La stratégie d'enchères dépend des rapports sur les conversions, et les paramètres de conversion du client sont mal configurés.
MISCONFIGURED_SHARED_BUDGET Certaines campagnes en dehors de la stratégie d'enchères partagent un budget avec des campagnes incluses dans la stratégie.
MISCONFIGURED_STRATEGY_TYPE Le type de stratégie de la campagne n'est pas valide et n'est pas diffusée.
PAUSED La stratégie d'enchères n'est pas active. Il n'y a pas de campagnes, de groupes d'annonces ni de mots clés actifs associés à la stratégie d'enchères. Ou aucun budget actif n'est associé à la stratégie d'enchères.
UNAVAILABLE Cette stratégie d'enchères n'est actuellement pas compatible avec les rapports sur l'état.
MULTIPLE_LEARNING Plusieurs états système LEARNING_* ont été attribués à cette stratégie d'enchères au cours de la période en question.
MULTIPLE_LIMITED Plusieurs états système 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 MISCONFIGURED_* ont été attribués à cette stratégie d'enchères au cours de la période en question.
MULTIPLE Plusieurs états système ont été attribués à cette stratégie d'enchères au cours de la période en question.

AdServingOptimizationStatus

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

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

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

Il s'agit d'une valeur réservée aux réponses.
OPTIMIZE La diffusion des annonces est optimisée en fonction du CTR de la campagne.
CONVERSION_OPTIMIZE La diffusion des annonces est optimisée en fonction du CTR * Conversion de la campagne. Si la campagne ne fait pas partie de la stratégie d'enchères de l'Optimiseur de conversion, elle est définie par défaut sur OPTIMISÉE.
ROTATE Les annonces sont alternées de manière régulière pendant 90 jours, puis optimisées pour les clics.
ROTATE_INDEFINITELY Diffuser les annonces peu performantes de manière plus régulière avec les annonces plus performantes, et ne pas procéder à une 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 de google.com.
HOTEL 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 Campagnes d'annonces locales
SMART Campagnes intelligentes
PERFORMANCE_MAX Performance Max.
LOCAL_SERVICES Campagnes Local Services
DISCOVERY Campagnes Discovery.
TRAVEL Campagnes de voyage
SOCIAL Campagnes sur les réseaux sociaux.

AdvertisingChannelSubType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisée uniquement comme valeur renvoyée. Représente la valeur inconnue dans cette version.
SEARCH_MOBILE_APP Campagnes pour applications mobiles pour le Réseau de Recherche
DISPLAY_MOBILE_APP Campagnes pour applications mobiles pour le Réseau Display
SEARCH_EXPRESS Campagnes AdWords Express sur le Réseau de Recherche
DISPLAY_EXPRESS Campagnes AdWords Express pour le display
SHOPPING_SMART_ADS campagnes Shopping intelligentes ;
DISPLAY_GMAIL_AD Campagnes d'annonces Gmail
DISPLAY_SMART_CAMPAIGN Campagnes intelligentes sur le Réseau Display : Vous ne pouvez pas créer de campagnes de ce sous-type.
VIDEO_OUTSTREAM Campagnes vidéo OutStream
VIDEO_ACTION Campagnes vidéo TrueView pour l'action.
VIDEO_NON_SKIPPABLE Campagnes vidéo avec des annonces vidéo non désactivables
APP_CAMPAIGN Campagne pour applications qui vous permet de promouvoir facilement votre application Android ou iOS sur les principales propriétés de Google, dont le Réseau de Recherche, Google Play, YouTube et le Réseau Display de Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Campagne pour applications axée sur l'engagement, visant à relancer l'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 Campagnes spécialisées pour la publicité locale.
SHOPPING_COMPARISON_LISTING_ADS Campagnes de type "Fiche du service de comparateur de prix"
SMART_CAMPAIGN Campagnes Shopping intelligentes standards
VIDEO_SEQUENCE Campagnes vidéo avec annonces vidéo en séquence.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Campagne pour applications de préinscription, spécialisée pour la promotion de la préinscription à une application mobile, qui cible plusieurs canaux publicitaires sur Google Play, YouTube et le Réseau Display.
VIDEO_REACH_TARGET_FREQUENCY Campagne axée sur la couverture vidéo avec stratégie d'enchères "Fréquence cible".
TRAVEL_ACTIVITIES Campagnes "Activités de voyage"
SOCIAL_FACEBOOK_TRACKING_ONLY Suivi Facebook uniquement pour les campagnes sur les réseaux sociaux.

CustomParameter

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

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

string

Clé correspondant au nom de la balise du paramètre.
value

string

Valeur à remplacer.

RealTimeBiddingSetting

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

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

boolean

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

NetworkSettings

Paramètres des réseaux de la campagne.

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

boolean

Indique si les annonces seront diffusées sur les sites partenaires du Réseau de Recherche de Google (nécessite que targetGoogleSearch soit également 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 permettant de contrôler les 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 représenté par ce paramètre (par exemple, "google.com" ou "www.google.com").
languageCode

string

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

boolean

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

ShoppingSetting

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

Représentation JSON 
{
  "feedLabel": string,
  "useVehicleInventory": boolean,
  "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 des attributs "libellé de flux" ou "pays de vente". S'il est utilisé à la place de "salesCountry", le champ "feedLabel" accepte les codes pays au même format (par exemple, "XX"). Sinon, il peut s'agir de n'importe quelle chaîne utilisée pour le libellé du flux dans Google Merchant Center.
useVehicleInventory

boolean

Indique si vous souhaitez cibler l'inventaire des fiches de véhicule.
merchantId

string (int64 format)

ID du compte Merchant Center. Ce champ est obligatoire pour les opérations de création. Ce champ est immuable pour les campagnes Shopping.
salesCountry

string

Pays de vente des produits à inclure dans la campagne.
campaignPriority

integer

Priorité de la campagne. Les campagnes ayant des priorités numériques plus élevées ont la priorité sur celles ayant des priorités plus faibles. Ce champ est obligatoire pour les campagnes Shopping. Les valeurs doivent être comprises entre 0 et 2 inclus. Ce champ est facultatif pour les campagnes Shopping intelligentes, mais doit être égal à 3 s'il est défini.
enableLocal

boolean

Indique si vous souhaitez inclure des 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 zones géographiques cibles 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 géographiques ciblées par l'annonceur ou s'il s'y intéresse.
SEARCH_INTEREST Indique qu'une annonce est déclenchée si l'utilisateur recherche les zones géographiques ciblées de l'annonceur. Cette fonctionnalité ne peut être utilisée qu'avec les campagnes Shopping standards et sur le Réseau de Recherche.
PRESENCE Indique qu'une annonce est déclenchée si l'utilisateur se trouve dans les zones ciblées de l'annonceur ou s'y rend régulièrement.

NegativeGeoTargetType

Types de zones 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éresse.
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 pour l'optimiser. Cette fonctionnalité ne s'applique qu'aux campagnes pour applications qui utilisent MULTI_CHANNEL comme AdvertisingChannelType et APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT comme AdvertisingChannelSubType.

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

string

Ensemble de noms de ressources sélectionné pour les actions de conversion permettant d'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é comme valeur de retour uniquement. Représente une valeur inconnue dans cette version.
CALL_CLICKS Optimisez pour les clics sur les appels. Les conversions après clic sur "Appeler" correspondent aux fois où les utilisateurs ont sélectionné "Appeler" pour contacter un magasin après avoir vu une annonce.
DRIVING_DIRECTIONS Optimisez pour les itinéraires routiers. Les conversions "Itinéraire" correspondent aux fois où les utilisateurs ont 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'utilisateurs qui se sont préinscrits pour recevoir une notification lorsque l'application sera 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 en fonction d'une action spécifiée par l'annonceur.

ManualCpc

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

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

boolean

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

ManualCpm

Ce type ne comporte aucun champ.

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

PercentCpc

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

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

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. Il s'agit d'un champ facultatif saisi par l'annonceur et spécifié en micro-unités locales. Remarque: Une valeur de zéro est interprétée de la même manière que si la valeur bid_ceiling n'était pas définie.
enhancedCpcEnabled

boolean

Ajuste l'enchère pour chaque mise aux enchères à la hausse ou à la baisse, en fonction de la probabilité d'une conversion. Les enchères individuelles peuvent dépasser cpcBidCeilingMicros, mais le montant moyen des enchères d'une campagne ne doit pas le faire.

TargetCpm

Ce type ne comporte aucun champ.

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

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 la ressource de l'asset de la campagne. Les noms de ressources CampaignAsset ont la forme suivante:

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 est l'association entre une campagne et un ensemble d'assets. Ajouter un CampaignAssetSet permet d'associer 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 campagne. Les noms de ressources des éléments d'un ensemble d'éléments ont la forme suivante :

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

string

Campagne à laquelle cet ensemble d'éléments est associé.
assetSet

string

Ensemble de composants associé à la campagne.
status

enum (AssetSetLinkStatus)

État de l'élément de l'ensemble de composants de la campagne. Lecture seule.

CampaignAudienceView

Vue de l'audience d'une campagne. Inclut les données de performances des centres d'intérêt et des listes de remarketing pour les annonces sur le Réseau Display et le Réseau YouTube, ainsi que les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), agrégées par campagne et critère 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 de l'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

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 des critères de campagne sont au format suivant :

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

string

Nom à afficher du critère.

Ce champ est ignoré pour les mutations.
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 de l'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

Indique si le critère doit être ciblé (false) ou exclu (true).

Champ d'union criterion. Critère de la campagne.

Vous devez définir un seul de ces champs. 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 des utilisateurs.
language

object (LanguageInfo)

HashiCorp.
webpage

object (WebpageInfo)

Page Web
locationGroup

object (LocationGroupInfo)

Groupe de zones géographiques

CampaignCriterionStatus

États possibles d'un CampaignCriterion.

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 réservée aux réponses.
ENABLED Le critère de campagne est activé.
PAUSED Le critère de campagne est mis en veille.
REMOVED Le critère de campagne est supprimé.

LanguageInfo

Critère linguistique

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

string

Nom de la ressource de la constante de langue.

LocationGroupInfo

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

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

string

Constante(s) de ciblage géographique limitant la portée de la zone géographique dans le flux. Actuellement, une seule constante de zone géographique est autorisée.
radiusUnits

enum (LocationGroupRadiusUnits)

Unité du rayon. Les constantes de ciblage géographique sont acceptées en miles et en mètres. Les millimètres et les mètres sont acceptés pour les ensembles d'éléments de flux. Ce paramètre est obligatoire et doit être défini dans les opérations CREATE.
feedItemSets[]

string

Ensembles d'éléments de flux dont les éléments sont ciblés. Si plusieurs ID sont spécifiés, tous les éléments qui apparaissent dans au moins un ensemble sont ciblés. Ce champ ne peut pas être utilisé avec geoTargetConstants. Ce paramètre est facultatif et ne peut être défini que dans les opérations CREATE.
radius

string (int64 format)

Distance en unités spécifiant le rayon autour des zones ciblées. Ce paramètre est obligatoire et doit être défini dans les opérations CREATE.

LocationGroupRadiusUnits

Unité de mesure du 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 la valeur inconnue dans cette version.
METERS Mètres
MILES Miles
MILLI_MILES Milli miles

CampaignEffectiveLabel

Représente une relation entre une campagne et une étiquette efficace. Un libellé efficace est un libellé hérité ou directement attribué à cette campagne.

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

string

Nom de la ressource. Les noms de ressources CampaignEffectivelabel ont la forme suivante: customers/{customerId}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

Campagne à laquelle le libellé "effective" est associé.
label

string

Libellé effectif attribué à la campagne.
ownerCustomerId

string (int64 format)

Identifiant du client propriétaire du libellé effectif.

CampaignLabel

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

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

string

Nom de la ressource. Les noms de ressources des libellés de campagne se présentent sous la forme suivante: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}
campaign

string

Campagne à laquelle le libellé est associé.
label

string

Libellé attribué à la campagne.
ownerCustomerId

string (int64 format)

ID du client propriétaire du libellé.

CartDataSalesView

Affichage des données du panier sur les ventes.

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

string

Nom de ressource de la vue des données du panier. Les noms de ressources de la vue des ventes des données du panier se présentent 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 des données démographiques détaillées et des audiences d'affinité, 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 la ressource de l'audience. Les noms d'audience se présentent comme suit:

customers/{customerId}/audiences/{audience_id}
id

string (int64 format)

ID de l'audience.
name

string

Obligatoire. Nom de l'audience. Il doit être unique pour toutes les audiences. Il doit comporter au moins un caractère et au maximum 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. Les noms de ressources d'action de conversion se présentent 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 des conversions enregistrées 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 lié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", l'action de conversion n'est pas enchérissable pour toutes les campagnes, quel que soit l'objectif de conversion de la campagne ou celui des clients. Toutefois, les objectifs de conversion personnalisés ne respectent pas le champ primaryForGoal. Par conséquent, si un objectif de conversion personnalisé est configuré pour une campagne avec une action de conversion primaryForGoal = fausse, cette action de conversion est toujours enchérissable. Par défaut, la valeur de primaryForGoal est "true" si elle n'est pas définie. Dans la version 9, la valeur "false" ne peut être attribuée à "primaryForGoal" qu'après la création via une opération "update", car elle n'est pas déclarée comme facultative.
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 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 d'actions de conversion possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
AD_CALL Conversions qui se produisent lorsqu'un utilisateur clique sur l'extension Appel d'une annonce.
CLICK_TO_CALL Conversions qui se produisent lorsqu'un utilisateur sur un appareil mobile clique sur un numéro de téléphone.
GOOGLE_PLAY_DOWNLOAD Conversions qui se produisent lorsqu'un utilisateur télécharge une application mobile depuis le Google Play Store.
GOOGLE_PLAY_IN_APP_PURCHASE Conversions qui se produisent lorsqu'un utilisateur effectue un achat dans une application via le système de facturation Android.
UPLOAD_CALLS Conversions d'appels suivies et importées par l'annonceur.
UPLOAD_CLICKS Conversions suivies par l'annonceur et importées avec des clics attribués.
WEBPAGE Conversions qui se produisent sur une page Web.
WEBSITE_CALL Conversions qui se produisent lorsqu'un utilisateur appelle un numéro de téléphone généré dynamiquement depuis le site Web d'un annonceur.
STORE_SALES_DIRECT_UPLOAD Conversion "ventes en magasin" basée sur les importations de données marchandes propriétaires ou tierces. Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types d'importation directe des ventes en magasin.
STORE_SALES Conversion "Ventes en magasin" basée sur les données d'importation de marchands first party ou tiers et/ou sur les achats en magasin effectués avec des 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 Conversion de première ouverture d'une application Android suivie via Firebase
FIREBASE_ANDROID_IN_APP_PURCHASE Conversions d'achat via une application Android suivies via Firebase
FIREBASE_ANDROID_CUSTOM Conversions personnalisées d'applications Android suivies via Firebase
FIREBASE_IOS_FIRST_OPEN Conversion de première ouverture d'une application iOS suivie via Firebase
FIREBASE_IOS_IN_APP_PURCHASE Conversion d'achats via une application dans une application iOS suivie via Firebase
FIREBASE_IOS_CUSTOM Conversions personnalisées dans une application iOS suivies via Firebase
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversions à la première ouverture des applications Android suivies via un outil d'analyse d'applications tiers.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversion d'achat via une application Android suivie via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversions personnalisées des applications Android suivies via un outil d'analyse d'applications tiers.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversions de 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'achats via une application dans une application iOS suivies via une solution d'analyse d'applications tierce
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversions personnalisées dans une application iOS suivies via une solution d'analyse d'applications tierce
ANDROID_APP_PRE_REGISTRATION Conversions qui se produisent lorsqu'un utilisateur se préinscrit à une application mobile sur le Google Play Store. Lecture seule.
ANDROID_INSTALLS_ALL_OTHER_APPS Conversions qui suivent tous les téléchargements Google Play qui ne sont pas suivis par un type spécifique à l'application. Lecture seule.
FLOODLIGHT_ACTION Activité Floodlight qui compte le nombre de fois que 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 qui permet de suivre le nombre de ventes réalisées ou le nombre d'articles achetés. Peut également enregistrer la valeur totale de chaque vente. Lecture seule.
GOOGLE_HOSTED Conversions qui suivent les actions locales des produits et services Google après une interaction avec une annonce. Lecture seule.
LEAD_FORM_SUBMIT Conversions enregistré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 de Search Ads 360. Lecture seule.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Les conversions d'appels qui se produisent dans les annonces de campagnes intelligentes sans configuration du suivi des appels, à l'aide de critères personnalisés de campagne intelligente. 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 un itinéraire vers un établissement dans Google Maps. Campagne intelligente uniquement. Lecture seule.
SMART_CAMPAIGN_TRACKED_CALLS Conversions par appel qui se produisent dans les annonces de campagnes intelligentes avec le suivi des appels configuré, à l'aide de critères personnalisés de campagne intelligente. Lecture seule.
STORE_VISITS Conversions qui se produisent lorsqu'un utilisateur visite le magasin d'un annonceur. Lecture seule.
WEBPAGE_CODELESS Conversions créées à partir d'événements sur le site Web (envoi de formulaires ou chargement de pages, par exemple) qui n'utilisent pas d'extraits d'événements 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 de conversions d'événements personnalisés Google Analytics 4 associés.
GOOGLE_ANALYTICS_4_PURCHASE Conversions provenant des conversions d'achat Google Analytics 4 associées.

ConversionActionCategory

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la valeur inconnue dans cette version.
DEFAULT Catégorie par défaut.
PAGE_VIEW Utilisateur consultant une page.
PURCHASE Événement "achat", "ventes" ou "commande passée".
SIGNUP Action de l'utilisateur consistant à s'inscrire.
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 à effectuer un paiement sur le site d'un annonceur
SUBSCRIBE_PAID Début d'un abonnement payant pour un produit ou un service.
PHONE_CALL_LEAD Appel pour indiquer un intérêt pour l'offre d'un annonceur.
IMPORTED_LEAD Conversion de prospect importée depuis une source externe dans Google Ads.
SUBMIT_LEAD_FORM Envoi d'un formulaire sur le site d'un annonceur indiquant un intérêt commercial.
BOOK_APPOINTMENT Réservation d'un rendez-vous dans l'établissement d'un annonceur.
REQUEST_QUOTE Demande de devis ou d'estimation de prix.
GET_DIRECTIONS Recherche de l'établissement d'un annonceur avec l'intention de s'y rendre
OUTBOUND_CLICK Clic sur le site d'un partenaire d'un annonceur.
CONTACT Appel, SMS, e-mail, chat ou tout autre type de contact avec un annonceur
ENGAGEMENT Un événement d'engagement sur un site Web, comme une durée de session prolongée ou un objectif intelligent Google Analytics (GA). Destiné à être utilisé pour les importations d'objectifs Or GA, Firebase et GA.
STORE_VISIT Visite d'un magasin physique
STORE_SALE Une promotion a lieu dans un magasin physique.
QUALIFIED_LEAD Conversion de prospect importée depuis une source externe dans Google Ads, et qui a été qualifiée par l'annonceur (équipe marketing/ventes). Dans le parcours de génération de prospects à la vente, les annonceurs obtiennent des prospects, puis les exploitent en contactant le consommateur. Si le consommateur est intéressé et peut finir par acheter le produit, l'annonceur marque ces prospects comme "prospects qualifiés".
CONVERTED_LEAD Conversion de prospect importée depuis une source externe dans Google Ads, qui a terminé une étape choisie, comme défini par l'annonceur générant des 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 de 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 utiliser toujours la valeur par défaut.
defaultCurrencyCode

string

Code de devise à utiliser lorsque les événements de conversion de 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 utiliser toujours la valeur par défaut.
alwaysUseDefaultValue

boolean

Indique si la valeur par défaut 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 lié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

Modèle d'attribution qui décrit comment répartir le crédit d'une conversion particulière entre de nombreuses interactions précédentes.

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 à l'aide de l'attribution Google Search.
GOOGLE_SEARCH_ATTRIBUTION_LINEAR Attribue le crédit d'une conversion de manière égale à tous ses clics grâce à l'attribution sur le Réseau de Recherche de Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attribue de manière exponentielle plus de crédit à une conversion pour ses clics les plus récents à l'aide de l'attribution sur le Réseau de Recherche de Google (demi-vie de 1 semaine).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attribue 40% du crédit d'une conversion à ses premiers et derniers clics. Les 20% restants sont répartis uniformément entre tous les autres clics. Cette attribution utilise la recherche 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 de 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 la 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. Il n'a pas été mis à 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é. Cela est généralement dû au fait que le nombre d'événements requis n'a pas été atteint au cours d'une période de 30 jours récente.
NEVER_GENERATED Le modèle basé sur les données n'a jamais été généré. Le plus souvent, cela est dû au fait que le nombre d'événements requis sur une période de 30 jours n'a jamais été atteint.

FloodlightSettings

Paramètres lié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

Une variable personnalisée de conversion Pour en savoir plus, consultez la section "À propos des métriques et des dimensions Floodlight personnalisées dans la nouvelle interface Search Ads 360" à l'adresse 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 de ressources des variables personnalisées de conversion se présentent sous la forme suivante :

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. Le nom ne doit pas dépasser 100 caractères. Il ne doit pas y avoir d'espaces superflus avant et après.
tag

string

Obligatoire. Balise de la variable personnalisée de conversion. Un tag doit être unique et se composer d'un "u" suivi d'un nombre inférieur ou égal à 100. Exemple: "u4".
status

enum (ConversionCustomVariableStatus)

État de la variable personnalisée de conversion pour le décompte des événements de conversion.
ownerCustomer

string

Nom de ressource du client propriétaire 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 la valeur inconnue dans cette version.
ACTIVATION_NEEDED

La variable personnalisée de conversion est en attente d'activation et ne génèrera pas d'autres statistiques tant qu'elle n'est pas définie sur "ACTIVE".

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 et ne générera pas de statistiques tant qu'elle ne sera pas redéfinie sur 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 la valeur inconnue dans cette version.
BELOW_ALL_LIMITS La cardinalité de la variable personnalisée de conversion est inférieure à toutes les limites. La variable peut être utilisée pour la segmentation, et les statistiques peuvent s'accumuler pour les nouvelles valeurs si elle 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 pas la limite de statistiques. La segmentation sera désactivée, mais les statistiques peuvent s'accumuler pour les 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 s'approche des limites de statistiques (> 90%). La segmentation sera désactivée, mais les statistiques peuvent s'accumuler pour les 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 les limites des statistiques. La segmentation sera désactivée et les statistiques pour les variables activées ne pourront s'accumuler que si les valeurs existantes n'augmentent plus la cardinalité de la variable.

FloodlightConversionCustomVariableInfo

Informations sur 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 "Variable Floodlight" défini dans Search Ads 360

FloodlightVariableType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 https://support.google.com/searchads/answer/4397154?hl=en.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 "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 la ressource du client. Les noms de ressources client ont la forme suivante :

customers/{customerId}
conversionTrackingSetting

object (ConversionTrackingSetting)

Paramètre de suivi des conversions pour 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 (CM) pour un compte administrateur.
accountStatus

enum (AccountStatus)

État du compte (par exemple, "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 pour l'ajout de 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 administrateur.

ConversionTrackingSetting

Ensemble de paramètres définis au niveau du client pour 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. Il indique si le client utilise le suivi des conversions et qui en est le propriétaire. Si ce 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 du compte administrateur. Ce champ est en lecture seule.
googleAdsConversionCustomer

string

Nom de la ressource du client où 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 (c'est le champ "conversionTrackingStatus" qui le fait). Ce champ est en lecture seule.
googleAdsCrossAccountConversionTrackingId

string (int64 format)

ID de suivi des conversions de l'administrateur du client. Il est défini lorsque le client active le suivi des conversions et remplace "conversionTrackingId". Ce champ ne peut être géré que via l'interface utilisateur 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 active le suivi des conversions multicomptes et remplace le paramètre "conversionTrackingId".

ConversionTrackingStatus

État du suivi des conversions du client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 le login-customer-id de la requête.
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 Compte Google Ads.
MICROSOFT Compte Microsoft Advertising
SEARCH_ADS_360 Compte administrateur Search Ads 360
YAHOO_JAPAN Compte Yahoo! Japan.

DoubleClickCampaignManagerSetting

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

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

string (int64 format)

ID 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 (par exemple, Amérique du Nord/New_York).

AccountStatus

États possibles d'un compte

Enums
UNSPECIFIED Valeur par défaut.
UNKNOWN Valeur inconnue.
ENABLED Le compte peut diffuser des annonces.
PAUSED Le compte est désactivé par l'utilisateur.
SUSPENDED Le compte est désactivé par un processus interne.
REMOVED Le compte est irrévocablement désactivé.
DRAFT La configuration du compte est toujours en cours et n'est pas encore ACTIVE.

CustomerStatus

États possibles d'un client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la valeur inconnue dans cette version.
ENABLED Indique qu'un compte est actif et peut diffuser des annonces.
CANCELED Indique qu'un compte résilié ne peut pas diffuser d'annonces. Peut être réactivé par un utilisateur 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. L'état du compte de test sera également "CLOSED" (CLÔTURÉ). 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 la forme suivante :

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

string

Obligatoire. Élément associé au client.
status

enum (AssetLinkStatus)

État de l'asset du client.

CustomerAssetSet

CustomerAssetSet est le lien entre un client et un ensemble d'éléments. Ajouter un CustomerAssetSet permet d'associer un ensemble d'assets à un client.

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

string

Nom de ressource de l'ensemble d'éléments client. Les noms de ressources des éléments d'un ensemble d'éléments ont la forme suivante :

customers/{customerId}/customerAssetSets/{asset_set_id}
assetSet

string

Ensemble de composants associé au client.
customer

string

Client auquel cet ensemble d'éléments est associé.
status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

Représente une vue des BiddingStrategies appartenant au client et partagées avec lui.

Contrairement à BiddingStrategy, cette ressource inclut les stratégies appartenant aux administrateurs du client et partagées avec ce client, en plus des stratégies appartenant à ce client. Cette ressource ne fournit pas de métriques et n'expose 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 la ressource de la stratégie d'enchères accessible. Les noms de ressources AccessibleBiddingStrategy ont 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)

ID du client propriétaire de la stratégie d'enchères.
ownerDescriptiveName

string

Nom descriptif du client propriétaire de la stratégie d'enchères.

Champ d'union scheme. Schéma 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)

Stratégie d'enchères automatiques qui vous aide à maximiser la valeur de conversion de vos campagnes tout en dépensant votre budget.
maximizeConversions

object (MaximizeConversions)

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

object (TargetCpa)

Stratégie d'enchères 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 avez défini.
targetImpressionShare

object (TargetImpressionShare)

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

object (TargetRoas)

Stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant, en moyenne, un ROAS (retour sur les dépenses publicitaires) cible spécifique.
targetSpend

object (TargetSpend)

Stratégie d'enchères qui définit vos enchères pour vous aider à enregistrer un maximum de clics dans les limites de votre budget.

MaximizeConversionValue

Stratégie d'enchères automatiques qui vous aide à maximiser la valeur de conversion de vos campagnes tout en dépensant votre budget.

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

number

L'option "Objectif de ROAS cible" Si vous définissez cette option, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, votre objectif de retour sur les dépenses publicitaires. Si le ROAS cible est élevé, la stratégie d'enchères risque de ne pas pouvoir dépenser la totalité du budget. Si vous ne définissez pas de ROAS cible, la stratégie d'enchères s'efforcera d'atteindre le ROAS le plus élevé possible pour le budget.

Maximiser les conversions

Stratégie d'enchères automatiques qui vous aide à enregistrer un maximum de conversions pour vos campagnes tout en dépensant votre budget.

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

string (int64 format)

L'option "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 "Coût par acquisition (CPA) cible" Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.

TargetCpa

Cette stratégie d'enchères automatiques 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 avez défini.

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

Stratégie d'enchères automatiques qui définit les enchères afin qu'un certain pourcentage d'annonces sur le Réseau de Recherche soit diffusé en haut de la première page (ou à un autre emplacement ciblé).

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

enum (TargetImpressionShareLocation)

Emplacement ciblé sur la page de résultats de recherche.
locationFractionMicros

string (int64 format)

Fraction d'annonces à diffuser dans la zone géographique ciblée, en micros. Par exemple, 1% correspond à 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

Il s'agit d'une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen 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

La stratégie d'enchères "Maximiser les clics" définit automatiquement vos enchères pour que vous enregistriez 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 la fin de la relation
PENDING Indique que la relation a été demandée par l'administrateur, mais que le client ne l'a pas encore acceptée.
REFUSED Le responsable a demandé à établir une relation, mais le client a refusé.
CANCELED Indique que la relation a été demandée par l'administrateur, mais qu'il l'a annulée.

CustomerClient

Lien entre le client donné et un client client. Les CustomerClients n'existent que pour les clients administrateurs. 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 la ressource du client client. Les noms de ressources CustomerClient sont au format customers/{customerId}/customerClients/{client_customer_id}.
appliedLabels[]

string

Noms de ressource des libellés appartenant au client à l'origine de la demande et appliqués au client. Les noms de ressources d'étiquette se présentent comme suit:

customers/{customerId}/labels/{label_id}
status

enum (CustomerStatus)

État du client. Lecture seule.
clientCustomer

string

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

boolean

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

Lecture seule.
level

string (int64 format)

Distance entre un client donné et un autre client. Pour les liens internes, la valeur de niveau est 0. Lecture seule.
timeZone

string

Représentation de la chaîne CLDR (Common Locale Data Repository) du fuseau horaire du client, par exemple America/Los_Angeles. Lecture seule.
testAccount

boolean

Indique si le client est un compte test. Lecture seule.
manager

boolean

Indique si le client est un administrateur. Lecture seule.
descriptiveName

string

Nom descriptif du client. Lecture seule.
currencyCode

string

Code de devise (par exemple, "USD", "EUR") du client. Lecture seule.
id

string (int64 format)

ID du client client. Lecture seule.

DynamicSearchAdsSearchTermView

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 la ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Les noms de ressources des vues de termes de recherche des annonces dynamiques du Réseau de Recherche se présentent sous la forme suivante :

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 de l'impression.

Ce champ est en lecture seule.

GenderView

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ère de genre est diffusé auprès de tous les genres. Tous les genres apparaissent donc dans genderView avec des statistiques.

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

string

Nom de ressource de la vue par genre. Les noms de ressources des vues par genre se présentent sous la forme suivante:

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

GeoTargetConstant

Une constante de ciblage 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 la ressource de la constante de ciblage géographique. Les noms de ressources de constantes de ciblage géographique ont la forme suivante :

geoTargetConstants/{geo_target_constant_id}
status

enum (GeoTargetConstantStatus)

État de la constante de ciblage géographique.
id

string (int64 format)

ID de la constante de ciblage géographique.
name

string

Nom anglais de la constante de la cible géographique.
countryCode

string

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

string

Type de cible de la constante de ciblage géographique.
canonicalName

string

Nom anglais complet, composé du nom de la cible, de celui de son parent et de son pays.
parentGeoTarget

string

Nom de ressource de la constante de cible géographique parente. Les noms de ressources de constantes de ciblage géographique ont la forme suivante :

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

États possibles d'une constante de ciblage 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 réservée aux réponses.
ENABLED La constante de ciblage géographique est valide.
REMOVAL_PLANNED La constante de ciblage géographique est obsolète et sera supprimée.

KeywordView

Vue par mot clé.

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

string

Nom de ressource de la vue des mots clés. Les noms de ressources des vues de mots clés se présentent sous la forme suivante:

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

Libellé

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 de ressources d'étiquettes se présentent sous la forme suivante: 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 de couleur.
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 la valeur inconnue dans cette version.
ENABLED Le libellé est activé.
REMOVED Le libellé est supprimé.

TextLabel

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

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

string

Couleur d'arrière-plan du libellé au format hexadécimal. 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 pour les comptes administrateur.
description

string

Brève description du libellé. La longueur de l'élément 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 la ressource de la constante de langue. Les noms de ressources de constantes de langue ont 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 "English (US)", "Spanish", etc.
targetable

boolean

Indique si la langue peut être ciblée.

LocationView

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

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

string

Nom de la ressource de la vue d'établissement. Les noms des ressources de la vue d'emplacement se présentent sous la forme suivante:

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

ProductBiddingCategoryConstant

Une catégorie d'enchères sur les 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 de ressources de la catégorie d'enchères sur les produits se présentent sous la forme suivante:

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

enum (ProductBiddingCategoryLevel)

Niveau de la catégorie d'enchères du produit.
status

enum (ProductBiddingCategoryStatus)

État de la catégorie d'enchères associées au produit.
id

string (int64 format)

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

Cet ID est équivalent à l'ID google_product_category 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 la ressource de la catégorie d'enchères de produits parente.
languageCode

string

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

string

Valeur d'affichage de la catégorie d'enchères de produit localisée conformément au code 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 la 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 des produits.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 à des fins de création de rapports.

ProductGroupView

Vue de groupe de produits.

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

string

Nom de ressource de la vue du groupe de produits. Les noms de ressources des vues de groupes de produits se présentent sous la forme :

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

ShoppingPerformanceView

Vue "Performances Shopping". Fournit des statistiques sur les campagnes Shopping agrégées à plusieurs niveaux de dimension 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. Les noms de ressources des vues des performances Shopping se présentent sous la forme : customers/{customerId}/shoppingPerformanceView.

UserList

Liste des 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 la ressource de la liste d'utilisateurs. Les noms de ressources de liste d'utilisateurs ont 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)

ID de la liste d'utilisateurs.
name

string

Nom de cette liste d'utilisateurs. Selon son 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 la valeur inconnue dans cette version.
REMARKETING UserList représentée sous la forme d'un ensemble de types de conversion.
LOGICAL UserList représentée sous la forme d'une combinaison d'autres listes/centres d'intérêt d'utilisateurs.
EXTERNAL_REMARKETING UserList créée sur la plate-forme Google Ad Manager
RULE_BASED UserList associée à une règle.
SIMILAR UserList avec des utilisateurs semblables à ceux d'une autre UserList.
CRM_BASED Liste d'utilisateurs de données CRM first party fournies par l'annonceur sous forme d'e-mails ou d'autres formats.

UserLocationView

Vue de la position d'un utilisateur

La vue "Emplacement de l'utilisateur" inclut toutes les métriques agrégées au niveau du pays, une ligne par pays. Il fournit des métriques sur la position physique réelle de l'utilisateur, en fonction de la zone ciblée ou non. Si d'autres champs de segment sont utilisés, il est possible que plusieurs lignes s'affichent pour chaque pays.

Représentation JSON 
{
  "resourceName": string,
  "countryCriterionId": string,
  "targetingLocation": boolean
}
Champs
resourceName

string

Nom de la ressource de la vue de l'emplacement de l'utilisateur. Les noms de ressources de la vue UserLocation se présentent sous la forme suivante:

customers/{customerId}/userLocationViews/{countryCriterionId}~{targetingLocation}
countryCriterionId

string (int64 format)

ID du critère pour le pays.
targetingLocation

boolean

Indique si l'emplacement a été ciblé ou non.

WebpageView

Affichage d'une page Web.

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

string

Nom de ressource de la page Web vue. Les noms des ressources de vue de page Web se présentent 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 de ressources de visite se présentent sous la forme suivante:

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 de l'élément avec lequel l'utilisateur a interagi lors de l'événement "visite".
assetFieldType

enum (AssetFieldType)

Type de champ de l'élément 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 la valeur inconnue dans cette version.
ONLINE L'article est vendu en ligne.
LOCAL L'article est vendu dans les magasins locaux.

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. Les noms de ressources de conversion se présentent 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 visite Search Ads 360 auquel 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, il correspond à la colonne "id" ou à la colonne "floodlightOrderId" suivant 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 de l'élément avec lequel l'utilisateur a interagi lors de l'événement de conversion.
assetFieldType

enum (AssetFieldType)

Type de champ de l'élément 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 la valeur inconnue dans cette version.
VISIT La conversion est attribuée à une visite.
CRITERION_AD La conversion est attribuée à une paire critère/annonce.

ConversionStatus

États possibles d'une conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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,
  "crossDeviceConversionsByConversionDate": number,
  "crossDeviceConversionsValue": number,
  "crossDeviceConversionsValueByConversionDate": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "generalInvalidClickRate": number,
  "generalInvalidClicks": 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 de date correspondent à la date de conversion. Pour en savoir plus sur les colonnes "par_date_de_conversion", consultez https://support.google.com/sa360/answer/9250611.
allConversionsByConversionDate

number

Cette valeur correspond au nombre total de conversions. Inclut toutes les conversions, quelle que soit la valeur de "includeInConversionsMetric". Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne de date correspondent à la date de conversion. Pour en savoir plus sur les colonnes "par_date_de_conversion", consultez https://support.google.com/sa360/answer/9250611.
conversionCustomMetrics[]

object (Value)

Métriques personnalisées de conversion.
conversionsValueByConversionDate

number

Somme de la valeur des conversions enchérissables par date de conversion. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne de 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 d'attribution. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne de date correspondent à la date de conversion.
historicalCreativeQualityScore

enum (QualityScoreBucket)

Historique du niveau de qualité de la création.
historicalLandingPageQualityScore

enum (QualityScoreBucket)

Qualité de l'historique de l'expérience sur la page de destination
historicalSearchPredictedCtr

enum (QualityScoreBucket)

Taux de clics (CTR) prévu pour la recherche dans l'historique
interactionEventTypes[]

enum (InteractionEventType)

Types d'interactions payantes et gratuites.
rawEventConversionMetrics[]

object (Value)

Métriques de conversion d'événement brutes.
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

Toutes les conversions issues des interactions (par opposition aux conversions après affichage) divisées par le nombre d'interactions avec les annonces.
allConversionsValue

number

Valeur de toutes les conversions.
allConversions

number

Cette valeur correspond au nombre total de conversions. Inclut toutes les conversions, quelle que soit la valeur de "includeInConversionsMetric".
allConversionsValuePerCost

number

Valeur de toutes les conversions divisée par le coût total des interactions avec les annonces (clics sur les annonces textuelles ou vues des annonces vidéo, par exemple).
allConversionsFromClickToCall

number

Nombre de fois où les utilisateurs ont cliqué sur le bouton "Appeler" pour contacter un magasin après avoir vu une annonce ou cliqué dessus. Tous les appels sont comptabilisés, indépendamment de leur durée, qu'ils aient abouti ou non.

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 utilisateurs ont cliqué sur un lien vers le menu d'un magasin 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 supplémentaires (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

Il s'agit du 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
averageCpm

number

Coût moyen pour mille impressions (CPM). Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clicks

string (int64 format)

Nombre de clics.
contentBudgetLostImpressionShare

number

Estimation du pourcentage 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 pour le budget du 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 dont 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 de la conversion enchérissable divisée par le coût total des interactions éligibles à la conversion.
conversionsFromInteractionsValuePerInteraction

number

Valeur des conversions générées par les interactions, divisée par le nombre d'interactions avec l'annonce. Cela n'inclut que les actions de conversion dont 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 dont 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
costPerAllConversions

number

Coût des interactions avec les annonces divisé par toutes les conversions.
costPerConversion

number

Coût moyen éligible à la conversion par conversion enchérissable.
costPerCurrentModelAttributedConversion

number

Coût des interactions avec les annonces divisé par les conversions attribuées par le modèle actuel. Cela n'inclut que les actions de conversion dont 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 allConversions.
crossDeviceConversionsByConversionDate

number

Nombre de conversions multi-appareils par date de conversion. Pour en savoir plus sur les colonnes "par_date_de_conversion", consultez https://support.google.com/sa360/answer/9250611.
crossDeviceConversionsValue

number

Somme de la valeur des conversions multi-appareils.
crossDeviceConversionsValueByConversionDate

number

Somme des valeurs des conversions multi-appareils par date de conversion. Pour en savoir plus sur les colonnes "par_date_de_conversion", consultez https://support.google.com/sa360/answer/9250611.
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 dont 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.
averageQualityScore

number

Niveau de qualité moyen.
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

Fréquence à laquelle les utilisateurs interagissent avec votre annonce après l'avoir 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 à l'action principale de l'utilisateur associée à un format d'annonce : les clics pour les annonces textuelles et Shopping, les vues pour les annonces vidéo, etc.
invalidClickRate

number

Pourcentage de clics exclus du 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 illégitimes et qui ne vous sont pas facturés.
generalInvalidClickRate

number

Pourcentage de clics non comptabilisés dans le nombre total de clics (clics filtrés + clics non filtrés) car il s'agissait de clics incorrects généraux. Il s'agit des clics que Google considère comme illégitimes et détectés par des méthodes courantes de filtrage (trafic incorrect connu dans les centres de données, robots ou autres robots d'exploration, schémas irréguliers, etc.). Ces clics ne sont ni facturés, ni comptabilisés dans les statistiques de votre compte. Pour en savoir plus, consultez la page d'aide https://support.google.com/campaignmanager/answer/6076504.
generalInvalidClicks

string (int64 format)

Nombre de clics incorrects généraux. Il s'agit d'un sous-ensemble de vos clics incorrects détectés par des méthodes de filtrage régulières (trafic incorrect connu d'un centre de données, robots d'exploration, schémas irréguliers, etc.). Ces clics ne sont ni facturés, ni comptabilisés dans les statistiques de votre compte. Pour en savoir plus, consultez la page d'aide https://support.google.com/campaignmanager/answer/6076504.
mobileFriendlyClicksPercentage

number

Pourcentage de clics sur mobile qui redirigent les utilisateurs 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

Nombre estimé de fois où votre annonce n'était pas la première des annonces en première position dans les résultats de recherche en raison d'un budget trop faible. Remarque: le taux d'impressions perdues en première position absolue 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 premiers résultats de recherche naturels en raison d'un budget trop faible. Remarque: le taux d'impressions perdues en première position 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 enregistrés sur le Réseau de Recherche, divisé par le nombre estimé de clics que vous auriez pu enregistrer. 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 sur le Réseau de Recherche pour des termes de recherche correspondant exactement à vos mots clés (ou étant des variantes proches), divisé par le nombre estimé d'impressions qu'elles étaient susceptibles d'enregistrer dans les mêmes conditions, quel que soit le type 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

Nombre estimé de fois où votre annonce n'était pas la première des annonces en première position 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 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

Nombre estimé de fois où 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 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

Impressions enregistrées parmi les annonces en première position, comparées au nombre estimé d'impressions que vous auriez pu enregistrer à ces emplacements. 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 premiers 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 leur nombre. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne de date correspondent à la date de conversion. Pour en savoir plus sur les colonnes "par_date_de_conversion", consultez https://support.google.com/sa360/answer/9250611.
valuePerConversion

number

Valeur de la 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 de 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. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur 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. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur 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. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountCrossSellUnitsSold

number

La métrique "Unités vendues via les ventes croisées du compte client" 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.
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 du compte client (prix de revient) 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountLeadGrossProfitMicros

string (int64 format)

La marge brute des prospects du 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur 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. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountLeadUnitsSold

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

Une valeur flottante.
doubleValue

number

Valeur double.
stringValue

string

Chaîne.

QualityScoreBucket

Énumération listant les buckets de niveau de qualité possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente la 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 d'interactions payantes et gratuites possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
CLICK Cliquez sur le site. Dans la plupart des cas, cette interaction redirige l'utilisateur vers un site externe, généralement la page de destination de l'annonceur. Il s'agit également du type d'événement InteractionEventType par défaut pour les événements de clic.
ENGAGEMENT Intention exprimée par l'utilisateur d'interagir avec l'annonce en place.
VIDEO_VIEW L'utilisateur a regardé une annonce vidéo.
NONE InteractionEventType par défaut pour les événements de conversion d'annonce. Cette option est utilisée lorsqu'une ligne de conversion d'annonce n'indique PAS que les interactions gratuites (par exemple, les conversions d'annonces) doivent être "promues" et comptabilisées dans les métriques principales. Il s'agit simplement d'autres conversions (publicitaires).

Segments

Champs de segment 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,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "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 de l'action de conversion.
conversionCustomDimensions[]

object (Value)

Dimensions personnalisées de la 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 de conversion d'événement brutes.
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.
geoTargetCity

string

Nom de la ressource de la constante de ciblage géographique représentant une ville.
geoTargetCountry

string

Nom de la ressource de la constante de ciblage géographique représentant un pays.
geoTargetMetro

string

Nom de la ressource de la constante de ciblage géographique représentant une zone métropolitaine.
geoTargetRegion

string

Nom de ressource de la constante de cible géographique qui représente une région.
hour

integer

Heure de la journée, sous la forme d'un nombre compris entre 0 et 23 (inclus).
month

string

Mois représenté par la date du premier jour du mois. au 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 comme représenté par la date du premier jour d'un trimestre. Utilise l'année civile pour les trimestres. Par exemple, le deuxième trimestre 2018 commence le 01/04/2018. au format AAAA-MM-JJ.
week

string

Semaine définie du lundi au dimanche et représentée par la date du lundi. au format AAAA-MM-JJ.
year

integer

Année, au format aaaa.
assetInteractionTarget

object (AssetInteractionTarget)

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et AdGroupAsset. Indique si les métriques d'interaction ont eu lieu sur l'asset lui-même, ou sur un autre asset ou une autre unité d'annonce. Les interactions (clics, par exemple) sont comptabilisées pour toutes les parties de l'annonce diffusée (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. Lorsque "interactionOnThisAsset" est défini sur "false", cela signifie que les interactions ne se trouvent pas sur cet élément spécifique, mais sur d'autres parties de l'annonce avec laquelle cet élément est diffusé.

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éseaux

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

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 la valeur inconnue dans cette version.
SINGLE_CHANNEL L'article est vendu par le biais d'un seul canal de distribution, à savoir les magasins locaux ou en ligne, comme l'indique le canal de distribution ProductChannel.
MULTI_CHANNEL L'article est mis en correspondance avec son équivalent en ligne ou en magasin, ce qui indique qu'il est disponible à l'achat dans les deux ShoppingProductChannels.

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 la valeur inconnue dans cette version.
OLD L'état du produit est ancien.
NEW Le produit est neuf.
REFURBISHED L'état du produit est "Reconditionné".
USED L'état du produit est "d'occasion".

AssetInteractionTarget

Segment AssetInteractionTarget.

Représentation JSON 
{
  "asset": string,
  "interactionOnThisAsset": boolean
}
Champs
asset

string

Nom de ressource de l'élément.
interactionOnThisAsset

boolean

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et AdGroupAsset. Indique si les métriques d'interaction ont eu lieu sur l'asset lui-même, ou sur un autre asset ou une autre unité d'annonce.