SearchAds360Row

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é d'annonce du groupe d'annonces référencé dans la requête.
adGroupAsset

object (AdGroupAsset)

Complément de groupe d'annonces référencé dans la requête.
adGroupAssetSet

object (AdGroupAssetSet)

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

object (AdGroupAudienceView)

Vue de l'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 de groupe d'annonces référencé dans la requête.
adGroupCriterionLabel

object (AdGroupCriterionLabel)

Libellé de 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é de groupe d'annonces référencé dans la requête.
ageRangeView

object (AgeRangeView)

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

object (Asset)

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 de groupe de composants référencé dans la requête.
assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

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

object (AssetGroupTopCombinationView)

Vue des meilleures combinaisons de composants du groupe de composants référencée dans la requête.
assetGroup

object (AssetGroup)

Groupe de composants 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ée 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 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 campagne référencé dans la requête.
campaignEffectiveLabel

object (CampaignEffectiveLabel)

Libellé "Efficace pour la campagne" référencé dans la requête.
campaignLabel

object (CampaignLabel)

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

object (CartDataSalesView)

Vue des ventes de données de 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'avoir 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 des termes de recherche des annonces dynamiques du Réseau de Recherche référencée dans la requête.
genderView

object (GenderView)

Vue du 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 de mot clé référencée dans la requête.
label

object (Label)

Libellé référencé dans la requête.
languageConstant

object (LanguageConstant)

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

object (LocationView)

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

object (ProductBiddingCategoryConstant)

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

object (ProductGroupView)

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

object (ShoppingPerformanceView)

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

object (UserList)

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

object (UserLocationView)

Vue de la position 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)

Métriques.
segments

object (Segments)

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,
  "trackingUrlTemplate": string,
  "cpcBidMicros": string,
  "engineStatus": enum (AdGroupEngineStatus),
  "finalUrlSuffix": string
}
Champs
resourceName

string

Nom de ressource du groupe d'annonces. Les noms de ressources de groupes 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 ressource des libellés actifs 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 concerne uniquement les comptes autres que Google Ads (par exemple, Yahoo Japan, Microsoft, Baidu, etc.). Pour l'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).
trackingUrlTemplate

string

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

string (int64 format)

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

enum (AdGroupEngineStatus)

État du moteur pour le groupe d'annonces.
finalUrlSuffix

string

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

AdGroupStatus

États possibles d'un groupe d'annonces.

Enums
UNSPECIFIED L'état n'a pas été spécifié.
UNKNOWN

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

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

AdGroupType

Énumération listant les types possibles de groupes d'annonces.

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

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

Il s'agit d'une valeur de réponse uniquement.
SEARCH_STANDARD Type de groupe d'annonces par défaut pour les campagnes sur le Réseau de Recherche.
DISPLAY_STANDARD Type de groupe d'annonces par défaut pour les campagnes display.
SHOPPING_PRODUCT_ADS Type de groupe d'annonces pour les campagnes Shopping diffusant des annonces standards pour un produit.
SHOPPING_SHOWCASE_ADS Type de groupe d'annonces limité à la diffusion d'annonces Showcase ou de marchand 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 Annonces vidéo InStream non désactivables.
VIDEO_OUTSTREAM Annonces vidéo OutStream.
SEARCH_DYNAMIC_ADS Type de groupe d'annonces pour les groupes d'annonces dynamiques du Réseau de Recherche.
SHOPPING_COMPARISON_LISTING_ADS Type des groupes d'annonces dans les campagnes Shopping de comparaison de prix.
PROMOTED_HOTEL_ADS Type de groupe d'annonces pour les groupes d'annonces de 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 de réponse uniquement.
OPTIMIZE Optimisez les annonces de vos groupes d'annonces en fonction des clics ou des conversions.
ROTATE_FOREVER Alterner de manière régulière sans interruption.

AdGroupEngineStatus

État du moteur du groupe d'annonces.

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

Obsolète. Ne pas utiliser.
AD_GROUP_EXPIRED Aucune annonce n'est diffusée pour ce groupe d'annonces, car sa date de fin est passée.
AD_GROUP_REMOVED Le groupe d'annonces a été supprimé.
AD_GROUP_DRAFT Aucune annonce n'est diffusée pour ce groupe d'annonces, car le groupe d'annonces associé est toujours à l'état de brouillon.
AD_GROUP_PAUSED Le groupe d'annonces a été mis en veille.
AD_GROUP_SERVING Le groupe d'annonces est actif et 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 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 s'appliquent ces paramètres.
bidOnly

boolean

Indique si vous souhaitez limiter la diffusion de vos annonces aux critères que vous avez sélectionnés pour cette dimension de ciblage ou cibler toutes les valeurs de cette dimension de ciblage et diffuser les annonces en fonction de votre ciblage dans d'autres dimensions de ciblage. Une valeur de true signifie que ces critères n'appliqueront que des modificateurs d'enchères et n'auront aucune incidence sur le ciblage. Une valeur de false signifie que ces critères limiteront le ciblage et appliqueront des modificateurs d'enchères.

TargetingDimension

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
KEYWORD Critères de mots clés, par exemple "croisière sur 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 "ALL" avec TargetRestriction.
AUDIENCE Critères d'audience, y compris les listes d'utilisateurs, les centres d'intérêt des utilisateurs, les audiences d'affinité personnalisée et les audiences personnalisées sur le marché.
TOPIC Critères thématiques pour cibler des catégories de contenu, par exemple "category::Animaux>Animaux de compagnie". 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, qui incluent des sites Web tels que "www.flowers4sale.com", ainsi que des applications mobiles, des catégories d'applications mobiles, des vidéos YouTube et des chaînes YouTube.
PARENTAL_STATUS Critères de ciblage par statut parental.
INCOME_RANGE Critères de ciblage par tranche de revenus.

AdGroupAd

Annonce de groupe d'annonces.

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 des 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 cette annonce de groupe d'annonces. 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 libellés effectifs associés à 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 concerne uniquement le compte Search Ads 360, par exemple Yahoo, Japan, Microsoft, Baidu, etc. Pour l'entité autre que Search Ads 360, utilisez plutôt "adGroupAd.ad.id".
engineStatus

enum (AdGroupAdEngineStatus)

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

string

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

AdGroupAdStatus

États possibles d'un AdGroupAd.

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.

FinalAppUrl

URL de lien profond vers une application pour le système d'exploitation donné.

Représentation JSON 
{
  "osType": enum (AppUrlOperatingSystemType),
  "url": string
}
Champs
osType

enum (AppUrlOperatingSystemType)

Système d'exploitation ciblé par cette URL. Obligatoire.
url

string

URL du lien profond vers l'application. Les liens profonds spécifient un emplacement dans une application qui correspond au contenu que vous souhaitez afficher. Ils doivent se présenter sous la forme {scheme}://{host_path}. Le schéma identifie l'application à ouvrir. Pour votre application, vous pouvez utiliser un schéma personnalisé qui commence par le nom de l'application. L'hôte et le chemin d'accès spécifient l'emplacement unique dans l'application où se trouve votre contenu. Exemple : "exampleapp://productid_1234". Obligatoire.

AppUrlOperatingSystemType

Système d'exploitation

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
IOS Système d'exploitation Apple iOS.
ANDROID Système d'exploitation Android.

AdType

Types d'annonces possibles.

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

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

Il s'agit d'une valeur de réponse uniquement.
TEXT_AD L'annonce est une annonce textuelle.
EXPANDED_TEXT_AD 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 L'annonce est 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 Il s'agit d'une annonce Gmail.
IMAGE_AD Il s'agit d'une annonce illustrée.
RESPONSIVE_SEARCH_AD L'annonce est 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 application.
LEGACY_APP_INSTALL_AD L'annonce est une ancienne annonce incitant à installer une application.
RESPONSIVE_DISPLAY_AD L'annonce est une annonce display responsive.
LOCAL_AD L'annonce est une annonce locale.
HTML5_UPLOAD_AD L'annonce est une annonce display importée avec le type de produit HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD L'annonce est une annonce display importée avec l'un des types de produit DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Il s'agit d'une annonce ciblant l'engagement avec une application.
SHOPPING_COMPARISON_LISTING_AD L'annonce est une annonce comparateur de prix Shopping.
VIDEO_BUMPER_AD Annonce vidéo bumper.
VIDEO_NON_SKIPPABLE_IN_STREAM_AD Annonce vidéo InStream non désactivable.
VIDEO_OUTSTREAM_AD Annonce vidéo OutStream.
VIDEO_TRUEVIEW_DISCOVERY_AD Annonce vidéo TrueView InDisplay.
VIDEO_TRUEVIEW_IN_STREAM_AD Annonce vidéo TrueView InStream.
VIDEO_RESPONSIVE_AD Annonce vidéo responsive.
SMART_CAMPAIGN_AD Annonce de campagne intelligente
APP_PRE_REGISTRATION_AD Annonce de préinscription à une application universelle.
DISCOVERY_MULTI_ASSET_AD Annonce multimulti-composants Discovery.
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 à afficher de l'annonce.
displayMobileUrl

string

URL mobile à afficher de l'annonce.
adTrackingId

string (int64 format)

ID de suivi de l'annonce.

SearchAds360ExpandedTextAdInfo

Annonce textuelle grand format Search Ads 360.

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

string

Titre de l'annonce.
headline2

string

Deuxième titre de l'annonce.
headline3

string

Troisième titre de l'annonce.
description1

string

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

string

Deuxième ligne de description de l'annonce.
path1

string

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

string

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

string (int64 format)

ID de suivi de l'annonce.

SearchAds360ResponsiveSearchAdInfo

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

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

object (AdTextAsset)

Liste des composants Texte pour les titres. Lorsque l'annonce est diffusée, 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 délimiteur.
path2

string

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

string (int64 format)

ID de suivi de l'annonce.

AdTextAsset

Composant texte utilisé dans une annonce.

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

string

Texte du composant.

SearchAds360ProductAdInfo

Ce type ne comporte aucun champ.

Annonce produit Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Annonce dynamique agrandie sur le Réseau de Recherche.

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

string

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

string

Deuxième ligne de description de l'annonce.
adTrackingId

string (int64 format)

ID de suivi de l'annonce.

AdGroupAdEngineStatus

Énumère les états du moteur AdGroupAd.

Enums
UNSPECIFIED Aucune valeur n'a été spécifiée.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
AD_GROUP_AD_ELIGIBLE

Obsolète. Ne pas utiliser.
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN Baidu : la création n'a pas été approuvée.
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW Baidu : URL mobile en cours d'examen.
AD_GROUP_AD_PARTIALLY_INVALID Baidu : la création n'est pas valide sur un appareil mobile, mais elle l'est sur un ordinateur.
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'a été.
AD_GROUP_AD_AD_GROUP_PAUSED La création a été mise en veille, car le groupe d'annonces est en veille.

AdGroupAdEffectiveLabel

Relation entre une annonce d'un 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 ressource de l'étiquette effective de l'annonce du groupe d'annonces. Les noms de ressource des étiquettes effectives d'annonces de groupe d'annonces se présentent sous la forme suivante : customers/{ownerCustomerId}/adGroupAdEffectiveLabels/{ad_group_id}~{adId}~{label_id}.
adGroupAd

string

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

string

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

string (int64 format)

ID 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 ressource du libellé d'annonce de groupe d'annonces. Les noms de ressources des libellés d'annonces de groupe d'annonces se présentent sous la forme suivante : customers/{ownerCustomerId}/adGroupAdLabels/{ad_group_id}~{adId}~{label_id}.
adGroupAd

string

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

string

Libellé attribué à l'annonce du groupe d'annonces.
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 du composant 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 vers un composant.

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

AdGroupAssetSet

AdGroupAssetSet est le lien entre un groupe d'annonces et un ensemble de composants. La création d'un AdGroupAssetSet associe un ensemble de composants à un groupe d'annonces.

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

string

Nom de ressource de l'ensemble d'assets du groupe d'annonces. Les noms de ressources des ensembles d'assets de groupe d'annonces se présentent sous la forme suivante :

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

string

Groupe d'annonces auquel cet ensemble d'éléments est associé.
assetSet

string

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

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

États possibles de l'association entre un ensemble d'assets et son conteneur.

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

AdGroupAudienceView

Vue de l'audience d'un groupe d'annonces. Inclut les données de performances des listes de centres d'intérêt et 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 au niveau de l'audience.

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

string

Nom de ressource de la vue "Audience du groupe d'annonces". Les noms de ressources des vues d'audience de groupe d'annonces se présentent sous la forme suivante :

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

AdGroupBidModifier

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

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

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

string

Nom de ressource du modificateur d'enchère de groupe d'annonces. Les noms de ressources des modificateurs d'enchères de groupe d'annonces se présentent sous la forme suivante :

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 dotées d'un navigateur complet
DESKTOP Ordinateurs.
CONNECTED_TV Smart TV et consoles de jeu
OTHER Autres types d'appareils.

AdGroupCriterion

Critère de groupe d'annonces. Le rapport adGroupCriterion ne renvoie que les critères qui ont été ajoutés explicitement 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
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "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 de groupe d'annonces. Les noms de ressources des critères de groupe d'annonces se présentent sous la forme suivante :

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 ressource 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 basées sur des critères à différents emplacements.
finalUrls[]

string

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

string

Liste des URL mobiles finales possibles après toutes les redirections interdomaines.
urlCustomParameters[]

object (CustomParameter)

Liste des mappages utilisés pour remplacer les balises de paramètres personnalisés dans un trackingUrlTemplate, finalUrls ou mobile_final_urls.
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 passer d'un critère positif à 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.

Un seul doit être défini. 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 de réponse uniquement.
ENABLED Le critère de groupe d'annonces est activé.
PAUSED Le critère de groupe d'annonces est mis en veille.
REMOVED Le critère de groupe d'annonces est supprimé.

QualityInfo

Conteneur d'informations sur la qualité des critères 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
KEYWORD Mot clé, par exemple "croisière sur Mars".
PLACEMENT Emplacement (également appelé "site Web"), par exemple "www.fleursavendre.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 des utilisateurs.
PROXIMITY Proximité.
TOPIC Cible de 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 Intention personnalisée.
LOCATION_GROUP Groupe de zones géographiques.
CUSTOM_AUDIENCE Audience personnalisée
COMBINED_AUDIENCE Audience combinée
KEYWORD_THEME Thème de mot clé de campagne intelligente
AUDIENCE Audience
LOCAL_SERVICE_ID ID du service Annonces Local Services.
BRAND Marque
BRAND_LIST Liste de marques
LIFE_EVENT Événement de la vie

PositionEstimates

Estimations pour les enchères basées sur des critères à différents emplacements.

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une 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 à cause 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 pour un appareil n'est pas valide, tandis que celle pour l'autre appareil l'est.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu : le mot clé a été créé et mis en veille par le responsable du compte Baidu. Vous pouvez maintenant l'activer.
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'a été.

CustomParameter

Mappage pouvant être utilisé par les balises de paramètres personnalisés 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.

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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
EXACT Correspondance exacte
PHRASE Expression exacte
BROAD Requête large

ListingGroupInfo

Critère de groupe de fiches.

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

enum (ListingGroupType)

Type du groupe de fiches.

ListingGroupType

Type du groupe de fiches.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
SUBDIVISION Subdivision des produits selon 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 de fiches définissant 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 tranche d'âge démographique (par exemple, entre 18 et 24 ans).

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

GenderInfo

Critère de genre.

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

enum (GenderType)

Type de genre.

GenderType

Type de genre démographique (par exemple, "féminin").

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

UserListInfo

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

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

string

Nom de laressource de la liste d'utilisateurs.

WebpageInfo

Représente un critère permettant de cibler les 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 page Web.
argument

string

Argument de la condition de ciblage de page Web.

WebpageConditionOperand

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

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

WebpageConditionOperator

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

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

LocationInfo

Critère de localisation.

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 ressource de l'étiquette effective du critère de groupe d'annonces. Les noms de ressources des libellés effectifs de critères de groupe d'annonces se présentent sous la forme customers/{ownerCustomerId}/adGroupCriterionEffectiveLabels/{ad_group_id}~{criterionId}~{label_id}.
adGroupCriterion

string

Critère de groupe d'annonces auquel est associée l'étiquette effective.
label

string

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

string (int64 format)

ID 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 ressource de l'étiquette de critère de groupe d'annonces. Les noms de ressources des étiquettes de critères de groupe d'annonces se présentent sous la forme suivante : customers/{ownerCustomerId}/adGroupCriterionLabels/{ad_group_id}~{criterionId}~{label_id}.
adGroupCriterion

string

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

string

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

string (int64 format)

ID 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 ressource des étiquettes effectives de groupe d'annonces se présentent sous la forme suivante : customers/{ownerCustomerId}/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 ressource du libellé de groupe d'annonces. Les noms de ressources des libellés de groupe d'annonces se présentent sous la forme suivante : customers/{ownerCustomerId}/adGroupLabels/{ad_group_id}~{label_id}.
adGroup

string

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

string

Libellé attribué au groupe d'annonces.
ownerCustomerId

string (int64 format)

ID du client propriétaire du libellé.

AgeRangeView

Vue d'une tranche d'âge.

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

string

Nom de ressource de la vue de tranche d'âge. Les noms de ressources de la vue "Tranche d'âge" se présentent sous la forme suivante :

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

Composant

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 qu'un composant ne soit plus diffusé, supprimez-le de l'entité qui l'utilise.

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

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

string

Nom de ressource du composant. Les noms de ressources d'éléments se présentent sous la forme suivante :

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

enum (AssetType)

Type de l'élément.
finalUrls[]

string

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

string

Liste des URL finales pour mobile possibles après toutes les redirections interdomaines.
urlCustomParameters[]

object (CustomParameter)

Liste des mappages à utiliser pour remplacer les balises de paramètres personnalisés d'URL dans trackingUrlTemplate, finalUrls et/ou finalMobileUrls.
status

enum (AssetStatus)

État de l'élément.
creationTime

string

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

string

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

string (int64 format)

ID de l'élément.
name

string

Nom facultatif de l'élément.
trackingUrlTemplate

string

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

string

Modèle d'URL permettant d'ajouter des paramètres aux URL de pages de destination diffusées avec le suivi en parallèle.
engineStatus

enum (AssetEngineStatus)

État du moteur pour un composant.
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 composant vidéo YouTube.
imageAsset

object (ImageAsset)

Composant Image
textAsset

object (TextAsset)

Un composant Texte.
calloutAsset

object (UnifiedCalloutAsset)

Composant Accroche unifié.
pageFeedAsset

object (UnifiedPageFeedAsset)

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

object (MobileAppAsset)

Composant Application mobile.
callAsset

object (UnifiedCallAsset)

Un composant Appel unifié.
callToActionAsset

object (CallToActionAsset)

Composant Incitation à l'action.
locationAsset

object (UnifiedLocationAsset)

Composant Lieu unifié.

AssetType

Énumération décrivant les types de composants possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. 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 Élément "Réserver sur Google".
PROMOTION Composant Promotion.
CALLOUT Composant Accroche.
STRUCTURED_SNIPPET Composant Extrait structuré.
PAGE_FEED Élément Flux de pages.
DYNAMIC_EDUCATION Composant 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 Asset immobilier dynamique.
DYNAMIC_CUSTOM Composant personnalisé dynamique.
DYNAMIC_HOTELS_AND_RENTALS Asset dynamique pour les hôtels et les locations.
DYNAMIC_FLIGHTS Asset dynamique sur les vols.
DYNAMIC_TRAVEL Asset dynamique sur les voyages.
DYNAMIC_LOCAL Asset local dynamique.
DYNAMIC_JOBS Asset dynamique sur les emplois.
LOCATION Composant Lieu.
HOTEL_PROPERTY Asset établissement hôtelier.

AssetStatus

États possibles d'un composant.

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

AssetEngineStatus

Énumération décrivant les états possibles du moteur d'éléments.

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

YoutubeVideoAsset

Un élément YouTube.

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

string

Titre de la vidéo YouTube.
youtubeVideoId

string

ID vidéo YouTube. Il s'agit de la valeur de 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 de l'image en octets.

MimeType

Type MIME

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

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

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

ImageDimension

Métadonnées d'une image à 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 de validité de ce composant, à partir de laquelle il peut commencer à être diffusé, au format aaaa-MM-jj.
endDate

string

Dernière date à laquelle ce composant est efficace et toujours diffusé, au format aaaa-MM-jj.
adScheduleTargets[]

object (AdScheduleInfo)

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

boolean

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

AdScheduleInfo

Représente un critère AdSchedule.

AdSchedule est spécifié comme le jour de la semaine et un intervalle de temps pendant lequel les annonces seront diffusées.

Vous ne pouvez pas ajouter plus de six programmations d'annonces pour le même jour.

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

enum (MinuteOfHour)

Nombre de minutes après l'heure de début à laquelle cette planification 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 de cette programmation. L'heure de fin n'est pas incluse dans la programmation.

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 s'applique la programmation.

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. Cette valeur doit être 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. Cette valeur doit être 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ère les quarts d'heure. Par exemple, "FIFTEEN" (QUINZE)

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

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 le 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 validité de ce composant, à partir de laquelle il peut commencer à être diffusé, au format aaaa-MM-jj.
endDate

string

Dernière date à laquelle ce composant est efficace et toujours diffusé, au format aaaa-MM-jj.
adScheduleTargets[]

object (AdScheduleInfo)

Liste des programmations sans chevauchement spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Vous pouvez créer jusqu'à six plannings 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 réservé au Japon.
useSearcherTimeZone

boolean

Indique si le composant Lien annexe doit être affiché dans le fuseau horaire de l'utilisateur effectuant la recherche. S'applique à Microsoft Ads.
mobilePreferred

boolean

Indique si le composant Lien annexe doit être affiché sur les appareils mobiles. S'applique à Microsoft Ads.

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 de 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 qui distribue cette application spécifique.

MobileAppVendor

Type de fournisseur d'applications mobiles

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

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 Appel doit utiliser son propre paramètre de conversion par appel, suivre le paramètre au niveau du compte ou désactiver la conversion par appel.
callConversionAction

string

Action de conversion à laquelle attribuer une conversion d'appel. Si aucune valeur n'est définie, 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 programmations sans chevauchement spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Vous pouvez créer jusqu'à six plannings 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 Ads.
callTrackingEnabled

boolean

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

boolean

Indique si l'extension d'appel doit être affichée dans le fuseau horaire de l'utilisateur effectuant la recherche. S'applique à Microsoft Ads.
startDate

string

Date de début de validité de ce composant, à partir de laquelle il peut commencer à être diffusé, au format aaaa-MM-jj.
endDate

string

Dernière date à laquelle ce composant est efficace et toujours diffusé, au format aaaa-MM-jj.

CallConversionReportingState

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

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

CallToActionAsset

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'incitation à l'action possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. 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 "Postuler maintenant".
SIGN_UP Le type d'incitation à l'action est "S'inscrire".
CONTACT_US Le type d'incitation à l'action est "Nous contacter".
SUBSCRIBE Le type d'incitation à l'action est "S'abonner".
DOWNLOAD Le type d'incitation à l'action est "Télécharger".
BOOK_NOW Le type d'incitation à l'action est "Réserver maintenant".
SHOP_NOW Le type d'incitation à l'action est "Acheter".
BUY_NOW Le type d'incitation à l'action est "Acheter maintenant".
DONATE_NOW Le type d'incitation à l'action est "Faire un don".
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 "En savoir plus".
START_NOW Le type d'incitation à l'action est "Commencer".
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 pour le client. Cette valeur ne sera renvoyée que si le composant Lieu est synchronisé à partir du compte de fiche d'établissement. Il est possible d'avoir plusieurs fiches d'établissement dans le même compte qui pointent vers le même ID 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 "AFFILIATE", 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. Ces informations sont synchronisées à partir du compte de la fiche d'établissement.
storeCode

string

Code de magasin de la fiche d'établissement de cet établissement. Ces informations sont synchronisées à partir du compte de la fiche d'établissement.
listingId

string (int64 format)

Identifiant de la fiche d'établissement pour ce lieu. Ces informations sont synchronisées à partir du compte de fiche d'établissement associé.

LocationOwnershipType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. 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 tierce : ALE)

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 du composant du groupe de composants. Le nom de ressource de composant de groupe de composants se présente sous la forme suivante :

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

string

Groupe de composants auquel cet élément de groupe de composants est associé.
asset

string

Élément auquel le 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 du lien entre un composant et un groupe de composants.

AssetFieldType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
HEADLINE L'élément est associé pour être utilisé comme titre.
DESCRIPTION Le composant est associé pour être utilisé comme description.
MANDATORY_AD_TEXT L'asset 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é comme kit média.
YOUTUBE_VIDEO L'élément est associé pour être utilisé comme vidéo YouTube.
BOOK_ON_GOOGLE L'élément est associé pour indiquer qu'une campagne d'hôtel est activée pour "Réserver sur Google".
LEAD_FORM Le composant est associé pour être utilisé comme extension Formulaire pour prospects.
PROMOTION L'élément est associé pour être utilisé comme extension Promotion.
CALLOUT L'élément est associé pour être utilisé comme extension d'accroche.
STRUCTURED_SNIPPET Le composant est associé pour être utilisé comme extension d'extrait structuré.
MOBILE_APP Le composant est associé pour être utilisé comme extension Application mobile.
HOTEL_CALLOUT Le composant est associé pour être utilisé comme extension d'accroche pour hôtel.
CALL Le composant est associé pour être utilisé comme extension d'appel.
PRICE Le composant est associé pour être utilisé comme extension de prix.
LONG_HEADLINE L'élément est associé pour être utilisé comme titre long.
BUSINESS_NAME Le composant est associé pour être utilisé comme nom d'entreprise.
SQUARE_MARKETING_IMAGE L'élément est associé pour être utilisé comme image marketing carrée.
PORTRAIT_MARKETING_IMAGE Le composant est associé pour être utilisé comme image marketing en mode portrait.
VIDEO L'élément est associé pour être utilisé comme logo non YouTube.
CALL_TO_ACTION_SELECTION L'élément est associé pour être utilisé afin de sélectionner une incitation à l'action.
AD_IMAGE Le composant est associé pour être utilisé comme 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.
LONG_DESCRIPTION Le composant est associé pour être utilisé comme description longue.
CALL_TO_ACTION L'élément est associé pour être utilisé comme incitation à l'action.

AssetGroupSignal

AssetGroupSignal représente un signal dans un groupe de composants. L'existence d'un signal indique à la campagne Performance Max quels utilisateurs sont les plus susceptibles d'effectuer une conversion. Les campagnes Performance Max utilisent le 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 de groupe de composants. Le nom de ressource du signal de groupe de composants se présente sous la forme suivante :

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

string

Groupe de composants auquel appartient ce signal de groupe de composants.
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

Critère d'audience.

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

string

Nom de ressource de l'audience.

AssetGroupListingGroupFilter

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

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

string

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

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

string

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

string (int64 format)

ID de ListingGroupFilter.
type

enum (ListingGroupFilterType)

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

enum (ListingGroupFilterVertical)

Verticale représentée par l'arborescence de nœuds actuelle. Tous les nœuds d'un même arbre doivent appartenir au même secteur.
caseValue

object (ListingGroupFilterDimension)

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

string

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

object (ListingGroupFilterDimensionPath)

Chemin d'accès aux dimensions définissant ce filtre de groupe de fiches.

ListingGroupFilterType

Type de filtre du groupe de fiches.

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

ListingGroupFilterVertical

Type de verticale du filtre de groupe de fiches.

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

ListingGroupFilterDimension

Dimensions de fiche pour le filtre de groupe de fiches (groupe de composants).

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. Une dimension de l'un des types ci-dessous est toujours présente. dimension ne peut être qu'un des éléments suivants :
productBiddingCategory

object (ProductBiddingCategory)

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

object (ProductBrand)

Marque d'une offre de produit.
productChannel

object (ProductChannel)

Localité d'une offre de produit.
productCondition

object (ProductCondition)

État d'une offre de produit.
productCustomAttribute

object (ProductCustomAttribute)

Attribut personnalisé d'une offre de produit.
productItemId

object (ProductItemId)

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

object (ProductType)

Type d'offre de produit.

ProductBiddingCategory

Élément d'une catégorie d'enchères à un certain niveau. Les catégories de premier niveau sont au niveau 1, leurs enfants au niveau 2, et ainsi de suite. Nous acceptons actuellement jusqu'à cinq niveaux. L'utilisateur doit spécifier un type de dimension qui indique le niveau de la catégorie. Toutes les subdivisions identiques 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
LEVEL1 Niveau 1.
LEVEL2 Niveau 2.
LEVEL3 Niveau 3.
LEVEL4 Niveau 4.
LEVEL5 Niveau 5.

ProductBrand

Marque du produit.

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

string

Valeur de chaîne de la marque du produit.

ProductChannel

Localité d'une offre de produit.

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

enum (ListingGroupFilterProductChannel)

Valeur de la localité.

ListingGroupFilterProductChannel

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une 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é uniquement pour la valeur renvoyée. Représente une 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 chaîne de l'attribut personnalisé du produit.

ListingGroupFilterCustomAttributeIndex

Index des attributs client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
INDEX0 Premier attribut personnalisé du 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 d'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'une offre de produit.

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

ListingGroupFilterDimensionPath

Chemin de définition des dimensions définissant un filtre de groupe d'annonces.

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

object (ListingGroupFilterDimension)

Chemin d'accès complet aux dimensions dans la hiérarchie des filtres de groupe de fiches (à l'exclusion du nœud racine) vers ce filtre de groupe de fiches.

AssetGroupTopCombinationView

Vue sur l'utilisation des meilleures combinaisons de composants de groupes de composants.

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

string

Nom de ressource de la vue "Combinaison principale" du groupe de composants. Les noms de ressources des vues "Combinaison principale du groupe d'assets" se présentent sous la forme suivante : "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".
assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Combinaisons de composants les plus performantes diffusées ensemble.

AssetGroupAssetCombinationData

Données sur les combinaisons de composants de groupes de composants

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

object (AssetUsage)

Composants diffusés.

AssetUsage

Contient les informations d'utilisation du composant.

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

string

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

enum (ServedAssetFieldType)

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

ServedAssetFieldType

Types de champs de composants possibles.

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

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

Il s'agit d'une valeur de réponse uniquement.
HEADLINE_1 Le composant est utilisé dans le titre 1.
HEADLINE_2 Le composant est utilisé dans le titre 2.
HEADLINE_3 Le composant est utilisé dans le titre 3.
DESCRIPTION_1 L'élément est utilisé dans la description 1.
DESCRIPTION_2 L'élément est utilisé dans la description 2.
HEADLINE L'élément a été utilisé dans un titre. Utilisez cette option uniquement 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 au format portrait.
LONG_HEADLINE L'élément 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 au format portrait.
BUSINESS_NAME_IN_PORTRAIT L'élément a été utilisé comme nom de l'entreprise dans une image au format portrait.
BUSINESS_NAME L'élément a été utilisé comme nom de l'entreprise.
MARKETING_IMAGE L'élément a été utilisé comme image marketing.
MARKETING_IMAGE_IN_PORTRAIT Le composant a été utilisé comme image marketing en mode portrait.
SQUARE_MARKETING_IMAGE Le composant 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'élément a été utilisé comme vidéo YouTube.
CALL Ce composant est utilisé comme appel.
MOBILE_APP Ce composant est utilisé comme application mobile.
CALLOUT Ce composant est utilisé comme accroche.
STRUCTURED_SNIPPET Ce composant est utilisé comme extrait structuré.
PRICE Ce composant est utilisé comme prix.
PROMOTION Ce composant est utilisé comme promotion.
AD_IMAGE Ce composant est utilisé comme image.
LEAD_FORM Le composant est utilisé comme formulaire pour prospects.
DESCRIPTION_PREFIX L'asset est utilisé comme préfixe de description.

AssetGroup

un groupe de composants. 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 ressource du groupe de composants. Les noms de ressources des groupes 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'assets.
name

string

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

string

Liste des URL finales après toutes les redirections interdomaines. Dans Performance Max, les URL sont éligibles à l'expansion par défaut, sauf si vous la désactivez.
finalMobileUrls[]

string

Liste des URL finales pour mobile après toutes les redirections interdomaines. Dans Performance Max, les URL sont éligibles à l'expansion par défaut, sauf si vous la désactivez.
status

enum (AssetGroupStatus)

État du groupe de composants.
path1

string

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

string

Deuxième partie du texte qui peut ê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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
PENDING L'efficacité de l'annonce est actuellement en attente.
NO_ADS Aucune annonce n'a pu être générée.
POOR L'efficacité est faible.
AVERAGE Efficacité moyenne.
GOOD Bonne force.
EXCELLENT Excellente résistance.

AssetSetAsset

AssetSetAsset est le lien entre un élément et un ensemble d'éléments. L'ajout d'un AssetSetAsset associe un élément à un ensemble d'éléments.

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

string

Nom de ressource de l'élément de l'ensemble d'assets. Les noms de ressources des éléments d'un groupe d'assets se présentent sous 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'asset de l'ensemble d'assets. Lecture seule.

AssetSetAssetStatus

États possibles d'un asset 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'asset de l'ensemble d'assets 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 asset à 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 ressource de l'ensemble d'assets. Les noms de ressources des ensembles d'assets se présentent sous 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 se présentent sous 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 ISO 4217 à trois lettres).

Pour les stratégies d'enchères dans les comptes administrateur, cette devise peut être définie lors de la création et est définie par défaut sur la devise du compte administrateur. Pour les clients diffusant des annonces, ce champ ne peut pas être défini. Toutes les stratégies d'un client diffusant des annonces utilisent implicitement la devise de ce client. Dans tous les cas, le champ "effectiveCurrencyCode" renvoie la devise utilisée par la stratégie.
id

string (int64 format)

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

string

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

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

string

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

Pour les stratégies d'enchères dans les comptes client, il s'agit de la devise définie par l'annonceur lors de la création de la stratégie. Pour la diffusion auprès des clients, il s'agit du code de devise 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)

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'en générer.
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)

Stratégie d'enchères automatiques qui vous permet de maximiser les conversions pour vos campagnes sans dépasser 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)

Stratégie d'enchères qui définit les enchères en fonction de la fraction cible des enchères dans lesquelles l'annonceur doit se classer devant 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 vers des stratégies qui ont déjà ce schéma renseigné sont autorisées.
targetRoas

object (TargetRoas)

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

object (TargetSpend)

Stratégie d'enchères qui définit vos enchères pour vous permettre d'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 de réponse uniquement.
ENABLED La stratégie d'enchères est activée.
REMOVED La stratégie d'enchères est supprimée.

BiddingStrategyType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
COMMISSION La stratégie d'enchères automatiques "Commission" permet à l'annonceur de payer une certaine partie de la valeur de conversion.
ENHANCED_CPC Le CPC optimisé est une stratégie d'enchères qui augmente les enchères pour les clics qui semblent les plus susceptibles de générer une conversion et les diminue pour les clics qui semblent les moins susceptibles de générer une conversion.
INVALID Utilisé uniquement pour la valeur renvoyée. Indique qu'une campagne n'a pas de stratégie d'enchères. Cela empêche la diffusion de la campagne. Par exemple, une campagne peut être associée à une stratégie d'enchères de compte 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 du compte administrateur désormais inaccessible et passera au type de stratégie d'enchères "NON VALIDE".
MANUAL_CPA Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère pour chaque action spécifiée.
MANUAL_CPC Stratégie d'enchères manuelles au coût par clic, où l'utilisateur paie à chaque clic.
MANUAL_CPM Enchères basées sur les impressions manuelles, où l'utilisateur paie pour mille impressions.
MANUAL_CPV Stratégie d'enchères qui paie 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 automatiques qui définit automatiquement les enchères pour maximiser les revenus tout en dépensant votre budget.
PAGE_ONE_PROMOTED Schéma d'enchères "Annonces sponsorisées en première page", qui définit des enchères au CPC max. pour cibler les impressions en première page ou les emplacements sponsorisés en 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 représentent 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 avez défini.
TARGET_CPM Le CPM cible est une stratégie d'enchères automatiques qui définit des enchères pour générer autant d'impressions que possible en fonction du coût pour mille impressions (CPM) cible que vous avez défini.
TARGET_IMPRESSION_SHARE Stratégie d'enchères automatiques qui définit les enchères de sorte qu'un certain pourcentage d'annonces sur le Réseau de Recherche soit diffusé en haut de la première page (ou à un autre emplacement ciblé).
TARGET_OUTRANK_SHARE Le taux de surclassement cible est une stratégie d'enchères automatiques qui définit les enchères en fonction de la fraction cible d'enchères dans 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 automatiques "ROAS cible" vous aide à maximiser vos revenus tout en atteignant un retour sur les dépenses publicitaires (ROAS) cible spécifique.
TARGET_SPEND La stratégie d'enchères "Cible de dépenses" définit automatiquement vos enchères pour que vous enregistriez autant de clics que possible dans les limites de votre budget.

EnhancedCpc

Ce type ne comporte aucun champ.

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

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 obtenir 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. Modifiable uniquement pour les stratégies de portefeuille d'enchères.
cpcBidFloorMicros

string (int64 format)

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

number

L'option "ROAS cible". Si elle est définie, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, le ROAS cible. Si le ROAS cible est élevé, il est possible que la stratégie d'enchères ne puisse pas dépenser l'intégralité du budget. Si le ROAS cible n'est pas défini, la stratégie d'enchères s'efforcera d'atteindre le ROAS le plus élevé possible pour le budget.

MaximizeConversions

Stratégie d'enchères automatiques qui vous permet de maximiser les conversions pour vos campagnes sans dépasser 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. Modifiable uniquement pour les stratégies de portefeuille d'enchères.
cpcBidFloorMicros

string (int64 format)

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

string (int64 format)

L'option "CPA cible". Il s'agit du montant moyen que vous souhaitez dépenser par action de conversion, exprimé en micro-unités de la devise de la stratégie d'enchères. Si elle est définie, la stratégie d'enchères générera autant de conversions que possible pour un coût par action cible égal ou inférieur à celui que vous avez spécifié. 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 en fonction 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 de sorte 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 des résultats de recherche.
locationFractionMicros

string (int64 format)

Fraction d'annonces à diffuser dans la zone ciblée, en micro-unités. Par exemple, 1 % équivaut à 10 000.
cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

Énumération décrivant les objectifs possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
ANYWHERE_ON_PAGE N'importe quel emplacement sur la page Web.
TOP_OF_PAGE Zone d'annonces 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 dans lesquelles l'annonceur doit se classer devant 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

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

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

number

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

string (int64 format)

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

string (int64 format)

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

TargetSpend

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

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

string (int64 format)

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 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 ressource du budget de la campagne. Les noms de ressources des budgets 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
STANDARD Le serveur de budget limitera la diffusion de manière uniforme sur toute la période.
ACCELERATED Le serveur de budget ne limitera pas la diffusion, et les annonces seront diffusées aussi rapidement que possible.

BudgetPeriod

Période possible d'un budget.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
DAILY Budget quotidien.
FIXED_DAILY Budget quotidien fixe.
CUSTOM_PERIOD Un budget personnalisé peut être utilisé avec total_amount pour spécifier une limite de budget pour 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,
  "feedTypes": [
    enum (AssetSetType)
  ],
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

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

string

Nom de ressource de la campagne. Les noms de ressources de campagne se présentent sous la forme suivante :

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

enum (CampaignStatus)

État de la campagne.

Lorsqu'une campagne est ajoutée, son état est défini par défaut sur "Activée".
servingStatus

enum (CampaignServingStatus)

État de diffusion de la campagne.
biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

État du système de la stratégie d'enchères de la campagne.
adServingOptimizationStatus

enum (AdServingOptimizationStatus)

État d'optimisation de la diffusion d'annonces pour 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és 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 de réseau 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 de ciblage géographique des annonces.
effectiveLabels[]

string

Noms de ressource des libellés effectifs associés à cette campagne. Un libellé effectif 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 ressource AccessibleBiddingStrategy. Il s'agit d'une vue en lecture seule des attributs non restreints 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 restreints ne sont disponibles que pour le client propriétaire de la stratégie et ses responsables. Les attributs restreints ne peuvent être lus qu'à partir de la ressource BiddingStrategy.
frequencyCaps[]

object (FrequencyCapEntry)

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

object (SelectiveOptimization)

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

object (OptimizationGoalSetting)

Paramètres d'objectif d'optimisation pour cette campagne, qui incluent un ensemble de types d'objectifs d'optimisation.
trackingSetting

object (TrackingSetting)

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

string

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

enum (AssetFieldType)

Types de champs de composants à exclure de cette campagne. Les liens d'assets avec ces types de champs ne seront pas hérités par cette campagne depuis le 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 obsolète 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".
feedTypes[]

enum (AssetSetType)

Types de flux associés directement à cette campagne.
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 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 parallèle.
urlExpansionOptOut

boolean

Indique si l'extension d'URL vers des URL plus ciblées est désactivée. Si elle l'est (valeur "true"), seules les URL finales du groupe de composants ou les URL spécifiées dans les flux de données d'entreprise ou Google Merchant Center de l'annonceur sont ciblées. Si la valeur est "false" (activé), l'ensemble du domaine sera ciblé. 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 à l'aide du service BiddingStrategy) ou une stratégie standard intégrée à la campagne. campaign_bidding_strategy ne peut être qu'un des éléments suivants :
biddingStrategy

string

Nom de ressource de la stratégie de portefeuille d'enchères 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 pour chaque action spécifiée. 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 standards "Maximiser les conversions" qui maximise automatiquement le nombre de conversions tout en exploitant la totalité de votre budget.
maximizeConversionValue

object (MaximizeConversionValue)

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

object (TargetCpa)

Stratégie d'enchères standards au CPA cible qui définit automatiquement les enchères pour générer autant de conversions que possible en fonction du coût par acquisition (CPA) cible que vous avez défini.
targetImpressionShare

object (TargetImpressionShare)

Stratégie d'enchères "Taux d'impressions cible". Stratégie d'enchères automatiques qui définit les enchères pour atteindre un pourcentage d'impressions choisi.
targetRoas

object (TargetRoas)

Stratégie d'enchères standards au ROAS cible qui maximise automatiquement les revenus tout en atteignant la moyenne d'un retour sur les dépenses publicitaires (ROAS) cible spécifique.
targetSpend

object (TargetSpend)

Stratégie d'enchères standards "Cible de dépenses" 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 standard au pourcentage de CPC, où les enchères représentent une fraction du prix annoncé pour un bien ou un service.
targetCpm

object (TargetCpm)

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

CampaignStatus

États possibles d'une campagne.

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

CampaignServingStatus

États de diffusion possibles d'une campagne.

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

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

Il s'agit d'une valeur de réponse uniquement.
SERVING Diffusion
NONE Aucune.
ENDED Terminée.
PENDING En attente.
SUSPENDED Suspendu

BiddingStrategySystemStatus

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

Enums
UNSPECIFIED Signale qu'une erreur inattendue s'est produite (par exemple, aucun type de stratégie d'enchères ou aucune information sur l'état n'ont été trouvés).
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
ENABLED La stratégie d'enchères est active et le système AdWords ne détecte aucun problème particulier à son sujet.
LEARNING_NEW La stratégie d'enchères est en 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'une modification récente des paramètres.
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 y sont associés.
LEARNING_CONVERSION_TYPE_CHANGE La stratégie d'enchères dépend des rapports sur les conversions. Le client a récemment modifié les types de conversions qui étaient 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 était insuffisant au cours des dernières semaines.
LIMITED_BY_BUDGET Une part importante des mots clés de cette stratégie d'enchères sont limités par le budget.
LIMITED_BY_LOW_PRIORITY_SPEND La stratégie d'enchères ne peut pas atteindre ses dépenses cibles, car ses dépenses ont été dépriorisées.
LIMITED_BY_LOW_QUALITY Une part 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 entièrement son budget en raison d'un ciblage trop précis.
MISCONFIGURED_ZERO_ELIGIBILITY Suivi des conversions (aucun ping) et/ou listes de remarketing pour les CSI manquants.
MISCONFIGURED_CONVERSION_TYPES La stratégie d'enchères dépend des rapports sur les conversions. Or, le client ne dispose pas des types de conversions qui pourraient être associés à cette stratégie.
MISCONFIGURED_CONVERSION_SETTINGS La stratégie d'enchères dépend du reporting des conversions, et les paramètres de conversion du client sont mal configurés.
MISCONFIGURED_SHARED_BUDGET Certaines campagnes qui ne sont pas incluses dans la stratégie d'enchères partagent des budgets avec des campagnes qui le sont.
MISCONFIGURED_STRATEGY_TYPE La campagne utilise un type de stratégie non valide et n'est pas diffusée.
PAUSED La stratégie d'enchères n'est pas active. Soit aucune campagne, aucun groupe d'annonces ni aucun mot clé actifs ne sont associés à la stratégie d'enchères. Ou bien aucune stratégie d'enchères n'est associée à des budgets actifs.
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é enregistrés pour cette stratégie d'enchères au cours de la période concernée.
MULTIPLE_LIMITED Plusieurs états système LIMITED_* ont été associés à cette stratégie d'enchères pendant la période concernée.
MULTIPLE_MISCONFIGURED Plusieurs états système MISCONFIGURED_* ont été enregistrés pour cette stratégie d'enchères au cours de la période concernée.
MULTIPLE Plusieurs états du système ont été enregistrés pour cette stratégie d'enchères au cours de la période concernée.

AdServingOptimizationStatus

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

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

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

Il s'agit d'une valeur de réponse uniquement.
OPTIMIZE La diffusion des annonces est optimisée en fonction du CTR de la campagne.
CONVERSION_OPTIMIZE La diffusion des annonces est optimisée en fonction du CTR multiplié par le taux de conversion de la campagne. Si la campagne n'utilise pas la stratégie d'enchères de l'optimiseur de conversion, elle sera 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 performantes, sans optimisation
UNAVAILABLE L'état d'optimisation de la diffusion des annonces n'est pas disponible.

AdvertisingChannelType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
SEARCH Réseau de Recherche. Inclut les campagnes display groupées et les campagnes Réseau de Recherche+.
DISPLAY Réseau Display de Google uniquement.
SHOPPING Les campagnes Shopping sont diffusées sur la propriété Shopping et dans les résultats de recherche google.com.
HOTEL 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 de vos campagnes 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é uniquement comme valeur de retour. Représente une valeur inconnue dans cette version.
SEARCH_MOBILE_APP Campagnes pour applications mobiles sur le Réseau de Recherche
DISPLAY_MOBILE_APP Campagnes pour applications mobiles sur le Réseau Display
SEARCH_EXPRESS Campagnes AdWords Express pour le Réseau de Recherche.
DISPLAY_EXPRESS Campagnes AdWords Express pour le Réseau 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 plus 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, qui vise à générer du réengagement avec l'application sur plusieurs des principales propriétés de Google, dont le Réseau de Recherche, YouTube et le Réseau Display de Google.
LOCAL_CAMPAIGN Campagnes spécialisées pour la publicité locale.
SHOPPING_COMPARISON_LISTING_ADS Campagnes Shopping comparateur de prix.
SMART_CAMPAIGN Campagnes intelligentes standards
VIDEO_SEQUENCE Campagnes vidéo avec des annonces vidéo séquencées.
APP_CAMPAIGN_FOR_PRE_REGISTRATION Campagne pour applications de préinscription, spécialisée dans la publicité pour la préinscription à des applications mobiles, qui cible plusieurs canaux publicitaires sur Google Play, YouTube et le Réseau Display.
VIDEO_REACH_TARGET_FREQUENCY Campagne vidéo axée sur la couverture avec la stratégie d'enchères "Fréquence cible".
TRAVEL_ACTIVITIES Campagnes de voyage pour Activités.
SOCIAL_FACEBOOK_TRACKING_ONLY Facebook ne suit que les campagnes sur les réseaux sociaux.

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 la campagne est activée pour les enchères en temps réel.

NetworkSettings

Paramètres de réseau 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 défini sur true).
targetContentNetwork

boolean

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

boolean

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

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 que représente 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'univers des produits pouvant être promus par la campagne et la façon dont cette campagne interagit avec les autres campagnes Shopping.

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

string

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

boolean

Indique s'il faut cibler l'inventaire des fiches de véhicules.
merchantId

string (int64 format)

ID du compte Merchant Center. Ce champ est obligatoire pour les opérations de création. Ce champ 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 une priorité numériquement plus élevée sont prioritaires par rapport à celles ayant une priorité plus faible. 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 les produits en magasin doivent être inclus.

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 à exclure dans cette campagne.

PositiveGeoTargetType

Types de cibles géographiques positives possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
PRESENCE_OR_INTEREST Indique qu'une annonce est déclenchée si l'utilisateur se trouve dans les zones ciblées par l'annonceur ou s'y intéresse.
SEARCH_INTEREST Indique qu'une annonce est déclenchée si l'utilisateur recherche les zones ciblées de l'annonceur. Vous ne pouvez l'utiliser 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 cibles géographiques à exclure possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
PRESENCE_OR_INTEREST Indique qu'un utilisateur est exclu de la diffusion de l'annonce s'il se trouve dans les zones géographiques exclues de l'annonceur ou s'il y montre de l'intérêt.
PRESENCE Indique qu'un utilisateur est exclu de la diffusion de 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 lesquelles optimiser cette campagne. Cette fonctionnalité ne s'applique qu'aux campagnes pour applications qui utilisent MULTI_CHANNEL comme AdvertisingChannelType et APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT comme AdvertisingChannelSubType.

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

string

Ensemble sélectionné de noms de ressources pour les actions de conversion permettant d'optimiser cette campagne.

OptimizationGoalSetting

Paramètres d'objectif d'optimisation pour cette campagne, qui incluent 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é uniquement comme valeur de retour. Représente une valeur inconnue dans cette version.
CALL_CLICKS Optimisez vos campagnes pour les clics sur les numéros de téléphone. Les conversions par clic sur le numéro de téléphone correspondent au nombre de fois où les utilisateurs ont sélectionné "Appeler" pour contacter un magasin après avoir vu une annonce.
DRIVING_DIRECTIONS Optimisez vos campagnes pour les demandes d'itinéraire. Les conversions "Itinéraire" correspondent au nombre de fois où les utilisateurs ont sélectionné "Itinéraire" pour se rendre dans un magasin après avoir vu une annonce.
APP_PRE_REGISTRATION Optimisez les préinscriptions. Les conversions de préinscription correspondent au nombre d'utilisateurs qui se sont préinscrits pour recevoir une notification lorsque l'application sera disponible.

TrackingSetting

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

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

string

URL utilisée pour le suivi dynamique.

AssetSetType

Types possibles d'un ensemble de composants.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
PAGE_FEED Ensemble de composants de page.
DYNAMIC_EDUCATION Ensemble de composants d'enseignement dynamique.
MERCHANT_CENTER_FEED Ensemble d'assets Google Merchant Center.
DYNAMIC_REAL_ESTATE Ensemble d'assets immobiliers dynamiques.
DYNAMIC_CUSTOM Ensemble de composants personnalisés dynamiques.
DYNAMIC_HOTELS_AND_RENTALS Ensemble d'assets dynamiques pour les hôtels et les locations.
DYNAMIC_FLIGHTS Ensemble d'assets dynamiques sur les vols.
DYNAMIC_TRAVEL Ensemble de composants de voyage dynamiques.
DYNAMIC_LOCAL Ensemble de composants locaux dynamiques.
DYNAMIC_JOBS Ensemble de composants dynamiques (emploi).
LOCATION_SYNC Ensemble de composants au niveau de la synchronisation de lieu.
BUSINESS_PROFILE_DYNAMIC_LOCATION_GROUP Ensemble de composants de groupe de zones géographiques de fiche d'établissement.
CHAIN_DYNAMIC_LOCATION_GROUP Ensemble de composants Groupe de chaînes d'établissements pouvant être utilisé pour les établissements détenus et affiliés.
STATIC_LOCATION_GROUP Ensemble de composants Groupe d'établissements statique, qui peut être utilisé pour les établissements détenus et affiliés.
HOTEL_PROPERTY Ensemble de composants "Établissement hôtelier" utilisé pour associer un flux d'établissements hôteliers aux campagnes Performance Max pour les objectifs de voyage.
TRAVEL_FEED Type d'ensemble de composants de flux de voyage. Peut représenter un flux d'hôtels ou un flux d'activités.

ManualCpa

Ce type ne comporte aucun champ.

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

ManualCpc

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

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

boolean

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

ManualCpm

Ce type ne comporte aucun champ.

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

PercentCpc

Stratégie d'enchères dans laquelle les enchères représentent une fraction du prix annoncé pour un bien ou 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, spécifié en micro-unités locales. Remarque : Une valeur nulle est interprétée de la même manière qu'un bid_ceiling non défini.
enhancedCpcEnabled

boolean

Ajuste l'enchère pour chaque mise aux enchères à la hausse ou à la baisse, en fonction de la probabilité de conversion. Les enchères individuelles peuvent dépasser cpcBidCeilingMicros, mais le montant moyen des enchères pour 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 avez défini.

CampaignAsset

Lien entre une campagne et un composant.

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

string

Nom de ressource du composant Campagne. Les noms de ressources CampaignAsset se présentent sous la forme suivante :

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

enum (AssetLinkStatus)

État du composant de campagne.
campaign

string

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

string

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

CampaignAssetSet

CampaignAssetSet est le lien entre une campagne et un ensemble de composants. L'ajout d'un CampaignAssetSet associe un ensemble de composants à une campagne.

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

string

Nom de ressource de l'ensemble de composants de la campagne. Les noms de ressources des éléments d'un groupe d'assets se présentent sous 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 d'éléments associé à la campagne.
status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

Vue d'audience de campagne. Inclut les données de performances des listes de centres d'intérêt et 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 par 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 "Audience de la campagne". Les noms de ressources des vues d'audience de campagne se présentent sous la forme suivante :

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 se présentent sous la forme suivante :

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

Un seul doit être défini. 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 de réponse uniquement.
ENABLED Le critère de campagne est activé.
PAUSED Le critère de la 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 ressource de la constante de langue.

LocationGroupInfo

Rayon autour d'une liste de lieux spécifiée dans un flux.

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

string

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

enum (LocationGroupRadiusUnits)

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

string

Ensembles d'éléments de flux dont les éléments de flux sont ciblés. Si plusieurs ID sont spécifiés, tous les éléments qui 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 champ est obligatoire et doit être défini dans les opérations CREATE.

LocationGroupRadiusUnits

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

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

CampaignEffectiveLabel

Représente une relation entre une campagne et un libellé efficace. Un libellé effectif 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 se présentent sous la forme suivante : customers/{ownerCustomerId}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign

string

Campagne à laquelle le libellé effectif est associé.
label

string

Libellé effectif attribué à la campagne.
ownerCustomerId

string (int64 format)

ID 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/{ownerCustomerId}/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

Vue des ventes avec les données du panier.

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

string

Nom de ressource de la vue "Données du panier". Les noms de ressources des vues des ventes de données de panier se présentent sous la forme suivante : customers/{customerId}/cartDataSalesView

Audience

Les audiences sont 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 ressource de l'audience. Les noms d'audience se présentent sous la forme suivante :

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 entre 1 et 255 caractères.
description

string

Description de cette audience.

ConversionAction

Une action de conversion.

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

string

Nom de ressource de l'action de conversion. Les noms de ressources d'actions de conversion se présentent au format suivant :

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 conversions 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, quels que soient leur objectif de conversion client ou leur objectif de conversion de campagne. Toutefois, les objectifs de conversion personnalisés ne respectent pas primaryForGoal. Par conséquent, si une campagne est configurée avec un objectif de conversion personnalisé dont l'action de conversion est définie sur primaryForGoal = false, cette action de conversion reste enchérissable. Par défaut, la valeur de "primaryForGoal" est "true" si elle n'est pas définie. Dans la version 9, primaryForGoal ne peut être défini sur "false" qu'après la création, via une opération de mise à jour, car il n'est pas déclaré comme facultatif.
ownerCustomer

string

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

boolean

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

boolean

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

string (int64 format)

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

string

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

ConversionActionStatus

États possibles d'une action de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. 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'UI.

ConversionActionType

Types possibles d'une action de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
AD_CALL Conversions qui se produisent lorsqu'un utilisateur clique sur l'extension d'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 la facturation Android.
UPLOAD_CALLS Conversions par appel suivies par l'annonceur et importées.
UPLOAD_CLICKS Conversions suivies par l'annonceur et importées avec les clics attribués.
WEBPAGE Conversions qui ont lieu sur une page Web.
WEBSITE_CALL Conversions qui se produisent lorsqu'un utilisateur appelle un numéro de téléphone généré de manière dynamique à partir du site Web d'un annonceur.
STORE_SALES_DIRECT_UPLOAD Conversion des ventes en magasin basée sur les données first party ou tierces importées par le marchand. Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types d'importation directe des ventes en magasin.
STORE_SALES Conversion des ventes en magasin basée sur les importations de données first party ou tierces des marchands 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 Conversions de première ouverture d'une application Android suivies avec Firebase.
FIREBASE_ANDROID_IN_APP_PURCHASE Conversions d'achats via une application Android suivies avec Firebase.
FIREBASE_ANDROID_CUSTOM Conversions personnalisées d'applications Android suivies avec Firebase.
FIREBASE_IOS_FIRST_OPEN Conversions de première ouverture d'application iOS suivies avec Firebase.
FIREBASE_IOS_IN_APP_PURCHASE Conversions d'achats via une application iOS suivies avec Firebase.
FIREBASE_IOS_CUSTOM Conversions personnalisées d'applications iOS suivies avec Firebase.
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN Conversions de première ouverture d'application Android suivies à l'aide d'une solution d'analyse d'applications tierce.
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE Conversions d'achats via une application Android suivies à l'aide d'une solution d'analyse d'applications tierce.
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM Conversions personnalisées d'applications Android suivies à l'aide d'une solution d'analyse d'applications tierce.
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN Conversions de première ouverture d'application iOS suivies à l'aide d'une solution d'analyse d'applications tierce.
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE Conversions d'achats via une application iOS suivies à l'aide d'une solution d'analyse d'applications tierce.
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM Conversions personnalisées d'applications iOS suivies à l'aide d'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 à une application. Lecture seule.
FLOODLIGHT_ACTION Activité Floodlight qui comptabilise le nombre de fois où les internautes ont consulté une page Web spécifique après avoir vu l'une des annonces d'un annonceur ou cliqué dessus. Lecture seule.
FLOODLIGHT_TRANSACTION Activité Floodlight qui suit le nombre de ventes réalisées ou le nombre d'articles achetés. Vous pouvez également capturer la valeur totale de chaque vente. Lecture seule.
GOOGLE_HOSTED Conversions qui suivent les actions locales effectuées dans les 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

Obsolète : l'intégration Salesforce sera remplacée par une méthode améliorée d'importation de vos conversions depuis Salesforce. - consultez https://support.google.com/google-ads/answer/14728349.
SEARCH_ADS_360 Conversions importées à partir des données Floodlight Search Ads 360. Lecture seule.
SMART_CAMPAIGN_AD_CLICKS_TO_CALL Conversions par appel générées par les annonces de campagnes intelligentes sans suivi des appels configuré, à l'aide de critères personnalisés de campagnes intelligentes. 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 campagnes intelligentes. Lecture seule.
STORE_VISITS Conversions qui se produisent lorsqu'un utilisateur visite le magasin physique d'un annonceur. Lecture seule.
WEBPAGE_CODELESS Conversions créées à partir d'événements sur le site Web (comme l'envoi de formulaires ou le chargement de pages) qui n'utilisent pas d'extraits d'événement codés individuellement. Lecture seule.
UNIVERSAL_ANALYTICS_GOAL Conversions provenant d'objectifs Universal Analytics associés.
UNIVERSAL_ANALYTICS_TRANSACTION Conversions provenant de transactions Universal Analytics associées.
GOOGLE_ANALYTICS_4_CUSTOM Conversions provenant 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 de conversions associées à une ConversionAction.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
DEFAULT Catégorie par défaut.
PAGE_VIEW Un utilisateur consulte une page.
PURCHASE Événement "Achat", "Vente" ou "Commande passée".
SIGNUP Action utilisateur d'inscription.
LEAD Action générant des 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 à un produit ou service.
PHONE_CALL_LEAD Appel à manifester votre intérêt pour l'offre d'un annonceur.
IMPORTED_LEAD Conversion de prospects importée dans Google Ads à partir d'une source externe.
SUBMIT_LEAD_FORM Envoi d'un formulaire sur le site d'un annonceur indiquant un intérêt commercial.
BOOK_APPOINTMENT Réservation d'un rendez-vous avec l'entreprise d'un annonceur.
REQUEST_QUOTE Une demande de devis ou d'estimation de prix.
GET_DIRECTIONS Recherche de l'adresse d'un annonceur avec l'intention de s'y rendre
OUTBOUND_CLICK Clic vers le site d'un partenaire de l'annonceur.
CONTACT Un appel, un SMS, un e-mail, un chat ou tout autre type de contact avec un annonceur.
ENGAGEMENT Un événement d'engagement sur le site Web, comme une longue durée de visite ou un objectif intelligent Google Analytics (GA). Destiné à être utilisé pour les importations d'objectifs GA, Firebase et GA Gold.
STORE_VISIT Visite dans un magasin physique.
STORE_SALE Vente réalisée dans un magasin physique.
QUALIFIED_LEAD Conversion de prospects importée dans Google Ads à partir d'une source externe et qualifiée par l'annonceur (équipe marketing/commerciale). Dans le parcours du prospect à la vente, les annonceurs obtiennent des prospects, puis agissent en les contactant. Si le consommateur est intéressé et susceptible d'acheter son produit, l'annonceur marque ces prospects comme "prospects qualifiés".
CONVERTED_LEAD Conversion de prospects importée d'une source externe dans Google Ads, qui a franchi une étape choisie définie par l'annonceur de génération de prospects.

ValueSettings

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

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

number

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

string

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

boolean

Indique si la valeur et le code de devise par défaut doivent être utilisés à la place de ceux 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 spécifique entre potentiellement plusieurs interactions précédentes.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
EXTERNAL Utilise l'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 à l'aide de l'attribution à la recherche Google.
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY Attribue un crédit exponentiellement plus élevé pour une conversion à ses clics les plus récents à l'aide de l'attribution Google Search (la demi-vie est d'une semaine).
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED Attribue 40 % du crédit d'une conversion à son premier et à son dernier clic. Les 20 % restants sont répartis de manière égale entre tous les autres clics. Cette fonctionnalité utilise l'attribution des entonnoirs de conversion pour les recherches 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 à la recherche Google.

DataDrivenModelStatus

Énumère les états du modèle basé sur les données.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
AVAILABLE Le modèle basé sur les données est disponible.
STALE Le modèle basé sur les données est obsolète. 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é. Le plus souvent, cela est dû au fait que le nombre d'événements requis n'a pas été atteint au cours des 30 derniers jours.
NEVER_GENERATED Le modèle basé sur les données n'a jamais été généré. Le plus souvent, cela est dû au fait qu'il n'y a jamais eu le nombre d'événements requis au cours d'une période de 30 jours.

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

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

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

string

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

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 supplémentaires avant et après.
tag

string

Obligatoire. Balise de la variable personnalisée de conversion. Le tag doit être unique et se composer d'un caractère "u" suivi directement d'un nombre inférieur ou égal à 100. Par 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
ACTIVATION_NEEDED

La variable personnalisée de conversion est en attente d'activation et ne générera pas de statistiques tant qu'elle ne sera pas définie sur "ACTIVÉE".

Cet état ne peut pas être utilisé dans les requêtes CREATE et UPDATE.
ENABLED La variable personnalisée de conversion est activée et des statistiques seront générées.
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 à nouveau définie sur "Activée".

ConversionCustomVariableFamily

Famille d'une variable personnalisée de conversion.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
BELOW_ALL_LIMITS La variable personnalisée de conversion a une cardinalité inférieure à toutes les limites. La variable peut être utilisée pour la segmentation et des statistiques peuvent s'accumuler pour les nouvelles valeurs si la variable est activée.
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT La variable personnalisée de conversion a une cardinalité qui dépasse la limite de segmentation, mais pas la limite de statistiques. La segmentation sera désactivée, mais des statistiques pourront être générées 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 approche les limites de statistiques (> 90 %). La segmentation sera désactivée, mais des statistiques pourront être générées 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 de statistiques. La segmentation sera désactivée et les statistiques des variables activées ne pourront s'accumuler que si les valeurs existantes n'augmentent pas davantage 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 de la variable Floodlight défini dans Search Ads 360.

FloodlightVariableType

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

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

FloodlightVariableDataType

Type de données de la variable Floodlight, tel qu'il est 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
NUMBER Représente une variable Floodlight de type "Nombre". Cette variable peut être attribuée à des variables Floodlight de type DIMENSION ou METRIC.
STRING Représente une variable Floodlight de type "String". Cette variable peut être attribuée à des 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,
  "managerId": string,
  "managerDescriptiveName": string,
  "subManagerId": string,
  "subManagerDescriptiveName": string,
  "associateManagerId": string,
  "associateManagerDescriptiveName": string,
  "accountLevel": enum (AccountLevelType),
  "id": string,
  "descriptiveName": string,
  "currencyCode": string,
  "timeZone": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "autoTaggingEnabled": boolean,
  "manager": boolean
}
Champs
resourceName

string

Nom de ressource du client. Les noms de ressources client se présentent sous 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 (DCM) pour un compte client 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".
managerId

string (int64 format)

Numéro client de l'administrateur. Une valeur de 0 indique que le client n'a pas de responsable SA360.
managerDescriptiveName

string

Nom descriptif du responsable.
subManagerId

string (int64 format)

Numéro client de l'administrateur secondaire. Une valeur de 0 indique que le client n'a pas de sous-administrateur SA360.
subManagerDescriptiveName

string

Nom descriptif de l'administrateur secondaire.
associateManagerId

string (int64 format)

Numéro client de l'administrateur associé. La valeur 0 indique que le client n'a pas d'administrateur associé SA360.
associateManagerDescriptiveName

string

Nom descriptif du responsable associé.
accountLevel

enum (AccountLevelType)

Niveau de compte du client : administrateur, administrateur secondaire, administrateur associé ou compte de service.
id

string (int64 format)

ID du client.
descriptiveName

string

Nom descriptif facultatif et non unique du client.
currencyCode

string

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

string

ID du fuseau horaire local du client.
trackingUrlTemplate

string

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

string

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

boolean

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

boolean

Indique si le client est un administrateur.

ConversionTrackingSetting

Ensemble de paramètres au niveau du client liés au 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 du compte administrateur. Ce champ est en lecture seule. Pour en savoir plus, consultez 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 sera différente en fonction du login-customer-id de la demande.
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 ressource du client pour lequel 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 ID n'indique pas si le client utilise le suivi des conversions (c'est le cas de conversionTrackingStatus). Ce champ est en lecture seule.
googleAdsCrossAccountConversionTrackingId

string (int64 format)

ID de suivi des conversions de l'administrateur du client. Cette valeur est définie lorsque le client a activé le suivi des conversions. Elle remplace conversionTrackingId. Ce champ ne peut être géré que dans l'UI Google Ads. Ce champ est en lecture seule.
crossAccountConversionTrackingId

string (int64 format)

ID de suivi des conversions de l'administrateur du client. Cette valeur est définie lorsque le client a activé le suivi des conversions multicomptes. Elle remplace conversionTrackingId.

ConversionTrackingStatus

État du suivi des conversions du client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
NOT_CONVERSION_TRACKED Le client n'utilise aucun suivi des conversions.
CONVERSION_TRACKING_MANAGED_BY_SELF Les actions de conversion sont créées et gérées par ce client.
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER Les actions de conversion sont créées et gérées par l'administrateur spécifié dans 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 de celui spécifié dans le login-customer-id de la demande.

AccountType

Types de comptes de moteur possibles.

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

DoubleClickCampaignManagerSetting

Paramètre DoubleClick Campaign Manager (DCM) pour un compte client 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 de l'IANA (par exemple, America/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 a été désactivé par l'utilisateur.
SUSPENDED Le compte est désactivé par une procédure interne.
REMOVED Le compte est définitivement désactivé.
DRAFT Le compte est toujours en cours de configuration et n'est pas encore ACTIVÉ.

CustomerStatus

États possibles d'un client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
ENABLED Indique un compte actif pouvant diffuser des annonces.
CANCELED Indique un compte résilié qui ne peut pas diffuser d'annonces. Un administrateur peut le réactiver.
SUSPENDED Indique un compte suspendu qui ne peut pas diffuser d'annonces. Ne peut être activé que par l'assistance Google.
CLOSED Indique un compte clôturé qui ne peut pas diffuser d'annonces. Le compte de test aura également l'état "CLÔTURÉ". Cet état est définitif et ne peut pas être modifié.

AccountLevelType

Énumération décrivant les niveaux de compte possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
CLIENT_ACCOUNT_FACEBOOK Compte client (Facebook)
CLIENT_ACCOUNT_GOOGLE_ADS Compte client (Google Ads)
CLIENT_ACCOUNT_MICROSOFT Compte client (Microsoft)
CLIENT_ACCOUNT_YAHOO_JAPAN Compte client (Yahoo! JAPAN)
CLIENT_ACCOUNT_ENGINE_TRACK Compte client (suivi de moteur)
MANAGER Compte administrateur de niveau supérieur.
SUB_MANAGER Administrateur secondaire.
ASSOCIATE_MANAGER Administrateur associé.

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'asset client. Les noms de ressources CustomerAsset se présentent sous la forme suivante :

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

string

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

enum (AssetLinkStatus)

État de l'asset client.

CustomerAssetSet

CustomerAssetSet est le lien entre un client et un ensemble d'assets. L'ajout d'un CustomerAssetSet associe 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'assets client. Les noms de ressources des éléments d'un groupe d'assets se présentent sous la forme suivante :

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

string

Ensemble d'éléments 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 client. Lecture seule.

AccessibleBiddingStrategy

Représente une vue des stratégies d'enchères 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 ressource de la stratégie d'enchères accessible. Les noms de ressources AccessibleBiddingStrategy se présentent sous la forme suivante :

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}
id

string (int64 format)

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

string

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

enum (BiddingStrategyType)

Type de stratégie d'enchères.
ownerCustomerId

string (int64 format)

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

string

DescriptiveName 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'un seul. 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)

Stratégie d'enchères automatiques qui vous permet de maximiser les conversions pour vos campagnes sans dépasser 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 retour sur les dépenses publicitaires (ROAS) cible spécifique.
targetSpend

object (TargetSpend)

Stratégie d'enchères qui définit vos enchères pour vous permettre d'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 "ROAS cible". Si elle est définie, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, le ROAS cible. Si le ROAS cible est élevé, il est possible que la stratégie d'enchères ne puisse pas dépenser l'intégralité du budget. Si le ROAS cible n'est pas défini, la stratégie d'enchères s'efforcera d'atteindre le ROAS le plus élevé possible pour le budget.

MaximizeConversions

Stratégie d'enchères automatiques qui vous permet de maximiser les conversions pour vos campagnes sans dépasser votre budget.

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

string (int64 format)

L'option "CPA cible". Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.
targetCpaMicros

string (int64 format)

L'option "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 de sorte 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 des résultats de recherche.
locationFractionMicros

string (int64 format)

Fraction d'annonces à diffuser dans la zone ciblée, en micro-unités. Par exemple, 1 % équivaut à 10 000.
cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

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

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

number

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

TargetSpend

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

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

string (int64 format)

Objectif de dépenses en dessous duquel optimiser les clics. Un enchérisseur TargetSpend tentera de dépenser la plus petite de cette valeur ou le montant normal de limitation des dépenses. S'il n'est pas spécifié, le budget est utilisé comme cible de dépenses. Ce champ est obsolète et ne doit plus être utilisé. Pour en savoir plus, consultez 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'un lien.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
ACTIVE Indique la relation actuellement en vigueur
INACTIVE Indique une relation terminée
PENDING Indique que l'administrateur a demandé à établir une relation, mais que le client ne l'a pas encore acceptée.
REFUSED L'administrateur a demandé à établir une relation, mais le client a refusé.
CANCELED Indique que l'association a été demandée par l'administrateur, mais qu'il l'a annulée.

CustomerClient

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

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

string

Nom de ressource du client. Les noms de ressources CustomerClient se présentent sous la forme suivante : customers/{customerId}/customerClients/{client_customer_id}
appliedLabels[]

string

Noms de ressource des libellés appartenant au client demandeur et appliqués au client. Les noms de ressources des libellés se présentent sous la forme suivante :

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

enum (CustomerStatus)

État du compte client. Lecture seule.
clientCustomer

string

Nom de ressource du client-compte 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 le client et le client donné. Pour un lien vers soi-même, la valeur du niveau sera de 0. Lecture seule.
timeZone

string

Représentation sous forme de 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 de 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" ou "EUR") pour le client. Lecture seule.
id

string (int64 format)

ID du client. Lecture seule.

DynamicSearchAdsSearchTermView

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

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

string

Nom de ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Les noms de ressources des vues des 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 de l'impression sélectionnée de manière dynamique.

Ce champ est en lecture seule.

GenderView

Vue par genre. La ressource genderView reflète l'état de diffusion effectif, et non 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. Par conséquent, tous les genres apparaissent 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

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 ressource de la constante de ciblage géographique. Les noms de ressources constantes de ciblage géographique se présentent sous 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 ciblage 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 complet en anglais, composé du nom de la cible, de celui de son parent et de celui du pays.
parentGeoTarget

string

Nom de ressource de la constante de ciblage géographique parente. Les noms de ressources constantes de ciblage géographique se présentent sous 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 de réponse uniquement.
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 des mots clés

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

string

Nom de ressource de la vue de mot clé. 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 de libellé se présentent sous la forme suivante : customers/{ownerCustomerId}/labels/{label_id}
status

enum (LabelStatus)

État du libellé. Lecture seule.
textLabel

object (TextLabel)

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

string (int64 format)

ID du libellé. Lecture seule.
name

string

Nom du libellé.

Ce champ est obligatoire. Il doit être renseigné 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é uniquement pour la valeur renvoyée. Représente une 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 coloré.

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 de fond ne soit pas visible pour les comptes administrateur.
description

string

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

LanguageConstant

une langue.

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

string

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

languageConstants/{criterionId}
id

string (int64 format)

ID de la constante de langue.
code

string

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

string

Nom complet de la langue en anglais (par exemple, "English (US)", "Spanish", etc.).
targetable

boolean

Indique si la langue peut être ciblée.

LocationView

Une vue des zones géographiques résume les performances des campagnes selon un critère géographique.

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

string

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

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

ProductBiddingCategoryConstant

Catégorie d'enchères pour 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 des catégories d'enchères de 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 du 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 ressource de la catégorie d'enchères du produit parent.
languageCode

string

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

string

Valeur à afficher de la catégorie d'enchères du produit, localisée selon languageCode.

ProductBiddingCategoryLevel

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

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

ProductBiddingCategoryStatus

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

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

ProductGroupView

Vue du 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 suivante :

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

ShoppingPerformanceView

Vue des performances Shopping. Fournit des statistiques sur les campagnes Shopping agrégées à plusieurs niveaux de dimension produit. Les valeurs des dimensions de produit de Merchant Center, telles que la marque, la catégorie, les attributs personnalisés, l'état du produit et le type de produit, reflètent l'état de chaque dimension à la date et à l'heure où l'événement correspondant a été enregistré.

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 suivante : customers/{customerId}/shoppingPerformanceView

UserList

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

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

string

Nom de ressource de la liste d'utilisateurs. Les noms de ressources de la liste d'utilisateurs se présentent comme suit :

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. En fonction de 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
REMARKETING UserList représentée sous la forme d'une collection de types de conversion.
LOGICAL UserList représentée comme une combinaison d'autres listes d'utilisateurs/centres d'intérêt.
EXTERNAL_REMARKETING Liste d'utilisateurs créée sur la plate-forme Google Ad Manager.
RULE_BASED UserList associée à une règle.
SIMILAR UserList avec des utilisateurs semblables à ceux d'une autre UserList.
CRM_BASED Liste de données CRM first party fournies par l'annonceur sous forme d'adresses e-mail ou dans d'autres formats.

UserLocationView

Vue de la zone géographique d'un utilisateur.

La vue "Emplacement de l'utilisateur" inclut toutes les métriques agrégées au niveau du pays, avec une ligne par pays. Il indique les métriques en fonction de la position physique réelle de l'utilisateur, selon la zone ciblée ou non. Si d'autres champs de segment sont utilisés, vous pouvez obtenir plusieurs lignes par pays.

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

string

Nom de ressource de la vue de la zone géographique de l'utilisateur. Les noms de ressources des vues 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'établissement a été ciblé ou non.

WebpageView

Une vue de page Web.

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

string

Nom de ressource de la vue de la page Web. Les noms de ressources des vues de pages Web se présentent sous la forme suivante :

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

Consulter

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 sont au format suivant :

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

string (int64 format)

ID de la visite.
criterionId

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

string

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

string

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

enum (ProductChannel)

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

string

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

string

Magasin associé à l'annonce produit en magasin ayant fait l'objet d'un clic. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin.
productCountryCode

string

Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic.
assetId

string (int64 format)

ID du composant avec lequel l'utilisateur a interagi lors de l'événement de visite.
assetFieldType

enum (AssetFieldType)

Type de champ de 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
ONLINE L'article est vendu en ligne.
LOCAL L'article est vendu dans des 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 au format suivant :

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 du composant avec lequel l'utilisateur a interagi lors de l'événement de conversion.
assetFieldType

enum (AssetFieldType)

Type de champ de composant de l'événement de conversion.

AttributionType

Type d'attribution des conversions dans Search Ads 360

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
ENABLED La conversion est activée.
REMOVED La conversion a été supprimée.

Métriques

Données de métriques.

Représentation JSON 
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "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,
  "uniqueUsers": string,
  "averageImpressionFrequencyPerUser": number
}
Champs
allConversionsValueByConversionDate

number

Valeur de toutes les conversions. Lorsque cette colonne est sélectionnée avec une date, les valeurs de la colonne de date correspondent à la date de conversion. Pour en savoir plus sur les colonnes "by_conversion_date", 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 une date, les valeurs de la colonne de date correspondent à la date de conversion. Pour en savoir plus sur les colonnes "by_conversion_date", 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 une 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 de l'attribution. Lorsque cette colonne est sélectionnée avec une 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)

Historique du taux de clics (CTR) prédit pour la recherche.
interactionEventTypes[]

enum (InteractionEventType)

Types d'interactions payantes et sans frais.
rawEventConversionMetrics[]

object (Value)

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

number

Nombre de conversions d'un autre type (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 du 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 du 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 du flux.
averageCost

number

Montant moyen que vous payez par interaction. Cette somme correspond au coût total de vos annonces divisé par le nombre total d'interactions.
averageCpc

number

Coût total de tous les clics divisé par le nombre total de clics reçus. 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.
averageCpm

number

Coût moyen pour mille impressions (CPM). 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.
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 en raison du budget pour le 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 à une 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 des conversions enchérissables divisée par le coût total des interactions éligibles aux conversions.
conversionsFromInteractionsValuePerInteraction

number

Valeur des conversions issues des interactions divisée par le nombre d'interactions avec l'annonce. Cela n'inclut que les actions de conversion 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. Consultez le paramètre metrics_currency sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
costPerAllConversions

number

Coût des interactions avec les annonces divisé par le nombre total de conversions.
costPerConversion

number

Coût moyen éligible aux conversions par conversion enchérissable.
costPerCurrentModelAttributedConversion

number

Coût des interactions avec les annonces divisé par le nombre de conversions attribuées au 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 "by_conversion_date", consultez https://support.google.com/sa360/answer/9250611.
crossDeviceConversionsValue

number

Somme de la valeur des conversions multi-appareils.
crossDeviceConversionsValueByConversionDate

number

Somme de la valeur des conversions multi-appareils par date de conversion. Pour en savoir plus sur les colonnes "by_conversion_date", 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 à la principale action effectuée par l'utilisateur en fonction du format de l'annonce (clic pour les annonces textuelles et Shopping, vue pour les annonces vidéo, etc.).
invalidClickRate

number

Pourcentage de clics filtrés sur le nombre total de clics (clics filtrés + clics 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 pour lesquels vous n'êtes pas facturé.
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 de clics que Google considère comme illicites et qui sont détectés par des moyens de filtrage de routine (trafic incorrect connu des centres de données, robots et 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 permettent aux utilisateurs d'accéder à une page adaptée aux mobiles.
searchAbsoluteTopImpressionShare

number

Pourcentage d'impressions d'annonces Shopping ou sur le Réseau de Recherche diffusées à la position la plus visible. Pour en savoir plus, consultez https://support.google.com/sa360/answer/9566729. Toute valeur inférieure à 0,1 est signalée à 0,0999.
searchBudgetLostAbsoluteTopImpressionShare

number

Nombre estimant la fréquence à laquelle 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 (budget) 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

Nombre estimant la fréquence à laquelle votre annonce n'a pas été diffusée à côté des meilleurs résultats de recherche naturels en raison d'un budget insuffisant. 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, quels que soient vos types de correspondance de 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 estimant la fréquence à laquelle votre annonce n'était pas la toute 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 estimant la fréquence à laquelle votre annonce n'a pas été diffusée à côté des meilleurs résultats de recherche naturels en raison de son mauvais classement. Remarque : le taux d'impressions perdues en première position 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 que vous avez enregistrées en haut de la page 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 de toutes les conversions.
valuePerAllConversionsByConversionDate

number

Valeur de toutes les conversions divisée par le nombre de toutes les conversions. Lorsque cette colonne est sélectionnée avec une date, les valeurs de la colonne de date correspondent à la date de conversion. Pour en savoir plus sur les colonnes "by_conversion_date", consultez https://support.google.com/sa360/answer/9250611.
valuePerConversion

number

Valeur des conversions enchérissables 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 le nombre de 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 une 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 au niveau 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 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.
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 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.
clientAccountCrossSellGrossProfitMicros

string (int64 format)

La marge brute des ventes croisées au niveau 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. Consultez le paramètre metrics_currency sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountCrossSellRevenueMicros

string (int64 format)

Les revenus des ventes croisées du compte client correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion d'un autre produit. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les revenus des ventes croisées correspondent à la valeur totale des ventes croisées attribuées à vos annonces. Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus de la vente croisée pour cette commande sont de 20 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. 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 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.
clientAccountCrossSellUnitsSold

number

La métrique "Unités vendues via les ventes croisées" au niveau 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 au niveau du compte client correspond au coût total des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, leur coût est comptabilisé comme coût de vente lié aux prospects. Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 $ et celui de la chemise est de 5 $. Le coût de vente lié aux prospects pour cette commande est de 3 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. 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. Consultez le paramètre metrics_currency sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
clientAccountLeadGrossProfitMicros

string (int64 format)

La marge brute des prospects au niveau 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. Consultez le paramètre metrics_currency sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.
leadGrossProfitMicros

string (int64 format)

La marge brute des prospects correspond aux bénéfices générés par les produits vendus suite à la promotion de ces mêmes produits, moins le prix de revient. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, votre marge brute des prospects est calculée comme suit : revenus générés par ces ventes moins le prix de revient. Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et a une valeur de 3 $ pour le prix de revient. La marge brute des prospects pour cette commande est égale à 7 $, soit 10 $ - 3 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. 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.
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 s'élèvent à 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 s'élèvent à 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.
clientAccountLeadUnitsSold

number

La métrique "Unités vendues aux prospects" au niveau du compte client correspond au nombre total de produits vendus suite à la promotion de ces mêmes produits. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, le nombre total de ces produits vendus s'affiche sous "Unités vendues aux prospects". Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues aux prospects dans cette commande est de 1. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.
leadUnitsSold

number

La métrique "Unités du produit principal 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.
uniqueUsers

string (int64 format)

Nombre d'utilisateurs uniques ayant vu votre annonce au cours de la période demandée. Cette métrique ne peut pas être agrégée et ne peut être demandée que pour des plages de dates de 92 jours ou moins. Cette métrique est disponible pour les types de campagnes suivants : display, vidéo, Discovery et pour applications.
averageImpressionFrequencyPerUser

number

Nombre moyen de fois où un utilisateur unique a vu votre annonce au cours de la période demandée. Cette métrique ne peut pas être agrégée et ne peut être demandée que pour des plages de dates de 92 jours ou moins. Cette métrique est disponible pour les types de campagnes suivants : display, vidéo, Discovery et pour applications.

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

Un float.
doubleValue

number

Valeur double.
stringValue

string

Chaîne.

QualityScoreBucket

Énumération listant les différents niveaux de qualité possibles.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
BELOW_AVERAGE La qualité de la création est inférieure à la moyenne.
AVERAGE La qualité de la création est moyenne.
ABOVE_AVERAGE La qualité de la création est supérieure à la moyenne.

InteractionEventType

Énumération décrivant les types possibles d'interactions payantes et sans frais.

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

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 d'action de conversion.
conversionCustomDimensions[]

object (Value)

Dimensions personnalisées de conversion.
dayOfWeek

enum (DayOfWeek)

Jour de la semaine, par exemple "MONDAY" (LUNDI).
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 brut.
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 ressource de la constante de ciblage géographique représentant une ville.
geoTargetCountry

string

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

string

Nom de ressource de la constante de ciblage géographique représentant une agglomération.
geoTargetRegion

string

Nom de ressource de la constante de ciblage géographique représentant 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. Format : aaaa-MM-jj
productBiddingCategoryLevel1

string

Catégorie d'enchères (niveau 1) du produit.
productBiddingCategoryLevel2

string

Catégorie d'enchères (niveau 2) du produit.
productBiddingCategoryLevel3

string

Catégorie d'enchères (niveau 3) du produit.
productBiddingCategoryLevel4

string

Catégorie d'enchères (niveau 4) du produit.
productBiddingCategoryLevel5

string

Catégorie d'enchères (niveau 5) du produit.
productBrand

string

Marque du produit.
productCountry

string

Nom de ressource de la constante de ciblage géographique pour le pays de vente du produit.
productCustomAttribute0

string

Attribut personnalisé 0 du produit.
productCustomAttribute1

string

Attribut personnalisé 1 du produit.
productCustomAttribute2

string

Attribut personnalisé 2 du produit.
productCustomAttribute3

string

Attribut personnalisé 3 du produit.
productCustomAttribute4

string

Attribut personnalisé 4 du produit.
productItemId

string

ID d'article du produit.
productLanguage

string

Nom de ressource de la constante de langue du produit.
productSoldBiddingCategoryLevel1

string

Catégorie d'enchères (niveau 1) du produit vendu.
productSoldBiddingCategoryLevel2

string

Catégorie d'enchères (niveau 2) du produit vendu.
productSoldBiddingCategoryLevel3

string

Catégorie d'enchères (niveau 3) du produit vendu.
productSoldBiddingCategoryLevel4

string

Catégorie d'enchères (niveau 4) du produit vendu.
productSoldBiddingCategoryLevel5

string

Catégorie d'enchères (niveau 5) du produit vendu.
productSoldBrand

string

Marque du produit vendu.
productSoldCustomAttribute0

string

Attribut personnalisé 0 du produit vendu.
productSoldCustomAttribute1

string

Attribut personnalisé 1 du produit vendu.
productSoldCustomAttribute2

string

Attribut personnalisé 2 du produit vendu.
productSoldCustomAttribute3

string

Attribut personnalisé 3 du produit vendu.
productSoldCustomAttribute4

string

Attribut personnalisé 4 du produit vendu.
productSoldItemId

string

ID d'article du produit vendu.
productSoldTitle

string

Titre du produit vendu.
productSoldTypeL1

string

Type (niveau 1) du produit vendu.
productSoldTypeL2

string

Type (niveau 2) du produit vendu.
productSoldTypeL3

string

Type (niveau 3) du produit vendu.
productSoldTypeL4

string

Type (niveau 4) du produit vendu.
productSoldTypeL5

string

Type (niveau 5) du produit vendu.
productStoreId

string

ID de magasin associé au produit.
productTitle

string

Titre du produit.
productTypeL1

string

Type (niveau 1) du produit.
productTypeL2

string

Type (niveau 2) du produit.
productTypeL3

string

Type (niveau 3) du produit.
productTypeL4

string

Type (niveau 4) du produit.
productTypeL5

string

Type (niveau 5) du produit.
quarter

string

Trimestre représenté par la date du premier jour du trimestre. Utilise l'année civile pour les trimestres (par exemple, le deuxième trimestre de 2018 commence le 1er avril 2018). Format : aaaa-MM-jj
week

string

Semaine définie du lundi au dimanche, représentée par la date du lundi. 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 se sont produites sur le composant lui-même ou sur un autre composant ou bloc d'annonces. Les interactions (par exemple, les clics) sont comptabilisées pour toutes les parties de l'annonce diffusée (par exemple, l'annonce elle-même et d'autres composants tels que les liens annexes) lorsqu'elles sont diffusées ensemble. Lorsque interactionOnThisAsset est défini sur "true", cela signifie que les interactions ont lieu sur ce composant spécifique. Lorsque interactionOnThisAsset est défini sur "false", cela signifie que les interactions n'ont pas lieu sur ce composant spécifique, mais sur d'autres parties de l'annonce diffusée avec ce composant.

AdNetworkType

Énumère les types de réseaux Google Ads.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN La valeur est inconnue dans cette version.
SEARCH Recherche Google
SEARCH_PARTNERS Partenaires du Réseau de Recherche
CONTENT Réseau Display
YOUTUBE_WATCH Vidéos YouTube
MIXED Multiréseau

Mot clé

Segment de critère de mot clé.

Représentation JSON 
{
  "info": {
    object (KeywordInfo)
  },
  "adGroupCriterion": string
}
Champs
info

object (KeywordInfo)

Informations sur les mots clés.
adGroupCriterion

string

Nom de ressource AdGroupCriterion.

ProductChannelExclusivity

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
SINGLE_CHANNEL L'article est vendu sur un seul canal, en magasin ou en ligne, comme indiqué par son attribut ProductChannel.
MULTI_CHANNEL L'article est associé à 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é uniquement pour la valeur renvoyée. Représente une valeur inconnue dans cette version.
OLD L'état du produit est "ancien".
NEW L'état du 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 du composant.
interactionOnThisAsset

boolean

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et AdGroupAsset. Indique si les métriques d'interaction se sont produites sur le composant lui-même ou sur un autre composant ou bloc d'annonces.