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 lui.
Contrairement à BiddingStrategy, cette ressource inclut les stratégies appartenant aux administrateurs du client et partagées avec ce client, en plus des stratégies appartenant à ce client. Cette ressource ne fournit pas de métriques et n'expose qu'un sous-ensemble limité des attributs BiddingStrategy.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la stratégie d'enchères accessible. Les noms de ressources AccessibleBiddingStrategy se présentent sous la forme suivante :
|
id |
ID de la stratégie d'enchères. |
name |
Nom de la stratégie d'enchères. |
type |
Type de stratégie d'enchères. |
owner_customer_id |
ID du client propriétaire de la stratégie d'enchères. |
owner_descriptive_name |
descriptive_name du client propriétaire de la stratégie d'enchères. |
Champ d'union Vous ne pouvez en définir qu'un seul. |
|
maximize_conversion_value |
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 |
Stratégie d'enchères automatiques qui vous permet de maximiser le nombre de conversions pour vos campagnes sans dépasser votre budget. |
target_cpa |
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 |
Stratégie d'enchères qui optimise automatiquement les enchères en fonction d'un pourcentage d'impressions choisi. |
target_roas |
Stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant, en moyenne, un retour sur les dépenses publicitaires (ROAS) cible spécifique. |
target_spend |
Stratégie d'enchères qui définit vos enchères pour vous permettre d'enregistrer un maximum de clics dans les limites de votre budget. |
MaximizeConversionValue
Stratégie d'enchères automatiques qui vous aide à maximiser la valeur de conversion de vos campagnes tout en dépensant votre budget.
| Champs | |
|---|---|
target_roas |
L'option "ROAS cible". Si elle est définie, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, le retour sur les dépenses publicitaires cible. Si le ROAS cible est élevé, il est possible que la stratégie d'enchères ne puisse pas dépenser l'intégralité du budget. Si le ROAS cible n'est pas défini, la stratégie d'enchères s'efforcera d'atteindre le ROAS le plus élevé possible pour le budget. |
MaximizeConversions
Stratégie d'enchères automatiques qui vous permet de maximiser le nombre de conversions pour vos campagnes sans dépasser votre budget.
| Champs | |
|---|---|
target_cpa |
L'option "CPA cible". Il s'agit du montant moyen que vous souhaitez dépenser par acquisition. |
target_cpa_micros |
L'option "CPA cible". Il s'agit du montant moyen que vous souhaitez dépenser par acquisition. |
TargetCpa
Cette stratégie d'enchères automatiques définit vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous avez défini.
| Champs | |
|---|---|
target_cpa_micros |
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. |
TargetRoas
Stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant un retour sur les dépenses publicitaires (ROAS) cible spécifique.
| Champs | |
|---|---|
target_roas |
Revenu choisi (sur la base des données de conversion) par unité de dépense. |
TargetSpend
Une stratégie d'enchères automatiques qui définit vos enchères pour vous aider à obtenir autant de clics que possible dans les limites de votre budget.
| Champs | |
|---|---|
target_spend_micros |
Objectif de dépenses en dessous duquel optimiser les clics. Un enchérisseur TargetSpend tentera de dépenser la plus petite de cette valeur ou le montant normal de limitation des dépenses. S'il n'est pas spécifié, le budget est utilisé comme cible de dépenses. Ce champ est obsolète et ne doit plus être utilisé. Pour en savoir plus, consultez https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html. |
cpc_bid_ceiling_micros |
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 |
Nom de ressource de l'annonce. Les noms de ressources d'annonces sont au format suivant :
|
final_urls[] |
Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce. |
final_app_urls[] |
Liste des URL finales de l'application qui seront utilisées sur mobile si l'utilisateur a installé l'application spécifique. |
final_mobile_urls[] |
Liste d'URL mobiles finales possibles après toutes les redirections interdomaines de l'annonce. |
type |
Type d'annonce. |
synthetic_content_info |
Informations sur le contenu synthétique de l'annonce. Seules les annonces de certains types peuvent être mises à jour à l'aide du champ Valeurs |
id |
Identifiant de l'annonce. |
tracking_url_template |
Modèle d'URL permettant de créer une URL de suivi. |
final_url_suffix |
Suffixe à utiliser lors de la création d'une URL finale. |
display_url |
URL qui s'affiche dans la description de certains formats d'annonces. |
name |
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. |
Champ d'union ad_data. Informations pertinentes pour le type d'annonce. Une seule valeur doit être définie. ad_data ne peut être qu'un des éléments suivants : |
|
text_ad |
Informations concernant une annonce textuelle. |
expanded_text_ad |
Détails concernant une annonce textuelle agrandie. Les annonces textuelles agrandies sont obsolètes. Utilisez |
responsive_search_ad |
Informations concernant une annonce responsive sur le Réseau de Recherche. |
product_ad |
Informations sur une annonce produit. |
expanded_dynamic_search_ad |
Informations concernant une annonce dynamique agrandie sur le Réseau de Recherche. |
AdGroup
Un groupe d'annonces.
| Champs | |
|---|---|
resource_name |
Nom de ressource du groupe d'annonces. Les noms de ressources de groupes d'annonces se présentent sous la forme suivante :
|
status |
État du groupe d'annonces. |
type |
Type du groupe d'annonces. |
ad_rotation_mode |
Mode de rotation des annonces du groupe d'annonces. |
creation_time |
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 |
Paramètre pour les fonctionnalités liées au ciblage. |
labels[] |
Noms de ressource des étiquettes associées à ce groupe d'annonces. |
effective_labels[] |
Noms de ressource des libellés actifs associés à ce groupe d'annonces. Un libellé efficace est un libellé hérité ou directement attribué à ce groupe d'annonces. |
engine_id |
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 |
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 |
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 |
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 |
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 |
Identifiant du groupe d'annonces. |
name |
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). |
tracking_url_template |
Modèle d'URL permettant de créer une URL de suivi. |
cpc_bid_micros |
Enchère au CPC (coût par clic) maximal. Ce champ est utilisé lorsque la stratégie d'enchères efficace du groupe d'annonces est "CPC manuel". Ce champ n'est pas applicable et sera ignoré si la campagne du groupe d'annonces utilise une stratégie de portefeuille d'enchères. |
engine_status |
État du moteur pour le groupe d'annonces. |
final_url_suffix |
Modèle d'URL permettant d'ajouter des paramètres à l'URL finale. |
AdGroupAd
Annonce de groupe d'annonces.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'annonce. Les noms de ressources des annonces de groupe d'annonces se présentent sous la forme suivante :
|
status |
État de l'annonce. |
ad |
Annonce. |
creation_time |
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[] |
Noms de ressource des étiquettes associées à cette annonce de groupe d'annonces. |
effective_labels[] |
Noms de ressource des libellés effectifs associés à cette annonce. Un libellé efficace est un libellé hérité ou directement attribué à cette annonce. |
engine_id |
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 |
É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 |
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é effectif. Un libellé efficace est un libellé hérité ou directement attribué à cette annonce de groupe d'annonces.
| Champs | |
|---|---|
resource_name |
Nom de ressource du libellé effectif de l'annonce du groupe d'annonces. Les noms de ressource des étiquettes effectives d'annonce de groupe d'annonces se présentent sous la forme suivante : |
ad_group_ad |
Annonce du groupe d'annonces à laquelle le libellé effectif est associé. |
label |
Libellé effectif attribué à l'annonce du groupe d'annonces. |
owner_customer_id |
ID du client propriétaire du libellé effectif. |
AdGroupAdLabel
Relation entre une annonce d'un groupe d'annonces et un libellé.
| Champs | |
|---|---|
resource_name |
Nom de ressource du libellé d'annonce de groupe d'annonces. Les noms de ressources des libellés d'annonces de groupe d'annonces se présentent sous la forme suivante : |
ad_group_ad |
Annonce du groupe d'annonces à laquelle le libellé est associé. |
label |
Libellé attribué à l'annonce du groupe d'annonces. |
owner_customer_id |
ID du client propriétaire du libellé. |
AdGroupAsset
Lien entre un groupe d'annonces et un composant.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'asset du groupe d'annonces. Les noms de ressources AdGroupAsset se présentent sous la forme suivante :
|
ad_group |
Obligatoire. Groupe d'annonces auquel l'élément est associé. |
asset |
Obligatoire. L'élément associé au groupe d'annonces. |
status |
État du composant du groupe d'annonces. |
AdGroupAssetSet
AdGroupAssetSet est le lien entre un groupe d'annonces et un ensemble de composants. La création d'un AdGroupAssetSet associe un ensemble de composants à un groupe d'annonces.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'ensemble de composants du groupe d'annonces. Les noms de ressources des ensembles d'assets de groupe d'annonces se présentent sous la forme suivante :
|
ad_group |
Groupe d'annonces auquel cet ensemble de composants est associé. |
asset_set |
Ensemble de composants associé au groupe d'annonces. |
status |
État de l'ensemble de composants du groupe d'annonces. Lecture seule. |
AdGroupAudienceView
Vue de l'audience d'un groupe d'annonces. Inclut les données sur les performances des listes de centres d'intérêt et de remarketing pour les annonces sur le Réseau Display et le réseau YouTube, ainsi que les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), agrégées au niveau de l'audience.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue "Audience du groupe d'annonces". Les noms de ressources des vues d'audience de groupe d'annonces se présentent sous la forme suivante :
|
AdGroupBidModifier
Représente un modificateur d'enchères de groupe d'annonces.
| Champs | |
|---|---|
resource_name |
Nom de ressource du modificateur d'enchère de groupe d'annonces. Les noms de ressources des modificateurs d'enchères de groupe d'annonces se présentent sous la forme suivante :
|
bid_modifier |
Modificateur de l'enchère lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. Indiquez 0 pour désactiver un type d'appareil. |
Champ d'union Obligatoire dans les opérations de création à partir de la version 5. |
|
device |
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é ajoutés explicitement au groupe d'annonces.
| Champs | |
|---|---|
resource_name |
Nom de ressource du critère de groupe d'annonces. Les noms de ressources des critères de groupe d'annonces se présentent sous la forme suivante :
|
creation_time |
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 |
É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 |
Informations sur la qualité du critère. |
type |
Type du critère. |
labels[] |
Noms de ressource des étiquettes associées à ce critère de groupe d'annonces. |
effective_labels[] |
Noms de ressource des libellés effectifs associés à ce critère de groupe d'annonces. Un libellé efficace est un libellé hérité ou directement attribué à ce critère de groupe d'annonces. |
position_estimates |
Estimations des enchères basées sur des critères à différents emplacements. |
final_urls[] |
Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce. |
final_mobile_urls[] |
Liste des URL mobiles finales possibles après toutes les redirections interdomaines. |
url_custom_parameters[] |
Liste des mappages utilisés pour remplacer les balises de paramètres personnalisés dans un |
engine_id |
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". |
last_modified_time |
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 |
ID du critère. |
ad_group |
Groupe d'annonces auquel appartient le critère. |
negative |
Indique si le critère doit être ciblé ( Ce champ est immuable. Pour passer d'un critère positif à un critère négatif, supprimez-le, puis ajoutez-le à nouveau. |
bid_modifier |
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 |
Enchère au CPC (coût par clic). |
effective_cpc_bid_micros |
L'enchère au CPC (coût par clic) effective. |
engine_status |
État du moteur pour le critère de groupe d'annonces. |
final_url_suffix |
Modèle d'URL permettant d'ajouter des paramètres à l'URL finale. |
tracking_url_template |
Modèle d'URL permettant de créer une URL de suivi. |
Champ d'union Un seul doit être défini. |
|
keyword |
Mot clé. |
listing_group |
Groupe de fiches. |
age_range |
Tranche d'âge. |
gender |
Gender. |
user_list |
Liste des utilisateurs. |
webpage |
Page Web |
location |
Localisation. |
PositionEstimates
Estimations des enchères basées sur des critères à différents emplacements.
| Champs | |
|---|---|
top_of_page_cpc_micros |
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 d'informations sur la qualité des critères de groupe d'annonces.
| Champs | |
|---|---|
quality_score |
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é effectif. Un libellé efficace est un libellé hérité ou directement attribué à ce critère de groupe d'annonces.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'étiquette effective du critère de groupe d'annonces. Les noms de ressources des libellés effectifs de critères de groupe d'annonces se présentent sous la forme |
ad_group_criterion |
Critère de groupe d'annonces auquel est associée l'étiquette effective. |
label |
Libellé effectif attribué au critère de groupe d'annonces. |
owner_customer_id |
ID du client propriétaire du libellé effectif. |
AdGroupCriterionLabel
Relation entre un critère de groupe d'annonces et un libellé.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'étiquette de critère de groupe d'annonces. Les noms de ressources des libellés de critères de groupe d'annonces se présentent sous la forme suivante : |
ad_group_criterion |
Critère de groupe d'annonces auquel le libellé est associé. |
label |
Libellé attribué au critère de groupe d'annonces. |
owner_customer_id |
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 |
Nom de ressource du libellé effectif du groupe d'annonces. Les noms de ressource des étiquettes effectives de groupe d'annonces se présentent sous la forme suivante : |
ad_group |
Groupe d'annonces auquel le libellé effectif est associé. |
label |
Libellé effectif attribué au groupe d'annonces. |
owner_customer_id |
ID du client propriétaire du libellé effectif. |
AdGroupLabel
Relation entre un groupe d'annonces et un libellé.
| Champs | |
|---|---|
resource_name |
Nom de ressource du libellé de groupe d'annonces. Les noms de ressources des étiquettes de groupe d'annonces se présentent sous la forme suivante : |
ad_group |
Groupe d'annonces auquel le libellé est associé. |
label |
Libellé attribué au groupe d'annonces. |
owner_customer_id |
ID du client propriétaire du libellé. |
AgeRangeView
Vue d'une tranche d'âge.
Représente la vue des métriques de performances d'un client (comme les impressions et les clics) agrégées par tranche d'âge. Toutes les statistiques sont agrégées au niveau du groupe d'annonces.
Remarque : Vous pouvez segmenter les métriques par tranche d'âge à l'aide de age_range_view ou par genre à l'aide de gender_view. Toutefois, l'API Search Ads 360 ne permet pas de segmenter les métriques à la fois par tranche d'âge et par genre dans une même requête. L'analyse des performances pour les deux dimensions combinées n'est pas compatible avec l'API Search Ads 360.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue de tranche d'âge. Les noms de ressources des vues par tranche d'âge se présentent sous la forme suivante :
|
Élément
Un composant est un élément d'annonce qui 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 qu'un composant ne soit plus diffusé, supprimez-le de l'entité qui l'utilise.
| Champs | |
|---|---|
resource_name |
Nom de ressource du composant. Les noms de ressources d'éléments se présentent sous la forme suivante :
|
type |
Type de composant. |
final_urls[] |
Liste des URL finales possibles après toutes les redirections interdomaines. |
final_mobile_urls[] |
Liste des URL finales pour mobile possibles après toutes les redirections interdomaines. |
url_custom_parameters[] |
Liste des mappages à utiliser pour remplacer les balises de paramètres personnalisés d'URL dans tracking_url_template, final_urls et/ou final_mobile_urls. |
status |
État de l'élément. |
creation_time |
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 |
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". |
synthetic_content_info |
Informations sur le contenu synthétique de l'élément. Seuls les composants avec des types spécifiques peuvent être mis à jour à l'aide du champ Valeurs |
id |
ID de l'élément. |
name |
Nom facultatif de l'élément. |
tracking_url_template |
Modèle d'URL permettant de créer une URL de suivi. |
final_url_suffix |
Modèle d'URL permettant d'ajouter des paramètres aux URL de pages de destination diffusées avec le suivi en parallèle. |
engine_status |
État du moteur d'un composant. |
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 |
Un composant vidéo YouTube. |
image_asset |
Composant Image |
text_asset |
Un composant Texte. |
callout_asset |
Composant Accroche unifié. |
sitelink_asset |
Composant Lien annexe unifié. |
page_feed_asset |
Un élément de flux de pages unifié. |
mobile_app_asset |
Composant Application mobile |
call_asset |
Un composant Appel unifié. |
call_to_action_asset |
Composant Incitation à l'action. |
location_asset |
Composant Lieu unifié. |
AssetGroup
Un groupe de composants. AssetGroupAsset permet d'associer un composant à un groupe de composants. AssetGroupSignal permet d'associer un signal à un groupe de composants.
| Champs | |
|---|---|
resource_name |
Nom de ressource du groupe de composants. Les noms de ressources des groupes de composants se présentent sous la forme suivante :
|
id |
ID du groupe d'assets. |
campaign |
Campagne à laquelle ce groupe de composants est associé. Élément associé au groupe d'assets. |
name |
Obligatoire. Nom du groupe de composants. Obligatoire. Il doit comporter au moins un caractère et au maximum 128. Il doit être unique dans une campagne. |
final_urls[] |
Liste des URL finales après toutes les redirections interdomaines. Dans Performance Max, les URL sont éligibles à l'extension par défaut, sauf si vous la désactivez. |
final_mobile_urls[] |
Liste des URL finales pour mobile après toutes les redirections interdomaines. Dans Performance Max, les URL sont éligibles à l'extension par défaut, sauf si vous la désactivez. |
status |
État du groupe de composants. |
path1 |
Première partie du texte qui peut être ajouté à l'URL affichée dans l'annonce. |
path2 |
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 |
Efficacité globale des annonces de ce groupe d'assets. |
AssetGroupAsset
AssetGroupAsset est le lien entre un composant et un groupe de composants. L'ajout d'un AssetGroupAsset associe un composant à un groupe de composants.
| Champs | |
|---|---|
resource_name |
Nom de ressource du composant du groupe de composants. Le nom de ressource de l'élément du groupe d'assets se présente sous la forme suivante :
|
asset_group |
Groupe de composants auquel cet élément de groupe de composants est associé. |
asset |
Élément auquel le groupe de composants est associé. |
field_type |
Description de l'emplacement du composant dans le groupe de composants. Par exemple : HEADLINE, YOUTUBE_VIDEO, etc. |
status |
État du lien entre un composant et un groupe de composants. |
AssetGroupAssetCombinationData
Données sur les combinaisons de composants de groupes de composants
| Champs | |
|---|---|
asset_combination_served_assets[] |
Composants diffusés. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter représente un nœud d'arborescence de filtre de groupe de fiches dans un groupe de composants.
| Champs | |
|---|---|
resource_name |
Nom de ressource du filtre de groupe de fiches (groupe de composants). Le nom de ressource du filtre de groupe de fiches (groupe de composants) se présente sous la forme suivante :
|
asset_group |
Groupe de composants auquel appartient ce filtre de groupe de fiches. |
id |
ID de ListingGroupFilter. |
type |
Type d'un nœud de filtre de groupe de fiches. |
vertical |
Verticale représentée par l'arborescence de nœuds actuelle. Tous les nœuds d'un même arbre doivent appartenir à la même verticale. |
case_value |
Valeur de dimension avec laquelle ce groupe de fiches affine son parent. Indéfini pour le groupe racine. |
parent_listing_group_filter |
Nom de ressource de la subdivision du groupe de fiches parent. Valeur nulle pour le nœud de filtre du groupe de fiches racine. |
path |
Chemin d'accès aux dimensions définissant 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 quels utilisateurs sont les plus susceptibles de générer des conversions. Les campagnes Performance Max utilisent le signal pour rechercher d'autres personnes ayant une intention similaire ou plus forte afin de générer des conversions sur le Réseau de Recherche, sur le Display, dans les vidéos, etc.
| Champs | |
|---|---|
resource_name |
Nom de ressource du signal de groupe de composants. Le nom de ressource du signal de groupe d'assets se présente sous la forme suivante :
|
asset_group |
Groupe de composants auquel appartient ce signal de groupe de composants. |
Champ d'union signal. Signal du groupe de composants. signal ne peut être qu'un des éléments suivants : |
|
audience |
Signal d'audience à utiliser par la campagne Performance Max. |
AssetGroupTopCombinationView
Vue sur l'utilisation des meilleures combinaisons de composants dans les groupes de composants.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue de la combinaison principale du groupe de composants. Les noms de ressources des vues "Combinaison optimale du groupe d'assets" se présentent sous la forme suivante : "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}". |
asset_group_top_combinations[] |
Combinaisons de composants les plus performantes diffusées ensemble. |
AssetSet
Ensemble de composants représentant une collection de composants. Utilisez AssetSetAsset pour associer un élément à l'ensemble de composants.
| Champs | |
|---|---|
id |
ID de l'ensemble de composants. |
resource_name |
Nom de ressource de l'ensemble de composants. Les noms de ressources des ensembles d'assets se présentent comme suit :
|
AssetSetAsset
AssetSetAsset est le lien entre un élément et un ensemble de composants. L'ajout d'un AssetSetAsset associe un actif à un ensemble de composants.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'élément de l'ensemble de composants. Les noms de ressources des éléments d'un groupe d'assets se présentent sous la forme suivante :
|
asset_set |
Ensemble d'éléments auquel cet élément d'ensemble d'éléments est associé. |
asset |
Élément auquel l'ensemble d'éléments est associé. |
status |
État de l'asset de l'ensemble de composants. 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 |
Nom de ressource de l'audience. Les noms d'audience se présentent sous la forme suivante :
|
id |
ID de l'audience. |
name |
Obligatoire. Nom de l'audience. Il doit être unique pour toutes les audiences. Il doit comporter entre 1 et 255 caractères. |
description |
Description de cette audience. |
BiddingStrategy
Une stratégie d'enchères.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la stratégie d'enchères. Les noms de ressources de stratégie d'enchères se présentent sous la forme suivante :
|
status |
État de la stratégie d'enchères. Ce champ est en lecture seule. |
type |
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 |
Devise utilisée par la stratégie d'enchères (code ISO 4217 à trois lettres). Pour les stratégies d'enchères dans les comptes administrateur, cette devise peut être définie lors de la création et est définie par défaut sur la devise du compte administrateur. Pour les clients diffusant des annonces, ce champ ne peut pas être défini. Toutes les stratégies d'un client diffusant des annonces utilisent implicitement la devise de ce client. Dans tous les cas, le champ effective_currency_code renvoie la devise utilisée par la stratégie. |
id |
ID de la stratégie d'enchères. |
name |
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 |
Devise utilisée par la stratégie d'enchères (code ISO 4217 à trois lettres). Pour les stratégies d'enchères dans les comptes client, il s'agit de la devise définie par l'annonceur lors de la création de la stratégie. Pour la diffusion auprès des clients, il s'agit du currency_code du client. Les métriques sur les stratégies d'enchères sont exprimées dans cette devise. Ce champ est en lecture seule. |
campaign_count |
Nombre de campagnes associées à cette stratégie d'enchères. Ce champ est en lecture seule. |
non_removed_campaign_count |
Nombre de campagnes non supprimées associées à cette stratégie d'enchères. Ce champ est en lecture seule. |
Champ d'union Vous ne pouvez en définir qu'un seul. |
|
enhanced_cpc |
Stratégie d'enchères qui augmente les enchères pour les clics qui semblent les plus susceptibles de générer une conversion et les diminue pour les clics qui semblent les moins susceptibles d'en générer. |
maximize_conversion_value |
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 |
Stratégie d'enchères automatiques qui vous permet de maximiser le nombre de conversions pour vos campagnes sans dépasser votre budget. |
target_cpa |
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 |
Stratégie d'enchères qui optimise automatiquement les enchères en fonction d'un pourcentage d'impressions choisi. |
target_outrank_share |
Stratégie d'enchères qui définit les enchères en fonction de la fraction cible des enchères dans lesquelles l'annonceur doit se classer devant un concurrent spécifique. Ce champ a été abandonné. La création d'une stratégie d'enchères avec ce champ ou l'association de stratégies d'enchères à une campagne avec ce champ échoueront. Les mutations vers des stratégies qui ont déjà ce schéma renseigné sont autorisées. |
target_roas |
Stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant, en moyenne, un retour sur les dépenses publicitaires (ROAS) cible spécifique. |
target_spend |
Stratégie d'enchères qui définit vos enchères pour vous permettre d'enregistrer un maximum de clics dans les limites de votre budget. |
Campagne
Une campagne.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la campagne. Les noms de ressources de campagne se présentent sous la forme suivante :
|
status |
État de la campagne. Lorsqu'une campagne est ajoutée, son état est défini sur "Activée" par défaut. |
serving_status |
État de diffusion des annonces de la campagne. |
bidding_strategy_system_status |
État du système de la stratégie d'enchères de la campagne. |
ad_serving_optimization_status |
État d'optimisation de la diffusion des annonces de la campagne. |
advertising_channel_type |
Cible de diffusion principale pour les annonces de la campagne. Vous pouvez affiner les options de ciblage dans 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 |
Filtre facultatif de 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[] |
Liste des mappages utilisés pour remplacer les balises de paramètres personnalisés dans un |
real_time_bidding_setting |
Paramètres des enchères en temps réel, une fonctionnalité disponible uniquement pour les campagnes ciblant le réseau Ad Exchange. |
network_settings |
Paramètres de réseau de la campagne. |
dynamic_search_ads_setting |
Paramètre permettant de contrôler les annonces dynamiques du Réseau de Recherche (ADR). |
shopping_setting |
Paramètre permettant de contrôler les campagnes Shopping. |
geo_target_type_setting |
Paramètre de ciblage géographique des annonces. |
effective_labels[] |
Noms de ressource des libellés effectifs associés à cette campagne. Un libellé effectif est un libellé hérité ou directement attribué à cette campagne. |
labels[] |
Noms de ressource des étiquettes associées à cette campagne. |
bidding_strategy_type |
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 Ce champ est en lecture seule. |
accessible_bidding_strategy |
Nom de ressource AccessibleBiddingStrategy, une vue en lecture seule des attributs non restreints 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 restreints ne peuvent être lus qu'à partir de la ressource BiddingStrategy. |
frequency_caps[] |
Liste qui limite la fréquence à laquelle chaque utilisateur verra les annonces de cette campagne. |
selective_optimization |
Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion pour lesquelles optimiser cette campagne. Cette fonctionnalité ne s'applique qu'aux campagnes pour applications qui utilisent MULTI_CHANNEL comme AdvertisingChannelType et APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT comme AdvertisingChannelSubType. |
optimization_goal_setting |
Paramètres d'objectif d'optimisation pour cette campagne, qui incluent un ensemble de types d'objectifs d'optimisation. |
tracking_setting |
Paramètres au niveau de la campagne pour les informations de suivi. |
engine_id |
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[] |
Types de champs de composants à exclure de cette campagne. Les liens d'assets avec ces types de champs ne seront pas hérités par cette campagne depuis le niveau supérieur. |
create_time |
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 obsolète dans la version 1. Utilisez plutôt creation_time. |
creation_time |
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 |
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". |
feed_types[] |
Types de flux associés directement à cette campagne. |
id |
Identifiant de la campagne. |
name |
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 |
Modèle d'URL permettant de créer une URL de suivi. |
campaign_budget |
Nom de ressource du budget de la campagne. |
start_date |
Date à laquelle la diffusion de la campagne a commencé dans le fuseau horaire du client au format AAAA-MM-JJ. |
end_date |
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 |
Suffixe utilisé pour ajouter des paramètres de requête aux pages de destination diffusées avec le suivi en parallèle. |
url_expansion_opt_out |
Indique si l'extension d'URL vers des URL plus ciblées est désactivée. Si elle l'est (valeur "true"), seules les URL finales du groupe de composants ou les URL spécifiées dans les flux de données d'entreprise ou Google Merchant Center de l'annonceur sont ciblées. Si la valeur est "false" (activé), l'ensemble du domaine sera ciblé. Ce champ ne peut être défini que pour les campagnes Performance Max, où la valeur par défaut est "false". |
Champ d'union Elle doit être de portefeuille (créée via le service BiddingStrategy) ou standard (intégrée à la campagne). |
|
bidding_strategy |
Nom de ressource de la stratégie de portefeuille d'enchères utilisée par la campagne. |
manual_cpa |
Stratégie d'enchères au CPA manuelles standard. Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère pour chaque action spécifiée. Disponible uniquement pour les campagnes Local Services. |
manual_cpc |
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 |
Stratégie d'enchères au CPM manuelles standards. Enchères manuelles basées sur les impressions, où l'utilisateur paie pour mille impressions. |
maximize_conversions |
Stratégie d'enchères "Maximiser les conversions" standard qui maximise automatiquement le nombre de conversions tout en exploitant la totalité de votre budget. |
maximize_conversion_value |
Stratégie d'enchères standards "Maximiser la valeur de conversion" qui définit automatiquement les enchères pour maximiser les revenus tout en exploitant la totalité de votre budget. |
target_cpa |
Stratégie d'enchères au CPA cible standard qui définit automatiquement les enchères pour générer un maximum de conversions en fonction du coût par acquisition (CPA) cible que vous spécifiez. |
target_impression_share |
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 |
Stratégie d'enchères au ROAS cible standard qui maximise automatiquement les revenus tout en atteignant la moyenne d'un retour sur les dépenses publicitaires (ROAS) cible spécifique. |
target_spend |
Stratégie d'enchères standards "Cible de dépenses" qui définit automatiquement vos enchères pour vous aider à enregistrer autant de clics que possible dans les limites de votre budget. |
percent_cpc |
Stratégie d'enchères standard au pourcentage de CPC, où les enchères représentent une fraction du prix annoncé pour un bien ou un service. |
target_cpm |
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 |
Obligatoire. Nom de domaine Internet que représente ce paramètre (par exemple, "google.com" ou "www.google.com"). |
language_code |
Obligatoire. Code de langue spécifiant la langue du domaine, par exemple "en". |
use_supplied_urls_only |
Indique si la campagne utilise exclusivement des URL fournies par l'annonceur. |
GeoTargetTypeSetting
Représente un ensemble de paramètres liés au ciblage géographique des annonces.
| Champs | |
|---|---|
positive_geo_target_type |
Paramètre utilisé pour le ciblage géographique positif dans cette campagne spécifique. |
negative_geo_target_type |
Paramètre utilisé pour le ciblage géographique négatif dans cette campagne. |
NetworkSettings
Paramètres de réseau de la campagne.
| Champs | |
|---|---|
target_google_search |
Indique si les annonces seront diffusées avec les résultats de recherche google.com. |
target_search_network |
Indique si les annonces seront diffusées sur les sites du réseau des partenaires du Réseau de Recherche de Google (nécessite que |
target_content_network |
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 |
Indique si des annonces seront diffusées sur le réseau de partenaires. Cette option n'est disponible que pour certains comptes partenaires. Sauf indication contraire, ce champ ne s'applique probablement pas à votre compte. Ce paramètre ne permet pas de contrôler si des annonces seront diffusées sur le réseau des partenaires du Réseau de Recherche de Google. Utilisez plutôt |
OptimizationGoalSetting
Paramètres d'objectif d'optimisation pour cette campagne, qui incluent un ensemble de types d'objectifs d'optimisation.
| Champs | |
|---|---|
optimization_goal_types[] |
Liste des types d'objectifs d'optimisation. |
SelectiveOptimization
Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion pour lesquelles optimiser cette campagne. Cette fonctionnalité ne s'applique qu'aux campagnes pour applications qui utilisent MULTI_CHANNEL comme AdvertisingChannelType et APP_CAMPAIGN ou APP_CAMPAIGN_FOR_ENGAGEMENT comme AdvertisingChannelSubType.
| Champs | |
|---|---|
conversion_actions[] |
Ensemble sélectionné de noms de ressources pour les actions de conversion permettant d'optimiser cette campagne. |
ShoppingSetting
Paramètre pour les campagnes Shopping. Définit l'univers des produits pouvant être promus par la campagne et la façon dont cette campagne interagit avec les autres campagnes Shopping.
| Champs | |
|---|---|
feed_label |
Libellé du flux des produits à inclure dans la campagne. Les libellés de flux valides peuvent contenir jusqu'à 20 caractères, y compris des lettres majuscules, des chiffres, des traits d'union et des traits de soulignement. Si vous utilisiez auparavant le champ |
use_vehicle_inventory |
Indique s'il faut cibler l'inventaire des fiches de véhicules. |
merchant_id |
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 |
Pays de vente des produits à inclure dans la campagne. |
campaign_priority |
Priorité de la campagne. Les campagnes dont la priorité est numériquement plus élevée sont prioritaires par rapport à celles dont la priorité est plus faible. Ce champ est obligatoire pour les campagnes Shopping. Les valeurs doivent être comprises entre 0 et 2 (inclus). Ce champ est facultatif pour les campagnes Shopping intelligentes, mais doit être égal à 3 s'il est défini. |
enable_local |
Indique si les produits en magasin doivent être inclus. |
TrackingSetting
Paramètres au niveau de la campagne pour les informations de suivi.
| Champs | |
|---|---|
tracking_url |
URL utilisée pour le suivi dynamique. |
CampaignAsset
Lien entre une campagne et un composant.
| Champs | |
|---|---|
resource_name |
Nom de ressource du composant de campagne. Les noms de ressources CampaignAsset se présentent sous la forme suivante :
|
status |
État du composant de campagne. |
campaign |
La campagne à laquelle l'élément est associé. |
asset |
L'élément associé à la campagne. |
CampaignAssetSet
CampaignAssetSet est le lien entre une campagne et un ensemble de composants. L'ajout d'un CampaignAssetSet associe un ensemble de composants à une campagne.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'ensemble de composants de la campagne. Les noms de ressources des éléments d'un groupe d'assets se présentent sous la forme suivante :
|
campaign |
Campagne à laquelle cet ensemble de composants est associé. |
asset_set |
Ensemble de composants associé à la campagne. |
status |
État du composant de l'ensemble de composants de la campagne. Lecture seule. |
CampaignAudienceView
Vue d'audience d'une campagne. Inclut les données sur les performances des listes de centres d'intérêt et de remarketing pour les annonces sur le Réseau Display et le réseau YouTube, ainsi que les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), agrégées par campagne et par critère d'audience. Cette vue n'inclut que les audiences associées au niveau de la campagne.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue "Audience de la campagne". Les noms de ressources des vues d'audience de campagne se présentent sous la forme suivante :
|
CampaignBudget
Un budget de campagne.
| Champs | |
|---|---|
resource_name |
Nom de ressource du budget de la campagne. Les noms de ressources de budget de campagne se présentent sous la forme suivante :
|
delivery_method |
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 |
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 |
Montant moyen à dépenser par jour pour la campagne. Ce champ est utilisé lorsque le Le montant est exprimé en micro-unités dans la devise locale du compte. Un million de micro-unités équivaut à une unité de devise. Les dépenses mensuelles effectives sont limitées à 30,4 fois ce montant quotidien. Ce champ s'exclut mutuellement avec "total_amount_micros". Vous ne devez définir qu'un seul élément "amount_micros" ou "total_amount_micros". |
CampaignCriterion
Critère de campagne.
| Champs | |
|---|---|
resource_name |
Nom de ressource du critère de campagne. Les noms de ressources des critères de campagne se présentent sous la forme suivante :
|
display_name |
Nom à afficher du critère. Ce champ est ignoré pour les mutations. |
type |
Type du critère. |
status |
État du critère. |
last_modified_time |
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 |
ID du critère. Ce champ est ignoré lors de la modification. |
bid_modifier |
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 |
Indique si le critère doit être ciblé ( |
Champ d'union Un seul doit être défini. |
|
keyword |
Mot clé. |
location |
Localisation. |
device |
appareil. |
age_range |
Tranche d'âge. |
gender |
Gender. |
user_list |
Liste des utilisateurs. |
language |
Language. |
webpage |
Page Web |
location_group |
Groupe de zones géographiques |
CampaignEffectiveLabel
Représente une relation entre une campagne et un libellé efficace. Un libellé effectif est un libellé hérité ou directement attribué à cette campagne.
| Champs | |
|---|---|
resource_name |
Nom de la ressource. Les noms de ressources CampaignEffectivelabel se présentent sous la forme suivante : |
campaign |
Campagne à laquelle le libellé effectif est associé. |
label |
Libellé effectif attribué à la campagne. |
owner_customer_id |
ID du client propriétaire du libellé effectif. |
CampaignLabel
Représente une relation entre une campagne et un libellé.
| Champs | |
|---|---|
resource_name |
Nom de la ressource. Les noms de ressources des libellés de campagne se présentent sous la forme suivante : |
campaign |
Campagne à laquelle le libellé est associé. |
label |
Libellé attribué à la campagne. |
owner_customer_id |
ID du client propriétaire du libellé. |
CartDataSalesView
Vue des ventes avec les données du panier
Fournit des informations sur les produits achetés si les conversions avec les données du panier sont implémentées. Les métriques de performances (revenus, marge brute, métriques sur les prospects/ventes croisées, etc.) et les attributs Merchant Center (marque, catégorie, etc.) sont disponibles pour les produits définis dans un flux d'inventaire et vendus grâce aux annonces Google. Pour les achats attribués à des clics sur des annonces Shopping, vous pouvez afficher ensemble les dimensions des produits sur lesquels les utilisateurs ont cliqué et de ceux qu'ils ont achetés.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue "Données du panier". Les noms de ressources des vues des ventes de données de panier se présentent sous la forme suivante : |
Conversion
Une conversion.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la conversion. Les noms de ressources de conversion se présentent au format suivant :
|
id |
Identifiant de la conversion |
criterion_id |
ID du critère Search Ads 360. Une valeur de 0 indique que le critère n'est pas attribué. |
merchant_id |
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 |
Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée. |
click_id |
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 |
ID de visite Search Ads 360 auquel la conversion est attribuée. |
advertiser_conversion_id |
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 |
Identifiant du produit ayant fait l'objet d'un clic. |
product_channel |
Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin. |
product_language_code |
Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit. |
product_store_id |
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 |
Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic. |
attribution_type |
Élément auquel la conversion est attribuée : visite ou mot clé + annonce. |
conversion_date_time |
Code temporel de l'événement de conversion. |
conversion_last_modified_date_time |
Code temporel de la dernière modification de la conversion. |
conversion_visit_date_time |
Code temporel de la visite à laquelle la conversion est attribuée. |
conversion_quantity |
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 |
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 |
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 |
ID de commande Floodlight fourni par l'annonceur pour la conversion. |
status |
État de la conversion (ACTIVÉ ou SUPPRIMÉ). |
asset_id |
ID du composant avec lequel l'utilisateur a interagi lors de l'événement de conversion. |
asset_field_type |
Type de champ de composant de l'événement de conversion. |
ConversionAction
Une action de conversion.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'action de conversion. Les noms de ressources d'actions de conversion se présentent au format suivant :
|
creation_time |
Horodatage de la création de l'activité Floodlight, au format ISO 8601. |
status |
État de cette action de conversion pour le décompte des événements de conversion. |
type |
Type d'action de conversion. |
category |
Catégorie des conversions enregistrées pour cette action de conversion. |
value_settings |
Paramètres liés à la valeur des événements de conversion associés à cette action de conversion. |
attribution_model_settings |
Paramètres liés au modèle d'attribution de cette action de conversion. |
floodlight_settings |
Paramètres Floodlight pour les types de conversions Floodlight. |
id |
ID de l'action de conversion. |
name |
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 |
Si le bit primary_for_goal d'une action de conversion est défini sur "false", l'action de conversion est non enchérissable pour toutes les campagnes, quels que soient leur objectif de conversion client ou leur objectif de conversion de campagne. Toutefois, les objectifs de conversion personnalisés ne respectent pas primary_for_goal. Par conséquent, si une campagne a 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, primary_for_goal ne peut être défini sur "false" qu'après la création via une opération de mise à jour, car il n'est pas déclaré comme facultatif. |
owner_customer |
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 |
Indique si cette action de conversion doit être incluse dans la métrique "client_account_conversions". |
include_in_conversions_metric |
Indique si cette action de conversion doit être incluse dans la métrique "Conversions". |
click_through_lookback_window_days |
Nombre maximal de jours pouvant s'écouler entre une interaction (un clic, par exemple) et un événement de conversion. |
app_id |
ID d'application pour une action de conversion d'application. |
AttributionModelSettings
Paramètres liés au modèle d'attribution de cette action de conversion.
| Champs | |
|---|---|
attribution_model |
Type de modèle d'attribution de cette action de conversion. |
data_driven_model_status |
État du modèle d'attribution basée sur les données pour l'action de conversion. |
FloodlightSettings
Paramètres liés à une action de conversion Floodlight.
| Champs | |
|---|---|
activity_group_tag |
Chaîne permettant d'identifier un groupe d'activités Floodlight lors de la création de rapports sur les conversions. |
activity_tag |
Chaîne permettant d'identifier une activité Floodlight lors de la création de rapports sur les conversions. |
activity_id |
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 |
Valeur à utiliser lorsque des événements de conversion pour cette action de conversion sont envoyés avec une valeur non valide, non autorisée ou manquante, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut. |
default_currency_code |
Code de devise à utiliser lorsque les événements de conversion pour cette action de conversion sont envoyés avec un code de devise non valide ou manquant, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut. |
always_use_default_value |
Indique si la valeur et le code de devise par défaut doivent être utilisés à la place de ceux spécifiés dans les événements de conversion pour cette action de conversion. |
ConversionCustomVariable
Variable personnalisée de conversion. Consultez "À propos des métriques et dimensions Floodlight personnalisées dans la nouvelle interface Search Ads 360" sur https://support.google.com/sa360/answer/13567857.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la variable personnalisée de conversion. Les noms de ressources des variables personnalisées de conversion se présentent au format suivant :
|
id |
ID de la variable personnalisée de conversion. |
name |
Obligatoire. Nom de la variable personnalisée de conversion. Le nom doit être unique. Le nom ne doit pas dépasser 100 caractères. Il ne doit pas y avoir d'espaces supplémentaires avant et après. |
tag |
Obligatoire. Balise de la variable personnalisée de conversion. Le tag doit être unique et se composer d'un caractère "u" suivi directement d'un nombre inférieur ou égal à 100. Par exemple : "u4". |
status |
État de la variable personnalisée de conversion pour le décompte des événements de conversion. |
owner_customer |
Nom de ressource du client propriétaire de la variable personnalisée de conversion. |
family |
Famille de la variable personnalisée de conversion. |
cardinality |
Cardinalité de la variable personnalisée de conversion. |
floodlight_conversion_custom_variable_info |
Champs pour les variables personnalisées de conversion Floodlight Search Ads 360. |
custom_column_ids[] |
ID des colonnes personnalisées qui utilisent cette variable personnalisée de conversion. |
FloodlightConversionCustomVariableInfo
Informations sur les variables personnalisées de conversion Floodlight Search Ads 360.
| Champs | |
|---|---|
floodlight_variable_type |
Type de variable Floodlight défini dans Search Ads 360. |
floodlight_variable_data_type |
Type de données de la variable Floodlight défini dans Search Ads 360. |
ConversionTrackingSetting
Ensemble de paramètres au niveau du client liés au suivi des conversions Search Ads 360.
| Champs | |
|---|---|
accepted_customer_data_terms |
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. |
conversion_tracking_status |
État du suivi des conversions. Il indique si le client utilise le suivi des conversions et qui en est le propriétaire. Si ce client utilise le suivi des conversions multicomptes, la valeur renvoyée sera différente en fonction du |
enhanced_conversions_for_leads_enabled |
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 |
Nom de ressource du client pour lequel les conversions sont créées et gérées. Ce champ est en lecture seule. |
conversion_tracking_id |
ID de suivi des conversions utilisé pour ce compte. Cet ID n'indique pas si le client utilise le suivi des conversions (c'est le cas de conversion_tracking_status). Ce champ est en lecture seule. |
google_ads_cross_account_conversion_tracking_id |
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 conversion_tracking_id. Ce champ ne peut être géré que dans l'UI Google Ads. Ce champ est en lecture seule. |
cross_account_conversion_tracking_id |
ID de suivi des conversions de l'administrateur du client. Cette valeur est définie lorsque le client a activé le suivi des conversions multicomptes. Elle remplace conversion_tracking_id. |
CustomColumn
Une colonne personnalisée. Découvrez la colonne personnalisée Search Ads 360 à l'adresse https://support.google.com/sa360/answer/9633916
| Champs | |
|---|---|
resource_name |
Nom de ressource de la colonne personnalisée. Les noms de ressources des colonnes personnalisées se présentent sous la forme suivante :
|
id |
ID de la colonne personnalisée. |
name |
Nom défini par l'utilisateur pour la colonne personnalisée. |
description |
Description de la colonne personnalisée définie par l'utilisateur. |
value_type |
Type de la valeur du résultat de la colonne personnalisée. |
references_attributes |
Vrai lorsque la colonne personnalisée fait référence à un ou plusieurs attributs. |
references_metrics |
Vrai lorsque la colonne personnalisée fait référence à une ou plusieurs métriques. |
queryable |
Vrai lorsque la colonne personnalisée peut être utilisée dans la requête de SearchAds360Service.Search et SearchAds360Service.SearchStream. |
referenced_system_columns[] |
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 |
Indique comment la valeur du résultat de la colonne personnalisée doit être interprétée. |
Client
Un client.
| Champs | |
|---|---|
resource_name |
Nom de ressource du client. Les noms de ressources client se présentent sous la forme suivante :
|
conversion_tracking_setting |
Paramètre de suivi des conversions pour un client. |
account_type |
Type de compte de moteur (par exemple, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Suivi de moteur). |
double_click_campaign_manager_setting |
Paramètre DoubleClick Campaign Manager (DCM) pour un client administrateur. |
account_status |
L'état du compte (par exemple, "Activé", "Mis en veille", "Supprimé", etc.) |
last_modified_time |
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 |
ID du compte dans le compte de moteur externe. |
status |
État du client. |
creation_time |
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". |
manager_id |
Numéro client de l'administrateur. Une valeur de 0 indique que le client n'a pas de responsable SA360. |
manager_descriptive_name |
Nom descriptif du responsable. |
sub_manager_id |
Numéro client de l'administrateur secondaire. Une valeur de 0 indique que le client n'a pas de compte administrateur SA360 enfant. |
sub_manager_descriptive_name |
Nom descriptif de l'administrateur secondaire. |
associate_manager_id |
Numéro client de l'administrateur associé. La valeur 0 indique que le client n'a pas d'administrateur associé SA360. |
associate_manager_descriptive_name |
Nom descriptif de l'administrateur associé. |
account_level |
Niveau de compte du client : administrateur, administrateur secondaire, administrateur associé ou compte de service. |
id |
ID du client. |
descriptive_name |
Nom descriptif facultatif et non unique du client. |
currency_code |
Devise de fonctionnement du compte. Accepte un sous-ensemble de codes de devise ISO 4217. |
time_zone |
ID du fuseau horaire local du client. |
tracking_url_template |
Modèle d'URL permettant de créer une URL de suivi à partir de paramètres. |
final_url_suffix |
Modèle d'URL permettant d'ajouter des paramètres à l'URL finale. |
auto_tagging_enabled |
Indique si le taggage automatique est activé pour le client. |
manager |
Indique si le client est un administrateur. |
CustomerAsset
Lien entre un client et un élément.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'avoir client. Les noms de ressources CustomerAsset se présentent sous la forme suivante :
|
asset |
Obligatoire. Élément associé au client. |
status |
État de l'asset client. |
CustomerAssetSet
CustomerAssetSet est le lien entre un client et un ensemble de composants. L'ajout d'un CustomerAssetSet associe un ensemble de composants à un client.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'ensemble de composants client. Les noms de ressources des éléments d'un groupe d'assets se présentent sous la forme suivante :
|
asset_set |
Ensemble de composants associé au client. |
customer |
Client auquel cet ensemble de composants est associé. |
status |
État de l'asset de l'ensemble de composants client. Lecture seule. |
CustomerClient
Lien entre le client donné et un client. Les CustomerClients n'existent que pour les clients administrateurs. Tous les clients directs et indirects sont inclus, ainsi que le gestionnaire lui-même.
| Champs | |
|---|---|
resource_name |
Nom de ressource du client. Les noms de ressources CustomerClient se présentent sous la forme suivante : |
applied_labels[] |
Noms de ressource des libellés appartenant au client demandeur et appliqués au client. Les noms de ressources des libellés se présentent sous la forme suivante :
|
status |
État du compte client. Lecture seule. |
client_customer |
Nom de ressource du client associé au client donné. Lecture seule. |
level |
Distance entre le client donné et le client. Pour le lien "self", la valeur du niveau sera 0. Lecture seule. |
time_zone |
Représentation sous forme de chaîne CLDR (Common Locale Data Repository) du fuseau horaire du client, par exemple "America/Los_Angeles". Lecture seule. |
test_account |
Indique si le client est un compte de test. Lecture seule. |
manager |
Indique si le client est un administrateur. Lecture seule. |
descriptive_name |
Nom descriptif du client. Lecture seule. |
currency_code |
Code de devise (par exemple, "USD" ou "EUR") pour le client. Lecture seule. |
id |
ID du client. Lecture seule. |
CustomerManagerLink
Représente la relation entre un client et un responsable.
| Champs | |
|---|---|
resource_name |
Nom de la ressource. Les noms de ressources CustomerManagerLink se présentent sous la forme suivante : |
status |
État de l'association entre le client et le gestionnaire. |
manager_customer |
Compte client administrateur associé au client. |
manager_link_id |
ID de l'association client-administrateur. Ce champ est en lecture seule. |
start_time |
Code temporel de la 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 |
ID de l'annonceur Campaign Manager associé à ce client. |
network_id |
ID du réseau Campaign Manager associé à ce client. |
time_zone |
Fuseau horaire du réseau Campaign Manager associé à ce client, au format de la base de données des fuseaux horaires de l'IANA (par exemple, America/New_York). |
DynamicSearchAdsSearchTermView
Vue des termes de recherche pour les annonces dynamiques du Réseau de Recherche.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Les noms de ressources des vues des termes de recherche des annonces dynamiques du Réseau de Recherche se présentent sous la forme suivante :
|
landing_page |
URL de la page de destination de l'impression sélectionnée de manière dynamique. Ce champ est en lecture seule. |
GenderView
Ressource de vue du genre. Représente la vue des métriques de performances d'un client, agrégées par genre. Toutes les statistiques sont agrégées au niveau du groupe d'annonces.
Remarque : Vous pouvez segmenter les métriques par tranche d'âge à l'aide de age_range_view ou par genre à l'aide de gender_view. Toutefois, l'API Search Ads 360 ne permet pas de segmenter les métriques à la fois par tranche d'âge et par genre dans une même requête. L'analyse des performances pour les deux dimensions combinées n'est pas compatible avec l'API Search Ads 360.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue par genre. Les noms de ressources des vues par genre se présentent sous la forme suivante :
|
GeoTargetConstant
Constante de ciblage géographique.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la constante de ciblage géographique. Les noms de ressources constantes de ciblage géographique se présentent sous la forme suivante :
|
status |
État de la constante de ciblage géographique. |
id |
ID de la constante de ciblage géographique. |
name |
Nom anglais de la constante de ciblage géographique. |
country_code |
Code pays ISO-3166-1 alpha-2 associé à la cible. |
target_type |
Type de cible de la constante de ciblage géographique. |
canonical_name |
Nom complet en anglais, composé du nom de la cible, de celui de son parent et de celui du pays. |
parent_geo_target |
Nom de ressource de la constante de ciblage géographique parente. Les noms de ressources constantes de ciblage géographique se présentent sous la forme suivante :
|
KeywordView
Vue des mots clés
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue de mot clé. Les noms de ressources des vues de mots clés se présentent sous la forme suivante :
|
Libellé
Un libellé.
| Champs | |
|---|---|
resource_name |
Nom de la ressource. Les noms de ressources de libellé se présentent sous la forme suivante : |
status |
État du libellé. Lecture seule. |
text_label |
Type de libellé affichant du texte sur un arrière-plan coloré. |
id |
ID du libellé. Lecture seule. |
name |
Nom du libellé. Ce champ est obligatoire. Il doit être renseigné lors de la création d'un libellé. La longueur de cette chaîne doit être comprise entre 1 et 80, inclus. |
LanguageConstant
Une langue.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la constante de langue. Les noms de ressources des constantes de langue se présentent sous la forme suivante :
|
id |
ID de la constante de langue. |
code |
Code de langue (par exemple, "en_US", "en_AU", "es", "fr", etc.). |
name |
Nom complet de la langue en anglais (par exemple, "English (US)", "Spanish", etc.). |
targetable |
Indique si la langue peut être ciblée. |
ListingGroupFilterDimension
Dimensions de fiche pour le filtre de groupe de fiches (groupe de composants).
| Champs | |
|---|---|
Champ d'union dimension. Une dimension de l'un des types ci-dessous est toujours présente. dimension ne peut être qu'un des éléments suivants : |
|
product_bidding_category |
Catégorie d'enchères d'une offre de produit. |
product_brand |
Marque d'une offre de produit. |
product_channel |
Localité d'une offre de produit. |
product_condition |
État d'une offre de produit. |
product_custom_attribute |
Attribut personnalisé d'une offre de produit. |
product_item_id |
ID d'article d'une offre de produit. |
product_type |
Type d'offre de produit. |
ProductBiddingCategory
Élément d'une catégorie d'enchères à un certain niveau. Les catégories de premier niveau sont au niveau 1, leurs enfants au niveau 2, et ainsi de suite. Nous acceptons actuellement jusqu'à cinq niveaux. L'utilisateur doit spécifier un type de dimension qui indique le niveau de la catégorie. Toutes les valeurs d'une même subdivision doivent avoir le même type de dimension (niveau de catégorie).
| Champs | |
|---|---|
level |
Indique le niveau de la catégorie dans la taxonomie. |
id |
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 |
Valeur de chaîne de la marque du produit. |
ProductChannel
Localité d'une offre de produit.
| Champs | |
|---|---|
channel |
Valeur de la localité. |
ProductCondition
État d'une offre de produit.
| Champs | |
|---|---|
condition |
Valeur de la condition. |
ProductCustomAttribute
Attribut personnalisé d'une offre de produit.
| Champs | |
|---|---|
index |
Indique l'index de l'attribut personnalisé. |
value |
Valeur de chaîne de l'attribut personnalisé du produit. |
ProductItemId
ID d'article d'une offre de produit.
| Champs | |
|---|---|
value |
Valeur de l'ID. |
ProductType
Type d'offre de produit.
| Champs | |
|---|---|
level |
Niveau du type. |
value |
Valeur du type. |
ListingGroupFilterDimensionPath
Chemin de définition des dimensions définissant un filtre de groupe de fiches.
| Champs | |
|---|---|
dimensions[] |
Chemin d'accès complet aux dimensions dans la hiérarchie des filtres de groupe de fiches (à l'exclusion du nœud racine) vers ce filtre de groupe de fiches. |
LocationView
Une vue des zones géographiques résume les performances des campagnes selon un critère géographique.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue de l'établissement. Les noms de ressources des vues de localisation se présentent sous la forme suivante :
|
ProductBiddingCategoryConstant
Catégorie d'enchères pour les produits.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la catégorie d'enchères du produit. Les noms de ressources des catégories d'enchères de produits se présentent sous la forme suivante :
|
level |
Niveau de la catégorie d'enchères du produit. |
status |
État de la catégorie d'enchères du produit. |
id |
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 |
Code pays à deux lettres en majuscules de la catégorie d'enchères du produit. |
product_bidding_category_constant_parent |
Nom de ressource de la catégorie d'enchères de produits parente. |
language_code |
Code de langue de la catégorie d'enchères du produit. |
localized_name |
Valeur à afficher de la catégorie d'enchères sur les produits, localisée en fonction de language_code. |
ProductGroupView
Vue du groupe de produits.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue du groupe de produits. Les noms de ressources des vues de groupes de produits se présentent sous la forme suivante :
|
SearchAds360Field
Champ ou ressource (artefact) utilisé par SearchAds360Service.
| Champs | |
|---|---|
resource_name |
Nom de ressource de l'artefact. Les noms de ressources d'artefact se présentent sous la forme suivante :
|
category |
Catégorie de l'artefact. |
selectable_with[] |
Noms de toutes les ressources, de tous les segments et de toutes les métriques pouvant être sélectionnés avec l'artefact décrit. |
attribute_resources[] |
Noms de toutes les ressources qui peuvent ê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[] |
Ce champ liste les noms de toutes les métriques qui peuvent être sélectionnées 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 "RESOURCE". |
segments[] |
Ce champ liste les noms de tous les artefacts (segment ou 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[] |
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 catégorie SEGMENT ou ATTRIBUTE. |
data_type |
Ce champ détermine les opérateurs pouvant être utilisés avec l'artefact dans les clauses WHERE. |
name |
Nom de l'artefact. |
selectable |
Indique si l'artefact peut être utilisé dans une clause SELECT dans les requêtes de recherche. |
filterable |
Indique si l'artefact peut être utilisé dans une clause WHERE dans les requêtes de recherche. |
sortable |
Indique si l'artefact peut être utilisé dans une clause ORDER BY dans les requêtes de recherche. |
type_url |
URL du fichier proto décrivant le type de données de l'artefact. |
is_repeated |
Indique si l'artefact de champ est répété. |
ShoppingPerformanceView
Vue des performances Shopping.
Fournit des statistiques sur les campagnes Shopping et Performance Max agrégées à plusieurs niveaux de dimension produit. Les valeurs de dimension produit de Merchant Center, telles que la marque, la catégorie, les attributs personnalisés, l'état du produit et le type de produit, reflètent l'état de chaque dimension à la date et à l'heure où l'événement correspondant a été enregistré.
Le nombre d'impressions et de clics pour lesquels shopping_performance_view renvoie des statistiques peut être différent de celui des rapports sur les campagnes. shopping_performance_view indique les impressions et les clics sur les produits qui apparaissent dans les annonces, tandis que les rapports sur les campagnes indiquent les impressions et les clics sur les annonces elles-mêmes. Selon le format, une annonce peut présenter de zéro à plusieurs produits. Il est donc possible que les chiffres ne correspondent pas.
Dans l'UI Search Ads 360, vous pouvez interroger les impressions et les clics des produits apparaissant dans les annonces en sélectionnant une colonne dans "Attributs du produit" dans l'éditeur de rapports. Par exemple, sélectionner la colonne "Marque" équivaut à sélectionner segments.product_brand.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue des performances Shopping. Les noms de ressources des vues des performances Shopping se présentent sous la forme suivante : |
UserList
Une liste d'utilisateurs. Il s'agit d'une liste d'utilisateurs qu'un client peut cibler. La clé unique d'une liste d'utilisateurs se compose des champs suivants : id. Notez que name doit également être unique pour les listes d'utilisateurs appartenant à un client donné, sauf dans certains cas où access_reason est défini sur SHARED. Si vous ne respectez pas la contrainte de nom unique, l'erreur UserListError.INVALID_NAME s'affiche.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la liste d'utilisateurs. Les noms de ressources de liste d'utilisateurs se présentent sous la forme suivante :
|
type |
Type de cette liste. Ce champ est en lecture seule. |
id |
ID de la liste d'utilisateurs. |
name |
Nom de cette liste d'utilisateurs. Unique par liste d'utilisateurs, sauf dans certains cas où une liste d'utilisateurs du même nom a la valeur |
UserLocationView
Vue de la zone géographique d'un utilisateur.
La vue "Emplacement de l'utilisateur" inclut toutes les métriques agrégées au niveau du pays, avec une ligne par pays. Il indique les métriques en fonction de la position physique réelle de l'utilisateur, selon la zone ciblée ou non. Si d'autres champs de segment sont utilisés, vous pouvez obtenir plusieurs lignes par pays.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue de la zone géographique de l'utilisateur. Les noms de ressources des vues UserLocation se présentent sous la forme suivante :
|
country_criterion_id |
ID du critère pour le pays. |
targeting_location |
Indique si l'établissement a été ciblé ou non. |
Consulter
une visite ;
| Champs | |
|---|---|
resource_name |
Nom de ressource de la visite. Les noms de ressources de visite sont au format suivant :
|
id |
ID de la visite. |
criterion_id |
Identifiant de mot clé Search Ads 360 La valeur 0 indique que le mot clé n'est pas attribué. |
merchant_id |
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 |
Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée. |
click_id |
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 |
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 |
Identifiant du produit ayant fait l'objet d'un clic. |
product_channel |
Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin. |
product_language_code |
Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit. |
product_store_id |
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 |
Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic. |
asset_id |
ID du composant avec lequel l'utilisateur a interagi lors de l'événement de visite. |
asset_field_type |
Type de champ de l'élément de l'événement de visite. |
WebpageView
Une vue de page Web.
| Champs | |
|---|---|
resource_name |
Nom de ressource de la vue de la page Web. Les noms de ressources de vues de pages Web se présentent sous la forme suivante :
|