Package google.ads.searchads360.v0.common

Index

AdScheduleInfo

Représente un critère AdSchedule.

Le calendrier de diffusion des annonces correspond au jour de la semaine et à l'intervalle de temps au cours duquel les annonces seront diffusées.

Vous ne pouvez pas ajouter plus de six calendriers de diffusion pour une même journée.

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 la planification se termine. La planification n'inclut pas la minute de fin.

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 le calendrier 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 contenir une valeur comprise entre 0 et 23 inclus.

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

end_hour

int32

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

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

AgeRangeInfo

Critère de tranche d'âge.

Champs
type

AgeRangeType

Type de tranche d'âge.

AssetInteractionTarget

Un segment AssetInteractionTarget.

Champs
asset

string

Nom de la ressource de l'élément.

interaction_on_this_asset

bool

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et GroupAsset. Indique si les métriques d'interaction concernent le composant lui-même, ou un autre composant ou bloc d'annonces.

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 de diffusion de l'élément.

AudienceInfo

Un critère d'audience.

Champs
audience

string

Nom de la ressource d'audience.

BusinessProfileLocation

Données sur l'établissement synchronisées depuis le compte de fiches d'établissement associé.

Champs
labels[]

string

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

store_code

string

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

listing_id

int64

ID de la fiche associée à cette adresse d'établissement. Elle est synchronisée à partir du compte de fiche d'établissement associé.

CallToActionAsset

Un composant Incitation à l'action.

Champs
call_to_action

CallToActionType

Incitation à l'action.

CustomParameter

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

Champs
key

string

Clé correspondant au nom du tag 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.

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

Cette stratégie d'enchères est obsolète et ne peut plus être créée. Pour obtenir des fonctionnalités équivalentes, utilisez ManualCpc en définissant "enhanced_cpc_enabled" sur "true".

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 leur taille d'origine.

file_size

int64

Taille du fichier du composant Image en octets.

ImageDimension

Métadonnées d'une image dans une certaine taille, originale 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é

Un segment de critère de mot-clé.

Champs
info

KeywordInfo

Informations sur le mot clé.

ad_group_criterion

string

Nom de la ressource Critère.

KeywordInfo

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

Un critère de langue.

Champs
language_constant

string

Nom de 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

Constantes des cibles géographiques limitant la portée de la zone géographique dans le flux. Actuellement, une seule constante de cible géographique est autorisée.

radius_units

LocationGroupRadiusUnits

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

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 figurent dans au moins un ensemble sont ciblés. Impossible d'utiliser ce champ 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. Cette étape est obligatoire et doit être définie 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 pour chaque action qu'il spécifie.

ManualCpc

Système d'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.

Système d'enchères manuel basé sur les impressions, où l'utilisateur paie pour mille impressions.

MaximizeConversionValue

Cette stratégie d'enchères automatiques vous permet d'enregistrer la meilleure valeur de conversion possible pour vos campagnes tout en exploitant la totalité de 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. Non modifiable uniquement 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. Non modifiable uniquement pour les stratégies de portefeuille d'enchères.

target_roas

double

Option de retour sur les dépenses publicitaires (ROAS) cible Si elle est définie, la stratégie d'enchères maximisera les revenus tout en atteignant, en moyenne, l'objectif de retour sur les dépenses publicitaires. Si le ROAS cible est élevé, il est possible que la stratégie d'enchères ne puisse pas dépenser la totalité du budget. Si aucun ROAS cible n'est défini, la stratégie d'enchères essaie d'atteindre le ROAS le plus élevé possible en fonction du budget.

MaximizeConversions

Cette stratégie d'enchères automatiques vous permet d'enregistrer le plus grand nombre de conversions possible pour vos campagnes tout en exploitant la totalité de 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. Non modifiable uniquement 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. Non modifiable uniquement pour les stratégies de portefeuille d'enchères.

target_cpa_micros

int64

L'option "Coût par action (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 elle est définie, la stratégie d'enchères générera autant de conversions que possible pour un coût par action cible égal ou inférieur. Si le CPA cible n'est pas défini, la stratégie d'enchères essaie d'atteindre le CPA le plus faible possible en fonction 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 "date" correspondent à la date de conversion. Vous trouverez des informations détaillées sur les colonnes "by_conversion_date" à l'adresse https://support.google.com/sa360/answer/9250611.

all_conversions_by_conversion_date

double

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 "date" correspondent à la date de conversion. Vous trouverez des informations détaillées sur les colonnes "by_conversion_date" à l'adresse https://support.google.com/sa360/answer/9250611.

conversion_custom_metrics[]

Value

Les métriques personnalisées de conversion.

conversions_value_by_conversion_date

double

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

conversions_by_conversion_date

double

Somme des conversions par date de conversion pour les types de conversions enchérissables. Peut être fractionnaire en raison de la modélisation de l'attribution. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "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

la qualité de l'historique de l'expérience sur la page de destination ;

historical_search_predicted_ctr

QualityScoreBucket

L'historique du taux de clics (CTR) prévu des recherches.

interaction_event_types[]

InteractionEventType

Types d'interactions payantes et sans frais.

raw_event_conversion_metrics[]

Value

Métriques brutes sur les conversions d'événements.

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

Nombre total de conversions générées par les interactions (et non par les conversions après affichage) divisé par le nombre d'interactions avec l'annonce.

all_conversions_value

double

Valeur de toutes les conversions.

all_conversions

double

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 vos annonces (clics pour les annonces textuelles, visionnages pour les annonces vidéo, etc.).

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. Ce nombre n'indique pas si les appels ont réussi ou non, ni leur durée.

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 internautes ont cliqué sur un lien vers le menu d'un établissement 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 (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

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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

average_cpm

double

Coût moyen pour mille impressions (CPM). Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

clicks

int64

Nombre de clics.

content_budget_lost_impression_share

double

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

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'une interaction) par interaction éligible à la 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 ne concerne que les actions de conversion pour lesquelles 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

cost_per_all_conversions

double

Coût des interactions avec les annonces 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 une annonce divisé par le nombre de conversions attribuées par le modèle actuel. Cela ne concerne que les actions de conversion pour lesquelles l'attribut "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_value

double

Somme de la valeur des conversions multi-appareils.

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 ne concerne que les actions de conversion pour lesquelles 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 des conversions incluses dans le champ "Conversions". Cette métrique n'est utile que si vous avez associé une valeur à vos actions de conversion.

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

Il s'agit de la fréquence à laquelle les utilisateurs interagissent avec votre annonce une fois qu'ils l'ont vue. Il s'agit du nombre d'interactions divisé par le nombre de fois où votre annonce est diffusée.

interactions

int64

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

invalid_click_rate

double

Pourcentage de clics filtrés par rapport au 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 étant illicites et ne vous sont donc pas facturés.

mobile_friendly_clicks_percentage

double

Pourcentage de clics sur mobile redirigeant 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

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée en toute première position parmi les annonces les plus performantes dans les résultats de recherche en raison d'un budget trop faible. Remarque: Le taux d'impressions perdues en première position absolue pour le budget sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

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

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée à côté des meilleurs résultats de recherche naturels en raison d'un budget faible. Remarque: Le taux d'impressions perdues en première position (budget) sur le Réseau de Recherche est compris entre 0 et 0,9. Toute valeur supérieure à 0,9 est signalée comme 0,9001.

search_click_share

double

Nombre de clics générés sur le Réseau de Recherche divisé par le nombre estimé de clics susceptibles d'avoir été enregistrés. Remarque: La part de clics sur le Réseau de Recherche est comprise entre 0,1 et 1. Toute valeur inférieure à 0,1 est signalée à 0,0999.

search_exact_match_impression_share

double

Nombre d'impressions enregistrées par vos annonces, divisé par le nombre estimé d'impressions qu'elles étaient susceptibles d'enregistrer sur le Réseau de Recherche pour des termes de recherche correspondant exactement à vos mots clés (ou correspondant à des variantes proches), quels que soient les types 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 n'a pas été en première position parmi les annonces les plus performantes dans les résultats de recherche en raison de son mauvais classement. Remarque: Le taux d'impressions perdues en première position absolue sur le classement 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_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

Estimation de la fréquence à laquelle 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 le classement 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_top_impression_share

double

Il s'agit du nombre d'impressions enregistrées par vos annonces les plus performantes par rapport au nombre estimé d'impressions que vous auriez pu enregistrer avec ces annonces. 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 meilleurs résultats de recherche naturels.

value_per_all_conversions

double

Valeur de toutes les conversions divisée par le nombre total de conversions.

value_per_all_conversions_by_conversion_date

double

Valeur de toutes les conversions divisée par le nombre total de conversions. Lorsque cette colonne est sélectionnée avec la date, les valeurs de la colonne "date" correspondent à la date de conversion. Vous trouverez des informations détaillées sur les colonnes "by_conversion_date" à l'adresse 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, les valeurs de la colonne "date" correspondent à la date de 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_cross_sell_units_sold

double

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

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 coût de vente lié aux prospects 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez 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 dans le 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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 sont de 10 $. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page 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. Il s'agit d'une valeur monétaire renvoyée par défaut dans la devise du client. Pour en savoir plus sur le paramètre "metrics_currency", consultez la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause

client_account_lead_units_sold

double

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

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 identifiant de façon 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 d'applications qui distribue cette application spécifique.

PercentCpc

Il s'agit d'une stratégie d'enchères selon laquelle les enchères ne représentent qu'une fraction du prix annoncé d'un bien ou d'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 micros locales. Remarque: Une valeur nulle est interprétée de la même manière que si le champ "bid_padding" n'est pas défini.

enhanced_cpc_enabled

bool

Augmente ou réduit l'enchère lors de chaque mise aux enchères, en fonction de la probabilité de conversion. Les enchères individuelles peuvent être supérieures à cpc_bid_arcade_micros, mais pas le montant moyen des enchères d'une campagne.

RealTimeBiddingSetting

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

Champs
opt_in

bool

Indique si la campagne utilise les enchères en temps réel.

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é au chemin 1 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
path1

string

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

path2

string

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

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 de l'annonce à afficher

display_mobile_url

string

URL mobile affichée de l'annonce.

ad_tracking_id

int64

ID de suivi de l'annonce.

Segments

Champs "Segmenter 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 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 brutes pour les conversions d'événements.

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.

month

string

Mois, représenté par la date du premier jour du mois. 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 de l'article 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 du trimestre. Utilise l'année civile pour les trimestres. Par exemple, le deuxième trimestre 2018 commence le 01/04/2018. Format aaaa-MM-jj.

week

string

Semaine, correspondant à la période du lundi au dimanche, et représentée par le lundi. Format aaaa-MM-jj.

year

int32

Année, au format aaaa.

asset_interaction_target

AssetInteractionTarget

Utilisé uniquement avec les métriques CustomerAsset, CampaignAsset et GroupAsset. Indique si les métriques d'interaction concernent le composant lui-même, ou un autre composant ou bloc d'annonces. Les interactions (par exemple, les clics) sont comptabilisées à travers toutes les parties de l'annonce diffusée (par exemple, 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 a la valeur "true", cela signifie que les interactions ont lieu sur cet élément spécifique. Si interaction_on_this_asset a la valeur "false", cela signifie que les interactions ont lieu non sur cet élément spécifique, mais sur d'autres parties de l'annonce diffusée avec cet élément.

TargetCpa

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

Champs
target_cpa_micros

int64

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

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 cible (coût pour mille impressions) est une stratégie d'enchères automatiques qui définit des enchères afin d'optimiser les performances en fonction du CPM cible que vous avez défini.

TargetImpressionShare

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

Champs
location

TargetImpressionShareLocation

Zone ciblée sur la page des 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 les enchères en fonction de la fraction cible des enchères pour laquelle l'annonceur doit 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 vous souhaitez limiter la diffusion de vos annonces pour qu'elles ne soient diffusées qu'en fonction des critères que vous avez sélectionnés pour cette propriété "target_dimension", ou si vous souhaitez cibler toutes les valeurs de cette dimension et diffuser des annonces en fonction de votre ciblage dans d'autres dimensions "TargetDimensions". La valeur true signifie que ces critères n'appliqueront que les modificateurs d'enchères, et n'auront pas d'incidence sur le ciblage. La valeur false signifie que ces critères limitent le ciblage et appliquent des modificateurs d'enchères.

TargetRoas

Cette stratégie d'enchères automatiques 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

Il s'agit d'une stratégie d'enchères automatiques qui définit vos enchères pour vous aider à enregistrer autant de clics que possible dans les limites de votre budget.

Champs
target_spend_micros
(deprecated)

int64

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

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 de l'asset texte.

TextLabel

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

Champs
background_color

string

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

description

string

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

UnifiedCallAsset

Un composant Appel unifié.

Champs
country_code

string

Code pays à deux lettres correspondant au 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 ce composant Appel 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 le composant peut être diffusé. Vous pouvez programmer jusqu'à 6 programmations 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 aux annonces Microsoft.

call_tracking_enabled

bool

Activer ou non l'appel dans le cadre du suivi des appels. S'applique aux annonces Microsoft.

use_searcher_time_zone

bool

Indique si l'extension d'appel doit s'afficher dans le fuseau horaire de l'utilisateur du Réseau de Recherche. S'applique aux annonces Microsoft.

start_date

string

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

end_date

string

Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.

UnifiedCalloutAsset

Un 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 à laquelle cet élément est effectif et peut commencer à être diffusé, au format aaaa-MM-jj.

end_date

string

Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.

ad_schedule_targets[]

AdScheduleInfo

Liste des calendriers sans chevauchement spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Vous pouvez programmer jusqu'à 6 programmations par jour, soit 42 au total.

use_searcher_time_zone

bool

Indique si l'élément doit s'afficher dans le fuseau horaire de l'utilisateur de la recherche. S'applique aux annonces Microsoft.

UnifiedLocationAsset

Un 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 de composant donnés. Pour en savoir plus sur les ID de lieu, consultez la page https://developers.google.com/places/web-service/place-id.

business_profile_locations[]

BusinessProfileLocation

Liste des établissements pour le client. Il ne s'affiche que si le composant Lieu est synchronisé à partir du compte de fiches d'établissement. Un même compte peut contenir plusieurs fiches d'établissement qui pointent vers le même ID de lieu.

location_ownership_type

LocationOwnershipType

Type de propriété de l'établissement. Si le type est BUSINESS_OWNER, l'annonce est diffusée en tant qu'extension de lieu. Si le type est AFFILIÉ, il sera diffusé en tant que lieu affilié.

UnifiedPageFeedAsset

Un é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

Un 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 à laquelle cet élément est effectif et peut commencer à être diffusé, au format aaaa-MM-jj.

end_date

string

Date limite à laquelle ce composant est effectif et est toujours diffusé, au format aaaa-MM-jj.

ad_schedule_targets[]

AdScheduleInfo

Liste des calendriers sans chevauchement spécifiant tous les intervalles de temps pendant lesquels le composant peut être diffusé. Vous pouvez programmer jusqu'à 6 programmations par jour, soit 42 au total.

tracking_id

int64

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

use_searcher_time_zone

bool

Indique si le composant Lien annexe doit être affiché dans le fuseau horaire de l'utilisateur du Réseau de Recherche. S'applique aux annonces Microsoft.

mobile_preferred

bool

Indique si la préférence d'affichage du composant Lien annexe sur les appareils mobiles est définie. S'applique aux annonces Microsoft.

UserListInfo

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

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

Flottant.

double_value

double

Valeur double.

string_value

string

Chaîne.

WebpageConditionInfo

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

Champs
operand

WebpageConditionOperand

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

operator

WebpageConditionOperator

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

argument

string

Argument de la condition de ciblage de la page 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 du nom sera utilisée pour identifier, trier et filtrer les critères associés à 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 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.