- 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
- AdAppDeepLinkAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- AppPreRegistrationAdInfo
- DemandGenMultiAssetAdInfo
- DemandGenCarouselAdInfo
- AdDemandGenCarouselCardAsset
- DemandGenVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
Une 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 ont la forme suivante:
|
finalUrls[] |
Liste d'URL finales possibles après toutes les redirections interdomaines de l'annonce. |
finalAppUrls[] |
Liste des URL finales des applications qui seront utilisées sur mobile si l'utilisateur a installé l'application spécifique. |
finalMobileUrls[] |
Liste des URL mobiles finales possibles après toutes les redirections interdomaines de l'annonce. |
urlCustomParameters[] |
Liste des mappages pouvant être utilisés pour remplacer les balises de paramètres personnalisées dans un |
type |
Uniquement en sortie. Type d'annonce. |
devicePreference |
Préférences relatives aux appareils de l'annonce. Vous ne pouvez spécifier de préférence que pour les appareils mobiles. Lorsque cette préférence est définie, l'annonce est diffusée de préférence sur les appareils mobiles. L'annonce peut toujours s'afficher sur d'autres types d'appareils, par exemple si aucune autre annonce n'est disponible. Si aucune préférence n'est spécifiée (pas de préférence d'appareil), tous les appareils sont ciblés. Cette fonctionnalité n'est compatible qu'avec certains types d'annonces. |
urlCollections[] |
URL supplémentaires de 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 cette annonce est gérée par le système, ce champ indique la 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 cette annonce a été ajoutée automatiquement par Google Ads et non par un utilisateur. Par exemple, cela peut se produire lorsque des annonces sont créées automatiquement en tant que suggestions pour 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 concernant le type d'annonce. Vous devez définir une seule valeur. ad_data ne peut être qu'un des éléments suivants : |
|
textAd |
Immuable. Informations sur une annonce textuelle |
expandedTextAd |
Informations concernant une annonce textuelle agrandie. |
callAd |
Informations sur une annonce Appel. |
expandedDynamicSearchAd |
Immuable. Informations concernant une annonce dynamique agrandie du Réseau de Recherche. Le titre, les URL finales et l'URL à afficher de ce type d'annonce 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 concernant une annonce d'hôtel |
shoppingSmartAd |
Informations concernant une annonce Shopping intelligente |
shoppingProductAd |
Informations concernant une annonce Shopping pour un produit. |
imageAd |
Immuable. Informations sur une annonce illustrée. |
videoAd |
Informations sur une annonce vidéo |
videoResponsiveAd |
Informations concernant une annonce vidéo responsive. |
responsiveSearchAd |
Informations sur une annonce responsive sur le Réseau de Recherche. |
legacyResponsiveDisplayAd |
Informations concernant une ancienne annonce display responsive. |
appAd |
Informations sur 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 |
Informations concernant une annonce display importée. |
appEngagementAd |
Informations sur une annonce ciblant l'engagement avec une application. |
shoppingComparisonListingAd |
Informations concernant une annonce Shopping comparateur de prix. |
smartCampaignAd |
Informations concernant une annonce de campagne intelligente |
appPreRegistrationAd |
Informations concernant une annonce pour une application axée sur la préinscription. |
demandGenMultiAssetAd |
Informations concernant une annonce multicomposant de génération de la demande. |
demandGenCarouselAd |
Informations concernant une annonce carrousel de génération de la demande. |
demandGenVideoResponsiveAd |
Informations concernant une annonce vidéo responsive de génération de la demande. |
demandGenProductAd |
Informations concernant une annonce produit de génération de la demande. |
travelAd |
Informations concernant une annonce de voyage |
FinalAppUrl
URL de lien profond vers 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 vers l'application. Les liens profonds spécifient un emplacement dans une application qui correspond au contenu que vous souhaitez afficher. Ils doivent être au format {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 spécifient 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é uniquement pour la valeur renvoyée. Représente la 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 n'est pas connue dans cette version. Il s'agit d'une valeur réservée aux réponses. |
TEXT_AD |
L'annonce est une annonce textuelle. |
EXPANDED_TEXT_AD |
L'annonce est une annonce textuelle agrandie. |
EXPANDED_DYNAMIC_SEARCH_AD |
L'annonce est une annonce dynamique agrandie sur le Réseau de Recherche. |
HOTEL_AD |
L'annonce est une annonce d'hôtel. |
SHOPPING_SMART_AD |
L'annonce est une annonce Shopping intelligente. |
SHOPPING_PRODUCT_AD |
L'annonce est une annonce Shopping standard. |
VIDEO_AD |
L'annonce est une annonce vidéo. |
IMAGE_AD |
Cette annonce est une annonce illustrée. |
RESPONSIVE_SEARCH_AD |
L'annonce est 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 |
L'annonce est une annonce display responsive. |
LOCAL_AD |
L'annonce est une annonce locale. |
HTML5_UPLOAD_AD |
L'annonce est une annonce display importée avec le type de produit HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
L'annonce est une annonce display importée avec l'un des types de produits DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
L'annonce est une annonce ciblant l'engagement avec une application. |
SHOPPING_COMPARISON_LISTING_AD |
L'annonce est une annonce Shopping de type "Fiche du service de comparateur de prix". |
VIDEO_BUMPER_AD |
Annonce vidéo bumper |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Annonce InStream vidéo non désactivable. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
Annonce vidéo TrueView InStream |
VIDEO_RESPONSIVE_AD |
Annonce vidéo responsive. |
SMART_CAMPAIGN_AD |
Annonce de campagne intelligente. |
CALL_AD |
Annonce Appel |
APP_PRE_REGISTRATION_AD |
Annonce de préinscription à une application universelle. |
IN_FEED_VIDEO_AD |
Annonce vidéo In-Feed |
DEMAND_GEN_MULTI_ASSET_AD |
Annonce multicomposant de génération de la demande |
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 taguées 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 de cette instance UrlCollection. |
trackingUrlTemplate |
Modèle d'URL permettant de créer une URL de suivi. |
SystemManagedResourceSource
Énumération listant les sources d'entités gérées par le système possibles.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé uniquement pour la valeur renvoyée. Représente la valeur inconnue dans cette version. |
AD_VARIATIONS |
Annonce du test de 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 apparaître à côté de l'URL affichée de l'annonce. |
path2 |
Texte supplémentaire pouvant s'afficher à côté de l'URL affichée de 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 de l'annonce. |
phoneNumber |
Numéro de téléphone de l'annonce. |
businessName |
Nom de l'établissement dans l'annonce. |
headline1 |
Premier titre de l'annonce. |
headline2 |
Deuxième titre de l'annonce. |
description1 |
Première ligne de la description de l'annonce. |
description2 |
Deuxième ligne de description de l'annonce. |
callTracked |
Indique si le suivi des appels doit être activé pour la création. L'activation du suivi des appels active également les conversions par appel. |
disableCallConversion |
Indique si la conversion par appel doit être désactivée pour la création. Si défini sur |
phoneNumberVerificationUrl |
URL à utiliser pour valider le numéro de téléphone. |
conversionAction |
Action de conversion à laquelle attribuer une conversion d'appel. Si aucune valeur n'est définie, une action de conversion par défaut est utilisée. Ce champ n'a d'effet que si |
conversionReportingState |
Comportement de conversion d'appel de cette annonce Appel. Il peut utiliser son propre paramètre de conversion par appel, hériter du paramètre au niveau du compte ou être désactivé. |
path1 |
Première partie du texte pouvant être ajoutée à l'URL de l'annonce. Facultatif. |
path2 |
Deuxième partie du texte pouvant être ajoutée à l'URL de l'annonce. Ce champ ne peut être défini que lorsque |
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 pour un 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 de l'image en taille réelle, en pixels. |
pixelHeight |
Hauteur en pixels de l'image en taille réelle. |
imageUrl |
URL de l'image en taille réelle. |
previewPixelWidth |
Largeur de l'image de taille d'aperçu, en pixels. |
previewPixelHeight |
Hauteur de l'image de taille d'aperçu, en pixels. |
previewImageUrl |
URL de l'image en taille d'aperçu. |
name |
Nom de l'image. Si l'image a été créée à partir d'un MediaFile, il s'agit du nom de ce MediaFile. 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'ImageAd. Vous pouvez le spécifier de deux manières. 1. Ressource MediaFile existante. 2. Données d'image brutes sous forme d'octets. image ne peut être qu'un des éléments suivants : |
|
imageAsset |
Composants d'image utilisés pour l'annonce. |
data |
Données d'image brutes sous forme d'octets. Chaîne encodée en base64. |
adIdToCopyImageFrom |
ID de l'annonce à partir de laquelle l'image doit être copiée. |
AdImageAsset
Composant Image utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de la ressource Asset de cette image. |
VideoAdInfo
Une annonce vidéo
Représentation JSON |
---|
{ "video": { object ( |
Champs | |
---|---|
video |
Éléments vidéo YouTube utilisés pour l'annonce. |
Champ d'union format . Schéma spécifique aux 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 InStream vidéo non désactivable. |
inFeed |
Format d'annonce vidéo In-Feed. |
AdVideoAsset
Élément vidéo utilisé dans une annonce.
Représentation JSON |
---|
{
"asset": string,
"adVideoAssetInfo": {
object ( |
Champs | |
---|---|
asset |
Nom de la ressource d'élément de cette vidéo. |
adVideoAssetInfo |
Contient les champs d'informations de 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. Les composants vidéo pour lesquels une préférence d'inventaire a été définie seront privilégiés par rapport aux autres vidéos de la même annonce au moment de la diffusion. Imaginons que cette annonce soit diffusée pour un inventaire spécifique. Le serveur tente d'abord de faire correspondre une vidéo éligible à une préférence correspondant à cet inventaire. Les vidéos sans préférences ne sont sélectionnées que lorsqu'une vidéo avec une préférence correspondante et éligible à un espace publicitaire donné est disponible. |
AdVideoAssetInventoryPreferences
Préférences d'inventaire pour les éléments vidéo YouTube
Représentation JSON |
---|
{ "inFeedPreference": boolean, "inStreamPreference": boolean, "shortsPreference": boolean } |
Champs | |
---|---|
inFeedPreference |
Si cette valeur est définie sur "True", l'élément vidéo YouTube associé à cette préférence d'inventaire sera privilégié lorsque vous choisirez une vidéo à diffuser dans le flux. |
inStreamPreference |
Si cette valeur est définie sur "true", l'élément vidéo YouTube associé à cette préférence d'inventaire sera privilégié lorsque vous choisirez une vidéo à diffuser dans InStream. |
shortsPreference |
Si cette valeur est définie sur "true", l'élément vidéo YouTube avec cette préférence d'inventaire sera privilégié lorsque vous choisirez 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é du bouton d'incitation à l'action redirigeant l'utilisateur vers l'URL finale de l'annonce vidéo. Obligatoire pour les campagnes TrueView pour l'action, facultatif dans le cas contraire. |
actionHeadline |
Texte supplémentaire affiché avec le bouton d'incitation à l'action pour donner du contexte et inciter à cliquer sur le bouton. |
companionBanner |
Composants Image de la bannière associée utilisée avec l'annonce. |
VideoBumperInStreamAdInfo
Représentation du format d'annonce InStream bumper (annonce vidéo InStream très courte et non désactivable).
Représentation JSON |
---|
{
"companionBanner": {
object ( |
Champs | |
---|---|
companionBanner |
Composants Image de la bannière associée utilisée avec l'annonce. |
actionButtonLabel |
Libellé du bouton "Incitation à l'action" redirigeant 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 inciter à cliquer sur le bouton. |
VideoOutstreamAdInfo
Représentation du format d'annonce vidéo OutStream (annonce diffusée à côté d'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 InStream vidéo non désactivable (annonce vidéo InStream non désactivable de 15 secondes).
Représentation JSON |
---|
{
"companionBanner": {
object ( |
Champs | |
---|---|
companionBanner |
Composants Image de la bannière associée utilisée avec l'annonce. |
actionButtonLabel |
Libellé du bouton "Incitation à l'action" redirigeant 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 inciter à cliquer sur le bouton. |
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 |
Image de la miniature de la vidéo à utiliser. |
VideoThumbnail
Énumération listant les types de miniatures de vidéos possibles.
Enums | |
---|---|
UNSPECIFIED |
Le type n'a pas été spécifié. |
UNKNOWN |
La valeur reçue n'est pas connue dans cette version. Il s'agit d'une valeur réservée aux réponses. |
DEFAULT_THUMBNAIL |
Vignette par défaut. Peut être généré automatiquement ou importé par l'utilisateur. |
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, une seule valeur est acceptée pour le titre court. |
longHeadlines[] |
Liste des composants texte utilisés pour le titre long. Actuellement, une seule valeur est acceptée pour le titre long. |
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 composants vidéo YouTube utilisés pour l'annonce. Actuellement, une seule valeur est acceptée pour l'asset vidéo YouTube. |
companionBanners[] |
Liste des composants Image utilisés pour la bannière associée. Actuellement, une seule valeur est acceptée pour l'asset de bannière associée. |
breadcrumb1 |
Première partie du texte qui s'affiche dans l'annonce avec l'URL affichée. |
breadcrumb2 |
Deuxième partie du texte qui s'affiche 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 le contenu de vos annonces aux termes de recherche de 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 https://support.google.com/google-ads/answer/7684791.
Représentation JSON |
---|
{ "headlines": [ { object ( |
Champs | |
---|---|
headlines[] |
Liste des composants texte pour les titres. Lorsque l'annonce est diffusée, les titres sont sélectionnés dans cette liste. |
descriptions[] |
Liste des composants texte pour les descriptions. Lorsque l'annonce est diffusée, les descriptions sont sélectionnées dans cette liste. |
path1 |
Première partie du texte pouvant être ajoutée à l'URL de l'annonce. |
path2 |
Deuxième partie du texte pouvant être ajoutée à l'URL de l'annonce. Ce champ ne peut être défini que lorsque |
LegacyResponsiveDisplayAdInfo
Ancienne annonce display responsive Les annonces de ce type sont libellées "Annonces responsives" dans l'interface utilisateur de Google Ads.
Représentation JSON |
---|
{
"formatSetting": enum ( |
Champs | |
---|---|
formatSetting |
Indique 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'établissement dans l'annonce. |
allowFlexibleColor |
Consentement de l'annonceur pour autoriser la couleur flexible. Si cette valeur est définie sur "true", l'annonce peut être diffusée avec une couleur différente si nécessaire. Si la valeur est "false", l'annonce sera 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 en hexadécimal (par exemple, #ffffff pour le blanc). Si l'une des valeurs |
mainColor |
Couleur principale de l'annonce en hexadécimal (par exemple, #ffffff pour le blanc). Si l'une des valeurs |
callToActionText |
Texte d'incitation à l'action de l'annonce. |
logoImage |
Nom de la ressource MediaFile de l'image du logo utilisée dans l'annonce. |
squareLogoImage |
Nom de la ressource MediaFile de l'image du logo carré utilisée dans l'annonce. |
marketingImage |
Nom de la ressource MediaFile de l'image marketing utilisée dans l'annonce. |
squareMarketingImage |
Nom de la ressource MediaFile de l'image marketing carrée utilisée dans l'annonce. |
pricePrefix |
Préfixe avant le prix. (par exemple, "à partir de"). |
promoText |
Texte promotionnel utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite sous deux jours"). |
DisplayAdFormatSetting
Énumère les paramètres des formats d'annonces display.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
ALL_FORMATS |
Texte, images et formats natifs |
NON_NATIVE |
Formats de texte et d'image |
NATIVE |
Par exemple, pour les formats natifs, le rendu 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. Lorsque l'annonce est diffusée, les titres sont sélectionnés dans cette liste. |
descriptions[] |
Liste des composants texte pour les descriptions. Lorsque l'annonce est diffusée, les descriptions sont sélectionnées dans cette liste. |
images[] |
Liste des composants Image pouvant être diffusés avec l'annonce. |
youtubeVideos[] |
Liste des composants vidéo YouTube pouvant être diffusés avec l'annonce. |
html5MediaBundles[] |
Liste des composants du lot multimédia pouvant être utilisés avec l'annonce. |
appDeepLink |
Élément du lien profond vers l'application pouvant être utilisé avec l'annonce. |
AdMediaBundleAsset
Composant de kit média utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de la ressource Asset de ce lot multimédia. |
AdAppDeepLinkAsset
Lien profond vers une application utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de la ressource d'élément de cet élément de lien profond vers l'application. |
LegacyAppInstallAdInfo
Annonce d'installation d'application ancienne qui ne peut être utilisée que par quelques clients sélectionnés.
Représentation JSON |
---|
{
"appStore": enum ( |
Champs | |
---|---|
appStore |
Plate-forme 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é uniquement pour la valeur renvoyée. Représente la 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 de 600 x 314 pixels, et le format doit être de 1,91:1 (+-1%). Vous devez indiquer au moins un |
squareMarketingImages[] |
Images marketing carrées à utiliser dans l'annonce Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est de 300 x 300 pixels, et le format doit être de 1:1 (+-1%). Vous devez indiquer au moins un carré |
logoImages[] |
Images de logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est de 512 x 128, et le format doit être de 4:1 (+-1%). Combiné à |
squareLogoImages[] |
Images de logo carrées à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est de 128 x 128 pixels, et le format doit être de 1:1 (+-1%). Combiné à |
headlines[] |
Titres courts pour l'annonce. La longueur maximale est de 30 caractères. Vous pouvez spécifier au moins un et cinq titres maximum. |
longHeadline |
Titre long obligatoire. La longueur maximale est de 90 caractères. |
descriptions[] |
Textes descriptifs de l'annonce La longueur maximale est de 90 caractères. Vous pouvez spécifier au moins un et cinq titres maximum. |
youtubeVideos[] |
Vidéos YouTube facultatives pour l'annonce. Vous pouvez spécifier un maximum de cinq vidéos. |
formatSetting |
Indique le format dans lequel l'annonce sera diffusée. La valeur par défaut est ALL_FORMATS. |
controlSpec |
Spécifications pour différentes commandes de création. |
businessName |
Nom de l'annonceur/de la marque. La largeur d'affichage maximale est de 25. |
mainColor |
Couleur principale de l'annonce en hexadécimal (par exemple, #ffffff pour le blanc). Si l'une des valeurs |
accentColor |
Couleur d'accentuation de l'annonce en hexadécimal (par exemple, #ffffff pour le blanc). Si l'une des valeurs |
allowFlexibleColor |
Consentement de l'annonceur pour autoriser la couleur flexible. Si cette valeur est définie sur "true", l'annonce peut être diffusée avec une couleur différente si nécessaire. Si la valeur est "false", l'annonce sera 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, "à partir de"). |
promoText |
Texte promotionnel utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite sous deux jours"). |
ResponsiveDisplayAdControlSpec
Spécifications pour différentes fonctionnalités 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 composants. |
enableAutogenVideo |
Indique si l'annonceur a activé la fonctionnalité de création automatique de vidéos. |
LocalAdInfo
Annonce locale
Représentation JSON |
---|
{ "headlines": [ { object ( |
Champs | |
---|---|
headlines[] |
Liste des composants texte pour les titres. Lorsque l'annonce est diffusée, les titres sont sélectionnés dans cette liste. Vous devez spécifier au moins un et au plus cinq titres. |
descriptions[] |
Liste des composants texte pour les descriptions. Lorsque l'annonce est diffusée, les descriptions sont sélectionnées dans cette liste. Vous devez spécifier au moins une description et au maximum cinq. |
callToActions[] |
Liste des composants texte pour les incitations à l'action. Lorsque l'annonce est diffusée, les incitations à l'action sont sélectionnées dans cette liste. Vous devez spécifier au moins un et au maximum cinq incitations à l'action. |
marketingImages[] |
Liste des composants Image marketing pouvant être affichés avec l'annonce. Les images doivent mesurer 314 x 600 pixels ou 320 x 320 pixels. Vous devez spécifier au moins un et au plus 20 éléments 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 au plus cinq composants Image. |
videos[] |
Liste des composants vidéo YouTube pouvant être diffusés avec l'annonce. Vous devez spécifier au moins un et au plus 20 éléments vidéo. |
path1 |
Première partie du texte facultatif pouvant être ajouté à l'URL de l'annonce. |
path2 |
Deuxième partie du texte facultatif pouvant être ajouté à l'URL de l'annonce. Ce champ ne peut être défini que lorsque |
DisplayUploadAdInfo
Type générique d'annonce display. Le format d'annonce exact est contrôlé par le champ displayUploadProductType
, qui détermine les types de données à inclure avec l'annonce.
Représentation JSON |
---|
{ "displayUploadProductType": enum ( |
Champs | |
---|---|
displayUploadProductType |
Type de produit de cette annonce. Pour en savoir plus, consultez les commentaires sur l'énumération. |
Champ d'union media_asset . Données des composants qui constituent l'annonce. media_asset ne peut être qu'un des éléments suivants : |
|
mediaBundle |
Élément de kit média à utiliser dans l'annonce. Pour en savoir plus sur le lot multimédia pour HTML5_UPLOAD_AD, consultez la page https://support.google.com/google-ads/answer/1722096. Les lots multimédias 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 https://support.google.com/webdesigner/answer/7543898. |
DisplayUploadProductType
Énumère les types de produits display à 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, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. |
DYNAMIC_HTML5_EDUCATION_AD |
Annonce HTML5 dynamique pour l'enseignement. Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne d'information. |
DYNAMIC_HTML5_FLIGHT_AD |
Annonce HTML5 dynamique pour les vols Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne de vol. |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
Annonce HTML5 dynamique pour hôtels et locations Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne d'hôtel. |
DYNAMIC_HTML5_JOB_AD |
Annonce d'offre d'emploi HTML5 dynamique. Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne d'offre d'emploi. |
DYNAMIC_HTML5_LOCAL_AD |
Annonce locale HTML5 dynamique. Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne locale. |
DYNAMIC_HTML5_REAL_ESTATE_AD |
Annonce HTML5 dynamique pour l'immobilier Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne immobilière. |
DYNAMIC_HTML5_CUSTOM_AD |
Annonce personnalisée HTML5 dynamique Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne personnalisée. |
DYNAMIC_HTML5_TRAVEL_AD |
Annonce de voyage HTML5 dynamique. Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé que dans une campagne de voyage. |
DYNAMIC_HTML5_HOTEL_AD |
Annonce HTML5 dynamique pour un hôtel Pour ce type de produit, le champ upload_media_bundle dans DisplayUploadAdInfo doit être défini. Ne peut être utilisé 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 billet d'avion). Ils vous permettent d'envoyer 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. Lorsque l'annonce est diffusée, les titres sont sélectionnés dans cette liste. |
descriptions[] |
Liste des composants texte pour les descriptions. Lorsque l'annonce est diffusée, les descriptions sont sélectionnées dans cette liste. |
images[] |
Liste des composants Image pouvant être diffusés avec l'annonce. |
videos[] |
Liste des composants vidéo pouvant être diffusés avec l'annonce. |
ShoppingComparisonListingAdInfo
Annonce Shopping 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 proposent un lien vers la fiche de votre application ou de votre jeu sur Google Play. Elles peuvent être diffusées sur Google Play, YouTube (InStream uniquement), et dans d'autres applications et sites Web mobiles du Réseau Display. Vous susciterez ainsi l'intérêt des utilisateurs pour votre application ou votre jeu et commencerez à sécuriser des installations avant son lancement.
Représentation JSON |
---|
{ "headlines": [ { object ( |
Champs | |
---|---|
headlines[] |
Liste des composants texte pour les titres. Lorsque l'annonce est diffusée, les titres sont sélectionnés dans cette liste. |
descriptions[] |
Liste des composants texte pour les descriptions. Lorsque l'annonce est diffusée, les descriptions sont sélectionnées dans cette liste. |
images[] |
Liste des ID des composants Image dont les images peuvent être diffusées avec l'annonce. |
youtubeVideos[] |
Liste des ID d'éléments vidéo YouTube dont les vidéos peuvent être diffusées avec l'annonce. |
DemandGenMultiAssetAdInfo
Annonce multicomposant de génération de la demande.
Représentation JSON |
---|
{ "marketingImages": [ { object ( |
Champs | |
---|---|
marketingImages[] |
Composants d'image marketing à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est de 600 x 314 pixels, et le format doit être de 1,91:1 (+-1%). Obligatoire si squareMarketingImages n'est pas présent. Combiné à |
squareMarketingImages[] |
Composants Image marketing carrés à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est de 300 x 300 pixels, et le format doit être de 1:1 (+-1%). Obligatoire si marketingImages n'est pas présent. Combiné à |
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 de 480 x 600 pixels, et le format doit être de 4:5 (+-1%). Combiné à |
tallPortraitMarketingImages[] |
Composants Image marketing de grande taille en mode portrait à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est de 600 x 1 067, et le format doit être de 9:16 (+-1%). Combiné à |
logoImages[] |
Éléments d'image de logo à utiliser dans l'annonce. Les types d'images valides sont GIF, JPEG et PNG. La taille minimale est de 128 x 128 pixels, et le format doit être de 1:1 (+-1%). Vous pouvez spécifier au moins une image de logo et cinq au maximum. |
headlines[] |
Composant texte du titre de l'annonce. La largeur d'affichage maximale est de 30. Vous pouvez spécifier au moins un et cinq titres maximum. |
descriptions[] |
Texte descriptif de l'annonce. La largeur d'affichage maximale est de 90. Vous pouvez spécifier au moins une et cinq descriptions au maximum. |
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 de 128 x 128 pixels, et le format doit être de 1:1 (+-1%). |
headline |
Obligatoire. Titre de l'annonce |
description |
Obligatoire. Texte descriptif de l'annonce. |
callToActionText |
Texte d'incitation à l'action. |
carouselCards[] |
Obligatoire. Cartes du carrousel qui s'affichent avec l'annonce. (entre 2 et 10) |
AdDemandGenCarouselCardAsset
Composant de fiche de carrousel de génération de la demande utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de la ressource Asset de cette fiche du carrousel Discovery. |
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 composants 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 de 128 x 128 pixels, et le format doit être de 1:1 (+-1%). |
breadcrumb1 |
Première partie du texte qui s'affiche dans l'annonce avec l'URL affichée. |
breadcrumb2 |
Deuxième partie du texte qui s'affiche dans l'annonce avec l'URL affichée. |
businessName |
Obligatoire. Nom de l'annonceur/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 la ressource de l'asset de ce composant d'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 s'affiche dans l'annonce avec l'URL affichée. |
breadcrumb2 |
Deuxième partie du texte qui s'affiche dans l'annonce avec l'URL affichée. |
businessName |
Obligatoire. Nom de l'annonceur/de la marque. |
headline |
Obligatoire. Composant texte utilisé pour le titre court. |
description |
Obligatoire. Élément de 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 de 128 x 128 pixels, et le format doit être de 1:1 (+-1%). |
callToAction |
Composant de type CallToActionAsset utilisé pour le bouton "Incitation à l'action". |
TravelAdInfo
Ce type ne comporte aucun champ.
Annonce de voyage.