SearchAds360Row

Une ligne renvoyée par la requête.

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

object (AdGroup)

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

adGroupAd

object (AdGroupAd)

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

adGroupAdLabel

object (AdGroupAdLabel)

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

adGroupAsset

object (AdGroupAsset)

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

adGroupAssetSet

object (AdGroupAssetSet)

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

adGroupAudienceView

object (AdGroupAudienceView)

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

adGroupBidModifier

object (AdGroupBidModifier)

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

adGroupCriterion

object (AdGroupCriterion)

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

adGroupCriterionLabel

object (AdGroupCriterionLabel)

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

adGroupLabel

object (AdGroupLabel)

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

ageRangeView

object (AgeRangeView)

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

asset

object (Asset)

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

assetGroupAsset

object (AssetGroupAsset)

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

assetGroupSignal

object (AssetGroupSignal)

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

assetGroupListingGroupFilter

object (AssetGroupListingGroupFilter)

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

assetGroupTopCombinationView

object (AssetGroupTopCombinationView)

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

assetGroup

object (AssetGroup)

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

assetSetAsset

object (AssetSetAsset)

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

assetSet

object (AssetSet)

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

biddingStrategy

object (BiddingStrategy)

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

campaignBudget

object (CampaignBudget)

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

campaign

object (Campaign)

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

campaignAsset

object (CampaignAsset)

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

campaignAssetSet

object (CampaignAssetSet)

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

campaignAudienceView

object (CampaignAudienceView)

Vue "Audience de la campagne" référencée dans la requête.

campaignCriterion

object (CampaignCriterion)

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

campaignLabel

object (CampaignLabel)

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

cartDataSalesView

object (CartDataSalesView)

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

audience

object (Audience)

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

conversionAction

object (ConversionAction)

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

conversionCustomVariable

object (ConversionCustomVariable)

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

customer

object (Customer)

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

customerAsset

object (CustomerAsset)

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

customerAssetSet

object (CustomerAssetSet)

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

accessibleBiddingStrategy

object (AccessibleBiddingStrategy)

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

customerClient

object (CustomerClient)

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

dynamicSearchAdsSearchTermView

object (DynamicSearchAdsSearchTermView)

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

genderView

object (GenderView)

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

geoTargetConstant

object (GeoTargetConstant)

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

keywordView

object (KeywordView)

Vue de mot clé référencée dans la requête.

label

object (Label)

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

languageConstant

object (LanguageConstant)

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

locationView

object (LocationView)

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

productBiddingCategoryConstant

object (ProductBiddingCategoryConstant)

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

productGroupView

object (ProductGroupView)

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

shoppingPerformanceView

object (ShoppingPerformanceView)

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

userList

object (UserList)

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

webpageView

object (WebpageView)

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

visit

object (Visit)

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

conversion

object (Conversion)

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

metrics

object (Metrics)

Les métriques

segments

object (Segments)

Les segments.

customColumns[]

object (Value)

Colonnes personnalisées

AdGroup

Un groupe d'annonces

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

string

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

customers/{customerId}/adGroups/{ad_group_id}

status

enum (AdGroupStatus)

État du groupe d'annonces.

type

enum (AdGroupType)

Type de groupe d'annonces.

adRotationMode

enum (AdGroupAdRotationMode)

Mode de rotation des annonces du groupe d'annonces.

creationTime

string

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 de ciblage des fonctionnalités associées.

labels[]

string

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

engineId

string

ID du groupe d'annonces dans le compte de moteur externe. Ce champ ne concerne que les comptes autres que Google Ads (par exemple, Yahoo! Japan, Microsoft, Baidu, etc.). Pour une entité Google Ads, utilisez "adGroup.id". à la place.

startDate

string

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

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

endDate

string

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

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

languageCode

string

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

lastModifiedTime

string

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

id

string (int64 format)

Identifiant du groupe d'annonces.

name

string

Nom du groupe d'annonces.

Ce champ est obligatoire. Il ne doit pas être vide lors de la création de groupes d'annonces.

Il doit contenir moins de 255 caractères UTF-8 en pleine largeur.

Il ne doit contenir aucun caractère nul (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD).

cpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupEngineStatus)

État du moteur pour le groupe d'annonces.

AdGroupStatus

États possibles d'un groupe d'annonces.

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

La valeur reçue est inconnue 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 répertoriant les types de groupe d'annonces possibles.

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

La valeur reçue est inconnue dans cette version.

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

SEARCH_STANDARD Type de groupe d'annonces par défaut pour les campagnes sur le Réseau de Recherche.
DISPLAY_STANDARD Type de groupe d'annonces par défaut pour les campagnes display.
SHOPPING_PRODUCT_ADS Type de groupe d'annonces pour les campagnes Shopping diffusant des annonces produit standards.
SHOPPING_SHOWCASE_ADS Type des groupes d'annonces qui se limitent à diffuser des annonces Showcase ou des annonces des marchands dans les résultats Shopping.
HOTEL_ADS Type de groupe d'annonces par défaut pour les campagnes d'hôtel.
SHOPPING_SMART_ADS Type des groupes d'annonces dans les campagnes Shopping intelligentes.
VIDEO_BUMPER Courtes annonces vidéo InStream non désactivables.
VIDEO_TRUE_VIEW_IN_STREAM Les annonces vidéo TrueView InStream (désactivables).
VIDEO_TRUE_VIEW_IN_DISPLAY Les annonces vidéo TrueView InDisplay
VIDEO_NON_SKIPPABLE_IN_STREAM Les annonces vidéo InStream non désactivables.
VIDEO_OUTSTREAM Les annonces vidéo OutStream.
SEARCH_DYNAMIC_ADS Type de groupe d'annonces pour les groupes d'annonces dynamiques du Réseau de Recherche.
SHOPPING_COMPARISON_LISTING_ADS Type des groupes d'annonces dans les campagnes de type "Fiche du service de comparateur de prix".
PROMOTED_HOTEL_ADS Type de groupe d'annonces pour les groupes d'annonces "Hôtels sponsorisés".
VIDEO_RESPONSIVE Groupes d'annonces vidéo responsives.
VIDEO_EFFICIENT_REACH Groupes d'annonces vidéo avec 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 est inconnue dans cette version.

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

OPTIMIZE Optimisez les annonces d'un groupe d'annonces en fonction des clics ou des conversions.
ROTATE_FOREVER Alterner indéfiniment

AdGroupEngineStatus

État du moteur de groupe d'annonces.

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

Obsolète. Ne pas utiliser.

AD_GROUP_EXPIRED Aucune annonce n'est diffusée pour ce groupe d'annonces, car sa date de fin est passée.
AD_GROUP_REMOVED Le groupe d'annonces a été supprimé.
AD_GROUP_DRAFT Aucune annonce n'est diffusée pour ce groupe d'annonces, car le groupe d'annonces associé est encore à l'état de brouillon.
AD_GROUP_PAUSED Le groupe d'annonces a été mis en veille.
AD_GROUP_SERVING Le groupe d'annonces est actif et 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 de ciblage, au niveau de la campagne et du groupe d'annonces. Pour en savoir plus sur le paramètre de ciblage, consultez la page https://support.google.com/google-ads/answer/7365594.

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

object (TargetRestriction)

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

TargetRestriction

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

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

enum (TargetingDimension)

Il s'agit de la dimension de ciblage à laquelle ces paramètres s'appliquent.

bidOnly

boolean

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

TargetingDimension

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

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

AdGroupAd

Annonce d'un groupe d'annonces.

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

string

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

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

status

enum (AdGroupAdStatus)

État de l'annonce.

ad

object (Ad)

L'annonce.

creationTime

string

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

labels[]

string

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

engineId

string

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

engineStatus

enum (AdGroupAdEngineStatus)

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

lastModifiedTime

string

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

AdGroupAdStatus

Les états possibles d'un GroupAd

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

La valeur reçue est inconnue dans cette version.

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

ENABLED L'annonce du groupe d'annonces est activée.
PAUSED L'annonce du groupe d'annonces est mise en veille.
REMOVED L'annonce du groupe d'annonces est supprimée.

AdType

Types d'annonces possibles.

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

La valeur reçue est inconnue dans cette version.

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

TEXT_AD Il s'agit d'une annonce textuelle.
EXPANDED_TEXT_AD Il s'agit d'une annonce textuelle agrandie.
CALL_ONLY_AD Il s'agit d'une annonce Appel uniquement.
EXPANDED_DYNAMIC_SEARCH_AD Il s'agit d'une annonce dynamique agrandie sur le Réseau de Recherche.
HOTEL_AD L'annonce est une annonce d'hôtel.
SHOPPING_SMART_AD Il s'agit d'une annonce Shopping intelligente.
SHOPPING_PRODUCT_AD Il s'agit d'une annonce Shopping standard.
VIDEO_AD Il s'agit d'une annonce vidéo.
GMAIL_AD Cette annonce est une annonce Gmail.
IMAGE_AD Cette annonce est une annonce illustrée.
RESPONSIVE_SEARCH_AD Il s'agit d'une annonce responsive sur le Réseau de Recherche.
LEGACY_RESPONSIVE_DISPLAY_AD L'annonce est une ancienne annonce display responsive.
APP_AD L'annonce est une annonce pour une application.
LEGACY_APP_INSTALL_AD L'annonce est une ancienne annonce incitant à installer une application.
RESPONSIVE_DISPLAY_AD Il s'agit d'une annonce display responsive.
LOCAL_AD Il s'agit d'une annonce locale.
HTML5_UPLOAD_AD Il s'agit d'une annonce display importée avec le type de produit HTML5_UPLOAD_AD.
DYNAMIC_HTML5_AD Il s'agit d'une annonce display importée avec l'un des types de produits DYNAMIC_HTML5_*.
APP_ENGAGEMENT_AD Il s'agit d'une annonce ciblant l'engagement avec une application.
SHOPPING_COMPARISON_LISTING_AD Il s'agit d'une annonce Shopping Fiche du service de comparateur de prix.
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 d'une campagne intelligente.
APP_PRE_REGISTRATION_AD Annonce universelle de préinscription à une application.
DISCOVERY_MULTI_ASSET_AD Annonce Discovery avec plusieurs éléments.
TRAVEL_AD Annonce de voyage.
DISCOVERY_VIDEO_RESPONSIVE_AD Annonce vidéo responsive Discovery.
MULTIMEDIA_AD Annonce multimédia.

SearchAds360TextAdInfo

Annonce textuelle Search Ads 360.

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

string

Titre de l'annonce.

description1

string

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

description2

string

Deuxième ligne de description de l'annonce.

displayUrl

string

URL affichée de l'annonce

displayMobileUrl

string

URL mobile de l'annonce qui s'affiche.

adTrackingId

string (int64 format)

Identifiant de suivi de l'annonce.

SearchAds360ExpandedTextAdInfo

Annonce textuelle agrandie Search Ads 360.

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

string

Titre de l'annonce.

headline2

string

Deuxième titre de l'annonce.

headline3

string

Troisième titre de l'annonce.

description1

string

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

description2

string

Deuxième ligne de description de l'annonce.

path1

string

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

path2

string

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

adTrackingId

string (int64 format)

Identifiant de suivi de l'annonce.

SearchAds360ResponsiveSearchAdInfo

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

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

object (AdTextAsset)

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

descriptions[]

object (AdTextAsset)

Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront 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é au chemin 1 avec un délimiteur.

adTrackingId

string (int64 format)

Identifiant de suivi de l'annonce.

AdTextAsset

Composant texte utilisé dans une annonce.

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

string

Texte de l'élément.

SearchAds360ProductAdInfo

Ce type ne comporte aucun champ.

Annonce produit Search Ads 360.

SearchAds360ExpandedDynamicSearchAdInfo

Annonce dynamique agrandie du Réseau de Recherche.

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

string

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

description2

string

Deuxième ligne de description de l'annonce.

adTrackingId

string (int64 format)

Identifiant de suivi de l'annonce.

AdGroupAdEngineStatus

Énumère les états du moteur GROUPAd.

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

Obsolète. Ne pas utiliser.

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

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

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

AdGroupAdLabel

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

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

string

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

adGroupAd

string

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

label

string

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

AdGroupAsset

Lien entre un groupe d'annonces et un composant.

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

string

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

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

adGroup

string

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

asset

string

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

status

enum (AssetLinkStatus)

État du composant du groupe d'annonces.

AssetLinkStatus

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

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

AdGroupAssetSet

GROUPAssetSet est le lien entre un groupe d'annonces et un ensemble d'assets. La création d'un GroupAssetSet associe un ensemble d'assets à un groupe d'annonces.

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

string

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

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

adGroup

string

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

assetSet

string

Ensemble de composants associé au groupe d'annonces.

status

enum (AssetSetLinkStatus)

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

AssetSetLinkStatus

États possibles de l'association entre l'ensemble de composants et son conteneur.

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

AdGroupAudienceView

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

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

string

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

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

AdGroupBidModifier

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

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

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

string

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

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

bidModifier

number

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

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

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

device

object (DeviceInfo)

Un critère d'appareil.

DeviceInfo

Un critère d'appareil.

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

enum (Device)

Type d'appareil.

Appareil

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

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

AdGroupCriterion

Un critère de groupe d'annonces. Le rapport adGroupCritère ne renvoie que les critères qui ont été explicitement ajoutés au groupe d'annonces.

Représentation JSON
{
  "resourceName": string,
  "creationTime": string,
  "status": enum (AdGroupCriterionStatus),
  "qualityInfo": {
    object (QualityInfo)
  },
  "type": enum (CriterionType),
  "labels": [
    string
  ],
  "positionEstimates": {
    object (PositionEstimates)
  },
  "finalUrls": [
    string
  ],
  "engineId": string,
  "lastModifiedTime": string,
  "criterionId": string,
  "adGroup": string,
  "negative": boolean,
  "bidModifier": number,
  "cpcBidMicros": string,
  "effectiveCpcBidMicros": string,
  "engineStatus": enum (AdGroupCriterionEngineStatus),
  "finalUrlSuffix": string,
  "trackingUrlTemplate": string,

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

string

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

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

creationTime

string

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

status

enum (AdGroupCriterionStatus)

État du critère.

Il s'agit de l'état de l'entité de critère du groupe d'annonces définie par le client. Remarque : Les rapports de l'interface utilisateur peuvent intégrer des informations supplémentaires qui déterminent si un critère peut être exécuté. Dans certains cas, un critère supprimé dans l'API peut encore apparaître comme activé dans l'interface utilisateur. Par exemple, les campagnes par défaut sont diffusées auprès des utilisateurs de toutes les tranches d'âge, sauf si elles sont exclues. Du fait qu'elle peut voir les annonces, l'interface utilisateur affiche chaque tranche d'âge comme étant activée, mais l'état AdGroupCriterion.status indique "supprimée", car aucun critère positif n'a été ajouté.

qualityInfo

object (QualityInfo)

Informations concernant la qualité du critère.

type

enum (CriterionType)

Type du critère.

labels[]

string

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

positionEstimates

object (PositionEstimates)

Estimations pour les enchères des critères à différentes positions.

finalUrls[]

string

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

engineId

string

ID du critère de groupe d'annonces dans le compte de moteur externe. Ce champ ne concerne que les comptes autres que Google Ads (par exemple, Yahoo! Japan, Microsoft, Baidu, etc.). Pour une entité Google Ads, utilisez "adGroupCritère.criterion_id". à la place.

lastModifiedTime

string

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

criterionId

string (int64 format)

ID du critère.

adGroup

string

Groupe d'annonces auquel appartient le critère.

negative

boolean

Permet de cibler (false) ou d'exclure (true) le critère.

Ce champ est immuable. Pour remplacer un critère positif par un critère négatif, supprimez-le, puis ajoutez-le à nouveau.

bidModifier

number

Modificateur de l'enchère lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. La plupart des types de critères pouvant être ciblés sont compatibles avec les modificateurs.

cpcBidMicros

string (int64 format)

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

effectiveCpcBidMicros

string (int64 format)

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

engineStatus

enum (AdGroupCriterionEngineStatus)

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

finalUrlSuffix

string

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

trackingUrlTemplate

string

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

Champ d'union criterion. Le critère du groupe d'annonces.

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

keyword

object (KeywordInfo)

Mot clé.

listingGroup

object (ListingGroupInfo)

Groupe de fiches.

ageRange

object (AgeRangeInfo)

Tranche d'âge.

gender

object (GenderInfo)

Gender.

userList

object (UserListInfo)

Liste d'utilisateurs.

webpage

object (WebpageInfo)

Page Web

location

object (LocationInfo)

Localisation.

AdGroupCriterionStatus

États possibles d'un critère Critères.

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

La valeur reçue est inconnue dans cette version.

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

ENABLED Le critère du groupe d'annonces est activé.
PAUSED Le critère du groupe d'annonces a été mis en veille.
REMOVED Le critère du groupe d'annonces est supprimé.

QualityInfo

Conteneur pour les informations sur la qualité du critère de groupe d'annonces.

Représentation JSON
{
  "qualityScore": integer
}
Champs
qualityScore

integer

Le niveau de qualité.

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

CriterionType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
KEYWORD Mot clé (par exemple, "croisière sur mars").
PLACEMENT Emplacement, également appelé site Web (par exemple, "www.fleurs4soldes.com")
MOBILE_APP_CATEGORY Catégories d'applications mobiles à cibler.
MOBILE_APPLICATION Applications mobiles à cibler.
DEVICE Appareils à cibler.
LOCATION Zones géographiques à cibler.
LISTING_GROUP Groupes de fiches à cibler.
AD_SCHEDULE Calendrier de diffusion des annonces.
AGE_RANGE Tranche d'âge.
GENDER Gender.
INCOME_RANGE Plage de revenus.
PARENTAL_STATUS Statut parental.
YOUTUBE_VIDEO Vidéo YouTube.
YOUTUBE_CHANNEL Chaîne YouTube.
USER_LIST Liste d'utilisateurs.
PROXIMITY Proximité.
TOPIC Un thème ciblé sur le Réseau Display (par exemple, "Animaux et animaux de compagnie").
LISTING_SCOPE Champ d'application de la liste à cibler.
LANGUAGE HashiCorp.
IP_BLOCK IpBlock.
CONTENT_LABEL Libellé de contenu pour l'exclusion de catégories.
CARRIER Opérateur.
USER_INTEREST Catégorie qui intéresse l'utilisateur.
WEBPAGE Critère de page Web pour les annonces dynamiques du Réseau de Recherche.
OPERATING_SYSTEM_VERSION La version du système d'exploitation.
APP_PAYMENT_MODEL Modèle de paiement de l'application.
MOBILE_DEVICE Appareil mobile
CUSTOM_AFFINITY Audience d'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 mots clés de la 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 des critères à différentes positions.

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

string (int64 format)

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

AdGroupCriterionEngineStatus

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente 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 qualité trop faible pour être affichée
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME Baidu: mis en veille par Baidu en raison du faible volume de recherche.
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW Baidu: URL mobile en cours d'examen.
AD_GROUP_CRITERION_PARTIALLY_INVALID Baidu: la page de destination d'un appareil n'est pas valide, tandis que celle de l'autre appareil est valide.
AD_GROUP_CRITERION_TO_BE_ACTIVATED Baidu: le mot clé a été créé et mis en veille par l'équipe de gestion du compte Baidu, et 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 en cours de diffusion.
AD_GROUP_CRITERION_ACCOUNT_PAUSED Le critère a été mis en veille, car le compte a été mis en veille.

KeywordInfo

Un critère de mot clé.

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

enum (KeywordMatchType)

Type de correspondance du mot clé.

text

string

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

KeywordMatchType

Types de correspondance des mots clés possibles.

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

ListingGroupInfo

Critère du groupe de fiches.

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

enum (ListingGroupType)

Type du groupe de fiches.

ListingGroupType

Type du groupe de fiches.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SUBDIVISION Subdivision des produits selon une dimension de fiche. Ces nœuds ne servent pas à cibler des entrées de liste, mais servent uniquement à définir la structure de l'arborescence.
UNIT Unité de groupe de fiches qui définit une enchère.

AgeRangeInfo

Un critère de tranche d'âge.

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

enum (AgeRangeType)

Type de tranche d'âge.

AgeRangeType

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

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

GenderInfo

Un critère de genre.

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

enum (GenderType)

Type de genre.

GenderType

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

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

UserListInfo

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

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

string

Nom de laressource de la liste d'utilisateurs.

WebpageInfo

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

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

object (WebpageConditionInfo)

Conditions ou expressions logiques pour le ciblage de pages Web. La liste des conditions de ciblage des pages Web est combinée lorsqu'elle est évaluée lors du ciblage. Une liste de conditions vide indique que toutes les pages du site Web de la campagne sont ciblées.

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

coveragePercentage

number

Pourcentage de couverture des critères de site Web. Il s'agit du pourcentage calculé de couverture de site Web en fonction de la cible de site Web, de la cible de site Web à exclure et des mots clés à exclure dans le groupe d'annonces et la campagne. Par exemple, lorsque la couverture est égale à 1, la couverture est de 100 %. Ce champ est en lecture seule.

criterionName

string

Nom du critère défini par ce paramètre. La valeur "name" sera utilisée pour identifier, trier et filtrer les critères avec ce type de paramètres.

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

WebpageConditionInfo

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

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

enum (WebpageConditionOperand)

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

operator

enum (WebpageConditionOperator)

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

argument

string

Argument de la condition de ciblage 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é pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
URL Opérande indiquant une condition de ciblage par URL de page Web.
CATEGORY Opérande indiquant une condition de ciblage par catégorie de page Web.
PAGE_TITLE Opérande indiquant une condition de ciblage par titre de page Web.
PAGE_CONTENT Opérande indiquant une condition de ciblage par contenu d'une page Web.
CUSTOM_LABEL Opérande indiquant une condition de ciblage par étiquette personnalisée de page Web.

WebpageConditionOperator

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

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

LocationInfo

Un critère géographique.

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

string

Nom de la ressource constante de ciblage géographique.

AdGroupCriterionLabel

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

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

string

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

adGroupCriterion

string

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

label

string

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

AdGroupLabel

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

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

string

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

adGroup

string

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

label

string

Libellé attribué au groupe d'annonces.

AgeRangeView

Vue par tranche d'âge.

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

string

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

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

Élément

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

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

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

string

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

customers/{customerId}/assets/{assetId}

type

enum (AssetType)

Type de l'asset.

finalUrls[]

string

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

status

enum (AssetStatus)

État de l'élément.

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

ID de l'élément.

name

string

Nom facultatif de l'élément.

trackingUrlTemplate

string

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

engineStatus

enum (AssetEngineStatus)

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

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

object (YoutubeVideoAsset)

Une vidéo YouTube.

imageAsset

object (ImageAsset)

Un composant Image.

textAsset

object (TextAsset)

Un composant texte.

calloutAsset

object (UnifiedCalloutAsset)

Composant Accroche unifié.

pageFeedAsset

object (UnifiedPageFeedAsset)

Élément de flux de pages unifié.

mobileAppAsset

object (MobileAppAsset)

Un composant Application mobile.

callAsset

object (UnifiedCallAsset)

Un composant Appel unifié

callToActionAsset

object (CallToActionAsset)

Un composant Incitation à l'action.

locationAsset

object (UnifiedLocationAsset)

Composant Lieu unifié.

AssetType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
YOUTUBE_VIDEO élément vidéo YouTube.
MEDIA_BUNDLE Élément du kit média.
IMAGE Composant Image.
TEXT Composant texte.
LEAD_FORM Composant Formulaire pour prospects.
BOOK_ON_GOOGLE Asset Réserver sur Google.
PROMOTION Composant Promotion.
CALLOUT Un composant Accroche.
STRUCTURED_SNIPPET Composant Extrait structuré.
PAGE_FEED un élément de flux de pages.
DYNAMIC_EDUCATION Asset dynamique pour l'enseignement.
MOBILE_APP Composant Application mobile.
HOTEL_CALLOUT Composant Accroche pour hôtel.
CALL Un composant Appel.
PRICE Composant Prix.
CALL_TO_ACTION Composant Incitation à l'action.
DYNAMIC_REAL_ESTATE Asset immobilier dynamique.
DYNAMIC_CUSTOM Élément 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 d'établissement hôtelier.

AssetStatus

États possibles d'un composant.

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

AssetEngineStatus

Identifiant suivant = 11

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

YoutubeVideoAsset

Un élément YouTube.

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

string

Titre de la vidéo YouTube.

youtubeVideoId

string

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

ImageAsset

Un composant Image.

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

enum (MimeType)

Type MIME du composant Image.

fullSize

object (ImageDimension)

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

fileSize

string (int64 format)

Taille du fichier de l'élément image en octets.

MimeType

Type MIME

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

La valeur reçue est inconnue 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/gif.
IMAGE_PNG Type MIME de l'image/png.
FLASH Type MIME de l'application/x-shockwave-flash.
TEXT_HTML Type MIME du texte/html.
PDF Type MIME de l'application/pdf.
MSWORD Type MIME de l'application/msword.
MSEXCEL Type MIME de l'application/vnd.ms-excel.
RTF Type MIME de l'application/rtf.
AUDIO_WAV Type MIME de l'audio/wav.
AUDIO_MP3 Type MIME de l'audio/mp3.
HTML5_AD_ZIP Type MIME de l'application/x-html5-ad-zip.

ImageDimension

Métadonnées d'une image dans une certaine taille, qu'elle soit d'origine ou redimensionnée.

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

string (int64 format)

Hauteur de l'image.

widthPixels

string (int64 format)

Largeur de l'image.

url

string

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

TextAsset

Un composant texte.

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

string

Contenu texte de l'asset texte.

UnifiedCalloutAsset

Composant Accroche unifié.

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

string

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

startDate

string

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

endDate

string

Date à laquelle cet élément entre en vigueur et diffuse actuellement des annonces, au format aaaa-MM-jj.

adScheduleTargets[]

object (AdScheduleInfo)

Liste de calendriers de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Il peut y avoir jusqu'à six programmations par jour, soit 42 au total.

useSearcherTimeZone

boolean

Permet d'afficher ou non l'élément dans le fuseau horaire de l'utilisateur associé à la recherche. S'applique à Microsoft Ads.

AdScheduleInfo

Représente un critère AdSchedule.

Le paramètre "AdSchedule" correspond au jour de la semaine et à l'intervalle de temps au cours duquel les annonces seront diffusées.

Vous ne pouvez pas ajouter plus de six calendriers de diffusion pour le même jour.

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

enum (MinuteOfHour)

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

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

endMinute

enum (MinuteOfHour)

Minutes après l'heure de fin à laquelle cette programmation se termine. Le calendrier n'inclut pas la minute de fin.

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

dayOfWeek

enum (DayOfWeek)

Jour de la semaine auquel le calendrier s'applique.

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

startHour

integer

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

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

endHour

integer

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

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

MinuteOfHour

Énumération des quarts d'heure. Exemple : "FIFTEEN"

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

DayOfWeek

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

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

UnifiedSitelinkAsset

Composant Lien annexe unifié.

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

string

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

description2

string

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

startDate

string

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

endDate

string

Date à laquelle cet élément entre en vigueur et diffuse actuellement des annonces, au format aaaa-MM-jj.

adScheduleTargets[]

object (AdScheduleInfo)

Liste de calendriers de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Il peut y avoir jusqu'à six programmations 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! Japan uniquement.

useSearcherTimeZone

boolean

Permet d'afficher ou non le composant Lien annexe dans le fuseau horaire de l'utilisateur associé à la recherche. S'applique à Microsoft Ads.

mobilePreferred

boolean

Indique si le composant Lien annexe s'affiche sur les appareils mobiles ou non. S'applique à Microsoft Ads.

UnifiedPageFeedAsset

Élément de flux de pages unifié.

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

string

La page Web que les annonceurs souhaitent cibler.

labels[]

string

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

MobileAppAsset

Asset représentant une application mobile.

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

string

Obligatoire. Chaîne qui identifie de manière unique une application mobile. Il doit simplement contenir l'ID natif de la plate-forme, par exemple "com.android.ebay". pour Android ou "12345689" pour iOS.

appStore

enum (MobileAppVendor)

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

MobileAppVendor

Le type de fournisseur de l'application mobile

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

UnifiedCallAsset

Un composant Appel unifié

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

string

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

phoneNumber

string

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

callConversionReportingState

enum (CallConversionReportingState)

Indique si cet élément CallAsset doit utiliser son propre paramètre de conversion par appel, suivre le paramètre au niveau du compte ou désactiver la conversion par appel.

callConversionAction

string

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

adScheduleTargets[]

object (AdScheduleInfo)

Liste de calendriers de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Il peut y avoir jusqu'à six programmations par jour, soit 42 au total.

callOnly

boolean

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

callTrackingEnabled

boolean

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

useSearcherTimeZone

boolean

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

startDate

string

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

endDate

string

Date à laquelle cet élément entre en vigueur et diffuse actuellement des annonces, au format aaaa-MM-jj.

CallConversionReportingState

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

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

CallToActionAsset

Un composant Incitation à l'action.

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

enum (CallToActionType)

Incitation à l'action.

CallToActionType

Énumération décrivant les types possibles d'incitations à l'action.

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

UnifiedLocationAsset

Composant Lieu unifié.

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

string

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

businessProfileLocations[]

object (BusinessProfileLocation)

Liste des établissements du client. Cette information ne s'affiche que si le composant Lieu est synchronisé à partir du compte de la fiche d'établissement. Plusieurs fiches d'établissement d'un même compte peuvent renvoyer vers le même ID de lieu.

locationOwnershipType

enum (LocationOwnershipType)

Type de propriété de l'établissement. Si le type est BUSINESS_OWNER, il sera diffusé en tant qu'extension de lieu. S'il est de type 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 fiches d'établissement associé.

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

string

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

storeCode

string

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

listingId

string (int64 format)

ID de la fiche de cet établissement. Ces informations sont synchronisées à partir du compte de fiche d'établissement associé.

LocationOwnershipType

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

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

AssetGroupAsset

AssetGroupAsset est le lien entre un élément et un groupe d'assets. L'ajout d'un AssetGroupAsset associe un asset à un groupe d'assets.

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

string

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

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

assetGroup

string

Groupe d'assets auquel cet asset est associé.

asset

string

Asset auquel ce composant du groupe d'assets est associé.

fieldType

enum (AssetFieldType)

Description de l'emplacement de l'asset dans le groupe d'assets. Par exemple: HEADLINE, YOUTUBE_VIDEO, etc.

status

enum (AssetLinkStatus)

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

AssetFieldType

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

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

AssetGroupSignal

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

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

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

string

Nom de ressource du signal du groupe d'assets. Le nom de la ressource du signal de groupe d'assets se présente comme suit:

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

assetGroup

string

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

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

object (AudienceInfo)

Signal d'audience que la campagne Performance Max doit utiliser.

AudienceInfo

Un 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 filtres pour un groupe de fiches dans un groupe d'assets.

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

string

Nom de ressource du filtre de groupe de fiches (groupe d'assets). Le nom de la ressource du filtre de groupe de fiches du groupe d'assets se présente comme suit:

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

assetGroup

string

Groupe d'assets auquel ce filtre de groupe de fiches de groupe d'assets fait partie.

id

string (int64 format)

ID de ListingGroupFilter.

type

enum (ListingGroupFilterType)

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

vertical

enum (ListingGroupFilterVertical)

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

caseValue

object (ListingGroupFilterDimension)

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

parentListingGroupFilter

string

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

path

object (ListingGroupFilterDimensionPath)

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

ListingGroupFilterType

Type de filtre de groupe de fiches.

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

ListingGroupFilterVertical

Type de secteur du filtre de groupes de fiches.

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

ListingGroupFilterDimension

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

Représentation JSON
{

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

object (ProductBiddingCategory)

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

productBrand

object (ProductBrand)

Marque d'une offre de produit.

productChannel

object (ProductChannel)

Localité d'une offre de produit.

productCondition

object (ProductCondition)

Condition d'une offre de produit.

productCustomAttribute

object (ProductCustomAttribute)

Attribut personnalisé d'une offre de produit.

productItemId

object (ProductItemId)

Identifiant de l'article d'une offre.

productType

object (ProductType)

Type d'une offre de produit.

ProductBiddingCategory

Un élément d'une catégorie d'enchères à un certain niveau. Les catégories de niveau supérieur se situent au niveau 1, les enfants au niveau 2, etc. Pour le moment, nous acceptons jusqu'à cinq niveaux. L'utilisateur doit spécifier un type de dimension qui indique le niveau de la catégorie. Tous les cas de la même subdivision doivent être associés au même type de dimension (au niveau de la catégorie).

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

enum (ListingGroupFilterBiddingCategoryLevel)

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

id

string (int64 format)

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

Cet identifiant correspond à l'identifiant "google_product_category" décrit dans cet article: https://support.google.com/merchants/answer/6324436.

ListingGroupFilterBiddingCategoryLevel

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

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

ProductBrand

Marque du produit.

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

string

Valeur de chaîne de la marque du produit.

ProductChannel

Localité d'une offre de produit.

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

enum (ListingGroupFilterProductChannel)

Valeur de la localité.

ListingGroupFilterProductChannel

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

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

ProductCondition

Condition d'une offre de produit.

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

enum (ListingGroupFilterProductCondition)

Valeur de la condition.

ListingGroupFilterProductCondition

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

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

ProductCustomAttribute

Attribut personnalisé d'une offre de produit.

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

enum (ListingGroupFilterCustomAttributeIndex)

Indique l'index de l'attribut personnalisé.

value

string

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

ListingGroupFilterCustomAttributeIndex

Index des attributs du client.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
INDEX0 Premier attribut personnalisé du filtre de groupe de fiches.
INDEX1 Deuxième attribut personnalisé 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 Attribut personnalisé de cinquième filtre de groupe de fiches.

ProductItemId

Identifiant de l'article d'une offre.

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

string

Valeur de l'identifiant.

ProductType

Type d'une offre de produit.

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

enum (ListingGroupFilterProductTypeLevel)

Niveau du type.

value

string

Valeur du type.

ListingGroupFilterProductTypeLevel

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

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

ListingGroupFilterDimensionPath

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

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

object (ListingGroupFilterDimension)

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

AssetGroupTopCombinationView

Vue sur l'utilisation d'une combinaison de composants d'annonce d'un groupe d'annonces.

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

string

Nom de ressource de la vue des combinaisons principales du groupe d'assets. Les noms des ressources de la vue des combinaisons principales AssetGroup ont le format suivant : "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".

assetGroupTopCombinations[]

object (AssetGroupAssetCombinationData)

Meilleures combinaisons d'assets diffusés ensemble.

AssetGroupAssetCombinationData

Données sur les combinaisons de composants du groupe d'assets

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

object (AssetUsage)

Éléments diffusés.

AssetUsage

Contient les informations sur l'utilisation de l'asset.

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

string

Nom de ressource de l'élément.

servedAssetFieldType

enum (ServedAssetFieldType)

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

ServedAssetFieldType

Types de champs d'éléments possibles.

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

La valeur reçue est inconnue dans cette version.

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

HEADLINE_1 Il est utilisé dans le titre 1.
HEADLINE_2 Il est utilisé dans le titre 2.
HEADLINE_3 Il est utilisé dans le titre 3.
DESCRIPTION_1 Il est utilisé dans la description 1.
DESCRIPTION_2 Il est utilisé dans la description 2.
HEADLINE L'asset a été utilisé dans un titre. N'utilisez cette option que s'il n'y a qu'un seul titre dans l'annonce. Sinon, utilisez les énumérations HEADLINE_1, HEADLINE_2 ou HEADLINE_3.
HEADLINE_IN_PORTRAIT L'asset a été utilisé comme titre dans l'image en mode portrait.
LONG_HEADLINE L'élément a été utilisé dans un titre long (utilisé dans une annonce responsive multi-élément).
DESCRIPTION L'asset a été utilisé dans une description. N'utilisez cette option que s'il n'y a qu'une seule description dans l'annonce. Sinon, utilisez les énumérations DESCRIPTION_1 ou DESCRIPTION_@.
DESCRIPTION_IN_PORTRAIT L'asset a été utilisé comme description dans l'image en mode portrait.
BUSINESS_NAME_IN_PORTRAIT L'asset a été utilisé comme nom de l'entreprise dans l'image en mode portrait.
BUSINESS_NAME Le composant a été utilisé comme nom de l'entreprise.
MARKETING_IMAGE L'asset a été utilisé comme image marketing.
MARKETING_IMAGE_IN_PORTRAIT L'asset a été utilisé comme image marketing en mode portrait.
SQUARE_MARKETING_IMAGE L'asset a été utilisé comme image marketing carrée.
PORTRAIT_MARKETING_IMAGE L'asset a été utilisé en tant qu'image marketing en mode portrait.
CALL_TO_ACTION Le composant a été utilisé comme incitation à l'action.
YOU_TUBE_VIDEO L'élément a été utilisé en tant que 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é en tant que promotion.
AD_IMAGE Cet asset est utilisé en tant qu'image.
LEAD_FORM Le composant est utilisé comme formulaire pour prospects.

AssetGroup

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

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

string

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

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é. Asset associé au groupe d'assets.

name

string

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

finalUrls[]

string

Liste des URL finales après toutes les redirections vers un autre domaine. Dans Performance Max, les URL peuvent être étendues par défaut, sauf si vous désactivez cette fonctionnalité.

finalMobileUrls[]

string

Liste des URL finales pour mobile après toutes les redirections vers un autre domaine. Dans Performance Max, les URL peuvent être étendues par défaut, sauf si vous désactivez cette fonctionnalité.

status

enum (AssetGroupStatus)

État du groupe d'assets.

path1

string

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

path2

string

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

adStrength

enum (AdStrength)

Efficacité globale de l'annonce de ce groupe d'assets.

AssetGroupStatus

États possibles d'un groupe d'assets.

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

AdStrength

Énumération listant les forces possibles de l'annonce.

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

AssetSetAsset

AssetSetAsset est le lien entre un élément et un ensemble d'éléments. En ajoutant un élément AssetSetAsset, vous associez 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'éléments. Les noms de ressources d'éléments de l'ensemble d'éléments se présentent comme suit:

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

assetSet

string

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

asset

string

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

status

enum (AssetSetAssetStatus)

État de l'élément de l'ensemble d'assets. En lecture seule.

AssetSetAssetStatus

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

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

AssetSet

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

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

string (int64 format)

ID de l'ensemble d'éléments.

resourceName

string

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

customers/{customerId}/assetSets/{asset_set_id}

BiddingStrategy

Une stratégie d'enchères.

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

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

string

Nom de ressource de la stratégie d'enchères. Les noms de ressources de stratégie d'enchères se présentent comme suit:

customers/{customerId}/biddingStrategies/{bidding_strategy_id}

status

enum (BiddingStrategyStatus)

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

Ce champ est en lecture seule.

type

enum (BiddingStrategyType)

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

Ce champ est en lecture seule.

currencyCode

string

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

Pour les stratégies d'enchères des clients administrateur, cette devise peut être définie lors de la création. Elle est définie par défaut sur celle du client administrateur. Pour les clients de livraison, ce champ ne peut pas être défini. toutes les stratégies d'un client actif utilisent implicitement la devise de ce client. Dans tous les cas, le champ effectiveCurrencyCode affiche la devise utilisée par la stratégie.

id

string (int64 format)

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

name

string

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

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

effectiveCurrencyCode

string

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

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

Les métriques de stratégie d'enchères sont enregistré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. Le schéma d'enchères

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

enhancedCpc

object (EnhancedCpc)

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

maximizeConversionValue

object (MaximizeConversionValue)

Stratégie d'enchères automatiques qui vous permet d'enregistrer la plus grande valeur de conversion pour vos campagnes tout en exploitant la totalité de votre budget.

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

Il s'agit d'une 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 spécifiez.

targetImpressionShare

object (TargetImpressionShare)

Il s'agit d'une stratégie d'enchères qui optimise automatiquement les enchères en fonction d'un pourcentage donné d'impressions.

targetOutrankShare

object (TargetOutrankShare)

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

targetRoas

object (TargetRoas)

Il s'agit d'une stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen spécifique.

targetSpend

object (TargetSpend)

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

BiddingStrategyStatus

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

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

La valeur reçue est inconnue dans cette version.

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

ENABLED La stratégie d'enchères est activée.
REMOVED La stratégie d'enchères est supprimée.

BiddingStrategyType

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

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

EnhancedCpc

Ce type ne comporte aucun champ.

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

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 des fonctionnalités équivalentes.

MaximizeConversionValue

Stratégie d'enchères automatiques qui vous permet d'enregistrer la plus grande valeur de conversion pour vos campagnes tout en exploitant la totalité de votre budget.

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

string (int64 format)

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. La limite s'applique à tous les mots clés gérés par la stratégie. Cette valeur ne peut être modifiée 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. Cette valeur ne peut être modifiée que pour les stratégies de portefeuille d'enchères.

targetRoas

number

L'option de retour sur les dépenses publicitaires (ROAS) cible. Si cette valeur est définie, la stratégie d'enchères maximise les revenus tout en atteignant le ROAS cible moyen. Si le ROAS cible est élevé, la stratégie d'enchères risque de ne pas pouvoir dépenser la totalité du budget. Si aucun ROAS cible n'est défini, la stratégie d'enchères s'efforce d'atteindre le ROAS le plus élevé possible en fonction du budget.

MaximizeConversions

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

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. Cette valeur ne peut être modifiée 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. Cette valeur ne peut être modifiée que pour les stratégies de portefeuille d'enchères.

targetCpaMicros

string (int64 format)

L'option "Coût par action (CPA) cible". Il s'agit du montant moyen que vous souhaitez dépenser pour chaque action de conversion spécifiée en micro-unités de la devise de la stratégie d'enchères. Si cette valeur 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-ci. Si aucun CPA cible n'est défini, la stratégie d'enchères tente d'atteindre le CPA le plus faible possible en fonction du budget.

TargetCpa

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetImpressionShareLocation

Énumération décrivant les objectifs possibles.

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

TargetOutrankShare

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

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

string (Int64Value format)

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

TargetRoas

Il s'agit d'une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen spécifique.

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

number

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

cpcBidCeilingMicros

string (int64 format)

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

cpcBidFloorMicros

string (int64 format)

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

TargetSpend

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

CampaignBudget

Un budget de campagne.

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

string

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

customers/{customerId}/campaignBudgets/{campaign_budget_id}

deliveryMethod

enum (BudgetDeliveryMethod)

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

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

period

enum (BudgetPeriod)

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

amountMicros

string (int64 format)

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

BudgetDeliveryMethod

Modes de diffusion possibles d'un budget.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
STANDARD Le serveur du budget limitera la diffusion de manière uniforme sur l'ensemble de la période.
ACCELERATED Le serveur du 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é pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DAILY Budget quotidien.
FIXED_DAILY Budget quotidien fixe.
CUSTOM_PERIOD Vous pouvez utiliser un budget personnalisé avec "total_amount" pour spécifier la limite de budget pour 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)
  },
  "labels": [
    string
  ],
  "biddingStrategyType": enum (BiddingStrategyType),
  "accessibleBiddingStrategy": string,
  "frequencyCaps": [
    {
      object (FrequencyCapEntry)
    }
  ],
  "selectiveOptimization": {
    object (SelectiveOptimization)
  },
  "optimizationGoalSetting": {
    object (OptimizationGoalSetting)
  },
  "trackingSetting": {
    object (TrackingSetting)
  },
  "engineId": string,
  "excludedParentAssetFieldTypes": [
    enum (AssetFieldType)
  ],
  "createTime": string,
  "creationTime": string,
  "lastModifiedTime": string,
  "id": string,
  "name": string,
  "trackingUrlTemplate": string,
  "campaignBudget": string,
  "startDate": string,
  "endDate": string,
  "finalUrlSuffix": string,
  "urlExpansionOptOut": boolean,

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

string

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

customers/{customerId}/campaigns/{campaign_id}

status

enum (CampaignStatus)

État de la campagne.

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

servingStatus

enum (CampaignServingStatus)

État de diffusion des annonces de la campagne.

biddingStrategySystemStatus

enum (BiddingStrategySystemStatus)

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

adServingOptimizationStatus

enum (AdServingOptimizationStatus)

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

advertisingChannelType

enum (AdvertisingChannelType)

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

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

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

advertisingChannelSubType

enum (AdvertisingChannelSubType)

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

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

urlCustomParameters[]

object (CustomParameter)

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

realTimeBiddingSetting

object (RealTimeBiddingSetting)

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

networkSettings

object (NetworkSettings)

Paramètres des réseaux de la campagne.

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.

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 définir soit le schéma d'enchères pour créer une stratégie d'enchères standard, soit le champ biddingStrategy pour créer une stratégie de portefeuille d'enchères.

Ce champ est en lecture seule.

accessibleBiddingStrategy

string

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

frequencyCaps[]

object (FrequencyCapEntry)

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

selectiveOptimization

object (SelectiveOptimization)

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

optimizationGoalSetting

object (OptimizationGoalSetting)

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

trackingSetting

object (TrackingSetting)

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'asset avec ces types de champs ne seront pas hérités par cette campagne à partir du niveau supérieur.

createTime

string

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

creationTime

string

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

lastModifiedTime

string

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

id

string (int64 format)

Identifiant de la campagne.

name

string

Nom de la campagne.

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

Il ne doit contenir aucun caractère nul (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD).

trackingUrlTemplate

string

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

campaignBudget

string

Budget de la campagne.

startDate

string

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

endDate

string

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

finalUrlSuffix

string

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

urlExpansionOptOut

boolean

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

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

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

biddingStrategy

string

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

manualCpa

object (ManualCpa)

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

manualCpc

object (ManualCpc)

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

manualCpm

object (ManualCpm)

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

maximizeConversions

object (MaximizeConversions)

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

maximizeConversionValue

object (MaximizeConversionValue)

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

targetCpa

object (TargetCpa)

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

targetImpressionShare

object (TargetImpressionShare)

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

targetRoas

object (TargetRoas)

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

targetSpend

object (TargetSpend)

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

percentCpc

object (PercentCpc)

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

targetCpm

object (TargetCpm)

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

CampaignStatus

États possibles d'une campagne.

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

CampaignServingStatus

États de diffusion possibles d'une campagne.

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

La valeur reçue est inconnue dans cette version.

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

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

BiddingStrategySystemStatus

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

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

AdServingOptimizationStatus

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

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

La valeur reçue est inconnue dans cette version.

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

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

AdvertisingChannelType

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

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

AdvertisingChannelSubType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisée uniquement comme valeur renvoyée. Représente une valeur inconnue dans cette version.
SEARCH_MOBILE_APP Campagnes pour applications mobiles pour le Réseau de Recherche
DISPLAY_MOBILE_APP Campagnes pour applications mobiles pour le Réseau Display
SEARCH_EXPRESS Campagnes AdWords Express pour le Réseau de Recherche
DISPLAY_EXPRESS des campagnes AdWords Express pour le Réseau Display.
SHOPPING_SMART_ADS les campagnes Shopping intelligentes.
DISPLAY_GMAIL_AD Campagnes d'annonces Gmail.
DISPLAY_SMART_CAMPAIGN Campagnes intelligentes sur le Réseau Display : Impossible de créer des campagnes de ce sous-type.
VIDEO_OUTSTREAM les campagnes vidéo OutStream.
VIDEO_ACTION les campagnes vidéo TrueView pour l'action.
VIDEO_NON_SKIPPABLE Les campagnes vidéo comportant des annonces vidéo non désactivables.
APP_CAMPAIGN Les campagnes pour applications vous permettent de promouvoir facilement votre application Android ou iOS sur les principales propriétés de Google, dont le Réseau de Recherche, Google Play, YouTube et le Réseau Display de Google.
APP_CAMPAIGN_FOR_ENGAGEMENT Campagne pour applications axée sur l'engagement visant à susciter un nouvel intérêt pour votre 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 dans la publicité locale.
SHOPPING_COMPARISON_LISTING_ADS Campagnes de type "Fiche du service de comparateur de prix"
SMART_CAMPAIGN les campagnes intelligentes standards.
VIDEO_SEQUENCE Campagnes vidéo avec des annonces vidéo de séquencement
APP_CAMPAIGN_FOR_PRE_REGISTRATION Campagne pour applications axée sur la 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 une stratégie d'enchères avec fréquence cible
TRAVEL_ACTIVITIES Activités de voyage.
SOCIAL_FACEBOOK_TRACKING_ONLY Suivi Facebook uniquement pour les campagnes sur les réseaux sociaux.

CustomParameter

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

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

string

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

value

string

Valeur à remplacer.

RealTimeBiddingSetting

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

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

boolean

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

NetworkSettings

Paramètres des réseaux de la campagne.

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

boolean

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

targetContentNetwork

boolean

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

targetPartnerSearchNetwork

boolean

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

DynamicSearchAdsSetting

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

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

string

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

languageCode

string

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

useSuppliedUrlsOnly

boolean

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

ShoppingSetting

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

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

string

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

useVehicleInventory

boolean

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

merchantId

string (int64 format)

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

salesCountry

string

Pays de vente des produits à inclure dans la campagne.

campaignPriority

integer

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

enableLocal

boolean

Permet d'inclure ou non les produits en magasin.

GeoTargetTypeSetting

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

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

enum (PositiveGeoTargetType)

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

negativeGeoTargetType

enum (NegativeGeoTargetType)

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

PositiveGeoTargetType

Types de cibles géographiques à inclure possibles.

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

NegativeGeoTargetType

Types de cibles géographiques à exclure possibles.

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

FrequencyCapEntry

Ce type ne comporte aucun champ.

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

SelectiveOptimization

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

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

string

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

OptimizationGoalSetting

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

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

enum (OptimizationGoalType)

Liste des types d'objectifs d'optimisation.

OptimizationGoalType

Type d'objectif d'optimisation

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

TrackingSetting

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

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

string

URL utilisée pour le suivi dynamique.

ManualCpa

Ce type ne comporte aucun champ.

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

ManualCpc

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

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

boolean

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

ManualCpm

Ce type ne comporte aucun champ.

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

PercentCpc

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

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

string (int64 format)

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

enhancedCpcEnabled

boolean

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

TargetCpm

Ce type ne comporte aucun champ.

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

CampaignAsset

Lien entre une campagne et un élément.

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

string

Nom de ressource du composant de campagne. Les noms de ressources CampaignAsset sont au format suivant:

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

status

enum (AssetLinkStatus)

État du composant de la campagne.

campaign

string

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

asset

string

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

CampaignAssetSet

CampaignAssetSet est le lien entre une campagne et un ensemble d'assets. L'ajout d'un CampaignAssetSet associe un ensemble d'éléments à une campagne.

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

string

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

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

campaign

string

Campagne à laquelle cet ensemble de composants est associé.

assetSet

string

Ensemble de composants associé à la campagne.

status

enum (AssetSetLinkStatus)

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

CampaignAudienceView

Vue d'audience d'une campagne. Comprend les données sur les performances issues des centres d'intérêt et des listes de remarketing pour les annonces sur les Réseaux Display et YouTube, et des listes de remarketing pour les annonces du Réseau de Recherche (RLSA), regroupé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 d'audience de la campagne. Les noms des ressources de vue d'audience de la campagne se présentent comme suit:

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

CampaignCriterion

Un critère de campagne.

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

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

string

Nom de ressource du critère de campagne. Les noms de ressources 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 opérations mutate.

type

enum (CriterionType)

Type du critère.

status

enum (CampaignCriterionStatus)

État du critère.

lastModifiedTime

string

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

criterionId

string (int64 format)

ID du critère.

Ce champ est ignoré lors de l'opération mutate.

bidModifier

number

Modificateur des enchères lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. La plupart des types de critères pouvant être ciblés sont compatibles avec les modificateurs. Indiquez 0 pour désactiver un type d'appareil.

negative

boolean

Permet de cibler (false) ou d'exclure (true) le critère.

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

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

keyword

object (KeywordInfo)

Mot clé.

location

object (LocationInfo)

Localisation.

device

object (DeviceInfo)

appareil.

ageRange

object (AgeRangeInfo)

Tranche d'âge.

gender

object (GenderInfo)

Gender.

userList

object (UserListInfo)

Liste d'utilisateurs.

language

object (LanguageInfo)

HashiCorp.

webpage

object (WebpageInfo)

Page Web.

locationGroup

object (LocationGroupInfo)

Groupe de zones géographiques

CampaignCriterionStatus

États possibles d'un "CampaignCritère".

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

La valeur reçue est inconnue dans cette version.

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

ENABLED Le critère de campagne est activé.
PAUSED Le critère de campagne est mis en veille.
REMOVED Le critère de la campagne est supprimé.

LanguageInfo

Un critère de langue.

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

string

Nom de ressource de la constante de langue.

LocationGroupInfo

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

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

string

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

radiusUnits

enum (LocationGroupRadiusUnits)

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

feedItemSets[]

string

Ensembles d'éléments de flux dont les éléments de flux sont ciblés. Si plusieurs identifiants 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. Cette étape est facultative et ne peut être définie que dans les opérations CREATE.

radius

string (int64 format)

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

LocationGroupRadiusUnits

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

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

CampaignLabel

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

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

string

Nom de la ressource. Les noms de ressources des libellés de campagne sont au format suivant: customers/{customerId}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Campagne à laquelle le libellé est associé.

label

string

Libellé attribué à la campagne.

CartDataSalesView

Affichage des données du panier sur les ventes.

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

string

Nom de ressource de la vue des données du panier. Les noms des ressources de la vue des données du panier se présentent comme suit: customers/{customerId}/cartDataSalesView

Audience

L'audience constitue 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 comme suit:

customers/{customerId}/audiences/{audience_id}

id

string (int64 format)

ID de l'audience.

name

string

Obligatoire. Nom de l'audience. Il doit être unique pour toutes les audiences. Il doit comporter 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 des actions de conversion se présentent comme suit:

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 associés au modèle d'attribution de cette action de conversion.

floodlightSettings

object (FloodlightSettings)

Paramètres Floodlight pour les types de conversion Floodlight.

id

string (int64 format)

ID de l'action de conversion.

name

string

Nom de l'action de conversion.

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

primaryForGoal

boolean

Si le bit "primaryForGoal" d'une action de conversion est défini sur "false", l'action de conversion n'est pas enchérissable pour toutes les campagnes, quels que soient l'objectif de conversion de la campagne ou celui des clients. Toutefois, les objectifs de conversion personnalisés ne respectent pas primaryForGoal. Par conséquent, si un objectif de conversion personnalisé est configuré pour une campagne avec une action de conversion primaryForGoal = fausse, cette action de conversion est toujours enchérissable. Par défaut, la valeur "primaryForGoal" est définie sur "true" si cette règle n'est pas configurée. Dans V9, primaryForGoal ne peut être définie sur "false" qu'après la création via une "mise à jour" car elle n'est pas déclarée comme facultative.

ownerCustomer

string

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

includeInClientAccountConversionsMetric

boolean

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

includeInConversionsMetric

boolean

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

clickThroughLookbackWindowDays

string (int64 format)

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

appId

string

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

ConversionActionStatus

États possibles d'une action de conversion.

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

ConversionActionType

Types possibles d'une action de conversion.

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

ConversionActionCategory

Catégorie des conversions associées à une ConversionAction.

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DEFAULT Catégorie par défaut.
PAGE_VIEW Utilisateur visitant une page.
PURCHASE Achat, vente ou "commande passée" .
SIGNUP Action de l'utilisateur lors de l'inscription.
LEAD Action de génération de prospects.
DOWNLOAD Action de téléchargement de logiciel (comme pour une application).
ADD_TO_CART Ajout d'articles à un panier ou à un sac sur le site d'un annonceur.
BEGIN_CHECKOUT Lorsqu'un utilisateur accède au processus de paiement sur le site d'un annonceur.
SUBSCRIBE_PAID Début d'un abonnement payant à un produit ou à un service.
PHONE_CALL_LEAD Appel indiquant qu'un annonceur est intéressé par son offre.
IMPORTED_LEAD Une conversion de prospect importée dans Google Ads à partir d'une source externe.
SUBMIT_LEAD_FORM Envoi d'un formulaire sur le site d'un annonceur indiquant un intérêt pour une entreprise.
BOOK_APPOINTMENT Une prise de rendez-vous avec l'entreprise d'un annonceur.
REQUEST_QUOTE Demande de devis ou d'estimation de prix.
GET_DIRECTIONS Recherche de l'établissement d'un annonceur dans l'intention de s'y rendre
OUTBOUND_CLICK Clic vers le site du partenaire d'un annonceur
CONTACT Appel, SMS, e-mail, chat ou autre type de contact avec un annonceur.
ENGAGEMENT Un événement d'engagement sur un site Web tel qu'une durée de vie du site longue ou un objectif intelligent Google Analytics (GA). Destiné à être utilisé pour les importations d'objectifs Or GA, Firebase et GA.
STORE_VISIT Une visite dans un magasin physique
STORE_SALE Une promotion a lieu dans un magasin physique.
QUALIFIED_LEAD Une conversion de prospect importée dans Google Ads à partir d'une source externe, qui a été davantage qualifiée par l'annonceur (équipe marketing/commercial). Au cours du parcours entre le prospect et la vente, les annonceurs obtiennent des prospects, puis passent à l'action en s'adressant au consommateur. Si le consommateur est intéressé et est susceptible d'acheter son produit, l'annonceur marque ces prospects comme des "prospects qualifiés".
CONVERTED_LEAD Une conversion de prospect importée dans Google Ads à partir d'une source externe, qui a en outre terminé une étape définie par l'annonceur souhaitant générer des prospects.

ValueSettings

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

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

number

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

defaultCurrencyCode

string

Code de devise à utiliser lorsque des é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

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

AttributionModelSettings

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

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

enum (AttributionModel)

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

dataDrivenModelStatus

enum (DataDrivenModelStatus)

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

AttributionModel

Modèle d'attribution qui décrit comment répartir le crédit d'une conversion donnée entre de nombreuses interactions antérieures (éventuellement)

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

DataDrivenModelStatus

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente 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 en cours d'utilisation, 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 que le nombre d'événements requis sur une période de 30 jours n'a jamais été atteint.

FloodlightSettings

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

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

string

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

activityTag

string

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

activityId

string (int64 format)

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

ConversionCustomVariable

Une variable personnalisée de conversion Voir "À propos des métriques et des dimensions Floodlight personnalisées dans la nouvelle interface Search Ads 360" à l'adresse https://support.google.com/sa360/answer/13567857.

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

string

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

customers/{customerId}/conversionCustomVariables/{conversion_custom_variable_id}

id

string (int64 format)

ID de la variable personnalisée de conversion.

name

string

Obligatoire. Nom de la variable personnalisée de conversion. Le nom doit être unique. Le nom ne doit pas dépasser 100 caractères. Il ne doit pas y avoir d'espaces superflus avant et après.

tag

string

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

status

enum (ConversionCustomVariableStatus)

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

ownerCustomer

string

Nom de ressource du client propriétaire de la variable personnalisée de conversion.

family

enum (ConversionCustomVariableFamily)

Famille de la variable personnalisée de conversion

cardinality

enum (ConversionCustomVariableCardinality)

Cardinalité de la variable personnalisée de conversion.

floodlightConversionCustomVariableInfo

object (FloodlightConversionCustomVariableInfo)

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

customColumnIds[]

string (int64 format)

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

ConversionCustomVariableStatus

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

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

La variable personnalisée de conversion est en attente d'activation. Elle ne générera pas de statistiques tant qu'elle 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 génère des statistiques.
PAUSED La variable personnalisée de conversion est en veille et ne générera pas de statistiques tant qu'elle ne sera pas redéfinie sur ACTIVÉE.

ConversionCustomVariableFamily

Famille d'une variable personnalisée de conversion

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

ConversionCustomVariableCardinality

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

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

FloodlightConversionCustomVariableInfo

Informations sur les variables personnalisées de conversion Floodlight Search Ads 360

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

enum (FloodlightVariableType)

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

floodlightVariableDataType

enum (FloodlightVariableDataType)

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

FloodlightVariableType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
DIMENSION Dimension "Type de variable Floodlight".
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, telle qu'elle est définie dans Search Ads 360. Pour en savoir plus, consultez la page https://support.google.com/searchads/answer/4397154?hl=en.

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

Client

Un client.

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

string

Nom de ressource du client. Les noms de ressources client se présentent comme suit:

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 (Campaign Manager) pour un compte administrateur.

accountStatus

enum (AccountStatus)

l'état du compte (par exemple, activé, mis en veille, supprimé, etc.) ;

lastModifiedTime

string

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

engineId

string

ID du compte dans le compte de moteur externe.

status

enum (CustomerStatus)

État du client.

creationTime

string

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

id

string (int64 format)

ID du client.

descriptiveName

string

Nom descriptif facultatif et non unique du client.

currencyCode

string

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

timeZone

string

ID du fuseau horaire local du client.

trackingUrlTemplate

string

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

finalUrlSuffix

string

Modèle d'URL pour l'ajout de paramètres à l'URL finale.

autoTaggingEnabled

boolean

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

manager

boolean

Indique si le client est un responsable.

ConversionTrackingSetting

Ensemble de paramètres définis au niveau du client pour le suivi des conversions Search Ads 360.

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

boolean

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

conversionTrackingStatus

enum (ConversionTrackingStatus)

État du suivi des conversions. Elle 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 de l'login-customer-id de la requête.

enhancedConversionsForLeadsEnabled

boolean

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

googleAdsConversionCustomer

string

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

conversionTrackingId

string (int64 format)

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

googleAdsCrossAccountConversionTrackingId

string (int64 format)

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

crossAccountConversionTrackingId

string (int64 format)

ID de suivi des conversions du responsable du client. Il est défini lorsque le client active le suivi des conversions multicomptes et remplace le paramètre "conversionTrackingId".

ConversionTrackingStatus

État du suivi des conversions du client.

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

AccountType

Types de comptes de moteur possibles.

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

DoubleClickCampaignManagerSetting

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

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

string (int64 format)

Référence de l'annonceur Campaign Manager associé à ce client.

networkId

string (int64 format)

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

timeZone

string

Fuseau horaire du réseau Campaign Manager associé à ce client, au format de la base de données des fuseaux horaires IANA (par exemple, 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 est désactivé par l'utilisateur.
SUSPENDED Le compte est désactivé par un processus interne.
REMOVED Le compte est désactivé de manière irrévocable.
DRAFT Le compte est toujours en cours de configuration. Il n'est pas encore ACTIVÉ.

CustomerStatus

Statuts possibles d'un client.

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

CustomerAsset

Lien entre un client et un élément.

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

string

Nom de ressource de l'élément client. Les noms de ressources CustomerAsset se présentent comme suit:

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

asset

string

Obligatoire. Élément associé au client.

status

enum (AssetLinkStatus)

État du composant du client.

CustomerAssetSet

CustomerAssetSet est le lien entre un client et un ensemble d'éléments. L'ajout d'un CustomerAssetSet associe un ensemble de composants à un client.

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

string

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

customers/{customerId}/customerAssetSets/{asset_set_id}

assetSet

string

Ensemble de composants associé au client.

customer

string

Client auquel cet ensemble de composants est associé.

status

enum (AssetSetLinkStatus)

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

AccessibleBiddingStrategy

Représente une vue des stratégies d'enchères appartenant au client et partagées avec celui-ci.

Contrairement à BiddingStrategy, cette ressource inclut les stratégies détenues par les responsables du client et partagées avec ce client, en plus des stratégies détenues par ce client. Cette ressource ne fournit pas de métriques et n'expose qu'un sous-ensemble limité d'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 comme suit:

customers/{customerId}/accessibleBiddingStrategies/{bidding_strategy_id}

id

string (int64 format)

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

name

string

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

type

enum (BiddingStrategyType)

Type de stratégie d'enchères.

ownerCustomerId

string (int64 format)

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

ownerDescriptiveName

string

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

Champ d'union scheme. Le schéma d'enchères

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

maximizeConversionValue

object (MaximizeConversionValue)

Stratégie d'enchères automatiques qui vous permet d'enregistrer la plus grande valeur de conversion pour vos campagnes tout en exploitant la totalité de votre budget.

maximizeConversions

object (MaximizeConversions)

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

targetCpa

object (TargetCpa)

Il s'agit d'une 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 spécifiez.

targetImpressionShare

object (TargetImpressionShare)

Il s'agit d'une stratégie d'enchères qui optimise automatiquement les enchères en fonction d'un pourcentage donné d'impressions.

targetRoas

object (TargetRoas)

Il s'agit d'une stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen spécifique.

targetSpend

object (TargetSpend)

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

MaximizeConversionValue

Stratégie d'enchères automatiques qui vous permet d'enregistrer la plus grande valeur de conversion pour vos campagnes tout en exploitant la totalité de votre budget.

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

number

L'option de retour sur les dépenses publicitaires (ROAS) cible. Si cette valeur est définie, la stratégie d'enchères maximise les revenus tout en atteignant le ROAS cible moyen. Si le ROAS cible est élevé, la stratégie d'enchères risque de ne pas pouvoir dépenser la totalité du budget. Si aucun ROAS cible n'est défini, la stratégie d'enchères s'efforce d'atteindre le ROAS le plus élevé possible en fonction du budget.

MaximizeConversions

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

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

string (int64 format)

Option "Coût par acquisition (CPA) cible" Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.

targetCpaMicros

string (int64 format)

Option "Coût par acquisition (CPA) cible" Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.

TargetCpa

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

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

string (int64 format)

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

TargetImpressionShare

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

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

enum (TargetImpressionShareLocation)

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

locationFractionMicros

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

TargetRoas

Il s'agit d'une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen spécifique.

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

number

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

TargetSpend

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

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

string (int64 format)

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

cpcBidCeilingMicros

string (int64 format)

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

ManagerLinkStatus

États possibles d'une association.

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

CustomerClient

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

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

string

Nom de ressource du client client. Les noms de ressources CustomerClient se présentent comme suit: customers/{customerId}/customerClients/{client_customer_id}

appliedLabels[]

string

Noms de ressources des libellés appartenant au client demandeur et appliqués au client client. Les noms de ressources d'étiquette se présentent comme suit:

customers/{customerId}/labels/{label_id}

status

enum (CustomerStatus)

État du client. Lecture seule.

clientCustomer

string

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

hidden

boolean

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

Lecture seule.

level

string (int64 format)

Distance entre un client donné et un client donné. Pour le lien auto, la valeur du niveau est 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 test. Lecture seule.

manager

boolean

Indique si le client est un gestionnaire. Lecture seule.

descriptiveName

string

Nom descriptif du client. Lecture seule.

currencyCode

string

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

id

string (int64 format)

Identifiant du client client. Lecture seule.

DynamicSearchAdsSearchTermView

Vue des termes de recherche pour des 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 des ressources de vue des annonces dynamiques du Réseau de Recherche se présentent comme suit:

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

landingPage

string

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

Ce champ est en lecture seule.

GenderView

Vue par genre. La ressource "genderView" reflète l'état de diffusion effectif, plutôt que les critères ajoutés. Par défaut, un groupe d'annonces sans critère de sexe est diffusé auprès de tous les sexes. Tous les sexes apparaissent donc dans "genderView" avec des statistiques.

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

string

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

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

GeoTargetConstant

Constante de cible géographique

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

string

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

geoTargetConstants/{geo_target_constant_id}

status

enum (GeoTargetConstantStatus)

État de la constante de la cible géographique.

id

string (int64 format)

ID de la constante de la cible géographique.

name

string

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

countryCode

string

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

targetType

string

Type de cible constante de la cible géographique.

canonicalName

string

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

parentGeoTarget

string

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

geoTargetConstants/{parent_geo_target_constant_id}

GeoTargetConstantStatus

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

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

La valeur reçue est inconnue dans cette version.

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

ENABLED La constante de cible géographique est valide.
REMOVAL_PLANNED La constante de cible géographique est obsolète et sera supprimée.

KeywordView

Vue par mot clé.

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

string

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

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

Libellé

Une étiquette.

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

string

Nom de la ressource. Les noms de ressources d'étiquettes se présentent sous la forme suivante: customers/{customerId}/labels/{label_id}

status

enum (LabelStatus)

État du libellé. Lecture seule.

textLabel

object (TextLabel)

Type de libellé affichant du texte sur un fond coloré.

id

string (int64 format)

ID du libellé. Lecture seule.

name

string

Nom du libellé.

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

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

LabelStatus

États possibles d'un libellé.

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

TextLabel

Type de libellé affichant du texte sur un fond coloré.

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

string

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

description

string

Brève description du libellé. La longueur 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 langage se présentent sous la forme suivante:

languageConstants/{criterionId}

id

string (int64 format)

ID de la constante de langue.

code

string

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

name

string

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

targetable

boolean

Indique si la langue peut être ciblée.

LocationView

La vue par zone géographique récapitule les performances des campagnes par critère géographique.

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

string

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

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

ProductBiddingCategoryConstant

Catégorie d'enchères sur les produits.

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

string

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

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

level

enum (ProductBiddingCategoryLevel)

Niveau de la catégorie d'enchères associées au produit.

status

enum (ProductBiddingCategoryStatus)

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

id

string (int64 format)

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

Cet identifiant correspond à l'identifiant "google_product_category" décrit dans cet article: https://support.google.com/merchants/answer/6324436.

countryCode

string

Code pays à deux lettres majuscules de la catégorie d'enchères de 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 au niveau du produit.

localizedName

string

Valeur d'affichage de la catégorie d'enchères de produit localisée conformément au code languageCode.

ProductBiddingCategoryLevel

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

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

ProductBiddingCategoryStatus

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

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

ProductGroupView

Vue de groupe de produits.

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

string

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

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

ShoppingPerformanceView

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

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

string

Nom de ressource de la vue des performances Shopping. Les noms des ressources de la vue des performances Shopping sont au format suivant: 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 sous la forme suivante:

customers/{customerId}/userLists/{user_list_id}

type

enum (UserListType)

Type de la liste.

Ce champ est en lecture seule.

id

string (int64 format)

Identifiant de la liste d'utilisateurs.

name

string

Nom de cette liste d'utilisateurs. Selon son access_reason, le nom de la liste d'utilisateurs peut ne pas être unique (par exemple, si access_reason=SHARED)

UserListType

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

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

WebpageView

Affichage d'une page Web.

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

string

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

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

Accéder à la page

Une visite.

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

string

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

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

id

string (int64 format)

ID de la visite.

criterionId

string (int64 format)

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

merchantId

string (int64 format)

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

adId

string (int64 format)

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

clickId

string

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

visitDateTime

string

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

productId

string

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

productChannel

enum (ProductChannel)

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

productLanguageCode

string

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

productStoreId

string

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

productCountryCode

string

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

assetId

string (int64 format)

ID du composant avec lequel vous avez interagi lors de l'événement de visite.

assetFieldType

enum (AssetFieldType)

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

ProductChannel

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
ONLINE L'article est vendu en ligne.
LOCAL L'article est vendu dans des magasins 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 des ressources de conversion se présentent comme suit:

customers/{customerId}/conversions/{ad_group_id}~{criterionId}~{ds_conversion_id}

id

string (int64 format)

Identifiant de la conversion

criterionId

string (int64 format)

ID du critère Search Ads 360. Une valeur de 0 indique que le critère n'est pas attribué.

merchantId

string (int64 format)

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

adId

string (int64 format)

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

clickId

string

Chaîne unique, pour la visite à laquelle la conversion est attribuée, transmise à la page de destination en tant que paramètre d'URL d'ID de clic.

visitId

string (int64 format)

ID de la visite Search Ads 360 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", en fonction des instructions Floodlight de l'annonceur.

productId

string

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

productChannel

enum (ProductChannel)

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

productLanguageCode

string

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

productStoreId

string

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

productCountryCode

string

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

attributionType

enum (AttributionType)

Élément auquel la conversion est attribuée : visite ou mot clé + annonce.

conversionDateTime

string

Code temporel de l'événement de conversion.

conversionLastModifiedDateTime

string

Code temporel de la dernière modification de la conversion.

conversionVisitDateTime

string

Code temporel de la visite à laquelle la conversion est attribuée.

conversionQuantity

string (int64 format)

Quantité d'articles enregistrés par la conversion, telle que déterminée par le paramètre d'URL qty. L'annonceur est responsable du remplissage dynamique du paramètre (par exemple avec le nombre d'articles vendus dans le cadre de la conversion). Sinon, la valeur par défaut est définie sur 1.

conversionRevenueMicros

string (int64 format)

Revenus ajustés en micro-unités pour l'événement de conversion. Cette valeur est toujours dans la devise du compte de diffusion.

floodlightOriginalRevenue

string (int64 format)

Revenus initiaux non modifiés associés à l'événement Floodlight (dans la devise du rapport actuel), avant la modification des instructions de devise Floodlight.

floodlightOrderId

string

ID de commande Floodlight fourni par l'annonceur pour la conversion.

status

enum (ConversionStatus)

État de la conversion (ACTIVÉ ou SUPPRIMÉ).

assetId

string (int64 format)

ID du composant avec lequel vous avez interagi lors de l'événement de conversion.

assetFieldType

enum (AssetFieldType)

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

AttributionType

Type d'attribution des conversions dans Search Ads 360

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
VISIT La conversion est attribuée à une visite.
CRITERION_AD La conversion est attribuée à une paire critère/annonce.

ConversionStatus

États possibles d'une conversion.

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

Métriques

Données de métriques.

Représentation JSON
{
  "allConversionsValueByConversionDate": number,
  "allConversionsByConversionDate": number,
  "conversionCustomMetrics": [
    {
      object (Value)
    }
  ],
  "conversionsValueByConversionDate": number,
  "conversionsByConversionDate": number,
  "historicalCreativeQualityScore": enum (QualityScoreBucket),
  "historicalLandingPageQualityScore": enum (QualityScoreBucket),
  "historicalSearchPredictedCtr": enum (QualityScoreBucket),
  "interactionEventTypes": [
    enum (InteractionEventType)
  ],
  "rawEventConversionMetrics": [
    {
      object (Value)
    }
  ],
  "absoluteTopImpressionPercentage": number,
  "allConversionsFromInteractionsRate": number,
  "allConversionsValue": number,
  "allConversions": number,
  "allConversionsValuePerCost": number,
  "allConversionsFromClickToCall": number,
  "allConversionsFromDirections": number,
  "allConversionsFromInteractionsValuePerInteraction": number,
  "allConversionsFromMenu": number,
  "allConversionsFromOrder": number,
  "allConversionsFromOtherEngagement": number,
  "allConversionsFromStoreVisit": number,
  "visits": number,
  "allConversionsFromStoreWebsite": number,
  "averageCost": number,
  "averageCpc": number,
  "averageCpm": number,
  "clicks": string,
  "contentBudgetLostImpressionShare": number,
  "contentImpressionShare": number,
  "contentRankLostImpressionShare": number,
  "conversionsFromInteractionsRate": number,
  "clientAccountConversionsValue": number,
  "conversionsValuePerCost": number,
  "conversionsFromInteractionsValuePerInteraction": number,
  "clientAccountConversions": number,
  "costMicros": string,
  "costPerAllConversions": number,
  "costPerConversion": number,
  "costPerCurrentModelAttributedConversion": number,
  "crossDeviceConversions": number,
  "crossDeviceConversionsValue": number,
  "ctr": number,
  "conversions": number,
  "conversionsValue": number,
  "averageQualityScore": number,
  "historicalQualityScore": string,
  "impressions": string,
  "interactionRate": number,
  "interactions": string,
  "invalidClickRate": number,
  "invalidClicks": string,
  "mobileFriendlyClicksPercentage": number,
  "searchAbsoluteTopImpressionShare": number,
  "searchBudgetLostAbsoluteTopImpressionShare": number,
  "searchBudgetLostImpressionShare": number,
  "searchBudgetLostTopImpressionShare": number,
  "searchClickShare": number,
  "searchExactMatchImpressionShare": number,
  "searchImpressionShare": number,
  "searchRankLostAbsoluteTopImpressionShare": number,
  "searchRankLostImpressionShare": number,
  "searchRankLostTopImpressionShare": number,
  "searchTopImpressionShare": number,
  "topImpressionPercentage": number,
  "valuePerAllConversions": number,
  "valuePerAllConversionsByConversionDate": number,
  "valuePerConversion": number,
  "valuePerConversionsByConversionDate": number,
  "clientAccountViewThroughConversions": string,
  "clientAccountCrossSellCostOfGoodsSoldMicros": string,
  "crossSellCostOfGoodsSoldMicros": string,
  "clientAccountCrossSellGrossProfitMicros": string,
  "crossSellGrossProfitMicros": string,
  "clientAccountCrossSellRevenueMicros": string,
  "crossSellRevenueMicros": string,
  "clientAccountCrossSellUnitsSold": number,
  "crossSellUnitsSold": number,
  "clientAccountLeadCostOfGoodsSoldMicros": string,
  "leadCostOfGoodsSoldMicros": string,
  "clientAccountLeadGrossProfitMicros": string,
  "leadGrossProfitMicros": string,
  "clientAccountLeadRevenueMicros": string,
  "leadRevenueMicros": string,
  "clientAccountLeadUnitsSold": number,
  "leadUnitsSold": number
}
Champs
allConversionsValueByConversionDate

number

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

allConversionsByConversionDate

number

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

conversionCustomMetrics[]

object (Value)

Métriques personnalisées de conversion.

conversionsValueByConversionDate

number

Somme des valeurs de conversions enchérissables par date de conversion. Lorsque cette colonne est sélectionnée avec la date, ses valeurs correspondent à la date de la conversion.

conversionsByConversionDate

number

Somme des conversions par date de conversion pour les types de conversion enchérissables. Peut être fractionnaire en raison de la modélisation de l'attribution. Lorsque cette colonne est sélectionnée avec la date, ses valeurs correspondent à la date de la conversion.

historicalCreativeQualityScore

enum (QualityScoreBucket)

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

historicalLandingPageQualityScore

enum (QualityScoreBucket)

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

historicalSearchPredictedCtr

enum (QualityScoreBucket)

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

interactionEventTypes[]

enum (InteractionEventType)

Types d'interactions sans frais et payantes.

rawEventConversionMetrics[]

object (Value)

Métriques brutes des conversions d'événements.

absoluteTopImpressionPercentage

number

Le taux d'impressions en première position absolue sur le Réseau de Recherche correspond au pourcentage d'impressions de vos annonces diffusées à la position la plus proéminente sur le Réseau de Recherche.

allConversionsFromInteractionsRate

number

Nombre total de conversions générées par des interactions (par opposition aux conversions après affichage) divisé par le nombre d'interactions avec l'annonce.

allConversionsValue

number

Valeur de toutes les conversions.

allConversions

number

Cette valeur correspond au nombre total de conversions. Cela inclut toutes les conversions, quelle que soit la valeur d'includeInConversionsMetric.

allConversionsValuePerCost

number

Valeur de toutes les conversions divisée par le coût total des interactions avec l'annonce (clics pour les annonces textuelles ou visionnages pour les annonces vidéo, par exemple).

allConversionsFromClickToCall

number

Nombre de fois où les utilisateurs ont cliqué sur le bouton "Appeler" pour appeler un magasin pendant ou après avoir cliqué sur une annonce. Ce nombre n'inclut pas les appels passés ou non, ni leur durée.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromDirections

number

Nombre de fois où les utilisateurs ont cliqué sur un "Itinéraire" pour accéder à un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromInteractionsValuePerInteraction

number

Valeur de toutes les conversions issues des interactions divisée par le nombre total d'interactions.

allConversionsFromMenu

number

Nombre de fois où les utilisateurs ont cliqué sur un lien vers le menu d'un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromOrder

number

Nombre de fois où les utilisateurs ont passé une commande dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromOtherEngagement

number

Nombre de conversions supplémentaires (par exemple, la publication d'un avis ou l'enregistrement de l'adresse du magasin) effectuées par les utilisateurs après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

allConversionsFromStoreVisit

number

Estimation du nombre de fois où les utilisateurs se sont rendus dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

visits

number

Clics que Search Ads 360 a bien enregistrés et transférés vers la page de destination d'un annonceur.

allConversionsFromStoreWebsite

number

Nombre de fois où les utilisateurs ont été redirigés vers l'URL d'un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

averageCost

number

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

averageCpc

number

Coût total de tous les clics divisé par le nombre total de clics reçus. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

averageCpm

number

Coût moyen pour mille impressions (CPM). Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. 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 nombre de fois (en pourcentage) où votre annonce était susceptible d'être diffusée sur le Réseau Display, mais ne l'a pas été en raison d'un budget trop faible. Remarque: Le taux d'impressions perdues en raison du budget de contenu est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

contentImpressionShare

number

Il s'agit du nombre d'impressions enregistrées sur le Réseau Display, divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Remarque : le taux d'impressions du contenu est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

contentRankLostImpressionShare

number

Estimation du pourcentage d'impressions que vos annonces n'ont pas reçues sur le Réseau Display en raison d'un mauvais classement. Remarque : le taux d'impressions perdues dans le classement du contenu est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

conversionsFromInteractionsRate

number

Nombre moyen de conversions enchérissables (à partir d'une interaction) par interaction éligible à 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 inclut uniquement les actions de conversion pour lesquelles l'attribut includeInClientAccountConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

conversionsValuePerCost

number

Valeur d'une conversion enchérissable divisée par le coût total des interactions éligibles à la conversion.

conversionsFromInteractionsValuePerInteraction

number

Valeur des conversions issues des interactions divisée par le nombre d'interactions avec l'annonce. Cela ne concerne que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

clientAccountConversions

number

Nombre de conversions de comptes client. Cela inclut uniquement les actions de conversion pour lesquelles l'attribut includeInClientAccountConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

costMicros

string (int64 format)

Somme du coût par clic (CPC) et du coût par mille impressions (CPM) enregistrés au cours de la période concernée. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

costPerAllConversions

number

Coût des interactions avec l'annonce divisé par le nombre total de conversions.

costPerConversion

number

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

costPerCurrentModelAttributedConversion

number

Coût des interactions avec les annonces divisé par le nombre de conversions attribuées par le modèle actuel. Cela ne concerne que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

crossDeviceConversions

number

Conversions enregistrées lorsqu'un client clique sur une annonce sur un appareil, puis effectue une conversion sur un autre appareil ou navigateur. Les conversions multi-appareils sont déjà incluses dans allConversions.

crossDeviceConversionsValue

number

Somme de la valeur des conversions multi-appareils.

ctr

number

Nombre de clics sur votre annonce (clics) divisé par le nombre d'affichages de celle-ci (impressions).

conversions

number

Nombre de conversions Cela ne concerne que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

conversionsValue

number

Somme des valeurs de conversion incluses dans le champ "Conversions". Cette statistique 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

Il s'agit de la fréquence à laquelle les utilisateurs interagissent avec votre annonce une fois qu'ils l'ont vue. Il s'agit du nombre d'interactions divisé par le nombre de fois où votre annonce est diffusée.

interactions

string (int64 format)

Nombre d'interactions. Une interaction correspond à l'action principale de l'utilisateur associée à un format d'annonce : les clics pour les annonces textuelles et Shopping, les vues pour les annonces vidéo, etc.

invalidClickRate

number

Pourcentage de clics exclus du nombre total de clics (clics filtrés et non filtrés) au cours de la période de référence.

invalidClicks

string (int64 format)

Nombre de clics que Google considère illégitimes et pour lesquels aucuns frais ne vous sont facturés.

mobileFriendlyClicksPercentage

number

Pourcentage de clics sur mobile qui redirigent les utilisateurs vers une page adaptée aux mobiles.

searchAbsoluteTopImpressionShare

number

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

searchBudgetLostAbsoluteTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce ne figurait pas en toute première place parmi les 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 en lien avec le budget sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchBudgetLostImpressionShare

number

Estimation du pourcentage de fois où votre annonce était susceptible d'être diffusée sur le Réseau de Recherche, mais ne l'a pas été en raison d'un budget trop faible. Remarque : le taux d'impressions perdues sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchBudgetLostTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée à côté des premiers résultats de recherche naturels en raison d'un budget trop faible. Remarque: Le taux d'impressions perdues en première position associée au budget sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchClickShare

number

Nombre de clics enregistrés sur le Réseau de Recherche divisé par le nombre estimé de clics susceptibles d'avoir été enregistrés. Remarque: La part de clics sur le Réseau de Recherche est comprise entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

searchExactMatchImpressionShare

number

Nombre d'impressions enregistrées par vos annonces, divisé par le nombre estimé d'impressions susceptibles d'être enregistrées sur le Réseau de Recherche pour des termes de recherche correspondant exactement à vos mots clés (ou étant des variantes proches), quels que soient les types de correspondance des mots clés. Remarque: Le taux d'impressions pour les mots clés exacts sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

searchImpressionShare

number

Il s'agit du nombre d'impressions enregistrées sur le Réseau de Recherche, divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Remarque : le taux d'impressions sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

searchRankLostAbsoluteTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce ne figurait pas en toute première place parmi les 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 dans le classement dans les résultats de recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchRankLostImpressionShare

number

Estimation du pourcentage d'impressions que vos annonces n'ont pas reçues sur le Réseau de Recherche en raison d'un mauvais classement. Remarque : le taux d'impressions perdues pour le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

searchRankLostTopImpressionShare

number

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée à côté des premiers résultats de recherche naturels en raison de son mauvais classement. Remarque: Le taux d'impressions perdues en première position dans les résultats 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 parmi les annonces en première position comparées au nombre estimé d'impressions qu'elles étaient susceptibles d'enregistrer dans les annonces en première position. Remarque: Le taux d'impressions en première position sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

Les meilleures annonces apparaissent généralement au-dessus des premiers résultats naturels, même si pour certaines requêtes, elles peuvent s'afficher en dessous des résultats naturels en haut de page.

topImpressionPercentage

number

Pourcentage de vos impressions d'annonces diffusées à côté des premiers résultats de recherche naturels.

valuePerAllConversions

number

Valeur de toutes les conversions divisée par le nombre total de conversions.

valuePerAllConversionsByConversionDate

number

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

valuePerConversion

number

Valeur d'une conversion enchérissable divisée par le nombre de conversions enchérissables. Indique la valeur moyenne de chacune des conversions enchérissables.

valuePerConversionsByConversionDate

number

Valeur des conversions enchérissables par date de conversion divisée par les conversions enchérissables par date de conversion. Indique la valeur moyenne de chacune des conversions enchérissables (par date de conversion). Lorsque cette colonne est sélectionnée avec la date, ses valeurs correspondent à la date de la conversion.

clientAccountViewThroughConversions

string (int64 format)

Nombre total de conversions après affichage Cela se produit lorsqu'un client voit une annonce illustrée ou rich media, puis effectue ultérieurement une conversion sur votre site sans interagir avec une autre annonce (par exemple, en cliquant dessus).

clientAccountCrossSellCostOfGoodsSoldMicros

string (int64 format)

Le prix de revient des ventes croisées du compte client correspond au coût total des produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Le prix de revient des ventes croisées correspond au coût total des produits vendus dont vous n'avez pas fait la promotion. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 € et celui de la chemise est de 5 €. Le prix de revient des ventes croisées pour cette commande est de 5 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellCostOfGoodsSoldMicros

string (int64 format)

Le prix de revient des ventes croisées correspond au coût total des produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Le prix de revient des ventes croisées correspond au coût total des produits vendus dont vous n'avez pas fait la promotion. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 € et celui de la chemise est de 5 €. Le prix de revient des ventes croisées pour cette commande est de 5 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. 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 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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

crossSellRevenueMicros

string (int64 format)

Les revenus des ventes croisées correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les revenus des ventes croisées correspondent à la valeur totale des ventes croisées attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus de la vente croisée pour cette commande sont de 20 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountCrossSellUnitsSold

number

Les unités vendues via les ventes croisées du compte client correspondent au nombre total de produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les unités vendues via les ventes croisées correspondent au nombre total de produits vendus par vente croisée issus de toutes les commandes attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues via les ventes croisées dans cette commande est de 2. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

crossSellUnitsSold

number

La métrique "Unités vendues via les ventes croisées" correspond au nombre total de produits vendus suite à la promotion d'un autre produit. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les unités vendues via les ventes croisées correspondent au nombre total de produits vendus par vente croisée issus de toutes les commandes attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues via les ventes croisées dans cette commande est de 2. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

clientAccountLeadCostOfGoodsSoldMicros

string (int64 format)

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

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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadGrossProfitMicros

string (int64 format)

La marge brute des prospects du compte client correspond aux bénéfices générés par les produits vendus suite à la promotion de ces mêmes produits, moins le prix de revient. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, votre marge brute des prospects est calculée comme suit : revenus générés par ces ventes moins le prix de revient. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 € et a une valeur de 3 € pour le prix de revient. La marge brute des prospects pour cette commande est égale à 7 €, soit 10 € - 3 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadRevenueMicros

string (int64 format)

Les revenus des prospects du compte client correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, la valeur totale des ventes de ces produits s'affiche sous "Revenus des prospects". Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus des prospects pour cette commande sont de 10 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

leadRevenueMicros

string (int64 format)

Les revenus des prospects correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, la valeur totale des ventes de ces produits s'affiche sous "Revenus des prospects". Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus des prospects pour cette commande sont de 10 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clientAccountLeadUnitsSold

number

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

leadUnitsSold

number

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

Valeur

Conteneur de données générique.

Représentation JSON
{

  // Union field value can be only one of the following:
  "booleanValue": boolean,
  "int64Value": string,
  "floatValue": number,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Champs
Champ d'union value. une valeur. value ne peut être qu'un des éléments suivants :
booleanValue

boolean

Valeur booléenne.

int64Value

string (int64 format)

Int64.

floatValue

number

Un float.

doubleValue

number

Valeur double.

stringValue

string

Chaîne.

QualityScoreBucket

Énumération répertoriant les segments de niveau de qualité possibles.

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

InteractionEventType

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
CLICK Cliquez pour accéder au site. Dans la plupart des cas, cette interaction redirige l'utilisateur vers un site externe, généralement la page de destination de l'annonceur. Il s'agit également de l'InteractionEventType par défaut pour les événements de clic.
ENGAGEMENT L'intention de l'utilisateur d'interagir avec l'annonce sur place
VIDEO_VIEW Un utilisateur a visionné une annonce vidéo.
NONE InteractionEventType par défaut pour les événements de conversion d'annonce. 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'annonces) doivent être "promouvoir". et incluses dans les métriques clés. Il s'agit simplement d'autres conversions (annonces).

Segments

Segmenter uniquement.

Représentation JSON
{
  "adNetworkType": enum (AdNetworkType),
  "conversionActionCategory": enum (ConversionActionCategory),
  "conversionCustomDimensions": [
    {
      object (Value)
    }
  ],
  "dayOfWeek": enum (DayOfWeek),
  "device": enum (Device),
  "keyword": {
    object (Keyword)
  },
  "productChannel": enum (ProductChannel),
  "productChannelExclusivity": enum (ProductChannelExclusivity),
  "productCondition": enum (ProductCondition),
  "productSoldCondition": enum (ProductCondition),
  "rawEventConversionDimensions": [
    {
      object (Value)
    }
  ],
  "conversionAction": string,
  "conversionActionName": string,
  "date": string,
  "geoTargetCity": string,
  "geoTargetCountry": string,
  "geoTargetMetro": string,
  "geoTargetRegion": string,
  "hour": integer,
  "month": string,
  "productBiddingCategoryLevel1": string,
  "productBiddingCategoryLevel2": string,
  "productBiddingCategoryLevel3": string,
  "productBiddingCategoryLevel4": string,
  "productBiddingCategoryLevel5": string,
  "productBrand": string,
  "productCountry": string,
  "productCustomAttribute0": string,
  "productCustomAttribute1": string,
  "productCustomAttribute2": string,
  "productCustomAttribute3": string,
  "productCustomAttribute4": string,
  "productItemId": string,
  "productLanguage": string,
  "productSoldBiddingCategoryLevel1": string,
  "productSoldBiddingCategoryLevel2": string,
  "productSoldBiddingCategoryLevel3": string,
  "productSoldBiddingCategoryLevel4": string,
  "productSoldBiddingCategoryLevel5": string,
  "productSoldBrand": string,
  "productSoldCustomAttribute0": string,
  "productSoldCustomAttribute1": string,
  "productSoldCustomAttribute2": string,
  "productSoldCustomAttribute3": string,
  "productSoldCustomAttribute4": string,
  "productSoldItemId": string,
  "productSoldTitle": string,
  "productSoldTypeL1": string,
  "productSoldTypeL2": string,
  "productSoldTypeL3": string,
  "productSoldTypeL4": string,
  "productSoldTypeL5": string,
  "productStoreId": string,
  "productTitle": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "quarter": string,
  "week": string,
  "year": integer,
  "assetInteractionTarget": {
    object (AssetInteractionTarget)
  }
}
Champs
adNetworkType

enum (AdNetworkType)

Type de réseau publicitaire.

conversionActionCategory

enum (ConversionActionCategory)

Catégorie de l'action de conversion.

conversionCustomDimensions[]

object (Value)

Dimensions personnalisées de la conversion.

dayOfWeek

enum (DayOfWeek)

Jour de la semaine (par exemple, MONDAY)

device

enum (Device)

Appareil auquel les métriques s'appliquent.

keyword

object (Keyword)

Critère du mot clé.

productChannel

enum (ProductChannel)

Canal du produit.

productChannelExclusivity

enum (ProductChannelExclusivity)

Exclusivité de canal du produit.

productCondition

enum (ProductCondition)

État du produit.

productSoldCondition

enum (ProductCondition)

État du produit vendu.

rawEventConversionDimensions[]

object (Value)

Dimensions brutes de conversion d'événement.

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 cible géographique qui représente une ville.

geoTargetCountry

string

Nom de ressource de la constante de cible géographique qui représente un pays.

geoTargetMetro

string

Nom de ressource de la constante de cible géographique qui représente une agglomération.

geoTargetRegion

string

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

hour

integer

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

month

string

Mois, représenté par la date du premier jour du mois. au format aaaa-MM-jj.

productBiddingCategoryLevel1

string

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

productBiddingCategoryLevel2

string

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

productBiddingCategoryLevel3

string

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

productBiddingCategoryLevel4

string

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

productBiddingCategoryLevel5

string

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

productBrand

string

Marque du produit.

productCountry

string

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

productCustomAttribute0

string

Attribut personnalisé 0 du produit.

productCustomAttribute1

string

Attribut personnalisé 1 du produit.

productCustomAttribute2

string

Attribut personnalisé 2 du produit.

productCustomAttribute3

string

Attribut personnalisé 3 du produit.

productCustomAttribute4

string

Attribut personnalisé 4 du produit.

productItemId

string

ID d'article du produit.

productLanguage

string

Nom de ressource de la constante de langue du produit.

productSoldBiddingCategoryLevel1

string

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

productSoldBiddingCategoryLevel2

string

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

productSoldBiddingCategoryLevel3

string

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

productSoldBiddingCategoryLevel4

string

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

productSoldBiddingCategoryLevel5

string

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

productSoldBrand

string

Marque du produit vendu.

productSoldCustomAttribute0

string

Attribut personnalisé 0 du produit vendu

productSoldCustomAttribute1

string

Attribut personnalisé 1 du produit vendu.

productSoldCustomAttribute2

string

Attribut personnalisé 2 du produit vendu

productSoldCustomAttribute3

string

Attribut personnalisé 3 du produit vendu

productSoldCustomAttribute4

string

Attribut personnalisé 4 du produit vendu

productSoldItemId

string

ID d'article du produit vendu.

productSoldTitle

string

Titre du produit vendu.

productSoldTypeL1

string

Type (niveau 1) du produit vendu.

productSoldTypeL2

string

Type (niveau 2) du produit vendu.

productSoldTypeL3

string

Type (niveau 3) du produit vendu.

productSoldTypeL4

string

Type (niveau 4) du produit vendu.

productSoldTypeL5

string

Type (niveau 5) du produit vendu.

productStoreId

string

ID de magasin associé au produit.

productTitle

string

Titre du produit.

productTypeL1

string

Type (niveau 1) du produit.

productTypeL2

string

Type (niveau 2) du produit.

productTypeL3

string

Type (niveau 3) du produit.

productTypeL4

string

Type (niveau 4) du produit.

productTypeL5

string

Type (niveau 5) du produit.

quarter

string

Trimestre comme représenté par la date du premier jour d'un trimestre. Utilise l'année civile pour les trimestres. Par exemple, le deuxième trimestre 2018 commence le 01/04/2018. au format aaaa-MM-jj.

week

string

Semaine (définie du lundi au dimanche) et représentée par le lundi. au format aaaa-MM-jj.

year

integer

Année au format aaaa

assetInteractionTarget

object (AssetInteractionTarget)

Utilisé uniquement avec les métriques "CustomerAsset", "CampaignAsset" et "GroupAsset". Indique si les métriques d'interaction ont eu lieu sur le composant lui-même, ou sur un autre composant ou bloc d'annonces. Les interactions (les clics, par exemple) sont comptabilisées dans l'ensemble des parties d'une annonce diffusée (par exemple, l'annonce elle-même et d'autres composants tels que les liens annexes) lorsqu'elles sont diffusées simultanément. Lorsque "interactionOnThisAsset" est défini sur "true", cela signifie que les interactions ont lieu sur cet élément spécifique. Lorsque "interactionOnThisAsset" est défini sur "false", cela signifie que les interactions ne se trouvent pas sur cet élément spécifique, mais sur d'autres parties de l'annonce avec laquelle cet élément est diffusé.

AdNetworkType

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

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

Mot clé

Un segment de critère de mot-clé.

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

object (KeywordInfo)

Informations sur le mot clé.

adGroupCriterion

string

Nom de la ressource GroupByKey.

ProductChannelExclusivity

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

Enums
UNSPECIFIED Non spécifié.
UNKNOWN Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
SINGLE_CHANNEL L'article est vendu par le biais d'un seul canal de distribution, à savoir les magasins locaux ou en ligne, comme l'indique le canal de distribution ProductChannel.
MULTI_CHANNEL L'article est mis en correspondance avec son équivalent en ligne ou en magasin, ce qui indique qu'il est disponible à l'achat sur les deux canaux ShoppingProductChannels.

ProductCondition

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

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

AssetInteractionTarget

Un segment AssetInteractionTarget.

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

string

Nom de ressource de l'élément.

interactionOnThisAsset

boolean

Utilisé uniquement avec les métriques "CustomerAsset", "CampaignAsset" et "GroupAsset". Indique si les métriques d'interaction ont eu lieu sur le composant lui-même, ou sur un autre composant ou bloc d'annonces.