- Représentation JSON
- FinalAppUrl
- AppUrlOperatingSystemType
- AdType
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- AdVideoAssetInfo
- AdVideoAssetInventoryPreferences
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- AppPreRegistrationAdInfo
- DemandGenMultiAssetAdInfo
- DemandGenCarouselAdInfo
- AdDemandGenCarouselCardAsset
- DemandGenVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
Annonce.
Représentation JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
Champs | |
---|---|
resourceName |
Immuable. 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. |
finalAppUrls[] |
Liste des URL finales de l'application qui seront utilisées sur mobile si l'utilisateur a installé l'application en question. |
finalMobileUrls[] |
Liste des URL finales pour mobile possibles après toutes les redirections vers un autre domaine pour l'annonce. |
urlCustomParameters[] |
Liste des mappages pouvant être utilisés pour remplacer des tags de paramètre personnalisé dans |
type |
Uniquement en sortie. Type d'annonce. |
devicePreference |
Préférences relatives aux appareils pour l'annonce. Vous ne pouvez spécifier une préférence que pour les appareils mobiles. Lorsque cette préférence est définie, l'annonce diffusée sur un appareil mobile est prioritaire par rapport aux autres annonces. L'annonce peut toujours être diffusée sur d'autres types d'appareils, par exemple si aucune autre annonce n'est disponible. Si aucune valeur n'est spécifiée (aucune préférence relative aux appareils), tous les appareils sont ciblés. Cette option n'est compatible qu'avec certains types d'annonces. |
urlCollections[] |
URL supplémentaires pour l'annonce, taguées avec un identifiant unique pouvant être référencé à partir d'autres champs de l'annonce. |
systemManagedResourceSource |
Uniquement en sortie. Si l'annonce est gérée par le système, ce champ indique sa source. Ce champ est en lecture seule. |
id |
Uniquement en sortie. Identifiant de l'annonce. |
trackingUrlTemplate |
Modèle d'URL permettant de créer une URL de suivi. |
finalUrlSuffix |
Suffixe à utiliser lors de la création d'une URL finale. |
displayUrl |
URL qui s'affiche dans la description de certains formats d'annonces. |
addedByGoogleAds |
Uniquement en sortie. Indique si l'annonce a été ajoutée automatiquement par Google Ads et non par un utilisateur. Cela peut se produire, par exemple, lorsque des annonces sont créées automatiquement en tant que suggestions de nouvelles annonces en fonction des performances des annonces existantes. |
name |
Immuable. 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 |
Immuable. Informations concernant une annonce textuelle. |
expandedTextAd |
Informations sur une annonce textuelle agrandie |
callAd |
Détails concernant une annonce Appel. |
expandedDynamicSearchAd |
Immuable. Informations sur une annonce dynamique agrandie du Réseau de Recherche Pour ce type d'annonce, le titre, les URL finales et l'URL à afficher sont générés automatiquement au moment de la diffusion en fonction des informations spécifiques au nom de domaine fournies par |
hotelAd |
Informations sur une annonce d'hôtel. |
shoppingSmartAd |
Informations sur une annonce Shopping intelligente |
shoppingProductAd |
Informations sur une annonce Shopping pour un produit |
imageAd |
Immuable. Informations sur une annonce illustrée |
videoAd |
Informations concernant une annonce vidéo. |
videoResponsiveAd |
Informations concernant une annonce vidéo responsive. |
responsiveSearchAd |
Informations concernant une annonce responsive sur le Réseau de Recherche. |
legacyResponsiveDisplayAd |
Informations concernant une ancienne annonce display responsive |
appAd |
Informations concernant une annonce pour une application. |
legacyAppInstallAd |
Immuable. Informations sur une ancienne annonce incitant à installer une application |
responsiveDisplayAd |
Informations concernant une annonce display responsive |
localAd |
Informations concernant une annonce locale. |
displayUploadAd |
Détails concernant une annonce display importée |
appEngagementAd |
Informations sur une annonce ciblant l'engagement avec une application |
shoppingComparisonListingAd |
Informations sur les annonces comparateur de prix en magasin |
smartCampaignAd |
Informations sur l'annonce d'une campagne intelligente |
appPreRegistrationAd |
Informations sur une annonce de préinscription à une application |
demandGenMultiAssetAd |
Détails concernant une annonce de génération de la demande avec plusieurs composants |
demandGenCarouselAd |
Informations sur une annonce carrousel de génération de la demande |
demandGenVideoResponsiveAd |
Informations sur une annonce vidéo responsive de génération de la demande |
demandGenProductAd |
Informations sur une annonce produit de génération de la demande |
travelAd |
Informations concernant une annonce de voyage |
FinalAppUrl
URL permettant de créer des liens profonds dans une application pour le système d'exploitation donné.
Représentation JSON |
---|
{
"osType": enum ( |
Champs | |
---|---|
osType |
Système d'exploitation ciblé par cette URL. Obligatoire. |
url |
URL du lien profond de l'application. Les liens profonds spécifient un emplacement dans une application qui correspond au contenu que vous souhaitez afficher. Ils doivent se présenter sous la forme {scheme}://{host_path}. Le schéma identifie l'application à ouvrir. Pour votre application, vous pouvez utiliser un schéma personnalisé qui commence par le nom de l'application. L'hôte et le chemin d'accès indiquent l'emplacement unique de votre contenu dans l'application. Exemple: "exampleapp://productid_1234". Obligatoire. |
AppUrlOperatingSystemType
Système d'exploitation
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
IOS |
Système d'exploitation Apple IOS. |
ANDROID |
Système d'exploitation Android |
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. |
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. |
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_IN_STREAM_AD |
Annonce vidéo TrueView InStream. |
VIDEO_RESPONSIVE_AD |
Annonce vidéo responsive. |
SMART_CAMPAIGN_AD |
Annonce d'une campagne intelligente. |
CALL_AD |
Annonce Appel. |
APP_PRE_REGISTRATION_AD |
Annonce universelle de préinscription à une application. |
IN_FEED_VIDEO_AD |
Annonce vidéo In-Feed. |
DEMAND_GEN_MULTI_ASSET_AD |
Annonce de génération de la demande avec plusieurs composants. |
DEMAND_GEN_CAROUSEL_AD |
Annonce carrousel de génération de la demande. |
TRAVEL_AD |
Annonce de voyage. |
DEMAND_GEN_VIDEO_RESPONSIVE_AD |
Annonce vidéo responsive de génération de la demande. |
DEMAND_GEN_PRODUCT_AD |
Annonce produit de génération de la demande. |
UrlCollection
Ensemble d'URL comportant un tag avec un identifiant unique.
Représentation JSON |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
Champs | |
---|---|
finalUrls[] |
Liste des URL finales possibles. |
finalMobileUrls[] |
Liste des URL finales pour mobile possibles. |
urlCollectionId |
Identifiant unique pour cette instance UrlCollection. |
trackingUrlTemplate |
Modèle d'URL permettant de créer une URL de suivi. |
SystemManagedResourceSource
Énumération répertoriant les sources possibles d'entités gérées par le système.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
AD_VARIATIONS |
Annonce de test des variantes d'annonces générées. |
TextAdInfo
Annonce textuelle.
Représentation JSON |
---|
{ "headline": string, "description1": string, "description2": 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. |
ExpandedTextAdInfo
Annonce textuelle agrandie.
Représentation JSON |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
Champs | |
---|---|
headlinePart1 |
Première partie du titre de l'annonce. |
headlinePart2 |
Deuxième partie du titre de l'annonce. |
headlinePart3 |
Troisième partie du titre de l'annonce. |
description |
Description de l'annonce. |
description2 |
Deuxième description de l'annonce. |
path1 |
Texte pouvant s'afficher à côté de l'URL affichée dans l'annonce. |
path2 |
Texte supplémentaire pouvant apparaître à côté de l'URL affichée dans l'annonce. |
CallAdInfo
Annonce Appel.
Représentation JSON |
---|
{
"countryCode": string,
"phoneNumber": string,
"businessName": string,
"headline1": string,
"headline2": string,
"description1": string,
"description2": string,
"callTracked": boolean,
"disableCallConversion": boolean,
"phoneNumberVerificationUrl": string,
"conversionAction": string,
"conversionReportingState": enum ( |
Champs | |
---|---|
countryCode |
Code pays figurant dans l'annonce. |
phoneNumber |
Numéro de téléphone affiché dans l'annonce. |
businessName |
Nom de l'entreprise dans l'annonce. |
headline1 |
Premier titre de l'annonce. |
headline2 |
Deuxième titre dans l'annonce. |
description1 |
Première ligne de la description de l'annonce. |
description2 |
Deuxième ligne de description de l'annonce. |
callTracked |
Permet d'activer ou non le suivi des appels pour la création. L'activation du suivi des appels active également les conversions par appel. |
disableCallConversion |
Permet de désactiver ou non la conversion par appel pour la création. Si la valeur est définie sur |
phoneNumberVerificationUrl |
URL à utiliser pour la validation du numéro de téléphone. |
conversionAction |
Action de conversion à laquelle attribuer une conversion par appel. Si cette règle n'est pas configurée, une action de conversion par défaut est utilisée. Ce champ n'a d'effet que si |
conversionReportingState |
Comportement des conversions par appel de cette annonce Appel. Elle peut utiliser son propre paramètre de conversion par appel, hériter du paramètre défini au niveau du compte ou être désactivée. |
path1 |
Première partie du texte pouvant être ajoutée à l'URL dans l'annonce. Facultatif. |
path2 |
Deuxième partie du texte pouvant être ajoutée à l'URL dans l'annonce. Ce champ ne peut être défini que si |
ExpandedDynamicSearchAdInfo
Annonce dynamique agrandie du Réseau de Recherche.
Représentation JSON |
---|
{ "description": string, "description2": string } |
Champs | |
---|---|
description |
Description de l'annonce. |
description2 |
Deuxième description de l'annonce. |
HotelAdInfo
Ce type ne comporte aucun champ.
Annonce d'hôtel.
ShoppingSmartAdInfo
Ce type ne comporte aucun champ.
Annonce Shopping intelligente.
ShoppingProductAdInfo
Ce type ne comporte aucun champ.
Annonce Shopping standard.
ImageAdInfo
Annonce illustrée.
Représentation JSON |
---|
{ "mimeType": enum ( |
Champs | |
---|---|
mimeType |
Type MIME de l'image. |
pixelWidth |
Largeur, en pixels, de l'image en taille réelle. |
pixelHeight |
Hauteur en pixels de l'image en taille réelle. |
imageUrl |
URL de l'image en taille réelle. |
previewPixelWidth |
Largeur, en pixels, de l'image de taille d'aperçu. |
previewPixelHeight |
Hauteur, en pixels, de l'image de taille d'aperçu. |
previewImageUrl |
URL de l'image de taille d'aperçu. |
name |
Nom de l'image. Si l'image a été créée à partir d'un élément MediaFile, il s'agit du nom de ce dernier. Si l'image a été créée à partir d'octets, ce champ est vide. |
Champ d'union image . Image à partir de laquelle créer l'annonce illustrée Cela peut être spécifié de deux manières. 1. Ressource MediaFile existante. 2. Données brutes de l'image, en octets image ne peut être qu'un des éléments suivants : |
|
imageAsset |
Composants Image utilisés pour l'annonce. |
data |
Données d'images brutes, en octets. Chaîne encodée en base64. |
adIdToCopyImageFrom |
Identifiant d'annonce à partir duquel l'image doit être copiée. |
AdImageAsset
Composant Image utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de ressource de l'élément de cette image. |
VideoAdInfo
Annonce vidéo.
Représentation JSON |
---|
{ "video": { object ( |
Champs | |
---|---|
video |
Assets vidéo YouTube utilisés pour l'annonce. |
Champ d'union format . Schéma propre au format pour les différents formats vidéo. format ne peut être qu'un des éléments suivants : |
|
inStream |
Format d'annonce vidéo TrueView InStream. |
bumper |
Format d'annonce vidéo InStream bumper. |
outStream |
Format d'annonce vidéo OutStream. |
nonSkippable |
Format d'annonce vidéo InStream non désactivable. |
inFeed |
Format d'annonce vidéo In-Feed. |
AdVideoAsset
Asset vidéo utilisé dans une annonce.
Représentation JSON |
---|
{
"asset": string,
"adVideoAssetInfo": {
object ( |
Champs | |
---|---|
asset |
Nom de ressource de l'élément de cette vidéo. |
adVideoAssetInfo |
Contient des champs d'informations pour cet AdVideoAsset. |
AdVideoAssetInfo
Contient des champs d'informations pour AdVideoAssets.
Représentation JSON |
---|
{
"adVideoAssetInventoryPreferences": {
object ( |
Champs | |
---|---|
adVideoAssetInventoryPreferences |
Liste des préférences d'inventaire pour cet AdVideoAsset. Ce champ ne peut être défini que pour DiscoveryVideoResponsiveAd. Lors de la diffusion, les assets vidéo dont les préférences pour les composants d'inventaire sont définis seront prioritaires par rapport aux autres vidéos de la même annonce. Prenons l'exemple de cette annonce diffusée pour un inventaire spécifique. Le serveur essaie d'abord de mettre en correspondance une vidéo éligible avec une préférence de correspondance pour cet inventaire. Les vidéos sans préférences ne sont sélectionnées que lorsqu'une vidéo ayant les préférences correspondantes et qui est éligible pour un espace publicitaire donné est disponible. |
AdVideoAssetInventoryPreferences
Préférences d'inventaire pour les éléments vidéo YouTube. Balise suivante: 4
Représentation JSON |
---|
{ "inFeedPreference": boolean, "inStreamPreference": boolean, "shortsPreference": boolean } |
Champs | |
---|---|
inFeedPreference |
Lorsque cette option est définie sur "true", l'élément vidéo YouTube associé à cette préférence d'inventaire est prioritaire lors du choix d'une vidéo à diffuser dans le flux. |
inStreamPreference |
Lorsque cette option est définie sur "true", l'élément vidéo YouTube avec cette préférence d'inventaire est prioritaire lors du choix d'une vidéo à diffuser au format InStream. |
shortsPreference |
Lorsque cette option est définie sur "true", l'asset vidéo YouTube avec cette préférence d'inventaire est prioritaire lors du choix d'une vidéo à diffuser sur YouTube Shorts. |
VideoTrueViewInStreamAdInfo
Représentation du format d'annonce vidéo TrueView InStream (annonce diffusée pendant la lecture de la vidéo, souvent au début, qui affiche un bouton "Ignorer" quelques secondes après le début de la vidéo).
Représentation JSON |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
Champs | |
---|---|
actionButtonLabel |
Libellé sur le bouton d'incitation à l'action qui redirige l'utilisateur vers l'URL finale de l'annonce vidéo. Obligatoire pour les campagnes TrueView pour l'action, facultatif dans les autres cas. |
actionHeadline |
Texte supplémentaire affiché avec le bouton d'incitation à l'action pour donner du contexte et encourager les utilisateurs à cliquer sur le bouton |
companionBanner |
Éléments image de la bannière associée utilisée avec l'annonce. |
VideoBumperInStreamAdInfo
Représentation du format d'annonce vidéo InStream non désactivable (annonce vidéo InStream très courte non désactivable).
Représentation JSON |
---|
{
"companionBanner": {
object ( |
Champs | |
---|---|
companionBanner |
Éléments image de la bannière associée utilisée avec l'annonce. |
actionButtonLabel |
Libellé sur le bouton "Incitation à l'action" qui redirige l'utilisateur vers l'URL finale de l'annonce vidéo. |
actionHeadline |
Texte supplémentaire affiché avec le bouton d'incitation à l'action pour donner du contexte et encourager les utilisateurs à cliquer sur le bouton |
VideoOutstreamAdInfo
Représentation du format d'annonce vidéo OutStream (annonce diffusée avec un flux avec lecture automatique, sans son).
Représentation JSON |
---|
{ "headline": string, "description": string } |
Champs | |
---|---|
headline |
Titre de l'annonce. |
description |
Ligne de description. |
VideoNonSkippableInStreamAdInfo
Représentation du format d'annonce vidéo InStream non désactivable (annonce vidéo InStream non désactivable de 15 secondes).
Représentation JSON |
---|
{
"companionBanner": {
object ( |
Champs | |
---|---|
companionBanner |
Éléments image de la bannière associée utilisée avec l'annonce. |
actionButtonLabel |
Libellé sur le bouton "Incitation à l'action" qui redirige l'utilisateur vers l'URL finale de l'annonce vidéo. |
actionHeadline |
Texte supplémentaire affiché avec le bouton "Incitation à l'action" pour fournir du contexte et encourager les utilisateurs à cliquer dessus. |
InFeedVideoAdInfo
Représentation du format d'annonce vidéo In-Feed.
Représentation JSON |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
Champs | |
---|---|
headline |
Titre de l'annonce. |
description1 |
Première ligne de texte de l'annonce. |
description2 |
Deuxième ligne de texte de l'annonce. |
thumbnail |
Miniature de la vidéo à utiliser. |
VideoThumbnail
Énumération répertoriant les types de miniatures de vidéo 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. |
DEFAULT_THUMBNAIL |
Miniature par défaut. Elles peuvent être générées automatiquement ou mises en ligne par les utilisateurs. |
THUMBNAIL_1 |
Miniature 1 générée à partir de la vidéo. |
THUMBNAIL_2 |
Miniature 2, générée à partir de la vidéo |
THUMBNAIL_3 |
Miniature 3, générée à partir de la vidéo. |
VideoResponsiveAdInfo
Annonce vidéo responsive.
Représentation JSON |
---|
{ "headlines": [ { object ( |
Champs | |
---|---|
headlines[] |
Liste des composants texte utilisés pour le titre court. Actuellement, le titre court n'accepte qu'une seule valeur. |
longHeadlines[] |
Liste des composants texte utilisés pour le titre long. Actuellement, le titre long n'accepte qu'une seule valeur. |
descriptions[] |
Liste des composants texte utilisés pour la description. Actuellement, une seule valeur est acceptée pour la description. |
callToActions[] |
Liste des composants texte utilisés pour le bouton (par exemple, le bouton "Incitation à l'action"). Actuellement, une seule valeur est acceptée pour le bouton. |
videos[] |
Liste des éléments vidéo YouTube utilisés pour l'annonce. Actuellement, une seule valeur est acceptée pour l'élément vidéo YouTube. |
companionBanners[] |
Liste des éléments image utilisés pour la bannière associée. Actuellement, une seule valeur est acceptée pour l'élément de bannière associée. |
breadcrumb1 |
Première partie du texte qui apparaît dans l'annonce avec l'URL affichée. |
breadcrumb2 |
Deuxième partie du texte qui apparaît dans l'annonce avec l'URL affichée. |
ResponsiveSearchAdInfo
Annonce responsive sur le Réseau de Recherche.
Les annonces responsives sur le Réseau de Recherche s'adaptent de manière à afficher plus de texte et un message plus pertinent auprès de vos clients. Lorsque vous créez ce type d'annonce, saisissez plusieurs titres et descriptions. Google Ads testera automatiquement différentes combinaisons au fil du temps afin d'identifier les plus performantes. En adaptant leur contenu aux termes de recherche saisis par vos clients potentiels, les annonces responsives sur le Réseau de Recherche peuvent améliorer les performances de votre campagne.
Pour en savoir plus, consultez la page https://support.google.com/google-ads/answer/7684791.
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 |
Première partie du texte pouvant être ajoutée à l'URL dans l'annonce. |
path2 |
Deuxième partie du texte pouvant être ajoutée à l'URL dans l'annonce. Ce champ ne peut être défini que si |
LegacyResponsiveDisplayAdInfo
Une ancienne annonce display responsive. Les annonces de ce type sont associées au libellé "Annonces responsives" dans l'interface utilisateur Google Ads.
Représentation JSON |
---|
{
"formatSetting": enum ( |
Champs | |
---|---|
formatSetting |
Spécifie le format dans lequel l'annonce sera diffusée. La valeur par défaut est ALL_FORMATS. |
shortHeadline |
Version courte du titre de l'annonce. |
longHeadline |
Version longue du titre de l'annonce. |
description |
Description de l'annonce. |
businessName |
Nom de l'entreprise dans l'annonce. |
allowFlexibleColor |
Consentement de l'annonceur pour autoriser la couleur flexible. Si la valeur est "true", l'annonce peut être diffusée avec une couleur différente si nécessaire. Si la valeur est "false", l'annonce est diffusée avec les couleurs spécifiées ou une couleur neutre. La valeur par défaut est |
accentColor |
Couleur d'accentuation de l'annonce au format hexadécimal (#ffffff pour le blanc, par exemple). Si l'une des valeurs |
mainColor |
Couleur principale de l'annonce au format hexadécimal (#ffffff pour le blanc, par exemple). Si l'une des valeurs |
callToActionText |
Texte d'incitation à l'action de l'annonce. |
logoImage |
Nom de ressource MediaFile de l'image du logo utilisée dans l'annonce. |
squareLogoImage |
Nom de ressource MediaFile de l'image du logo carré utilisé dans l'annonce. |
marketingImage |
Nom de ressource MediaFile de l'image marketing utilisée dans l'annonce. |
squareMarketingImage |
Nom de ressource MediaFile de l'image marketing carrée utilisée dans l'annonce. |
pricePrefix |
Préfixe avant le prix. Par exemple, "aussi faible que". |
promoText |
Texte publicitaire utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite en 48h"). |
DisplayAdFormatSetting
Énumère les paramètres de format d'annonce display.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
ALL_FORMATS |
Formats textuels, illustrés et natifs. |
NON_NATIVE |
Formats texte et image |
NATIVE |
Format natif (par exemple, l'affichage du format est contrôlé par l'éditeur et non par Google) |
AppAdInfo
Annonce pour une application.
Représentation JSON |
---|
{ "mandatoryAdText": { object ( |
Champs | |
---|---|
mandatoryAdText |
Texte d'annonce obligatoire. |
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. |
images[] |
Liste des composants Image pouvant s'afficher avec l'annonce. |
youtubeVideos[] |
Liste des assets vidéo YouTube pouvant être affichés avec l'annonce. |
html5MediaBundles[] |
Liste des éléments du kit média qui peuvent être utilisés avec l'annonce. |
AdMediaBundleAsset
Élément du kit média utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de ressource d'élément de ce kit média. |
LegacyAppInstallAdInfo
Une ancienne annonce incitant à installer une application qui ne peut être utilisée que par un petit nombre de clients spécifiques.
Représentation JSON |
---|
{
"appStore": enum ( |
Champs | |
---|---|
appStore |
Plate-forme de téléchargement d'applications sur laquelle l'application mobile est disponible. |
appId |
ID de l'application mobile. |
headline |
Titre de l'annonce. |
description1 |
Première ligne de description de l'annonce. |
description2 |
Deuxième ligne de description de l'annonce. |
LegacyAppInstallAdAppStore
Type de plate-forme de téléchargement d'applications dans une ancienne annonce incitant à installer une application.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
APPLE_APP_STORE |
Apple iTunes. |
GOOGLE_PLAY |
Google Play. |
WINDOWS_STORE |
Windows Store. |
WINDOWS_PHONE_STORE |
Windows Phone Store. |
CN_APP_STORE |
L'application est hébergée sur une plate-forme de téléchargement d'applications chinoise. |
ResponsiveDisplayAdInfo
Annonce display responsive.
Représentation JSON |
---|
{ "marketingImages": [ { object ( |
Champs | |
---|---|
marketingImages[] |
Images marketing à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 600 x 314 et le format doit être 1,91:1 (+-1%). Veuillez indiquer au moins un élément |
squareMarketingImages[] |
Images marketing carrées à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 300 x 300 et le format doit être 1:1 (+-1%). Vous devez ajouter au moins un élément |
logoImages[] |
Images de logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 512 x 128 et le format doit être 4:1 (+-1%). Combiné à |
squareLogoImages[] |
Logos carrés à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 128 x 128 et le format doit être 1:1 (+-1%). Combiné à |
headlines[] |
Titres courts pour l'annonce. Il ne doit pas dépasser 30 caractères. Vous pouvez spécifier au moins un et cinq titres. |
longHeadline |
Titre long obligatoire. Il ne doit pas dépasser 90 caractères. |
descriptions[] |
Texte descriptif de l'annonce. Il ne doit pas dépasser 90 caractères. Vous pouvez spécifier au moins un et cinq titres. |
youtubeVideos[] |
Vidéos YouTube facultatives pour l'annonce. Vous ne pouvez pas spécifier plus de cinq vidéos. |
formatSetting |
Spécifie le format dans lequel l'annonce sera diffusée. La valeur par défaut est ALL_FORMATS. |
controlSpec |
Spécifications relatives aux différentes commandes de création. |
businessName |
Nom de l'annonceur ou de la marque. La largeur d'affichage maximale est de 25. |
mainColor |
Couleur principale de l'annonce au format hexadécimal (#ffffff pour le blanc, par exemple). Si l'une des valeurs |
accentColor |
Couleur d'accentuation de l'annonce au format hexadécimal (#ffffff pour le blanc, par exemple). Si l'une des valeurs |
allowFlexibleColor |
Consentement de l'annonceur pour autoriser la couleur flexible. Si la valeur est "true", l'annonce peut être diffusée avec une couleur différente si nécessaire. Si la valeur est "false", l'annonce est diffusée avec les couleurs spécifiées ou une couleur neutre. La valeur par défaut est |
callToActionText |
Texte d'incitation à l'action de l'annonce. La largeur d'affichage maximale est de 30. |
pricePrefix |
Préfixe avant le prix. Par exemple, "aussi faible que". |
promoText |
Texte publicitaire utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite en 48h"). |
ResponsiveDisplayAdControlSpec
Spécification des différentes commandes de création d'une annonce display responsive.
Représentation JSON |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
Champs | |
---|---|
enableAssetEnhancements |
Indique si l'annonceur a activé la fonctionnalité d'amélioration des assets. |
enableAutogenVideo |
Indique si l'annonceur a activé la génération automatique de vidéos. |
LocalAdInfo
Annonce locale.
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. Vous devez spécifier au moins un titre et cinq titres. |
descriptions[] |
Liste des composants texte pour les descriptions. Lors de la diffusion de l'annonce, les descriptions seront sélectionnées dans cette liste. Vous devez spécifier au moins une description et cinq descriptions au maximum. |
callToActions[] |
Liste des composants texte pour les incitations à l'action. Lors de la diffusion de l'annonce, les incitations à l'action sont sélectionnées dans cette liste. Vous devez spécifier au moins une incitation à l'action et au maximum cinq. |
marketingImages[] |
Liste des composants Image marketing pouvant être affichés avec l'annonce. Les images doivent faire 314 x 600 pixels ou 320 x 320 pixels. Vous devez spécifier au moins 1 et 20 composants Image. |
logoImages[] |
Liste des composants Image de logo pouvant être affichés avec l'annonce. Les images doivent mesurer 128 x 128 pixels et ne pas dépasser 120 Ko. Vous devez spécifier au moins un et cinq composants Image. |
videos[] |
Liste des assets vidéo YouTube pouvant être affichés avec l'annonce. Vous devez spécifier entre 1 et 20 assets vidéo. |
path1 |
Première partie du texte facultatif pouvant être ajoutée à l'URL dans l'annonce. |
path2 |
Deuxième partie du texte facultatif pouvant être ajoutée à l'URL dans l'annonce. Ce champ ne peut être défini que si |
DisplayUploadAdInfo
Type générique d'annonce display. Le format exact de l'annonce est contrôlé par le champ displayUploadProductType
, qui détermine les types de données à inclure dans l'annonce.
Représentation JSON |
---|
{ "displayUploadProductType": enum ( |
Champs | |
---|---|
displayUploadProductType |
Type de produit de cette annonce. Consultez les commentaires sur l'énumération pour plus de détails. |
Champ d'union media_asset . Données sur les composants qui constituent l'annonce. media_asset ne peut être qu'un des éléments suivants : |
|
mediaBundle |
Élément du kit média à utiliser dans l'annonce. Pour en savoir plus sur le kit média pour HTML5_UPLOAD_AD, consultez https://support.google.com/google-ads/answer/1722096. Les kits média qui font partie de types de produits dynamiques utilisent un format spécial qui doit être créé via Google Web Designer. Pour en savoir plus, consultez la page https://support.google.com/webdesigner/answer/7543898. |
DisplayUploadProductType
Énumère les types de produits à importer.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
HTML5_UPLOAD_AD |
Annonce HTML5 à importer. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. |
DYNAMIC_HTML5_EDUCATION_AD |
Annonce HTML5 dynamique pour l'enseignement. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne pédagogique. |
DYNAMIC_HTML5_FLIGHT_AD |
Annonce HTML5 dynamique pour un vol. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peuvent être utilisés que dans une campagne éclair. |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
Annonce HTML5 dynamique pour des hôtels et des locations. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peuvent être utilisées que dans une campagne d'hôtel. |
DYNAMIC_HTML5_JOB_AD |
Annonce d'emploi HTML5 dynamique. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne de jobs. |
DYNAMIC_HTML5_LOCAL_AD |
Annonce locale HTML5 dynamique. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peuvent être utilisées que dans une campagne locale. |
DYNAMIC_HTML5_REAL_ESTATE_AD |
Annonce HTML5 dynamique pour l'immobilier. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne immobilière. |
DYNAMIC_HTML5_CUSTOM_AD |
Annonce personnalisée HTML5 dynamique. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peuvent être utilisées que dans une campagne personnalisée. |
DYNAMIC_HTML5_TRAVEL_AD |
Annonce de voyage HTML5 dynamique. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne de voyage. |
DYNAMIC_HTML5_HOTEL_AD |
Annonce d'hôtel HTML5 dynamique. Pour ce type de produit, vous devez définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peuvent être utilisées que dans une campagne d'hôtel. |
AppEngagementAdInfo
Les annonces ciblant l'engagement avec une application vous permettent de rédiger un texte destiné à encourager une action spécifique dans l'application (par exemple, s'enregistrer, effectuer un achat ou réserver un vol). Elles vous permettent de rediriger les utilisateurs vers une partie spécifique de votre application, où ils peuvent trouver ce qu'ils recherchent plus facilement et plus rapidement.
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. |
images[] |
Liste des composants Image pouvant s'afficher avec l'annonce. |
videos[] |
Liste des composants vidéo pouvant être affichés avec l'annonce. |
ShoppingComparisonListingAdInfo
Annonce de type "Fiche du service de comparateur de prix".
Représentation JSON |
---|
{ "headline": string } |
Champs | |
---|---|
headline |
Titre de l'annonce Ce champ est obligatoire. La longueur autorisée est comprise entre 25 et 45 caractères. |
AppPreRegistrationAdInfo
Les annonces de préinscription à une application redirigent les utilisateurs vers la fiche de votre application ou de votre jeu sur Google Play. Elles peuvent être diffusées sur Google Play, sur YouTube (InStream uniquement), ainsi que dans d'autres applications et sites Web mobiles du Réseau Display. Cela vous aidera à susciter l'intérêt des utilisateurs pour votre application ou votre jeu, et à générer une base d'installations anticipées avant son lancement.
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. |
images[] |
Liste des ID des composants Image dont les images peuvent s'afficher avec l'annonce. |
youtubeVideos[] |
Liste des ID des éléments vidéo YouTube dont les vidéos peuvent être diffusées avec l'annonce. |
DemandGenMultiAssetAdInfo
Une annonce de génération de la demande avec plusieurs composants.
Représentation JSON |
---|
{ "marketingImages": [ { object ( |
Champs | |
---|---|
marketingImages[] |
Composants Image marketing à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 600 x 314 et le format doit être 1,91:1 (+-1%). Obligatoire si squareMarketingImages n'est pas présent. Si vous combinez |
squareMarketingImages[] |
Composants Image marketing carrées à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 300 x 300 et le format doit être 1:1 (+-1%). Obligatoire si marketingImages n'est pas présent. Si vous combinez |
portraitMarketingImages[] |
Composants Image marketing en mode portrait à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 480 x 600 et le format doit être 4:5 (+-1%). Si vous combinez |
logoImages[] |
Composants Image de logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 128 x 128 et le format doit être 1:1 (+-1%). Vous pouvez spécifier au moins une et cinq images de logo. |
headlines[] |
Composant texte Titre de l'annonce. La largeur d'affichage maximale est de 30. Vous pouvez spécifier au moins un et cinq titres. |
descriptions[] |
Texte descriptif de l'annonce. La largeur d'affichage maximale est de 90. Vous pouvez spécifier entre une et cinq descriptions. |
businessName |
Nom de l'annonceur/de la marque. La largeur d'affichage maximale est de 25. Obligatoire. |
callToActionText |
Texte d'incitation à l'action. |
leadFormOnly |
Option booléenne indiquant si cette annonce doit être diffusée avec un formulaire pour prospects. |
DemandGenCarouselAdInfo
Annonce carrousel de génération de la demande.
Représentation JSON |
---|
{ "businessName": string, "logoImage": { object ( |
Champs | |
---|---|
businessName |
Obligatoire. Nom de l'annonceur/de la marque. |
logoImage |
Obligatoire. Image du logo à utiliser dans l'annonce. La taille minimale est 128 x 128 et le format doit être 1:1 (+-1%). |
headline |
Obligatoire. Titre de l'annonce |
description |
Obligatoire. Texte descriptif de l'annonce. |
callToActionText |
Texte d'incitation à l'action. |
carouselCards[] |
Obligatoire. Fiches de carrousel qui s'afficheront avec l'annonce. Min 2 max 10. |
AdDemandGenCarouselCardAsset
Composant d'une fiche de carrousel de génération de la demande utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de ressource d'élément de cette fiche de carrousel de découverte. |
DemandGenVideoResponsiveAdInfo
Annonce vidéo responsive de génération de la demande.
Représentation JSON |
---|
{ "headlines": [ { object ( |
Champs | |
---|---|
headlines[] |
Liste des composants texte utilisés pour le titre court. |
longHeadlines[] |
Liste des composants texte utilisés pour le titre long. |
descriptions[] |
Liste des composants texte utilisés pour la description. |
videos[] |
Liste des éléments vidéo YouTube utilisés pour l'annonce. |
logoImages[] |
Image du logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 128 x 128 et le format doit être 1:1 (+-1%). |
breadcrumb1 |
Première partie du texte qui apparaît dans l'annonce avec l'URL affichée. |
breadcrumb2 |
Deuxième partie du texte qui apparaît dans l'annonce avec l'URL affichée. |
businessName |
Obligatoire. Nom de l'annonceur ou de la marque. |
callToActions[] |
Composants de type CallToActionAsset utilisés pour le bouton "Incitation à l'action". |
AdCallToActionAsset
Composant d'incitation à l'action utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de ressource de ce composant Incitation à l'action. |
DemandGenProductAdInfo
Annonce produit de génération de la demande.
Représentation JSON |
---|
{ "breadcrumb1": string, "breadcrumb2": string, "businessName": { object ( |
Champs | |
---|---|
breadcrumb1 |
Première partie du texte qui apparaît dans l'annonce avec l'URL affichée. |
breadcrumb2 |
Deuxième partie du texte qui apparaît dans l'annonce avec l'URL affichée. |
businessName |
Obligatoire. Nom de l'annonceur ou de la marque. |
headline |
Obligatoire. Composant texte utilisé pour le titre court. |
description |
Obligatoire. Composant texte utilisé pour la description. |
logoImage |
Obligatoire. Image du logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est 128 x 128 et le format doit être 1:1 (+-1%). |
callToAction |
Asset de type CallToActionAsset utilisé pour le bouton "Incitation à l'action". |
TravelAdInfo
Ce type ne comporte aucun champ.
Annonce de voyage.