- Ressource: Annonce
- FinalAppUrl
- AppUrlOperatingSystemType
- CustomParameter
- AdType
- Appareil
- UrlCollection
- SystemManagedResourceSource
- TextAdInfo
- ExpandedTextAdInfo
- CallAdInfo
- CallConversionReportingState
- ExpandedDynamicSearchAdInfo
- HotelAdInfo
- ShoppingSmartAdInfo
- ShoppingProductAdInfo
- ImageAdInfo
- MimeType
- AdImageAsset
- VideoAdInfo
- AdVideoAsset
- VideoTrueViewInStreamAdInfo
- VideoBumperInStreamAdInfo
- VideoOutstreamAdInfo
- VideoNonSkippableInStreamAdInfo
- InFeedVideoAdInfo
- VideoThumbnail
- VideoResponsiveAdInfo
- AdTextAsset
- ServedAssetFieldType
- AssetPerformanceLabel
- AdAssetPolicySummary
- PolicyTopicEntry
- PolicyTopicEntryType
- PolicyTopicEvidence
- WebsiteList
- TextList
- DestinationTextList
- DestinationMismatch
- PolicyTopicEvidenceDestinationMismatchUrlType
- DestinationNotWorking
- PolicyTopicEvidenceDestinationNotWorkingDevice
- PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
- PolicyTopicConstraint
- CountryConstraintList
- CountryConstraint
- ResellerConstraint
- PolicyReviewStatus
- PolicyApprovalStatus
- ResponsiveSearchAdInfo
- LegacyResponsiveDisplayAdInfo
- DisplayAdFormatSetting
- AppAdInfo
- AdMediaBundleAsset
- LegacyAppInstallAdInfo
- LegacyAppInstallAdAppStore
- ResponsiveDisplayAdInfo
- ResponsiveDisplayAdControlSpec
- LocalAdInfo
- DisplayUploadAdInfo
- DisplayUploadProductType
- AppEngagementAdInfo
- ShoppingComparisonListingAdInfo
- SmartCampaignAdInfo
- AppPreRegistrationAdInfo
- DiscoveryMultiAssetAdInfo
- DiscoveryCarouselAdInfo
- AdDiscoveryCarouselCardAsset
- DiscoveryVideoResponsiveAdInfo
- AdCallToActionAsset
- DemandGenProductAdInfo
- TravelAdInfo
- Méthodes
Ressource: Ad
Une annonce.
Représentation JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
Champs | |
---|---|
resourceName |
Immuable. Nom de ressource de l'annonce. Le nom des ressources d'annonces se présente sous la forme suivante:
|
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 spécifique. |
finalMobileUrls[] |
Liste des URL finales pour mobile possibles après toutes les redirections via un autre domaine pour l'annonce. |
urlCustomParameters[] |
Liste des mappages pouvant être utilisés pour remplacer les balises de paramètres personnalisés dans |
type |
Uniquement en sortie. Type d'annonce. |
devicePreference |
Préférences relatives aux appareils pour l'annonce. Vous ne pouvez indiquer une préférence que pour les appareils mobiles. Lorsque cette préférence est définie, l'annonce est prioritaire par rapport aux autres lorsqu'elle est diffusée sur un appareil mobile. 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 acceptée que pour certains types d'annonces. |
urlCollections[] |
URL supplémentaires de l'annonce, comportant 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 indiquera 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. Cela peut se produire, par exemple, lorsque des annonces sont automatiquement créées 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 concernant une annonce textuelle agrandie. |
callAd |
Informations concernant 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 lors de la diffusion pour ce type d'annonce, 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 produit Shopping. |
imageAd |
Immuable. Informations concernant 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 |
Détails concernant une ancienne annonce display responsive. |
appAd |
Informations concernant une annonce pour une application. |
legacyAppInstallAd |
Immuable. Détails concernant une ancienne annonce incitant à installer une application. |
responsiveDisplayAd |
Informations concernant une annonce display responsive. |
localAd |
Détails concernant une annonce locale. |
displayUploadAd |
Détails concernant une annonce display importée. |
appEngagementAd |
Informations concernant une annonce ciblant l'engagement avec une application. |
shoppingComparisonListingAd |
Informations concernant une annonce comparateur de prix Shopping. |
smartCampaignAd |
Détails concernant les annonces d'une campagne intelligente. |
appPreRegistrationAd |
Informations concernant une annonce de préinscription à une application |
discoveryMultiAssetAd |
Détails concernant une annonce Discovery à plusieurs éléments. |
discoveryCarouselAd |
Détails concernant une annonce carrousel Discovery. |
discoveryVideoResponsiveAd |
Détails concernant une annonce vidéo Discovery responsive. |
demandGenProductAd |
Détails concernant une annonce produit de génération de la demande. |
travelAd |
Détails 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 votre 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 son nom. 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é pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
IOS |
Le système d'exploitation Apple IOS. |
ANDROID |
Le système d'exploitation Android |
CustomParameter
Mappage pouvant être utilisé par les balises de paramètres personnalisés dans trackingUrlTemplate
, finalUrls
ou mobile_final_urls
.
Représentation JSON |
---|
{ "key": string, "value": string } |
Champs | |
---|---|
key |
Clé correspondant au nom du tag du paramètre. |
value |
Valeur à remplacer. |
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 de réponse uniquement. |
TEXT_AD |
L'annonce est une annonce textuelle. |
EXPANDED_TEXT_AD |
Il s'agit d'une annonce textuelle agrandie. |
EXPANDED_DYNAMIC_SEARCH_AD |
L'annonce est une annonce dynamique agrandie du 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 |
L'annonce est une annonce vidéo. |
IMAGE_AD |
Cette annonce est une annonce illustrée. |
RESPONSIVE_SEARCH_AD |
L'annonce est 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 à importer 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 |
L'annonce est une annonce comparateur de prix Shopping. |
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 pour 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. |
DISCOVERY_MULTI_ASSET_AD |
Annonce multi-élément Discovery. |
DISCOVERY_CAROUSEL_AD |
Annonce carrousel Discovery. |
TRAVEL_AD |
Annonce de voyage |
DISCOVERY_VIDEO_RESPONSIVE_AD |
Annonce vidéo responsive pour Discovery. |
DEMAND_GEN_PRODUCT_AD |
Annonce produit de génération de la demande. |
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 |
UrlCollection
Ensemble d'URL taguées à l'aide d'un identifiant unique.
Représentation JSON |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
Champs | |
---|---|
finalUrls[] |
Une liste des URL finales possibles. |
finalMobileUrls[] |
Une 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 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 test de variantes d'annonces générée. |
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 qui peut s'afficher à côté de l'URL de l'annonce. |
path2 |
Texte supplémentaire qui peut s'afficher à côté de l'URL 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 |
Le code pays de l'annonce. |
phoneNumber |
Numéro de téléphone dans l'annonce. |
businessName |
Nom de l'entreprise 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 |
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 |
Indique si la conversion par appel doit être désactivée pour la création. Si la valeur est |
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 de conversion par appel de cette annonce Appel. Elle peut utiliser son propre paramètre de conversion par appel, hériter du paramètre au niveau du compte ou être désactivée. |
path1 |
Première partie de texte pouvant être ajoutée à l'URL dans l'annonce. Facultatif. |
path2 |
Deuxième partie de texte pouvant être ajoutée à l'URL dans l'annonce. Ce champ ne peut être défini que si |
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). |
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 dans la taille de l'aperçu. |
previewPixelHeight |
Hauteur en pixels de la taille de l'aperçu de l'image. |
previewImageUrl |
URL de l'image de la 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 fichier. 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 brutes de l'image, exprimées en octets. image ne peut être qu'un des éléments suivants : |
|
imageAsset |
Composants Image utilisés pour l'annonce. |
data |
Données d'image brutes en octets. Chaîne encodée en base64. |
adIdToCopyImageFrom |
Identifiant de l'annonce à partir de laquelle copier l'image. |
MimeType
Type MIME
Enums | |
---|---|
UNSPECIFIED |
Le type MIME n'a pas été spécifié. |
UNKNOWN |
La valeur reçue n'est pas connue 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 ou du GIF. |
IMAGE_PNG |
Type MIME de l'image/png. |
FLASH |
Type MIME de l'application/x-shockwave-flash. |
TEXT_HTML |
Type MIME de text/html. |
PDF |
Type MIME de l'application/pdf. |
MSWORD |
Type MIME de l'application/msword. |
MSEXCEL |
Type MIME de l'application 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 application/x-html5-ad-zip. |
AdImageAsset
Composant Image utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de la ressource d'asset 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 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 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 } |
Champs | |
---|---|
asset |
Nom de ressource de l'asset pour cette vidéo. |
VideoTrueViewInStreamAdInfo
Représentation du format d'annonce vidéo TrueView InStream (annonce diffusée pendant la lecture d'une vidéo, souvent au début, avec un bouton "Ignorer" affiché pendant quelques secondes).
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 les autres cas. |
actionHeadline |
Texte supplémentaire affiché avec le bouton d'incitation à l'action pour fournir du contexte et encourager les utilisateurs à cliquer sur le bouton. |
companionBanner |
Assets image de la bannière associée utilisée avec l'annonce. |
VideoBumperInStreamAdInfo
Représentation du format d'annonce vidéo InStream bumper (annonce vidéo InStream très courte non désactivable).
Représentation JSON |
---|
{
"companionBanner": {
object ( |
Champs | |
---|---|
companionBanner |
Assets 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 fournir du contexte et encourager les utilisateurs à 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 vidéo InStream non désactivable (annonce vidéo InStream non désactivable de 15 secondes).
Représentation JSON |
---|
{
"companionBanner": {
object ( |
Champs | |
---|---|
companionBanner |
Assets 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 "Incitation à l'action" pour fournir 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 miniature de la vidéo à utiliser. |
VideoThumbnail
Énumération répertoriant les types possibles d'une miniature de vidéo.
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 de réponse uniquement. |
DEFAULT_THUMBNAIL |
Vignette par défaut. Elles peuvent être générées automatiquement ou mises en ligne 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 assets vidéo YouTube utilisés pour l'annonce. Actuellement, une seule valeur est acceptée pour l'asset 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. |
AdTextAsset
Asset texte utilisé dans une annonce.
Représentation JSON |
---|
{ "pinnedField": enum ( |
Champs | |
---|---|
pinnedField |
Champ épinglé de l'asset. Ainsi, le composant ne sera diffusé que dans ce champ. Vous pouvez épingler plusieurs composants au même champ. Un élément retiré ou épinglé à un autre champ ne s'affichera pas dans un champ où un autre élément a été épinglé. |
assetPerformanceLabel |
Libellé de performances de ce composant texte. |
policySummaryInfo |
Résumé des règles de cet élément texte. |
text |
Texte de l'asset. |
ServedAssetFieldType
Types de champs d'éléments 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 de réponse uniquement. |
HEADLINE_1 |
Le composant est utilisé dans le titre 1. |
HEADLINE_2 |
Le composant est utilisé dans le titre 2. |
HEADLINE_3 |
Le composant est utilisé dans le titre 3. |
DESCRIPTION_1 |
L'élément est utilisé dans la description 1. |
DESCRIPTION_2 |
L'asset est utilisé dans la description 2. |
HEADLINE |
Le composant a été utilisé dans un titre. N'utilisez cette option que si l'annonce ne comporte qu'un seul titre. Sinon, utilisez les énumérations HEADLINE_1, HEADLINE_2 ou HEADLINE_3. |
HEADLINE_IN_PORTRAIT |
L'asset a été utilisé comme titre dans une image en mode portrait. |
LONG_HEADLINE |
L'asset a été utilisé dans un titre long (utilisé dans MultiAssetResponsiveAd). |
DESCRIPTION |
L'asset a été utilisé dans une description. N'utilisez cette option que si l'annonce ne comporte qu'une seule description. Sinon, utilisez les énumérations DESCRIPTION_1 ou DESCRIPTION_@. |
DESCRIPTION_IN_PORTRAIT |
L'asset a été utilisé comme description dans une image en mode portrait. |
BUSINESS_NAME_IN_PORTRAIT |
Le composant a été utilisé comme nom de l'entreprise dans une 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 image en mode portrait. |
SQUARE_MARKETING_IMAGE |
L'asset a été utilisé comme image marketing carrée. |
PORTRAIT_MARKETING_IMAGE |
L'asset a été utilisé comme image marketing en mode portrait. |
LOGO |
L'asset 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é comme vidéo YouTube. |
SITELINK |
Ce composant est utilisé comme lien annexe. |
CALL |
Ce composant est utilisé pour un appel. |
MOBILE_APP |
Ce composant est utilisé en tant qu'application mobile. |
CALLOUT |
Ce composant est utilisé en tant qu'accroche. |
STRUCTURED_SNIPPET |
Ce composant est utilisé comme extrait structuré. |
PRICE |
Ce composant est utilisé comme prix. |
PROMOTION |
Ce composant est utilisé comme promotion. |
AD_IMAGE |
Ce composant est utilisé en tant qu'image. |
LEAD_FORM |
Le composant est utilisé comme formulaire pour prospects. |
BUSINESS_LOGO |
Le composant est utilisé comme logo d'entreprise. |
AssetPerformanceLabel
Énumération décrivant les libellés de performances possibles d'un composant, généralement calculé dans le contexte d'une association.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version. |
PENDING |
Cet élément ne dispose pas encore d'informations sur les performances. Il est possible qu'elle soit toujours en cours d'examen. |
LEARNING |
L'asset a commencé à générer des impressions, mais les statistiques ne sont pas suffisamment pertinentes d'un point de vue statistique pour obtenir un libellé de performances. |
LOW |
Composants les moins performants. |
GOOD |
Composants performants. |
BEST |
Composants les plus performants. |
AdAssetPolicySummary
Contient des informations sur les règles relatives à un élément inclus dans une annonce.
Représentation JSON |
---|
{ "policyTopicEntries": [ { object ( |
Champs | |
---|---|
policyTopicEntries[] |
Liste des résultats concernant les règles pour cet élément. |
reviewStatus |
Emplacement du processus d'examen pour ce composant. |
approvalStatus |
État d'approbation général de ce composant, calculé en fonction de l'état des différentes entrées concernant des thèmes de règles spécifiques. |
PolicyTopicEntry
Constatation liée à une ressource (par exemple, la règle associée à un site qui vend de l'alcool)
Chaque PolicyTopicEntry est associée à un sujet qui indique le règlement spécifique relatif aux annonces concerné, ainsi qu'un type indiquant son effet sur la diffusion. Il peut éventuellement comporter une ou plusieurs preuves indiquant la raison du résultat. Elle peut également comporter une ou plusieurs contraintes indiquant comment la diffusion peut être limitée.
Représentation JSON |
---|
{ "type": enum ( |
Champs | |
---|---|
type |
Décrit l'impact négatif ou positif de cette règle sur la diffusion. |
evidences[] |
Informations supplémentaires expliquant le résultat d'un cas de non-respect des règles (par exemple, le nom d'une marque) |
constraints[] |
Indique les conséquences sur la diffusion de cette ressource (par exemple, si elle n'est pas diffusée dans un pays). |
topic |
Sujet de la règle auquel ce résultat fait référence. Par exemple, "ALCOHOL", "TRADEMARKS_IN_AD_TEXT" ou "DESTINATION_NOT_WORKING". L'ensemble des thèmes de règles possibles n'est pas corrigé pour une version particulière de l'API et peut être modifié à tout moment. |
PolicyTopicEntryType
Types d'entrées de thèmes de règles 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 de réponse uniquement. |
PROHIBITED |
La ressource ne sera pas diffusée. |
LIMITED |
Dans certaines circonstances, la ressource ne sera pas diffusée. |
FULLY_LIMITED |
La ressource ne peut pas du tout être diffusée en raison des critères de ciblage actuels. |
DESCRIPTIVE |
Peut présenter un intérêt, mais ne limite pas le mode de diffusion de la ressource. |
BROADENING |
Augmentation de la couverture au-delà de la normale. |
AREA_OF_INTEREST_ONLY |
Limite pour tous les pays ciblés, mais peut être diffusée dans d'autres pays en fonction de la zone d'intérêt. |
PolicyTopicEvidence
Informations supplémentaires expliquant un résultat de non-respect des règles.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union value . Informations spécifiques aux preuves en fonction du type de preuve. value ne peut être qu'un des éléments suivants : |
|
websiteList |
Liste des sites Web liés à cette ressource. |
textList |
Liste de preuves trouvées dans le texte d'une ressource. |
languageCode |
Langue dans laquelle la ressource a été détectée. Il s'agit d'un tag de langue IETF (par exemple, "en-US"). |
destinationTextList |
Texte de la destination de la ressource à l'origine d'un résultat de stratégie. |
destinationMismatch |
Les destinations des URL d'une ressource ne correspondent pas. |
destinationNotWorking |
Informations détaillées lorsque la destination renvoie un code d'erreur HTTP ou ne fonctionne pas dans toutes les zones géographiques des appareils couramment utilisés |
WebsiteList
Liste des sites Web à l'origine d'un résultat de non-respect des règles. Utilisé pour le thème de règle ONE_WEBSITE_PER_AD_GROUP, par exemple. S'il y a plus de cinq sites Web, seuls les cinq premiers (ceux qui figurent le plus dans les ressources) sont listés ici.
Représentation JSON |
---|
{ "websites": [ string ] } |
Champs | |
---|---|
websites[] |
Sites Web à l'origine du résultat du règlement. |
TextList
Liste des fragments de texte qui ne respectent pas une règle.
Représentation JSON |
---|
{ "texts": [ string ] } |
Champs | |
---|---|
texts[] |
Fragments de texte de la ressource à l'origine du résultat de la règle. |
DestinationTextList
Liste de chaînes sur une page de destination ayant entraîné un résultat de non-respect des règles.
Représentation JSON |
---|
{ "destinationTexts": [ string ] } |
Champs | |
---|---|
destinationTexts[] |
Liste des textes trouvés sur la page de destination de la ressource. |
DestinationMismatch
Preuve de non-concordance des URL d'une ressource.
Représentation JSON |
---|
{
"urlTypes": [
enum ( |
Champs | |
---|---|
urlTypes[] |
Ensemble d'URL qui ne correspondent pas. |
PolicyTopicEvidenceDestinationMismatchUrlType
Types d'URL de destination possibles pour la preuve du règlement.
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 de réponse uniquement. |
DISPLAY_URL |
URL à afficher |
FINAL_URL |
URL finale. |
FINAL_MOBILE_URL |
URL finale pour mobile. |
TRACKING_URL |
Modèle d'URL de suivi, avec l'URL pour ordinateur remplacée. |
MOBILE_TRACKING_URL |
Modèle d'URL de suivi, avec l'URL mobile remplacée. |
DestinationNotWorking
Données probantes lorsque la destination renvoie un code d'erreur HTTP ou ne fonctionne pas dans toutes les zones géographiques des appareils couramment utilisés.
Représentation JSON |
---|
{ "device": enum ( |
Champs | |
---|---|
device |
Type d'appareil pour lequel l'URL n'a pas pu être chargée. |
expandedUrl |
URL complète qui n'a pas fonctionné. |
lastCheckedDateTime |
Heure de la dernière vérification de l'URL. Le format est "AAAA-MM-JJ HH:MM:SS". Exemples: "2018-03-05 09:15:00" ou "2018-02-01 14:34:30" |
Champ d'union reason . Indique la raison du résultat de la règle DESTINATION_NOT_WORKING. reason ne peut être qu'un des éléments suivants : |
|
dnsErrorType |
Type d'erreur DNS. |
httpErrorCode |
Code d'erreur HTTP. |
PolicyTopicEvidenceDestinationNotWorkingDevice
La destination potentielle des preuves concernant le sujet du règlement ne fonctionne pas sur les appareils.
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 de réponse uniquement. |
DESKTOP |
La page de destination ne fonctionne pas sur les ordinateurs. |
ANDROID |
La page de destination ne fonctionne pas sur les appareils Android. |
IOS |
La page de destination ne fonctionne pas sur les appareils iOS. |
PolicyTopicEvidenceDestinationNotWorkingDnsErrorType
Types d'erreurs DNS possibles pour la destination de preuve du sujet de la règle qui ne fonctionne pas.
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 de réponse uniquement. |
HOSTNAME_NOT_FOUND |
Nom d'hôte introuvable dans le DNS lors de la récupération de la page de destination. |
GOOGLE_CRAWLER_DNS_ISSUE |
Problème avec le robot d'exploration interne de Google lors de la communication avec le DNS. Cette erreur ne signifie pas que la page de destination ne fonctionne pas. Google réexplorera la page de destination. |
PolicyTopicConstraint
Décrit l'effet d'une entrée de sujet de règle sur l'inférence.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union value . Informations spécifiques sur la contrainte. value ne peut être qu'un des éléments suivants : |
|
countryConstraintList |
Pays dans lesquels la ressource ne peut pas être diffusée. |
resellerConstraint |
Contrainte revendeur. |
certificateMissingInCountryList |
Pays dans lesquels un certificat est requis pour la diffusion. |
certificateDomainMismatchInCountryList |
Pays dans lesquels le domaine de la ressource n'est pas couvert par les certificats associés. |
CountryConstraintList
Liste des pays où la diffusion d'une ressource est limitée.
Représentation JSON |
---|
{
"countries": [
{
object ( |
Champs | |
---|---|
countries[] |
Pays dans lesquels la diffusion est limitée. |
totalTargetedCountries |
Nombre total de pays ciblés par la ressource. |
CountryConstraint
Indique que la capacité d'une ressource à être diffusée dans un pays particulier est limitée.
Représentation JSON |
---|
{ "countryCriterion": string } |
Champs | |
---|---|
countryCriterion |
Nom de ressource constant de la cible géographique du pays dans lequel la diffusion est limitée. |
ResellerConstraint
Ce type ne comporte aucun champ.
Des restrictions ont été appliquées à un sujet du règlement, car le site Web a été refusé à des fins de revendeur.
PolicyReviewStatus
États possibles de vérification du respect des règles.
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 de réponse uniquement. |
REVIEW_IN_PROGRESS |
En cours d'examen. |
REVIEWED |
Examen principal terminé. D'autres examens peuvent se poursuivre. |
UNDER_APPEAL |
La ressource a été renvoyée pour approbation, ou vous avez fait appel de sa décision liée aux règles. |
ELIGIBLE_MAY_SERVE |
La ressource est éligible et peut être diffusée, mais elle peut encore faire l'objet d'un examen plus approfondi. |
PolicyApprovalStatus
États d'approbation des règles possibles. Lorsque plusieurs états d'approbation sont disponibles, le plus grave est utilisé. L'ordre de gravité est DISAPPROVED, AREA_OF_INTEREST_ONLY, APPROVED_LIMITED et APPROVED.
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 de réponse uniquement. |
DISAPPROVED |
Ne sera pas diffusé. |
APPROVED_LIMITED |
Diffusion soumise à des restrictions. |
APPROVED |
Diffusion sans restrictions. |
AREA_OF_INTEREST_ONLY |
Ne sera pas diffusée dans les pays ciblés, mais pourra l'être auprès des utilisateurs qui recherchent des informations sur les pays ciblés. |
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 de texte pouvant être ajoutée à l'URL dans l'annonce. |
path2 |
Deuxième partie de texte pouvant être ajoutée à l'URL dans l'annonce. Ce champ ne peut être défini que si |
LegacyResponsiveDisplayAdInfo
Ancienne annonce display responsive. Les annonces de ce type sont signalées par le 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 autorisant la couleur flexible. Lorsque 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 dans les couleurs spécifiées ou dans une couleur neutre. La valeur par défaut est |
accentColor |
Couleur d'accentuation de l'annonce au format hexadécimal (par exemple, #ffffff pour le blanc). Si |
mainColor |
Couleur principale de l'annonce au format hexadécimal (par exemple, #ffffff pour le blanc). Si |
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ée 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 bas que". |
promoText |
Texte publicitaire utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite en 48h"). |
DisplayAdFormatSetting
Énumère les paramètres du format d'annonce display.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
ALL_FORMATS |
Annonces textuelles, illustrées et natives. |
NON_NATIVE |
Formats textuels et illustrés. |
NATIVE |
Le format natif (par exemple, 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. 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 être affichés 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
Asset de kit média utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de ressource de l'asset de ce kit média. |
LegacyAppInstallAdInfo
Une ancienne annonce incitant à installer une application qui ne peut être utilisée que par un nombre limité de clients.
Représentation JSON |
---|
{
"appStore": enum ( |
Champs | |
---|---|
appStore |
Plate-forme de téléchargement d'applications dans 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
Une 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%). 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%). Si elle est associée à |
squareLogoImages[] |
Images de logos carrées à 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%). Si elle est associée à |
headlines[] |
Titres courts pour l'annonce. Il ne doit pas dépasser 30 caractères. Vous pouvez spécifier entre un et cinq titres. |
longHeadline |
Titre long obligatoire. Il ne doit pas dépasser 90 caractères. |
descriptions[] |
Textes descriptifs de l'annonce. Il ne doit pas dépasser 90 caractères. Vous pouvez spécifier entre un et cinq titres. |
youtubeVideos[] |
Vidéos YouTube facultatives pour l'annonce. Vous pouvez spécifier jusqu'à 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 pour 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 (par exemple, #ffffff pour le blanc). Si |
accentColor |
Couleur d'accentuation de l'annonce au format hexadécimal (par exemple, #ffffff pour le blanc). Si |
allowFlexibleColor |
Consentement de l'annonceur autorisant la couleur flexible. Lorsque 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 dans les couleurs spécifiées ou dans 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 bas que". |
promoText |
Texte publicitaire utilisé pour les formats dynamiques des annonces responsives. (par exemple, "Livraison gratuite en 48h"). |
ResponsiveDisplayAdControlSpec
Spécifications concernant les 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 fonctionnalité vidéo de génération automatique. |
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 entre un 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 saisir entre une et cinq descriptions. |
callToActions[] |
Liste des composants texte pour les incitations à l'action. Lorsque l'annonce sera diffusée, les incitations à l'action seront sélectionnées dans cette liste. Vous devez spécifier entre une et 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 entre 1 et 20 composants Image. |
logoImages[] |
Liste des composants Image du logo pouvant être affichés avec l'annonce. Les images doivent faire 128 x 128 pixels et ne pas dépasser 120 ko. Vous devez spécifier entre un et cinq composants Image. |
videos[] |
Liste des assets vidéo YouTube pouvant être affichés avec l'annonce. Vous devez spécifier entre un et 20 assets vidéo. |
path1 |
Première partie de texte facultatif qui peut être ajouté à l'URL dans l'annonce. |
path2 |
Deuxième partie du texte facultatif qui peut être ajouté à l'URL dans l'annonce. Ce champ ne peut être défini que si |
DisplayUploadAdInfo
Type d'annonce display générique. Le format exact 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. Pour en savoir plus, consultez les commentaires de l'énumération. |
Champ d'union media_asset . Données des composants qui composent l'annonce. media_asset ne peut être qu'un des éléments suivants : |
|
mediaBundle |
Asset de kit média à utiliser dans l'annonce. Pour en savoir plus sur le kit média pour HTML5_UPLOAD_AD, consultez l'article 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 display à importer.
Enums | |
---|---|
UNSPECIFIED |
Non spécifié. |
UNKNOWN |
La valeur est inconnue dans cette version. |
HTML5_UPLOAD_AD |
Annonce HTML5 à importer. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. |
DYNAMIC_HTML5_EDUCATION_AD |
Annonce pédagogique HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne éducative. |
DYNAMIC_HTML5_FLIGHT_AD |
Annonce HTML5 dynamique pour la diffusion d'annonces. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne de diffusion. |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
Annonce HTML5 dynamique pour hôtels et locations. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne d'hôtel. |
DYNAMIC_HTML5_JOB_AD |
Annonce d'emploi HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne d'offres d'emploi. |
DYNAMIC_HTML5_LOCAL_AD |
Annonce locale HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne locale. |
DYNAMIC_HTML5_REAL_ESTATE_AD |
Annonce immobilière HTML5 dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne immobilière. |
DYNAMIC_HTML5_CUSTOM_AD |
Annonce HTML5 personnalisée dynamique. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. Ne peut être utilisé que dans une campagne personnalisée. |
DYNAMIC_HTML5_TRAVEL_AD |
Annonce de voyage HTML5 dynamique. Ce type de produit nécessite de 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. Ce type de produit nécessite de définir le champ "upload_media_bundle" dans DisplayUploadAdInfo. 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 encourageant une action spécifique dans l'application, comme faire son check-in, effectuer un achat ou réserver un billet d'avion. Elles vous permettent de rediriger les utilisateurs vers une section spécifique de votre application où ils peuvent trouver plus facilement et plus rapidement ce qu'ils cherchent.
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 être affichés avec l'annonce. |
videos[] |
Liste des assets vidéo pouvant être affichés avec l'annonce. |
ShoppingComparisonListingAdInfo
Annonce comparateur de prix Shopping.
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. |
SmartCampaignAdInfo
Annonce pour une campagne intelligente.
Représentation JSON |
---|
{ "headlines": [ { object ( |
Champs | |
---|---|
headlines[] |
Liste de composants texte, chacun correspondant à un titre lors de la diffusion de l'annonce. Cette liste comprend entre 3 et 15 composants texte. |
descriptions[] |
Liste des composants texte, chacun correspondant à une description lors de la diffusion de l'annonce. Cette liste comprend entre deux et quatre composants texte. |
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 sur 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'installation anticipée pour votre application ou votre jeu 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 de composants Image dont les images peuvent s'afficher avec l'annonce. |
youtubeVideos[] |
Liste des ID d'éléments vidéo YouTube dont les vidéos peuvent être diffusées avec l'annonce. |
DiscoveryMultiAssetAdInfo
Annonce Discovery à plusieurs éléments.
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. Combinée à |
squareMarketingImages[] |
Composants Image marketing carrée à 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. Combinée à |
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%). Combinée à |
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 entre une et cinq images de logo. |
headlines[] |
Composant texte de titre de l'annonce. La largeur d'affichage maximale est de 30. Vous pouvez spécifier entre un et cinq titres. |
descriptions[] |
Texte descriptif de l'annonce. La largeur d'affichage maximale est de 90. Vous pouvez saisir entre une et cinq descriptions. |
businessName |
Nom de l'annonceur ou de la marque. La largeur d'affichage maximale est de 25. Obligatoire. |
callToActionText |
Texte d'incitation à l'action. |
leadFormOnly |
Option booléenne qui indique si cette annonce doit être diffusée avec un formulaire pour prospects. |
DiscoveryCarouselAdInfo
Annonce carrousel Discovery.
Représentation JSON |
---|
{ "businessName": string, "logoImage": { object ( |
Champs | |
---|---|
businessName |
Obligatoire. Nom de l'annonceur ou 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. 2 au minimum, 10 au maximum. |
AdDiscoveryCarouselCardAsset
Élément de fiche de carrousel Discovery utilisé dans une annonce.
Représentation JSON |
---|
{ "asset": string } |
Champs | |
---|---|
asset |
Nom de la ressource d'asset de cette fiche de carrousel Discovery. |
DiscoveryVideoResponsiveAdInfo
Annonce vidéo Discovery responsive.
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 assets 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 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 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. Asset texte utilisé pour le titre court. |
description |
Obligatoire. Asset 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 |
Composant de type CallToActionAsset utilisé pour le bouton "Incitation à l'action". |
TravelAdInfo
Ce type ne comporte aucun champ.
Annonce de voyage
Méthodes |
|
---|---|
|
Affiche l'annonce demandée dans les moindres détails. |
|
Met à jour les annonces. |