Package google.ads.searchads360.v0.common

Index

AdScheduleInfo

Représente un critère AdSchedule.

AdSchedule est spécifié en tant que jour de la semaine et intervalle de temps pendant lequel les annonces seront diffusées.

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

Champs
start_minute

MinuteOfHour

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

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

end_minute

MinuteOfHour

Minutes après l'heure de fin à laquelle cette programmation se termine. La minute de fin n'est pas incluse dans l'horaire.

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

day_of_week

DayOfWeek

Jour de la semaine auquel la programmation s'applique.

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

start_hour

int32

Heure de début au format 24 heures. Ce champ doit être compris entre 0 et 23 inclus.

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

end_hour

int32

Heure de fin au format 24 heures (24 signifie la fin de la journée). Ce champ doit être compris entre 0 et 24, inclus.

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

AdTextAsset

Composant texte utilisé dans une annonce.

Champs
text

string

Texte de l'élément.

AgeRangeInfo

Critère de tranche d'âge.

Champs
type

AgeRangeType

Type de tranche d'âge.

AssetInteractionTarget

Segment AssetInteractionTarget.

Champs
asset

string

Nom de la ressource de l'asset.

interaction_on_this_asset

bool

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et AdGroupAsset. Indique si les métriques d'interaction ont eu lieu sur l'asset lui-même, ou sur un autre asset ou une autre unité d'annonce.

AssetUsage

Contient les informations d'utilisation de l'asset.

Champs
asset

string

Nom de ressource de l'élément.

served_asset_field_type

ServedAssetFieldType

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

AudienceInfo

Un critère d'audience.

Champs
audience

string

Nom de la ressource Audience.

BusinessProfileLocation

Données de localisation de la fiche d'établissement synchronisées à partir du compte de fiche d'établissement associé.

Champs
labels[]

string

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

store_code

string

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

listing_id

int64

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

CallToActionAsset

Composant d'incitation à l'action.

Champs
call_to_action

CallToActionType

Incitation à l'action.

CustomParameter

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

Champs
key

string

Clé correspondant au nom de la balise du paramètre.

value

string

Valeur à remplacer.

DeviceInfo

Critère d'appareil.

Champs
type

Device

Type d'appareil.

EnhancedCpc

Ce type ne comporte aucun champ.

Stratégie d'enchères automatisée qui augmente les enchères pour les clics qui semblent le plus susceptibles de générer une conversion et les diminue pour les clics pour lesquels cette probabilité est faible.

Cette stratégie d'enchères est obsolète et ne peut plus être créée. Utilisez ManualCpc avec enhanced_cpc_enabled défini sur "true" pour obtenir une fonctionnalité équivalente.

FrequencyCapEntry

Ce type ne comporte aucun champ.

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

GenderInfo

Critère de genre.

Champs
type

GenderType

Type de genre.

ImageAsset

Un composant Image.

Champs
mime_type

MimeType

Type MIME du composant Image.

full_size

ImageDimension

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

file_size

int64

Taille du fichier du composant Image, en octets.

ImageDimension

Métadonnées d'une image à une certaine taille, d'origine ou redimensionnée.

Champs
height_pixels

int64

Hauteur de l'image.

width_pixels

int64

Largeur de l'image.

url

string

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

Mot clé

Segment de critère de mot clé.

Champs
info

KeywordInfo

Informations sur le mot clé.

ad_group_criterion

string

Nom de la ressource GroupByKey.

KeywordInfo

Un critère de mot clé.

Champs
match_type

KeywordMatchType

Type de correspondance du mot clé.

text

string

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

LanguageInfo

Critère linguistique

Champs
language_constant

string

Nom de la ressource de la constante de langue.

ListingGroupInfo

Critère de groupe de fiches.

Champs
type

ListingGroupType

Type du groupe de fiches.

LocationGroupInfo

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

Champs
geo_target_constants[]

string

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

radius_units

LocationGroupRadiusUnits

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

feed_item_sets[]

string

Ensembles d'éléments de flux dont les éléments de flux sont ciblés. Si plusieurs ID sont spécifiés, tous les éléments qui apparaissent dans au moins un ensemble sont ciblés. Ce champ ne peut pas être utilisé avec geo_target_constants. Cette étape est facultative et ne peut être définie que dans les opérations CREATE.

radius

int64

Distance en unités spécifiant le rayon autour des zones ciblées. Ce paramètre est obligatoire et doit être défini dans les opérations CREATE.

LocationInfo

Un critère géographique.

Champs
geo_target_constant

string

Nom de la ressource constante de ciblage géographique.

ManualCpa

Ce type ne comporte aucun champ.

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.

ManualCpc

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

Champs
enhanced_cpc_enabled

bool

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

ManualCpm

Ce type ne comporte aucun champ.

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

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
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. Peut être modifié uniquement pour les stratégies d'enchères de portefeuille.

cpc_bid_floor_micros

int64

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

target_roas

double

L'option "Objectif de ROAS cible" Si cette valeur est définie, la stratégie d'enchères maximise les revenus tout en atteignant le ROAS cible moyen. Si le ROAS cible est élevé, la stratégie d'enchères risque de ne pas pouvoir dépenser la totalité du budget. Si 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.

MaximizeConversions

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

Champs
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. Peut être modifié uniquement pour les stratégies d'enchères de portefeuille.

cpc_bid_floor_micros

int64

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

target_cpa_micros

int64

L'option "Coût par action cible" (CPA cible) Il s'agit du montant moyen que vous souhaitez dépenser par action de conversion, spécifié en micro-unités de la devise de la stratégie d'enchères. Si vous définissez cette stratégie, elle générera autant de conversions que possible pour un coût par action cible égal ou inférieur. Si vous ne définissez pas de CPA cible, la stratégie d'enchères s'efforcera d'obtenir le CPA le plus bas possible compte tenu du budget.

Métriques

Données de métriques.

Champs
all_conversions_value_by_conversion_date

double

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

all_conversions_by_conversion_date

double

Cette valeur correspond au nombre total de conversions. Inclut toutes les conversions, quelle que soit la valeur de "include_in_conversions_metric". Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne de date correspondent à la date de conversion. Pour en savoir plus sur les colonnes "by_conversion_date", consultez la page https://support.google.com/sa360/answer/9250611.

conversion_custom_metrics[]

Value

Métriques personnalisées de conversion

conversions_value_by_conversion_date

double

Somme de la valeur des conversions enchérissables par date de conversion. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne de date correspondent à la date de conversion.

conversions_by_conversion_date

double

Somme des conversions par date de conversion pour les types de conversion enchérissables. Peut être fractionnaire en raison de la modélisation d'attribution. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne de date correspondent à la date de conversion.

historical_creative_quality_score

QualityScoreBucket

Historique du niveau de qualité de la création.

historical_landing_page_quality_score

QualityScoreBucket

Qualité de l'expérience sur la page de destination au fil du temps.

historical_search_predicted_ctr

QualityScoreBucket

Taux de clics (CTR) prédit sur la base de l'historique des recherches

interaction_event_types[]

InteractionEventType

Types d'interactions payantes et gratuites.

raw_event_conversion_metrics[]

Value

Métriques de conversion d'événement brutes.

absolute_top_impression_percentage

double

Le taux d'impressions en première position absolue sur le Réseau de Recherche correspond au pourcentage d'impressions de vos annonces diffusées à la position la plus proéminente sur le Réseau de Recherche.

all_conversions_from_interactions_rate

double

Toutes les conversions issues des interactions (par opposition aux conversions après affichage) divisées par le nombre d'interactions avec les annonces.

all_conversions_value

double

Valeur de toutes les conversions.

all_conversions

double

Cette valeur correspond au nombre total de conversions. Inclut toutes les conversions, quelle que soit la valeur de "include_in_conversions_metric".

all_conversions_value_per_cost

double

Valeur de toutes les conversions divisée par le coût total des interactions avec l'annonce (clics pour les annonces textuelles ou visionnages pour les annonces vidéo, par exemple).

all_conversions_from_click_to_call

double

Nombre de fois où les utilisateurs ont cliqué sur le bouton "Appeler" pour contacter un magasin pendant ou après avoir cliqué sur une annonce. Tous les appels sont comptabilisés, indépendamment de leur durée, qu'ils aient abouti ou non.

Cette métrique ne s'applique qu'aux éléments de flux.

all_conversions_from_directions

double

Nombre de fois où les internautes ont cliqué sur le bouton "Itinéraire" pour se rendre dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

all_conversions_from_interactions_value_per_interaction

double

Valeur de toutes les conversions issues des interactions, divisée par le nombre total d'interactions.

all_conversions_from_menu

double

Nombre de fois où les utilisateurs ont cliqué sur un lien vers le menu d'un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

all_conversions_from_order

double

Nombre de fois où les utilisateurs ont passé une commande dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

all_conversions_from_other_engagement

double

Nombre de conversions autres que celles répertoriées (par exemple, la publication d'un avis ou l'enregistrement de l'adresse du magasin) effectuées par les utilisateurs après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

all_conversions_from_store_visit

double

Estimation du nombre de fois où les utilisateurs se sont rendus dans un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

visits

double

Clics que Search Ads 360 a bien enregistrés et transférés vers la page de destination d'un annonceur.

all_conversions_from_store_website

double

Nombre de fois où les internautes ont été redirigés vers l'URL d'un magasin après avoir cliqué sur une annonce.

Cette métrique ne s'applique qu'aux éléments de flux.

average_cost

double

Il s'agit du montant moyen que vous payez par interaction. Cette somme correspond au coût total de vos annonces divisé par le nombre total d'interactions.

average_cpc

double

Coût total de tous les clics divisé par le nombre total de clics reçus. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

average_cpm

double

Coût moyen pour mille impressions (CPM). Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

clicks

int64

Nombre de clics.

content_budget_lost_impression_share

double

Estimation du nombre de fois (en %) où votre annonce était susceptible d'être diffusée sur le Réseau Display, mais ne l'a pas été en raison d'un budget trop faible. Remarque : le taux d'impressions perdues pour le budget du contenu est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

content_impression_share

double

Il s'agit du nombre d'impressions enregistrées sur le Réseau Display, divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Remarque : le taux d'impressions du contenu est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

content_rank_lost_impression_share

double

Estimation du pourcentage d'impressions que vos annonces n'ont pas reçues sur le Réseau Display en raison d'un mauvais classement. Remarque : le taux d'impressions perdues dans le classement du contenu est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

conversions_from_interactions_rate

double

Nombre moyen de conversions enchérissables (à partir d'interactions) par interaction éligible à une conversion. Indique la fréquence moyenne à laquelle une interaction avec une annonce génère une conversion enchérissable.

client_account_conversions_value

double

Valeur des conversions de compte client. Cela n'inclut que les actions de conversion dont l'attribut "include_in_client_account_conversions_metric" est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

conversions_value_per_cost

double

Valeur d'une conversion enchérissable divisée par le coût total des interactions éligibles à la conversion.

conversions_from_interactions_value_per_interaction

double

Valeur des conversions issues des interactions divisée par le nombre d'interactions avec l'annonce. Cela n'inclut que les actions de conversion dont l'attribut "include_in_conversions_metric" est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

client_account_conversions

double

Nombre de conversions de comptes client. Cela n'inclut que les actions de conversion dont l'attribut "include_in_client_account_conversions_metric" est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

cost_micros

int64

Somme du coût par clic (CPC) et du coût par mille impressions (CPM) enregistrés au cours de la période concernée. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

cost_per_all_conversions

double

Coût des interactions avec l'annonce divisé par le nombre total de conversions.

cost_per_conversion

double

Coût moyen éligible à la conversion par conversion enchérissable.

cost_per_current_model_attributed_conversion

double

Coût des interactions avec les annonces divisé par les conversions attribuées par le modèle actuel. Cela n'inclut que les actions de conversion dont l'attribut "include_in_conversions_metric" est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

cross_device_conversions

double

Conversions enregistrées lorsqu'un client clique sur une annonce sur un appareil, puis effectue une conversion sur un autre appareil ou navigateur. Les conversions multi-appareils sont déjà incluses dans "all_conversions".

cross_device_conversions_by_conversion_date

double

Nombre de conversions multi-appareils par date de conversion. Pour en savoir plus sur les colonnes "par_date_de_conversion", consultez https://support.google.com/sa360/answer/9250611.

cross_device_conversions_value

double

Somme de la valeur des conversions multi-appareils.

cross_device_conversions_value_by_conversion_date

double

Somme des valeurs des conversions multi-appareils par date de conversion. Pour en savoir plus sur les colonnes "par_date_de_conversion", consultez https://support.google.com/sa360/answer/9250611.

ctr

double

Nombre de clics sur votre annonce (clics) divisé par le nombre d'affichages de celle-ci (impressions).

conversions

double

Nombre de conversions Cela n'inclut que les actions de conversion dont l'attribut "include_in_conversions_metric" est défini sur "true". Si vous utilisez des enchères basées sur les conversions, vos stratégies d'enchères optimiseront ces conversions.

conversions_value

double

Somme des valeurs de conversion incluses dans le champ "Conversions". Cette métrique n'est utile que si vous avez associé une valeur à vos actions de conversion.

average_quality_score

double

Niveau de qualité moyen.

historical_quality_score

int64

Historique du niveau de qualité.

impressions

int64

Fréquence à laquelle votre annonce a été diffusée sur une page de résultats de recherche ou sur un site Web du Réseau Google.

interaction_rate

double

Fréquence à laquelle les utilisateurs interagissent avec votre annonce après l'avoir vue. Il s'agit du nombre d'interactions divisé par le nombre de fois où votre annonce est diffusée.

interactions

int64

Nombre d'interactions. Une interaction correspond à la principale action effectuée par l'utilisateur en fonction du format de l'annonce (clic pour les annonces textuelles et Shopping, visionnage pour les annonces vidéo, etc.).

invalid_click_rate

double

Pourcentage de clics exclus du nombre total de clics (clics filtrés et non filtrés) au cours de la période de référence.

invalid_clicks

int64

Nombre de clics que Google considère comme illégitimes et qui ne vous sont pas facturés.

general_invalid_click_rate

double

Pourcentage de clics non comptabilisés dans le nombre total de clics (clics filtrés + clics non filtrés) car il s'agissait de clics incorrects généraux. Il s'agit de clics que Google considère comme illicites et qui sont détectés par des moyens de filtrage de routine (trafic incorrect connu des centres de données, robots et autres robots d'exploration, schémas irréguliers, etc.). Ces clics ne sont ni facturés, ni comptabilisés dans les statistiques de votre compte. Pour en savoir plus, consultez la page d'aide https://support.google.com/campaignmanager/answer/6076504.

general_invalid_clicks

int64

Nombre de clics incorrects généraux. Il s'agit d'un sous-ensemble de vos clics incorrects détectés par des méthodes de filtrage régulières (trafic incorrect connu d'un centre de données, robots d'exploration, schémas irréguliers, etc.). Ces clics ne sont ni facturés, ni comptabilisés dans les statistiques de votre compte. Pour en savoir plus, consultez la page d'aide https://support.google.com/campaignmanager/answer/6076504.

mobile_friendly_clicks_percentage

double

Pourcentage de clics sur mobile qui redirigent les utilisateurs vers une page adaptée aux mobiles.

search_absolute_top_impression_share

double

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

search_budget_lost_absolute_top_impression_share

double

Nombre estimé de fois où votre annonce n'était pas la première des annonces en première position dans les résultats de recherche en raison d'un budget trop faible. Remarque: le taux d'impressions perdues en première position absolue sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

search_budget_lost_impression_share

double

Estimation du pourcentage de fois où votre annonce était susceptible d'être diffusée sur le Réseau de Recherche, mais ne l'a pas été en raison d'un budget trop faible. Remarque : le taux d'impressions perdues sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

search_budget_lost_top_impression_share

double

Nombre estimé de fois où votre annonce n'a pas été diffusée à côté des meilleurs résultats de recherche naturels en raison d'un budget insuffisant. Remarque: le taux d'impressions perdues en première position sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

search_click_share

double

Nombre de clics enregistrés sur le Réseau de Recherche, divisé par le nombre estimé de clics que vous auriez pu enregistrer. Remarque: La part de clics sur le Réseau de Recherche est comprise entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

search_exact_match_impression_share

double

Nombre d'impressions enregistrées par vos annonces sur le Réseau de Recherche pour des termes de recherche correspondant exactement à vos mots clés (ou étant des variantes proches), divisé par le nombre estimé d'impressions qu'elles étaient susceptibles d'enregistrer dans les mêmes conditions, quel que soit le type de correspondance de vos mots clés. Remarque: Le taux d'impressions pour les mots clés exacts sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

search_impression_share

double

Il s'agit du nombre d'impressions enregistrées sur le Réseau de Recherche, divisé par le nombre estimé d'impressions susceptibles d'avoir été enregistrées. Remarque : le taux d'impressions sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

search_rank_lost_absolute_top_impression_share

double

Estimation de la fréquence à laquelle votre annonce ne figurait pas en toute première place parmi les annonces en première position dans les résultats de recherche en raison de son mauvais classement. Remarque: Le taux d'impressions perdues en première position absolue dans le classement dans les résultats de recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

search_rank_lost_impression_share

double

Estimation du pourcentage d'impressions que vos annonces n'ont pas reçues sur le Réseau de Recherche en raison d'un mauvais classement. Remarque : le taux d'impressions perdues pour le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

search_rank_lost_top_impression_share

double

Nombre estimé de fois où votre annonce n'a pas été diffusée à côté des meilleurs résultats de recherche naturels en raison de son mauvais classement. Remarque: Le taux d'impressions perdues en première position dans les résultats de recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

search_top_impression_share

double

Impressions que vous avez enregistrées parmi les annonces en première position comparées au nombre estimé d'impressions qu'elles étaient susceptibles d'enregistrer dans les annonces en première position. Remarque: le taux d'impressions en première position sur le Réseau de Recherche est compris entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

Les meilleures annonces apparaissent généralement au-dessus des premiers résultats naturels, même si pour certaines requêtes, elles peuvent s'afficher en dessous des résultats naturels en haut de page.

top_impression_percentage

double

Pourcentage de vos impressions d'annonces diffusées à côté des premiers résultats de recherche naturels.

value_per_all_conversions

double

Valeur de toutes les conversions divisée par leur nombre.

value_per_all_conversions_by_conversion_date

double

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

value_per_conversion

double

Valeur d'une conversion enchérissable divisée par le nombre de conversions enchérissables. Indique la valeur moyenne de chacune des conversions enchérissables.

value_per_conversions_by_conversion_date

double

Valeur des conversions enchérissables par date de conversion, divisée par les conversions enchérissables par date de conversion. Indique la valeur moyenne de chacune des conversions enchérissables (par date de conversion). Lorsque cette colonne est sélectionnée avec la date, ses valeurs correspondent à la date de la conversion.

client_account_view_through_conversions

int64

Nombre total de conversions après affichage Cela se produit lorsqu'un client voit une annonce illustrée ou rich media, puis effectue ultérieurement une conversion sur votre site sans interagir avec une autre annonce (par exemple, en cliquant dessus).

client_account_cross_sell_cost_of_goods_sold_micros

int64

Le prix de revient des ventes croisées du compte client correspond au coût total des produits vendus suite à la promotion d'un autre produit. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Le prix de revient des ventes croisées correspond au coût total des produits vendus dont vous n'avez pas fait la promotion. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 $ et celui de la chemise est de 5 $. Le prix de revient des ventes croisées pour cette commande est de 5 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

cross_sell_cost_of_goods_sold_micros

int64

Le prix de revient des ventes croisées correspond au coût total des produits vendus suite à la promotion d'un autre produit. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Le prix de revient des ventes croisées correspond au coût total des produits vendus dont vous n'avez pas fait la promotion. Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 $ et celui de la chemise est de 5 $. Le prix de revient des ventes croisées pour cette commande est de 5 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

client_account_cross_sell_gross_profit_micros

int64

La marge brute des ventes croisées du compte client correspond aux bénéfices générés par les produits vendus suite à la promotion d'un autre produit, moins le prix de revient. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. La marge brute des ventes croisées correspond au revenu généré par la vente croisée attribuée à vos annonces, moins le prix de revient. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La chemise coûte 20 $, et son prix de revient est de 5 $. La marge brute de la vente croisée de cette commande est égale à 20 $ - 5 $, soit 15 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

cross_sell_gross_profit_micros

int64

La marge brute des ventes croisées correspond aux bénéfices générés par les produits vendus suite à la promotion d'un autre produit, moins le prix de revient. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. La marge brute des ventes croisées correspond au revenu généré par la vente croisée attribuée à vos annonces, moins le prix de revient. Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La chemise coûte 20 $, et son prix de revient est de 5 $. La marge brute de la vente croisée de cette commande est égale à 20 $ - 5 $, soit 15 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

client_account_cross_sell_revenue_micros

int64

Les revenus des ventes croisées du compte client correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion d'un autre produit. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les revenus des ventes croisées correspondent à la valeur totale des ventes croisées attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus de la vente croisée pour cette commande sont de 20 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

cross_sell_revenue_micros

int64

Les revenus des ventes croisées correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion d'un autre produit. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les revenus des ventes croisées correspondent à la valeur totale des ventes croisées attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus de la vente croisée pour cette commande sont de 20 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

client_account_cross_sell_units_sold

double

La métrique "Unités vendues via les ventes croisées du compte client" correspond au nombre total de produits vendus suite à la promotion d'un autre produit. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les unités vendues via les ventes croisées correspondent au nombre total de produits vendus par vente croisée issus de toutes les commandes attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues via les ventes croisées dans cette commande est de 2. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

cross_sell_units_sold

double

La métrique "Unités vendues via les ventes croisées" correspond au nombre total de produits vendus suite à la promotion d'un autre produit. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si ces deux produits sont différents, on parle de vente croisée. Les unités vendues via les ventes croisées correspondent au nombre total de produits vendus par vente croisée issus de toutes les commandes attribuées à vos annonces. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette, une chemise et une veste. Le nombre d'unités vendues via les ventes croisées dans cette commande est de 2. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier.

client_account_lead_cost_of_goods_sold_micros

int64

Le prix de revient des biens du prospect vendus dans le compte client correspond au coût total des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, leur coût est comptabilisé comme coût de vente lié aux prospects. Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 $ et celui de la chemise est de 5 $. Le coût de vente lié aux prospects pour cette commande est de 3 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

lead_cost_of_goods_sold_micros

int64

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

client_account_lead_gross_profit_micros

int64

La marge brute des prospects du compte client correspond aux bénéfices générés par les produits vendus suite à la promotion de ces mêmes produits, moins le prix de revient. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, votre marge brute des prospects est calculée comme suit : revenus générés par ces ventes moins le prix de revient. Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et a une valeur de 3 $ pour le prix de revient. La marge brute des prospects pour cette commande est égale à 7 $, soit 10 $ - 3 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

lead_gross_profit_micros

int64

La marge brute des prospects correspond aux bénéfices générés par les produits vendus suite à la promotion de ces mêmes produits, moins le prix de revient. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, votre marge brute des prospects est calculée comme suit : revenus générés par ces ventes moins le prix de revient. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et a une valeur de 3 $ pour le prix de revient. La marge brute des prospects pour cette commande est égale à 7 $, soit 10 $ - 3 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

client_account_lead_revenue_micros

int64

Les revenus des prospects du compte client correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement : vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, la valeur totale des ventes de ces produits s'affiche sous "Revenus des prospects". Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus des prospects pour cette commande s'élèvent à 10 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est renvoyée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

lead_revenue_micros

int64

Les revenus des prospects correspondent au montant total que vous avez généré avec des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi avant l'achat est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, la valeur totale des ventes de ces produits s'affiche sous "Revenus des prospects". Exemple : Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. La casquette coûte 10 $ et la chemise 20 $. Les revenus des prospects pour cette commande sont de 10 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Pour en savoir plus sur le paramètre metrics_currency, consultez https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

client_account_lead_units_sold

double

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

lead_units_sold

double

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

MobileAppAsset

Asset représentant une application mobile.

Champs
app_id

string

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

app_store

MobileAppVendor

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

PercentCpc

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

Champs
cpc_bid_ceiling_micros

int64

Limite d'enchère maximale pouvant être définie par la stratégie d'enchères. Il s'agit d'un champ facultatif saisi par l'annonceur et spécifié en micro-unités locales. Remarque: Une valeur de zéro est interprétée de la même manière que si la valeur bid_ceiling n'était pas définie.

enhanced_cpc_enabled

bool

Ajuste l'enchère pour chaque mise aux enchères à la hausse ou à la baisse, en fonction de la probabilité d'une conversion. Les enchères individuelles peuvent dépasser la valeur cpc_bid_ceiling_micros, mais le montant moyen des enchères d'une campagne ne doit pas le faire.

RealTimeBiddingSetting

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

Champs
opt_in

bool

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

SearchAds360ExpandedDynamicSearchAdInfo

Annonce dynamique agrandie du Réseau de Recherche.

Champs
description1

string

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

description2

string

Deuxième ligne de description de l'annonce.

ad_tracking_id

int64

ID de suivi de l'annonce.

SearchAds360ExpandedTextAdInfo

Annonce textuelle agrandie Search Ads 360.

Champs
headline

string

Titre de l'annonce.

headline2

string

Deuxième titre de l'annonce.

headline3

string

Troisième titre de l'annonce.

description1

string

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

description2

string

Deuxième ligne de description de l'annonce.

path1

string

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

path2

string

Texte ajouté à path1 avec un délimiteur.

ad_tracking_id

int64

ID de suivi de l'annonce.

SearchAds360ProductAdInfo

Ce type ne comporte aucun champ.

Annonce produit Search Ads 360.

SearchAds360ResponsiveSearchAdInfo

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

Champs
headlines[]

AdTextAsset

Liste des composants texte pour les titres. Lorsque l'annonce est diffusée, les titres sont sélectionnés dans cette liste.

descriptions[]

AdTextAsset

Liste des composants texte pour les descriptions. Lorsque l'annonce est diffusée, les descriptions sont sélectionnées dans cette liste.

path1

string

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

path2

string

Texte ajouté à path1 avec un délimiteur.

ad_tracking_id

int64

ID de suivi de l'annonce.

SearchAds360TextAdInfo

Annonce textuelle Search Ads 360.

Champs
headline

string

Titre de l'annonce.

description1

string

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

description2

string

Deuxième ligne de description de l'annonce.

display_url

string

URL affichée de l'annonce

display_mobile_url

string

URL mobile affichée de l'annonce.

ad_tracking_id

int64

ID de suivi de l'annonce.

Segments

Champs de segment uniquement.

Champs
ad_network_type

AdNetworkType

Type de réseau publicitaire.

conversion_action_category

ConversionActionCategory

Catégorie d'action de conversion.

conversion_custom_dimensions[]

Value

Dimensions personnalisées de la conversion.

day_of_week

DayOfWeek

Jour de la semaine (par exemple, MONDAY)

device

Device

Appareil auquel les métriques s'appliquent.

keyword

Keyword

Critère de mot clé.

product_channel

ProductChannel

Canal du produit.

product_channel_exclusivity

ProductChannelExclusivity

Exclusivité de canal du produit.

product_condition

ProductCondition

État du produit.

product_sold_condition

ProductCondition

État du produit vendu.

raw_event_conversion_dimensions[]

Value

Dimensions de conversion d'événement brutes.

conversion_action

string

Nom de ressource de l'action de conversion.

conversion_action_name

string

Nom de l'action de conversion

date

string

Date à laquelle les métriques s'appliquent, au format aaaa-MM-jj, par exemple 2018-04-17.

geo_target_city

string

Nom de la ressource de la constante de ciblage géographique représentant une ville.

geo_target_country

string

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

geo_target_metro

string

Nom de la ressource de la constante de ciblage géographique représentant une zone métropolitaine.

geo_target_region

string

Nom de la ressource de la constante de ciblage géographique représentant une région.

hour

int32

Heure de la journée sous la forme d'un nombre compris entre 0 et 23 inclus.

month

string

Mois représenté par la date du premier jour du mois. au format AAAA-MM-JJ.

product_bidding_category_level1

string

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

product_bidding_category_level2

string

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

product_bidding_category_level3

string

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

product_bidding_category_level4

string

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

product_bidding_category_level5

string

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

product_brand

string

Marque du produit.

product_country

string

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

product_custom_attribute0

string

Attribut personnalisé 0 du produit.

product_custom_attribute1

string

Attribut personnalisé 1 du produit.

product_custom_attribute2

string

Attribut personnalisé 2 du produit.

product_custom_attribute3

string

Attribut personnalisé 3 du produit.

product_custom_attribute4

string

Attribut personnalisé 4 du produit.

product_item_id

string

ID d'article du produit.

product_language

string

Nom de ressource de la constante de langue du produit.

product_sold_bidding_category_level1

string

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

product_sold_bidding_category_level2

string

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

product_sold_bidding_category_level3

string

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

product_sold_bidding_category_level4

string

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

product_sold_bidding_category_level5

string

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

product_sold_brand

string

Marque du produit vendu.

product_sold_custom_attribute0

string

Attribut personnalisé 0 du produit vendu.

product_sold_custom_attribute1

string

Attribut personnalisé 1 du produit vendu.

product_sold_custom_attribute2

string

Attribut personnalisé 2 du produit vendu

product_sold_custom_attribute3

string

Attribut personnalisé 3 du produit vendu.

product_sold_custom_attribute4

string

Attribut personnalisé 4 du produit vendu.

product_sold_item_id

string

ID d'article du produit vendu.

product_sold_title

string

Titre du produit vendu.

product_sold_type_l1

string

Type (niveau 1) du produit vendu.

product_sold_type_l2

string

Type (niveau 2) du produit vendu.

product_sold_type_l3

string

Type (niveau 3) du produit vendu.

product_sold_type_l4

string

Type (niveau 4) du produit vendu.

product_sold_type_l5

string

Type (niveau 5) du produit vendu.

product_store_id

string

ID de magasin associé au produit.

product_title

string

Titre du produit.

product_type_l1

string

Type (niveau 1) du produit.

product_type_l2

string

Type (niveau 2) du produit.

product_type_l3

string

Type (niveau 3) du produit.

product_type_l4

string

Type (niveau 4) du produit.

product_type_l5

string

Type (niveau 5) du produit.

quarter

string

Trimestre représenté par la date du premier jour d'un trimestre. Utilise l'année civile pour les trimestres. Par exemple, le deuxième trimestre de 2018 commence le 01/04/2018. au format AAAA-MM-JJ.

week

string

Semaine définie du lundi au dimanche et représentée par la date du lundi. au format aaaa-MM-jj.

year

int32

Année, au format aaaa.

asset_interaction_target

AssetInteractionTarget

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et AdGroupAsset. Indique si les métriques d'interaction ont eu lieu sur le composant lui-même, ou sur un autre composant ou bloc d'annonces. Les interactions (clics, par exemple) sont comptabilisées pour toutes les parties de l'annonce diffusée (l'annonce elle-même et d'autres composants tels que les liens annexes) lorsqu'elles sont diffusées ensemble. Lorsque interaction_on_this_asset est définie sur "true", cela signifie que les interactions se produisent sur cet asset spécifique. Si elle est définie sur "false", cela signifie que les interactions ne se produisent pas sur cet asset spécifique, mais sur d'autres parties de l'annonce diffusée avec cet asset.

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

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.

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. Ce paramètre ne doit être défini que pour les stratégies de portefeuille d'enchères.

cpc_bid_floor_micros

int64

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

TargetCpm

Ce type ne comporte aucun champ.

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

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 choisie d'annonces à diffuser dans la zone 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.

TargetOutrankShare

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

Champs
cpc_bid_ceiling_micros

Int64Value

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.

TargetRestriction

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

Champs
targeting_dimension

TargetingDimension

Dimension de ciblage à laquelle ces paramètres s'appliquent.

bid_only

bool

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

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

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

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. Ce paramètre ne doit être défini que pour les stratégies de portefeuille d'enchères.

cpc_bid_floor_micros

int64

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

TargetSpend

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

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

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.

TargetingSetting

Paramètres des fonctionnalités de ciblage, au niveau de la campagne et du groupe d'annonces. Pour en savoir plus sur le paramètre de ciblage, consultez la page https://support.google.com/google-ads/answer/7365594.

Champs
target_restrictions[]

TargetRestriction

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

TextAsset

Un composant texte.

Champs
text

string

Contenu textuel du composant texte.

TextLabel

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

Champs
background_color

string

Couleur d'arrière-plan du libellé au format hexadécimal. Cette chaîne doit correspondre à l'expression régulière '^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$'. Remarque : La couleur d'arrière-plan peut ne pas être visible pour les comptes administrateur.

description

string

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

UnifiedCallAsset

Composant Appel unifié.

Champs
country_code

string

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

phone_number

string

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

call_conversion_reporting_state

CallConversionReportingState

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

call_conversion_action

string

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

ad_schedule_targets[]

AdScheduleInfo

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

call_only

bool

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

call_tracking_enabled

bool

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

use_searcher_time_zone

bool

Indique si l'extension d'appel doit s'afficher dans le fuseau horaire de l'utilisateur de la recherche. S'applique à Microsoft Ads.

start_date

string

Date de début de la diffusion de cet asset, au format AAAA-MM-JJ.

end_date

string

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

UnifiedCalloutAsset

Composant Accroche unifié.

Champs
callout_text

string

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

start_date

string

Date de début de la diffusion de cet asset, au format AAAA-MM-JJ.

end_date

string

Dernière date à laquelle cet élément est actif et diffusé, au format AAAA-MM-JJ.

ad_schedule_targets[]

AdScheduleInfo

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

use_searcher_time_zone

bool

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

UnifiedLocationAsset

Composant Lieu unifié.

Champs
place_id

string

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

business_profile_locations[]

BusinessProfileLocation

Liste des établissements du client. Cette valeur ne s'affiche que si le composant Lieu est synchronisé à partir du compte de fiche d'établissement. Il est possible d'avoir plusieurs fiches d'établissement dans un même compte qui pointent vers le même identifiant de lieu.

location_ownership_type

LocationOwnershipType

Type de droits détenus sur l'établissement. Si le type est BUSINESS_OWNER, il sera diffusé en tant qu'extension de lieu. Si le type est AFFILIÉ, il sera diffusé en tant que lieu affilié.

UnifiedPageFeedAsset

Élément de flux de pages unifié.

Champs
page_url

string

Page Web que les annonceurs souhaitent cibler.

labels[]

string

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

UnifiedSitelinkAsset

Composant Lien annexe unifié.

Champs
description1

string

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

description2

string

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

start_date

string

Date de début de la diffusion de cet asset, au format AAAA-MM-JJ.

end_date

string

Dernière date à laquelle cet élément est actif et diffusé, au format AAAA-MM-JJ.

ad_schedule_targets[]

AdScheduleInfo

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

tracking_id

int64

ID utilisé pour suivre les clics sur le composant Lien annexe. Il s'agit d'un compte Yahoo! Japan uniquement.

use_searcher_time_zone

bool

Indique si le composant Lien annexe doit s'afficher dans le fuseau horaire de l'utilisateur de la recherche. S'applique à Microsoft Advertising.

mobile_preferred

bool

Indique si le composant Lien annexe doit s'afficher sur les appareils mobiles. S'applique à Microsoft Ads.

UserListInfo

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

Champs
user_list

string

Nom de laressource de la liste d'utilisateurs.

Valeur

Conteneur de données générique.

Champs
Champ d'union value. une valeur. value ne peut être qu'un des éléments suivants :
boolean_value

bool

Valeur booléenne.

int64_value

int64

Un int64.

float_value

float

Une valeur flottante.

double_value

double

Valeur double.

string_value

string

Chaîne.

WebpageConditionInfo

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

Champs
operand

WebpageConditionOperand

Operande de la condition de ciblage des pages Web.

operator

WebpageConditionOperator

Opérateur de la condition de ciblage des pages Web.

argument

string

Argument de la condition de ciblage des pages Web.

WebpageInfo

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

Champs
conditions[]

WebpageConditionInfo

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

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

coverage_percentage

double

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

criterion_name

string

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

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

YoutubeVideoAsset

Un élément YouTube.

Champs
youtube_video_title

string

Titre de la vidéo YouTube.

youtube_video_id

string

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