Package google.ads.searchads360.v0.resources

string

Nom de la ressource de la stratégie d'enchères accessible. Les noms de ressources AccessibleBiddingStrategy ont la forme suivante:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

int64

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

string

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

BiddingStrategyType

Type de stratégie d'enchères.

int64

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

string

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

MaximizeConversionValue

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

MaximizeConversions

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

TargetCpa

Stratégie d'enchères qui définit vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous avez défini.

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

double

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

int64

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

int64

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

int64

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.

TargetImpressionShareLocation

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

int64

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

int64

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.

double

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

int64

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.

int64

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.

string

Nom de ressource de l'annonce. Les noms de ressources d'annonces ont la forme suivante:

customers/{customer_id}/ads/{ad_id}

string

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

AdType

Type d'annonce.

int64

Identifiant de l'annonce.

string

URL qui s'affiche dans la description de certains formats d'annonces.

string

Nom de l'annonce. Cette valeur sert uniquement à identifier l'annonce. Ils ne doivent pas nécessairement être uniques et n'ont aucune incidence sur l'annonce diffusée. Le champ de nom n'est actuellement compatible qu'avec DisplayUploadAd, ImageAd, ShoppingComparaisonListingAd et VideoAd.

SearchAds360TextAdInfo

Informations sur une annonce textuelle

SearchAds360ExpandedTextAdInfo

Informations concernant une annonce textuelle agrandie.

SearchAds360ResponsiveSearchAdInfo

Informations sur une annonce responsive sur le Réseau de Recherche.

SearchAds360ProductAdInfo

Informations sur une annonce produit

SearchAds360ExpandedDynamicSearchAdInfo

Informations sur une annonce dynamique agrandie du Réseau de Recherche.

string

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

customers/{customer_id}/adGroups/{ad_group_id}

AdGroupStatus

État du groupe d'annonces.

AdGroupType

Type du groupe d'annonces.

AdGroupAdRotationMode

Mode de rotation des annonces du groupe d'annonces.

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

Paramètre pour les fonctionnalités liées au ciblage.

string

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

string

Noms de ressource des étiquettes efficaces associées à ce groupe d'annonces. Un libellé efficace est un libellé hérité ou directement attribué à ce groupe d'annonces.

string

ID du groupe d'annonces dans le compte de moteur externe. Ce champ concerne uniquement les comptes autres que Google Ads (par exemple, Yahoo Japan, Microsoft, Baidu, etc.). Pour l'entité Google Ads, utilisez plutôt "ad_group.id".

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

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

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

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

int64

Identifiant du groupe d'annonces.

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

int64

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

AdGroupEngineStatus

État du moteur pour le groupe d'annonces.

string

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

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

AdGroupAdStatus

État de l'annonce.

Ad

Annonce.

string

Horodatage de la création de cette annonce de groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

string

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

string

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

string

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

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.

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

string

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

string

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

string

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

int64

ID du client propriétaire du libellé effectif.

string

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

string

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

string

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

int64

ID du client propriétaire du libellé.

string

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

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

string

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

string

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

AssetLinkStatus

État du composant du groupe d'annonces.

string

Nom de ressource de l'ensemble d'assets du groupe d'annonces. Les noms de ressources des ensembles d'assets de groupe d'annonces ont la forme suivante:

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

string

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

string

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

AssetSetLinkStatus

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

string

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

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

string

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

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

double

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.

DeviceInfo

Critère d'appareil.

string

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

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

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

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

Informations sur la qualité du critère.

CriterionType

Type du critère.

string

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

string

Noms de ressource des étiquettes effectives associées à ce critère de groupe d'annonces. Un libellé efficace est un libellé hérité ou attribué directement à ce critère de groupe d'annonces.

PositionEstimates

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

string

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

string

ID du critère de groupe d'annonces dans le compte de moteur externe. Ce champ concerne uniquement les comptes autres que Google Ads (par exemple, Yahoo Japan, Microsoft, Baidu, etc.). Pour l'entité Google Ads, utilisez plutôt "ad_group_criterion.criterion_id".

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

int64

ID du critère.

string

Groupe d'annonces auquel le critère appartient.

bool

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

Ce champ est immuable. Pour passer d'un critère positif à un critère négatif, supprimez-le, puis ajoutez-le de nouveau.

double

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.

int64

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

int64

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

AdGroupCriterionEngineStatus

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

string

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

string

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

KeywordInfo

Mot clé.

ListingGroupInfo

Groupe de fiches.

AgeRangeInfo

Tranche d'âge.

GenderInfo

Gender.

UserListInfo

Liste des utilisateurs.

WebpageInfo

Page Web

LocationInfo

Localisation.

int64

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.

int32

Le niveau de qualité.

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

string

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

string

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

string

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

int64

ID du client propriétaire du libellé effectif.

string

Nom de la ressource du libellé du critère du groupe d'annonces. Les noms de ressources des étiquettes de critères de groupe d'annonces se présentent sous la forme: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}.

string

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

string

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

int64

ID du client propriétaire du libellé.

string

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

string

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

string

Libellé effectif attribué au groupe d'annonces.

int64

ID du client propriétaire du libellé effectif.

string

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

string

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

string

Libellé attribué au groupe d'annonces.

int64

ID du client propriétaire du libellé.

string

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

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

string

Nom de la ressource de l'asset. Les noms de ressources d'éléments ont la forme suivante:

customers/{customer_id}/assets/{asset_id}

AssetType

Type de l'asset.

string

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

AssetStatus

État de l'élément.

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

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

int64

ID de l'élément.

string

Nom facultatif du composant.

string

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

AssetEngineStatus

État du moteur d'un composant.

YoutubeVideoAsset

Un élément vidéo YouTube.

ImageAsset

Composant Image

TextAsset

Un composant texte.

UnifiedCalloutAsset

Composant Accroche unifié.

UnifiedSitelinkAsset

Composant Lien annexe unifié.

UnifiedPageFeedAsset

Élément de flux de pages unifié.

MobileAppAsset

Composant Application mobile

UnifiedCallAsset

Composant Appel unifié.

CallToActionAsset

Composant d'incitation à l'action.

UnifiedLocationAsset

Composant Lieu unifié.

string

Nom de la ressource du groupe de composants. Les noms de ressources de groupe d'assets se présentent sous la forme suivante:

customers/{customer_id}/assetGroups/{asset_group_id}

int64

ID du groupe de composants.

string

Campagne à laquelle ce groupe d'assets est associé. Élément associé au groupe d'éléments.

string

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

string

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

string

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

AssetGroupStatus

État du groupe de composants.

string

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

string

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

AdStrength

Efficacité globale des annonces de ce groupe d'assets.

string

Nom de ressource de l'asset du groupe de composants. Le nom de la ressource d'un composant de groupe de composants se présente sous la forme suivante:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

string

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

string

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

AssetFieldType

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

AssetLinkStatus

État du lien entre un composant et un groupe de composants.

AssetUsage

Composants diffusés.

string

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

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

string

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

int64

ID du ListingGroupFilter.

ListingGroupFilterType

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

ListingGroupFilterVertical

Verticale que l'arborescence de nœuds actuelle représente. Tous les nœuds d'un même arbre doivent appartenir à la même verticale.

ListingGroupFilterDimension

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

string

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

ListingGroupFilterDimensionPath

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

string

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

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

string

Groupe de composants auquel appartient ce signal de groupe de composants.

AudienceInfo

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

string

Nom de ressource de la vue de la combinaison la plus performante du groupe de composants. Les noms de ressources des vues "Meilleure combinaison de groupes d'assets" se présentent sous la forme "clients/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".

AssetGroupAssetCombinationData

Combinaisons de composants les plus populaires diffusées ensemble.

int64

ID de l'ensemble de composants.

string

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

customers/{customer_id}/assetSets/{asset_set_id}

string

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

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

string

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

string

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

AssetSetAssetStatus

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

string

Nom de la ressource de l'audience. Les noms d'audience se présentent sous la forme suivante:

customers/{customer_id}/audiences/{audience_id}

int64

ID de l'audience.

string

Obligatoire. Nom de l'audience. Il doit être unique pour toutes les audiences. Il doit comporter au moins un caractère et au maximum 255 caractères.

string

Description de cette audience.

string

Nom de la ressource de la stratégie d'enchères. Les noms de ressources de stratégie d'enchères ont la forme suivante:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

BiddingStrategyStatus

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

Ce champ est en lecture seule.

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.

string

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

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

int64

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

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

string

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

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

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

Ce champ est en lecture seule.

int64

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

Ce champ est en lecture seule.

int64

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

Ce champ est en lecture seule.

EnhancedCpc

Stratégie d'enchères qui augmente les enchères pour les clics qui semblent les plus susceptibles de générer une conversion et les diminue pour les clics pour lesquels les chances de conversion sont faibles.

MaximizeConversionValue

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

MaximizeConversions

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

TargetCpa

Stratégie d'enchères qui définit vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous avez défini.

TargetImpressionShare

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

TargetOutrankShare

Stratégie d'enchères qui définit les enchères en fonction de la fraction cible des enchères pour lesquelles l'annonceur doit devancer un concurrent spécifique. Ce champ a été abandonné. Vous ne pourrez pas créer de stratégie d'enchères avec ce champ ni associer de stratégies d'enchères avec ce champ à une campagne. Les mutations de stratégies pour lesquelles ce schéma est déjà renseigné sont autorisées.

TargetRoas

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

TargetSpend

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

string

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

customers/{customer_id}/campaigns/{campaign_id}

CampaignStatus

État de la campagne.

Lorsque vous ajoutez une campagne, son état est défini par défaut sur "ACTIVE".

CampaignServingStatus

État de diffusion des annonces de la campagne.

BiddingStrategySystemStatus

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

AdServingOptimizationStatus

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

AdvertisingChannelType

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

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

Filtre facultatif de advertising_channel_type. 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é.

CustomParameter

Liste des mappages utilisés pour remplacer les balises de paramètres personnalisées dans un tracking_url_template, final_urls ou mobile_final_urls.

RealTimeBiddingSetting

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

NetworkSettings

Paramètres des réseaux de la campagne.

DynamicSearchAdsSetting

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

ShoppingSetting

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

GeoTargetTypeSetting

Paramètre du ciblage géographique des annonces.

string

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

string

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

BiddingStrategyType

Type de stratégie d'enchères.

Pour créer une stratégie d'enchères, vous pouvez utiliser le schéma d'enchères afin de créer une stratégie d'enchères standard ou le champ bidding_strategy pour créer une stratégie de portefeuille d'enchères.

Ce champ est en lecture seule.

string

Nom de la ressource AccessibleBiddingStrategy, une vue en lecture seule des attributs sans restriction de la stratégie d'enchères de portefeuille associée identifiée par "bidding_strategy". 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 limités ne peuvent être lus que depuis la ressource BiddingStrategy.

FrequencyCapEntry

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

SelectiveOptimization

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

OptimizationGoalSetting

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

TrackingSetting

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

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

AssetFieldType

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

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

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

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

int64

Identifiant de la campagne.

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

string

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

string

Nom de la ressource du budget de la campagne.

string

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

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.

string

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

bool

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

string

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

ManualCpa

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

ManualCpc

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

ManualCpm

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

MaximizeConversions

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

MaximizeConversionValue

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

TargetCpa

Stratégie d'enchères au CPA cible standard qui définit automatiquement vos enchères pour générer un maximum de conversions en fonction du coût par acquisition (CPA) cible que vous spécifiez.

TargetImpressionShare

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

TargetRoas

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

TargetSpend

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

PercentCpc

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

TargetCpm

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

string

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

string

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

bool

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

PositiveGeoTargetType

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

NegativeGeoTargetType

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

bool

Indique si les annonces seront diffusées avec les résultats de recherche google.com.

bool

Indique si les annonces seront diffusées sur les sites partenaires du Réseau de Recherche de Google (nécessite que target_google_search soit également true).

bool

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.

bool

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

OptimizationGoalType

Liste des types d'objectifs d'optimisation.

string

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

string

Libellé du flux des produits à inclure dans la campagne. Vous ne pouvez définir qu'un seul des attributs "libellé_flux" ou "pays_de_vente". Si vous utilisez le champ "libellé_flux" au lieu de "pays_ventes", vous pouvez saisir des 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.

bool

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

int64

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

string

Pays de vente des produits à inclure dans la campagne.

int32

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

bool

Indique si les produits en magasin doivent être inclus.

string

URL utilisée pour le suivi dynamique.

string

Nom de la ressource de l'asset de la campagne. Les noms de ressources CampaignAsset ont la forme suivante:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

AssetLinkStatus

État du composant de la campagne.

string

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

string

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

string

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

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

string

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

string

Ensemble d'éléments associé à la campagne.

AssetSetLinkStatus

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

string

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

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

string

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

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

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.

BudgetPeriod

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

int64

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.

string

Nom de la ressource du critère de la campagne. Les noms de ressources des critères de campagne sont au format suivant:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

string

Nom à afficher du critère.

Ce champ est ignoré pour les mutations.

CriterionType

Type du critère.

CampaignCriterionStatus

État du critère.

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

int64

ID du critère.

Ce champ est ignoré lors de la mutation.

float

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.

bool

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

KeywordInfo

Mot clé.

LocationInfo

Localisation.

DeviceInfo

appareil.

AgeRangeInfo

Tranche d'âge.

GenderInfo

Gender.

UserListInfo

Liste des utilisateurs.

LanguageInfo

HashiCorp.

WebpageInfo

Page Web

LocationGroupInfo

Groupe d'établissements

string

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

string

Campagne à laquelle le libellé effectif est associé.

string

Libellé effectif attribué à la campagne.

int64

ID du client propriétaire du libellé effectif.

string

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

string

Campagne à laquelle le libellé est associé.

string

Libellé attribué à la campagne.

int64

ID du client propriétaire du libellé.

string

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

string

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

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

int64

Identifiant de la conversion

int64

ID du critère Search Ads 360. Une valeur de 0 indique que le critère n'est pas attribué.

int64

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.

int64

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

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.

int64

ID de visite Search Ads 360 auquel la conversion est attribuée.

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 "floodlight_order_id" suivant les instructions Floodlight de l'annonceur.

string

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

ProductChannel

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

string

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

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.

string

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

AttributionType

Élément auquel la conversion est attribuée : visite ou mot clé + annonce.

string

Code temporel de l'événement de conversion.

string

Code temporel de la dernière modification de la conversion.

string

Code temporel de la visite à laquelle la conversion est attribuée.

int64

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.

int64

Revenus ajustés en micro-unités pour l'événement de conversion. Cette valeur est toujours dans la devise du compte de diffusion.

int64

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.

string

ID de commande Floodlight fourni par l'annonceur pour la conversion.

ConversionStatus

État de la conversion (ACTIVÉ ou SUPPRIMÉ).

int64

ID de l'élément avec lequel l'utilisateur a interagi lors de l'événement de conversion.

AssetFieldType

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

string

Nom de ressource de l'action de conversion. Les noms de ressources d'action de conversion se présentent sous la forme suivante:

customers/{customer_id}/conversionActions/{conversion_action_id}

string

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

ConversionActionStatus

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

ConversionActionType

Type d'action de conversion.

ConversionActionCategory

Catégorie des conversions enregistrées pour cette action de conversion.

ValueSettings

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

AttributionModelSettings

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

FloodlightSettings

Paramètres Floodlight pour les types de conversion Floodlight.

int64

ID de l'action de conversion.

string

Nom de l'action de conversion.

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

bool

Si le bit "primary_for_goal" d'une action de conversion est défini sur "false", l'action de conversion ne peut pas être mise aux enchères pour toutes les campagnes, quel que soit leur objectif de conversion client ou leur objectif de conversion de campagne. Toutefois, les objectifs de conversion personnalisés ne respectent pas la valeur primary_for_goal. Par conséquent, si une campagne comporte un objectif de conversion personnalisé configuré avec une action de conversion primary_for_goal = false, cette action de conversion reste enchérissable. Par défaut, la valeur de primary_for_goal est "true" si elle n'est pas définie. Dans la version 9, la valeur "false" ne peut être attribuée à "primary_for_goal" qu'après la création via une opération "update", car elle n'est pas déclarée comme facultative.

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.

bool

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

bool

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

int64

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

string

ID de l'application pour une action de conversion dans une application.

AttributionModel

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

DataDrivenModelStatus

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

string

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

string

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

int64

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

double

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.

string

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

bool

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

string

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

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

int64

ID de la variable personnalisée de conversion.

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.

string

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

ConversionCustomVariableStatus

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

string

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

ConversionCustomVariableFamily

Famille de la variable personnalisée de conversion.

ConversionCustomVariableCardinality

Cardinalité de la variable personnalisée de conversion.

FloodlightConversionCustomVariableInfo

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

int64

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

FloodlightVariableType

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

FloodlightVariableDataType

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

bool

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

ConversionTrackingStatus

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

bool

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

string

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

int64

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

int64

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

int64

ID de suivi des conversions de l'administrateur du client. Ce paramètre est défini lorsque le client a activé le suivi des conversions multicomptes et qu'il remplace le paramètre conversion_tracking_id.

string

Nom de ressource de la colonne personnalisée. Les noms de ressources de colonnes personnalisées ont la forme suivante:

customers/{customer_id}/customColumns/{custom_column_id}

int64

ID de la colonne personnalisée.

string

Nom défini par l'utilisateur de la colonne personnalisée.

string

Description définie par l'utilisateur de la colonne personnalisée.

CustomColumnValueType

Type de la valeur de résultat de la colonne personnalisée.

bool

Vrai lorsque la colonne personnalisée fait référence à un ou plusieurs attributs.

bool

Vrai lorsque la colonne personnalisée fait référence à une ou plusieurs métriques.

bool

Vrai lorsque la colonne personnalisée peut être utilisée dans la requête de SearchAds360Service.Search et SearchAds360Service.SearchStream.

string

Liste des colonnes système référencées de cette colonne personnalisée. Par exemple, une colonne personnalisée "somme des impressions et des clics" a référencé les colonnes système {"metrics.clicks", "metrics.impressions"}.

CustomColumnRenderType

Comment la valeur de résultat de la colonne personnalisée doit être interprétée.

string

Nom de la ressource du client. Les noms de ressources client ont la forme suivante:

customers/{customer_id}

ConversionTrackingSetting

Paramètre de suivi des conversions pour un client.

AccountType

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

DoubleClickCampaignManagerSetting

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

AccountStatus

État du compte (par exemple, "Activé", "Mis en veille", "Supprimé", etc.)

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

string

ID du compte dans le compte de moteur externe.

CustomerStatus

État du client.

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

int64

Numéro client de l'administrateur. Une valeur de 0 indique que le client ne dispose pas d'administrateur SA360.

string

Nom descriptif du gestionnaire.

int64

Numéro client de l'administrateur secondaire. Une valeur de 0 indique que le client ne dispose pas d'administrateur SA360 secondaire.

string

Nom descriptif de l'administrateur secondaire.

int64

Numéro client de l'administrateur associé. Une valeur de 0 indique que le client ne dispose pas d'administrateur associé SA360.

string

Nom descriptif du responsable associé.

AccountLevelType

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

int64

ID du client.

string

Nom descriptif facultatif et non unique du client.

string

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

string

ID du fuseau horaire local du client.

string

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

string

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

bool

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

bool

Indique si le client est un administrateur.

string

Nom de la ressource de l'asset client. Les noms de ressources CustomerAsset ont la forme suivante:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

string

Obligatoire. Élément associé au client.

AssetLinkStatus

État de l'asset du client.

string

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

customers/{customer_id}/customerAssetSets/{asset_set_id}

string

Ensemble d'éléments associé au client.

string

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

AssetSetLinkStatus

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

string

Nom de la ressource du client client. Les noms de ressources CustomerClient sont au format customers/{customer_id}/customerClients/{client_customer_id}.

string

Noms de ressource des libellés appartenant au client à l'origine de la demande et appliqués au client. Les noms de ressources d'étiquette ont la forme suivante:

customers/{customer_id}/labels/{label_id}

CustomerStatus

État du client client. Lecture seule.

string

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

bool

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

Lecture seule.

int64

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

string

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

bool

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

bool

Indique si le client est un administrateur. Lecture seule.

string

Nom descriptif du client. Lecture seule.

string

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

int64

ID du client client. Lecture seule.

string

Nom de la ressource. Les noms de ressources CustomerManagerLink ont la forme suivante: customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}.

ManagerLinkStatus

État du lien entre le client et le gestionnaire.

string

Client administrateur associé au client.

int64

ID de l'association client-administrateur. Ce champ est en lecture seule.

string

Code temporel de création de CustomerManagerLink. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

int64

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

int64

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

string

Fuseau horaire du réseau Campaign Manager associé à ce client, au format de la base de données des fuseaux horaires IANA (par exemple, Amérique du Nord/New_York).

string

Nom de la ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Les noms de ressources des vues de termes de recherche des annonces dynamiques du Réseau de Recherche se présentent sous la forme suivante:

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

string

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

Ce champ est en lecture seule.

string

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

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

string

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

geoTargetConstants/{geo_target_constant_id}

GeoTargetConstantStatus

État de la constante de ciblage géographique.

int64

ID de la constante de ciblage géographique.

string

Nom anglais de la constante de ciblage géographique.

string

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

string

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

string

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

string

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

geoTargetConstants/{parent_geo_target_constant_id}

string

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

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

string

Nom de la ressource. Les noms de ressources de libellé sont au format suivant: customers/{customer_id}/labels/{label_id}.

LabelStatus

État du libellé. Lecture seule.

TextLabel

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

int64

ID du libellé. Lecture seule.

string

Nom du libellé.

Ce champ est obligatoire. Il 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.

string

Nom de la ressource de la constante de langue. Les noms de ressources de constantes de langue ont la forme suivante:

languageConstants/{criterion_id}

int64

ID de la constante de langue.

string

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

string

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

bool

Indique si la langue peut être ciblée.

ProductBiddingCategory

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

ProductBrand

Marque d'une offre de produit.

ProductChannel

Localité d'une offre de produit.

ProductCondition

État d'une offre de produit.

ProductCustomAttribute

Attribut personnalisé d'une offre de produit.

ProductItemId

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

ProductType

Type d'offre de produit.

ListingGroupFilterBiddingCategoryLevel

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

int64

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

Cet ID est équivalent à l'ID google_product_category décrit dans cet article: https://support.google.com/merchants/answer/6324436.

string

Valeur de la chaîne de la marque du produit.

ListingGroupFilterProductChannel

Valeur de la localité.

ListingGroupFilterProductCondition

Valeur de la condition.

ListingGroupFilterCustomAttributeIndex

Indique l'index de l'attribut personnalisé.

string

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

string

Valeur de l'ID.

ListingGroupFilterProductTypeLevel

Niveau du type.

string

Valeur du type.

ListingGroupFilterDimension

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

string

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

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

string

Nom de la ressource de la catégorie d'enchères sur les produits. Les noms de ressources de la catégorie d'enchères sur les produits se présentent sous la forme suivante:

productBiddingCategoryConstants/{country_code}~{level}~{id}

ProductBiddingCategoryLevel

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

ProductBiddingCategoryStatus

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

int64

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

Cet ID est équivalent à l'ID google_product_category décrit dans cet article: https://support.google.com/merchants/answer/6324436.

string

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

string

Nom de la ressource de la catégorie d'enchères de produits parente.

string

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

string

Valeur à afficher de la catégorie d'enchères sur les produits localisée en fonction de language_code.

string

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

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

string

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

SearchAds360Fields/{name}

SearchAds360FieldCategory

Catégorie de l'artefact.

string

Noms de toutes les ressources, segments et métriques sélectionnables avec l'artefact décrit.

string

Noms de toutes les ressources sélectionnables avec l'artefact décrit. Les champs de ces ressources ne segmentent pas les métriques lorsqu'ils sont inclus dans les requêtes de recherche.

Ce champ n'est défini que pour les artefacts dont la catégorie est RESOURCE.

string

Ce champ liste les noms de toutes les métriques sélectionnables avec l'artefact décrit lorsqu'il est utilisé dans la clause FROM. Il n'est défini que pour les artefacts dont la catégorie est "RESSOURCE".

string

Ce champ liste les noms de tous les artefacts, qu'il s'agisse d'un segment ou d'une autre ressource, qui segmentent les métriques lorsqu'ils sont inclus dans les requêtes de recherche et lorsque l'artefact décrit est utilisé dans la clause FROM. Il n'est défini que pour les artefacts dont la catégorie est "RESSOURCE".

string

Valeurs que l'artefact peut prendre s'il s'agit d'un champ de type ENUM.

Ce champ n'est défini que pour les artefacts de la catégorie SEGMENT ou ATTRIBUTE.

SearchAds360FieldDataType

Ce champ détermine les opérateurs pouvant être utilisés avec l'artefact dans les clauses WHERE.

string

Nom de l'artefact.

bool

Indique si l'artefact peut être utilisé dans une clause SELECT dans les requêtes de recherche.

bool

Indique si l'artefact peut être utilisé dans une clause WHERE dans les requêtes de recherche.

bool

Indique si l'artefact peut être utilisé dans une clause ORDER BY dans les requêtes de recherche.

string

URL du proto décrivant le type de données de l'artefact.

bool

Indique si l'artefact de champ est répété.

string

Nom de la ressource de la vue "Performances Shopping". Les noms de ressources des vues des performances Shopping se présentent sous la forme: customers/{customer_id}/shoppingPerformanceView.

string

Nom de la ressource de la liste d'utilisateurs. Les noms de ressources de liste d'utilisateurs ont la forme suivante:

customers/{customer_id}/userLists/{user_list_id}

UserListType

Type de cette liste.

Ce champ est en lecture seule.

int64

ID de la liste d'utilisateurs.

string

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

string

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

customers/{customer_id}/userLocationViews/{country_criterion_id}~{targeting_location}

int64

ID du critère pour le pays.

bool

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

string

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

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

int64

ID de la visite.

int64

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

int64

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.

int64

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

string

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

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

string

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

ProductChannel

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

string

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

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.

string

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

int64

ID de l'élément avec lequel l'utilisateur a interagi lors de l'événement "visite".

AssetFieldType

Type de champ de l'élément de l'événement de visite.

string

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

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}