Package google.ads.searchads360.v0.resources

Index

• AccessibleBiddingStrategy (message)
• AccessibleBiddingStrategy.MaximizeConversionValue (message)
• AccessibleBiddingStrategy.MaximizeConversions (message)
• AccessibleBiddingStrategy.TargetCpa (message)
• AccessibleBiddingStrategy.TargetImpressionShare (message)
• AccessibleBiddingStrategy.TargetRoas (message)
• AccessibleBiddingStrategy.TargetSpend (message)
• Ad (message)
• AdGroup (message)
• AdGroupAd (message)
• AdGroupAdEffectiveLabel (message)
• AdGroupAdLabel (message)
• AdGroupAsset (message)
• AdGroupAssetSet (message)
• AdGroupAudienceView (message)
• AdGroupBidModifier (message)
• AdGroupCriterion (message)
• AdGroupCriterion.PositionEstimates (message)
• AdGroupCriterion.QualityInfo (message)
• AdGroupCriterionEffectiveLabel (message)
• AdGroupCriterionLabel (message)
• AdGroupEffectiveLabel (message)
• AdGroupLabel (message)
• AgeRangeView (message)
• Asset (message)
• AssetGroup (message)
• AssetGroupAsset (message)
• AssetGroupAssetCombinationData (message)
• AssetGroupListingGroupFilter (message)
• AssetGroupSignal (message)
• AssetGroupTopCombinationView (message)
• AssetSet (message)
• AssetSetAsset (message)
• Audience (message)
• BiddingStrategy (message)
• Campaign (message)
• Campaign.DynamicSearchAdsSetting (message)
• Campaign.GeoTargetTypeSetting (message)
• Campaign.NetworkSettings (message)
• Campaign.OptimizationGoalSetting (message)
• Campaign.SelectiveOptimization (message)
• Campaign.ShoppingSetting (message)
• Campaign.TrackingSetting (message)
• CampaignAsset (message)
• CampaignAssetSet (message)
• CampaignAudienceView (message)
• CampaignBudget (message)
• CampaignCriterion (message)
• CampaignEffectiveLabel (message)
• CampaignLabel (message)
• CartDataSalesView (message)
• Conversion (message)
• ConversionAction (message)
• ConversionAction.AttributionModelSettings (message)
• ConversionAction.FloodlightSettings (message)
• ConversionAction.ValueSettings (message)
• ConversionCustomVariable (message)
• ConversionCustomVariable.FloodlightConversionCustomVariableInfo (message)
• ConversionTrackingSetting (message)
• CustomColumn (message)
• Customer (message)
• CustomerAsset (message)
• CustomerAssetSet (message)
• CustomerClient (message)
• CustomerManagerLink (message)
• DoubleClickCampaignManagerSetting (message)
• DynamicSearchAdsSearchTermView (message)
• GenderView (message)
• GeoTargetConstant (message)
• KeywordView (message)
• Label (message)
• LanguageConstant (message)
• ListingGroupFilterDimension (message)
• ListingGroupFilterDimension.ProductBiddingCategory (message)
• ListingGroupFilterDimension.ProductBrand (message)
• ListingGroupFilterDimension.ProductChannel (message)
• ListingGroupFilterDimension.ProductCondition (message)
• ListingGroupFilterDimension.ProductCustomAttribute (message)
• ListingGroupFilterDimension.ProductItemId (message)
• ListingGroupFilterDimension.ProductType (message)
• ListingGroupFilterDimensionPath (message)
• LocationView (message)
• ProductBiddingCategoryConstant (message)
• ProductGroupView (message)
• SearchAds360Field (message)
• ShoppingPerformanceView (message)
• UserList (message)
• UserLocationView (message)
• Visit (message)
• WebpageView (message)

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 appartenant aux administrateurs du client et partagées avec ce client, en plus des stratégies appartenant à ce client. Cette ressource ne fournit pas de métriques et n'expose qu'un sous-ensemble limité des attributs BiddingStrategy.

Champs
resource_name	string Nom de ressource de la stratégie d'enchères accessible. Les noms de ressources AccessibleBiddingStrategy se présentent comme suit: customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}
id	int64 ID de la stratégie d'enchères.
name	string Nom de la stratégie d'enchères.
type	BiddingStrategyType Type de stratégie d'enchères.
owner_customer_id	int64 ID du client propriétaire de la stratégie d'enchères.
owner_descriptive_name	string Nom descriptif du client propriétaire de la stratégie d'enchères.
Champ d'union scheme. Schéma d'enchères. Vous ne pouvez en définir qu'une seule. scheme ne peut être qu'un des éléments suivants :
maximize_conversion_value	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.
maximize_conversions	MaximizeConversions Stratégie d'enchères automatiques qui vous aide à enregistrer un maximum de conversions pour vos campagnes tout en dépensant votre budget.
target_cpa	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.
target_impression_share	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.
target_roas	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.
target_spend	TargetSpend Stratégie d'enchères qui définit vos enchères pour vous aider à enregistrer un maximum de clics dans les limites de votre budget.

MaximizeConversionValue

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

Champs

target_roas

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

Maximiser les conversions

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.

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

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

TargetImpressionShare

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

Champs
location	TargetImpressionShareLocation Emplacement ciblé sur la page de résultats de recherche.
location_fraction_micros	int64 Fraction d'annonces à diffuser dans la zone géographique ciblée, en micros. Par exemple, 1 % équivaut à 10 000.
cpc_bid_ceiling_micros	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.

TargetRoas

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

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

TargetSpend

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

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

Annonce

Une annonce

Champs
resource_name	string Nom de ressource de l'annonce. Les noms de ressources d'annonces se présentent comme suit: customers/{customer_id}/ads/{ad_id}
final_urls[]	string Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce.
type	AdType Type d'annonce.
id	int64 Identifiant de l'annonce.
display_url	string URL qui s'affiche dans la description de certains formats d'annonces.
name	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.
Champ d'union ad_data. Informations pertinentes concernant le type d'annonce. Vous devez définir une seule valeur. ad_data ne peut être qu'un des éléments suivants :
text_ad	SearchAds360TextAdInfo Informations sur une annonce textuelle
expanded_text_ad	SearchAds360ExpandedTextAdInfo Informations concernant une annonce textuelle agrandie.
responsive_search_ad	SearchAds360ResponsiveSearchAdInfo Informations sur une annonce responsive sur le Réseau de Recherche.
product_ad	SearchAds360ProductAdInfo Informations sur une annonce produit
expanded_dynamic_search_ad	SearchAds360ExpandedDynamicSearchAdInfo Informations sur une annonce dynamique agrandie du Réseau de Recherche.

AdGroup

Un groupe d'annonces

Champs
resource_name	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}
status	AdGroupStatus État du groupe d'annonces.
type	AdGroupType Type du groupe d'annonces.
ad_rotation_mode	AdGroupAdRotationMode Mode de rotation des annonces du groupe d'annonces.
creation_time	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".
targeting_setting	TargetingSetting Paramètre pour les fonctionnalités liées au ciblage.
labels[]	string Noms de ressource des étiquettes associées à ce groupe d'annonces.
effective_labels[]	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.
engine_id	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".
start_date	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
end_date	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
language_code	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
last_modified_time	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	int64 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).
cpc_bid_micros	int64 Enchère au CPC (coût par clic) maximal.
engine_status	AdGroupEngineStatus État du moteur pour le groupe d'annonces.

AdGroupAd

Annonce intégrée à un groupe

Champs
resource_name	string Nom de ressource de l'annonce. Les noms de ressources d'annonces d'un groupe d'annonces se présentent comme suit: customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}
status	AdGroupAdStatus État de l'annonce.
ad	Ad Annonce.
creation_time	string Horodatage de la création de cette annonce de groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".
labels[]	string Noms de ressource des étiquettes associées à cette annonce de groupe d'annonces.
effective_labels[]	string Noms de ressource des étiquettes effectives associées à cette annonce. Un libellé effectif est un libellé hérité ou directement attribué à cette annonce.
engine_id	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".
engine_status	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.
last_modified_time	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".

AdGroupAdEffectiveLabel

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

Champs
resource_name	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}.
ad_group_ad	string Annonce du groupe d'annonces à laquelle le libellé effectif est associé.
label	string Libellé effectif attribué à l'annonce du groupe d'annonces.
owner_customer_id	int64 ID du client propriétaire du libellé effectif.

AdGroupAdLabel

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

Champs
resource_name	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}.
ad_group_ad	string Annonce du groupe d'annonces à laquelle le libellé est associé.
label	string Libellé attribué à l'annonce du groupe d'annonces.
owner_customer_id	int64 ID du client propriétaire du libellé.

AdGroupAsset

Lien entre un groupe d'annonces et un composant.

Champs
resource_name	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}
ad_group	string Obligatoire. Groupe d'annonces auquel l'élément est associé.
asset	string Obligatoire. L'élément associé au groupe d'annonces.
status	AssetLinkStatus État du composant du groupe d'annonces.

AdGroupAssetSet

AdGroupAssetSet est l'association entre un groupe d'annonces et un ensemble d'assets. Créer un ensemble d'assets de groupe d'annonces permet d'associer un ensemble d'assets à un groupe d'annonces.

Champs
resource_name	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}
ad_group	string Groupe d'annonces auquel cet ensemble d'éléments est associé.
asset_set	string Ensemble d'éléments associé au groupe d'annonces.
status	AssetSetLinkStatus État de l'ensemble d'éléments du groupe d'annonces. Lecture seule.

AdGroupAudienceView

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

Champs
resource_name	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}

AdGroupBidModifier

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

Champs
resource_name	string Nom de ressource du modificateur d'enchères 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}
bid_modifier	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.
Champ d'union criterion. Critère de ce modificateur d'enchère de groupe d'annonces. Obligatoire dans les opérations de création à partir de la version 5. criterion ne peut être qu'un des éléments suivants :
device	DeviceInfo Critère d'appareil.

AdGroupCriterion

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

Champs
resource_name	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}
creation_time	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	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é.
quality_info	QualityInfo Informations sur la qualité du critère.
type	CriterionType Type du critère.
labels[]	string Noms de ressource des étiquettes associées à ce critère de groupe d'annonces.
effective_labels[]	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 directement attribué à ce critère de groupe d'annonces.
position_estimates	PositionEstimates Estimations des enchères basées sur des critères à différentes positions.
final_urls[]	string Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce.
engine_id	string ID du critère de groupe d'annonces dans le compte de moteur externe. Ce champ ne concerne que les comptes autres que Google Ads (par exemple, Yahoo! Japan, Microsoft, Baidu, etc.). Pour une entité Google Ads, utilisez plutôt "ad_group_criterion.criterion_id".
last_modified_time	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".
criterion_id	int64 ID du critère.
ad_group	string Groupe d'annonces auquel appartient le critère.
negative	bool Indique si le critère doit être ciblé (false) ou exclu (true). Ce champ est immuable. Pour remplacer un critère positif par un critère négatif, supprimez-le, puis ajoutez-le à nouveau.
bid_modifier	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.
cpc_bid_micros	int64 Enchère au CPC (coût par clic).
effective_cpc_bid_micros	int64 L'enchère au CPC (coût par clic) effective.
engine_status	AdGroupCriterionEngineStatus État du moteur pour le critère de groupe d'annonces.
final_url_suffix	string Modèle d'URL permettant d'ajouter des paramètres à l'URL finale.
tracking_url_template	string Modèle d'URL permettant de créer une URL de suivi.
Champ d'union criterion. Critère du groupe d'annonces. Vous devez définir un seul de ces champs. criterion ne peut être qu'un des éléments suivants :
keyword	KeywordInfo Mot clé.
listing_group	ListingGroupInfo Groupe de fiches.
age_range	AgeRangeInfo Tranche d'âge.
gender	GenderInfo Gender.
user_list	UserListInfo Liste des utilisateurs.
webpage	WebpageInfo Page Web
location	LocationInfo Localisation.

PositionEstimates

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

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

QualityInfo

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

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

AdGroupCriterionEffectiveLabel

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

Champs
resource_name	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}.
ad_group_criterion	string Critère de groupe d'annonces auquel l'étiquette efficace est associée.
label	string Libellé effectif attribué au critère du groupe d'annonces.
owner_customer_id	int64 ID du client propriétaire du libellé effectif.

AdGroupCriterionLabel

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

Champs
resource_name	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}.
ad_group_criterion	string Critère du groupe d'annonces auquel le libellé est associé.
label	string Libellé attribué au critère du groupe d'annonces.
owner_customer_id	int64 ID du client propriétaire du libellé.

AdGroupEffectiveLabel

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

Champs
resource_name	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}.
ad_group	string Groupe d'annonces auquel le libellé effectif est associé.
label	string Libellé effectif attribué au groupe d'annonces.
owner_customer_id	int64 ID du client propriétaire du libellé effectif.

AdGroupLabel

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

Champs
resource_name	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 comme suit: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}
ad_group	string Groupe d'annonces auquel le libellé est associé.
label	string Libellé attribué au groupe d'annonces.
owner_customer_id	int64 Identifiant du client propriétaire du libellé.

AgeRangeView

Vue par tranche d'âge.

Champs
resource_name	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}

É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 composants sont immuables et ne peuvent pas être supprimés. Pour arrêter la diffusion d'un composant, supprimez-le de l'entité qui l'utilise.

Champs
resource_name	string Nom de ressource de l'élément. Les noms de ressources d'éléments ont la forme suivante: customers/{customer_id}/assets/{asset_id}
type	AssetType Type de l'asset.
final_urls[]	string Liste des URL finales possibles après toutes les redirections interdomaines.
status	AssetStatus État de l'élément.
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".
last_modified_time	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	int64 ID de l'élément.
name	string Nom facultatif du composant.
tracking_url_template	string Modèle d'URL permettant de créer une URL de suivi.
engine_status	AssetEngineStatus État dans le moteur d'un élément.
Champ d'union asset_data. Type spécifique de l'asset. asset_data ne peut être qu'un des éléments suivants :
youtube_video_asset	YoutubeVideoAsset Un élément vidéo YouTube.
image_asset	ImageAsset Composant Image
text_asset	TextAsset Un composant texte.
callout_asset	UnifiedCalloutAsset Composant Accroche unifié.
sitelink_asset	UnifiedSitelinkAsset Composant Lien annexe unifié.
page_feed_asset	UnifiedPageFeedAsset Élément de flux de pages unifié.
mobile_app_asset	MobileAppAsset Composant Application mobile
call_asset	UnifiedCallAsset Composant Appel unifié.
call_to_action_asset	CallToActionAsset Composant d'incitation à l'action.
location_asset	UnifiedLocationAsset Composant Lieu unifié.

AssetGroup

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

Champs
resource_name	string Nom de la ressource du groupe de composants. Les noms de ressources de groupe de composants se présentent sous la forme suivante : customers/{customer_id}/assetGroups/{asset_group_id}
id	int64 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 de composants. Obligatoire. Il doit comporter au moins un caractère et au maximum 128 caractères. Il doit être unique dans une campagne.
final_urls[]	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.
final_mobile_urls[]	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 désactivez cette fonctionnalité.
status	AssetGroupStatus État du groupe de composants.
path1	string Première partie du texte qui peut être ajoutée à l'URL affichée dans l'annonce.
path2	string Deuxième partie 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.
ad_strength	AdStrength Efficacité globale des annonces de ce groupe d'assets.

AssetGroupAsset

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

Champs
resource_name	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}
asset_group	string Groupe d'assets auquel cet asset est associé.
asset	string Élément auquel cet élément de groupe de composants est associé.
field_type	AssetFieldType Description de l'emplacement du composant dans le groupe de composants. Par exemple: HEADLINE, YOUTUBE_VIDEO, etc.
status	AssetLinkStatus État de l'association entre un élément et un groupe d'assets.

AssetGroupAssetCombinationData

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

Champs
asset_combination_served_assets[]	AssetUsage Éléments diffusés.

AssetGroupListingGroupFilter

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

Champs
resource_name	string Nom de la ressource du filtre de groupe de fiches (groupe de composants). Le nom de la ressource du filtre de groupe de fiches du groupe d'assets se présente comme suit: customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}
asset_group	string Groupe de composants auquel appartient ce filtre de groupe de fiches (groupe d'assets).
id	int64 ID du ListingGroupFilter.
type	ListingGroupFilterType Type d'un nœud de filtre de groupe de fiches.
vertical	ListingGroupFilterVertical Verticale que l'arborescence du nœud actuel représente. Tous les nœuds d'un même arbre doivent appartenir au même secteur.
case_value	ListingGroupFilterDimension Valeur de dimension avec laquelle ce groupe de fiches affine son parent. Indéfini pour le groupe racine.
parent_listing_group_filter	string Nom de la ressource de la subdivision du groupe d'annonces parent. "Null" pour le nœud de filtre de groupe de fiches racine.
path	ListingGroupFilterDimensionPath Chemin des dimensions qui définissent ce filtre de groupe de fiches.

AssetGroupSignal

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

Champs
resource_name	string Nom de la ressource du signal du groupe de composants. Le nom de la ressource du signal de groupe d'assets se présente sous la forme suivante : customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}
asset_group	string Groupe de composants auquel appartient ce signal de groupe de composants.
Champ d'union signal. Signal du groupe d'assets. signal ne peut être qu'un des éléments suivants :
audience	AudienceInfo Signal d'audience à utiliser par la campagne Performance Max.

AssetGroupTopCombinationView

Aperçu de l'utilisation de la combinaison d'assets d'annonces du groupe d'annonces.

Champs
resource_name	string Nom de ressource de la vue des combinaisons principales du groupe d'assets. 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}".
asset_group_top_combinations[]	AssetGroupAssetCombinationData Combinaisons d'assets les plus populaires diffusées ensemble.

AssetSet

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

Champs
id	int64 ID de l'ensemble de composants.
resource_name	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}

AssetSetAsset

AssetSetAsset est le lien entre un élément et un ensemble d'éléments. Ajouter un AssetSetAsset permet d'associer un élément à un ensemble d'éléments.

Champs
resource_name	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}
asset_set	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	AssetSetAssetStatus État de l'élément de l'ensemble d'assets. Lecture seule.

Audience

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

Champs
resource_name	string Nom de la ressource de l'audience. Les noms d'audience se présentent comme suit: customers/{customer_id}/audiences/{audience_id}
id	int64 ID de l'audience.
name	string Obligatoire. Nom de l'audience. Il doit être unique pour toutes les audiences. Il doit comporter au moins un caractère et au maximum 255 caractères.
description	string Description de cette audience.

BiddingStrategy

Une stratégie d'enchères.

Champs
resource_name	string Nom de la ressource de la stratégie d'enchères. Les noms de ressources de stratégie d'enchères se présentent comme suit: customers/{customer_id}/biddingStrategies/{bidding_strategy_id}
status	BiddingStrategyStatus État de la stratégie d'enchères. Ce champ est en lecture seule.
type	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.
currency_code	string Devise utilisée par la stratégie d'enchères (code ISO 4217 à trois lettres). Pour les stratégies d'enchères dans les comptes client administrateur, cette devise peut être définie lors de la création et est définie par défaut sur la devise du compte client administrateur. Pour les clients diffuseurs, ce champ ne peut pas être défini. Toutes les stratégies d'un client diffuseur utilisent implicitement la devise du client diffuseur. Dans tous les cas, le champ "code_devise_effective" renvoie la devise utilisée par la stratégie.
id	int64 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).
effective_currency_code	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.
campaign_count	int64 Nombre de campagnes associées à cette stratégie d'enchères. Ce champ est en lecture seule.
non_removed_campaign_count	int64 Nombre de campagnes non supprimées associées à cette stratégie d'enchères. Ce champ est en lecture seule.
Champ d'union scheme. Schéma d'enchères. Vous ne pouvez en définir qu'un seul. scheme ne peut être qu'un des éléments suivants :
enhanced_cpc	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 plus faibles.
maximize_conversion_value	MaximizeConversionValue Stratégie d'enchères automatiques qui vous aide à maximiser la valeur de conversion de vos campagnes tout en dépensant votre budget.
maximize_conversions	MaximizeConversions Stratégie d'enchères automatiques qui vous aide à enregistrer un maximum de conversions pour vos campagnes tout en dépensant votre budget.
target_cpa	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.
target_impression_share	TargetImpressionShare Stratégie d'enchères qui optimise automatiquement les enchères en fonction d'un pourcentage d'impressions choisi.
target_outrank_share	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 vers des stratégies dans lesquelles ce schéma est déjà renseigné sont autorisées.
target_roas	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.
target_spend	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.

Campagne

Une campagne

Champs
resource_name	string Nom de la ressource de la campagne. Les noms de ressources de campagne se présentent comme suit: customers/{customer_id}/campaigns/{campaign_id}
status	CampaignStatus État de la campagne. Lorsque vous ajoutez une campagne, son état est défini par défaut sur "ACTIVE".
serving_status	CampaignServingStatus État de diffusion des annonces de la campagne.
bidding_strategy_system_status	BiddingStrategySystemStatus État du système de la stratégie d'enchères de la campagne.
ad_serving_optimization_status	AdServingOptimizationStatus État de l'optimisation de la diffusion d'annonces de la campagne.
advertising_channel_type	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é.
advertising_channel_sub_type	AdvertisingChannelSubType Affinement facultatif pour 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é.
url_custom_parameters[]	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.
real_time_bidding_setting	RealTimeBiddingSetting Paramètres des enchères en temps réel, une fonctionnalité disponible uniquement pour les campagnes ciblant le réseau Ad Exchange.
network_settings	NetworkSettings Paramètres des réseaux de la campagne.
dynamic_search_ads_setting	DynamicSearchAdsSetting Paramètre permettant de contrôler les annonces dynamiques du Réseau de Recherche (ADR).
shopping_setting	ShoppingSetting Paramètre permettant de contrôler les campagnes Shopping.
geo_target_type_setting	GeoTargetTypeSetting Paramètre du ciblage géographique des annonces.
effective_labels[]	string Noms de ressource des étiquettes effectives associées à cette campagne. Un libellé efficace est un libellé hérité ou directement attribué à cette campagne.
labels[]	string Noms de ressource des étiquettes associées à cette campagne.
bidding_strategy_type	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.
accessible_bidding_strategy	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 limités ne sont disponibles que pour le client propriétaire de la stratégie et ses responsables. Les attributs limités ne peuvent être lus que depuis la ressource BiddingStrategy.
frequency_caps[]	FrequencyCapEntry Liste qui limite la fréquence à laquelle chaque utilisateur verra les annonces de cette campagne.
selective_optimization	SelectiveOptimization Paramètre d'optimisation sélective pour cette campagne, qui comprend un ensemble d'actions de conversion à optimiser pour cette campagne. Cette fonctionnalité ne s'applique qu'aux campagnes pour applications qui utilisent MULTI_CHANNEL comme AdvertisingChannelType et APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT comme AdvertisingChannelSubType.
optimization_goal_setting	OptimizationGoalSetting Paramètre d'objectif d'optimisation pour cette campagne, qui inclut un ensemble de types d'objectifs d'optimisation.
tracking_setting	TrackingSetting Paramètres au niveau de la campagne pour les informations de suivi.
engine_id	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".
excluded_parent_asset_field_types[]	AssetFieldType Types de champs d'assets à 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.
create_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". create_time sera abandonné dans la version 1. Utilisez plutôt "creation_time".
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".
last_modified_time	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	int64 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).
tracking_url_template	string Modèle d'URL permettant de créer une URL de suivi.
campaign_budget	string Nom de la ressource du budget de la campagne.
start_date	string Date à laquelle la diffusion de la campagne a commencé dans le fuseau horaire du client au format AAAA-MM-JJ.
end_date	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.
final_url_suffix	string Suffixe utilisé pour ajouter des paramètres de requête aux pages de destination diffusées avec le suivi parallèle.
url_expansion_opt_out	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'intégralité du domaine sera ciblée. Ce champ ne peut être défini que pour les campagnes Performance Max, dont la valeur par défaut est "false".
Champ d'union campaign_bidding_strategy. Stratégie d'enchères de la campagne. Doit être une stratégie de portefeuille (créée via le service BiddingStrategy) ou standard, intégrée à la campagne. campaign_bidding_strategy ne peut être qu'un des éléments suivants :
bidding_strategy	string Nom de ressource de la stratégie de portefeuille d'enchères utilisée par la campagne.
manual_cpa	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.
manual_cpc	ManualCpc Stratégie d'enchères au CPC manuelles standard. Enchères manuelles basées sur les clics, où l'utilisateur paie par clic.
manual_cpm	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
maximize_conversions	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.
maximize_conversion_value	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.
target_cpa	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.
target_impression_share	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.
target_roas	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.
target_spend	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.
percent_cpc	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.
target_cpm	TargetCpm Il s'agit d'une stratégie d'enchères qui optimise automatiquement le coût pour mille impressions.

DynamicSearchAdsSetting

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

Champs
domain_name	string Obligatoire. Nom de domaine Internet représenté par ce paramètre (par exemple, "google.com" ou "www.google.com").
language_code	string Obligatoire. Code de langue spécifiant la langue du domaine (par exemple, "en").
use_supplied_urls_only	bool Indique si la campagne utilise exclusivement des URL fournies par l'annonceur.

GeoTargetTypeSetting

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

Champs
positive_geo_target_type	PositiveGeoTargetType Paramètre utilisé pour le ciblage géographique à inclure dans cette campagne spécifique.
negative_geo_target_type	NegativeGeoTargetType Paramètre utilisé pour le ciblage géographique négatif dans cette campagne spécifique.

NetworkSettings

Paramètres des réseaux de la campagne.

Champs
target_google_search	bool Indique si les annonces seront diffusées avec les résultats de recherche google.com.
target_search_network	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).
target_content_network	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.
target_partner_search_network	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.

OptimizationGoalSetting

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

Champs
optimization_goal_types[]	OptimizationGoalType Liste des types d'objectifs d'optimisation.

SelectiveOptimization

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

Champs
conversion_actions[]	string Ensemble de noms de ressources sélectionnés pour les actions de conversion afin d'optimiser cette campagne.

ShoppingSetting

Paramètre des campagnes Shopping. Définit l'univers des produits pouvant être promus par la campagne et la façon dont elle interagit avec d'autres campagnes Shopping.

Champs
feed_label	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". S'il est utilisé à la place de sales_country, le champ feed_label accepte 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.
use_vehicle_inventory	bool Permet de cibler ou non l'inventaire des véhicules.
merchant_id	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.
sales_country	string Pays de vente des produits à inclure dans la campagne.
campaign_priority	int32 Priorité de la campagne. Les campagnes ayant des priorités numériques plus élevées ont la priorité sur celles ayant des priorités plus faibles. Ce champ est obligatoire pour les campagnes Shopping. Les valeurs doivent être comprises entre 0 et 2 inclus. Ce champ est facultatif pour les campagnes Shopping intelligentes, mais doit être égal à 3 s'il est défini.
enable_local	bool Permet d'inclure ou non les produits en magasin.

TrackingSetting

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

Champs
tracking_url	string URL utilisée pour le suivi dynamique.

CampaignAsset

Lien entre une campagne et un composant.

Champs
resource_name	string Nom de ressource du composant de campagne. Les noms de ressources CampaignAsset ont la forme suivante: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}
status	AssetLinkStatus État du composant de la campagne.
campaign	string La campagne à laquelle l'élément est associé.
asset	string L'élément associé à la campagne.

CampaignAssetSet

CampaignAssetSet est l'association entre une campagne et un ensemble d'assets. Ajouter un CampaignAssetSet permet d'associer un ensemble de composants à une campagne.

Champs
resource_name	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}
campaign	string Campagne à laquelle cet ensemble d'éléments est associé.
asset_set	string Ensemble d'éléments associé à la campagne.
status	AssetSetLinkStatus État du composant de l'ensemble de composants de la campagne. Lecture seule.

CampaignAudienceView

Vue de l'audience d'une campagne. Inclut les données de performances des centres d'intérêt et des listes de remarketing pour les annonces sur le Réseau Display et le Réseau YouTube, ainsi que les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), agrégées par campagne et critère d'audience. Cette vue n'inclut que les audiences associées au niveau de la campagne.

Champs
resource_name	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}

CampaignBudget

Un budget de campagne.

Champs
resource_name	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}
delivery_method	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	BudgetPeriod Période au cours de laquelle dépenser le budget. En l'absence de spécification, la valeur par défaut est DAILY.
amount_micros	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.

CampaignCriterion

Critère de campagne

Champs
resource_name	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}
display_name	string Nom à afficher du critère. Ce champ est ignoré pour les mutations.
type	CriterionType Type du critère.
status	CampaignCriterionStatus État du critère.
last_modified_time	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".
criterion_id	int64 ID du critère. Ce champ est ignoré lors de l'opération mutate.
bid_modifier	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.
negative	bool Permet de cibler (false) ou d'exclure (true) le critère.
Champ d'union criterion. Le critère de la campagne. Vous devez définir un seul de ces champs. criterion ne peut être qu'un des éléments suivants :
keyword	KeywordInfo Mot clé.
location	LocationInfo Localisation.
device	DeviceInfo appareil.
age_range	AgeRangeInfo Tranche d'âge.
gender	GenderInfo Gender.
user_list	UserListInfo Liste d'utilisateurs.
language	LanguageInfo HashiCorp.
webpage	WebpageInfo Page Web
location_group	LocationGroupInfo Groupe de zones géographiques

CampaignEffectiveLabel

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

Champs
resource_name	string Nom de la ressource. Les noms de ressources CampaignEffectivelabel ont la forme suivante: customers/{customer_id}/campaignEffectiveLabels/{campaign_id}~{label_id}
campaign	string Campagne à laquelle le libellé "effective" est associé.
label	string Libellé effectif attribué à la campagne.
owner_customer_id	int64 ID du client propriétaire du libellé effectif.

CampaignLabel

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

Champs
resource_name	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}.
campaign	string Campagne à laquelle le libellé est associé.
label	string Libellé attribué à la campagne.
owner_customer_id	int64 ID du client propriétaire du libellé.

CartDataSalesView

Vue des ventes des données du panier.

Champs
resource_name	string Nom de la ressource de la vue "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.

Conversion

Une conversion.

Champs
resource_name	string Nom de 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}
id	int64 Identifiant de la conversion
criterion_id	int64 ID du critère Search Ads 360. Une valeur de 0 indique que le critère n'est pas attribué.
merchant_id	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.
ad_id	int64 Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée.
click_id	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.
visit_id	int64 ID de visite Search Ads 360 auquel la conversion est attribuée.
advertiser_conversion_id	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.
product_id	string Identifiant du produit ayant fait l'objet d'un clic.
product_channel	ProductChannel Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin.
product_language_code	string Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit.
product_store_id	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.
product_country_code	string Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic.
attribution_type	AttributionType Élément auquel la conversion est attribuée : visite ou mot clé + annonce.
conversion_date_time	string Code temporel de l'événement de conversion.
conversion_last_modified_date_time	string Code temporel de la dernière modification de la conversion.
conversion_visit_date_time	string Code temporel de la visite à laquelle la conversion est attribuée.
conversion_quantity	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.
conversion_revenue_micros	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.
floodlight_original_revenue	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.
floodlight_order_id	string ID de commande Floodlight fourni par l'annonceur pour la conversion.
status	ConversionStatus État de la conversion (ACTIVÉ ou SUPPRIMÉ).
asset_id	int64 ID de l'élément avec lequel l'utilisateur a interagi lors de l'événement de conversion.
asset_field_type	AssetFieldType Type de champ de composant de l'événement de conversion.

ConversionAction

Une action de conversion.

Champs
resource_name	string Nom de ressource de l'action de conversion. Les noms de ressources des actions de conversion se présentent comme suit: customers/{customer_id}/conversionActions/{conversion_action_id}
creation_time	string Horodatage de la création de l'activité Floodlight, au format ISO 8601.
status	ConversionActionStatus État de cette action de conversion pour le décompte des événements de conversion.
type	ConversionActionType Type d'action de conversion.
category	ConversionActionCategory Catégorie des conversions enregistrées pour cette action de conversion.
value_settings	ValueSettings Paramètres liés à la valeur des événements de conversion associés à cette action de conversion.
attribution_model_settings	AttributionModelSettings Paramètres liés au modèle d'attribution de cette action de conversion.
floodlight_settings	FloodlightSettings Paramètres Floodlight pour les types de conversion Floodlight.
id	int64 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.
primary_for_goal	bool Si le bit "primary_for_goal" 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 du client. 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" définie sur "false", cette action de conversion reste enchérissable. Par défaut, la valeur "primary_for_goal" est "true" si elle n'est pas définie. Dans V9, la valeur "primary_for_goal" ne peut être définie sur "false" qu'après sa création via une opération de mise à jour, car elle n'est pas déclarée comme facultative.
owner_customer	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.
include_in_client_account_conversions_metric	bool Indique si cette action de conversion doit être incluse dans la métrique "client_account_conversions".
include_in_conversions_metric	bool Indique si cette action de conversion doit être incluse dans la métrique "Conversions".
click_through_lookback_window_days	int64 Nombre maximal de jours entre une interaction (un clic, par exemple) et un événement de conversion.
app_id	string ID d'application pour une action de conversion d'application.

AttributionModelSettings

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

Champs
attribution_model	AttributionModel Type de modèle d'attribution de cette action de conversion.
data_driven_model_status	DataDrivenModelStatus État du modèle d'attribution basée sur les données pour l'action de conversion.

FloodlightSettings

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

Champs
activity_group_tag	string Chaîne permettant d'identifier un groupe d'activités Floodlight lors de la création de rapports sur les conversions.
activity_tag	string Chaîne permettant d'identifier une activité Floodlight lors de la création de rapports sur les conversions.
activity_id	int64 ID de l'activité Floodlight dans DoubleClick Campaign Manager (DCM).

ValueSettings

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

Champs
default_value	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.
default_currency_code	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.
always_use_default_value	bool Indique si la valeur par défaut et le code de devise par défaut sont utilisés à la place de la valeur et du code de devise spécifiés dans les événements de conversion pour cette action de conversion.

ConversionCustomVariable

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

Champs
resource_name	string Nom de ressource de la variable personnalisée de conversion. Les noms de ressources des variables personnalisées de conversion se présentent sous la forme suivante : customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}
id	int64 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. 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".
status	ConversionCustomVariableStatus État de la variable personnalisée de conversion pour le décompte des événements de conversion.
owner_customer	string Nom de la ressource du client propriétaire de la variable personnalisée de conversion.
family	ConversionCustomVariableFamily Famille de la variable personnalisée de conversion.
cardinality	ConversionCustomVariableCardinality Cardinalité de la variable personnalisée de conversion.
floodlight_conversion_custom_variable_info	FloodlightConversionCustomVariableInfo Champs pour les variables personnalisées de conversion Floodlight Search Ads 360.
custom_column_ids[]	int64 ID des colonnes personnalisées qui utilisent cette variable personnalisée de conversion.

FloodlightConversionCustomVariableInfo

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

Champs
floodlight_variable_type	FloodlightVariableType Type de variable Floodlight défini dans Search Ads 360.
floodlight_variable_data_type	FloodlightVariableDataType Type de données de la variable Floodlight défini dans Search Ads 360.

ConversionTrackingSetting

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

Champs
accepted_customer_data_terms	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 la page https://support.google.com/adspolicy/answer/7475709.
conversion_tracking_status	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.
enhanced_conversions_for_leads_enabled	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.
google_ads_conversion_customer	string Nom de la ressource du client où les conversions sont créées et gérées. Ce champ est en lecture seule.
conversion_tracking_id	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.
google_ads_cross_account_conversion_tracking_id	int64 ID de suivi des conversions de l'administrateur du client. Il est défini lorsque le client active le suivi des conversions et remplace "conversion_tracking_id". Ce champ ne peut être géré que via l'interface utilisateur Google Ads. Ce champ est en lecture seule.
cross_account_conversion_tracking_id	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.

CustomColumn

Colonne personnalisée. Découvrez la colonne personnalisée Search Ads 360 à l'adresse https://support.google.com/sa360/answer/9633916

Champs
resource_name	string Nom de ressource de la colonne personnalisée. Les noms de ressources des colonnes personnalisées se présentent sous la forme suivante: customers/{customer_id}/customColumns/{custom_column_id}
id	int64 ID de la colonne personnalisée.
name	string Nom de la colonne personnalisée défini par l'utilisateur.
description	string Description définie par l'utilisateur de la colonne personnalisée.
value_type	CustomColumnValueType Type de la valeur de résultat de la colonne personnalisée.
references_attributes	bool Vrai lorsque la colonne personnalisée fait référence à un ou plusieurs attributs.
references_metrics	bool Vrai lorsque la colonne personnalisée fait référence à une ou plusieurs métriques.
queryable	bool Vrai lorsque la colonne personnalisée peut être utilisée dans la requête de SearchAds360Service.Search et SearchAds360Service.SearchStream.
referenced_system_columns[]	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"}.
render_type	CustomColumnRenderType Façon dont la valeur du résultat de la colonne personnalisée doit être interprétée.

Client

Un client.

Champs
resource_name	string Nom de la ressource du client. Les noms de ressources client ont la forme suivante : customers/{customer_id}
conversion_tracking_setting	ConversionTrackingSetting Paramètre de suivi des conversions pour un client.
account_type	AccountType Type de compte de moteur (par exemple, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Suivi de moteur).
double_click_campaign_manager_setting	DoubleClickCampaignManagerSetting Paramètre DoubleClick Campaign Manager (DCM) pour un client administrateur.
account_status	AccountStatus État du compte (par exemple, "Activé", "Mis en veille", "Supprimé", etc.)
last_modified_time	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".
engine_id	string ID du compte dans le compte de moteur externe.
status	CustomerStatus État du client.
creation_time	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	int64 ID du client.
descriptive_name	string Nom descriptif facultatif et non unique du client.
currency_code	string Devise de fonctionnement du compte. Accepte un sous-ensemble de codes de devise ISO 4217.
time_zone	string ID du fuseau horaire local du client.
tracking_url_template	string Modèle d'URL permettant de créer une URL de suivi à partir de paramètres.
final_url_suffix	string Modèle d'URL permettant d'ajouter des paramètres à l'URL finale.
auto_tagging_enabled	bool Indique si le taggage automatique est activé pour le client.
manager	bool Indique si le client est un administrateur.

CustomerAsset

Lien entre un client et un élément.

Champs
resource_name	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}
asset	string Obligatoire. Élément associé au client.
status	AssetLinkStatus État de l'asset du client.

CustomerAssetSet

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

Champs
resource_name	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}
asset_set	string Ensemble d'éléments associé au client.
customer	string Client auquel cet ensemble d'éléments est associé.
status	AssetSetLinkStatus État de l'asset de l'ensemble d'assets du client. Lecture seule.

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.

Champs
resource_name	string Nom de ressource du client client. Les noms de ressources CustomerClient sont au format customers/{customer_id}/customerClients/{client_customer_id}.
applied_labels[]	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}
status	CustomerStatus État du client client. Lecture seule.
client_customer	string Nom de la ressource du client-client associé au client donné. Lecture seule.
hidden	bool Indique s'il s'agit d'un compte masqué. Lecture seule.
level	int64 Distance entre un client donné et un client donné. Pour les liens internes, la valeur de niveau est 0. Lecture seule.
time_zone	string Représentation de la chaîne CLDR (Common Locale Data Repository) du fuseau horaire du client, par exemple America/Los_Angeles. Lecture seule.
test_account	bool Indique si le client est un compte test. Lecture seule.
manager	bool Indique si le client est un administrateur. Lecture seule.
descriptive_name	string Nom descriptif du client. Lecture seule.
currency_code	string Code de devise (par exemple, "USD" ou "EUR") pour le client. Lecture seule.
id	int64 ID du client client. Lecture seule.

CustomerManagerLink

Représente la relation de liaison client-gestionnaire.

Champs
resource_name	string Nom de la ressource. Les noms de ressources CustomerManagerLink ont la forme suivante : customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}.
status	ManagerLinkStatus État de l'association entre le client et l'administrateur.
manager_customer	string Client administrateur associé au client.
manager_link_id	int64 ID de l'association client-administrateur. Ce champ est en lecture seule.
start_time	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".

DoubleClickCampaignManagerSetting

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

Champs
advertiser_id	int64 ID de l'annonceur Campaign Manager associé à ce client.
network_id	int64 ID du réseau Campaign Manager associé à ce client.
time_zone	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).

DynamicSearchAdsSearchTermView

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

Champs
resource_name	string Nom de ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Les noms de ressources des vues 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}
landing_page	string URL de la page de destination sélectionnée dynamiquement de l'impression. Ce champ est en lecture seule.

GenderView

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

Champs
resource_name	string Nom de ressource de la vue du 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}

GeoTargetConstant

Constante de cible géographique

Champs
resource_name	string Nom de la ressource de la constante de ciblage géographique. Les noms de ressources de constantes de ciblage géographique ont la forme suivante : geoTargetConstants/{geo_target_constant_id}
status	GeoTargetConstantStatus État de la constante de ciblage géographique.
id	int64 ID de la constante de ciblage géographique.
name	string Nom anglais de la constante de ciblage géographique.
country_code	string Code pays ISO-3166-1 alpha-2 associé à la cible.
target_type	string Type de cible constante de la cible géographique.
canonical_name	string Nom anglais complet, composé du nom de la cible, de celui de son parent et de son pays.
parent_geo_target	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}

KeywordView

Affichage des mots clés.

Champs
resource_name	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}

Libellé

Un libellé.

Champs
resource_name	string Nom de la ressource. Les noms de ressources de libellé sont au format suivant : customers/{customer_id}/labels/{label_id}.
status	LabelStatus État du libellé. Lecture seule.
text_label	TextLabel Type de libellé affichant du texte sur un arrière-plan de couleur.
id	int64 ID du libellé. Lecture seule.
name	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.

LanguageConstant

Une langue.

Champs
resource_name	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}
id	int64 ID de la constante de langue.
code	string Code de langue (par exemple, "en_US", "en_AU", "es", "fr", etc.)
name	string Nom complet de la langue en anglais, par exemple "English (US)", "Spanish", etc.
targetable	bool Indique si la langue peut être ciblée.

ListingGroupFilterDimension

Dimensions de fiches pour le filtre de groupe de fiches (groupe d'assets).

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 :
product_bidding_category	ProductBiddingCategory Catégorie d'enchères d'une offre de produit.
product_brand	ProductBrand Marque d'une offre de produit.
product_channel	ProductChannel Localité d'une offre de produit.
product_condition	ProductCondition État d'une offre de produit.
product_custom_attribute	ProductCustomAttribute Attribut personnalisé d'une offre de produit.
product_item_id	ProductItemId Identifiant de l'article d'une offre.
product_type	ProductType Type d'offre de produit.

ProductBiddingCategory

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

Champs
level	ListingGroupFilterBiddingCategoryLevel Indique le niveau de la catégorie dans la taxonomie.
id	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.

ProductBrand

Marque du produit.

Champs
value	string Valeur de la chaîne de la marque du produit.

ProductChannel

Localité d'une offre de produit.

Champs
channel	ListingGroupFilterProductChannel Valeur de la localité.

ProductCondition

État d'une offre de produit.

Champs
condition	ListingGroupFilterProductCondition Valeur de la condition.

ProductCustomAttribute

Attribut personnalisé d'une offre de produit.

Champs
index	ListingGroupFilterCustomAttributeIndex Indique l'index de l'attribut personnalisé.
value	string Valeur de la chaîne de l'attribut personnalisé du produit.

ProductItemId

Identifiant de l'article d'une offre.

Champs
value	string Valeur de l'ID.

ProductType

Type d'offre de produit.

Champs
level	ListingGroupFilterProductTypeLevel Niveau du type.
value	string Valeur du type.

ListingGroupFilterDimensionPath

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

Champs
dimensions[]	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.

LocationView

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

Champs
resource_name	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}

ProductBiddingCategoryConstant

Une catégorie d'enchères sur les produits.

Champs
resource_name	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}
level	ProductBiddingCategoryLevel Niveau de la catégorie d'enchères du produit.
status	ProductBiddingCategoryStatus État de la catégorie d'enchères du produit.
id	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.
country_code	string Code pays à deux lettres en majuscules de la catégorie d'enchères du produit.
product_bidding_category_constant_parent	string Nom de la ressource de la catégorie d'enchères de produits parente.
language_code	string Code de langue de la catégorie d'enchères du produit.
localized_name	string Valeur à afficher de la catégorie d'enchères sur les produits localisée en fonction de language_code.

ProductGroupView

Vue d'un groupe de produits.

Champs
resource_name	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}

SearchAds360Field

Champ ou ressource (artefact) utilisé par SearchAds360Service.

Champs
resource_name	string Nom de la ressource de l'artefact. Les noms de ressources d'artefact se présentent sous la forme suivante: SearchAds360Fields/{name}
category	SearchAds360FieldCategory Catégorie de l'artefact.
selectable_with[]	string Noms de toutes les ressources, segments et métriques sélectionnables avec l'artefact décrit.
attribute_resources[]	string Noms de toutes les ressources pouvant être sélectionnées 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.
metrics[]	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".
segments[]	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 RESOURCE.
enum_values[]	string Valeurs que l'artefact peut supposer 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.
data_type	SearchAds360FieldDataType Ce champ détermine les opérateurs qui peuvent être utilisés avec l'artefact dans les clauses WHERE.
name	string Nom de l'artefact.
selectable	bool Indique si l'artefact peut être utilisé dans une clause SELECT dans les requêtes de recherche.
filterable	bool Indique si l'artefact peut être utilisé dans une clause WHERE dans les requêtes de recherche.
sortable	bool Indique si l'artefact peut être utilisé dans une clause ORDER BY dans les requêtes de recherche.
type_url	string URL du proto décrivant le type de données de l'artefact.
is_repeated	bool Indique si l'artefact de champ est répété.

ShoppingPerformanceView

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

Champs
resource_name	string Nom de la ressource de la vue "Performances Shopping". Les noms des ressources de la vue des performances Shopping sont au format suivant: customers/{customer_id}/shoppingPerformanceView

UserList

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

Champs
resource_name	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}
type	UserListType Type de la liste. Ce champ est en lecture seule.
id	int64 ID de la liste d'utilisateurs.
name	string Nom de cette liste d'utilisateurs. Selon la valeur de access_reason, le nom de la liste d'utilisateurs peut ne pas être unique (par exemple, si access_reason=SHARED).

UserLocationView

Vue de la position de l'utilisateur.

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

Champs
resource_name	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}
country_criterion_id	int64 Identifiant du critère du pays.
targeting_location	bool Indique si l'emplacement a été ciblé ou non.

Accéder à la page

Une visite.

Champs
resource_name	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}
id	int64 ID de la visite.
criterion_id	int64 Identifiant de mot clé Search Ads 360 La valeur 0 indique que le mot clé n'est pas attribué.
merchant_id	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.
ad_id	int64 Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée.
click_id	string Chaîne unique pour chaque visite, transmise à la page de destination en tant que paramètre d'URL d'ID de clic.
visit_date_time	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".
product_id	string Identifiant du produit ayant fait l'objet d'un clic.
product_channel	ProductChannel Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin.
product_language_code	string Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit.
product_store_id	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.
product_country_code	string Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic.
asset_id	int64 ID de l'élément avec lequel l'utilisateur a interagi lors de l'événement "visite".
asset_field_type	AssetFieldType Type de champ de l'élément de l'événement de visite.

WebpageView

Affichage d'une page Web.

Champs
resource_name	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}