- Représentation JSON
- AdGroup
- AdGroupStatus
- AdGroupType
- AdGroupAdRotationMode
- AdGroupEngineStatus
- TargetingSetting
- TargetRestriction
- TargetingDimension
- AdGroupAd
- AdGroupAdStatus
- Annonce
- AdType
- SearchAds360TextAdInfo
- SearchAds360ExpandedTextAdInfo
- SearchAds360ResponsiveSearchAdInfo
- AdTextAsset
- SearchAds360ProductAdInfo
- SearchAds360ExpandedDynamicSearchAdInfo
- AdGroupAdEngineStatus
- AdGroupAdLabel
- AdGroupAsset
- AssetLinkStatus
- AdGroupAssetSet
- AssetSetLinkStatus
- AdGroupAudienceView
- AdGroupBidModifier
- DeviceInfo
- Appareil
- AdGroupCriterion
- AdGroupCriterionStatus
- QualityInfo
- CriterionType
- PositionEstimates
- AdGroupCriterionEngineStatus
- KeywordInfo
- KeywordMatchType
- ListingGroupInfo
- ListingGroupType
- AgeRangeInfo
- AgeRangeType
- GenderInfo
- GenderType
- UserListInfo
- WebpageInfo
- WebpageConditionInfo
- WebpageConditionOperand
- WebpageConditionOperator
- LocationInfo
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRangeView
- Ressource
- AssetType
- AssetStatus
- AssetEngineStatus
- YoutubeVideoAsset
- ImageAsset
- MimeType
- ImageDimension
- TextAsset
- UnifiedCalloutAsset
- AdScheduleInfo
- MinuteOfHour
- DayOfWeek
- UnifiedSitelinkAsset
- UnifiedPageFeedAsset
- MobileAppAsset
- MobileAppVendor
- UnifiedCallAsset
- CallConversionReportingState
- CallToActionAsset
- CallToActionType
- UnifiedLocationAsset
- BusinessProfileLocation
- LocationOwnershipType
- AssetGroupAsset
- AssetFieldType
- AssetGroupSignal
- AudienceInfo
- AssetGroupListingGroupFilter
- ListingGroupFilterType
- ListingGroupFilterVertical
- ListingGroupFilterDimension
- ProductBiddingCategory
- ListingGroupFilterBiddingCategoryLevel
- ProductBrand
- ProductChannel
- ListingGroupFilterProductChannel
- ProductCondition
- ListingGroupFilterProductCondition
- ProductCustomAttribute
- ListingGroupFilterCustomAttributeIndex
- ProductItemId
- ProductType
- ListingGroupFilterProductTypeLevel
- ListingGroupFilterDimensionPath
- AssetGroupTopCombinationView
- AssetGroupAssetCombinationData
- AssetUsage
- ServedAssetFieldType
- AssetGroup
- AssetGroupStatus
- AdStrength
- AssetSetAsset
- AssetSetAssetStatus
- AssetSet
- BiddingStrategy
- BiddingStrategyStatus
- BiddingStrategyType
- EnhancedCpc
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetImpressionShareLocation
- TargetOutrankShare
- TargetRoas
- TargetSpend
- CampaignBudget
- BudgetDeliveryMethod
- BudgetPeriod
- Campagne
- CampaignStatus
- CampaignServingStatus
- BiddingStrategySystemStatus
- AdServingOptimizationStatus
- AdvertisingChannelType
- AdvertisingChannelSubType
- CustomParameter
- RealTimeBiddingSetting
- NetworkSettings
- DynamicSearchAdsSetting
- ShoppingSetting
- GeoTargetTypeSetting
- PositiveGeoTargetType
- NegativeGeoTargetType
- FrequencyCapEntry
- SelectiveOptimization
- OptimizationGoalSetting
- OptimizationGoalType
- TrackingSetting
- ManualCpa
- ManualCpc
- ManualCpm
- PercentCpc
- TargetCpm
- CampaignAsset
- CampaignAssetSet
- CampaignAudienceView
- CampaignCriterion
- CampaignCriterionStatus
- LanguageInfo
- LocationGroupInfo
- LocationGroupRadiusUnits
- CampaignLabel
- CartDataSalesView
- Audience
- ConversionAction
- ConversionActionStatus
- ConversionActionType
- ConversionActionCategory
- ValueSettings
- AttributionModelSettings
- AttributionModel
- DataDrivenModelStatus
- FloodlightSettings
- ConversionCustomVariable
- ConversionCustomVariableStatus
- ConversionCustomVariableFamily
- ConversionCustomVariableCardinality
- FloodlightConversionCustomVariableInfo
- FloodlightVariableType
- FloodlightVariableDataType
- Client
- ConversionTrackingSetting
- ConversionTrackingStatus
- AccountType
- DoubleClickCampaignManagerSetting
- AccountStatus
- CustomerStatus
- CustomerAsset
- CustomerAssetSet
- AccessibleBiddingStrategy
- MaximizeConversionValue
- MaximizeConversions
- TargetCpa
- TargetImpressionShare
- TargetRoas
- TargetSpend
- CustomerManagerLink
- ManagerLinkStatus
- CustomerClient
- DynamicSearchAdsSearchTermView
- GenderView
- GeoTargetConstant
- GeoTargetConstantStatus
- KeywordView
- Libellé
- LabelStatus
- TextLabel
- LanguageConstant
- LocationView
- ProductBiddingCategoryConstant
- ProductBiddingCategoryLevel
- ProductBiddingCategoryStatus
- ProductGroupView
- ShoppingPerformanceView
- UserList
- UserListType
- WebpageView
- Accéder
- ProductChannel
- Conversion
- AttributionType
- ConversionStatus
- Métriques
- Value
- QualityScoreBucket
- InteractionEventType
- Segments
- AdNetworkType
- Mot clé
- ProductChannelExclusivity
- ProductCondition
- AssetInteractionTarget
Une ligne renvoyée par la requête.
Représentation JSON |
---|
{ "adGroup": { object ( |
Champs | |
---|---|
adGroup |
Groupe d'annonces référencé dans la requête. |
adGroupAd |
Annonce référencée dans la requête. |
adGroupAdLabel |
Libellé d'annonce du groupe d'annonces référencé dans la requête. |
adGroupAsset |
Composant du groupe d'annonces référencé dans la requête. |
adGroupAssetSet |
Ensemble de composants du groupe d'annonces référencé dans la requête. |
adGroupAudienceView |
Vue d'audience du groupe d'annonces référencée dans la requête. |
adGroupBidModifier |
Modificateur d'enchères référencé dans la requête. |
adGroupCriterion |
Critère référencé dans la requête. |
adGroupCriterionLabel |
Libellé du critère du groupe d'annonces référencé dans la requête. |
adGroupLabel |
Libellé du groupe d'annonces référencé dans la requête. |
ageRangeView |
Vue de la tranche d'âge référencée dans la requête. |
asset |
Élément référencé dans la requête. |
assetGroupAsset |
Asset du groupe d'assets référencé dans la requête. |
assetGroupSignal |
Signal du groupe d'assets référencé dans la requête. |
assetGroupListingGroupFilter |
Filtre de groupe de fiches de groupe d'assets référencé dans la requête. |
assetGroupTopCombinationView |
Vue des meilleures combinaisons du groupe d'assets référencée dans la requête. |
assetGroup |
Groupe d'assets référencé dans la requête. |
assetSetAsset |
Asset de l'ensemble d'assets référencé dans la requête. |
assetSet |
Ensemble de composants référencé dans la requête. |
biddingStrategy |
Stratégie d'enchères référencée dans la requête. |
campaignBudget |
Budget de la campagne référencé dans la requête. |
campaign |
Campagne référencée dans la requête. |
campaignAsset |
Composant de campagne référencé dans la requête. |
campaignAssetSet |
Ensemble de composants de campagne référencé dans la requête. |
campaignAudienceView |
Vue "Audience de la campagne" référencée dans la requête. |
campaignCriterion |
Critère de campagne référencé dans la requête. |
campaignLabel |
Libellé de la campagne référencé dans la requête. |
cartDataSalesView |
Vue des ventes des données du panier référencée dans la requête. |
audience |
Audience référencée dans la requête. |
conversionAction |
Action de conversion référencée dans la requête. |
conversionCustomVariable |
Variable personnalisée de conversion référencée dans la requête. |
customer |
Client référencé dans la requête. |
customerAsset |
Asset du client référencé dans la requête. |
customerAssetSet |
Ensemble de composants du client référencé dans la requête. |
accessibleBiddingStrategy |
Stratégie d'enchères accessible référencée dans la requête. |
customerManagerLink |
CustomerManagerLink référencé dans la requête. |
customerClient |
CustomerClient référencé dans la requête. |
dynamicSearchAdsSearchTermView |
Vue du terme de recherche des annonces dynamiques du Réseau de Recherche référencée dans la requête. |
genderView |
Vue par genre référencée dans la requête. |
geoTargetConstant |
Constante de cible géographique référencée dans la requête. |
keywordView |
Vue de mot clé référencée dans la requête. |
label |
Étiquette référencée dans la requête. |
languageConstant |
Constante de langage référencée dans la requête. |
locationView |
Vue de l'établissement référencée dans la requête. |
productBiddingCategoryConstant |
Catégorie d'enchères pour les produits référencée dans la requête. |
productGroupView |
Vue du groupe de produits référencée dans la requête. |
shoppingPerformanceView |
Vue des performances Shopping référencée dans la requête. |
userList |
Liste d'utilisateurs référencée dans la requête. |
webpageView |
Vue de la page Web référencée dans la requête. |
visit |
Visite au niveau de l'événement référencée dans la requête. |
conversion |
Conversion au niveau de l'événement référencée dans la requête. |
metrics |
Les métriques |
segments |
Les segments. |
customColumns[] |
Colonnes personnalisées |
AdGroup
Un groupe d'annonces
Représentation JSON |
---|
{ "resourceName": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du groupe d'annonces. Les noms de ressources d'un groupe d'annonces se présentent comme suit:
|
status |
État du groupe d'annonces. |
type |
Type de groupe d'annonces. |
adRotationMode |
Mode de rotation des annonces du groupe d'annonces. |
creationTime |
Horodatage de la création de ce groupe d'annonces. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss". |
targetingSetting |
Paramètre de ciblage des fonctionnalités associées. |
labels[] |
Noms de ressource des étiquettes associées à ce groupe d'annonces. |
engineId |
ID du 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 "adGroup.id". à la place. |
startDate |
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 |
endDate |
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 |
languageCode |
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 |
lastModifiedTime |
Date et heure de la dernière modification de ce groupe d'annonces. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss". |
id |
Identifiant du groupe d'annonces. |
name |
Nom du groupe d'annonces. Ce champ est obligatoire. Il ne doit pas être vide lors de la création de groupes d'annonces. Il doit contenir moins de 255 caractères UTF-8 en pleine largeur. Il ne doit contenir aucun caractère nul (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD). |
cpcBidMicros |
Enchère au CPC (coût par clic) maximal. |
engineStatus |
État du moteur pour le groupe d'annonces. |
AdGroupStatus
États possibles d'un groupe d'annonces.
Enums | |
---|---|
UNSPECIFIED |
L'état n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
Le groupe d'annonces est activé. |
PAUSED |
Le groupe d'annonces est mis en veille. |
REMOVED |
Le groupe d'annonces est supprimé. |
AdGroupType
Énumération répertoriant les types de groupe d'annonces possibles.
Enums | |
---|---|
UNSPECIFIED |
Le type n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
SEARCH_STANDARD |
Type de groupe d'annonces par défaut pour les campagnes sur le Réseau de Recherche. |
DISPLAY_STANDARD |
Type de groupe d'annonces par défaut pour les campagnes display. |
SHOPPING_PRODUCT_ADS |
Type de groupe d'annonces pour les campagnes Shopping diffusant des annonces produit standards. |
SHOPPING_SHOWCASE_ADS |
Type des groupes d'annonces qui se limitent à diffuser des annonces Showcase ou des annonces des marchands dans les résultats Shopping. |
HOTEL_ADS |
Type de groupe d'annonces par défaut pour les campagnes d'hôtel. |
SHOPPING_SMART_ADS |
Type des groupes d'annonces dans les campagnes Shopping intelligentes. |
VIDEO_BUMPER |
Courtes annonces vidéo InStream non désactivables. |
VIDEO_TRUE_VIEW_IN_STREAM |
Les annonces vidéo TrueView InStream (désactivables). |
VIDEO_TRUE_VIEW_IN_DISPLAY |
Les annonces vidéo TrueView InDisplay |
VIDEO_NON_SKIPPABLE_IN_STREAM |
Les annonces vidéo InStream non désactivables. |
VIDEO_OUTSTREAM |
Les annonces vidéo OutStream. |
SEARCH_DYNAMIC_ADS |
Type de groupe d'annonces pour les groupes d'annonces dynamiques du Réseau de Recherche. |
SHOPPING_COMPARISON_LISTING_ADS |
Type des groupes d'annonces dans les campagnes de type "Fiche du service de comparateur de prix". |
PROMOTED_HOTEL_ADS |
Type de groupe d'annonces pour les groupes d'annonces "Hôtels sponsorisés". |
VIDEO_RESPONSIVE |
Groupes d'annonces vidéo responsives. |
VIDEO_EFFICIENT_REACH |
Groupes d'annonces vidéo avec couverture efficace. |
SMART_CAMPAIGN_ADS |
Type de groupe d'annonces pour les campagnes intelligentes. |
TRAVEL_ADS |
Type de groupe d'annonces pour les campagnes de voyage. |
AdGroupAdRotationMode
Modes de rotation des annonces possibles pour un groupe d'annonces.
Enums | |
---|---|
UNSPECIFIED |
Le mode de rotation des annonces n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
OPTIMIZE |
Optimisez les annonces d'un groupe d'annonces en fonction des clics ou des conversions. |
ROTATE_FOREVER |
Alterner indéfiniment |
AdGroupEngineStatus
État du moteur de groupe d'annonces.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
AD_GROUP_ELIGIBLE |
Obsolète. Ne pas utiliser. |
AD_GROUP_EXPIRED |
Aucune annonce n'est diffusée pour ce groupe d'annonces, car sa date de fin est passée. |
AD_GROUP_REMOVED |
Le groupe d'annonces a été supprimé. |
AD_GROUP_DRAFT |
Aucune annonce n'est diffusée pour ce groupe d'annonces, car le groupe d'annonces associé est encore à l'état de brouillon. |
AD_GROUP_PAUSED |
Le groupe d'annonces a été mis en veille. |
AD_GROUP_SERVING |
Le groupe d'annonces est actif et diffuse actuellement des annonces. |
AD_GROUP_SUBMITTED |
Le groupe d'annonces a été envoyé (ancien état Microsoft Bing Ads). |
CAMPAIGN_PAUSED |
Aucune annonce n'est diffusée pour ce groupe d'annonces, car la campagne a été mise en veille. |
ACCOUNT_PAUSED |
Aucune annonce n'est diffusée pour ce groupe d'annonces, car le compte a été mis en veille. |
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.
Représentation JSON |
---|
{
"targetRestrictions": [
{
object ( |
Champs | |
---|---|
targetRestrictions[] |
Paramètre par dimension de ciblage afin de restreindre la couverture de votre campagne ou de votre groupe d'annonces. |
TargetRestriction
Liste des paramètres de ciblage par dimension de ciblage.
Représentation JSON |
---|
{
"targetingDimension": enum ( |
Champs | |
---|---|
targetingDimension |
Il s'agit de la dimension de ciblage à laquelle ces paramètres s'appliquent. |
bidOnly |
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 de ciblage, ou si vous souhaitez cibler toutes les valeurs de cette dimension de ciblage et diffuser des annonces en fonction de votre ciblage dans d'autres dimensions de ciblage. La valeur |
TargetingDimension
Énumération décrivant les dimensions de ciblage possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
KEYWORD |
Critères de mot clé (par exemple, "croisière sur mars"). KEYWORD peut être utilisé comme dimension d'enchère personnalisée. Les mots clés constituent toujours une dimension de ciblage. Ils ne peuvent donc pas être définis comme cible "TOUT". avec TargetRestriction. |
AUDIENCE |
Les critères d'audience, qui incluent les listes d'utilisateurs, les centres d'intérêt des utilisateurs, les audiences d'affinité personnalisées et les audiences personnalisées sur le marché. |
TOPIC |
Critères de ciblage par catégorie de contenu (par exemple, "category::Animaux>Animaux de compagnie") Utilisé pour le ciblage vidéo et display. |
GENDER |
Critères de ciblage par sexe. |
AGE_RANGE |
Critères de ciblage des tranches d'âge. |
PLACEMENT |
Critères d'emplacement, qui incluent des sites Web tels que "www.fleurs4soldes.com", ainsi que des applications mobiles, des catégories d'applications mobiles, des vidéos YouTube et des chaînes YouTube. |
PARENTAL_STATUS |
Critères de ciblage par statut parental. |
INCOME_RANGE |
Critères de ciblage par tranche de revenus. |
AdGroupAd
Annonce d'un groupe d'annonces.
Représentation JSON |
---|
{ "resourceName": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'annonce. Les noms des ressources d'annonces d'un groupe d'annonces se présentent comme suit:
|
status |
État de l'annonce. |
ad |
L'annonce. |
creationTime |
Horodatage de la création de cet adGroupAd. La date/heure est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss.ssssss". |
labels[] |
Noms de ressource des étiquettes associées à cette annonce de groupe d'annonces. |
engineId |
ID de l'annonce dans le compte de moteur externe. Ce champ ne concerne que les comptes Search Ads 360 (par exemple, Yahoo Japan, Microsoft, Baidu, etc.). Pour une entité autre que Search Ads 360, utilisez "adGroupAd.ad.id". à la place. |
engineStatus |
É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. |
lastModifiedTime |
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". |
AdGroupAdStatus
Les états possibles d'un GroupAd
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
L'annonce du groupe d'annonces est activée. |
PAUSED |
L'annonce du groupe d'annonces est mise en veille. |
REMOVED |
L'annonce du groupe d'annonces est supprimée. |
Annonce
Annonce.
Représentation JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "type": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'annonce. Les noms de ressources d'annonces se présentent comme suit:
|
finalUrls[] |
Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce. |
type |
Type d'annonce. |
id |
Identifiant de l'annonce. |
displayUrl |
URL qui s'affiche dans la description de certains formats d'annonces. |
name |
Nom de l'annonce. Cette valeur sert uniquement à identifier l'annonce. Ils ne doivent pas nécessairement être uniques et n'ont aucune incidence sur l'annonce diffusée. 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 : |
|
textAd |
Informations concernant une annonce textuelle. |
expandedTextAd |
Informations sur une annonce textuelle agrandie |
responsiveSearchAd |
Informations concernant une annonce responsive sur le Réseau de Recherche. |
productAd |
Informations concernant une annonce pour un produit. |
expandedDynamicSearchAd |
Informations concernant une annonce dynamique agrandie sur le Réseau de Recherche |
AdType
Types d'annonces possibles.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
TEXT_AD |
Il s'agit d'une annonce textuelle. |
EXPANDED_TEXT_AD |
Il s'agit d'une annonce textuelle agrandie. |
CALL_ONLY_AD |
Il s'agit d'une annonce Appel uniquement. |
EXPANDED_DYNAMIC_SEARCH_AD |
Il s'agit d'une annonce dynamique agrandie sur le Réseau de Recherche. |
HOTEL_AD |
L'annonce est une annonce d'hôtel. |
SHOPPING_SMART_AD |
Il s'agit d'une annonce Shopping intelligente. |
SHOPPING_PRODUCT_AD |
Il s'agit d'une annonce Shopping standard. |
VIDEO_AD |
Il s'agit d'une annonce vidéo. |
GMAIL_AD |
Cette annonce est une annonce Gmail. |
IMAGE_AD |
Cette annonce est une annonce illustrée. |
RESPONSIVE_SEARCH_AD |
Il s'agit d'une annonce responsive sur le Réseau de Recherche. |
LEGACY_RESPONSIVE_DISPLAY_AD |
L'annonce est une ancienne annonce display responsive. |
APP_AD |
L'annonce est une annonce pour une application. |
LEGACY_APP_INSTALL_AD |
L'annonce est une ancienne annonce incitant à installer une application. |
RESPONSIVE_DISPLAY_AD |
Il s'agit d'une annonce display responsive. |
LOCAL_AD |
Il s'agit d'une annonce locale. |
HTML5_UPLOAD_AD |
Il s'agit d'une annonce display importée avec le type de produit HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
Il s'agit d'une annonce display importée avec l'un des types de produits DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
Il s'agit d'une annonce ciblant l'engagement avec une application. |
SHOPPING_COMPARISON_LISTING_AD |
Il s'agit d'une annonce Shopping Fiche du service de comparateur de prix. |
VIDEO_BUMPER_AD |
Annonce vidéo bumper. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Annonce vidéo InStream non désactivable. |
VIDEO_OUTSTREAM_AD |
Annonce vidéo OutStream. |
VIDEO_TRUEVIEW_DISCOVERY_AD |
Annonce vidéo TrueView InDisplay. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
Annonce vidéo TrueView InStream. |
VIDEO_RESPONSIVE_AD |
Annonce vidéo responsive. |
SMART_CAMPAIGN_AD |
Annonce d'une campagne intelligente. |
APP_PRE_REGISTRATION_AD |
Annonce universelle de préinscription à une application. |
DISCOVERY_MULTI_ASSET_AD |
Annonce Discovery avec plusieurs éléments. |
DISCOVERY_CAROUSEL_AD |
Annonce carrousel Discovery. |
TRAVEL_AD |
Annonce de voyage. |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Annonce vidéo responsive Discovery. |
MULTIMEDIA_AD |
Annonce multimédia. |
SearchAds360TextAdInfo
Annonce textuelle Search Ads 360.
Représentation JSON |
---|
{ "headline": string, "description1": string, "description2": string, "displayUrl": string, "displayMobileUrl": string, "adTrackingId": string } |
Champs | |
---|---|
headline |
Titre de l'annonce. |
description1 |
Première ligne de la description de l'annonce. |
description2 |
Deuxième ligne de description de l'annonce. |
displayUrl |
URL affichée de l'annonce |
displayMobileUrl |
URL mobile de l'annonce qui s'affiche. |
adTrackingId |
Identifiant de suivi de l'annonce. |
SearchAds360ExpandedTextAdInfo
Annonce textuelle agrandie Search Ads 360.
Représentation JSON |
---|
{ "headline": string, "headline2": string, "headline3": string, "description1": string, "description2": string, "path1": string, "path2": string, "adTrackingId": string } |
Champs | |
---|---|
headline |
Titre de l'annonce. |
headline2 |
Deuxième titre de l'annonce. |
headline3 |
Troisième titre de l'annonce. |
description1 |
Première ligne de la description de l'annonce. |
description2 |
Deuxième ligne de description de l'annonce. |
path1 |
Texte ajouté à l'URL visible générée automatiquement avec un délimiteur. |
path2 |
Texte ajouté au chemin 1 avec un délimiteur. |
adTrackingId |
Identifiant de suivi de l'annonce. |
SearchAds360ResponsiveSearchAdInfo
Annonce responsive sur le Réseau de Recherche Search Ads 360.
Représentation JSON |
---|
{ "headlines": [ { object ( |
Champs | |
---|---|
headlines[] |
Liste des composants texte pour les titres. Lors de la diffusion de l'annonce, les titres sont sélectionnés dans cette liste. |
descriptions[] |
Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront sélectionnées dans cette liste. |
path1 |
Texte ajouté à l'URL visible générée automatiquement avec un délimiteur. |
path2 |
Texte ajouté au chemin 1 avec un délimiteur. |
adTrackingId |
Identifiant de suivi de l'annonce. |
AdTextAsset
Composant texte utilisé dans une annonce.
Représentation JSON |
---|
{ "text": string } |
Champs | |
---|---|
text |
Texte de l'élément. |
SearchAds360ProductAdInfo
Ce type ne comporte aucun champ.
Annonce produit Search Ads 360.
SearchAds360ExpandedDynamicSearchAdInfo
Annonce dynamique agrandie du Réseau de Recherche.
Représentation JSON |
---|
{ "description1": string, "description2": string, "adTrackingId": string } |
Champs | |
---|---|
description1 |
Première ligne de la description de l'annonce. |
description2 |
Deuxième ligne de description de l'annonce. |
adTrackingId |
Identifiant de suivi de l'annonce. |
AdGroupAdEngineStatus
Énumère les états du moteur GROUPAd.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
AD_GROUP_AD_ELIGIBLE |
Obsolète. Ne pas utiliser. |
AD_GROUP_AD_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: la création n'a pas été approuvée. |
AD_GROUP_AD_MOBILE_URL_UNDER_REVIEW |
Baidu: URL mobile en cours d'examen. |
AD_GROUP_AD_PARTIALLY_INVALID |
Baidu: la création n'est pas valide sur un appareil mobile, mais elle est valide sur les ordinateurs. |
AD_GROUP_AD_TO_BE_ACTIVATED |
Baidu: la création est prête à être activée. |
AD_GROUP_AD_NOT_REVIEWED |
Baidu: création non examinée. |
AD_GROUP_AD_ON_HOLD |
Obsolète. Ne pas utiliser. Utilisé précédemment par Gemini |
AD_GROUP_AD_PAUSED |
La création a été mise en veille. |
AD_GROUP_AD_REMOVED |
La création a été supprimée. |
AD_GROUP_AD_PENDING_REVIEW |
La création est en attente d'examen. |
AD_GROUP_AD_UNDER_REVIEW |
La création est en cours d'examen. |
AD_GROUP_AD_APPROVED |
La création a été approuvée. |
AD_GROUP_AD_DISAPPROVED |
La création a été refusée. |
AD_GROUP_AD_SERVING |
La création est en cours de diffusion. |
AD_GROUP_AD_ACCOUNT_PAUSED |
La création a été mise en veille, car le compte l'est également. |
AD_GROUP_AD_CAMPAIGN_PAUSED |
La création a été mise en veille, car la campagne l'est également. |
AD_GROUP_AD_AD_GROUP_PAUSED |
La création a été mise en veille, car le groupe d'annonces l'est également. |
AdGroupAdLabel
Relation entre une annonce d'un groupe d'annonces et un libellé.
Représentation JSON |
---|
{ "resourceName": string, "adGroupAd": string, "label": string } |
Champs | |
---|---|
resourceName |
Nom de ressource du libellé d'annonce du groupe d'annonces. Les noms de ressources de libellé d'annonce du groupe d'annonces se présentent comme suit: |
adGroupAd |
Annonce du groupe d'annonces à laquelle le libellé est associé. |
label |
Libellé attribué à l'annonce du groupe d'annonces. |
AdGroupAsset
Lien entre un groupe d'annonces et un composant.
Représentation JSON |
---|
{
"resourceName": string,
"adGroup": string,
"asset": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'élément du groupe d'annonces. Les noms de ressources GroupAsset se présentent comme suit:
|
adGroup |
Obligatoire. Groupe d'annonces auquel l'élément est associé. |
asset |
Obligatoire. L'élément associé au groupe d'annonces. |
status |
État du composant du groupe d'annonces. |
AssetLinkStatus
Énumération décrivant les états d'un lien d'élément.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ENABLED |
Le lien vers l'élément est activé. |
REMOVED |
Le lien vers l'asset a été supprimé. |
PAUSED |
Le lien vers l'asset est en veille. |
AdGroupAssetSet
GROUPAssetSet est le lien entre un groupe d'annonces et un ensemble d'assets. La création d'un GroupAssetSet associe un ensemble d'assets à un groupe d'annonces.
Représentation JSON |
---|
{
"resourceName": string,
"adGroup": string,
"assetSet": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'ensemble d'assets du groupe d'annonces. Les noms de ressources de l'ensemble de composants du groupe d'annonces se présentent comme suit:
|
adGroup |
Groupe d'annonces auquel cet ensemble de composants est associé. |
assetSet |
Ensemble de composants associé au groupe d'annonces. |
status |
État de l'ensemble de composants du groupe d'annonces. En lecture seule. |
AssetSetLinkStatus
États possibles de l'association entre l'ensemble de composants et son conteneur.
Enums | |
---|---|
UNSPECIFIED |
L'état n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
L'association entre l'ensemble d'éléments et son conteneur est activée. |
REMOVED |
L'association entre l'ensemble d'éléments et son conteneur est supprimée. |
AdGroupAudienceView
Vue d'audience d'un groupe d'annonces. Comprend les données sur les performances issues des centres d'intérêt et des listes de remarketing pour les annonces sur les Réseaux Display et YouTube, et des listes de remarketing pour les annonces du Réseau de Recherche (RLSA), cumulées au niveau de l'audience.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue de l'audience du groupe d'annonces. Les noms des ressources de vue de l'audience d'un groupe d'annonces se présentent comme suit:
|
AdGroupBidModifier
Représente un modificateur d'enchères de groupe d'annonces.
Représentation JSON |
---|
{ "resourceName": string, "bidModifier": number, // Union field |
Champs | |
---|---|
resourceName |
Nom de ressource du modificateur d'enchères du groupe d'annonces. Les noms des ressources de modificateur d'enchères de groupe d'annonces se présentent comme suit:
|
bidModifier |
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 Obligatoire pour les opérations de création à partir de la version 5. |
|
device |
Un critère d'appareil. |
DeviceInfo
Un critère d'appareil.
Représentation JSON |
---|
{
"type": enum ( |
Champs | |
---|---|
type |
Type d'appareil. |
Appareil
Énumère les appareils Google Ads disponibles pour le ciblage.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
MOBILE |
Mobiles dotés d'un navigateur Internet complet. |
TABLET |
Tablettes dotées d'un navigateur Internet complet |
DESKTOP |
Ordinateurs. |
CONNECTED_TV |
Smart TV et consoles de jeu. |
OTHER |
Autres types d'appareils |
AdGroupCriterion
Un critère de groupe d'annonces. Le rapport adGroupCritère ne renvoie que les critères qui ont été explicitement ajoutés au groupe d'annonces.
Représentation JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du critère du groupe d'annonces. Les noms des ressources des critères du groupe d'annonces se présentent comme suit:
|
creationTime |
Horodatage au moment de la création de ce critère de groupe d'annonces. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss". |
status |
État du critère. Il s'agit de l'état de l'entité de critère du groupe d'annonces définie par le client. Remarque : Les rapports de l'interface utilisateur peuvent intégrer des informations supplémentaires qui déterminent si un critère peut être exécuté. Dans certains cas, un critère supprimé dans l'API peut encore apparaître comme activé dans l'interface utilisateur. Par exemple, les campagnes par défaut sont diffusées auprès des utilisateurs de toutes les tranches d'âge, sauf si elles sont exclues. Du fait qu'elle peut voir les annonces, l'interface utilisateur affiche chaque tranche d'âge comme étant activée, mais l'état AdGroupCriterion.status indique "supprimée", car aucun critère positif n'a été ajouté. |
qualityInfo |
Informations concernant la qualité du critère. |
type |
Type du critère. |
labels[] |
Noms de ressource des étiquettes associées à ce critère de groupe d'annonces. |
positionEstimates |
Estimations pour les enchères des critères à différentes positions. |
finalUrls[] |
Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce. |
engineId |
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 "adGroupCritère.criterion_id". à la place. |
lastModifiedTime |
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". |
criterionId |
ID du critère. |
adGroup |
Groupe d'annonces auquel appartient le critère. |
negative |
Permet de cibler ( Ce champ est immuable. Pour remplacer un critère positif par un critère négatif, supprimez-le, puis ajoutez-le à nouveau. |
bidModifier |
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. |
cpcBidMicros |
Enchère au CPC (coût par clic). |
effectiveCpcBidMicros |
L'enchère au CPC (coût par clic) effective. |
engineStatus |
État du moteur pour le critère de groupe d'annonces. |
finalUrlSuffix |
Modèle d'URL permettant d'ajouter des paramètres à l'URL finale. |
trackingUrlTemplate |
Modèle d'URL permettant de créer une URL de suivi. |
Champ d'union Vous ne devez en définir qu'un seul. |
|
keyword |
Mot clé. |
listingGroup |
Groupe de fiches. |
ageRange |
Tranche d'âge. |
gender |
Gender. |
userList |
Liste d'utilisateurs. |
webpage |
Page Web |
location |
Localisation. |
AdGroupCriterionStatus
États possibles d'un critère Critères.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
Le critère du groupe d'annonces est activé. |
PAUSED |
Le critère du groupe d'annonces a été mis en veille. |
REMOVED |
Le critère du groupe d'annonces est supprimé. |
QualityInfo
Conteneur pour les informations sur la qualité du critère de groupe d'annonces.
Représentation JSON |
---|
{ "qualityScore": integer } |
Champs | |
---|---|
qualityScore |
Le niveau de qualité. Ce champ peut ne pas être renseigné si Google ne dispose pas d'informations suffisantes pour déterminer une valeur. |
CriterionType
Énumération décrivant les types de critères possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
KEYWORD |
Mot clé (par exemple, "croisière sur mars"). |
PLACEMENT |
Emplacement, également appelé site Web (par exemple, "www.fleurs4soldes.com") |
MOBILE_APP_CATEGORY |
Catégories d'applications mobiles à cibler. |
MOBILE_APPLICATION |
Applications mobiles à cibler. |
DEVICE |
Appareils à cibler. |
LOCATION |
Zones géographiques à cibler. |
LISTING_GROUP |
Groupes de fiches à cibler. |
AD_SCHEDULE |
Calendrier de diffusion des annonces. |
AGE_RANGE |
Tranche d'âge. |
GENDER |
Gender. |
INCOME_RANGE |
Plage de revenus. |
PARENTAL_STATUS |
Statut parental. |
YOUTUBE_VIDEO |
Vidéo YouTube. |
YOUTUBE_CHANNEL |
Chaîne YouTube. |
USER_LIST |
Liste d'utilisateurs. |
PROXIMITY |
Proximité. |
TOPIC |
Un thème ciblé sur le Réseau Display (par exemple, "Animaux et animaux de compagnie"). |
LISTING_SCOPE |
Champ d'application de la liste à cibler. |
LANGUAGE |
HashiCorp. |
IP_BLOCK |
IpBlock. |
CONTENT_LABEL |
Libellé de contenu pour l'exclusion de catégories. |
CARRIER |
Opérateur. |
USER_INTEREST |
Catégorie qui intéresse l'utilisateur. |
WEBPAGE |
Critère de page Web pour les annonces dynamiques du Réseau de Recherche. |
OPERATING_SYSTEM_VERSION |
La version du système d'exploitation. |
APP_PAYMENT_MODEL |
Modèle de paiement de l'application. |
MOBILE_DEVICE |
Appareil mobile |
CUSTOM_AFFINITY |
Audience d'affinité personnalisée. |
CUSTOM_INTENT |
Intention personnalisée |
LOCATION_GROUP |
Groupe de zones géographiques. |
CUSTOM_AUDIENCE |
Audience personnalisée |
COMBINED_AUDIENCE |
Audience combinée |
KEYWORD_THEME |
Thème de mots clés de la campagne intelligente |
AUDIENCE |
Audience |
LOCAL_SERVICE_ID |
ID du service Annonces Local Services. |
BRAND |
Marque |
BRAND_LIST |
Liste de marques |
LIFE_EVENT |
Événement de la vie |
PositionEstimates
Estimations pour les enchères des critères à différentes positions.
Représentation JSON |
---|
{ "topOfPageCpcMicros": string } |
Champs | |
---|---|
topOfPageCpcMicros |
Estimation de l'enchère au CPC requise pour que l'annonce soit diffusée en haut de la première page des résultats de recherche. |
AdGroupCriterionEngineStatus
Énumère les états du moteur Critère de recherche.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
AD_GROUP_CRITERION_ELIGIBLE |
Obsolète. Ne pas utiliser. |
AD_GROUP_CRITERION_INAPPROPRIATE_FOR_CAMPAIGN |
Baidu: enchère ou qualité trop faible pour être affichée |
AD_GROUP_CRITERION_INVALID_MOBILE_SEARCH |
Baidu: enchère ou qualité trop faible pour les mobiles, mais éligible à l'affichage sur les ordinateurs |
AD_GROUP_CRITERION_INVALID_PC_SEARCH |
Baidu: enchère ou qualité trop faible pour les ordinateurs, mais éligible à l'affichage sur les mobiles |
AD_GROUP_CRITERION_INVALID_SEARCH |
Baidu: enchère ou qualité trop faible pour être affichée |
AD_GROUP_CRITERION_LOW_SEARCH_VOLUME |
Baidu: mis en veille par Baidu en raison du faible volume de recherche. |
AD_GROUP_CRITERION_MOBILE_URL_UNDER_REVIEW |
Baidu: URL mobile en cours d'examen. |
AD_GROUP_CRITERION_PARTIALLY_INVALID |
Baidu: la page de destination d'un appareil n'est pas valide, tandis que celle de l'autre appareil est valide. |
AD_GROUP_CRITERION_TO_BE_ACTIVATED |
Baidu: le mot clé a été créé et mis en veille par l'équipe de gestion du compte Baidu, et vous pouvez maintenant l'activer. |
AD_GROUP_CRITERION_UNDER_REVIEW |
Baidu: en cours d'examen par Baidu Gemini: critère en cours d'examen. |
AD_GROUP_CRITERION_NOT_REVIEWED |
Baidu: critère à examiner. |
AD_GROUP_CRITERION_ON_HOLD |
Obsolète. Ne pas utiliser. Utilisé précédemment par Gemini |
AD_GROUP_CRITERION_PENDING_REVIEW |
Y!J : critère en attente d'examen |
AD_GROUP_CRITERION_PAUSED |
Le critère a été mis en veille. |
AD_GROUP_CRITERION_REMOVED |
Le critère a été supprimé. |
AD_GROUP_CRITERION_APPROVED |
Le critère a été approuvé. |
AD_GROUP_CRITERION_DISAPPROVED |
Le critère a été refusé. |
AD_GROUP_CRITERION_SERVING |
Le critère est actif et en cours de diffusion. |
AD_GROUP_CRITERION_ACCOUNT_PAUSED |
Le critère a été mis en veille, car le compte a été mis en veille. |
KeywordInfo
Un critère de mot clé.
Représentation JSON |
---|
{
"matchType": enum ( |
Champs | |
---|---|
matchType |
Type de correspondance du mot clé. |
text |
Texte du mot clé (au maximum 80 caractères et 10 mots). |
KeywordMatchType
Types de correspondance des mots clés possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
EXACT |
Mot clé exact |
PHRASE |
Expression exacte. |
BROAD |
Requête large. |
ListingGroupInfo
Critère du groupe de fiches.
Représentation JSON |
---|
{
"type": enum ( |
Champs | |
---|---|
type |
Type du groupe de fiches. |
ListingGroupType
Type du groupe de fiches.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
SUBDIVISION |
Subdivision des produits selon une dimension de fiche. Ces nœuds ne servent pas à cibler des entrées de liste, mais servent uniquement à définir la structure de l'arborescence. |
UNIT |
Unité de groupe de fiches qui définit une enchère. |
AgeRangeInfo
Un critère de tranche d'âge.
Représentation JSON |
---|
{
"type": enum ( |
Champs | |
---|---|
type |
Type de tranche d'âge. |
AgeRangeType
Type de tranches d'âge démographiques (par exemple, entre 18 et 24 ans).
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
AGE_RANGE_18_24 |
Entre 18 et 24 ans |
AGE_RANGE_25_34 |
Entre 25 et 34 ans |
AGE_RANGE_35_44 |
Entre 35 et 44 ans |
AGE_RANGE_45_54 |
Entre 45 et 54 ans |
AGE_RANGE_55_64 |
Entre 55 et 64 ans |
AGE_RANGE_65_UP |
à partir de 65 ans. |
AGE_RANGE_UNDETERMINED |
Tranche d'âge indéterminée. |
GenderInfo
Un critère de genre.
Représentation JSON |
---|
{
"type": enum ( |
Champs | |
---|---|
type |
Type de genre. |
GenderType
Type de données démographiques concernant le genre (par exemple, "femme").
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
MALE |
Homme. |
FEMALE |
Féminin. |
UNDETERMINED |
Genre indéterminé. |
UserListInfo
Un critère de liste d'utilisateurs. Représente une liste d'utilisateurs définie par l'annonceur à cibler.
Représentation JSON |
---|
{ "userList": string } |
Champs | |
---|---|
userList |
Nom de laressource de la liste d'utilisateurs. |
WebpageInfo
Représente un critère de ciblage des pages Web du site Web d'un annonceur.
Représentation JSON |
---|
{
"conditions": [
{
object ( |
Champs | |
---|---|
conditions[] |
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. |
coveragePercentage |
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. |
criterionName |
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. |
WebpageConditionInfo
Expression logique pour cibler les pages Web du site Web d'un annonceur.
Représentation JSON |
---|
{ "operand": enum ( |
Champs | |
---|---|
operand |
Opérande de la condition de ciblage de page Web. |
operator |
Opérateur de la condition de ciblage de la page Web. |
argument |
Argument de la condition de ciblage de page Web. |
WebpageConditionOperand
Opérande de la condition de page Web dans le critère de page Web.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
URL |
Opérande indiquant une condition de ciblage par URL de page Web. |
CATEGORY |
Opérande indiquant une condition de ciblage par catégorie de page Web. |
PAGE_TITLE |
Opérande indiquant une condition de ciblage par titre de page Web. |
PAGE_CONTENT |
Opérande indiquant une condition de ciblage par contenu d'une page Web. |
CUSTOM_LABEL |
Opérande indiquant une condition de ciblage par étiquette personnalisée de page Web. |
WebpageConditionOperator
Opérateur de condition de page Web dans le critère de page Web.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
EQUALS |
L'argument "web condition" est égal à la condition Web comparée. |
CONTAINS |
L'argument "web condition" fait partie de la condition Web comparée. |
LocationInfo
Un critère géographique.
Représentation JSON |
---|
{ "geoTargetConstant": string } |
Champs | |
---|---|
geoTargetConstant |
Nom de la ressource constante de ciblage géographique. |
AdGroupCriterionLabel
Relation entre un critère de groupe d'annonces et un libellé.
Représentation JSON |
---|
{ "resourceName": string, "adGroupCriterion": string, "label": string } |
Champs | |
---|---|
resourceName |
Nom de ressource du libellé du critère du groupe d'annonces. Les noms de ressources du libellé du critère de groupe d'annonces sont au format suivant: |
adGroupCriterion |
Critère du groupe d'annonces auquel le libellé est associé. |
label |
Libellé attribué au critère du groupe d'annonces. |
AdGroupLabel
Relation entre un groupe d'annonces et un libellé.
Représentation JSON |
---|
{ "resourceName": string, "adGroup": string, "label": string } |
Champs | |
---|---|
resourceName |
Nom de ressource du libellé du groupe d'annonces. Les noms de ressources des libellés de groupe d'annonces se présentent comme suit: |
adGroup |
Groupe d'annonces auquel le libellé est associé. |
label |
Libellé attribué au groupe d'annonces. |
AgeRangeView
Vue par tranche d'âge.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue de la tranche d'âge. Les noms des ressources de la vue par tranche d'âge se présentent sous la forme suivante:
|
Élément
Un composant fait partie d'une annonce et peut être partagé 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.
Représentation JSON |
---|
{ "resourceName": string, "type": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'élément. Les noms de ressources d'éléments se présentent comme suit:
|
type |
Type de l'asset. |
finalUrls[] |
Liste des URL finales possibles après toutes les redirections interdomaines. |
status |
État de l'élément. |
creationTime |
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". |
lastModifiedTime |
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 |
ID de l'élément. |
name |
Nom facultatif de l'élément. |
trackingUrlTemplate |
Modèle d'URL permettant de créer une URL de suivi. |
engineStatus |
État dans le moteur d'un élément. |
Champ d'union asset_data . Type spécifique de l'élément. asset_data ne peut être qu'un des éléments suivants : |
|
youtubeVideoAsset |
Une vidéo YouTube. |
imageAsset |
Un composant Image. |
textAsset |
Un composant texte. |
calloutAsset |
Composant Accroche unifié. |
sitelinkAsset |
Composant Lien annexe unifié. |
pageFeedAsset |
Élément de flux de pages unifié. |
mobileAppAsset |
Un composant Application mobile. |
callAsset |
Un composant Appel unifié |
callToActionAsset |
Un composant Incitation à l'action. |
locationAsset |
Composant Lieu unifié. |
AssetType
Énumération décrivant les types d'éléments possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
YOUTUBE_VIDEO |
élément vidéo YouTube. |
MEDIA_BUNDLE |
Élément du kit média. |
IMAGE |
Composant Image. |
TEXT |
Composant texte. |
LEAD_FORM |
Composant Formulaire pour prospects. |
BOOK_ON_GOOGLE |
Asset Réserver sur Google. |
PROMOTION |
Composant Promotion. |
CALLOUT |
Un composant Accroche. |
STRUCTURED_SNIPPET |
Composant Extrait structuré. |
SITELINK |
Composant Lien annexe. |
PAGE_FEED |
un élément de flux de pages. |
DYNAMIC_EDUCATION |
Asset dynamique pour l'enseignement. |
MOBILE_APP |
Composant Application mobile. |
HOTEL_CALLOUT |
Composant Accroche pour hôtel. |
CALL |
Un composant Appel. |
PRICE |
Composant Prix. |
CALL_TO_ACTION |
Composant Incitation à l'action. |
DYNAMIC_REAL_ESTATE |
Asset immobilier dynamique. |
DYNAMIC_CUSTOM |
Élément personnalisé dynamique. |
DYNAMIC_HOTELS_AND_RENTALS |
Asset dynamique pour les hôtels et les locations. |
DYNAMIC_FLIGHTS |
Asset dynamique sur les vols. |
DISCOVERY_CAROUSEL_CARD |
Élément de la fiche carrousel Discovery. |
DYNAMIC_TRAVEL |
Asset dynamique sur les voyages. |
DYNAMIC_LOCAL |
Asset local dynamique. |
DYNAMIC_JOBS |
Asset dynamique sur les emplois. |
LOCATION |
Composant Lieu. |
HOTEL_PROPERTY |
Asset d'établissement hôtelier. |
AssetStatus
États possibles d'un composant.
Enums | |
---|---|
UNSPECIFIED |
L'état n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
L'asset est activé. |
REMOVED |
L'asset est supprimé. |
ARCHIVED |
L'élément est archivé. |
PENDING_SYSTEM_GENERATED |
L'asset est généré par le système en attendant son examen par l'utilisateur. |
AssetEngineStatus
Identifiant suivant = 11
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
SERVING |
L'asset est actif. |
SERVING_LIMITED |
L'asset est actif et limité. |
DISAPPROVED |
Le composant a été refusé (non éligible). |
DISABLED |
L'asset est inactif (en attente). |
REMOVED |
Le composant a été supprimé. |
YoutubeVideoAsset
Un élément YouTube.
Représentation JSON |
---|
{ "youtubeVideoTitle": string, "youtubeVideoId": string } |
Champs | |
---|---|
youtubeVideoTitle |
Titre de la vidéo YouTube. |
youtubeVideoId |
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. |
ImageAsset
Un composant Image.
Représentation JSON |
---|
{ "mimeType": enum ( |
Champs | |
---|---|
mimeType |
Type MIME du composant Image. |
fullSize |
Métadonnées de cette image dans sa taille d'origine. |
fileSize |
Taille du fichier de l'élément image en octets. |
MimeType
Type MIME
Enums | |
---|---|
UNSPECIFIED |
Le type MIME n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
IMAGE_JPEG |
Type MIME de l'image/jpeg. |
IMAGE_GIF |
Type MIME de l'image/gif. |
IMAGE_PNG |
Type MIME de l'image/png. |
FLASH |
Type MIME de l'application/x-shockwave-flash. |
TEXT_HTML |
Type MIME du texte/html. |
PDF |
Type MIME de l'application/pdf. |
MSWORD |
Type MIME de l'application/msword. |
MSEXCEL |
Type MIME de l'application/vnd.ms-excel. |
RTF |
Type MIME de l'application/rtf. |
AUDIO_WAV |
Type MIME de l'audio/wav. |
AUDIO_MP3 |
Type MIME de l'audio/mp3. |
HTML5_AD_ZIP |
Type MIME de l'application/x-html5-ad-zip. |
ImageDimension
Métadonnées d'une image dans une certaine taille, qu'elle soit d'origine ou redimensionnée.
Représentation JSON |
---|
{ "heightPixels": string, "widthPixels": string, "url": string } |
Champs | |
---|---|
heightPixels |
Hauteur de l'image. |
widthPixels |
Largeur de l'image. |
url |
URL qui renvoie l'image avec cette hauteur et cette largeur. |
TextAsset
Un composant texte.
Représentation JSON |
---|
{ "text": string } |
Champs | |
---|---|
text |
Contenu texte de l'asset texte. |
UnifiedCalloutAsset
Composant Accroche unifié.
Représentation JSON |
---|
{
"calloutText": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Champs | |
---|---|
calloutText |
Texte de l'accroche. La longueur de cette chaîne doit être comprise entre 1 et 25, inclus. |
startDate |
Date de début à laquelle cet élément entre en vigueur et peut commencer à être diffusé, au format aaaa-MM-jj. |
endDate |
Date à laquelle cet élément entre en vigueur et diffuse actuellement des annonces, au format aaaa-MM-jj. |
adScheduleTargets[] |
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. |
useSearcherTimeZone |
Permet d'afficher ou non l'élément dans le fuseau horaire de l'utilisateur associé à la recherche. S'applique à Microsoft Ads. |
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.
Représentation JSON |
---|
{ "startMinute": enum ( |
Champs | |
---|---|
startMinute |
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. |
endMinute |
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. |
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. |
startHour |
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. |
endHour |
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. |
MinuteOfHour
Énumération des quarts d'heure. Exemple : "FIFTEEN"
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
ZERO |
0 minute après l'heure. |
FIFTEEN |
Heure et quinze minutes. |
THIRTY |
Trente minutes après l'heure. |
FORTY_FIVE |
Quarante-cinq minutes après l'heure. |
DayOfWeek
Énumère les jours de la semaine, par exemple "lundi".
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
MONDAY |
lundi. |
TUESDAY |
mardi. |
WEDNESDAY |
mercredi. |
THURSDAY |
jeudi. |
FRIDAY |
vendredi. |
SATURDAY |
samedi). |
SUNDAY |
dimanche. |
UnifiedSitelinkAsset
Composant Lien annexe unifié.
Représentation JSON |
---|
{
"linkText": string,
"description1": string,
"description2": string,
"startDate": string,
"endDate": string,
"adScheduleTargets": [
{
object ( |
Champs | |
---|---|
linkText |
Texte à afficher pour le lien annexe. La longueur de cette chaîne doit être comprise entre 1 et 25, inclus. |
description1 |
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 |
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. |
startDate |
Date de début à laquelle cet élément entre en vigueur et peut commencer à être diffusé, au format aaaa-MM-jj. |
endDate |
Date à laquelle cet élément entre en vigueur et diffuse actuellement des annonces, au format aaaa-MM-jj. |
adScheduleTargets[] |
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. |
trackingId |
ID utilisé pour suivre les clics sur le composant Lien annexe. Il s'agit d'un compte Yahoo! Japan uniquement. |
useSearcherTimeZone |
Permet d'afficher ou non le composant Lien annexe dans le fuseau horaire de l'utilisateur associé à la recherche. S'applique à Microsoft Ads. |
mobilePreferred |
Indique si le composant Lien annexe s'affiche sur les appareils mobiles ou non. S'applique à Microsoft Ads. |
UnifiedPageFeedAsset
Élément de flux de pages unifié.
Représentation JSON |
---|
{ "pageUrl": string, "labels": [ string ] } |
Champs | |
---|---|
pageUrl |
La page Web que les annonceurs souhaitent cibler. |
labels[] |
Libellés utilisés pour regrouper les URL des pages. |
MobileAppAsset
Asset représentant une application mobile.
Représentation JSON |
---|
{
"appId": string,
"appStore": enum ( |
Champs | |
---|---|
appId |
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. |
appStore |
Obligatoire. Plate-forme de téléchargement d'applications qui distribue cette application spécifique. |
MobileAppVendor
Le type de fournisseur de l'application mobile
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
APPLE_APP_STORE |
Fournisseur d'applications mobiles pour l'App Store d'Apple. |
GOOGLE_APP_STORE |
Fournisseur d'applications mobiles pour la plate-forme de téléchargement d'applications Google. |
UnifiedCallAsset
Un composant Appel unifié
Représentation JSON |
---|
{ "countryCode": string, "phoneNumber": string, "callConversionReportingState": enum ( |
Champs | |
---|---|
countryCode |
Code pays à deux lettres du numéro de téléphone. Exemples : "US", "us". |
phoneNumber |
Numéro de téléphone brut de l'annonceur. Exemples : "1234567890", "(123)456-7890" |
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. |
callConversionAction |
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 callConversionReportingState est défini sur USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION. |
adScheduleTargets[] |
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. |
callOnly |
Indique si l'appel n'affiche que le numéro de téléphone, sans lien vers le site Web. S'applique à Microsoft Ads. |
callTrackingEnabled |
Indique si l'appel doit être activé dans le suivi des appels. S'applique à Microsoft Ads. |
useSearcherTimeZone |
Permet d'afficher ou non l'extension d'appel dans le fuseau horaire de l'utilisateur associé à la recherche. S'applique à Microsoft Ads. |
startDate |
Date de début à laquelle cet élément entre en vigueur et peut commencer à être diffusé, au format aaaa-MM-jj. |
endDate |
Date à laquelle cet élément entre en vigueur et diffuse actuellement des annonces, au format aaaa-MM-jj. |
CallConversionReportingState
Types de données possibles pour un état d'action de conversion par appel.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
DISABLED |
L'action de conversion par appel est désactivée. |
USE_ACCOUNT_LEVEL_CALL_CONVERSION_ACTION |
L'action de conversion par appel utilisera le type de conversion par appel défini au niveau du compte. |
USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION |
L'action de conversion par appel utilisera le type de conversion par appel défini au niveau de la ressource (annonces Appel uniquement/extensions d'appel). |
CallToActionAsset
Un composant Incitation à l'action.
Représentation JSON |
---|
{
"callToAction": enum ( |
Champs | |
---|---|
callToAction |
Incitation à l'action. |
CallToActionType
Énumération décrivant les types possibles d'incitations à l'action.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
LEARN_MORE |
Le type d'incitation à l'action est "En savoir plus". |
GET_QUOTE |
Le type d'incitation à l'action est "Obtenir un devis". |
APPLY_NOW |
Le type d'incitation à l'action est "Appliquer maintenant". |
SIGN_UP |
Le type d'incitation à l'action est "S'inscrire". |
CONTACT_US |
Le type d'incitation à l'action est "Contactez-nous". |
SUBSCRIBE |
L'incitation à l'action est de type "S'abonner". |
DOWNLOAD |
L'incitation à l'action est de type "Téléchargement". |
BOOK_NOW |
L'incitation à l'action est de type "Réserver maintenant". |
SHOP_NOW |
Le type d'incitation à l'action est "Acheter maintenant". |
BUY_NOW |
L'incitation à l'action est de type "Acheter maintenant". |
DONATE_NOW |
Le type d'incitation à l'action est "Faites un don maintenant". |
ORDER_NOW |
Le type d'incitation à l'action est "Commander maintenant". |
PLAY_NOW |
Le type d'incitation à l'action est "Lire". |
SEE_MORE |
Le type d'incitation à l'action est "Voir plus". |
START_NOW |
Le type d'incitation à l'action est "Commencer maintenant". |
VISIT_SITE |
Le type d'incitation à l'action est "Visiter le site". |
WATCH_NOW |
Le type d'incitation à l'action est "Regarder maintenant". |
UnifiedLocationAsset
Composant Lieu unifié.
Représentation JSON |
---|
{ "placeId": string, "businessProfileLocations": [ { object ( |
Champs | |
---|---|
placeId |
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. |
businessProfileLocations[] |
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. |
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é. |
BusinessProfileLocation
Données de localisation de la fiche d'établissement synchronisées à partir du compte de fiches d'établissement associé.
Représentation JSON |
---|
{ "labels": [ string ], "storeCode": string, "listingId": string } |
Champs | |
---|---|
labels[] |
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. |
storeCode |
Code de magasin de la fiche d'établissement de cet établissement. Cette information est synchronisée à partir du compte de fiche d'établissement. |
listingId |
ID de la fiche de cet établissement. Ces informations sont synchronisées à partir du compte de fiche d'établissement associé. |
LocationOwnershipType
Types possibles de propriété d'un établissement.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
BUSINESS_OWNER |
Propriétaire de l'établissement(ancienne extension de lieu - LE). |
AFFILIATE |
Lieu affilié(extension de lieu tiers - ALE). |
AssetGroupAsset
AssetGroupAsset est le lien entre un élément et un groupe d'assets. L'ajout d'un AssetGroupAsset associe un asset à un groupe d'assets.
Représentation JSON |
---|
{ "resourceName": string, "assetGroup": string, "asset": string, "fieldType": enum ( |
Champs | |
---|---|
resourceName |
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:
|
assetGroup |
Groupe d'assets auquel cet asset est associé. |
asset |
Asset auquel ce composant du groupe d'assets est associé. |
fieldType |
Description de l'emplacement de l'asset dans le groupe d'assets. Par exemple: HEADLINE, YOUTUBE_VIDEO, etc. |
status |
État de l'association entre un élément et un groupe d'assets. |
AssetFieldType
Énumération décrivant les emplacements possibles d'un élément.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
HEADLINE |
L'asset est associé pour être utilisé comme titre. |
DESCRIPTION |
Un lien vers l'asset peut être utilisé comme description. |
MANDATORY_AD_TEXT |
Le composant est associé pour être utilisé comme texte d'annonce obligatoire. |
MARKETING_IMAGE |
L'asset est associé pour être utilisé comme image marketing. |
MEDIA_BUNDLE |
L'élément est associé pour être utilisé comme kit média. |
YOUTUBE_VIDEO |
L'élément est associé pour être utilisé comme vidéo YouTube. |
BOOK_ON_GOOGLE |
Le composant est associé pour indiquer qu'une campagne d'hôtel est "Réserver sur Google" est activé. |
LEAD_FORM |
Le composant est associé et peut être utilisé comme extension de formulaire pour prospects. |
PROMOTION |
Le composant est associé et peut être utilisé comme extension de promotion. |
CALLOUT |
Le composant est associé pour être utilisé comme extension d'accroche. |
STRUCTURED_SNIPPET |
L'asset est associé et peut être utilisé comme extension d'extrait structuré. |
SITELINK |
Le composant est associé pour être utilisé en tant que lien annexe. |
MOBILE_APP |
L'élément est associé pour être utilisé en tant qu'extension d'application mobile. |
HOTEL_CALLOUT |
Le composant est associé pour être utilisé comme extension d'accroche associée à l'hôtel. |
CALL |
Le composant est associé pour être utilisé comme extension d'appel. |
PRICE |
L'asset est associé pour être utilisé comme extension de prix. |
LONG_HEADLINE |
L'asset est associé pour être utilisé comme titre long. |
BUSINESS_NAME |
L'asset est associé pour être utilisé comme nom d'entreprise. |
SQUARE_MARKETING_IMAGE |
L'asset est associé et peut être utilisé comme image marketing carrée. |
PORTRAIT_MARKETING_IMAGE |
L'asset est associé pour être utilisé comme image marketing en mode portrait. |
LOGO |
L'élément est associé pour être utilisé comme logo. |
LANDSCAPE_LOGO |
L'asset est associé pour être utilisé comme logo au format paysage. |
VIDEO |
L'élément est associé pour être utilisé comme logo autre que YouTube. |
CALL_TO_ACTION_SELECTION |
Un lien vers le composant permet de sélectionner une incitation à l'action. |
AD_IMAGE |
Un lien vers le composant permet de sélectionner une image d'annonce. |
BUSINESS_LOGO |
L'asset est associé pour être utilisé comme logo d'entreprise. |
HOTEL_PROPERTY |
Le composant est associé pour être utilisé en tant qu'établissement hôtelier dans une campagne Performance Max pour les objectifs de voyage. |
DISCOVERY_CAROUSEL_CARD |
L'élément est associé pour être utilisé comme fiche de carrousel Discovery. |
AssetGroupSignal
AssetGroupSignal représente un signal dans un groupe d'assets. L'existence d'un signal indique à la campagne Performance Max qui est le plus susceptible d'effectuer une conversion. Performance Max utilise le 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, les campagnes vidéo et plus encore.
Représentation JSON |
---|
{ "resourceName": string, "assetGroup": string, // Union field |
Champs | |
---|---|
resourceName |
Nom de ressource du signal du groupe d'assets. Le nom de la ressource du signal de groupe d'assets se présente comme suit:
|
assetGroup |
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 |
Signal d'audience que la campagne Performance Max doit utiliser. |
AudienceInfo
Un critère d'audience.
Représentation JSON |
---|
{ "audience": string } |
Champs | |
---|---|
audience |
Nom de ressource de l'audience. |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter représente un nœud d'arborescence de filtres pour un groupe de fiches dans un groupe d'assets.
Représentation JSON |
---|
{ "resourceName": string, "assetGroup": string, "id": string, "type": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du filtre de groupe de fiches (groupe d'assets). Le nom de la ressource du filtre de groupe de fiches du groupe d'assets se présente comme suit:
|
assetGroup |
Groupe d'assets auquel ce filtre de groupe de fiches de groupe d'assets fait partie. |
id |
ID de ListingGroupFilter. |
type |
Type d'un nœud de filtre de groupe de fiches. |
vertical |
Secteur représenté par l'arborescence de nœuds actuelle. Tous les nœuds d'une même arborescence doivent appartenir au même secteur. |
caseValue |
Valeur de dimension à laquelle ce groupe de fiches affine son parent. Non défini pour le groupe racine. |
parentListingGroupFilter |
Nom de ressource de la subdivision de groupe de fiches parent. Null pour le nœud de filtre de groupe de fiches racine. |
path |
Chemin des dimensions définissant ce filtre de groupe de fiches. |
ListingGroupFilterType
Type de filtre de groupe de fiches.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
SUBDIVISION |
Subdivision des produits selon certaines dimensions de fiche. |
UNIT_INCLUDED |
Nœud feuille de filtre de groupe de fiches inclus. |
UNIT_EXCLUDED |
Nœud feuille de filtre de groupe de fiches exclus. |
ListingGroupFilterVertical
Type de secteur du filtre de groupes de fiches.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
SHOPPING |
Représente le secteur d'achat. Le secteur n'est autorisé que dans les campagnes Performance Max pour le commerce. |
ListingGroupFilterDimension
Dimensions de la fiche pour le filtre de groupe de fiches sur le groupe d'assets.
Représentation JSON |
---|
{ // Union field |
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 : |
|
productBiddingCategory |
Catégorie d'enchères d'une offre de produit. |
productBrand |
Marque d'une offre de produit. |
productChannel |
Localité d'une offre de produit. |
productCondition |
Condition d'une offre de produit. |
productCustomAttribute |
Attribut personnalisé d'une offre de produit. |
productItemId |
Identifiant de l'article d'une offre. |
productType |
Type d'une offre de produit. |
ProductBiddingCategory
Un élément d'une catégorie d'enchères à un certain niveau. Les catégories de niveau supérieur se situent au niveau 1, les enfants au niveau 2, etc. Pour le moment, nous acceptons jusqu'à cinq niveaux. L'utilisateur doit spécifier un type de dimension qui indique le niveau de la catégorie. Tous les cas de la même subdivision doivent être associés au même type de dimension (au niveau de la catégorie).
Représentation JSON |
---|
{
"level": enum ( |
Champs | |
---|---|
level |
Indique le niveau de la catégorie dans la taxonomie. |
id |
ID de la catégorie d'enchères associées au produit. Cet identifiant correspond à l'identifiant "google_product_category" décrit dans cet article: https://support.google.com/merchants/answer/6324436. |
ListingGroupFilterBiddingCategoryLevel
Niveau de la catégorie d'enchères du filtre de groupe de fiches.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
LEVEL1 |
Niveau 1. |
LEVEL2 |
Niveau 2. |
LEVEL3 |
Niveau 3. |
LEVEL4 |
Niveau 4. |
LEVEL5 |
Niveau 5. |
ProductBrand
Marque du produit.
Représentation JSON |
---|
{ "value": string } |
Champs | |
---|---|
value |
Valeur de chaîne de la marque du produit. |
ProductChannel
Localité d'une offre de produit.
Représentation JSON |
---|
{
"channel": enum ( |
Champs | |
---|---|
channel |
Valeur de la localité. |
ListingGroupFilterProductChannel
Énumération décrivant la localité d'une offre de produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ONLINE |
L'article est vendu en ligne. |
LOCAL |
L'article est vendu dans des magasins locaux. |
ProductCondition
Condition d'une offre de produit.
Représentation JSON |
---|
{
"condition": enum ( |
Champs | |
---|---|
condition |
Valeur de la condition. |
ListingGroupFilterProductCondition
Énumération décrivant l'état d'une offre de produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
NEW |
Le produit est neuf. |
REFURBISHED |
Le produit est reconditionné. |
USED |
L'état du produit est utilisé. |
ProductCustomAttribute
Attribut personnalisé d'une offre de produit.
Représentation JSON |
---|
{
"index": enum ( |
Champs | |
---|---|
index |
Indique l'index de l'attribut personnalisé. |
value |
Valeur de chaîne de l'attribut personnalisé de produit. |
ListingGroupFilterCustomAttributeIndex
Index des attributs du client.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
INDEX0 |
Premier attribut personnalisé du filtre de groupe de fiches. |
INDEX1 |
Deuxième attribut personnalisé de filtre de groupe de fiches. |
INDEX2 |
Troisième attribut personnalisé de filtre de groupe de fiches. |
INDEX3 |
Quatrième attribut personnalisé de filtre de groupe de fiches. |
INDEX4 |
Attribut personnalisé de cinquième filtre de groupe de fiches. |
ProductItemId
Identifiant de l'article d'une offre.
Représentation JSON |
---|
{ "value": string } |
Champs | |
---|---|
value |
Valeur de l'identifiant. |
ProductType
Type d'une offre de produit.
Représentation JSON |
---|
{
"level": enum ( |
Champs | |
---|---|
level |
Niveau du type. |
value |
Valeur du type. |
ListingGroupFilterProductTypeLevel
Énumération décrivant le niveau du type d'une offre de produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
LEVEL1 |
Niveau 1. |
LEVEL2 |
Niveau 2. |
LEVEL3 |
Niveau 3. |
LEVEL4 |
Niveau 4. |
LEVEL5 |
Niveau 5. |
ListingGroupFilterDimensionPath
Chemin définissant les dimensions définissant un filtre de groupe de fiches.
Représentation JSON |
---|
{
"dimensions": [
{
object ( |
Champs | |
---|---|
dimensions[] |
Chemin complet des dimensions dans la hiérarchie des filtres de groupe de fiches (à l'exclusion du nœud racine) jusqu'à ce filtre de groupe de fiches. |
AssetGroupTopCombinationView
Vue sur l'utilisation d'une combinaison de composants d'annonce d'un groupe d'annonces.
Représentation JSON |
---|
{
"resourceName": string,
"assetGroupTopCombinations": [
{
object ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue des combinaisons principales du groupe d'assets. Les noms des ressources de la vue des combinaisons principales AssetGroup ont le format suivant : "customers/{customerId}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}". |
assetGroupTopCombinations[] |
Meilleures combinaisons d'assets diffusés ensemble. |
AssetGroupAssetCombinationData
Données sur les combinaisons de composants du groupe d'assets
Représentation JSON |
---|
{
"assetCombinationServedAssets": [
{
object ( |
Champs | |
---|---|
assetCombinationServedAssets[] |
Éléments diffusés. |
AssetUsage
Contient les informations sur l'utilisation de l'asset.
Représentation JSON |
---|
{
"asset": string,
"servedAssetFieldType": enum ( |
Champs | |
---|---|
asset |
Nom de ressource de l'élément. |
servedAssetFieldType |
Type de champ diffusé de l'élément. |
ServedAssetFieldType
Types de champs d'éléments possibles.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
HEADLINE_1 |
Il est utilisé dans le titre 1. |
HEADLINE_2 |
Il est utilisé dans le titre 2. |
HEADLINE_3 |
Il est utilisé dans le titre 3. |
DESCRIPTION_1 |
Il est utilisé dans la description 1. |
DESCRIPTION_2 |
Il est utilisé dans la description 2. |
HEADLINE |
L'asset a été utilisé dans un titre. N'utilisez cette option que s'il n'y a qu'un seul titre dans l'annonce. Sinon, utilisez les énumérations HEADLINE_1, HEADLINE_2 ou HEADLINE_3. |
HEADLINE_IN_PORTRAIT |
L'asset a été utilisé comme titre dans l'image en mode portrait. |
LONG_HEADLINE |
L'élément a été utilisé dans un titre long (utilisé dans une annonce responsive multi-élément). |
DESCRIPTION |
L'asset a été utilisé dans une description. N'utilisez cette option que s'il n'y a qu'une seule description dans l'annonce. Sinon, utilisez les énumérations DESCRIPTION_1 ou DESCRIPTION_@. |
DESCRIPTION_IN_PORTRAIT |
L'asset a été utilisé comme description dans l'image en mode portrait. |
BUSINESS_NAME_IN_PORTRAIT |
L'asset a été utilisé comme nom de l'entreprise dans l'image en mode portrait. |
BUSINESS_NAME |
Le composant a été utilisé comme nom de l'entreprise. |
MARKETING_IMAGE |
L'asset a été utilisé comme image marketing. |
MARKETING_IMAGE_IN_PORTRAIT |
L'asset a été utilisé comme image marketing en mode portrait. |
SQUARE_MARKETING_IMAGE |
L'asset a été utilisé comme image marketing carrée. |
PORTRAIT_MARKETING_IMAGE |
L'asset a été utilisé en tant qu'image marketing en mode portrait. |
LOGO |
L'élément a été utilisé comme logo. |
LANDSCAPE_LOGO |
L'asset a été utilisé en tant que logo en mode paysage. |
CALL_TO_ACTION |
Le composant a été utilisé comme incitation à l'action. |
YOU_TUBE_VIDEO |
L'élément a été utilisé en tant que vidéo YouTube. |
SITELINK |
Ce composant est utilisé comme lien annexe. |
CALL |
Ce composant est utilisé comme appel. |
MOBILE_APP |
Ce composant est utilisé comme application mobile. |
CALLOUT |
Ce composant est utilisé comme accroche. |
STRUCTURED_SNIPPET |
Ce composant est utilisé comme extrait structuré. |
PRICE |
Ce composant est utilisé comme prix. |
PROMOTION |
Ce composant est utilisé en tant que promotion. |
AD_IMAGE |
Cet asset est utilisé en tant qu'image. |
LEAD_FORM |
Le composant est utilisé comme formulaire pour prospects. |
BUSINESS_LOGO |
L'asset est utilisé comme logo d'entreprise. |
AssetGroup
Un groupe d'assets AssetGroupAsset permet d'associer un élément au groupe d'assets. AssetGroupSignal permet d'associer un signal à un groupe d'assets.
Représentation JSON |
---|
{ "resourceName": string, "id": string, "campaign": string, "name": string, "finalUrls": [ string ], "finalMobileUrls": [ string ], "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du groupe d'assets. Les noms de ressources du groupe d'assets se présentent comme suit:
|
id |
ID du groupe d'assets. |
campaign |
Campagne à laquelle ce groupe d'assets est associé. Asset associé au groupe d'assets. |
name |
Obligatoire. Nom du groupe d'assets. Obligatoire. Il doit comporter entre 1 et 128 caractères. Il doit être unique dans une campagne. |
finalUrls[] |
Liste des URL finales après toutes les redirections vers un autre domaine. Dans Performance Max, les URL peuvent être étendues par défaut, sauf si vous désactivez cette fonctionnalité. |
finalMobileUrls[] |
Liste des URL finales pour mobile après toutes les redirections vers un autre domaine. Dans Performance Max, les URL peuvent être étendues par défaut, sauf si vous désactivez cette fonctionnalité. |
status |
État du groupe d'assets. |
path1 |
Première partie du texte susceptible d'être ajoutée à l'URL affichée dans l'annonce. |
path2 |
Deuxième partie de texte susceptible d'être ajoutée à l'URL affichée dans l'annonce. Ce champ ne peut être défini que si "path1" est défini. |
adStrength |
Efficacité globale de l'annonce de ce groupe d'assets. |
AssetGroupStatus
États possibles d'un groupe d'assets.
Enums | |
---|---|
UNSPECIFIED |
L'état n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. |
ENABLED |
Le groupe d'assets est activé. |
PAUSED |
Le groupe d'assets est en veille. |
REMOVED |
Le groupe d'assets est supprimé. |
AdStrength
Énumération listant les forces possibles de l'annonce.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
PENDING |
L'efficacité de l'annonce est actuellement en attente. |
NO_ADS |
Aucune annonce n'a pu être générée. |
POOR |
Force médiocre. |
AVERAGE |
Force moyenne. |
GOOD |
Excellente force. |
EXCELLENT |
Excellente force. |
AssetSetAsset
AssetSetAsset est le lien entre un élément et un ensemble d'éléments. En ajoutant un élément AssetSetAsset, vous associez un élément à un ensemble d'éléments.
Représentation JSON |
---|
{
"resourceName": string,
"assetSet": string,
"asset": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'élément de l'ensemble d'éléments. Les noms de ressources d'éléments de l'ensemble d'éléments se présentent comme suit:
|
assetSet |
Ensemble d'éléments auquel cet élément d'ensemble d'éléments est associé. |
asset |
Élément auquel l'ensemble d'éléments est associé. |
status |
État de l'élément de l'ensemble d'assets. En lecture seule. |
AssetSetAssetStatus
États possibles d'un composant d'ensemble d'assets.
Enums | |
---|---|
UNSPECIFIED |
L'état n'a pas été spécifié. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
L'élément de l'ensemble d'assets est activé. |
REMOVED |
Le composant de l'ensemble d'assets est supprimé. |
AssetSet
Ensemble d'éléments représentant une collection d'éléments. Utilisez AssetSetAsset pour associer un élément à l'ensemble d'assets.
Représentation JSON |
---|
{ "id": string, "resourceName": string } |
Champs | |
---|---|
id |
ID de l'ensemble d'éléments. |
resourceName |
Nom de ressource de l'ensemble d'éléments. Les noms de ressources de l'ensemble d'éléments se présentent comme suit:
|
BiddingStrategy
Une stratégie d'enchères.
Représentation JSON |
---|
{ "resourceName": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la stratégie d'enchères. Les noms de ressources de stratégie d'enchères se présentent comme suit:
|
status |
État de la stratégie d'enchères. Ce champ est en lecture seule. |
type |
Type de stratégie d'enchères. Créez une stratégie d'enchères en définissant le schéma d'enchères. Ce champ est en lecture seule. |
currencyCode |
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. Elle est définie par défaut sur celle du client administrateur. Pour les clients de livraison, ce champ ne peut pas être défini. toutes les stratégies d'un client actif utilisent implicitement la devise de ce client. Dans tous les cas, le champ effectiveCurrencyCode affiche la devise utilisée par la stratégie. |
id |
ID de la stratégie d'enchères. |
name |
Nom de la stratégie d'enchères. Toutes les stratégies d'enchères d'un compte doivent être nommées séparément. La longueur de cette chaîne doit être comprise entre 1 et 255 caractères inclus, en octets UTF-8 (tronquée). |
effectiveCurrencyCode |
Devise utilisée par la stratégie d'enchères (code à trois lettres ISO 4217). Pour les stratégies d'enchères dans les comptes administrateur, il s'agit de la devise définie par l'annonceur lors de la création de la stratégie. Pour les clients actifs, il s'agit du codecurrencyCode du client. Les métriques de stratégie d'enchères sont enregistrées dans cette devise. Ce champ est en lecture seule. |
campaignCount |
Nombre de campagnes associées à cette stratégie d'enchères. Ce champ est en lecture seule. |
nonRemovedCampaignCount |
Nombre de campagnes non supprimées associées à cette stratégie d'enchères. Ce champ est en lecture seule. |
Champ d'union Vous ne pouvez en définir qu'une seule. |
|
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 diminue pour les clics qui semblent moins probables. |
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. |
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. |
targetCpa |
Il s'agit d'une stratégie d'enchères qui définit vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous spécifiez. |
targetImpressionShare |
Il s'agit d'une stratégie d'enchères qui optimise automatiquement les enchères en fonction d'un pourcentage donné d'impressions. |
targetOutrankShare |
Il s'agit d'une stratégie d'enchères qui définit des enchères en fonction de la fraction cible d'enchères pour lesquelles 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 mutations vers des stratégies dans lesquelles ce schéma est déjà renseigné sont autorisées. |
targetRoas |
Il s'agit d'une stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen spécifique. |
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. |
BiddingStrategyStatus
États possibles d'une stratégie d'enchères.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
La stratégie d'enchères est activée. |
REMOVED |
La stratégie d'enchères est supprimée. |
BiddingStrategyType
Énumération décrivant les types de stratégies d'enchères possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
COMMISSION |
Les commissions sont une stratégie d'enchères automatiques selon laquelle l'annonceur paie une partie spécifique de la valeur de conversion. |
ENHANCED_CPC |
La stratégie d'enchères "CPC optimisé" 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 probables. |
INVALID |
Utilisé pour la valeur renvoyée uniquement. Indique qu'une campagne ne comporte aucune stratégie d'enchères. Dans ce cas, la campagne ne peut pas être diffusée. Par exemple, si une campagne est associée à une stratégie d'enchères administrateur, le compte de diffusion est ensuite dissocié du compte administrateur. Dans ce cas, la campagne sera automatiquement dissociée de la stratégie d'enchères administrateur désormais inaccessible et passera au type de stratégie d'enchères "NON VALIDE". |
MANUAL_CPA |
Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère par action spécifiée par l'annonceur. |
MANUAL_CPC |
Système d'enchères manuel basé sur les clics, où l'utilisateur paie par clic. |
MANUAL_CPM |
Enchères manuelles basées sur les impressions, où l'utilisateur paie pour mille impressions |
MANUAL_CPV |
Il s'agit d'une stratégie d'enchères qui paie un montant configurable par visionnage de vidéo. |
MAXIMIZE_CONVERSIONS |
Il s'agit d'une stratégie d'enchères qui maximise automatiquement le nombre de conversions en fonction d'un budget quotidien. |
MAXIMIZE_CONVERSION_VALUE |
Il s'agit d'une stratégie d'enchères automatiques qui définit automatiquement les enchères pour maximiser les revenus tout en dépensant la totalité de votre budget. |
PAGE_ONE_PROMOTED |
Système d'enchères "Page 1 sponsorisée", qui définit les enchères au CPC max. afin de cibler les impressions sur les emplacements sponsorisés sur la première ou la première page sur google.fr. Cette valeur d'énumération est obsolète. |
PERCENT_CPC |
Le CPC au pourcentage est une stratégie d'enchères dans laquelle les enchères sont une fraction du prix annoncé d'un bien ou d'un service. |
TARGET_CPA |
Le CPA cible est 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. |
TARGET_CPM |
Le CPM cible est une stratégie d'enchères automatiques qui définit vos enchères afin de générer autant d'impressions que possible pour le coût pour mille impressions (CPM) cible que vous spécifiez. |
TARGET_IMPRESSION_SHARE |
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). |
TARGET_OUTRANK_SHARE |
La stratégie d'enchères automatiques "Taux de surclassement cible" définit des enchères en fonction de la fraction cible d'enchères pour lesquelles l'annonceur doit surclasser un concurrent spécifique. Cette valeur d'énumération est obsolète. |
TARGET_ROAS |
Le ROAS cible est une stratégie d'enchères automatiques qui vous aide à maximiser vos revenus tout en atteignant un retour sur les dépenses moyennes (ROAS) cible moyen. |
TARGET_SPEND |
L'objectif de dépenses est une 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. |
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. Utilisez ManualCpc avec EnhancedCpcEnabled défini sur "true" pour des fonctionnalités équivalentes.
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.
Représentation JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetRoas": number } |
Champs | |
---|---|
cpcBidCeilingMicros |
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. |
cpcBidFloorMicros |
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. |
targetRoas |
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.
Représentation JSON |
---|
{ "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string, "targetCpaMicros": string } |
Champs | |
---|---|
cpcBidCeilingMicros |
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. |
cpcBidFloorMicros |
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. |
targetCpaMicros |
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. |
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.
Représentation JSON |
---|
{ "targetCpaMicros": string, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Champs | |
---|---|
targetCpaMicros |
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. |
cpcBidCeilingMicros |
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. |
cpcBidFloorMicros |
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. |
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.
Représentation JSON |
---|
{ "targetRoas": number, "cpcBidCeilingMicros": string, "cpcBidFloorMicros": string } |
Champs | |
---|---|
targetRoas |
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. |
cpcBidCeilingMicros |
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. |
cpcBidFloorMicros |
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.
Représentation JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Champs | |
---|---|
targetSpendMicros |
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. |
cpcBidCeilingMicros |
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. |
CampaignBudget
Un budget de campagne.
Représentation JSON |
---|
{ "resourceName": string, "deliveryMethod": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du budget de la campagne. Les noms de ressources de budget de campagne se présentent comme suit:
|
deliveryMethod |
Mode de diffusion qui détermine la fréquence à laquelle le budget de la campagne est dépensé. La valeur par défaut est STANDARD si elle n'est pas spécifiée lors d'une opération de création. |
period |
Période au cours de laquelle dépenser le budget. En l'absence de spécification, la valeur par défaut est DAILY. |
amountMicros |
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. |
BudgetDeliveryMethod
Modes de diffusion possibles d'un budget.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
STANDARD |
Le serveur du budget limitera la diffusion de manière uniforme sur l'ensemble de la période. |
ACCELERATED |
Le serveur du budget ne limitera pas la diffusion, et les annonces seront diffusées aussi rapidement que possible. |
BudgetPeriod
Période possible d'un budget.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
DAILY |
Budget quotidien. |
FIXED_DAILY |
Budget quotidien fixe. |
CUSTOM_PERIOD |
Vous pouvez utiliser un budget personnalisé avec "total_amount" pour spécifier la limite de budget pour la durée de vie. |
Campagne
Une campagne.
Représentation JSON |
---|
{ "resourceName": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la campagne. Les noms de ressources de campagne se présentent comme suit:
|
status |
État de la campagne. Lorsqu'une campagne est ajoutée, l'état par défaut est ACTIVÉ. |
servingStatus |
État de diffusion des annonces de la campagne. |
biddingStrategySystemStatus |
État système de la stratégie d'enchères de la campagne. |
adServingOptimizationStatus |
État d'optimisation de la diffusion des annonces de la campagne. |
advertisingChannelType |
Cible de diffusion principale pour les annonces de la campagne. Vous pouvez affiner les options de ciblage dans Ce champ est obligatoire. Il doit être renseigné lors de la création de campagnes. Ne peut être défini que lors de la création de campagnes. Une fois la campagne créée, le champ ne peut plus être modifié. |
advertisingChannelSubType |
Affinement facultatif pour 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é. |
urlCustomParameters[] |
Liste des mappages utilisés pour remplacer les balises de paramètres personnalisés dans un élément |
realTimeBiddingSetting |
Paramètres des enchères en temps réel (fonctionnalité disponible uniquement pour les campagnes ciblant le réseau Ad Exchange). |
networkSettings |
Paramètres des réseaux de la campagne. |
dynamicSearchAdsSetting |
Paramètre permettant de contrôler les annonces dynamiques du Réseau de Recherche (ADR). |
shoppingSetting |
Paramètre permettant de contrôler les campagnes Shopping. |
geoTargetTypeSetting |
Paramètre de ciblage géographique des annonces. |
labels[] |
Noms de ressource des étiquettes associées à cette campagne. |
biddingStrategyType |
Type de stratégie d'enchères. Pour créer une stratégie d'enchères, vous pouvez définir soit le schéma d'enchères pour créer une stratégie d'enchères standard, soit le champ Ce champ est en lecture seule. |
accessibleBiddingStrategy |
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 "biddingStrategy". Vide si la campagne n'utilise pas de stratégie de portefeuille. Les attributs de stratégie sans restriction sont disponibles pour tous les clients avec lesquels la stratégie est partagée et sont lus à partir de la ressource AccessibleBiddingStrategy. En revanche, les attributs restreints ne sont disponibles que pour le client propriétaire de la stratégie et ses responsables. Les attributs restreints ne peuvent être lus qu'à partir de la ressource BiddingStrategy. |
frequencyCaps[] |
Liste qui limite la fréquence à laquelle chaque utilisateur verra les annonces de cette campagne. |
selectiveOptimization |
Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion pour l'optimiser. 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. |
optimizationGoalSetting |
Paramètre d'objectif d'optimisation pour cette campagne, qui inclut un ensemble de types d'objectifs d'optimisation. |
trackingSetting |
Paramètres au niveau de la campagne pour les informations de suivi. |
engineId |
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". |
excludedParentAssetFieldTypes[] |
Types de champs de composants à exclure de cette campagne. Les liens d'asset avec ces types de champs ne seront pas hérités par cette campagne à partir du niveau supérieur. |
createTime |
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". . createTime sera abandonné dans la v1. Utilisez createTime à la place. |
creationTime |
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". |
lastModifiedTime |
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 |
Identifiant de la campagne. |
name |
Nom de la campagne. Ce champ est obligatoire. Il doit être renseigné lors de la création de campagnes. Il ne doit contenir aucun caractère nul (point de code 0x0), de saut de ligne NL (point de code 0xA) ni de retour chariot (point de code 0xD). |
trackingUrlTemplate |
Modèle d'URL permettant de créer une URL de suivi. |
campaignBudget |
Budget de la campagne. |
startDate |
Date à laquelle la diffusion de la campagne a commencé dans le fuseau horaire du client au format AAAA-MM-JJ. |
endDate |
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. |
finalUrlSuffix |
Suffixe utilisé pour ajouter des paramètres de requête aux pages de destination diffusées avec le suivi en parallèle. |
urlExpansionOptOut |
Représente la désactivation de l'extension d'URL pour des URL plus ciblées. Si cette option est désactivée (vrai), seules les URL finales du groupe d'assets ou les URL spécifiées dans les flux de données d'entreprise ou Google Merchant Center de l'annonceur sont ciblées. Si cette option est activée (false), le domaine entier sera ciblé. Ce champ ne peut être défini que pour les campagnes Performance Max, où la valeur par défaut est "false". |
Champ d'union Il doit s'agir d'un portefeuille (créé via le service BiddingStrategy) ou d'un portefeuille standard intégré à la campagne. |
|
biddingStrategy |
Stratégie de portefeuille d'enchères utilisée par la campagne. |
manualCpa |
Stratégie d'enchères au CPA manuelles standard. Stratégie d'enchères manuelles qui permet à l'annonceur de définir l'enchère par action spécifiée par l'annonceur. Disponible uniquement pour les campagnes Local Services. |
manualCpc |
Stratégie d'enchères au CPC manuelles standard. Enchères manuelles basées sur les clics, où l'utilisateur paie par clic. |
manualCpm |
Stratégie d'enchères au CPM manuelles standard. Enchères manuelles basées sur les impressions, où l'utilisateur paie pour mille impressions |
maximizeConversions |
Stratégie d'enchères standard "Maximiser les conversions" qui maximise automatiquement le nombre de conversions tout en dépensant la totalité de votre budget. |
maximizeConversionValue |
Stratégie d'enchères standard "Maximiser la valeur de conversion" qui définit automatiquement les enchères pour maximiser les revenus tout en dépensant la totalité de votre budget. |
targetCpa |
Stratégie d'enchères standard au CPA cible, qui définit automatiquement vos enchères de sorte que vous enregistriez autant de conversions que possible pour le coût par acquisition (CPA) cible que vous spécifiez. |
targetImpressionShare |
Stratégie d'enchères "Taux d'impressions cible". Il s'agit d'une stratégie d'enchères automatiques qui définit les enchères de façon à atteindre un pourcentage donné d'impressions. |
targetRoas |
Stratégie d'enchères standard au ROAS cible qui maximise automatiquement les revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) spécifique moyen. |
targetSpend |
Cette stratégie d'enchères standard définit automatiquement vos enchères de sorte que vous enregistriez autant de clics que possible dans les limites de votre budget. |
percentCpc |
Stratégie d'enchères au CPC standard au pourcentage, dans laquelle les enchères sont une fraction du prix annoncé d'un bien ou d'un service. |
targetCpm |
Il s'agit d'une stratégie d'enchères qui optimise automatiquement le coût pour mille impressions. |
CampaignStatus
États possibles d'une campagne.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ENABLED |
La campagne est active et peut diffuser des annonces. |
PAUSED |
La campagne a été mise en veille par l'utilisateur. |
REMOVED |
La campagne a été supprimée. |
CampaignServingStatus
États de diffusion possibles d'une campagne.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
SERVING |
Inférence. |
NONE |
Aucun |
ENDED |
Terminé. |
PENDING |
En attente. |
SUSPENDED |
Suspendu. |
BiddingStrategySystemStatus
États système possibles d'une stratégie d'enchères.
Enums | |
---|---|
UNSPECIFIED |
Indique qu'une erreur inattendue s'est produite (par exemple, aucun type de stratégie d'enchères n'a été trouvé ou aucune information sur l'état n'a été trouvée). |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ENABLED |
La stratégie d'enchères est active et le système AdWords ne détecte aucun problème particulier à son sujet. |
LEARNING_NEW |
La stratégie d'enchères est en phase d'apprentissage, car elle a été créée ou réactivée récemment. |
LEARNING_SETTING_CHANGE |
La stratégie d'enchères est en phase d'apprentissage en raison d'un changement récent de paramètre. |
LEARNING_BUDGET_CHANGE |
La stratégie d'enchères est en phase d'apprentissage en raison d'une modification récente du budget. |
LEARNING_COMPOSITION_CHANGE |
La stratégie d'enchères est en phase d'apprentissage en raison d'une modification récente du nombre de campagnes, de groupes d'annonces ou de mots clés associés. |
LEARNING_CONVERSION_TYPE_CHANGE |
La stratégie d'enchères dépend des rapports sur les conversions et du client qui a récemment modifié les types de conversion pertinents pour la stratégie d'enchères. |
LEARNING_CONVERSION_SETTING_CHANGE |
La stratégie d'enchères dépend des rapports sur les conversions, et le client a récemment modifié ses paramètres de conversion. |
LIMITED_BY_CPC_BID_CEILING |
La stratégie d'enchères est limitée par son plafond d'enchères. |
LIMITED_BY_CPC_BID_FLOOR |
La stratégie d'enchères est limitée par son plancher d'enchères. |
LIMITED_BY_DATA |
La stratégie d'enchères est limitée, car le trafic de conversion n'a pas été suffisant au cours des dernières semaines. |
LIMITED_BY_BUDGET |
Une part significative des mots clés de cette stratégie d'enchères est limitée par le budget. |
LIMITED_BY_LOW_PRIORITY_SPEND |
La stratégie d'enchères ne peut pas atteindre son objectif de dépenses, car la priorité de ses dépenses a été inférieure. |
LIMITED_BY_LOW_QUALITY |
Une part significative des mots clés de cette stratégie d'enchères présente un faible niveau de qualité. |
LIMITED_BY_INVENTORY |
La stratégie d'enchères ne peut pas dépenser l'intégralité de son budget en raison d'un ciblage restreint. |
MISCONFIGURED_ZERO_ELIGIBILITY |
Il manque le suivi des conversions (aucun ping présent) et/ou des listes de remarketing pour les CSI. |
MISCONFIGURED_CONVERSION_TYPES |
La stratégie d'enchères dépend des rapports sur les conversions, et le client ne dispose pas de types de conversion qui pourraient être enregistrés avec cette stratégie. |
MISCONFIGURED_CONVERSION_SETTINGS |
La stratégie d'enchères dépend des rapports sur les conversions, et les paramètres de conversion du client sont mal configurés. |
MISCONFIGURED_SHARED_BUDGET |
Des campagnes externes à la stratégie d'enchères partagent un budget avec des campagnes incluses dans la stratégie. |
MISCONFIGURED_STRATEGY_TYPE |
Le type de stratégie de la campagne n'est pas valide et n'est pas diffusée. |
PAUSED |
La stratégie d'enchères n'est pas active. La stratégie d'enchères n'est associée à aucune campagne, aucun groupe d'annonces ni aucun mot clé actifs. ou aucun budget actif n'est associé à la stratégie d'enchères. |
UNAVAILABLE |
Cette stratégie d'enchères ne permet actuellement pas la création de rapports d'état. |
MULTIPLE_LEARNING |
Plusieurs états système LEARNING_* ont été associés à cette stratégie d'enchères au cours de la période en question. |
MULTIPLE_LIMITED |
Plusieurs états système (LIMITED_*) ont été définis pour cette stratégie d'enchères pendant la période en question. |
MULTIPLE_MISCONFIGURED |
Plusieurs états système MISCONFIGURED_* ont été associés à cette stratégie d'enchères pendant la période en question. |
MULTIPLE |
Plusieurs états système ont été définis pour cette stratégie d'enchères au cours de la période concernée. |
AdServingOptimizationStatus
Énumération décrivant les états de diffusion possibles.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
OPTIMIZE |
La diffusion des annonces est optimisée en fonction du CTR de la campagne. |
CONVERSION_OPTIMIZE |
La diffusion des annonces est optimisée en fonction du CTR * conversion de la campagne. Si la campagne ne fait pas partie de la stratégie d'enchères de l'Optimiseur de conversion, elle est définie par défaut sur OPTIMISÉE. |
ROTATE |
Les annonces sont alternées de manière régulière pendant 90 jours, puis optimisées pour les clics. |
ROTATE_INDEFINITELY |
Diffuser les annonces moins performantes de manière plus régulière avec les plus performantes, sans optimisation |
UNAVAILABLE |
L'état d'optimisation de la diffusion des annonces n'est pas disponible. |
AdvertisingChannelType
Énumération décrivant les différents types de canaux publicitaires.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
SEARCH |
Réseau de Recherche. Inclut les campagnes display groupées et les campagnes sur le Réseau de Recherche+. |
DISPLAY |
Réseau Display de Google uniquement. |
SHOPPING |
Les campagnes Shopping sont diffusées sur la propriété Shopping et dans les résultats de recherche de google.com. |
HOTEL |
les campagnes Hotel Ads. |
VIDEO |
Campagnes vidéo. |
MULTI_CHANNEL |
les campagnes pour applications et les campagnes pour applications axées sur l'engagement, diffusées sur plusieurs canaux. |
LOCAL |
les campagnes d'annonces locales. |
SMART |
Campagnes intelligentes |
PERFORMANCE_MAX |
Performance Max. |
LOCAL_SERVICES |
Campagnes Local Services. |
DISCOVERY |
Campagnes Discovery. |
TRAVEL |
Campagnes de voyage. |
SOCIAL |
Campagnes sur les réseaux sociaux. |
AdvertisingChannelSubType
Énumération décrivant les différents sous-types de canaux.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisée uniquement comme valeur renvoyée. Représente une valeur inconnue dans cette version. |
SEARCH_MOBILE_APP |
Campagnes pour applications mobiles pour le Réseau de Recherche |
DISPLAY_MOBILE_APP |
Campagnes pour applications mobiles pour le Réseau Display |
SEARCH_EXPRESS |
Campagnes AdWords Express pour le Réseau de Recherche |
DISPLAY_EXPRESS |
des campagnes AdWords Express pour le Réseau Display. |
SHOPPING_SMART_ADS |
les campagnes Shopping intelligentes. |
DISPLAY_GMAIL_AD |
Campagnes d'annonces Gmail. |
DISPLAY_SMART_CAMPAIGN |
Campagnes intelligentes sur le Réseau Display : Impossible de créer des campagnes de ce sous-type. |
VIDEO_OUTSTREAM |
les campagnes vidéo OutStream. |
VIDEO_ACTION |
les campagnes vidéo TrueView pour l'action. |
VIDEO_NON_SKIPPABLE |
Les campagnes vidéo comportant des annonces vidéo non désactivables. |
APP_CAMPAIGN |
Les campagnes pour applications vous permettent de promouvoir facilement votre application Android ou iOS sur les principales propriétés de Google, dont le Réseau de Recherche, Google Play, YouTube et le Réseau Display de Google. |
APP_CAMPAIGN_FOR_ENGAGEMENT |
Campagne pour applications axée sur l'engagement visant à susciter un nouvel intérêt pour votre application sur plusieurs des principales propriétés de Google, dont le Réseau de Recherche, YouTube et le Réseau Display de Google. |
LOCAL_CAMPAIGN |
Campagnes spécialisées dans la publicité locale. |
SHOPPING_COMPARISON_LISTING_ADS |
Campagnes de type "Fiche du service de comparateur de prix" |
SMART_CAMPAIGN |
les campagnes intelligentes standards. |
VIDEO_SEQUENCE |
Campagnes vidéo avec des annonces vidéo de séquencement |
APP_CAMPAIGN_FOR_PRE_REGISTRATION |
Campagne pour applications axée sur la préinscription, spécialisée dans la publicité pour la préinscription à des applications mobiles, qui cible plusieurs canaux publicitaires sur Google Play, YouTube et le Réseau Display. |
VIDEO_REACH_TARGET_FREQUENCY |
Campagne vidéo axée sur la couverture avec une stratégie d'enchères avec fréquence cible |
TRAVEL_ACTIVITIES |
Activités de voyage. |
SOCIAL_FACEBOOK_TRACKING_ONLY |
Suivi Facebook uniquement pour les campagnes sur les réseaux sociaux. |
CustomParameter
Mappage pouvant être utilisé par les tags de paramètres personnalisés dans un élément trackingUrlTemplate
, finalUrls
ou mobile_final_urls
.
Représentation JSON |
---|
{ "key": string, "value": string } |
Champs | |
---|---|
key |
Clé correspondant au nom du tag de paramètre. |
value |
Valeur à remplacer. |
RealTimeBiddingSetting
Paramètres des enchères en temps réel (fonctionnalité disponible uniquement pour les campagnes ciblant le réseau Ad Exchange).
Représentation JSON |
---|
{ "optIn": boolean } |
Champs | |
---|---|
optIn |
Indique si les enchères en temps réel sont activées pour la campagne. |
NetworkSettings
Paramètres des réseaux de la campagne.
Représentation JSON |
---|
{ "targetGoogleSearch": boolean, "targetSearchNetwork": boolean, "targetContentNetwork": boolean, "targetPartnerSearchNetwork": boolean } |
Champs | |
---|---|
targetGoogleSearch |
Indique si les annonces seront diffusées avec les résultats de recherche google.com. |
targetSearchNetwork |
Indique si les annonces seront diffusées sur les sites partenaires du Réseau de Recherche de Google ( |
targetContentNetwork |
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. |
targetPartnerSearchNetwork |
Indique si des annonces seront diffusées sur le réseau Google Partners. Cette option n'est disponible que pour certains comptes partenaires Google. |
DynamicSearchAdsSetting
Paramètre permettant de contrôler les annonces dynamiques du Réseau de Recherche (ADR).
Représentation JSON |
---|
{ "domainName": string, "languageCode": string, "useSuppliedUrlsOnly": boolean } |
Champs | |
---|---|
domainName |
Obligatoire. Nom de domaine Internet représenté par ce paramètre, par exemple "google.com". ou "www.google.com". |
languageCode |
Obligatoire. Code de langue spécifiant la langue du domaine (par exemple, "en"). |
useSuppliedUrlsOnly |
Indique si la campagne utilise exclusivement les URL fournies par l'annonceur. |
ShoppingSetting
Paramètre des campagnes Shopping. Définit l'ensemble des produits dont la campagne peut faire la promotion et la manière dont celle-ci interagit avec les autres campagnes Shopping.
Représentation JSON |
---|
{ "feedLabel": string, "useVehicleInventory": boolean, "merchantId": string, "salesCountry": string, "campaignPriority": integer, "enableLocal": boolean } |
Champs | |
---|---|
feedLabel |
Libellé du flux des produits à inclure dans la campagne. Vous ne pouvez définir qu'un seul élément feedLabel ou salesCountry. S'il est utilisé à la place de salesCountry, le champ feedLabel accepte les codes pays au 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. |
useVehicleInventory |
Permet de cibler ou non l'inventaire des véhicules. |
merchantId |
ID du compte Merchant Center. Ce champ est obligatoire pour créer des opérations. Ce champ ne peut pas être modifié pour les campagnes Shopping. |
salesCountry |
Pays de vente des produits à inclure dans la campagne. |
campaignPriority |
Priorité de la campagne. Les campagnes dont le niveau de priorité est numériquement plus élevé prévalent sur celles dont le niveau de priorité est inférieur. Ce champ est obligatoire pour les campagnes Shopping et ses valeurs sont comprises entre 0 et 2 inclus. Ce champ est facultatif pour les campagnes Shopping intelligentes, mais sa valeur doit être égale à 3 s'il est défini. |
enableLocal |
Permet d'inclure ou non les produits en magasin. |
GeoTargetTypeSetting
Représente un ensemble de paramètres liés au ciblage géographique des annonces.
Représentation JSON |
---|
{ "positiveGeoTargetType": enum ( |
Champs | |
---|---|
positiveGeoTargetType |
Paramètre utilisé pour le ciblage géographique à inclure dans cette campagne spécifique. |
negativeGeoTargetType |
Paramètre utilisé pour le ciblage géographique à exclure dans cette campagne. |
PositiveGeoTargetType
Types de cibles géographiques à inclure possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
PRESENCE_OR_INTEREST |
Indique qu'une annonce est diffusée si l'utilisateur se trouve dans les zones ciblées par l'annonceur ou s'y intéresse. |
SEARCH_INTEREST |
Indique qu'une annonce est diffusée si l'utilisateur recherche les zones ciblées par l'annonceur. Il ne peut être utilisé qu'avec les campagnes Shopping standards et sur le Réseau de Recherche. |
PRESENCE |
Indique qu'une annonce est diffusée si l'utilisateur se trouve dans les zones ciblées par l'annonceur ou s'y rend régulièrement. |
NegativeGeoTargetType
Types de cibles géographiques à exclure possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
PRESENCE_OR_INTEREST |
Indique qu'un utilisateur ne peut pas voir l'annonce s'il se trouve dans les zones exclues de l'annonceur ou s'y intéressent. |
PRESENCE |
Indique qu'un utilisateur ne pourra pas voir l'annonce s'il se trouve dans les zones géographiques exclues de l'annonceur. |
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.
SelectiveOptimization
Paramètre d'optimisation sélective pour cette campagne, qui inclut un ensemble d'actions de conversion pour l'optimiser. 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.
Représentation JSON |
---|
{ "conversionActions": [ string ] } |
Champs | |
---|---|
conversionActions[] |
Ensemble d'actions de conversion sélectionné pour optimiser cette campagne. |
OptimizationGoalSetting
Paramètre d'objectif d'optimisation pour cette campagne, qui inclut un ensemble de types d'objectifs d'optimisation.
Représentation JSON |
---|
{
"optimizationGoalTypes": [
enum ( |
Champs | |
---|---|
optimizationGoalTypes[] |
Liste des types d'objectifs d'optimisation. |
OptimizationGoalType
Type d'objectif d'optimisation
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisée uniquement comme valeur renvoyée. Représente une valeur inconnue dans cette version. |
CALL_CLICKS |
Optimisez pour les clics d'appel. Les conversions après clic d'appel correspondent au nombre de fois où un utilisateur a sélectionné "Appeler" à contacter un magasin après avoir vu une annonce. |
DRIVING_DIRECTIONS |
Optimiser pour les itinéraires routiers. Les conversions d'itinéraires correspondent au nombre de fois où les utilisateurs ont sélectionné "Itinéraire" pour se rendre dans un magasin après avoir vu une annonce. |
APP_PRE_REGISTRATION |
Optimiser pour la préinscription. Les conversions de préinscription correspondent au nombre d'inscriptions à la préinscription qui recevront une notification lorsque l'application sera disponible. |
TrackingSetting
Paramètres au niveau de la campagne pour les informations de suivi.
Représentation JSON |
---|
{ "trackingUrl": string } |
Champs | |
---|---|
trackingUrl |
URL utilisée pour le suivi dynamique. |
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.
Représentation JSON |
---|
{ "enhancedCpcEnabled": boolean } |
Champs | |
---|---|
enhancedCpcEnabled |
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
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.
Représentation JSON |
---|
{ "cpcBidCeilingMicros": string, "enhancedCpcEnabled": boolean } |
Champs | |
---|---|
cpcBidCeilingMicros |
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. |
enhancedCpcEnabled |
À 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 cpcBidCeilingMicros, mais pas le montant moyen de l'enchère pour une campagne. |
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.
CampaignAsset
Lien entre une campagne et un élément.
Représentation JSON |
---|
{
"resourceName": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du composant de campagne. Les noms de ressources CampaignAsset sont au format suivant:
|
status |
État du composant de la campagne. |
campaign |
La campagne à laquelle l'élément est associé. |
asset |
L'élément associé à la campagne. |
CampaignAssetSet
CampaignAssetSet est le lien entre une campagne et un ensemble d'assets. L'ajout d'un CampaignAssetSet associe un ensemble d'éléments à une campagne.
Représentation JSON |
---|
{
"resourceName": string,
"campaign": string,
"assetSet": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'ensemble de composants de campagne. Les noms de ressources d'éléments de l'ensemble d'éléments se présentent comme suit:
|
campaign |
Campagne à laquelle cet ensemble de composants est associé. |
assetSet |
Ensemble de composants associé à la campagne. |
status |
État du composant de l'ensemble de composants de la campagne. En lecture seule. |
CampaignAudienceView
Vue d'audience d'une campagne. Comprend les données sur les performances issues des centres d'intérêt et des listes de remarketing pour les annonces sur les Réseaux Display et YouTube, et des listes de remarketing pour les annonces du Réseau de Recherche (RLSA), regroupées par campagne et par critère d'audience. Cette vue n'inclut que les audiences associées au niveau de la campagne.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
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:
|
CampaignCriterion
Un critère de campagne.
Représentation JSON |
---|
{ "resourceName": string, "displayName": string, "type": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du critère de campagne. Les noms de ressources des critères de campagne se présentent sous la forme suivante:
|
displayName |
Nom à afficher du critère. Ce champ est ignoré pour les opérations mutate. |
type |
Type du critère. |
status |
État du critère. |
lastModifiedTime |
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". |
criterionId |
ID du critère. Ce champ est ignoré lors de l'opération mutate. |
bidModifier |
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 |
Permet de cibler ( |
Champ d'union Vous ne devez en définir qu'un seul. |
|
keyword |
Mot clé. |
location |
Localisation. |
device |
appareil. |
ageRange |
Tranche d'âge. |
gender |
Gender. |
userList |
Liste d'utilisateurs. |
language |
HashiCorp. |
webpage |
Page Web. |
locationGroup |
Groupe de zones géographiques |
CampaignCriterionStatus
États possibles d'un "CampaignCritère".
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
Le critère de campagne est activé. |
PAUSED |
Le critère de campagne est mis en veille. |
REMOVED |
Le critère de la campagne est supprimé. |
LanguageInfo
Un critère de langue.
Représentation JSON |
---|
{ "languageConstant": string } |
Champs | |
---|---|
languageConstant |
Nom de ressource de la constante de langue. |
LocationGroupInfo
Rayon autour d'une liste de lieux spécifiés via un flux.
Représentation JSON |
---|
{
"geoTargetConstants": [
string
],
"radiusUnits": enum ( |
Champs | |
---|---|
geoTargetConstants[] |
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. |
radiusUnits |
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. |
feedItemSets[] |
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 geoTargetConstants. Cette étape est facultative et ne peut être définie que dans les opérations CREATE. |
radius |
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. |
LocationGroupRadiusUnits
Unité de distance du rayon dans le groupe de zones géographiques (par exemple, MILES)
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
METERS |
Mètres |
MILES |
Miles |
MILLI_MILES |
Milli miles |
CampaignLabel
Représente la relation entre une campagne et un libellé.
Représentation JSON |
---|
{ "resourceName": string, "campaign": string, "label": string } |
Champs | |
---|---|
resourceName |
Nom de la ressource. Les noms de ressources des libellés de campagne sont au format suivant: |
campaign |
Campagne à laquelle le libellé est associé. |
label |
Libellé attribué à la campagne. |
CartDataSalesView
Affichage des données du panier sur les ventes.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue des données du panier. Les noms des ressources de la vue des données du panier se présentent comme suit: |
Audience
L'audience constitue une option de ciblage efficace qui vous permet de croiser différents attributs de segment, tels que des données démographiques détaillées et des audiences d'affinité, afin de créer des audiences qui représentent des sections de vos segments cibles.
Représentation JSON |
---|
{ "resourceName": string, "id": string, "name": string, "description": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de l'audience. Les noms d'audience se présentent comme suit:
|
id |
ID de l'audience. |
name |
Obligatoire. Nom de l'audience. Il doit être unique pour toutes les audiences. Il doit comporter entre 1 et 255 caractères. |
description |
Description de cette audience. |
ConversionAction
Une action de conversion.
Représentation JSON |
---|
{ "resourceName": string, "creationTime": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'action de conversion. Les noms de ressources des actions de conversion se présentent comme suit:
|
creationTime |
Horodatage de la création de l'activité Floodlight, au format ISO 8601. |
status |
État de cette action de conversion pour le décompte des événements de conversion. |
type |
Type d'action de conversion. |
category |
Catégorie des conversions enregistrées pour cette action de conversion. |
valueSettings |
Paramètres liés à la valeur des événements de conversion associés à cette action de conversion. |
attributionModelSettings |
Paramètres associés au modèle d'attribution de cette action de conversion. |
floodlightSettings |
Paramètres Floodlight pour les types de conversion Floodlight. |
id |
ID de l'action de conversion. |
name |
Nom de l'action de conversion. Ce champ est obligatoire. Il doit être renseigné lors de la création d'actions de conversion. |
primaryForGoal |
Si le bit "primaryForGoal" d'une action de conversion est défini sur "false", l'action de conversion n'est pas enchérissable pour toutes les campagnes, quels que soient l'objectif de conversion de la campagne ou celui des clients. Toutefois, les objectifs de conversion personnalisés ne respectent pas primaryForGoal. Par conséquent, si un objectif de conversion personnalisé est configuré pour une campagne avec une action de conversion primaryForGoal = fausse, cette action de conversion est toujours enchérissable. Par défaut, la valeur "primaryForGoal" est définie sur "true" si cette règle n'est pas configurée. Dans V9, primaryForGoal ne peut être définie sur "false" qu'après la création via une "mise à jour" car elle n'est pas déclarée comme facultative. |
ownerCustomer |
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. |
includeInClientAccountConversionsMetric |
Indique si cette action de conversion doit être incluse dans "clientAccountConversions" la métrique. |
includeInConversionsMetric |
Indique si cette action de conversion doit être incluse dans les "conversions" la métrique. |
clickThroughLookbackWindowDays |
Nombre maximal de jours entre une interaction (un clic, par exemple) et un événement de conversion. |
appId |
ID d'application pour une action de conversion d'application. |
ConversionActionStatus
États possibles d'une action de conversion.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ENABLED |
Les conversions seront enregistrées. |
REMOVED |
Les conversions ne seront pas enregistrées. |
HIDDEN |
Les conversions ne seront pas enregistrées et l'action de conversion n'apparaîtra pas dans l'interface utilisateur. |
ConversionActionType
Types possibles d'une action de conversion.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
AD_CALL |
Conversions enregistrées lorsqu'un utilisateur clique sur l'extension d'appel d'une annonce. |
CLICK_TO_CALL |
Conversions enregistrées lorsqu'un utilisateur clique sur un numéro de téléphone depuis un appareil mobile. |
GOOGLE_PLAY_DOWNLOAD |
Conversions enregistrées lorsqu'un utilisateur télécharge une application mobile à partir du Google Play Store. |
GOOGLE_PLAY_IN_APP_PURCHASE |
Conversions enregistrées lorsqu'un utilisateur effectue un achat dans une application via la facturation Android. |
UPLOAD_CALLS |
Conversions par appel suivies par l'annonceur et importées. |
UPLOAD_CLICKS |
Conversions suivies par l'annonceur et importées avec des clics attribués. |
WEBPAGE |
Conversions se produisant sur une page Web. |
WEBSITE_CALL |
Conversions enregistrées lorsqu'un utilisateur appelle un numéro de téléphone généré dynamiquement depuis le site Web d'un annonceur. |
STORE_SALES_DIRECT_UPLOAD |
Conversion "ventes en magasin" basée sur les importations de données marchandes propriétaires ou tierces. Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types d'importation directe pour les ventes en magasin. |
STORE_SALES |
Conversion "ventes en magasin" basée sur les importations de données marchandes propriétaires ou tierces et/ou sur les achats en magasin effectués avec des cartes issues de réseaux de paiement. Seuls les clients figurant sur la liste d'autorisation peuvent utiliser les types de ventes en magasin. Lecture seule. |
FIREBASE_ANDROID_FIRST_OPEN |
Conversions de type "première ouverture" pour les applications Android suivies via Firebase. |
FIREBASE_ANDROID_IN_APP_PURCHASE |
Conversions d'achat via une application Android suivies via Firebase |
FIREBASE_ANDROID_CUSTOM |
Conversions personnalisées dans une application Android suivies via Firebase. |
FIREBASE_IOS_FIRST_OPEN |
Conversions liées à la première ouverture d'une application iOS suivies via Firebase. |
FIREBASE_IOS_IN_APP_PURCHASE |
Conversions d'achat via une application iOS suivies via Firebase |
FIREBASE_IOS_CUSTOM |
Conversions personnalisées des applications iOS suivies via Firebase. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_FIRST_OPEN |
Conversions à la première ouverture des applications Android suivies par un outil d'analyse d'applications tiers. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_IN_APP_PURCHASE |
Conversions d'achat d'applications via une application Android suivies via un outil d'analyse d'applications tiers. |
THIRD_PARTY_APP_ANALYTICS_ANDROID_CUSTOM |
Conversions personnalisées des applications Android suivies via un outil d'analyse d'applications tiers. |
THIRD_PARTY_APP_ANALYTICS_IOS_FIRST_OPEN |
Les conversions à la première ouverture des applications iOS suivies par un outil d'analyse d'applications tiers. |
THIRD_PARTY_APP_ANALYTICS_IOS_IN_APP_PURCHASE |
Les conversions d'achat via une application iOS suivies par un outil d'analyse d'applications tiers |
THIRD_PARTY_APP_ANALYTICS_IOS_CUSTOM |
Conversions personnalisées des applications iOS suivies via un outil d'analyse d'applications tiers. |
ANDROID_APP_PRE_REGISTRATION |
Conversions enregistrées lorsqu'un utilisateur se préinscrit à une application mobile depuis le Google Play Store. Lecture seule. |
ANDROID_INSTALLS_ALL_OTHER_APPS |
Il s'agit des conversions qui effectuent le suivi de tous les téléchargements Google Play qui ne sont pas suivis par un type spécifique à l'application. Lecture seule. |
FLOODLIGHT_ACTION |
Activité Floodlight qui compte le nombre de fois que les internautes ont consulté une page Web spécifique après avoir vu l'une des annonces d'un annonceur ou cliqué dessus. Lecture seule. |
FLOODLIGHT_TRANSACTION |
Activité Floodlight qui effectue le suivi du nombre de ventes réalisées ou du nombre d'articles achetés Elles permettent également de capturer la valeur totale de chaque vente. Lecture seule. |
GOOGLE_HOSTED |
Conversions qui suivent les actions locales dans les produits et services Google après avoir interagi avec une annonce. Lecture seule. |
LEAD_FORM_SUBMIT |
Les conversions sont enregistrées lorsqu'un utilisateur envoie un formulaire pour prospects. Lecture seule. |
SALESFORCE |
Conversions provenant de Salesforce. Lecture seule. |
SEARCH_ADS_360 |
Conversions importées à partir des données Floodlight Search Ads 360. Lecture seule. |
SMART_CAMPAIGN_AD_CLICKS_TO_CALL |
Conversions par appel générées par des annonces d'une campagne intelligente sans configuration de suivi des appels, utilisant des critères personnalisés de campagne intelligente. Lecture seule. |
SMART_CAMPAIGN_MAP_CLICKS_TO_CALL |
L'utilisateur clique sur un élément d'appel dans Google Maps. Campagne intelligente uniquement. Lecture seule. |
SMART_CAMPAIGN_MAP_DIRECTIONS |
L'utilisateur demande un itinéraire vers un établissement dans Google Maps. Campagne intelligente uniquement. Lecture seule. |
SMART_CAMPAIGN_TRACKED_CALLS |
Conversions par appel générées par des annonces d'une campagne intelligente avec une configuration du suivi des appels et utilisant des critères personnalisés de campagne intelligente. Lecture seule. |
STORE_VISITS |
Conversions enregistrées lorsqu'un utilisateur se rend dans le magasin d'un annonceur. Lecture seule. |
WEBPAGE_CODELESS |
Conversions créées à partir d'événements sur le site Web (envois de formulaires ou chargements de pages, par exemple) qui n'utilisent pas d'extraits d'événement codés individuellement. Lecture seule. |
UNIVERSAL_ANALYTICS_GOAL |
Conversions provenant d'objectifs Universal Analytics associés. |
UNIVERSAL_ANALYTICS_TRANSACTION |
Conversions provenant de transactions Universal Analytics associées. |
GOOGLE_ANALYTICS_4_CUSTOM |
Conversions provenant de conversions d'événements personnalisés Google Analytics 4 associés. |
GOOGLE_ANALYTICS_4_PURCHASE |
Conversions provenant de conversions d'achat Google Analytics 4 associées. |
ConversionActionCategory
Catégorie des conversions associées à une ConversionAction.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
DEFAULT |
Catégorie par défaut. |
PAGE_VIEW |
Utilisateur visitant une page. |
PURCHASE |
Achat, vente ou "commande passée" . |
SIGNUP |
Action de l'utilisateur lors de l'inscription. |
LEAD |
Action de génération de prospects. |
DOWNLOAD |
Action de téléchargement de logiciel (comme pour une application). |
ADD_TO_CART |
Ajout d'articles à un panier ou à un sac sur le site d'un annonceur. |
BEGIN_CHECKOUT |
Lorsqu'un utilisateur accède au processus de paiement sur le site d'un annonceur. |
SUBSCRIBE_PAID |
Début d'un abonnement payant à un produit ou à un service. |
PHONE_CALL_LEAD |
Appel indiquant qu'un annonceur est intéressé par son offre. |
IMPORTED_LEAD |
Une conversion de prospect importée dans Google Ads à partir d'une source externe. |
SUBMIT_LEAD_FORM |
Envoi d'un formulaire sur le site d'un annonceur indiquant un intérêt pour une entreprise. |
BOOK_APPOINTMENT |
Une prise de rendez-vous avec l'entreprise d'un annonceur. |
REQUEST_QUOTE |
Demande de devis ou d'estimation de prix. |
GET_DIRECTIONS |
Recherche de l'établissement d'un annonceur dans l'intention de s'y rendre |
OUTBOUND_CLICK |
Clic vers le site du partenaire d'un annonceur |
CONTACT |
Appel, SMS, e-mail, chat ou autre type de contact avec un annonceur. |
ENGAGEMENT |
Un événement d'engagement sur un site Web tel qu'une durée de vie du site longue ou un objectif intelligent Google Analytics (GA). Destiné à être utilisé pour les importations d'objectifs Or GA, Firebase et GA. |
STORE_VISIT |
Une visite dans un magasin physique |
STORE_SALE |
Une promotion a lieu dans un magasin physique. |
QUALIFIED_LEAD |
Une conversion de prospect importée dans Google Ads à partir d'une source externe, qui a été davantage qualifiée par l'annonceur (équipe marketing/commercial). Au cours du parcours entre le prospect et la vente, les annonceurs obtiennent des prospects, puis passent à l'action en s'adressant au consommateur. Si le consommateur est intéressé et est susceptible d'acheter son produit, l'annonceur marque ces prospects comme des "prospects qualifiés". |
CONVERTED_LEAD |
Une conversion de prospect importée dans Google Ads à partir d'une source externe, qui a en outre terminé une étape définie par l'annonceur souhaitant générer des prospects. |
ValueSettings
Paramètres liés à la valeur des événements de conversion associés à cette action de conversion.
Représentation JSON |
---|
{ "defaultValue": number, "defaultCurrencyCode": string, "alwaysUseDefaultValue": boolean } |
Champs | |
---|---|
defaultValue |
Valeur à utiliser lorsque les événements de conversion de 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 utiliser toujours la valeur par défaut. |
defaultCurrencyCode |
Code de devise à utiliser lorsque des événements de conversion pour cette action de conversion sont envoyés avec un code de devise non valide ou manquant, ou lorsque cette action de conversion est configurée pour toujours utiliser la valeur par défaut. |
alwaysUseDefaultValue |
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. |
AttributionModelSettings
Paramètres associés au modèle d'attribution de cette action de conversion.
Représentation JSON |
---|
{ "attributionModel": enum ( |
Champs | |
---|---|
attributionModel |
Type de modèle d'attribution de cette action de conversion. |
dataDrivenModelStatus |
État du modèle d'attribution basée sur les données pour l'action de conversion. |
AttributionModel
Modèle d'attribution qui décrit comment répartir le crédit d'une conversion donnée entre de nombreuses interactions antérieures (éventuellement)
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
EXTERNAL |
Utilise une attribution externe. |
GOOGLE_ADS_LAST_CLICK |
Attribue tout le crédit d'une conversion à son dernier clic. |
GOOGLE_SEARCH_ATTRIBUTION_FIRST_CLICK |
Attribue tout le crédit d'une conversion à son premier clic à l'aide de l'attribution sur le Réseau de Recherche de Google. |
GOOGLE_SEARCH_ATTRIBUTION_LINEAR |
Attribue le crédit d'une conversion de manière égale à tous ses clics grâce à l'attribution sur le Réseau de Recherche de Google. |
GOOGLE_SEARCH_ATTRIBUTION_TIME_DECAY |
Attribue de manière exponentielle plus de crédit à une conversion aux clics les plus récents à l'aide de l'attribution sur le Réseau de Recherche de Google (demi-vie : une semaine). |
GOOGLE_SEARCH_ATTRIBUTION_POSITION_BASED |
Attribue 40% du crédit d'une conversion à ses premiers et derniers clics Les 20% restants sont répartis uniformément entre tous les autres clics. L'attribution sur le Réseau de Recherche de Google est utilisée. |
GOOGLE_SEARCH_ATTRIBUTION_DATA_DRIVEN |
Modèle flexible qui utilise le machine learning pour déterminer la répartition appropriée du crédit entre les clics à l'aide de l'attribution sur le Réseau de Recherche de Google. |
DataDrivenModelStatus
Énumère les états des modèles basés sur les données.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
AVAILABLE |
Le modèle basé sur les données est disponible. |
STALE |
Le modèle basé sur les données est obsolète. Il n'a pas été mis à jour depuis au moins sept jours. Il est toujours en cours d'utilisation, mais expirera s'il n'est pas mis à jour pendant 30 jours. |
EXPIRED |
Le modèle basé sur les données a expiré. Il n'a pas été mis à jour depuis au moins 30 jours et ne peut pas être utilisé. Le plus souvent, cela est dû au fait que le nombre d'événements requis n'a pas été atteint au cours des 30 derniers jours. |
NEVER_GENERATED |
Le modèle basé sur les données n'a jamais été généré. Le plus souvent, cela est dû au fait que le nombre d'événements requis sur une période de 30 jours n'a jamais été atteint. |
FloodlightSettings
Paramètres associés à une action de conversion Floodlight.
Représentation JSON |
---|
{ "activityGroupTag": string, "activityTag": string, "activityId": string } |
Champs | |
---|---|
activityGroupTag |
Chaîne permettant d'identifier un groupe d'activités Floodlight lors de la création de rapports sur les conversions. |
activityTag |
Chaîne permettant d'identifier une activité Floodlight lors de la création de rapports sur les conversions. |
activityId |
ID de l'activité Floodlight dans DoubleClick Campaign Manager (DCM). |
ConversionCustomVariable
Une variable personnalisée de conversion Voir "À propos des métriques et des dimensions Floodlight personnalisées dans la nouvelle interface Search Ads 360" à l'adresse https://support.google.com/sa360/answer/13567857.
Représentation JSON |
---|
{ "resourceName": string, "id": string, "name": string, "tag": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la variable personnalisée de conversion. Les noms de ressources des variables personnalisées de conversion se présentent comme suit:
|
id |
ID de la variable personnalisée de conversion. |
name |
Obligatoire. Nom de la variable personnalisée de conversion. Le nom doit être unique. Le nom ne doit pas dépasser 100 caractères. Il ne doit pas y avoir d'espaces superflus avant et après. |
tag |
Obligatoire. Balise de la variable personnalisée de conversion. Le tag doit être unique et se composer d'un "u" directement suivi d'un nombre inférieur à 100. Exemple : "u4". |
status |
État de la variable personnalisée de conversion pour la comptabilisation des événements de conversion. |
ownerCustomer |
Nom de ressource du client propriétaire de la variable personnalisée de conversion. |
family |
Famille de la variable personnalisée de conversion |
cardinality |
Cardinalité de la variable personnalisée de conversion. |
floodlightConversionCustomVariableInfo |
Champs pour les variables personnalisées de conversion Floodlight Search Ads 360. |
customColumnIds[] |
ID des colonnes personnalisées qui utilisent cette variable personnalisée de conversion. |
ConversionCustomVariableStatus
États possibles d'une variable personnalisée de conversion.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ACTIVATION_NEEDED |
La variable personnalisée de conversion est en attente d'activation. Elle ne générera pas de statistiques tant qu'elle ne sera pas définie sur "ACTIVÉE". Cet état ne peut pas être utilisé dans les requêtes CREATE et UPDATE. |
ENABLED |
La variable personnalisée de conversion est activée et génère des statistiques. |
PAUSED |
La variable personnalisée de conversion est en veille et ne générera pas de statistiques tant qu'elle ne sera pas redéfinie sur ACTIVÉE. |
ConversionCustomVariableFamily
Famille d'une variable personnalisée de conversion
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
STANDARD |
Variable personnalisée de conversion standard Les clients doivent l'activer avant de pouvoir l'utiliser. |
FLOODLIGHT |
Variable personnalisée de conversion importée à partir d'une variable Floodlight personnalisée. |
ConversionCustomVariableCardinality
Cardinalité d'une variable personnalisée de conversion.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
BELOW_ALL_LIMITS |
La cardinalité de la variable personnalisée de conversion est inférieure à toutes les limites. La variable peut être utilisée pour la segmentation, et les statistiques peuvent s'accumuler pour les nouvelles valeurs si elle est activée. |
EXCEEDS_SEGMENTATION_LIMIT_BUT_NOT_STATS_LIMIT |
La cardinalité de la variable personnalisée de conversion dépasse la limite de segmentation, mais ne dépasse pas la limite des statistiques. La segmentation est désactivée, mais les statistiques peuvent être comptabilisées pour les nouvelles valeurs si la variable est activée. |
APPROACHES_STATS_LIMIT |
La variable personnalisée de conversion a dépassé les limites de segmentation et s'approche des limites de statistiques (> 90%). La segmentation est désactivée, mais les statistiques peuvent être comptabilisées pour les nouvelles valeurs si la variable est activée. |
EXCEEDS_STATS_LIMIT |
La variable personnalisée de conversion a dépassé les limites de segmentation et de statistiques. La segmentation sera désactivée et les statistiques pour les variables activées ne pourront s'accumuler que si les valeurs existantes n'augmentent plus la cardinalité de la variable. |
FloodlightConversionCustomVariableInfo
Informations sur les variables personnalisées de conversion Floodlight Search Ads 360
Représentation JSON |
---|
{ "floodlightVariableType": enum ( |
Champs | |
---|---|
floodlightVariableType |
Type de variable Floodlight défini dans Search Ads 360. |
floodlightVariableDataType |
Type de données "Variable Floodlight" défini dans Search Ads 360 |
FloodlightVariableType
Type de la variable Floodlight, telle que définie dans Search Ads 360. Pour en savoir plus, consultez la page https://support.google.com/searchads/answer/4397154?hl=en.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
DIMENSION |
Dimension "Type de variable Floodlight". |
METRIC |
Type de variable Floodlight de métrique. |
UNSET |
Le type de variable Floodlight n'est pas défini. |
FloodlightVariableDataType
Type de données de la variable Floodlight, telle qu'elle est définie dans Search Ads 360. Pour en savoir plus, consultez la page https://support.google.com/searchads/answer/4397154?hl=en.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
NUMBER |
Représente une variable Floodlight de "Nombre" de mots clés. Cette variable peut être attribuée à des variables Floodlight de type DIMENSION ou METRIC. |
STRING |
Représente une variable Floodlight de "String" de mots clés. Cette variable peut être attribuée aux variables Floodlight de type DIMENSION. |
Client
Un client.
Représentation JSON |
---|
{ "resourceName": string, "conversionTrackingSetting": { object ( |
Champs | |
---|---|
resourceName |
Nom de ressource du client. Les noms de ressources client se présentent comme suit:
|
conversionTrackingSetting |
Paramètre de suivi des conversions pour un client. |
accountType |
Type de compte de moteur (par exemple, Google Ads, Microsoft Advertising, Yahoo Japan, Baidu, Facebook, Suivi de moteur). |
doubleClickCampaignManagerSetting |
Paramètre DoubleClick Campaign Manager (Campaign Manager) pour un compte administrateur. |
accountStatus |
l'état du compte (par exemple, activé, mis en veille, supprimé, etc.) ; |
lastModifiedTime |
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". |
engineId |
ID du compte dans le compte de moteur externe. |
status |
État du client. |
creationTime |
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 |
ID du client. |
descriptiveName |
Nom descriptif facultatif et non unique du client. |
currencyCode |
Devise de fonctionnement du compte. Accepte un sous-ensemble de codes de devise ISO 4217. |
timeZone |
ID du fuseau horaire local du client. |
trackingUrlTemplate |
Modèle d'URL permettant de créer une URL de suivi à partir de paramètres. |
finalUrlSuffix |
Modèle d'URL pour l'ajout de paramètres à l'URL finale. |
autoTaggingEnabled |
Indique si le taggage automatique est activé pour le client. |
manager |
Indique si le client est un responsable. |
ConversionTrackingSetting
Ensemble de paramètres définis au niveau du client pour le suivi des conversions Search Ads 360.
Représentation JSON |
---|
{
"acceptedCustomerDataTerms": boolean,
"conversionTrackingStatus": enum ( |
Champs | |
---|---|
acceptedCustomerDataTerms |
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. |
conversionTrackingStatus |
État du suivi des conversions. Elle indique si le client utilise le suivi des conversions et qui en est le propriétaire. Si ce client utilise le suivi des conversions multicomptes, la valeur renvoyée sera différente en fonction de l' |
enhancedConversionsForLeadsEnabled |
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. |
googleAdsConversionCustomer |
Nom de la ressource du client où les conversions sont créées et gérées. Ce champ est en lecture seule. |
conversionTrackingId |
ID de suivi des conversions utilisé pour ce compte. Cet identifiant n'indique pas si le client utilise le suivi des conversions (conversionTrackingStatus). Ce champ est en lecture seule. |
googleAdsCrossAccountConversionTrackingId |
ID de suivi des conversions du responsable du client. Il est défini lorsque le client active le suivi des conversions et remplace le paramètre "conversionTrackingId". Ce champ ne peut être géré que dans l'interface utilisateur Google Ads. Ce champ est en lecture seule. |
crossAccountConversionTrackingId |
ID de suivi des conversions du responsable du client. Il est défini lorsque le client active le suivi des conversions multicomptes et remplace le paramètre "conversionTrackingId". |
ConversionTrackingStatus
État du suivi des conversions du client.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
NOT_CONVERSION_TRACKED |
Le client n'utilise pas le suivi des conversions. |
CONVERSION_TRACKING_MANAGED_BY_SELF |
Les actions de conversion sont créées et gérées par ce client. |
CONVERSION_TRACKING_MANAGED_BY_THIS_MANAGER |
Les actions de conversion sont créées et gérées par l'administrateur spécifié dans l'login-customer-id de la demande. |
CONVERSION_TRACKING_MANAGED_BY_ANOTHER_MANAGER |
Les actions de conversion sont créées et gérées par un administrateur différent du client ou de l'administrateur spécifié dans le login-customer-id de la demande. |
AccountType
Types de comptes de moteur possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
BAIDU |
compte Baidu. |
ENGINE_TRACK |
Compte de suivi de moteur. |
FACEBOOK |
Facebook. |
FACEBOOK_GATEWAY |
Compte Facebook géré via une passerelle. |
GOOGLE_ADS |
compte Google Ads. |
MICROSOFT |
compte Microsoft Advertising. |
SEARCH_ADS_360 |
compte administrateur Search Ads 360. |
YAHOO_JAPAN |
Yahoo! Japan. |
DoubleClickCampaignManagerSetting
Paramètre DoubleClick Campaign Manager (Campaign Manager) pour un compte administrateur.
Représentation JSON |
---|
{ "advertiserId": string, "networkId": string, "timeZone": string } |
Champs | |
---|---|
advertiserId |
Référence de l'annonceur Campaign Manager associé à ce client. |
networkId |
ID du réseau Campaign Manager associé à ce client. |
timeZone |
Fuseau horaire du réseau Campaign Manager associé à ce client, au format de la base de données des fuseaux horaires IANA (par exemple, America/New_York). |
AccountStatus
États possibles d'un compte.
Enums | |
---|---|
UNSPECIFIED |
Valeur par défaut. |
UNKNOWN |
Valeur inconnue. |
ENABLED |
Le compte peut diffuser des annonces. |
PAUSED |
Le compte est désactivé par l'utilisateur. |
SUSPENDED |
Le compte est désactivé par un processus interne. |
REMOVED |
Le compte est désactivé de manière irrévocable. |
DRAFT |
Le compte est toujours en cours de configuration. Il n'est pas encore ACTIVÉ. |
CustomerStatus
Statuts possibles d'un client.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ENABLED |
Indique qu'un compte actif peut diffuser des annonces. |
CANCELED |
Indique qu'un compte désactivé ne peut pas diffuser d'annonces. Peut être réactivé par un administrateur. |
SUSPENDED |
Indique qu'un compte suspendu ne peut pas diffuser d'annonces. Ne peut être activé que par l'assistance Google. |
CLOSED |
Indique qu'un compte clôturé ne peut pas diffuser d'annonces. Le compte test sera également associé à l'état FERMÉ. L'état est définitif et ne peut pas être rouvert. |
CustomerAsset
Lien entre un client et un élément.
Représentation JSON |
---|
{
"resourceName": string,
"asset": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'élément client. Les noms de ressources CustomerAsset se présentent comme suit:
|
asset |
Obligatoire. Élément associé au client. |
status |
État du composant du client. |
CustomerAssetSet
CustomerAssetSet est le lien entre un client et un ensemble d'éléments. L'ajout d'un CustomerAssetSet associe un ensemble de composants à un client.
Représentation JSON |
---|
{
"resourceName": string,
"assetSet": string,
"customer": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de l'ensemble d'éléments client. Les noms de ressources d'éléments de l'ensemble d'éléments se présentent comme suit:
|
assetSet |
Ensemble de composants associé au client. |
customer |
Client auquel cet ensemble de composants est associé. |
status |
État du composant de l'ensemble de composants du client. En lecture seule. |
AccessibleBiddingStrategy
Représente une vue des stratégies d'enchères appartenant au client et partagées 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'expose qu'un sous-ensemble limité d'attributs BiddingStrategy.
Représentation JSON |
---|
{ "resourceName": string, "id": string, "name": string, "type": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la stratégie d'enchères accessible. Les noms de ressources AccessibleBiddingStrategy se présentent comme suit:
|
id |
ID de la stratégie d'enchères. |
name |
Nom de la stratégie d'enchères. |
type |
Type de stratégie d'enchères. |
ownerCustomerId |
Identifiant du client propriétaire de la stratégie d'enchères. |
ownerDescriptiveName |
descriptiveName du client auquel la stratégie d'enchères appartient. |
Champ d'union Vous ne pouvez en définir qu'une seule. |
|
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. |
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. |
targetCpa |
Il s'agit d'une stratégie d'enchères qui définit vos enchères afin de générer autant de conversions que possible pour le coût par acquisition (CPA) cible que vous spécifiez. |
targetImpressionShare |
Il s'agit d'une stratégie d'enchères qui optimise automatiquement les enchères en fonction d'un pourcentage donné d'impressions. |
targetRoas |
Il s'agit d'une stratégie d'enchères qui vous aide à maximiser vos revenus tout en atteignant un objectif de retour sur les dépenses publicitaires (ROAS) moyen spécifique. |
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
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.
Représentation JSON |
---|
{ "targetRoas": number } |
Champs | |
---|---|
targetRoas |
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.
Représentation JSON |
---|
{ "targetCpa": string, "targetCpaMicros": string } |
Champs | |
---|---|
targetCpa |
Option "Coût par acquisition (CPA) cible" Il s'agit du montant moyen que vous souhaitez dépenser par acquisition. |
targetCpaMicros |
Option "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.
Représentation JSON |
---|
{ "targetCpaMicros": string } |
Champs | |
---|---|
targetCpaMicros |
CPA cible moyen. Cette cible doit être supérieure ou égale à l'unité facturable minimale, en fonction de la devise utilisée pour le compte. |
TargetRoas
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.
Représentation JSON |
---|
{ "targetRoas": number } |
Champs | |
---|---|
targetRoas |
Revenu choisi (sur la base des données de conversion) par unité de dépense. |
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.
Représentation JSON |
---|
{ "targetSpendMicros": string, "cpcBidCeilingMicros": string } |
Champs | |
---|---|
targetSpendMicros |
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. |
cpcBidCeilingMicros |
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. |
CustomerManagerLink
Représente la relation de lien client-administrateur.
Représentation JSON |
---|
{
"resourceName": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de la ressource. Les noms de ressources CustomerManagerLink sont au format suivant: |
status |
État de l'association entre le client et l'administrateur. |
managerCustomer |
Client administrateur associé au client. |
managerLinkId |
ID de l'association client-administrateur. Ce champ est en lecture seule. |
startTime |
Code temporel de la création de CustomerManagerLink. L'horodatage est dans le fuseau horaire du client et au format "aaaa-MM-jj HH:mm:ss". |
ManagerLinkStatus
États possibles d'une association.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ACTIVE |
Indique la relation effective actuelle |
INACTIVE |
Indique que la relation a été interrompue |
PENDING |
Indique que la relation a été demandée par le gestionnaire, mais que le client n'a pas encore accepté. |
REFUSED |
La relation a été demandée par le responsable, mais le client a refusé. |
CANCELED |
Indique que la relation a été demandée par l'administrateur, mais qu'elle l'a annulée. |
CustomerClient
Lien entre le client donné et un client client. Les clients n'existent que pour les comptes administrateur. Tous les clients directs et indirects des clients sont inclus, ainsi que le responsable lui-même.
Représentation JSON |
---|
{
"resourceName": string,
"appliedLabels": [
string
],
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource du client client. Les noms de ressources CustomerClient se présentent comme suit: |
appliedLabels[] |
Noms de ressources des libellés appartenant au client demandeur et appliqués au client client. Les noms de ressources d'étiquette se présentent comme suit:
|
status |
État du client. Lecture seule. |
clientCustomer |
Nom de ressource du client-client associé au client donné. Lecture seule. |
level |
Distance entre un client donné et un client donné. Pour le lien auto, la valeur du niveau est 0. Lecture seule. |
timeZone |
Représentation sous forme de chaîne CLDR (Common Locale Data Repository) du fuseau horaire du client, par exemple, America/Los_Angeles. Lecture seule. |
testAccount |
Indique si le client est un compte test. Lecture seule. |
manager |
Indique si le client est un gestionnaire. Lecture seule. |
descriptiveName |
Nom descriptif du client. Lecture seule. |
currencyCode |
Code de devise (par exemple, "USD" ou "EUR") pour le client. Lecture seule. |
id |
Identifiant du client client. Lecture seule. |
DynamicSearchAdsSearchTermView
Vue des termes de recherche pour des annonces dynamiques du Réseau de Recherche.
Représentation JSON |
---|
{ "resourceName": string, "landingPage": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue des termes de recherche des annonces dynamiques du Réseau de Recherche. Les noms des ressources de vue des annonces dynamiques du Réseau de Recherche se présentent comme suit:
|
landingPage |
URL de la page de destination de l'impression sélectionnée dynamiquement. Ce champ est en lecture seule. |
GenderView
Vue par genre. La ressource "genderView" reflète l'état de diffusion effectif, plutôt que les critères ajoutés. Par défaut, un groupe d'annonces sans critère de sexe est diffusé auprès de tous les sexes. Tous les sexes apparaissent donc dans "genderView" avec des statistiques.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue du genre. Les noms des ressources de la vue Genre se présentent sous la forme suivante:
|
GeoTargetConstant
Constante de cible géographique
Représentation JSON |
---|
{
"resourceName": string,
"status": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la constante de cible géographique. Les noms de ressources des constantes de la cible géographique se présentent sous la forme suivante:
|
status |
État de la constante de la cible géographique. |
id |
ID de la constante de la cible géographique. |
name |
Nom anglais de la constante de la cible géographique. |
countryCode |
Code pays ISO-3166-1 alpha-2 associé à la cible. |
targetType |
Type de cible constante de la cible géographique. |
canonicalName |
Nom complet en anglais composé du nom de la cible, de celui de son parent et de son pays. |
parentGeoTarget |
Nom de ressource de la constante de cible géographique parente. Les noms de ressources des constantes de la cible géographique se présentent sous la forme suivante:
|
GeoTargetConstantStatus
États possibles d'une constante de cible géographique.
Enums | |
---|---|
UNSPECIFIED |
Aucune valeur n'a été spécifiée. |
UNKNOWN |
La valeur reçue est inconnue dans cette version. Il s'agit d'une valeur de réponse uniquement. |
ENABLED |
La constante de cible géographique est valide. |
REMOVAL_PLANNED |
La constante de cible géographique est obsolète et sera supprimée. |
KeywordView
Vue par mot clé.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue de mot clé. Les noms des ressources de la vue des mots clés se présentent sous la forme suivante:
|
Libellé
Une étiquette.
Représentation JSON |
---|
{ "resourceName": string, "status": enum ( |
Champs | |
---|---|
resourceName |
Nom de la ressource. Les noms de ressources d'étiquettes se présentent sous la forme suivante: |
status |
État du libellé. Lecture seule. |
textLabel |
Type de libellé affichant du texte sur un fond coloré. |
id |
ID du libellé. Lecture seule. |
name |
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. |
LabelStatus
États possibles d'un libellé.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ENABLED |
Le libellé est activé. |
REMOVED |
Le libellé est supprimé. |
TextLabel
Type de libellé affichant du texte sur un fond coloré.
Représentation JSON |
---|
{ "backgroundColor": string, "description": string } |
Champs | |
---|---|
backgroundColor |
Couleur d'arrière-plan du libellé au format HEX. 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 |
Brève description du libellé. La longueur ne doit pas dépasser 200 caractères. |
LanguageConstant
Une langue.
Représentation JSON |
---|
{ "resourceName": string, "id": string, "code": string, "name": string, "targetable": boolean } |
Champs | |
---|---|
resourceName |
Nom de ressource de la constante de langue. Les noms de ressources des constantes de langage se présentent sous la forme suivante:
|
id |
ID de la constante de langue. |
code |
Code de langue, par exemple, "en_US", "en_AU", "es", "fr", etc. |
name |
Nom complet de la langue en anglais, par exemple "Français (États-Unis)", "Espagnol", etc. |
targetable |
Indique si la langue peut être ciblée. |
LocationView
La vue par zone géographique récapitule les performances des campagnes par critère géographique.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue de l'établissement. Les noms des ressources de la vue d'emplacement se présentent sous la forme suivante:
|
ProductBiddingCategoryConstant
Catégorie d'enchères sur les produits.
Représentation JSON |
---|
{ "resourceName": string, "level": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la catégorie d'enchères du produit. Les noms de ressources des catégories d'enchères par produit se présentent comme suit:
|
level |
Niveau de la catégorie d'enchères associées au produit. |
status |
État de la catégorie d'enchères associées au produit. |
id |
ID de la catégorie d'enchères associées au produit. Cet identifiant correspond à l'identifiant "google_product_category" décrit dans cet article: https://support.google.com/merchants/answer/6324436. |
countryCode |
Code pays à deux lettres majuscules de la catégorie d'enchères de produit. |
productBiddingCategoryConstantParent |
Nom de ressource de la catégorie d'enchères du produit parent. |
languageCode |
Code de langue de la catégorie d'enchères au niveau du produit. |
localizedName |
Valeur d'affichage de la catégorie d'enchères de produit localisée conformément au code languageCode. |
ProductBiddingCategoryLevel
Énumération décrivant le niveau de la catégorie d'enchères associées au produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
LEVEL1 |
Niveau 1. |
LEVEL2 |
Niveau 2. |
LEVEL3 |
Niveau 3. |
LEVEL4 |
Niveau 4. |
LEVEL5 |
Niveau 5. |
ProductBiddingCategoryStatus
Énumération décrivant l'état de la catégorie d'enchères associées au produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ACTIVE |
La catégorie est active et peut être utilisée pour les enchères. |
OBSOLETE |
Cette catégorie est obsolète. Utilisé uniquement pour la création de rapports. |
ProductGroupView
Vue de groupe de produits.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue du groupe de produits. Les noms des ressources de vue du groupe de produits se présentent comme suit:
|
ShoppingPerformanceView
Affichage des performances Shopping. Fournit des statistiques sur les campagnes Shopping, cumulées à plusieurs niveaux de dimensions de produits. 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.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la vue des performances Shopping. Les noms des ressources de la vue des performances Shopping sont au format suivant: |
UserList
Une liste d'utilisateurs. Il s'agit d'une liste d'utilisateurs qu'un client peut cibler.
Représentation JSON |
---|
{
"resourceName": string,
"type": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la liste d'utilisateurs. Les noms de ressources de la liste d'utilisateurs se présentent sous la forme suivante:
|
type |
Type de la liste. Ce champ est en lecture seule. |
id |
Identifiant de la liste d'utilisateurs. |
name |
Nom de cette liste d'utilisateurs. Selon son access_reason, le nom de la liste d'utilisateurs peut ne pas être unique (par exemple, si access_reason=SHARED) |
UserListType
Énumération contenant les types de listes d'utilisateurs possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
REMARKETING |
Objet UserList représenté par une collection de types de conversion. |
LOGICAL |
Objet UserList représenté par une combinaison d'autres listes d'utilisateurs/centres d'intérêt. |
EXTERNAL_REMARKETING |
Listes d'utilisateurs créées sur la plate-forme Google Ad Manager. |
RULE_BASED |
Objet UserList associé à une règle. |
SIMILAR |
UserList avec des utilisateurs semblables à ceux d'un autre UserList. |
CRM_BASED |
Liste d'utilisateurs de données CRM first party fournies par l'annonceur sous forme d'e-mails ou d'autres formats. |
WebpageView
Affichage d'une page Web.
Représentation JSON |
---|
{ "resourceName": string } |
Champs | |
---|---|
resourceName |
Nom de ressource de la page Web vue. Les noms des ressources de vue de page Web se présentent sous la forme suivante:
|
Accéder à la page
Une visite.
Représentation JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitDateTime": string, "productId": string, "productChannel": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la visite. Les noms des ressources de visite se présentent sous la forme suivante:
|
id |
ID de la visite. |
criterionId |
Identifiant de mot clé Search Ads 360 La valeur 0 indique que le mot clé n'est pas attribué. |
merchantId |
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. |
adId |
Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée. |
clickId |
Chaîne unique pour chaque visite, transmise à la page de destination en tant que paramètre d'URL d'ID de clic. |
visitDateTime |
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". |
productId |
Identifiant du produit ayant fait l'objet d'un clic. |
productChannel |
Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin. |
productLanguageCode |
Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit. |
productStoreId |
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. |
productCountryCode |
Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic. |
assetId |
ID du composant avec lequel vous avez interagi lors de l'événement de visite. |
assetFieldType |
Type de champ de composant de l'événement de visite. |
ProductChannel
Énumération décrivant la localité d'une offre de produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ONLINE |
L'article est vendu en ligne. |
LOCAL |
L'article est vendu dans des magasins locaux. |
Conversion
Une conversion.
Représentation JSON |
---|
{ "resourceName": string, "id": string, "criterionId": string, "merchantId": string, "adId": string, "clickId": string, "visitId": string, "advertiserConversionId": string, "productId": string, "productChannel": enum ( |
Champs | |
---|---|
resourceName |
Nom de ressource de la conversion. Les noms des ressources de conversion se présentent comme suit:
|
id |
Identifiant de la conversion |
criterionId |
ID du critère Search Ads 360. Une valeur de 0 indique que le critère n'est pas attribué. |
merchantId |
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. |
adId |
Identifiant de l'annonce. La valeur 0 indique que l'annonce n'est pas attribuée. |
clickId |
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. |
visitId |
ID de la visite Search Ads 360 auquel la conversion est attribuée. |
advertiserConversionId |
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 "FloodlightOrderId", en fonction des instructions Floodlight de l'annonceur. |
productId |
Identifiant du produit ayant fait l'objet d'un clic. |
productChannel |
Canal de ventes du produit ayant fait l'objet d'un clic : en ligne ou en magasin. |
productLanguageCode |
Langue (ISO-639-1) définie pour le flux Merchant Center contenant les données relatives au produit. |
productStoreId |
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. |
productCountryCode |
Pays (au format ISO-3166) enregistré pour le flux d'inventaire qui contient le produit ayant fait l'objet d'un clic. |
attributionType |
Élément auquel la conversion est attribuée : visite ou mot clé + annonce. |
conversionDateTime |
Code temporel de l'événement de conversion. |
conversionLastModifiedDateTime |
Code temporel de la dernière modification de la conversion. |
conversionVisitDateTime |
Code temporel de la visite à laquelle la conversion est attribuée. |
conversionQuantity |
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. |
conversionRevenueMicros |
Revenus ajustés en micro-unités pour l'événement de conversion. Cette valeur est toujours dans la devise du compte de diffusion. |
floodlightOriginalRevenue |
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. |
floodlightOrderId |
ID de commande Floodlight fourni par l'annonceur pour la conversion. |
status |
État de la conversion (ACTIVÉ ou SUPPRIMÉ). |
assetId |
ID du composant avec lequel vous avez interagi lors de l'événement de conversion. |
assetFieldType |
Type de champ de composant de l'événement de conversion. |
AttributionType
Type d'attribution des conversions dans Search Ads 360
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
VISIT |
La conversion est attribuée à une visite. |
CRITERION_AD |
La conversion est attribuée à une paire critère/annonce. |
ConversionStatus
États possibles d'une conversion.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
ENABLED |
La conversion est activée. |
REMOVED |
La conversion a été supprimée. |
Métriques
Données de métriques.
Représentation JSON |
---|
{ "allConversionsValueByConversionDate": number, "allConversionsByConversionDate": number, "conversionCustomMetrics": [ { object ( |
Champs | |
---|---|
allConversionsValueByConversionDate |
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. |
allConversionsByConversionDate |
Cette valeur correspond au nombre total de conversions. Cela inclut toutes les conversions, quelle que soit la valeur d'includeInConversionsMetric. 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. |
conversionCustomMetrics[] |
Métriques personnalisées de conversion. |
conversionsValueByConversionDate |
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. |
conversionsByConversionDate |
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. |
historicalCreativeQualityScore |
Historique du niveau de qualité de la création. |
historicalLandingPageQualityScore |
Qualité de l'historique de l'expérience sur la page de destination |
historicalSearchPredictedCtr |
Taux de clics (CTR) prévu pour la recherche dans l'historique |
interactionEventTypes[] |
Types d'interactions sans frais et payantes. |
rawEventConversionMetrics[] |
Métriques brutes des conversions d'événements. |
absoluteTopImpressionPercentage |
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. |
allConversionsFromInteractionsRate |
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. |
allConversionsValue |
Valeur de toutes les conversions. |
allConversions |
Cette valeur correspond au nombre total de conversions. Cela inclut toutes les conversions, quelle que soit la valeur d'includeInConversionsMetric. |
allConversionsValuePerCost |
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). |
allConversionsFromClickToCall |
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. |
allConversionsFromDirections |
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. |
allConversionsFromInteractionsValuePerInteraction |
Valeur de toutes les conversions issues des interactions divisée par le nombre total d'interactions. |
allConversionsFromMenu |
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. |
allConversionsFromOrder |
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. |
allConversionsFromOtherEngagement |
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. |
allConversionsFromStoreVisit |
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 |
Clics que Search Ads 360 a bien enregistrés et transférés vers la page de destination d'un annonceur. |
allConversionsFromStoreWebsite |
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. |
averageCost |
Montant moyen que vous payez par interaction. Cette somme correspond au coût total de vos annonces divisé par le nombre total d'interactions. |
averageCpc |
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. |
averageCpm |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clicks |
Nombre de clics. |
contentBudgetLostImpressionShare |
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. |
contentImpressionShare |
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. |
contentRankLostImpressionShare |
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. |
conversionsFromInteractionsRate |
Nombre moyen de conversions enchérissables (à partir 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. |
clientAccountConversionsValue |
Valeur des conversions de compte client. Cela inclut uniquement les actions de conversion pour lesquelles l'attribut includeInClientAccountConversionsMetric 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. |
conversionsValuePerCost |
Valeur d'une conversion enchérissable divisée par le coût total des interactions éligibles à la conversion. |
conversionsFromInteractionsValuePerInteraction |
Valeur des conversions issues des interactions divisée par le nombre d'interactions avec l'annonce. Cela ne concerne que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric 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. |
clientAccountConversions |
Nombre de conversions de comptes client. Cela inclut uniquement les actions de conversion pour lesquelles l'attribut includeInClientAccountConversionsMetric 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. |
costMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
costPerAllConversions |
Coût des interactions avec l'annonce divisé par le nombre total de conversions. |
costPerConversion |
Coût par conversion enchérissable moyen éligible aux conversions. |
costPerCurrentModelAttributedConversion |
Coût des interactions avec les annonces divisé par le nombre de conversions attribuées par le modèle actuel. Cela ne concerne que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric 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. |
crossDeviceConversions |
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 allConversions. |
crossDeviceConversionsValue |
Somme de la valeur des conversions multi-appareils. |
ctr |
Nombre de clics sur votre annonce (clics) divisé par le nombre d'affichages de celle-ci (impressions). |
conversions |
Nombre de conversions Cela ne concerne que les actions de conversion pour lesquelles l'attribut includeInConversionsMetric 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. |
conversionsValue |
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. |
averageQualityScore |
Niveau de qualité moyen. |
historicalQualityScore |
Historique du niveau de qualité. |
impressions |
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. |
interactionRate |
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 |
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. |
invalidClickRate |
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. |
invalidClicks |
Nombre de clics que Google considère illégitimes et pour lesquels aucuns frais ne vous sont facturés. |
mobileFriendlyClicksPercentage |
Pourcentage de clics sur mobile qui redirigent les utilisateurs vers une page adaptée aux mobiles. |
searchAbsoluteTopImpressionShare |
Pourcentage d'impressions d'annonces Shopping ou sur le Réseau de Recherche du client diffusées à la position la plus visible (Shopping). Pour en savoir plus, consultez la page https://support.google.com/sa360/answer/9566729. Toute valeur inférieure à 0,1 est signalée à 0,0999. |
searchBudgetLostAbsoluteTopImpressionShare |
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. |
searchBudgetLostImpressionShare |
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. |
searchBudgetLostTopImpressionShare |
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. |
searchClickShare |
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. |
searchExactMatchImpressionShare |
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. |
searchImpressionShare |
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. |
searchRankLostAbsoluteTopImpressionShare |
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. |
searchRankLostImpressionShare |
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. |
searchRankLostTopImpressionShare |
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. |
searchTopImpressionShare |
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. |
topImpressionPercentage |
Pourcentage de vos impressions d'annonces diffusées à côté des premiers résultats de recherche naturels. |
valuePerAllConversions |
Valeur de toutes les conversions divisée par le nombre total de conversions. |
valuePerAllConversionsByConversionDate |
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. |
valuePerConversion |
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. |
valuePerConversionsByConversionDate |
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. |
clientAccountViewThroughConversions |
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). |
clientAccountCrossSellCostOfGoodsSoldMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
crossSellCostOfGoodsSoldMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountCrossSellGrossProfitMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
crossSellGrossProfitMicros |
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. |
clientAccountCrossSellRevenueMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
crossSellRevenueMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountCrossSellUnitsSold |
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. |
crossSellUnitsSold |
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. |
clientAccountLeadCostOfGoodsSoldMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
leadCostOfGoodsSoldMicros |
Le coût de vente lié aux prospects correspond au coût total des produits vendus suite à la promotion de ces mêmes produits. Fonctionnement: vous enregistrez des conversions avec les données du panier pour les achats effectués sur votre site Web. Si l'annonce avec laquelle l'utilisateur a interagi est associée à un produit (voir les annonces Shopping), ce produit est alors considéré comme celui dont vous faites la promotion. Tout produit inclus dans la commande que le client passe est un produit vendu. Si les produits dont vous avez fait la promotion correspondent aux produits vendus, leur coût est comptabilisé comme coût de vente lié aux prospects. Exemple: Un utilisateur a cliqué sur une annonce Shopping pour une casquette, puis a acheté cette même casquette et une chemise. Le prix de revient de la casquette est de 3 € et celui de la chemise est de 5 €. Le coût de vente lié aux prospects pour cette commande est de 3 €. Cette métrique n'est disponible que si vous enregistrez des conversions avec les données du panier. Cette métrique est une valeur monétaire et est affichée dans la devise du client par défaut. Consultez le paramètre "metrics_currency" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountLeadGrossProfitMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
leadGrossProfitMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountLeadRevenueMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
leadRevenueMicros |
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" sur la page https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause. |
clientAccountLeadUnitsSold |
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. |
leadUnitsSold |
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. |
Valeur
Conteneur de données générique.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union value . une valeur. value ne peut être qu'un des éléments suivants : |
|
booleanValue |
Valeur booléenne. |
int64Value |
Int64. |
floatValue |
Un float. |
doubleValue |
Valeur double. |
stringValue |
Chaîne. |
QualityScoreBucket
Énumération répertoriant les segments de niveau de qualité possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
BELOW_AVERAGE |
La qualité de la création est inférieure à la moyenne. |
AVERAGE |
La création est de qualité moyenne. |
ABOVE_AVERAGE |
La qualité de la création est supérieure à la moyenne. |
InteractionEventType
Énumération décrivant les types possibles d'interactions sans frais et payantes.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
CLICK |
Cliquez pour accéder au site. Dans la plupart des cas, cette interaction redirige l'utilisateur vers un site externe, généralement la page de destination de l'annonceur. Il s'agit également de l'InteractionEventType par défaut pour les événements de clic. |
ENGAGEMENT |
L'intention de l'utilisateur d'interagir avec l'annonce sur place |
VIDEO_VIEW |
Un utilisateur a visionné une annonce vidéo. |
NONE |
InteractionEventType par défaut pour les événements de conversion d'annonce. Cette valeur est utilisée lorsqu'une ligne de conversion d'annonce n'indique PAS que les interactions sans frais (par exemple, les conversions d'annonces) doivent être "promouvoir". et incluses dans les métriques clés. Il s'agit simplement d'autres conversions (annonces). |
Segments
Segmenter uniquement.
Représentation JSON |
---|
{ "adNetworkType": enum ( |
Champs | |
---|---|
adNetworkType |
Type de réseau publicitaire. |
conversionActionCategory |
Catégorie de l'action de conversion. |
conversionCustomDimensions[] |
Dimensions personnalisées de la conversion. |
dayOfWeek |
Jour de la semaine (par exemple, MONDAY) |
device |
Appareil auquel les métriques s'appliquent. |
keyword |
Critère du mot clé. |
productChannel |
Canal du produit. |
productChannelExclusivity |
Exclusivité de canal du produit. |
productCondition |
État du produit. |
productSoldCondition |
État du produit vendu. |
rawEventConversionDimensions[] |
Dimensions brutes de conversion d'événement. |
conversionAction |
Nom de ressource de l'action de conversion. |
conversionActionName |
Nom de l'action de conversion |
date |
Date à laquelle les métriques s'appliquent, au format aaaa-MM-jj, par exemple 2018-04-17. |
geoTargetCity |
Nom de ressource de la constante de cible géographique qui représente une ville. |
geoTargetCountry |
Nom de ressource de la constante de cible géographique qui représente un pays. |
geoTargetMetro |
Nom de ressource de la constante de cible géographique qui représente une agglomération. |
geoTargetRegion |
Nom de ressource de la constante de cible géographique qui représente une région. |
hour |
Heure de la journée, sous la forme d'un nombre compris entre 0 et 23 (inclus). |
month |
Mois, représenté par la date du premier jour du mois. au format aaaa-MM-jj. |
productBiddingCategoryLevel1 |
Catégorie d'enchères (niveau 1) du produit. |
productBiddingCategoryLevel2 |
Catégorie d'enchères (niveau 2) du produit. |
productBiddingCategoryLevel3 |
Catégorie d'enchères (niveau 3) du produit. |
productBiddingCategoryLevel4 |
Catégorie d'enchères (niveau 4) du produit. |
productBiddingCategoryLevel5 |
Catégorie d'enchères (niveau 5) du produit. |
productBrand |
Marque du produit. |
productCountry |
Nom de ressource de la constante de ciblage géographique pour le pays de vente du produit. |
productCustomAttribute0 |
Attribut personnalisé 0 du produit. |
productCustomAttribute1 |
Attribut personnalisé 1 du produit. |
productCustomAttribute2 |
Attribut personnalisé 2 du produit. |
productCustomAttribute3 |
Attribut personnalisé 3 du produit. |
productCustomAttribute4 |
Attribut personnalisé 4 du produit. |
productItemId |
ID d'article du produit. |
productLanguage |
Nom de ressource de la constante de langue du produit. |
productSoldBiddingCategoryLevel1 |
Catégorie d'enchères (niveau 1) du produit vendu. |
productSoldBiddingCategoryLevel2 |
Catégorie d'enchères (niveau 2) du produit vendu. |
productSoldBiddingCategoryLevel3 |
Catégorie d'enchères (niveau 3) du produit vendu. |
productSoldBiddingCategoryLevel4 |
Catégorie d'enchères (niveau 4) du produit vendu. |
productSoldBiddingCategoryLevel5 |
Catégorie d'enchères (niveau 5) du produit vendu. |
productSoldBrand |
Marque du produit vendu. |
productSoldCustomAttribute0 |
Attribut personnalisé 0 du produit vendu |
productSoldCustomAttribute1 |
Attribut personnalisé 1 du produit vendu. |
productSoldCustomAttribute2 |
Attribut personnalisé 2 du produit vendu |
productSoldCustomAttribute3 |
Attribut personnalisé 3 du produit vendu |
productSoldCustomAttribute4 |
Attribut personnalisé 4 du produit vendu |
productSoldItemId |
ID d'article du produit vendu. |
productSoldTitle |
Titre du produit vendu. |
productSoldTypeL1 |
Type (niveau 1) du produit vendu. |
productSoldTypeL2 |
Type (niveau 2) du produit vendu. |
productSoldTypeL3 |
Type (niveau 3) du produit vendu. |
productSoldTypeL4 |
Type (niveau 4) du produit vendu. |
productSoldTypeL5 |
Type (niveau 5) du produit vendu. |
productStoreId |
ID de magasin associé au produit. |
productTitle |
Titre du produit. |
productTypeL1 |
Type (niveau 1) du produit. |
productTypeL2 |
Type (niveau 2) du produit. |
productTypeL3 |
Type (niveau 3) du produit. |
productTypeL4 |
Type (niveau 4) du produit. |
productTypeL5 |
Type (niveau 5) du produit. |
quarter |
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 |
Semaine (définie du lundi au dimanche) et représentée par le lundi. au format aaaa-MM-jj. |
year |
Année au format aaaa |
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 "interactionOnThisAsset" est défini sur "true", cela signifie que les interactions ont lieu sur cet élément spécifique. Lorsque "interactionOnThisAsset" est défini sur "false", cela signifie que les interactions ne se trouvent pas sur cet élément spécifique, mais sur d'autres parties de l'annonce avec laquelle cet élément est diffusé. |
AdNetworkType
Énumère les types de réseaux Google Ads.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
SEARCH |
Recherche Google |
SEARCH_PARTNERS |
Partenaires du Réseau de Recherche. |
CONTENT |
Réseau Display |
YOUTUBE_SEARCH |
Recherche YouTube. |
YOUTUBE_WATCH |
Vidéos YouTube |
MIXED |
Multiréseau. |
Mot clé
Un segment de critère de mot-clé.
Représentation JSON |
---|
{
"info": {
object ( |
Champs | |
---|---|
info |
Informations sur le mot clé. |
adGroupCriterion |
Nom de la ressource GroupByKey. |
ProductChannelExclusivity
Énumération décrivant la disponibilité d'une offre de produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
SINGLE_CHANNEL |
L'article est vendu par le biais d'un seul canal de distribution, à savoir les magasins locaux ou en ligne, comme l'indique le canal de distribution ProductChannel. |
MULTI_CHANNEL |
L'article est mis en correspondance avec son équivalent en ligne ou en magasin, ce qui indique qu'il est disponible à l'achat sur les deux canaux ShoppingProductChannels. |
ProductCondition
Énumération décrivant l'état d'une offre de produit.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
OLD |
L'état du produit est ancien. |
NEW |
Le produit est neuf. |
REFURBISHED |
Le produit est reconditionné. |
USED |
L'état du produit est utilisé. |
AssetInteractionTarget
Un segment AssetInteractionTarget.
Représentation JSON |
---|
{ "asset": string, "interactionOnThisAsset": boolean } |
Champs | |
---|---|
asset |
Nom de ressource de l'élément. |
interactionOnThisAsset |
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. |