Package google.ads.searchads360.v0.resources

Index

AccessibleBiddingStrategy

Représente une vue des stratégies d'enchères détenue par le client et partagée avec celui-ci.

Contrairement à BiddingStrategy, cette ressource inclut les stratégies détenues par les responsables du client et partagées avec ce client, en plus des stratégies détenues par ce client. Cette ressource ne fournit pas de métriques et n'affiche qu'un sous-ensemble limité des attributs BiddingStrategy.

Champs
resource_name

string

Nom de ressource de la stratégie d'enchères accessible. Les noms des ressources AccessibleBiddingStrategy se présentent sous la forme suivante:

customers/{customer_id}/accessibleBiddingStrategies/{bidding_strategy_id}

id

int64

ID de la stratégie d'enchères.

name

string

Nom de la stratégie d'enchères.

type

BiddingStrategyType

Type de stratégie d'enchères.

owner_customer_id

int64

Identifiant du client auquel appartient la stratégie d'enchères.

owner_descriptive_name

string

descriptif_name du client auquel appartient la stratégie d'enchères.

Champ d'union scheme. Système d'enchères.

Vous ne pouvez en définir qu'une seule. scheme ne peut être qu'un des éléments suivants :

maximize_conversion_value

MaximizeConversionValue

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.

maximize_conversions

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.

target_cpa

TargetCpa

Il s'agit d'une stratégie d'enchères qui définit vos enchères pour générer un maximum de conversions en fonction du coût par acquisition (CPA) cible que vous spécifiez.

target_impression_share

TargetImpressionShare

Stratégie d'enchères qui optimise automatiquement les campagnes en fonction d'un pourcentage d'impressions donné.

target_roas

TargetRoas

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

target_spend

TargetSpend

Il s'agit d'une stratégie d'enchères qui définit vos enchères de sorte que vous enregistriez autant de clics que possible dans les limites de votre budget.

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
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
target_cpa

int64

L'option de coût par acquisition (CPA) cible. Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.

target_cpa_micros

int64

L'option de coût par acquisition (CPA) cible. Il s'agit du montant moyen que vous souhaitez dépenser par acquisition.

TargetCpa

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

Champs
target_cpa_micros

int64

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

TargetImpressionShare

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.

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

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

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.

Une annonce.

Champs
resource_name

string

Nom de ressource de l'annonce. Le nom des ressources d'annonces se présente sous la forme suivante:

customers/{customer_id}/ads/{ad_id}

final_urls[]

string

Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce.

type

AdType

Type d'annonce.

id

int64

Identifiant de l'annonce.

display_url

string

URL qui s'affiche dans la description de certains formats d'annonces.

name

string

Nom de l'annonce. Cette valeur sert uniquement à identifier l'annonce. Ils ne doivent pas nécessairement être uniques et n'ont aucune incidence sur l'annonce diffusée. Le champ de nom n'est actuellement compatible qu'avec DisplayUploadAd, ImageAd, ShoppingComparaisonListingAd et VideoAd.

Champ d'union ad_data. Informations pertinentes pour le type d'annonce. Vous ne devez définir qu'une seule valeur. ad_data ne peut être qu'un des éléments suivants :
text_ad

SearchAds360TextAdInfo

Informations concernant une annonce textuelle.

expanded_text_ad

SearchAds360ExpandedTextAdInfo

Informations concernant une annonce textuelle agrandie.

responsive_search_ad

SearchAds360ResponsiveSearchAdInfo

Informations concernant une annonce responsive sur le Réseau de Recherche.

product_ad

SearchAds360ProductAdInfo

Informations concernant une annonce pour un produit.

expanded_dynamic_search_ad

SearchAds360ExpandedDynamicSearchAdInfo

Informations concernant une annonce dynamique agrandie sur le Réseau de Recherche.

AdGroup

Un groupe d'annonces.

Champs
resource_name

string

Nom de ressource du groupe d'annonces. Les noms de ressources d'un groupe d'annonces se présentent comme suit:

customers/{customer_id}/adGroups/{ad_group_id}

status

AdGroupStatus

État du groupe d'annonces.

type

AdGroupType

Type de groupe d'annonces.

ad_rotation_mode

AdGroupAdRotationMode

Mode de rotation des annonces du groupe d'annonces.

creation_time

string

Date et heure de création de ce groupe d'annonces. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

targeting_setting

TargetingSetting

Paramètre de ciblage des fonctionnalités associées.

labels[]

string

Noms de ressource des étiquettes associées à ce groupe d'annonces.

engine_id

string

ID du groupe d'annonces dans le compte de moteur externe. Ce champ concerne uniquement les comptes autres que Google Ads (par exemple, Yahoo Japan, Microsoft, Baidu, etc.). Pour l'entité Google Ads, utilisez plutôt "ad_group.id".

start_date

string

Date à laquelle ce groupe d'annonces commence à diffuser des annonces. Par défaut, le groupe d'annonces commence maintenant ou à la date de début de celui-ci, selon la date la plus tardive. Si ce champ est défini, le groupe d'annonces commence au début de la date spécifiée dans le fuseau horaire du client. Ce champ n'est disponible que pour les comptes de passerelle Microsoft Advertising et Facebook.

Format : AAAA-MM-JJ, exemple : 2019-03-14

end_date

string

Date à laquelle le groupe d'annonces cesse de diffuser des annonces. Par défaut, le groupe d'annonces se termine à la date de fin du groupe d'annonces. Si ce champ est défini, le groupe d'annonces se termine à la date spécifiée dans le fuseau horaire du client. Ce champ n'est disponible que pour les comptes de passerelle Microsoft Advertising et Facebook.

Format : AAAA-MM-JJ, exemple : 2019-03-14

language_code

string

Langue des annonces et des mots clés d'un groupe d'annonces. Ce champ n'est disponible que pour les comptes Microsoft Advertising. Pour en savoir plus: https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage

last_modified_time

string

Date et heure de la dernière modification de ce groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

id

int64

Identifiant du groupe d'annonces.

name

string

Nom du groupe d'annonces.

Ce champ est obligatoire. Il ne doit pas être vide lors de la création de groupes d'annonces.

Il doit contenir moins de 255 caractères UTF-8 en pleine largeur.

Il ne doit contenir aucun caractère nul (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD).

cpc_bid_micros

int64

Enchère au CPC (coût par clic) maximal.

engine_status

AdGroupEngineStatus

État du moteur pour le groupe d'annonces.

AdGroupAd

Annonce d'un groupe d'annonces.

Champs
resource_name

string

Nom de ressource de l'annonce. Les noms de ressources d'annonces d'un groupe d'annonces se présentent comme suit:

customers/{customer_id}/adGroupAds/{ad_group_id}~{ad_id}

status

AdGroupAdStatus

État de l'annonce.

ad

Ad

L'annonce.

creation_time

string

Code temporel de la création de cette annonce de groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

labels[]

string

Noms de ressource des étiquettes associées à cette annonce de groupe d'annonces.

engine_id

string

ID de l'annonce dans le compte de moteur externe. Ce champ concerne uniquement le compte SearchAds 360, par exemple Yahoo, Japan, Microsoft, Baidu, etc. Pour l'entité autre que SearchAds 360, utilisez plutôt "ad_group_ad.ad.id".

engine_status

AdGroupAdEngineStatus

État supplémentaire de l'annonce dans le compte de moteur externe. Les états possibles (selon le type de compte externe) sont les suivants : actif, éligible, en attente d'examen, etc.

last_modified_time

string

Date et heure de la dernière modification de l'annonce de ce groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

AdGroupAdLabel

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

Champs
resource_name

string

Nom de ressource du libellé d'annonce du groupe d'annonces. Les noms des ressources de libellé d'annonce du groupe d'annonces se présentent comme suit: customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}

ad_group_ad

string

Annonce du groupe d'annonces à laquelle le libellé est associé.

label

string

Libellé attribué à l'annonce du groupe d'annonces.

AdGroupAsset

Association entre un groupe d'annonces et un composant.

Champs
resource_name

string

Nom de ressource du composant du groupe d'annonces. Les noms de ressources GroupAsset se présentent comme suit:

customers/{customer_id}/adGroupAssets/{ad_group_id}~{asset_id}~{field_type}

ad_group

string

Obligatoire. Groupe d'annonces auquel l'élément est associé.

asset

string

Obligatoire. L'élément associé au groupe d'annonces.

status

AssetLinkStatus

État du composant du groupe d'annonces.

AdGroupAssetSet

Un groupe d'annonces et un ensemble de composants sont associés. La création d'un objet GroupAssetSet permet d'associer un ensemble de composants à un groupe d'annonces.

Champs
resource_name

string

Nom de ressource de l'ensemble de composants du groupe d'annonces. Les noms de ressources de l'ensemble de composants d'un groupe d'annonces se présentent comme suit:

customers/{customer_id}/adGroupAssetSets/{ad_group_id}~{asset_set_id}

ad_group

string

Groupe d'annonces auquel cet ensemble de composants est associé.

asset_set

string

Ensemble de composants associé au groupe d'annonces.

status

AssetSetLinkStatus

État de l'ensemble de composants du groupe d'annonces. Lecture seule.

AdGroupAudienceView

Vue d'audience d'un groupe d'annonces. Elles incluent les données de performances issues des centres d'intérêt et des listes de remarketing pour les annonces sur les Réseaux Display et YouTube, et les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), cumulées au niveau de l'audience.

Champs
resource_name

string

Nom de ressource de la vue d'audience du groupe d'annonces. Le nom des ressources de vue d'audience d'un groupe d'annonces se présente sous la forme suivante:

customers/{customer_id}/adGroupAudienceViews/{ad_group_id}~{criterion_id}

AdGroupBidModifier

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

Champs
resource_name

string

Nom de ressource du modificateur d'enchères de groupe d'annonces. Les noms de ressources du modificateur d'enchères de groupe d'annonces se présentent comme suit:

customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}

bid_modifier

double

Modificateur de l'enchère lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. La plage est de 1,0 à 6,0 pour PreferredContent. Indiquez 0 pour désactiver un type d'appareil.

Champ d'union criterion. Critère de ce modificateur d'enchère de groupe d'annonces.

Obligatoire pour les opérations de création à partir de la version 5. criterion ne peut être qu'un des éléments suivants :

device

DeviceInfo

Critère d'appareil.

AdGroupCriterion

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

Champs
resource_name

string

Nom de ressource du critère du groupe d'annonces. Les noms de ressources des critères du groupe d'annonces ont le format suivant:

customers/{customer_id}/adGroupCriteria/{ad_group_id}~{criterion_id}

creation_time

string

Horodatage au moment de la création de ce critère de groupe d'annonces. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

status

AdGroupCriterionStatus

État du critère.

Il s'agit de l'état de l'entité de critère du groupe d'annonces définie par le client. Remarque : Les rapports de l'interface utilisateur peuvent intégrer des informations supplémentaires qui déterminent si un critère peut être exécuté. Dans certains cas, un critère supprimé dans l'API peut encore apparaître comme activé dans l'interface utilisateur. Par exemple, les campagnes par défaut sont diffusées auprès des utilisateurs de toutes les tranches d'âge, sauf si elles sont exclues. Du fait qu'elle peut voir les annonces, l'interface utilisateur affiche chaque tranche d'âge comme étant activée, mais l'état AdGroupCriterion.status indique "supprimée", car aucun critère positif n'a été ajouté.

quality_info

QualityInfo

Informations concernant la qualité du critère.

type

CriterionType

Type du critère.

labels[]

string

Noms de ressource des étiquettes associées à ce critère de groupe d'annonces.

position_estimates

PositionEstimates

Estimations des enchères associées au critère à différentes positions.

final_urls[]

string

Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce.

engine_id

string

ID du critère de groupe d'annonces dans le compte de moteur externe. Ce champ ne concerne que les comptes autres que Google Ads (par exemple, Yahoo Japan, Microsoft, Baidu, etc.). Pour une entité Google Ads, utilisez plutôt "ad_group_criterion.criterion_id".

last_modified_time

string

Date et heure de la dernière modification de ce critère de groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

criterion_id

int64

ID du critère.

ad_group

string

Groupe d'annonces auquel appartient le critère.

negative

bool

Permet de spécifier si le critère doit être ciblé (false) ou exclu (true).

Ce champ est immuable. Pour transformer un critère positif en critère négatif, supprimez-le, puis ajoutez-le à nouveau.

bid_modifier

double

Modificateur de l'enchère lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. La plupart des types de critères pouvant être ciblés sont compatibles avec les modificateurs.

cpc_bid_micros

int64

Enchère au CPC (coût par clic).

effective_cpc_bid_micros

int64

L'enchère au CPC (coût par clic) effective.

engine_status

AdGroupCriterionEngineStatus

État du moteur pour le critère de groupe d'annonces.

final_url_suffix

string

Modèle d'URL permettant d'ajouter des paramètres à l'URL finale.

tracking_url_template

string

Modèle d'URL permettant de créer une URL de suivi.

Champ d'union criterion. Critère du groupe d'annonces.

Vous ne devez en définir qu'un. criterion ne peut être qu'un des éléments suivants :

keyword

KeywordInfo

Mot clé.

listing_group

ListingGroupInfo

Groupe de fiches.

age_range

AgeRangeInfo

Tranche d'âge.

gender

GenderInfo

Gender.

user_list

UserListInfo

Liste d'utilisateurs.

webpage

WebpageInfo

Page Web

location

LocationInfo

Localisation.

PositionEstimates

Estimations des enchères associées au critère à différentes positions.

Champs
top_of_page_cpc_micros

int64

Estimation de l'enchère au CPC nécessaire pour que l'annonce soit diffusée en haut de la première page des résultats de recherche.

QualityInfo

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

Champs
quality_score

int32

Le niveau de qualité.

Ce champ peut ne pas être renseigné si Google ne dispose pas d'informations suffisantes pour déterminer une valeur.

AdGroupCriterionLabel

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

Champs
resource_name

string

Nom de ressource du libellé du critère de groupe d'annonces. Les noms de ressources de libellé du critère de groupe d'annonces ont le format suivant: customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}

ad_group_criterion

string

Critère du groupe d'annonces auquel le libellé est associé.

label

string

Libellé attribué au critère du groupe d'annonces.

AdGroupLabel

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

Champs
resource_name

string

Nom de ressource du libellé du groupe d'annonces. Les noms des ressources de libellé du groupe d'annonces ont le format suivant: customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}

ad_group

string

Groupe d'annonces auquel le libellé est associé.

label

string

Libellé attribué au groupe d'annonces.

AgeRangeView

Vue par tranche d'âge.

Champs
resource_name

string

Nom de ressource de la vue de tranche d'âge. Le nom des ressources de la vue par tranche d'âge se présente sous la forme suivante:

customers/{customer_id}/ageRangeViews/{ad_group_id}~{criterion_id}

Élément

Le composant est une partie d'une annonce qui peut être partagée entre plusieurs annonces. Il peut s'agir d'une image (ImageAsset), d'une vidéo (YouTubeVideoAsset), etc. Les assets sont immuables et ne peuvent pas être supprimés. Pour arrêter la diffusion d'un composant, supprimez-le de l'entité qui l'utilise.

Champs
resource_name

string

Nom de ressource de l'élément. Les noms de ressources de l'asset se présentent sous la forme suivante:

customers/{customer_id}/assets/{asset_id}

type

AssetType

Type de l'élément.

final_urls[]

string

Liste des URL finales possibles après toutes les redirections interdomaines.

status

AssetStatus

État de l'élément.

creation_time

string

Horodatage lors de la création de cette annonce. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

last_modified_time

string

Date et heure de la dernière modification de cet élément. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

id

int64

ID de l'élément.

name

string

Nom facultatif de l'élément.

tracking_url_template

string

Modèle d'URL permettant de créer une URL de suivi.

engine_status

AssetEngineStatus

État d'un élément dans le moteur.

Champ d'union asset_data. Type spécifique de l'élément. asset_data ne peut être qu'un des éléments suivants :
youtube_video_asset

YoutubeVideoAsset

Asset vidéo YouTube.

image_asset

ImageAsset

Un composant Image.

text_asset

TextAsset

Un composant texte.

callout_asset

UnifiedCalloutAsset

Un composant Accroche unifié.

page_feed_asset

UnifiedPageFeedAsset

Un élément de flux de pages unifié.

mobile_app_asset

MobileAppAsset

Un composant Application mobile.

call_asset

UnifiedCallAsset

Un composant Appel unifié.

call_to_action_asset

CallToActionAsset

Un composant Incitation à l'action.

location_asset

UnifiedLocationAsset

Un composant Lieu unifié.

AssetGroup

Un groupe d'assets L'élément AssetGroupAsset permet d'associer un élément au groupe d'assets. AssetGroupSignal permet d'associer un signal à un groupe d'assets.

Champs
resource_name

string

Nom de ressource du groupe d'assets. Le nom des ressources d'un groupe d'assets se présente sous la forme suivante:

customers/{customer_id}/assetGroups/{asset_group_id}

id

int64

ID du groupe d'assets.

campaign

string

Campagne à laquelle ce groupe de composants est associé. Asset associé au groupe d'assets.

name

string

Obligatoire. Nom du groupe d'assets. Obligatoire. Il doit comporter entre 1 et 128 caractères. Il doit être unique au sein d'une campagne.

final_urls[]

string

Liste des URL finales après toutes les redirections vers un autre domaine. Dans Performance Max, l'extension peut être appliquée par défaut aux URL, sauf si cette option a été désactivée.

final_mobile_urls[]

string

Une liste des URL finales pour mobile après toutes les redirections vers un autre domaine. Dans Performance Max, l'extension peut être appliquée par défaut aux URL, sauf si cette option a été désactivée.

status

AssetGroupStatus

État du groupe d'assets.

path1

string

Première partie de texte susceptible d'être ajoutée à la fin de l'URL affichée dans l'annonce.

path2

string

Deuxième partie de texte susceptible d'être ajoutée à la fin de l'URL affichée dans l'annonce. Ce champ ne peut être défini que lorsque path1 est défini.

ad_strength

AdStrength

Efficacité globale de l'annonce pour ce groupe de composants.

AssetGroupAsset

L'élément AssetGroupAsset représente le lien entre un élément et un groupe d'assets. Lorsque vous ajoutez un élément AssetGroupAsset, un élément est associé à un groupe d'éléments.

Champs
resource_name

string

Nom de ressource de l'élément du groupe d'assets. Le nom de la ressource d'élément du groupe d'assets se présente sous la forme suivante:

customers/{customer_id}/assetGroupAssets/{asset_group_id}~{asset_id}~{field_type}

asset_group

string

Groupe d'assets auquel cet asset est associé.

asset

string

Composant associé à ce composant du groupe de composants.

field_type

AssetFieldType

Description de l'emplacement de l'asset dans le groupe d'assets. Exemples: TITRE, VIDÉO_YOUTUBE, etc.

status

AssetLinkStatus

État de l'association entre un composant et un groupe d'assets.

AssetGroupAssetCombinationData

Données sur la combinaison de composants du groupe d'assets

Champs
asset_combination_served_assets[]

AssetUsage

Composants diffusés.

AssetGroupListingGroupFilter

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

Champs
resource_name

string

Nom de ressource du filtre de groupe de fiches (groupe de composants). Le nom de la ressource de filtre de groupe de fiches (groupe d'assets) se présente sous la forme suivante:

customers/{customer_id}/assetGroupListingGroupFilters/{asset_group_id}~{listing_group_filter_id}

asset_group

string

Groupe de composants auquel appartient ce filtre de groupe de fiches de groupes de composants.

id

int64

ID du ListingGroupFilter.

type

ListingGroupFilterType

Type de nœud de filtre de groupe de fiches.

vertical

ListingGroupFilterVertical

Secteur représenté par l'arborescence de nœuds actuelle. Tous les nœuds de la même arborescence doivent appartenir au même secteur.

case_value

ListingGroupFilterDimension

Valeur de la dimension avec laquelle ce groupe de fiches affine son parent. Non défini pour le groupe racine.

parent_listing_group_filter

string

Nom de ressource de la subdivision du groupe de fiches parent. Valeur Null pour le nœud de filtre de groupe de fiches racine.

path

ListingGroupFilterDimensionPath

Chemin des dimensions définissant ce filtre de groupe de fiches.

AssetGroupSignal

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

Champs
resource_name

string

Nom de ressource du signal du groupe d'assets. Le nom de la ressource du signal de groupe d'assets se présente sous la forme suivante:

customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id}

asset_group

string

Groupe d'assets auquel ce signal de groupe d'assets appartient.

Champ d'union signal. Signal du groupe d'assets. signal ne peut être qu'un des éléments suivants :
audience

AudienceInfo

Signal d'audience à utiliser par la campagne Performance Max.

AssetGroupTopCombinationView

Aperçu de l'utilisation de la combinaison de composants d'un groupe d'annonces.

Champs
resource_name

string

Nom de ressource de la vue de la combinaison la plus performante du groupe d'assets. Les noms des ressources de la vue AssetGroup Top Combination ont le format suivant : "customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}".

asset_group_top_combinations[]

AssetGroupAssetCombinationData

Meilleures combinaisons d'éléments diffusés ensemble.

AssetSet

Ensemble d'éléments représentant un ensemble d'éléments. Utilisez AssetSetAsset pour associer un élément à l'ensemble de composants.

Champs
id

int64

ID de l'ensemble de composants.

resource_name

string

Nom de ressource de l'ensemble de composants. Les noms de ressources de l'ensemble d'éléments se présentent comme suit:

customers/{customer_id}/assetSets/{asset_set_id}

AssetSetAsset

"AssetSetAsset" correspond au lien entre un asset et un ensemble d'assets. L'ajout d'un élément AssetSetAsset associe un élément à un ensemble d'éléments.

Champs
resource_name

string

Nom de ressource de l'élément de l'ensemble d'assets. Les noms de ressources d'éléments de l'ensemble d'assets se présentent comme suit:

customers/{customer_id}/assetSetAssets/{asset_set_id}~{asset_id}

asset_set

string

Ensemble d'éléments auquel cet élément d'ensemble d'éléments est associé.

asset

string

Élément auquel l'ensemble d'éléments est associé.

status

AssetSetAssetStatus

État du composant de l'ensemble d'assets. Lecture seule.

Audience

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

Champs
resource_name

string

Nom de ressource de l'audience. Les noms d'audience se présentent de la façon suivante:

customers/{customer_id}/audiences/{audience_id}

id

int64

ID de l'audience.

name

string

Obligatoire. Nom de l'audience. Elle doit être unique pour tous les publics. Il doit comporter entre 1 et 255 caractères.

description

string

Description de cette audience.

BiddingStrategy

Une stratégie d'enchères.

Champs
resource_name

string

Nom de ressource de la stratégie d'enchères. Les noms des ressources de stratégie d'enchères se présentent de la façon suivante:

customers/{customer_id}/biddingStrategies/{bidding_strategy_id}

status

BiddingStrategyStatus

État de la stratégie d'enchères.

Ce champ est en lecture seule.

type

BiddingStrategyType

Type de stratégie d'enchères. Créez une stratégie d'enchères en définissant le schéma d'enchères.

Ce champ est en lecture seule.

currency_code

string

Devise utilisée par la stratégie d'enchères (code à trois lettres ISO 4217).

Pour les stratégies d'enchères des clients administrateur, cette devise peut être définie lors de la création et sera définie par défaut sur celle du client administrateur. Pour les clients diffusant des annonces, vous ne pouvez pas définir ce champ. Toutes les stratégies définies pour un client actif utilisent implicitement sa devise. Dans tous les cas, le champ "effective_currency_code" renvoie la devise utilisée par la stratégie.

id

int64

ID de la stratégie d'enchères.

name

string

Nom de la stratégie d'enchères. Toutes les stratégies d'enchères d'un compte doivent être nommées séparément.

La longueur de cette chaîne doit être comprise entre 1 et 255 caractères inclus, en octets UTF-8 (tronquée).

effective_currency_code

string

Devise utilisée par la stratégie d'enchères (code à trois lettres ISO 4217).

Pour les stratégies d'enchères chez les clients administrateur, il s'agit de la devise définie par l'annonceur lors de la création de la stratégie. Pour diffuser des annonces auprès des clients, il s'agit de la valeur currency_code du client.

Les métriques de la stratégie d'enchères sont indiquées dans cette devise.

Ce champ est en lecture seule.

campaign_count

int64

Nombre de campagnes associées à cette stratégie d'enchères.

Ce champ est en lecture seule.

non_removed_campaign_count

int64

Nombre de campagnes non supprimées associées à cette stratégie d'enchères.

Ce champ est en lecture seule.

Champ d'union scheme. Système d'enchères.

Vous ne pouvez en définir qu'une seule. scheme ne peut être qu'un des éléments suivants :

enhanced_cpc

EnhancedCpc

Il s'agit d'une stratégie d'enchères 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.

maximize_conversion_value

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.

maximize_conversions

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.

target_cpa

TargetCpa

Il s'agit d'une stratégie d'enchères qui définit vos enchères pour générer un maximum de conversions en fonction du coût par acquisition (CPA) cible que vous spécifiez.

target_impression_share

TargetImpressionShare

Stratégie d'enchères qui optimise automatiquement les campagnes en fonction d'un pourcentage d'impressions donné.

target_outrank_share

TargetOutrankShare

Il s'agit d'une stratégie 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. Ce champ a été abandonné. La création d'une stratégie d'enchères avec ce champ ou l'association de stratégies d'enchères avec ce champ à une campagne échoueront. Les modifications apportées aux stratégies pour lesquelles ce schéma est déjà renseigné sont autorisées.

target_roas

TargetRoas

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

target_spend

TargetSpend

Il s'agit d'une stratégie d'enchères qui définit vos enchères de sorte que vous enregistriez autant de clics que possible dans les limites de votre budget.

Campagne

Une campagne

Champs
resource_name

string

Nom de ressource de la campagne. Les noms de ressources de la campagne se présentent comme suit:

customers/{customer_id}/campaigns/{campaign_id}

status

CampaignStatus

État de la campagne.

Lorsqu'une nouvelle campagne est ajoutée, la valeur par défaut de l'état est ACTIVÉE.

serving_status

CampaignServingStatus

État de diffusion des annonces de la campagne.

bidding_strategy_system_status

BiddingStrategySystemStatus

État du système de la stratégie d'enchères de la campagne.

ad_serving_optimization_status

AdServingOptimizationStatus

État d'optimisation de la diffusion des annonces de la campagne.

advertising_channel_type

AdvertisingChannelType

Cible de diffusion principale pour les annonces de la campagne. Vous pouvez affiner les options de ciblage dans network_settings.

Ce champ est obligatoire. Il doit être renseigné lors de la création de campagnes.

Ne peut être défini que lors de la création de campagnes. Une fois la campagne créée, le champ ne peut plus être modifié.

advertising_channel_sub_type

AdvertisingChannelSubType

Affinement facultatif à advertising_channel_type. Doit être un sous-type valide du type de canal parent.

Ne peut être défini que lors de la création de campagnes. Une fois la campagne créée, le champ ne peut plus être modifié.

url_custom_parameters[]

CustomParameter

Liste des mappages utilisés pour remplacer les balises de paramètres personnalisés dans tracking_url_template, final_urls ou mobile_final_urls.

real_time_bidding_setting

RealTimeBiddingSetting

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

network_settings

NetworkSettings

Paramètres des réseaux de la campagne.

dynamic_search_ads_setting

DynamicSearchAdsSetting

Paramètre de contrôle des annonces dynamiques du Réseau de Recherche (ADR).

shopping_setting

ShoppingSetting

Paramètre permettant de contrôler les campagnes Shopping.

geo_target_type_setting

GeoTargetTypeSetting

Paramètre du ciblage géographique des annonces.

labels[]

string

Noms de ressource des étiquettes associées à cette campagne.

bidding_strategy_type

BiddingStrategyType

Type de stratégie d'enchères.

Vous pouvez créer une stratégie d'enchères en définissant le schéma d'enchères pour créer une stratégie d'enchères standard ou le champ bidding_strategy pour créer une stratégie de portefeuille d'enchères.

Ce champ est en lecture seule.

accessible_bidding_strategy

string

Nom de ressource de AccessibleBiddingStrategy, une vue en lecture seule des attributs non restreints de la stratégie de portefeuille d'enchères associée identifiée par "bidding_strategy". Ce champ est vide si la campagne n'utilise pas de stratégie de portefeuille. Les attributs de stratégie sans restriction sont disponibles pour tous les clients avec lesquels la stratégie est partagée et peuvent être lus à partir de la ressource AccessibleBiddingStrategy. En revanche, les attributs soumis à des restrictions ne sont disponibles que pour le client propriétaire de la stratégie et ses responsables. Les attributs restreints ne peuvent être lus qu'à partir de la ressource BiddingStrategy.

frequency_caps[]

FrequencyCapEntry

Liste qui limite la fréquence à laquelle chaque utilisateur voit les annonces de cette campagne.

selective_optimization

SelectiveOptimization

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

optimization_goal_setting

OptimizationGoalSetting

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

tracking_setting

TrackingSetting

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

engine_id

string

ID de la campagne dans le compte de moteur externe. Ce champ concerne uniquement les comptes autres que Google Ads. Par exemple, Yahoo Japan, Microsoft, Baidu, etc. Pour l'entité Google Ads, utilisez plutôt "campaign.id".

excluded_parent_asset_field_types[]

AssetFieldType

Types de champs de composants à exclure de cette campagne. Cette campagne n'héritera pas des liens d'éléments associés à ces types de champs à partir du niveau supérieur.

create_time

string

Horodatage lors de la création de cette annonce. L'horodatage est exprimé dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss". La fonction create_time sera abandonnée dans la version 1. Utilisez create_time à la place.

creation_time

string

Horodatage lors de la création de cette annonce. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

last_modified_time

string

Date et heure de la dernière modification de la campagne. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

id

int64

Identifiant de la campagne.

name

string

Nom de la campagne.

Ce champ est obligatoire. Il doit être renseigné lors de la création de campagnes.

Il ne doit contenir aucun caractère nul (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD).

tracking_url_template

string

Modèle d'URL permettant de créer une URL de suivi.

campaign_budget

string

Budget de la campagne.

start_date

string

Date à laquelle la diffusion de la campagne a commencé dans le fuseau horaire du client au format AAAA-MM-JJ.

end_date

string

Dernier jour de la campagne diffusée dans le fuseau horaire du client au format AAAA-MM-JJ. Lors de la création, la valeur par défaut est définie sur 2037-12-30, ce qui signifie que la campagne sera diffusée indéfiniment. Pour paramétrer une campagne existante afin qu'elle soit diffusée indéfiniment, configurez ce champ sur la valeur 2037-12-30.

final_url_suffix

string

Suffixe permettant d'ajouter des paramètres de requête aux pages de destination diffusées avec le suivi en parallèle.

url_expansion_opt_out

bool

Indique la désactivation de l'extension d'URL pour les URL plus ciblées. Si cette option est désactivée (vrai), seules les URL finales du groupe d'assets ou celles spécifiées dans le flux Google Merchant Center ou les flux de données d'entreprise de l'annonceur sont ciblées. Si cette option est activée (false), l'ensemble du domaine sera ciblé. Vous ne pouvez définir ce champ que pour les campagnes Performance Max, dont la valeur par défaut est "false".

Champ d'union campaign_bidding_strategy. Stratégie d'enchères de la campagne.

Il doit s'agir d'un portefeuille (créé via le service BiddingStrategy) ou d'un portefeuille standard intégré à la campagne. campaign_bidding_strategy ne peut être qu'un des éléments suivants :

bidding_strategy

string

Stratégie de portefeuille d'enchères utilisée par la campagne.

manual_cpa

ManualCpa

Stratégie d'enchères standards au CPA manuelles. Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère pour chaque action qu'il spécifie. Disponible uniquement pour les campagnes Local Services.

manual_cpc

ManualCpc

Stratégie d'enchères au CPC manuelles standard. Système d'enchères manuelles basées sur les clics, où l'utilisateur paie par clic.

manual_cpm

ManualCpm

Stratégie d'enchères standards au CPM manuelles. Système d'enchères manuel basé sur les impressions, où l'utilisateur paie pour mille impressions.

maximize_conversions

MaximizeConversions

La stratégie d'enchères standard "Maximiser les conversions" maximise automatiquement le nombre de conversions tout en exploitant la totalité de votre budget.

maximize_conversion_value

MaximizeConversionValue

La stratégie d'enchères standard "Maximiser la valeur de conversion" définit automatiquement les enchères pour maximiser les revenus tout en dépensant la totalité de votre budget.

target_cpa

TargetCpa

Cette stratégie d'enchères standard au CPA cible définit automatiquement vos enchères pour générer un maximum de conversions en fonction du coût par acquisition (CPA) cible que vous spécifiez.

target_impression_share

TargetImpressionShare

Stratégie d'enchères "Taux d'impressions cible". Il s'agit d'une stratégie d'enchères automatiques qui définit des enchères pour atteindre un pourcentage d'impressions donné.

target_roas

TargetRoas

Cette stratégie d'enchères standard au ROAS cible maximise automatiquement les revenus tout en atteignant en moyenne un ROAS cible spécifique.

target_spend

TargetSpend

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

percent_cpc

PercentCpc

Il s'agit de la stratégie d'enchères standard au CPC au pourcentage, où les enchères ne représentent qu'une fraction du prix annoncé pour un produit ou un service.

target_cpm

TargetCpm

Stratégie d'enchères qui optimise automatiquement le coût pour mille impressions.

DynamicSearchAdsSetting

Paramètre de contrôle des annonces dynamiques du Réseau de Recherche (ADR).

Champs
domain_name

string

Obligatoire. Nom de domaine Internet que ce paramètre représente, par exemple "google.com" ou "www.google.com".

language_code

string

Obligatoire. Code de langue spécifiant la langue du domaine, par exemple "en".

use_supplied_urls_only

bool

Indique si la campagne utilise exclusivement des URL fournies par l'annonceur.

GeoTargetTypeSetting

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

Champs
positive_geo_target_type

PositiveGeoTargetType

Paramètre utilisé pour le ciblage géographique positif dans cette campagne spécifique.

negative_geo_target_type

NegativeGeoTargetType

Paramètre utilisé pour le ciblage géographique négatif dans cette campagne spécifique.

NetworkSettings

Paramètres des réseaux de la campagne.

Champs
target_search_network

bool

Indique si les annonces seront diffusées sur des sites partenaires du Réseau de Recherche de Google (la valeur de target_google_search doit être définie sur true).

target_content_network

bool

Indique si les annonces seront diffusées ou non sur des emplacements spécifiés du Réseau Display de Google. Les emplacements sont spécifiés à l'aide du critère d'emplacement.

target_partner_search_network

bool

Indique si des annonces seront diffusées sur le réseau Google Partners. Cette option n'est disponible que pour certains comptes partenaires Google.

OptimizationGoalSetting

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

Champs
optimization_goal_types[]

OptimizationGoalType

Liste des types d'objectifs d'optimisation.

SelectiveOptimization

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

Champs
conversion_actions[]

string

Ensemble d'actions de conversion sélectionné pour optimiser cette campagne.

ShoppingSetting

Paramètre des campagnes Shopping. Définit l'univers des produits pouvant être promus par la campagne, ainsi que la manière dont cette campagne interagit avec les autres campagnes Shopping.

Champs
feed_label

string

Libellé du flux des produits à inclure dans la campagne. Vous ne pouvez définir qu'un seul libellé de flux ou pays de vente. S'il est utilisé à la place de sales_country, le champ feed_label accepte les codes pays dans le même format, par exemple: "XX". Sinon, il peut s'agir de n'importe quelle chaîne utilisée pour le libellé du flux dans Google Merchant Center.

use_vehicle_inventory

bool

Permet de cibler ou non l'inventaire des fiches de véhicules.

merchant_id

int64

ID du compte Merchant Center. Ce champ est obligatoire pour les opérations de création. Ce champ ne peut pas être modifié pour les campagnes Shopping.

sales_country

string

Pays de vente des produits à inclure dans la campagne.

campaign_priority

int32

Priorité de la campagne. Les campagnes associées à une priorité numérique plus élevée prévalent sur celles dont la priorité est plus faible. Ce champ est obligatoire pour les campagnes Shopping dont les valeurs sont comprises entre 0 et 2 inclus. Ce champ est facultatif pour les campagnes Shopping intelligentes, mais il doit être égal à 3 s'il est défini.

enable_local

bool

Permet d'inclure ou non les produits en magasin.

TrackingSetting

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

Champs
tracking_url

string

URL utilisée pour le suivi dynamique.

CampaignAsset

Lien entre une campagne et un élément.

Champs
resource_name

string

Nom de ressource du composant de la campagne. Les noms de ressources CampaignAsset ont le format suivant:

customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type}

status

AssetLinkStatus

État du composant de la campagne.

campaign

string

La campagne à laquelle l'élément est associé.

asset

string

L'élément associé à la campagne.

CampaignAssetSet

CampaignAssetSet correspond à l'association entre une campagne et un ensemble de composants. L'ajout d'un CampaignAssetSet associe un ensemble de composants à une campagne.

Champs
resource_name

string

Nom de ressource de l'ensemble de composants de la campagne. Les noms de ressources d'éléments de l'ensemble d'assets se présentent comme suit:

customers/{customer_id}/campaignAssetSets/{campaign_id}~{asset_set_id}

campaign

string

Campagne à laquelle cet ensemble de composants est associé.

asset_set

string

Ensemble de composants associé à la campagne.

status

AssetSetLinkStatus

État du composant de l'ensemble de composants de la campagne. Lecture seule.

CampaignAudienceView

Une vue d'audience de la campagne. Elles incluent les données de performances issues des centres d'intérêt et des listes de remarketing pour les annonces sur les Réseaux Display et YouTube, et les listes de remarketing pour les annonces du Réseau de Recherche (RLSA), regroupées par critère de campagne et d'audience. Cette vue n'inclut que les audiences associées au niveau de la campagne.

Champs
resource_name

string

Nom de ressource de la vue d'audience de la campagne. Les noms des ressources de vue d'audience de la campagne se présentent comme suit:

customers/{customer_id}/campaignAudienceViews/{campaign_id}~{criterion_id}

CampaignBudget

Un budget de campagne.

Champs
resource_name

string

Nom de la ressource associée au budget de la campagne. Le nom des ressources du budget de la campagne se présente comme suit:

customers/{customer_id}/campaignBudgets/{campaign_budget_id}

delivery_method

BudgetDeliveryMethod

Mode de diffusion qui détermine la fréquence à laquelle le budget de la campagne est dépensé.

La valeur par défaut est STANDARD si elle n'est pas spécifiée lors d'une opération de création.

period

BudgetPeriod

Période au cours de laquelle dépenser le budget. En l'absence de spécification, la valeur par défaut est DAILY.

amount_micros

int64

Montant du budget, dans la devise locale du compte. Le montant est exprimé en micro-unités, où un million équivaut à une unité de devise. Les dépenses mensuelles sont limitées à 30,4 fois ce montant.

CampaignCriterion

Un critère de campagne.

Champs
resource_name

string

Nom de ressource du critère de campagne. Les noms de ressources du critère de campagne se présentent comme suit:

customers/{customer_id}/campaignCriteria/{campaign_id}~{criterion_id}

display_name

string

Le nom à afficher du critère.

Ce champ est ignoré pour les objets mutate.

type

CriterionType

Type du critère.

status

CampaignCriterionStatus

État du critère.

last_modified_time

string

Date et heure de la dernière modification de ce critère de campagne. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

criterion_id

int64

ID du critère.

Ce champ est ignoré lors d'une opération mutate.

bid_modifier

float

Modificateur des enchères lorsque le critère correspond. Le modificateur doit être compris entre 0,1 et 10,0. La plupart des types de critères pouvant être ciblés sont compatibles avec les modificateurs. Indiquez 0 pour désactiver un type d'appareil.

negative

bool

Permet de spécifier si le critère doit être ciblé (false) ou exclu (true).

Champ d'union criterion. Le critère de la campagne.

Vous ne devez en définir qu'un. criterion ne peut être qu'un des éléments suivants :

keyword

KeywordInfo

Mot clé.

location

LocationInfo

Localisation.

device

DeviceInfo

appareil.

age_range

AgeRangeInfo

Tranche d'âge.

gender

GenderInfo

Gender.

user_list

UserListInfo

Liste d'utilisateurs.

language

LanguageInfo

HashiCorp.

webpage

WebpageInfo

Page Web.

location_group

LocationGroupInfo

Groupe de zones géographiques

CampaignLabel

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

Champs
resource_name

string

Nom de la ressource. Les noms des ressources de libellé de campagne se présentent comme suit: customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}

campaign

string

Campagne à laquelle le libellé est associé.

label

string

Libellé attribué à la campagne.

CartDataSalesView

Vue des ventes des données du panier.

Champs
resource_name

string

Nom de ressource de la vue des ventes de données relatives au panier. Le nom des ressources de la vue "Ventes" des données du panier se présente sous la forme suivante: customers/{customer_id}/cartDataSalesView

Conversion

Une conversion.

Champs
resource_name

string

Nom de ressource de la conversion. Le nom des ressources de conversion se présente sous la forme suivante:

customers/{customer_id}/conversions/{ad_group_id}~{criterion_id}~{ds_conversion_id}

id

int64

Identifiant de la conversion

criterion_id

int64

ID du critère Search Ads 360. Une valeur de 0 indique que le critère n'est pas attribué.

merchant_id

int64

ID de compte de l'inventaire SearchAds360 contenant le produit ayant fait l'objet d'un clic. SearchAds360 génère cet identifiant lorsque vous associez un compte d'inventaire dans SearchAds360.

ad_id

int64

Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée.

click_id

string

Chaîne unique, pour la visite à laquelle la conversion est attribuée, transmise à la page de destination en tant que paramètre d'URL d'ID de clic.

visit_id

int64

ID de visite SearchAds360 auquel la conversion est attribuée.

advertiser_conversion_id

string

Pour les conversions hors connexion, il s'agit d'un identifiant fourni par les annonceurs. Si un annonceur ne spécifie pas un tel identifiant, Search Ads 360 en génère un. Pour les conversions en ligne, il correspond à la colonne "id" ou à la colonne "floodlight_order_id" suivant les instructions Floodlight de l'annonceur.

product_id

string

Identifiant du produit ayant fait l'objet d'un clic.

product_channel

ProductChannel

Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin.

product_language_code

string

Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit.

product_store_id

string

Magasin associé à l'annonce produit en magasin ayant fait l'objet d'un clic. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin.

product_country_code

string

Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic.

attribution_type

AttributionType

Élément auquel la conversion est attribuée : visite ou mot clé + annonce.

conversion_date_time

string

Code temporel de l'événement de conversion.

conversion_last_modified_date_time

string

Code temporel de la dernière modification de la conversion.

conversion_visit_date_time

string

Code temporel de la visite à laquelle la conversion est attribuée.

conversion_quantity

int64

Quantité d'articles enregistrés par la conversion, telle que déterminée par le paramètre d'URL qty. L'annonceur est responsable du remplissage dynamique du paramètre (par exemple avec le nombre d'articles vendus dans le cadre de la conversion). Sinon, la valeur par défaut est définie sur 1.

conversion_revenue_micros

int64

Revenus ajustés en micro-unités pour l'événement de conversion. Cette valeur est toujours dans la devise du compte de diffusion.

floodlight_original_revenue

int64

Revenus initiaux non modifiés associés à l'événement Floodlight (dans la devise du rapport actuel), avant la modification des instructions de devise Floodlight.

floodlight_order_id

string

ID de commande Floodlight fourni par l'annonceur pour la conversion.

status

ConversionStatus

État de la conversion (ACTIVÉ ou SUPPRIMÉ)

asset_id

int64

ID du composant avec lequel vous avez interagi lors de l'événement de conversion.

asset_field_type

AssetFieldType

Type de champ de composant de l'événement de conversion.

ConversionAction

Une action de conversion.

Champs
resource_name

string

Nom de ressource de l'action de conversion. Le nom des ressources de l'action de conversion se présente sous la forme suivante:

customers/{customer_id}/conversionActions/{conversion_action_id}

creation_time

string

Horodatage de la création de l'activité Floodlight, au format ISO 8601.

status

ConversionActionStatus

État de cette action de conversion pour le décompte des événements de conversion.

type

ConversionActionType

Type d'action de conversion.

category

ConversionActionCategory

Catégorie de conversions enregistrée pour cette action de conversion.

value_settings

ValueSettings

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

attribution_model_settings

AttributionModelSettings

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

floodlight_settings

FloodlightSettings

Paramètres Floodlight pour les types de conversion Floodlight

id

int64

ID de l'action de conversion.

name

string

Nom de l'action de conversion.

Ce champ est obligatoire. Il doit être renseigné lors de la création d'actions de conversion.

primary_for_goal

bool

Si le bit "primary_for_goal" d'une action de conversion est défini sur "false", aucune enchère ne peut être définie pour toutes les campagnes, quel que soit l'objectif de conversion du client ou de la campagne. Toutefois, les objectifs de conversion personnalisés ne respectent pas "primary_for_goal". Par conséquent, si une campagne comporte un objectif de conversion personnalisé configuré avec une action de conversion "primary_for_goal = false", cette action de conversion peut toujours être enchérissable. Par défaut, "primary_for_goal" est défini sur "true". Dans V9, "primary_for_goal" ne peut être défini sur "false" qu'après sa création par le biais d'une opération de mise à jour, car il n'est pas déclaré comme facultatif.

owner_customer

string

Nom de ressource du client propriétaire de l'action de conversion, ou valeur "null" s'il s'agit d'une action de conversion définie par le système.

include_in_client_account_conversions_metric

bool

Indique si cette action de conversion doit être incluse dans la métrique "client_account_conversions".

include_in_conversions_metric

bool

Indique si cette action de conversion doit être incluse dans la métrique "Conversions".

click_through_lookback_window_days

int64

Nombre maximal de jours pouvant s'écouler entre une interaction (un clic, par exemple) et un événement de conversion.

app_id

string

ID d'application pour une action de conversion d'application.

AttributionModelSettings

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

Champs
attribution_model

AttributionModel

Type de modèle d'attribution de cette action de conversion.

data_driven_model_status

DataDrivenModelStatus

État du modèle d'attribution basée sur les données pour l'action de conversion.

FloodlightSettings

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

Champs
activity_group_tag

string

Chaîne permettant d'identifier un groupe d'activités Floodlight lors de la création de rapports sur les conversions.

activity_tag

string

Chaîne permettant d'identifier une activité Floodlight lors de la création de rapports sur les conversions.

activity_id

int64

ID de l'activité Floodlight dans DoubleClick Campaign Manager (DCM).

ValueSettings

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

Champs
default_value

double

Valeur à utiliser lorsque les événements de conversion associés à cette action de conversion sont envoyés avec une valeur non valide, non autorisée ou manquante, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut.

default_currency_code

string

Code de devise à utiliser lorsque les événements de conversion associés à cette action de conversion sont envoyés avec un code de devise non valide ou manquant, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut.

always_use_default_value

bool

Détermine si la valeur et le code de devise par défaut sont utilisés à la place de la valeur et du code de devise spécifiés dans les événements de conversion pour cette action de conversion.

ConversionCustomVariable

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

Champs
resource_name

string

Nom de ressource de la variable personnalisée de conversion. Les noms des ressources de variables personnalisées de conversion se présentent comme suit:

customers/{customer_id}/conversionCustomVariables/{conversion_custom_variable_id}

id

int64

ID de la variable personnalisée de conversion.

name

string

Obligatoire. Nom de la variable personnalisée de conversion. Le nom doit être unique. La longueur maximale du nom est de 100 caractères. N'ajoutez pas d'espace avant et après.

tag

string

Obligatoire. Balise de la variable personnalisée de conversion. Le tag doit être unique et se composer d'un caractère "u" directement suivi d'un nombre inférieur à 100. Exemple: "u4".

status

ConversionCustomVariableStatus

État de la variable personnalisée de conversion pour le cumul des événements de conversion.

owner_customer

string

Nom de la ressource du client qui possède la variable personnalisée de conversion.

family

ConversionCustomVariableFamily

Famille de la variable personnalisée de conversion.

cardinality

ConversionCustomVariableCardinality

Cardinalité de la variable personnalisée de conversion.

floodlight_conversion_custom_variable_info

FloodlightConversionCustomVariableInfo

Champs pour les variables personnalisées de conversion Floodlight Search Ads 360.

custom_column_ids[]

int64

ID des colonnes personnalisées qui utilisent cette variable personnalisée de conversion.

FloodlightConversionCustomVariableInfo

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

Champs
floodlight_variable_type

FloodlightVariableType

Type de variable Floodlight défini dans Search Ads 360.

floodlight_variable_data_type

FloodlightVariableDataType

Type de données de variable Floodlight défini dans Search Ads 360

ConversionTrackingSetting

Ensemble de paramètres concernant le client concernant le suivi des conversions Search Ads 360.

Champs
accepted_customer_data_terms

bool

Indique si le client a accepté les conditions d'utilisation des données client. Si vous utilisez le suivi des conversions multicomptes, cette valeur est héritée de l'administrateur. Ce champ est en lecture seule. Pour en savoir plus, consultez la page https://support.google.com/adspolicy/answer/7475709.

conversion_tracking_status

ConversionTrackingStatus

État du suivi des conversions. Elle indique si le client utilise le suivi des conversions et qui en est le propriétaire. Si le client utilise le suivi des conversions multicomptes, la valeur renvoyée diffère en fonction de l'login-customer-id de la requête.

enhanced_conversions_for_leads_enabled

bool

Indique si le client a activé le suivi avancé des conversions pour les prospects. Si vous utilisez le suivi des conversions multicomptes, cette valeur est héritée de l'administrateur. Ce champ est en lecture seule.

google_ads_conversion_customer

string

Nom de la ressource du client dans laquelle les conversions sont créées et gérées. Ce champ est en lecture seule.

conversion_tracking_id

int64

ID de suivi des conversions utilisé pour ce compte. Cet identifiant n'indique pas si le client utilise le suivi des conversions (contre "conversion_tracking_status"). Ce champ est en lecture seule.

google_ads_cross_account_conversion_tracking_id

int64

ID de suivi des conversions du responsable du client. Ce paramètre est défini lorsque le client a activé le suivi des conversions et remplace conversion_tracking_id. Ce champ ne peut être géré que via l'interface utilisateur de Google Ads. Ce champ est en lecture seule.

cross_account_conversion_tracking_id

int64

ID de suivi des conversions du responsable du client. Ce paramètre est défini lorsque le client a activé le suivi des conversions multicomptes et remplace conversion_tracking_id.

CustomColumn

Une colonne personnalisée. Consultez la section "Colonne personnalisée Search Ads 360" à l'adresse https://support.google.com/sa360/answer/9633916.

Champs
resource_name

string

Nom de ressource de la colonne personnalisée. Les noms de ressources des colonnes personnalisées ont le format suivant:

customers/{customer_id}/customColumns/{custom_column_id}

id

int64

ID de la colonne personnalisée.

name

string

Nom de la colonne personnalisée défini par l'utilisateur.

description

string

Description de la colonne personnalisée définie par l'utilisateur.

value_type

CustomColumnValueType

Type de valeur de résultat de la colonne personnalisée.

references_attributes

bool

Vrai lorsque la colonne personnalisée fait référence à un ou plusieurs attributs.

references_metrics

bool

Vrai lorsque la colonne personnalisée fait référence à une ou plusieurs métriques.

queryable

bool

Vrai lorsque la colonne personnalisée peut être utilisée dans la requête de SearchAds360Service.Search et SearchAds360Service.SearchStream.

referenced_system_columns[]

string

Liste des colonnes système référencées de cette colonne personnalisée. Par exemple, une colonne personnalisée "Somme des impressions et des clics" fait référence aux colonnes système {"metrics.clicks", "metrics.impressions"}.

Client

Un client.

Champs
resource_name

string

Nom de ressource du client. Le nom des ressources client se présente sous la forme suivante:

customers/{customer_id}

conversion_tracking_setting

ConversionTrackingSetting

Paramètre de suivi des conversions d'un client.

account_type

AccountType

Type de compte de moteur (par exemple, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Suivi de moteur).

double_click_campaign_manager_setting

DoubleClickCampaignManagerSetting

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

account_status

AccountStatus

L'état du compte ("Activé", "Mis en veille", "Supprimé", etc.)

last_modified_time

string

Date et heure de la dernière modification du client. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss".

engine_id

string

ID du compte dans le compte de moteur externe.

status

CustomerStatus

État du client.

creation_time

string

Horodatage lors de la création de ce client. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

id

int64

ID du client.

descriptive_name

string

Nom descriptif facultatif et non unique du client.

currency_code

string

Devise de fonctionnement du compte. Accepte un sous-ensemble de codes de devise ISO 4217.

time_zone

string

ID du fuseau horaire local du client.

tracking_url_template

string

Modèle d'URL permettant de créer une URL de suivi à partir de paramètres.

final_url_suffix

string

Modèle d'URL permettant d'ajouter des paramètres à l'URL finale.

auto_tagging_enabled

bool

Indique si le taggage automatique est activé pour le client.

manager

bool

Indique si le client est un gestionnaire.

CustomerAsset

Lien entre un client et un élément.

Champs
resource_name

string

Nom de ressource de l'élément client. Les noms de ressources CustomerAsset ont le format suivant:

customers/{customer_id}/customerAssets/{asset_id}~{field_type}

asset

string

Obligatoire. Élément associé au client.

status

AssetLinkStatus

État du composant client.

CustomerAssetSet

CustomerAssetSet est le lien entre un client et un ensemble de composants. L'ajout d'un CustomerAssetSet permet d'associer un ensemble de composants à un client.

Champs
resource_name

string

Nom de ressource de l'ensemble de composants du client. Les noms de ressources d'éléments de l'ensemble d'assets se présentent comme suit:

customers/{customer_id}/customerAssetSets/{asset_set_id}

asset_set

string

Ensemble de composants associé au client.

customer

string

Client auquel cet ensemble de composants est associé.

status

AssetSetLinkStatus

État du composant de l'ensemble de composants client. Lecture seule.

CustomerClient

Lien entre le client donné et un client. Les CustomerClients n'existent que pour les clients gestionnaires. Tous les clients directs et indirects sont inclus, ainsi que le gestionnaire lui-même.

Champs
resource_name

string

Nom de ressource du client client. Les noms de ressources CustomerClient ont le format suivant: customers/{customer_id}/customerClients/{client_customer_id}

applied_labels[]

string

Noms de ressources des libellés appartenant au client demandeur et appliqués au client client. Les noms des ressources d'étiquette ont le format suivant:

customers/{customer_id}/labels/{label_id}

status

CustomerStatus

État du client. Lecture seule.

client_customer

string

Nom de ressource du client-client lié au client donné. Lecture seule.

hidden

bool

Indique s'il s'agit d'un compte masqué.

Lecture seule.

level

int64

Distance entre le client donné et le client. Pour les liens auto, la valeur du niveau est 0. Lecture seule.

time_zone

string

Chaîne CLDR (Common Locale Data Repository) représentant le fuseau horaire du client, par exemple America/Los_Angeles. Lecture seule.

test_account

bool

Détermine si le client est un compte de test. Lecture seule.

manager

bool

Détermine si le client est un gestionnaire. Lecture seule.

descriptive_name

string

Nom descriptif du client. Lecture seule.

currency_code

string

Code de devise (par exemple, "USD" ou "EUR") pour le client. Lecture seule.

id

int64

Identifiant du client client. Lecture seule.

DoubleClickCampaignManagerSetting

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

Champs
advertiser_id

int64

Numéro de l'annonceur Campaign Manager associé à ce client.

network_id

int64

ID du réseau Campaign Manager associé à ce client.

time_zone

string

Fuseau horaire du réseau Campaign Manager associé à ce client, au format de la base de données des fuseaux horaires IANA, tel que America/New_York.

DynamicSearchAdsSearchTermView

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

Champs
resource_name

string

Nom de ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Le nom des ressources de la vue des termes de recherche pour les annonces dynamiques du Réseau de Recherche se présente comme suit:

customers/{customer_id}/dynamicSearchAdsSearchTermViews/{ad_group_id}~{search_term_fingerprint}~{headline_fingerprint}~{landing_page_fingerprint}~{page_url_fingerprint}

landing_page

string

URL de la page de destination sélectionnée dynamiquement pour l'impression.

Ce champ est en lecture seule.

GenderView

Une vue par genre. La ressource "gender_view" reflète l'état de diffusion effectif, plutôt que les critères ajoutés. Par défaut, un groupe d'annonces sans critères de genre est diffusé auprès de tous les sexes. Par conséquent, tous les sexes apparaissent dans la vue "gender_view", avec les statistiques.

Champs
resource_name

string

Nom de ressource de la vue par sexe. Le nom des ressources de la vue Sexe se présente sous la forme suivante:

customers/{customer_id}/genderViews/{ad_group_id}~{criterion_id}

GeoTargetConstant

Constante de cible géographique

Champs
resource_name

string

Nom de ressource de la constante de cible géographique. Les noms des ressources constantes des cibles géographiques se présentent sous la forme suivante:

geoTargetConstants/{geo_target_constant_id}

status

GeoTargetConstantStatus

État constant de la cible géographique.

id

int64

ID de la constante de cible géographique.

name

string

Nom anglais constant de la cible géographique.

country_code

string

Code pays ISO-3166-1 alpha-2 associé à la cible.

target_type

string

Type de cible constante de la cible géographique.

canonical_name

string

Nom complet anglo-saxon composé du nom de la cible, de celui du parent et du pays.

parent_geo_target

string

Nom de ressource de la constante de cible géographique parente. Les noms des ressources constantes des cibles géographiques se présentent sous la forme suivante:

geoTargetConstants/{parent_geo_target_constant_id}

KeywordView

Une vue de mot clé.

Champs
resource_name

string

Nom de ressource de la vue des mots clés. Les noms des ressources de la vue des mots clés se présentent comme suit:

customers/{customer_id}/keywordViews/{ad_group_id}~{criterion_id}

Étiquette

Un libellé.

Champs
resource_name

string

Nom de la ressource. Les noms des ressources d'étiquette ont le format suivant: customers/{customer_id}/labels/{label_id}

status

LabelStatus

État du libellé. Lecture seule.

text_label

TextLabel

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

id

int64

ID du libellé. Lecture seule.

name

string

Nom du libellé.

Ce champ est obligatoire et ne doit pas être vide lors de la création d'un libellé.

La longueur de cette chaîne doit être comprise entre 1 et 80, inclus.

LanguageConstant

Une langue.

Champs
resource_name

string

Nom de ressource de la constante de langue. Les noms des ressources de constantes de langage se présentent sous la forme suivante:

languageConstants/{criterion_id}

id

int64

ID de la constante de langue.

code

string

Code de langue, par exemple "en_US", "en_AU", "es", "fr", etc.

name

string

Nom complet de la langue en anglais, par exemple "Anglais (États-Unis)", "Espagnol", etc.

targetable

bool

Indique si la langue peut être ciblée.

ListingGroupFilterDimension

Dimensions de la fiche pour le filtre de groupe de fiches de groupe d'assets.

Champs
Champ d'union dimension. La dimension de l'un des types ci-dessous est toujours présente. dimension ne peut être qu'un des éléments suivants :
product_bidding_category

ProductBiddingCategory

Catégorie d'enchères d'une offre de produit.

product_brand

ProductBrand

Marque d'une offre de produit.

product_channel

ProductChannel

Localité d'une offre de produit.

product_condition

ProductCondition

État d'une offre de produit.

product_custom_attribute

ProductCustomAttribute

Attribut personnalisé d'une offre de produit.

product_item_id

ProductItemId

ID de l'article d'une offre.

product_type

ProductType

Type d'offre de produit.

ProductBiddingCategory

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

Champs
level

ListingGroupFilterBiddingCategoryLevel

Indique le niveau de la catégorie dans la taxonomie.

id

int64

ID de la catégorie d'enchères de produit.

Cet identifiant équivaut à l'identifiant google_product_category [catégorie_de_produits_google], tel que décrit dans cet article: https://support.google.com/merchants/answer/6324436.

ProductBrand

Marque du produit.

Champs
value

string

Valeur de chaîne de la marque du produit.

ProductChannel

Localité d'une offre de produit.

Champs
channel

ListingGroupFilterProductChannel

Valeur de la localité.

ProductCondition

État d'une offre de produit.

Champs
condition

ListingGroupFilterProductCondition

Valeur de la condition.

ProductCustomAttribute

Attribut personnalisé d'une offre de produit.

Champs
index

ListingGroupFilterCustomAttributeIndex

Indique l'index de l'attribut personnalisé.

value

string

Valeur de chaîne de l'attribut personnalisé du produit.

ProductItemId

ID de l'article d'une offre.

Champs
value

string

Valeur de l'ID.

ProductType

Type d'offre de produit.

Champs
level

ListingGroupFilterProductTypeLevel

Niveau du type.

value

string

Valeur du type.

ListingGroupFilterDimensionPath

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

Champs
dimensions[]

ListingGroupFilterDimension

Chemin complet des dimensions via la hiérarchie des filtres de groupe de fiches (à l'exclusion du nœud racine) vers ce filtre de groupe de fiches.

LocationView

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

Champs
resource_name

string

Nom de ressource de la vue de l'établissement. Les noms des ressources de vue d'emplacement se présentent comme suit:

customers/{customer_id}/locationViews/{campaign_id}~{criterion_id}

ProductBiddingCategoryConstant

Une catégorie d'enchères de produits.

Champs
resource_name

string

Nom de ressource de la catégorie d'enchères du produit. Les noms des ressources de catégorie d'enchères de produit se présentent comme suit:

productBiddingCategoryConstants/{country_code}~{level}~{id}

level

ProductBiddingCategoryLevel

Niveau de la catégorie d'enchères de produits.

status

ProductBiddingCategoryStatus

État de la catégorie d'enchères du produit.

id

int64

ID de la catégorie d'enchères de produit.

Cet identifiant équivaut à l'identifiant google_product_category [catégorie_de_produits_google], tel que décrit dans cet article: https://support.google.com/merchants/answer/6324436.

country_code

string

Code pays à deux lettres en majuscules de la catégorie d'enchères du produit.

product_bidding_category_constant_parent

string

Nom de ressource de la catégorie d'enchères du produit parent.

language_code

string

Code de langue de la catégorie d'enchères du produit.

localized_name

string

La valeur d'affichage de la catégorie d'enchères associée au produit est localisée en fonction de "language_code".

ProductGroupView

Affichage d'un groupe de produits.

Champs
resource_name

string

Nom de ressource de la vue du groupe de produits. Les noms des ressources d'affichage de groupe de produits se présentent comme suit:

customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id}

SearchAds360Field

Champ ou ressource (artefact) utilisé par SearchAds360Service.

Champs
resource_name

string

Nom de ressource de l'artefact. Les noms des ressources d'artefact se présentent sous la forme suivante:

SearchAds360Fields/{name}

category

SearchAds360FieldCategory

Catégorie de l'artefact.

selectable_with[]

string

Noms de toutes les ressources, segments et métriques sélectionnables avec l'artefact décrit.

attribute_resources[]

string

Noms de toutes les ressources sélectionnables avec l'artefact décrit. Les champs de ces ressources ne segmentent pas les statistiques lorsqu'ils sont inclus dans des requêtes de recherche.

Ce champ n'est défini que pour les artefacts dont la catégorie est RESOURCE.

metrics[]

string

Ce champ répertorie les noms de toutes les métriques sélectionnables avec l'artefact décrit lorsqu'il est utilisé dans la clause FROM. Il n'est défini que pour les artefacts dont la catégorie est RESOURCE.

segments[]

string

Ce champ répertorie les noms de tous les artefacts, qu'il s'agisse d'un segment ou d'une autre ressource, qui segmentent les métriques lorsqu'elles sont incluses dans les requêtes de recherche et lorsque l'artefact décrit est utilisé dans la clause FROM. Il n'est défini que pour les artefacts dont la catégorie est RESOURCE.

enum_values[]

string

Valeurs que l'artefact peut supposer s'il s'agit d'un champ de type ENUM.

Ce champ n'est défini que pour les artefacts de la catégorie SEGMENT ou ATTRIBUTE.

data_type

SearchAds360FieldDataType

Ce champ détermine les opérateurs pouvant être utilisés avec l'artefact dans les clauses WHERE.

name

string

Nom de l'artefact.

selectable

bool

Indique si l'artefact peut être utilisé dans une clause SELECT dans les requêtes de recherche.

filterable

bool

Indique si l'artefact peut être utilisé dans une clause WHERE dans les requêtes de recherche.

sortable

bool

Indique si l'artefact peut être utilisé dans une clause ORDER BY dans les requêtes de recherche.

type_url

string

URL du fichier proto décrivant le type de données de l'artefact.

is_repeated

bool

Indique si l'artefact de champ est répété.

ShoppingPerformanceView

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

Champs
resource_name

string

Nom de ressource de la vue des performances Shopping. Le nom des ressources de la vue des performances Shopping se présente sous la forme suivante: customers/{customer_id}/shoppingPerformanceView

UserList

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

Champs
resource_name

string

Nom de ressource de la liste d'utilisateurs. Les noms des ressources de la liste d'utilisateurs se présentent sous la forme suivante:

customers/{customer_id}/userLists/{user_list_id}

type

UserListType

Type de cette liste.

Ce champ est en lecture seule.

id

int64

Identifiant de la liste d'utilisateurs.

name

string

Nom de cette liste d'utilisateurs. En fonction de son motif d'accès (access_reason), le nom de la liste d'utilisateurs peut ne pas être unique (par exemple, si access_reason=SHARED).

Accéder à la page

Une visite.

Champs
resource_name

string

Nom de ressource de la visite. Les noms des ressources de visite se présentent comme suit:

customers/{customer_id}/visits/{ad_group_id}~{criterion_id}~{ds_visit_id}

id

int64

ID de la visite.

criterion_id

int64

Identifiant de mot clé Search Ads 360 La valeur 0 indique que le mot clé n'est pas attribué.

merchant_id

int64

ID de compte de l'inventaire Search Ads 360 contenant le produit ayant fait l'objet d'un clic. Search Ads 360 génère cet identifiant lorsque vous associez un compte d'inventaire dans Search Ads 360.

ad_id

int64

Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée.

click_id

string

Chaîne unique pour chaque visite, transmise à la page de destination en tant que paramètre d'URL d'ID de clic.

visit_date_time

string

Code temporel de l'événement de visite. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss".

product_id

string

Identifiant du produit ayant fait l'objet d'un clic.

product_channel

ProductChannel

Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin.

product_language_code

string

Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit.

product_store_id

string

Magasin associé à l'annonce produit en magasin ayant fait l'objet d'un clic. Il doit correspondre aux ID de magasin utilisés dans votre flux de produits en magasin.

product_country_code

string

Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic.

asset_id

int64

ID du composant avec lequel l'utilisateur a interagi lors de l'événement de visite.

asset_field_type

AssetFieldType

Type de champ de composant de l'événement de visite.

WebpageView

Affichage d'une page Web.

Champs
resource_name

string

Nom de ressource de la vue de la page Web. Le nom des ressources de la vue Page Web se présente sous la forme suivante:

customers/{customer_id}/webpageViews/{ad_group_id}~{criterion_id}