- Rappresentazione 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
Un annuncio.
Rappresentazione JSON |
---|
{ "resourceName": string, "finalUrls": [ string ], "finalAppUrls": [ { object ( |
Campi | |
---|---|
resourceName |
Immutabile. Il nome della risorsa dell'annuncio. I nomi delle risorse annuncio hanno il seguente formato:
|
finalUrls[] |
L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio. |
finalAppUrls[] |
Un elenco di URL finali dell'app che verranno utilizzati sui dispositivi mobili se l'utente ha installato l'app specifica. |
finalMobileUrls[] |
L'elenco dei possibili URL mobile finali dopo tutti i reindirizzamenti tra domini per l'annuncio. |
urlCustomParameters[] |
L'elenco delle mappature che possono essere utilizzate per sostituire i tag dei parametri personalizzati in un |
type |
Solo output. Il tipo di annuncio. |
devicePreference |
La preferenza del dispositivo per l'annuncio. Puoi specificare una preferenza solo per i dispositivi mobili. Quando questa preferenza è impostata, l'annuncio avrà la precedenza sugli altri annunci quando viene visualizzato su un dispositivo mobile. L'annuncio può comunque essere visualizzato su altri tipi di dispositivi, ad esempio se non sono disponibili altri annunci. Se non specificato (nessuna preferenza per il dispositivo), tutti i dispositivi sono scelti come target. Questa opzione è supportata solo da alcuni tipi di annunci. |
urlCollections[] |
URL aggiuntivi per l'annuncio codificati con un identificatore univoco a cui è possibile fare riferimento da altri campi dell'annuncio. |
systemManagedResourceSource |
Solo output. Se l'annuncio è gestito dal sistema, questo campo indica l'origine. Questo campo è di sola lettura. |
id |
Solo output. L'ID dell'annuncio. |
trackingUrlTemplate |
Il modello di URL per la creazione di un URL di monitoraggio. |
finalUrlSuffix |
Il suffisso da utilizzare per creare un URL finale. |
displayUrl |
L'URL visualizzato nella descrizione dell'annuncio per alcuni formati. |
addedByGoogleAds |
Solo output. Indica se l'annuncio è stato aggiunto automaticamente da Google Ads e non da un utente. Ad esempio, questo potrebbe accadere quando gli annunci vengono creati automaticamente come suggerimenti per nuovi annunci in base al rendimento degli annunci esistenti. |
name |
Immutabile. Il nome dell'annuncio. Viene utilizzato solo per poter identificare l'annuncio. Non deve essere univoco e non influisce sull'annuncio pubblicato. Al momento, il campo name è supportato solo per DisplayUploadAd, ImageAd, ShoppingComparisonListingAd e VideoAd. |
Campo unione ad_data . Dettagli pertinenti al tipo di annuncio. È necessario impostare un solo valore. ad_data può essere solo uno dei seguenti: |
|
textAd |
Immutabile. Dettagli relativi a un annuncio di testo. |
expandedTextAd |
Dettagli relativi a un annuncio di testo espanso. |
callAd |
Dettagli relativi a un annuncio di chiamata. |
expandedDynamicSearchAd |
Immutabile. Dettagli relativi a un annuncio dinamico della rete di ricerca espanso. Il titolo, gli URL finali e l'URL di visualizzazione di questo tipo di annuncio vengono generati automaticamente al momento della pubblicazione in base alle informazioni specifiche del nome di dominio fornite da |
hotelAd |
Dettagli relativi a un annuncio per hotel. |
shoppingSmartAd |
Dettagli relativi a un annuncio Shopping intelligente. |
shoppingProductAd |
Dettagli relativi a un annuncio Shopping prodotto. |
imageAd |
Immutabile. Dettagli relativi a un annuncio illustrato. |
videoAd |
Dettagli relativi a un annuncio video. |
videoResponsiveAd |
Dettagli relativi a un annuncio video adattabile. |
responsiveSearchAd |
Dettagli relativi a un annuncio adattabile della rete di ricerca. |
legacyResponsiveDisplayAd |
Dettagli relativi a un annuncio display adattabile precedente. |
appAd |
Dettagli relativi a un annuncio per app. |
legacyAppInstallAd |
Immutabile. Dettagli relativi a un annuncio per l'installazione di app precedente. |
responsiveDisplayAd |
Dettagli relativi a un annuncio display adattabile. |
localAd |
Dettagli relativi a un annuncio locale. |
displayUploadAd |
Dettagli relativi a un annuncio display caricato. |
appEngagementAd |
Dettagli relativi a un annuncio di coinvolgimento in app. |
shoppingComparisonListingAd |
Dettagli relativi a un annuncio per il confronto Shopping. |
smartCampaignAd |
Dettagli relativi a un annuncio di una campagna intelligente. |
appPreRegistrationAd |
Dettagli relativi a un annuncio di preregistrazione per app. |
demandGenMultiAssetAd |
Dettagli relativi a un annuncio multi asset Demand Gen. |
demandGenCarouselAd |
Dettagli relativi a un annuncio carosello Demand Gen. |
demandGenVideoResponsiveAd |
Dettagli relativi a un annuncio video adattabile Demand Gen. |
demandGenProductAd |
Dettagli relativi a un annuncio di prodotto Demand Gen. |
travelAd |
Dettagli relativi a un annuncio di viaggi. |
FinalAppUrl
Un URL per i link diretti a un'app per il sistema operativo specificato.
Rappresentazione JSON |
---|
{
"osType": enum ( |
Campi | |
---|---|
osType |
Il sistema operativo scelto come target da questo URL. Obbligatorio. |
url |
L'URL del link diretto all'app. I link diretti specificano una posizione in un'app corrispondente ai contenuti che vuoi mostrare e devono avere il seguente formato: {schema}://{percorso_host}. Lo schema identifica l'app da aprire. Per la tua app, puoi utilizzare uno schema personalizzato che inizia con il nome dell'app. L'host e il percorso specificano la posizione univoca dell'app in cui si trovano i tuoi contenuti. Esempio: "exampleapp://productid_1234". Obbligatorio. |
AppUrlOperatingSystemType
Sistema operativo
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione. |
IOS |
Il sistema operativo Apple iOS. |
ANDROID |
Il sistema operativo Android. |
AdType
I possibili tipi di annuncio.
Enum | |
---|---|
UNSPECIFIED |
Non è stato specificato alcun valore. |
UNKNOWN |
Il valore ricevuto non è noto in questa versione. Questo è un valore solo per la risposta. |
TEXT_AD |
L'annuncio è di tipo di testo. |
EXPANDED_TEXT_AD |
L'annuncio è un annuncio di testo espanso. |
EXPANDED_DYNAMIC_SEARCH_AD |
L'annuncio è un annuncio dinamico della rete di ricerca espanso. |
HOTEL_AD |
L'annuncio è un annuncio per hotel. |
SHOPPING_SMART_AD |
L'annuncio è un annuncio Shopping intelligente. |
SHOPPING_PRODUCT_AD |
L'annuncio è un annuncio Shopping standard. |
VIDEO_AD |
L'annuncio è un annuncio video. |
IMAGE_AD |
Questo è un annuncio illustrato. |
RESPONSIVE_SEARCH_AD |
L'annuncio è un annuncio adattabile della rete di ricerca. |
LEGACY_RESPONSIVE_DISPLAY_AD |
L'annuncio è un annuncio display adattabile precedente. |
APP_AD |
L'annuncio sia un annuncio per app. |
LEGACY_APP_INSTALL_AD |
L'annuncio è un annuncio per l'installazione di app precedente. |
RESPONSIVE_DISPLAY_AD |
L'annuncio è un annuncio display adattabile. |
LOCAL_AD |
L'annuncio sia un annuncio locale. |
HTML5_UPLOAD_AD |
L'annuncio è un annuncio da caricamento display con il tipo di prodotto HTML5_UPLOAD_AD. |
DYNAMIC_HTML5_AD |
L'annuncio è un annuncio display da caricamento con uno dei tipi di prodotto DYNAMIC_HTML5_*. |
APP_ENGAGEMENT_AD |
L'annuncio sia un annuncio di coinvolgimento in app. |
SHOPPING_COMPARISON_LISTING_AD |
L'annuncio è un annuncio Shopping per la scheda di confronto. |
VIDEO_BUMPER_AD |
Annuncio video bumper. |
VIDEO_NON_SKIPPABLE_IN_STREAM_AD |
Annuncio in-stream non ignorabile video. |
VIDEO_TRUEVIEW_IN_STREAM_AD |
Annuncio video TrueView in-stream. |
VIDEO_RESPONSIVE_AD |
Annuncio video adattabile. |
SMART_CAMPAIGN_AD |
Annuncio della campagna intelligente. |
CALL_AD |
Annuncio di chiamata. |
APP_PRE_REGISTRATION_AD |
Annuncio di preregistrazione di app universale. |
IN_FEED_VIDEO_AD |
Annuncio video in-feed. |
DEMAND_GEN_MULTI_ASSET_AD |
Annuncio multi asset Demand Gen. |
DEMAND_GEN_CAROUSEL_AD |
Annuncio carosello Demand Gen. |
TRAVEL_AD |
Annuncio di viaggi. |
DEMAND_GEN_VIDEO_RESPONSIVE_AD |
Annuncio video adattabile Demand Gen. |
DEMAND_GEN_PRODUCT_AD |
Annuncio di prodotto Demand Gen. |
UrlCollection
Raccolta di URL codificati con un identificatore univoco.
Rappresentazione JSON |
---|
{ "finalUrls": [ string ], "finalMobileUrls": [ string ], "urlCollectionId": string, "trackingUrlTemplate": string } |
Campi | |
---|---|
finalUrls[] |
Un elenco di possibili URL finali. |
finalMobileUrls[] |
Un elenco di possibili URL mobile finali. |
urlCollectionId |
Identificatore univoco per questa istanza di UrlCollection. |
trackingUrlTemplate |
Modello di URL per la creazione di un URL di monitoraggio. |
SystemManagedResourceSource
Enum che elenca le possibili origini entità gestite dal sistema.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione. |
AD_VARIATIONS |
Annuncio dell'esperimento sulle varianti di annunci generate. |
TextAdInfo
Un annuncio di testo.
Rappresentazione JSON |
---|
{ "headline": string, "description1": string, "description2": string } |
Campi | |
---|---|
headline |
Titolo dell'annuncio. |
description1 |
La prima riga della descrizione dell'annuncio. |
description2 |
La seconda riga della descrizione dell'annuncio. |
ExpandedTextAdInfo
Un annuncio di testo espanso.
Rappresentazione JSON |
---|
{ "headlinePart1": string, "headlinePart2": string, "headlinePart3": string, "description": string, "description2": string, "path1": string, "path2": string } |
Campi | |
---|---|
headlinePart1 |
La prima parte del titolo dell'annuncio. |
headlinePart2 |
La seconda parte del titolo dell'annuncio. |
headlinePart3 |
La terza parte del titolo dell'annuncio. |
description |
La descrizione dell'annuncio. |
description2 |
La seconda descrizione dell'annuncio. |
path1 |
Il testo che può essere visualizzato accanto all'URL visualizzato dell'annuncio. |
path2 |
Testo aggiuntivo che può essere visualizzato accanto all'URL visualizzato dell'annuncio. |
CallAdInfo
Un annuncio di chiamata.
Rappresentazione 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 ( |
Campi | |
---|---|
countryCode |
Il codice paese nell'annuncio. |
phoneNumber |
Il numero di telefono nell'annuncio. |
businessName |
Il nome dell'attività nell'annuncio. |
headline1 |
Primo titolo nell'annuncio. |
headline2 |
Secondo titolo dell'annuncio. |
description1 |
La prima riga della descrizione dell'annuncio. |
description2 |
La seconda riga della descrizione dell'annuncio. |
callTracked |
Indica se attivare il monitoraggio delle chiamate per la creatività. L'attivazione del monitoraggio delle chiamate consente anche le conversioni di chiamata. |
disableCallConversion |
Indica se disattivare la conversione di chiamata per la creatività. Se impostato su |
phoneNumberVerificationUrl |
L'URL da utilizzare per la verifica del numero di telefono. |
conversionAction |
L'azione di conversione a cui attribuire una conversione di chiamata. Se non viene impostata, viene utilizzata un'azione di conversione predefinita. Questo campo ha effetto solo se |
conversionReportingState |
Il comportamento di conversione delle chiamate di questo annuncio di chiamata. Può utilizzare la propria impostazione di conversione di chiamata, ereditare l'impostazione a livello di account o essere disattivata. |
path1 |
Prima parte di testo che può essere aggiunta all'URL nell'annuncio. Facoltativo. |
path2 |
Seconda parte di testo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche |
ExpandedDynamicSearchAdInfo
Un annuncio dinamico della rete di ricerca espanso.
Rappresentazione JSON |
---|
{ "description": string, "description2": string } |
Campi | |
---|---|
description |
La descrizione dell'annuncio. |
description2 |
La seconda descrizione dell'annuncio. |
HotelAdInfo
Questo tipo non contiene campi.
Un annuncio per hotel.
ShoppingSmartAdInfo
Questo tipo non contiene campi.
Un annuncio Shopping intelligente.
ShoppingProductAdInfo
Questo tipo non contiene campi.
Un annuncio Shopping standard.
ImageAdInfo
Un annuncio illustrato.
Rappresentazione JSON |
---|
{ "mimeType": enum ( |
Campi | |
---|---|
mimeType |
Il tipo MIME dell'immagine. |
pixelWidth |
Larghezza in pixel dell'immagine a grandezza originale. |
pixelHeight |
Altezza in pixel dell'immagine a grandezza originale. |
imageUrl |
URL dell'immagine a grandezza originale. |
previewPixelWidth |
Larghezza in pixel dell'immagine delle dimensioni di anteprima. |
previewPixelHeight |
Altezza in pixel dell'immagine nelle dimensioni di anteprima. |
previewImageUrl |
URL dell'immagine nelle dimensioni di anteprima. |
name |
Il nome dell'immagine. Se l'immagine è stata creata da un MediaFile, questo è il nome del MediaFile. Se l'immagine è stata creata da byte, questo campo è vuoto. |
Campo unione image . L'immagine da cui creare l'annuncio illustrativo. Questo valore può essere specificato in due modi. 1. Una risorsa MediaFile esistente. 2. I dati non elaborati delle immagini sotto forma di byte. image può essere solo uno dei seguenti: |
|
imageAsset |
Gli asset immagine utilizzati per l'annuncio. |
data |
Dati non elaborati delle immagini sotto forma di byte. Una stringa con codifica Base64. |
adIdToCopyImageFrom |
Un ID annuncio da cui copiare l'immagine. |
AdImageAsset
Un asset immagine utilizzato all'interno di un annuncio.
Rappresentazione JSON |
---|
{ "asset": string } |
Campi | |
---|---|
asset |
Il nome della risorsa Asset di questa immagine. |
VideoAdInfo
Un annuncio video.
Rappresentazione JSON |
---|
{ "video": { object ( |
Campi | |
---|---|
video |
Gli asset video di YouTube utilizzati per l'annuncio. |
Campo unione format . Schema specifico per i diversi formati video. format può essere solo uno dei seguenti: |
|
inStream |
Formato dell'annuncio video TrueView in-stream. |
bumper |
Formato dell'annuncio video bumper in-stream. |
outStream |
Formato dell'annuncio video outstream. |
nonSkippable |
Formato dell'annuncio in-stream non ignorabile video. |
inFeed |
Formato dell'annuncio video in-feed. |
AdVideoAsset
Un asset video utilizzato all'interno di un annuncio.
Rappresentazione JSON |
---|
{
"asset": string,
"adVideoAssetInfo": {
object ( |
Campi | |
---|---|
asset |
Il nome della risorsa asset di questo video. |
adVideoAssetInfo |
Contiene i campi di informazioni per questo asset video dell'annuncio. |
AdVideoAssetInfo
Contiene campi di informazioni per gli asset video dell'annuncio.
Rappresentazione JSON |
---|
{
"adVideoAssetInventoryPreferences": {
object ( |
Campi | |
---|---|
adVideoAssetInventoryPreferences |
Elenco delle preferenze di inventario per questa risorsa video dell'annuncio. Questo campo può essere impostato solo per DiscoveryVideoResponsiveAd. Gli asset video con una preferenza per gli asset dell'inventario impostata avranno la precedenza sugli altri video dello stesso annuncio durante la pubblicazione. Ad esempio, considera questo annuncio pubblicato per un inventario specifico. Il server cercherà prima di trovare una corrispondenza per un video idoneo con una preferenza corrispondente per quell'inventario. I video senza preferenze vengono scelti solo quando non è possibile trovare un video con preferenze corrispondenti e idoneo per un determinato spazio pubblicitario. |
AdVideoAssetInventoryPreferences
Preferenze dell'inventario degli asset video di YouTube.
Rappresentazione JSON |
---|
{ "inFeedPreference": boolean, "inStreamPreference": boolean, "shortsPreference": boolean } |
Campi | |
---|---|
inFeedPreference |
Se il valore è true, l'asset video di YouTube con questa preferenza di inventario avrà la priorità quando si sceglie un video da pubblicare in-feed. |
inStreamPreference |
Se il valore è true, l'asset video di YouTube con questa preferenza di inventario avrà la priorità quando si sceglie un video da pubblicare in-stream. |
shortsPreference |
Se il valore è true, l'asset video di YouTube con questa preferenza di inventario avrà la priorità quando si sceglie un video da pubblicare su YouTube Shorts. |
VideoTrueViewInStreamAdInfo
Rappresentazione del formato dell'annuncio video TrueView in-stream (annuncio mostrato durante la riproduzione del video, spesso all'inizio, che mostra un pulsante per saltarlo dopo alcuni secondi).
Rappresentazione JSON |
---|
{
"actionButtonLabel": string,
"actionHeadline": string,
"companionBanner": {
object ( |
Campi | |
---|---|
actionButtonLabel |
Etichetta sul pulsante di invito all'azione che indirizza l'utente all'URL finale dell'annuncio video. Obbligatorio per le campagne TrueView for Action, facoltativo in caso contrario. |
actionHeadline |
Testo aggiuntivo visualizzato con il pulsante di invito all'azione (CTA) per fornire contesto e incoraggiare i clic sul pulsante. |
companionBanner |
Gli asset immagine del banner complementare utilizzato con l'annuncio. |
VideoBumperInStreamAdInfo
Rappresentazione del formato dell'annuncio in-stream bumper video (annuncio video in-stream non ignorabile molto breve).
Rappresentazione JSON |
---|
{
"companionBanner": {
object ( |
Campi | |
---|---|
companionBanner |
Gli asset immagine del banner complementare utilizzato con l'annuncio. |
actionButtonLabel |
Etichetta sul pulsante "Invito all'azione" che indirizza l'utente all'URL finale dell'annuncio video. |
actionHeadline |
Testo aggiuntivo visualizzato con il pulsante di invito all'azione (CTA) per fornire contesto e incoraggiare i clic sul pulsante. |
VideoOutstreamAdInfo
Rappresentazione del formato dell'annuncio video outstream (annuncio visualizzato accanto a un feed con riproduzione automatica, senza audio).
Rappresentazione JSON |
---|
{ "headline": string, "description": string } |
Campi | |
---|---|
headline |
Titolo dell'annuncio. |
description |
La riga descrittiva. |
VideoNonSkippableInStreamAdInfo
Rappresentazione del formato dell'annuncio in-stream non ignorabile video (annuncio video in-stream non ignorabile di 15 secondi).
Rappresentazione JSON |
---|
{
"companionBanner": {
object ( |
Campi | |
---|---|
companionBanner |
Gli asset immagine del banner complementare utilizzato con l'annuncio. |
actionButtonLabel |
Etichetta sul pulsante "Invito all'azione" che indirizza l'utente all'URL finale dell'annuncio video. |
actionHeadline |
Testo aggiuntivo visualizzato con il pulsante "Invito all'azione" per fornire contesto e incoraggiare gli utenti a fare clic sul pulsante. |
InFeedVideoAdInfo
Rappresentazione del formato dell'annuncio video in-feed.
Rappresentazione JSON |
---|
{
"headline": string,
"description1": string,
"description2": string,
"thumbnail": enum ( |
Campi | |
---|---|
headline |
Titolo dell'annuncio. |
description1 |
Prima riga di testo dell'annuncio. |
description2 |
Seconda riga di testo dell'annuncio. |
thumbnail |
L'immagine in miniatura del video da utilizzare. |
VideoThumbnail
Enum che elenca i possibili tipi di miniatura di un video.
Enum | |
---|---|
UNSPECIFIED |
Il tipo non è stato specificato. |
UNKNOWN |
Il valore ricevuto non è noto in questa versione. Questo è un valore solo per la risposta. |
DEFAULT_THUMBNAIL |
La miniatura predefinita. Può essere generato automaticamente o caricato dall'utente. |
THUMBNAIL_1 |
Miniatura 1, generata dal video. |
THUMBNAIL_2 |
Miniatura 2, generata dal video. |
THUMBNAIL_3 |
Miniatura 3, generata dal video. |
VideoResponsiveAdInfo
Un annuncio video adattabile.
Rappresentazione JSON |
---|
{ "headlines": [ { object ( |
Campi | |
---|---|
headlines[] |
Elenco di asset di testo utilizzati per il titolo breve. Al momento è supportato un solo valore per il titolo breve. |
longHeadlines[] |
Elenco di asset di testo utilizzati per il titolo lungo. Al momento è supportato un solo valore per il titolo lungo. |
descriptions[] |
Elenco di asset di testo utilizzati per la descrizione. Al momento è supportato un solo valore per la descrizione. |
callToActions[] |
Elenco di asset di testo utilizzati per il pulsante, ad esempio il pulsante "Invito all'azione". Al momento è supportato un solo valore per il pulsante. |
videos[] |
Elenco degli asset video di YouTube utilizzati per l'annuncio. Al momento è supportato un solo valore per l'asset video di YouTube. |
companionBanners[] |
Elenco degli asset immagine utilizzati per il banner companion. Al momento è supportato un solo valore per l'asset banner companion. |
breadcrumb1 |
Prima parte di testo visualizzata nell'annuncio con l'URL visualizzato. |
breadcrumb2 |
Seconda parte di testo visualizzata nell'annuncio con l'URL visualizzato. |
ResponsiveSearchAdInfo
Un annuncio adattabile della rete di ricerca.
Gli annunci adattabili della rete di ricerca consentono di creare un annuncio che cambia in modo da mostrare ai clienti più testo e messaggi più pertinenti. Se durante la creazione di un annuncio adattabile della rete di ricerca inserisci più titoli e descrizioni, nel tempo Google Ads proverà automaticamente diverse combinazioni e capirà quali sono le più efficaci. Poiché i contenuti dell'annuncio vengono adattati in modo da corrispondere meglio ai termini di ricerca dei potenziali clienti, gli annunci adattabili della rete di ricerca possono migliorare il rendimento della campagna.
Scopri di più all'indirizzo https://support.google.com/google-ads/answer/7684791
Rappresentazione JSON |
---|
{ "headlines": [ { object ( |
Campi | |
---|---|
headlines[] |
Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco. |
descriptions[] |
Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco. |
path1 |
Prima parte di testo che può essere aggiunta all'URL nell'annuncio. |
path2 |
Seconda parte di testo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche |
LegacyResponsiveDisplayAdInfo
Un annuncio display adattabile precedente. Gli annunci di questo tipo sono etichettati come "Annunci adattabili" nell'interfaccia utente di Google Ads.
Rappresentazione JSON |
---|
{
"formatSetting": enum ( |
Campi | |
---|---|
formatSetting |
Specifica il formato in cui verrà pubblicato l'annuncio. Il valore predefinito è ALL_FORMATS. |
shortHeadline |
La versione breve del titolo dell'annuncio. |
longHeadline |
La versione lunga del titolo dell'annuncio. |
description |
La descrizione dell'annuncio. |
businessName |
Il nome dell'attività nell'annuncio. |
allowFlexibleColor |
Il consenso dell'inserzionista a consentire il colore flessibile. Se il valore è true, l'annuncio può essere pubblicato con un colore diverso, se necessario. Se il valore è false, l'annuncio verrà pubblicato con i colori specificati o con un colore neutro. Il valore predefinito è |
accentColor |
Il colore di accento dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori |
mainColor |
Il colore principale dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori |
callToActionText |
Il testo dell'invito all'azione per l'annuncio. |
logoImage |
Il nome della risorsa MediaFile dell'immagine del logo utilizzata nell'annuncio. |
squareLogoImage |
Il nome della risorsa MediaFile dell'immagine del logo quadrato utilizzata nell'annuncio. |
marketingImage |
Il nome della risorsa MediaFile dell'immagine di marketing utilizzata nell'annuncio. |
squareMarketingImage |
Il nome della risorsa MediaFile dell'immagine di marketing quadrata utilizzata nell'annuncio. |
pricePrefix |
Prefisso prima del prezzo. Ad esempio, "a partire da". |
promoText |
Testo promozionale utilizzato per i formati dinamici degli annunci adattabili. Ad esempio, "Spedizione gratuita in 2 giorni". |
DisplayAdFormatSetting
Elenca le impostazioni dei formati degli annunci display.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Il valore è sconosciuto in questa versione. |
ALL_FORMATS |
Formati di testo, immagine e nativi. |
NON_NATIVE |
Formati di testo e immagini. |
NATIVE |
Il formato nativo, ad esempio, il rendering del formato è controllato dal publisher e non da Google. |
AppAdInfo
Un annuncio per app.
Rappresentazione JSON |
---|
{ "mandatoryAdText": { object ( |
Campi | |
---|---|
mandatoryAdText |
Testo dell'annuncio obbligatorio. |
headlines[] |
Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco. |
descriptions[] |
Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco. |
images[] |
Elenco di asset immagine che possono essere visualizzati con l'annuncio. |
youtubeVideos[] |
Elenco di asset video di YouTube che potrebbero essere visualizzati con l'annuncio. |
html5MediaBundles[] |
Elenco degli asset del pacchetto di media che possono essere utilizzati con l'annuncio. |
appDeepLink |
Un asset link diretto all'app che può essere utilizzato con l'annuncio. |
AdMediaBundleAsset
Un asset bundle multimediale utilizzato all'interno di un annuncio.
Rappresentazione JSON |
---|
{ "asset": string } |
Campi | |
---|---|
asset |
Il nome della risorsa Asset di questo bundle multimediale. |
AdAppDeepLinkAsset
Un link diretto all'app utilizzato all'interno di un annuncio.
Rappresentazione JSON |
---|
{ "asset": string } |
Campi | |
---|---|
asset |
Il nome della risorsa dell'asset link diretto all'app. |
LegacyAppInstallAdInfo
Un annuncio di installazione di app precedente che può essere utilizzato solo da alcuni clienti selezionati.
Rappresentazione JSON |
---|
{
"appStore": enum ( |
Campi | |
---|---|
appStore |
L'app store in cui è disponibile l'app mobile. |
appId |
L'ID dell'app mobile. |
headline |
Titolo dell'annuncio. |
description1 |
La prima riga descrittiva dell'annuncio. |
description2 |
La seconda riga descrittiva dell'annuncio. |
LegacyAppInstallAdAppStore
Tipo di store in un annuncio per l'installazione di app precedente.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Utilizzato solo per il valore restituito. Rappresenta il valore sconosciuto in questa versione. |
APPLE_APP_STORE |
iTunes di Apple. |
GOOGLE_PLAY |
Google Play. |
WINDOWS_STORE |
Windows Store. |
WINDOWS_PHONE_STORE |
Windows Phone Store. |
CN_APP_STORE |
L'app è ospitata in uno store cinese. |
ResponsiveDisplayAdInfo
Un annuncio display adattabile.
Rappresentazione JSON |
---|
{ "marketingImages": [ { object ( |
Campi | |
---|---|
marketingImages[] |
Immagini di marketing da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 600 x 314 e le proporzioni devono essere 1,91:1 (+-1%). È obbligatorio specificare almeno un valore per |
squareMarketingImages[] |
Immagini di marketing quadrate da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 300 x 300 e le proporzioni devono essere 1:1 (+-1%). È obbligatorio selezionare almeno un quadrato |
logoImages[] |
Immagini del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 512 x 128 e le proporzioni devono essere 4:1 (+-1%). Se combinato con |
squareLogoImages[] |
Immagini di loghi quadrati da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 128 x 128 e le proporzioni devono essere 1:1 (+-1%). Se combinato con |
headlines[] |
Titoli nel formato breve per l'annuncio. La lunghezza massima è di 30 caratteri. È possibile specificare almeno 1 e un massimo di 5 titoli. |
longHeadline |
Un titolo lungo obbligatorio. La lunghezza massima è di 90 caratteri. |
descriptions[] |
Testi descrittivi per l'annuncio. La lunghezza massima è di 90 caratteri. È possibile specificare almeno 1 e un massimo di 5 titoli. |
youtubeVideos[] |
Video di YouTube facoltativi per l'annuncio. È possibile specificare un massimo di 5 video. |
formatSetting |
Specifica il formato in cui verrà pubblicato l'annuncio. Il valore predefinito è ALL_FORMATS. |
controlSpec |
Specifiche per vari controlli delle creatività. |
businessName |
Il nome dell'inserzionista/del brand. La larghezza massima del display è 25. |
mainColor |
Il colore principale dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori |
accentColor |
Il colore di accento dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori |
allowFlexibleColor |
Il consenso dell'inserzionista a consentire il colore flessibile. Se il valore è true, l'annuncio può essere pubblicato con un colore diverso, se necessario. Se il valore è false, l'annuncio verrà pubblicato con i colori specificati o con un colore neutro. Il valore predefinito è |
callToActionText |
Il testo dell'invito all'azione per l'annuncio. La larghezza massima del display è 30. |
pricePrefix |
Prefisso prima del prezzo. Ad esempio, "a partire da". |
promoText |
Testo promozionale utilizzato per i formati dinamici degli annunci adattabili. Ad esempio, "Spedizione gratuita in 2 giorni". |
ResponsiveDisplayAdControlSpec
Specifiche per vari controlli delle creatività per un annuncio display adattabile.
Rappresentazione JSON |
---|
{ "enableAssetEnhancements": boolean, "enableAutogenVideo": boolean } |
Campi | |
---|---|
enableAssetEnhancements |
Indica se l'inserzionista ha attivato la funzionalità di miglioramento degli asset. |
enableAutogenVideo |
Indica se l'inserzionista ha attivato la funzionalità di generazione automatica di video. |
LocalAdInfo
Un annuncio locale.
Rappresentazione JSON |
---|
{ "headlines": [ { object ( |
Campi | |
---|---|
headlines[] |
Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco. È necessario specificare almeno 1 e massimo 5 titoli. |
descriptions[] |
Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco. È necessario specificare almeno 1 e al massimo 5 descrizioni. |
callToActions[] |
Elenco di asset di testo per gli inviti all'azione. Quando l'annuncio viene pubblicato, gli inviti all'azione verranno selezionati da questo elenco. Devi specificare almeno 1 e al massimo 5 inviti all'azione. |
marketingImages[] |
Elenco di asset immagine di marketing che possono essere visualizzati con l'annuncio. Le immagini devono avere dimensioni di 314 x 600 pixel o 320 x 320 pixel. È necessario specificare almeno 1 e massimo 20 asset immagine. |
logoImages[] |
Elenco di asset immagine del logo che possono essere visualizzati con l'annuncio. Le immagini devono avere dimensioni di 128 x 128 pixel e non devono superare i 120 KB. È necessario specificare almeno 1 e massimo 5 asset immagine. |
videos[] |
Elenco di asset video di YouTube che potrebbero essere visualizzati con l'annuncio. È necessario specificare almeno 1 e massimo 20 asset video. |
path1 |
Prima parte di testo facoltativo che può essere aggiunto all'URL nell'annuncio. |
path2 |
Seconda parte di testo facoltativo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche |
DisplayUploadAdInfo
Un tipo generico di annuncio display. Il formato esatto dell'annuncio è controllato dal campo displayUploadProductType
, che determina i tipi di dati da includere nell'annuncio.
Rappresentazione JSON |
---|
{ "displayUploadProductType": enum ( |
Campi | |
---|---|
displayUploadProductType |
Il tipo di prodotto di questo annuncio. Per informazioni dettagliate, consulta i commenti sull'enum. |
Campo unione media_asset . I dati degli asset che compongono l'annuncio. media_asset può essere solo uno dei seguenti: |
|
mediaBundle |
Un asset bundle multimediale da utilizzare nell'annuncio. Per informazioni sul bundle di media per HTML5_UPLOAD_AD, consulta la pagina https://support.google.com/google-ads/answer/1722096. I bundle di media che fanno parte dei tipi di prodotto dinamici utilizzano un formato speciale che deve essere creato tramite Google Web Designer. Per ulteriori informazioni, visita la pagina https://support.google.com/webdesigner/answer/7543898. |
DisplayUploadProductType
Elenca i tipi di prodotto da caricare per la visualizzazione.
Enum | |
---|---|
UNSPECIFIED |
Non specificato. |
UNKNOWN |
Il valore è sconosciuto in questa versione. |
HTML5_UPLOAD_AD |
Annuncio da caricamento HTML5. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. |
DYNAMIC_HTML5_EDUCATION_AD |
Annuncio HTML5 dinamico per l'istruzione. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna per l'istruzione. |
DYNAMIC_HTML5_FLIGHT_AD |
Annuncio HTML5 dinamico per voli. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna di volo. |
DYNAMIC_HTML5_HOTEL_RENTAL_AD |
Annuncio HTML5 dinamico per hotel e case vacanze. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna per hotel. |
DYNAMIC_HTML5_JOB_AD |
Annuncio di lavoro HTML5 dinamico. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna di annunci di lavoro. |
DYNAMIC_HTML5_LOCAL_AD |
Annuncio locale HTML5 dinamico. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna locale. |
DYNAMIC_HTML5_REAL_ESTATE_AD |
Annuncio immobiliare HTML5 dinamico. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna immobiliare. |
DYNAMIC_HTML5_CUSTOM_AD |
Annuncio personalizzato HTML5 dinamico. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna personalizzata. |
DYNAMIC_HTML5_TRAVEL_AD |
Annuncio HTML5 dinamico per viaggi. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna per viaggi. |
DYNAMIC_HTML5_HOTEL_AD |
Annuncio HTML5 dinamico per hotel. Questo tipo di prodotto richiede l'impostazione del campo upload_media_bundle in DisplayUploadAdInfo. Può essere utilizzato solo in una campagna per hotel. |
AppEngagementAdInfo
Gli annunci di coinvolgimento in app ti consentono di scrivere del testo per invogliare gli utenti a eseguire un'azione specifica nell'app, come un accesso, un acquisto o la prenotazione di un volo. Consentono di indirizzare gli utenti a una parte specifica della tua app dove possono trovare ciò che stanno cercando in modo più facile e rapido.
Rappresentazione JSON |
---|
{ "headlines": [ { object ( |
Campi | |
---|---|
headlines[] |
Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco. |
descriptions[] |
Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco. |
images[] |
Elenco di asset immagine che possono essere visualizzati con l'annuncio. |
videos[] |
Elenco di asset video che possono essere visualizzati con l'annuncio. |
ShoppingComparisonListingAdInfo
Un annuncio per la scheda di confronto Shopping.
Rappresentazione JSON |
---|
{ "headline": string } |
Campi | |
---|---|
headline |
Titolo dell'annuncio. Questo campo è obbligatorio. La lunghezza consentita è compresa tra 25 e 45 caratteri. |
AppPreRegistrationAdInfo
Gli annunci di preregistrazione per app rimandano alla scheda della tua app o del tuo gioco su Google Play e possono essere pubblicati su Google Play, YouTube (solo in-stream) e all'interno di altre app e siti web mobile sulla Rete Display. Ti aiuterà ad attirare l'interesse degli utenti per la tua app o il tuo gioco e a generare una base di potenziali installazioni prima del lancio.
Rappresentazione JSON |
---|
{ "headlines": [ { object ( |
Campi | |
---|---|
headlines[] |
Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco. |
descriptions[] |
Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco. |
images[] |
Elenco di ID asset immagine le cui immagini possono essere visualizzate con l'annuncio. |
youtubeVideos[] |
Elenco di ID risorsa video di YouTube i cui video potrebbero essere visualizzati con l'annuncio. |
DemandGenMultiAssetAdInfo
Un annuncio multi asset Demand Gen.
Rappresentazione JSON |
---|
{ "marketingImages": [ { object ( |
Campi | |
---|---|
marketingImages[] |
Asset immagine di marketing da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 600 x 314 e le proporzioni devono essere 1,91:1 (+-1%). Obbligatorio se squareMarketingImages non è presente. Se combinato con |
squareMarketingImages[] |
Asset immagine di marketing quadrati da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 300 x 300 e le proporzioni devono essere 1:1 (+-1%). Obbligatorio se marketingImages non è presente. Se combinato con |
portraitMarketingImages[] |
Asset immagine verticale di marketing da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 480 x 600 e le proporzioni devono essere 4:5 (+-1%). Se combinato con |
tallPortraitMarketingImages[] |
Asset immagine di marketing lunghi verticali da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 600 x 1067 e le proporzioni devono essere 9:16 (+-1%). Se combinato con |
logoImages[] |
Asset immagine del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 128 x 128 e le proporzioni devono essere 1:1 (+-1%). È possibile specificare almeno 1 e massimo 5 immagini del logo. |
headlines[] |
Asset di testo del titolo dell'annuncio. La larghezza massima del display è 30. È possibile specificare almeno 1 e un massimo di 5 titoli. |
descriptions[] |
Il testo descrittivo dell'annuncio. La larghezza massima del display è 90. È possibile specificare almeno 1 e un massimo di 5 descrizioni. |
businessName |
Il nome dell'inserzionista/del brand. La larghezza massima del display è 25. Obbligatorio. |
callToActionText |
Testo dell'invito all'azione. |
leadFormOnly |
Opzione booleana che indica se questo annuncio deve essere pubblicato con il modulo per i lead. |
DemandGenCarouselAdInfo
Un annuncio carosello Demand Gen.
Rappresentazione JSON |
---|
{ "businessName": string, "logoImage": { object ( |
Campi | |
---|---|
businessName |
Obbligatorio. Il nome dell'inserzionista/del brand. |
logoImage |
Obbligatorio. Immagine del logo da utilizzare nell'annuncio. Le dimensioni minime sono 128 x 128 e le proporzioni devono essere 1:1 (+-1%). |
headline |
Obbligatorio. Titolo dell'annuncio. |
description |
Obbligatorio. Il testo descrittivo dell'annuncio. |
callToActionText |
Testo dell'invito all'azione. |
carouselCards[] |
Obbligatorio. Schede carosello che verranno visualizzate con l'annuncio. Minimo 2, massimo 10. |
AdDemandGenCarouselCardAsset
Un asset della scheda carosello Demand Gen utilizzato all'interno di un annuncio.
Rappresentazione JSON |
---|
{ "asset": string } |
Campi | |
---|---|
asset |
Il nome della risorsa Asset di questa scheda del carosello discovery. |
DemandGenVideoResponsiveAdInfo
Un annuncio video Demand Gen adattabile.
Rappresentazione JSON |
---|
{ "headlines": [ { object ( |
Campi | |
---|---|
headlines[] |
Elenco di asset di testo utilizzati per il titolo breve. |
longHeadlines[] |
Elenco di asset di testo utilizzati per il titolo lungo. |
descriptions[] |
Elenco di asset di testo utilizzati per la descrizione. |
videos[] |
Elenco degli asset video di YouTube utilizzati per l'annuncio. |
logoImages[] |
Immagine del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 128 x 128 e le proporzioni devono essere 1:1 (+-1%). |
breadcrumb1 |
Prima parte di testo visualizzata nell'annuncio con l'URL visualizzato. |
breadcrumb2 |
Seconda parte di testo visualizzata nell'annuncio con l'URL visualizzato. |
businessName |
Obbligatorio. Il nome dell'inserzionista/del brand. |
callToActions[] |
Asset di tipo CallToActionAsset utilizzati per il pulsante "Invito all'azione". |
AdCallToActionAsset
Un asset di invito all'azione utilizzato all'interno di un annuncio.
Rappresentazione JSON |
---|
{ "asset": string } |
Campi | |
---|---|
asset |
Il nome della risorsa dell'asset di invito all'azione. |
DemandGenProductAdInfo
Un annuncio di prodotto Demand Gen.
Rappresentazione JSON |
---|
{ "breadcrumb1": string, "breadcrumb2": string, "businessName": { object ( |
Campi | |
---|---|
breadcrumb1 |
Prima parte di testo visualizzata nell'annuncio con l'URL visualizzato. |
breadcrumb2 |
Seconda parte di testo visualizzata nell'annuncio con l'URL visualizzato. |
businessName |
Obbligatorio. Il nome dell'inserzionista/del brand. |
headline |
Obbligatorio. Asset di testo utilizzato per il titolo breve. |
description |
Obbligatorio. Asset di testo utilizzato per la descrizione. |
logoImage |
Obbligatorio. Immagine del logo da utilizzare nell'annuncio. I tipi di immagine validi sono GIF, JPEG e PNG. Le dimensioni minime sono 128 x 128 e le proporzioni devono essere 1:1 (+-1%). |
callToAction |
Asset di tipo CallToActionAsset utilizzato per il pulsante "Invito all'azione". |
TravelAdInfo
Questo tipo non contiene campi.
Un annuncio di viaggi.