Package google.ads.searchads360.v0.common

Index

AdScheduleInfo

Représente un critère AdSchedule.

Le paramètre "AdSchedule" 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 le 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. Le calendrier 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 24 signifie 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

Un critère de tranche d'âge.

Champs
type

AgeRangeType

Type de tranche d'âge.

AssetInteractionTarget

Un segment AssetInteractionTarget.

Champs
asset

string

Nom de 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 ont eu lieu sur le composant lui-même, ou sur un autre composant ou bloc d'annonces.

AssetUsage

Contient les informations sur l'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 ressource de l'audience.

BusinessProfileLocation

Données de localisation de la fiche d'établissement synchronisées à partir du 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 information est synchronisée à partir du compte de 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 fiche d'établissement.

listing_id

int64

ID de la fiche de cet établissement. Ces informations sont synchronisées à 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 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 du tag de paramètre.

value

string

Valeur à remplacer.

DeviceInfo

Un 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 diminue pour les clics qui semblent moins probables.

Cette stratégie d'enchères est obsolète et ne peut plus être créée. Pour obtenir des fonctionnalités équivalentes, utilisez ManualCpc avec Enhanced_cpc_enabled et défini 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

Un 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 de l'élément image en octets.

ImageDimension

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

Un 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

Un critère de langue.

Champs
language_constant

string

Nom de ressource de la constante de langue.

ListingGroupInfo

Critère du 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 cible géographique 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 cible géographique. Les miles et les 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 identifiants 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 exprimée 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 par 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 amélioré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 permet d'enregistrer la plus grande valeur de conversion 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. Cette valeur ne peut être modifiée 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. Cette valeur ne peut être modifiée que pour les stratégies de portefeuille d'enchères.

target_roas

double

L'option de retour sur les dépenses publicitaires (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 aucun ROAS cible n'est défini, la stratégie d'enchères s'efforce d'atteindre le ROAS le plus élevé possible en fonction du budget.

MaximizeConversions

Cette stratégie d'enchères automatiques vous permet de générer le plus grand nombre de conversions pour vos campagnes tout en exploitant la totalité de votre budget.

Champs
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. Cette valeur ne peut être modifiée 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. Cette valeur ne peut être modifiée que 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 pour chaque action de conversion spécifiée en micro-unités de la devise de la stratégie d'enchères. Si cette valeur 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 à celui-ci. Si aucun CPA cible n'est défini, la stratégie d'enchères tente 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, ses valeurs correspondent à la date de la 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, ses valeurs correspondent à la date de la 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 des valeurs de 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.

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 de l'attribution. Lorsque cette colonne est sélectionnée avec la date, ses valeurs correspondent à la date de la conversion.

historical_creative_quality_score

QualityScoreBucket

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

historical_landing_page_quality_score

QualityScoreBucket

Qualité de l'historique de l'expérience sur la page de destination

historical_search_predicted_ctr

QualityScoreBucket

Taux de clics (CTR) prévu pour la recherche dans l'historique

interaction_event_types[]

InteractionEventType

Types d'interactions sans frais et payantes.

raw_event_conversion_metrics[]

Value

Métriques brutes des 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 des interactions (par opposition aux 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

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 appeler un magasin pendant ou après avoir cliqué sur une annonce. Ce nombre n'inclut pas les appels passés 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 utilisateurs ont cliqué sur un "Itinéraire" pour accéder à 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 supplémentaires (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 utilisateurs 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. 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.

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. Consultez le paramètre "metrics_currency" à l'adresse 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 pourcentage) 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 (provenant d'une interaction) 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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" à l'adresse 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 par conversion enchérissable moyen éligible aux conversions.

cost_per_current_model_attributed_conversion

double

Coût des interactions avec les annonces divisé par le nombre de 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_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 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 statistique 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

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 à l'action principale de l'utilisateur associée à un format d'annonce : les clics pour les annonces textuelles et Shopping, les vues 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 illégitimes et pour lesquels aucuns frais ne vous sont facturés.

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 des 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 ne figurait pas en toute première place parmi les 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 en lien avec 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 premiers résultats de recherche naturels en raison d'un budget trop faible. Remarque: Le taux d'impressions perdues en première position associée au 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 enregistré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 susceptibles d'être enregistrées sur le Réseau de Recherche pour des termes de recherche correspondant exactement à vos mots clés (ou étant des variantes proches), quels que soient les types de correspondance des 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

Estimation de la fréquence à laquelle votre annonce n'a pas été diffusée à côté des premiers 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 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, ses valeurs correspondent à la date de la 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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" à l'adresse 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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" à l'adresse 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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" à l'adresse 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 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_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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" à l'adresse 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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" à l'adresse 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 du compte client (prix de revient) 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" à l'adresse 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" à l'adresse 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. Consultez le paramètre "metrics_currency" à l'adresse 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 affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" à l'adresse 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. 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" à l'adresse 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. Consultez le paramètre "metrics_currency" à l'adresse https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause.

client_account_lead_units_sold

double

Le nombre d'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 qui identifie de manière unique une application mobile. Il doit simplement contenir l'ID natif de la plate-forme, par exemple "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 dans 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 locaux. Remarque: Une valeur nulle est interprétée de la même manière que la valeur "enchère_plafond" n'est pas définie.

enhanced_cpc_enabled

bool

À la hausse ou à la baisse de chaque mise aux enchères, le montant de l'enchère est ajusté à la hausse ou à la baisse, en fonction de la probabilité de conversion. Les enchères individuelles peuvent dépasser cpc_bid_summit_micros, mais pas le montant moyen de l'enchère pour une campagne.

RealTimeBiddingSetting

Paramètres des enchères en temps réel (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é 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 affichée de l'annonce

display_mobile_url

string

URL mobile de l'annonce qui s'affiche.

ad_tracking_id

int64

Identifiant de suivi de l'annonce.

Segments

Segmenter uniquement.

Champs
ad_network_type

AdNetworkType

Type de réseau publicitaire.

conversion_action_category

ConversionActionCategory

Catégorie de l'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 du 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 de conversion d'événement.

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 ressource de la constante de cible géographique qui représente une ville.

geo_target_country

string

Nom de ressource de la constante de cible géographique qui représente un pays.

geo_target_metro

string

Nom de ressource de la constante de cible géographique qui représente une agglomération.

geo_target_region

string

Nom de ressource de la constante de cible géographique qui représente 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 comme 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 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 le 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 "GroupAsset". 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 (les clics, par exemple) sont comptabilisées dans l'ensemble des parties d'une annonce diffusée (par exemple, l'annonce elle-même et d'autres composants tels que les liens annexes) lorsqu'elles sont diffusées simultanément. Lorsque "interaction_on_this_asset" est défini sur "true", cela signifie que les interactions ont lieu sur cet élément spécifique. Lorsque "interaction_on_this_asset" est défini sur "false", cela signifie que les interactions ne concernent pas cet élément spécifique, mais d'autres parties de l'annonce diffusée avec laquelle cet élément est diffusé.

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 pour optimiser vos 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 dans toute autre zone ciblée).

Champs
location

TargetImpressionShareLocation

Zone ciblée 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% correspond à 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

Il s'agit de la dimension de ciblage à laquelle ces paramètres s'appliquent.

bid_only

bool

Indique si vous souhaitez que vos annonces ne soient diffusées qu'en fonction des critères que vous avez sélectionnés pour cette dimension_ciblage, ou si vous souhaitez cibler toutes les valeurs de cette dimension et diffuser des annonces en fonction de votre ciblage dans d'autres valeurs de ciblage. La valeur true signifie que ces critères n'appliqueront que les 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

Il s'agit d'une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen 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 de la stratégie d'enchères automatiques qui définit vos enchères de sorte 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 texte de l'asset texte.

TextLabel

Type de libellé affichant du texte sur un fond 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 pour 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 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 de calendriers de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Il peut y avoir jusqu'à six 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 à Microsoft Ads.

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

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

start_date

string

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

end_date

string

Date à laquelle cet élément entre en vigueur et diffuse actuellement 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 à laquelle cet élément entre en vigueur et peut commencer à être diffusé, au format aaaa-MM-jj.

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

Liste de calendriers de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Il peut y avoir jusqu'à six programmations 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 Ads.

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 l'ID de lieu, consultez la page https://developers.google.com/places/web-service/place-id.

business_profile_locations[]

BusinessProfileLocation

Liste des établissements du client. Cette information ne s'affiche que si le composant Lieu est synchronisé à partir du compte de la fiche d'établissement. Plusieurs fiches d'établissement d'un même compte peuvent renvoyer vers le même ID de lieu.

location_ownership_type

LocationOwnershipType

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

UnifiedPageFeedAsset

Élément de flux de pages unifié.

Champs
page_url

string

La 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 à laquelle cet élément entre en vigueur et peut commencer à être diffusé, au format aaaa-MM-jj.

end_date

string

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

ad_schedule_targets[]

AdScheduleInfo

Liste de calendriers de diffusion qui ne se chevauchent pas et précise tous les intervalles de temps pendant lesquels l'asset peut être diffusé. Il peut y avoir jusqu'à six programmations 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

Permet d'afficher ou non le composant Lien annexe dans le fuseau horaire de l'utilisateur associé à la recherche. S'applique à Microsoft Ads.

mobile_preferred

bool

Indique si le composant Lien annexe s'affiche sur les appareils mobiles ou non. S'applique à Microsoft Ads.

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

Int64.

float_value

float

Un float.

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

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