Ad

Un annuncio.

Rappresentazione JSON
{
  "resourceName": string,
  "finalUrls": [
    string
  ],
  "finalAppUrls": [
    {
      object (FinalAppUrl)
    }
  ],
  "finalMobileUrls": [
    string
  ],
  "urlCustomParameters": [
    {
      object (CustomParameter)
    }
  ],
  "type": enum (AdType),
  "devicePreference": enum (Device),
  "urlCollections": [
    {
      object (UrlCollection)
    }
  ],
  "systemManagedResourceSource": enum (SystemManagedResourceSource),
  "id": string,
  "trackingUrlTemplate": string,
  "finalUrlSuffix": string,
  "displayUrl": string,
  "addedByGoogleAds": boolean,
  "name": string,

  // Union field ad_data can be only one of the following:
  "textAd": {
    object (TextAdInfo)
  },
  "expandedTextAd": {
    object (ExpandedTextAdInfo)
  },
  "callAd": {
    object (CallAdInfo)
  },
  "expandedDynamicSearchAd": {
    object (ExpandedDynamicSearchAdInfo)
  },
  "hotelAd": {
    object (HotelAdInfo)
  },
  "shoppingSmartAd": {
    object (ShoppingSmartAdInfo)
  },
  "shoppingProductAd": {
    object (ShoppingProductAdInfo)
  },
  "imageAd": {
    object (ImageAdInfo)
  },
  "videoAd": {
    object (VideoAdInfo)
  },
  "videoResponsiveAd": {
    object (VideoResponsiveAdInfo)
  },
  "responsiveSearchAd": {
    object (ResponsiveSearchAdInfo)
  },
  "legacyResponsiveDisplayAd": {
    object (LegacyResponsiveDisplayAdInfo)
  },
  "appAd": {
    object (AppAdInfo)
  },
  "legacyAppInstallAd": {
    object (LegacyAppInstallAdInfo)
  },
  "responsiveDisplayAd": {
    object (ResponsiveDisplayAdInfo)
  },
  "localAd": {
    object (LocalAdInfo)
  },
  "displayUploadAd": {
    object (DisplayUploadAdInfo)
  },
  "appEngagementAd": {
    object (AppEngagementAdInfo)
  },
  "shoppingComparisonListingAd": {
    object (ShoppingComparisonListingAdInfo)
  },
  "smartCampaignAd": {
    object (SmartCampaignAdInfo)
  },
  "appPreRegistrationAd": {
    object (AppPreRegistrationAdInfo)
  },
  "demandGenMultiAssetAd": {
    object (DemandGenMultiAssetAdInfo)
  },
  "demandGenCarouselAd": {
    object (DemandGenCarouselAdInfo)
  },
  "demandGenVideoResponsiveAd": {
    object (DemandGenVideoResponsiveAdInfo)
  },
  "demandGenProductAd": {
    object (DemandGenProductAdInfo)
  },
  "travelAd": {
    object (TravelAdInfo)
  }
  // End of list of possible types for union field ad_data.
}
Campi
resourceName

string

Immutabile. Il nome della risorsa dell'annuncio. I nomi delle risorse annuncio hanno il seguente formato:

customers/{customerId}/ads/{ad_id}

finalUrls[]

string

L'elenco dei possibili URL finali dopo tutti i reindirizzamenti interdominio per l'annuncio.

finalAppUrls[]

object (FinalAppUrl)

Un elenco di URL finali dell'app che verranno utilizzati sui dispositivi mobili se l'utente ha installato l'app specifica.

finalMobileUrls[]

string

L'elenco dei possibili URL mobile finali dopo tutti i reindirizzamenti tra domini per l'annuncio.

urlCustomParameters[]

object (CustomParameter)

L'elenco delle mappature che possono essere utilizzate per sostituire i tag dei parametri personalizzati in un trackingUrlTemplate, finalUrls o mobile_final_urls. Per le mutazioni, utilizza le operazioni sui parametri URL personalizzati.

type

enum (AdType)

Solo output. Il tipo di annuncio.

devicePreference

enum (Device)

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[]

object (UrlCollection)

URL aggiuntivi per l'annuncio codificati con un identificatore univoco a cui è possibile fare riferimento da altri campi dell'annuncio.

systemManagedResourceSource

enum (SystemManagedResourceSource)

Solo output. Se l'annuncio è gestito dal sistema, questo campo indica l'origine. Questo campo è di sola lettura.

id

string (int64 format)

Solo output. L'ID dell'annuncio.

trackingUrlTemplate

string

Il modello di URL per la creazione di un URL di monitoraggio.

finalUrlSuffix

string

Il suffisso da utilizzare per creare un URL finale.

displayUrl

string

L'URL visualizzato nella descrizione dell'annuncio per alcuni formati.

addedByGoogleAds

boolean

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

string

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

object (TextAdInfo)

Immutabile. Dettagli relativi a un annuncio di testo.

expandedTextAd

object (ExpandedTextAdInfo)

Dettagli relativi a un annuncio di testo espanso.

callAd

object (CallAdInfo)

Dettagli relativi a un annuncio di chiamata.

expandedDynamicSearchAd

object (ExpandedDynamicSearchAdInfo)

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 dynamicSearchAdsSetting collegate a livello di campagna.

hotelAd

object (HotelAdInfo)

Dettagli relativi a un annuncio per hotel.

shoppingSmartAd

object (ShoppingSmartAdInfo)

Dettagli relativi a un annuncio Shopping intelligente.

shoppingProductAd

object (ShoppingProductAdInfo)

Dettagli relativi a un annuncio Shopping prodotto.

imageAd

object (ImageAdInfo)

Immutabile. Dettagli relativi a un annuncio illustrato.

videoAd

object (VideoAdInfo)

Dettagli relativi a un annuncio video.

videoResponsiveAd

object (VideoResponsiveAdInfo)

Dettagli relativi a un annuncio video adattabile.

responsiveSearchAd

object (ResponsiveSearchAdInfo)

Dettagli relativi a un annuncio adattabile della rete di ricerca.

legacyResponsiveDisplayAd

object (LegacyResponsiveDisplayAdInfo)

Dettagli relativi a un annuncio display adattabile precedente.

appAd

object (AppAdInfo)

Dettagli relativi a un annuncio per app.

legacyAppInstallAd

object (LegacyAppInstallAdInfo)

Immutabile. Dettagli relativi a un annuncio per l'installazione di app precedente.

responsiveDisplayAd

object (ResponsiveDisplayAdInfo)

Dettagli relativi a un annuncio display adattabile.

localAd

object (LocalAdInfo)

Dettagli relativi a un annuncio locale.

displayUploadAd

object (DisplayUploadAdInfo)

Dettagli relativi a un annuncio display caricato.

appEngagementAd

object (AppEngagementAdInfo)

Dettagli relativi a un annuncio di coinvolgimento in app.

shoppingComparisonListingAd

object (ShoppingComparisonListingAdInfo)

Dettagli relativi a un annuncio per il confronto Shopping.

smartCampaignAd

object (SmartCampaignAdInfo)

Dettagli relativi a un annuncio di una campagna intelligente.

appPreRegistrationAd

object (AppPreRegistrationAdInfo)

Dettagli relativi a un annuncio di preregistrazione per app.

demandGenMultiAssetAd

object (DemandGenMultiAssetAdInfo)

Dettagli relativi a un annuncio multi asset Demand Gen.

demandGenVideoResponsiveAd

object (DemandGenVideoResponsiveAdInfo)

Dettagli relativi a un annuncio video adattabile Demand Gen.

demandGenProductAd

object (DemandGenProductAdInfo)

Dettagli relativi a un annuncio di prodotto Demand Gen.

travelAd

object (TravelAdInfo)

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 (AppUrlOperatingSystemType),
  "url": string
}
Campi
osType

enum (AppUrlOperatingSystemType)

Il sistema operativo scelto come target da questo URL. Obbligatorio.

url

string

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.
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[]

string

Un elenco di possibili URL finali.

finalMobileUrls[]

string

Un elenco di possibili URL mobile finali.

urlCollectionId

string

Identificatore univoco per questa istanza di UrlCollection.

trackingUrlTemplate

string

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

string

Titolo dell'annuncio.

description1

string

La prima riga della descrizione dell'annuncio.

description2

string

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

string

La prima parte del titolo dell'annuncio.

headlinePart2

string

La seconda parte del titolo dell'annuncio.

headlinePart3

string

La terza parte del titolo dell'annuncio.

description

string

La descrizione dell'annuncio.

description2

string

La seconda descrizione dell'annuncio.

path1

string

Il testo che può essere visualizzato accanto all'URL visualizzato dell'annuncio.

path2

string

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 (CallConversionReportingState),
  "path1": string,
  "path2": string
}
Campi
countryCode

string

Il codice paese nell'annuncio.

phoneNumber

string

Il numero di telefono nell'annuncio.

businessName

string

Il nome dell'attività nell'annuncio.

headline1

string

Primo titolo nell'annuncio.

headline2

string

Secondo titolo dell'annuncio.

description1

string

La prima riga della descrizione dell'annuncio.

description2

string

La seconda riga della descrizione dell'annuncio.

callTracked

boolean

Indica se attivare il monitoraggio delle chiamate per la creatività. L'attivazione del monitoraggio delle chiamate consente anche le conversioni di chiamata.

disableCallConversion

boolean

Indica se disattivare la conversione di chiamata per la creatività. Se impostato su true, disattiva le conversioni di chiamata anche quando callTracked è true. Se callTracked è false, questo campo viene ignorato.

phoneNumberVerificationUrl

string

L'URL da utilizzare per la verifica del numero di telefono.

conversionAction

string

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 callTracked è impostato su true. In caso contrario, questo campo viene ignorato.

conversionReportingState

enum (CallConversionReportingState)

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

string

Prima parte di testo che può essere aggiunta all'URL nell'annuncio. Facoltativo.

path2

string

Seconda parte di testo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche path1. Facoltativo.

ExpandedDynamicSearchAdInfo

Un annuncio dinamico della rete di ricerca espanso.

Rappresentazione JSON
{
  "description": string,
  "description2": string
}
Campi
description

string

La descrizione dell'annuncio.

description2

string

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 (MimeType),
  "pixelWidth": string,
  "pixelHeight": string,
  "imageUrl": string,
  "previewPixelWidth": string,
  "previewPixelHeight": string,
  "previewImageUrl": string,
  "name": string,

  // Union field image can be only one of the following:
  "imageAsset": {
    object (AdImageAsset)
  },
  "data": string,
  "adIdToCopyImageFrom": string
  // End of list of possible types for union field image.
}
Campi
mimeType

enum (MimeType)

Il tipo MIME dell'immagine.

pixelWidth

string (int64 format)

Larghezza in pixel dell'immagine a grandezza originale.

pixelHeight

string (int64 format)

Altezza in pixel dell'immagine a grandezza originale.

imageUrl

string

URL dell'immagine a grandezza originale.

previewPixelWidth

string (int64 format)

Larghezza in pixel dell'immagine delle dimensioni di anteprima.

previewPixelHeight

string (int64 format)

Altezza in pixel dell'immagine nelle dimensioni di anteprima.

previewImageUrl

string

URL dell'immagine nelle dimensioni di anteprima.

name

string

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

object (AdImageAsset)

Gli asset immagine utilizzati per l'annuncio.

data

string (bytes format)

Dati non elaborati delle immagini sotto forma di byte.

Una stringa con codifica Base64.

adIdToCopyImageFrom

string (int64 format)

Un ID annuncio da cui copiare l'immagine.

AdImageAsset

Un asset immagine utilizzato all'interno di un annuncio.

Rappresentazione JSON
{
  "asset": string
}
Campi
asset

string

Il nome della risorsa Asset di questa immagine.

VideoAdInfo

Un annuncio video.

Rappresentazione JSON
{
  "video": {
    object (AdVideoAsset)
  },

  // Union field format can be only one of the following:
  "inStream": {
    object (VideoTrueViewInStreamAdInfo)
  },
  "bumper": {
    object (VideoBumperInStreamAdInfo)
  },
  "outStream": {
    object (VideoOutstreamAdInfo)
  },
  "nonSkippable": {
    object (VideoNonSkippableInStreamAdInfo)
  },
  "inFeed": {
    object (InFeedVideoAdInfo)
  }
  // End of list of possible types for union field format.
}
Campi
video

object (AdVideoAsset)

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

object (VideoTrueViewInStreamAdInfo)

Formato dell'annuncio video TrueView in-stream.

bumper

object (VideoBumperInStreamAdInfo)

Formato dell'annuncio video bumper in-stream.

outStream

object (VideoOutstreamAdInfo)

Formato dell'annuncio video outstream.

nonSkippable

object (VideoNonSkippableInStreamAdInfo)

Formato dell'annuncio in-stream non ignorabile video.

inFeed

object (InFeedVideoAdInfo)

Formato dell'annuncio video in-feed.

AdVideoAsset

Un asset video utilizzato all'interno di un annuncio.

Rappresentazione JSON
{
  "asset": string,
  "adVideoAssetInfo": {
    object (AdVideoAssetInfo)
  }
}
Campi
asset

string

Il nome della risorsa asset di questo video.

adVideoAssetInfo

object (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 (AdVideoAssetInventoryPreferences)
  }
}
Campi
adVideoAssetInventoryPreferences

object (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

boolean

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

boolean

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

boolean

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 (AdImageAsset)
  }
}
Campi
actionButtonLabel

string

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

string

Testo aggiuntivo visualizzato con il pulsante di invito all'azione (CTA) per fornire contesto e incoraggiare i clic sul pulsante.

companionBanner

object (AdImageAsset)

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 (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campi
companionBanner

object (AdImageAsset)

Gli asset immagine del banner complementare utilizzato con l'annuncio.

actionButtonLabel

string

Etichetta sul pulsante "Invito all'azione" che indirizza l'utente all'URL finale dell'annuncio video.

actionHeadline

string

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

string

Titolo dell'annuncio.

description

string

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 (AdImageAsset)
  },
  "actionButtonLabel": string,
  "actionHeadline": string
}
Campi
companionBanner

object (AdImageAsset)

Gli asset immagine del banner complementare utilizzato con l'annuncio.

actionButtonLabel

string

Etichetta sul pulsante "Invito all'azione" che indirizza l'utente all'URL finale dell'annuncio video.

actionHeadline

string

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 (VideoThumbnail)
}
Campi
headline

string

Titolo dell'annuncio.

description1

string

Prima riga di testo dell'annuncio.

description2

string

Seconda riga di testo dell'annuncio.

thumbnail

enum (VideoThumbnail)

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 (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "companionBanners": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo breve. Al momento è supportato un solo valore per il titolo breve.

longHeadlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo lungo. Al momento è supportato un solo valore per il titolo lungo.

descriptions[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per la descrizione. Al momento è supportato un solo valore per la descrizione.

callToActions[]

object (AdTextAsset)

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[]

object (AdVideoAsset)

Elenco degli asset video di YouTube utilizzati per l'annuncio. Al momento è supportato un solo valore per l'asset video di YouTube.

companionBanners[]

object (AdImageAsset)

Elenco degli asset immagine utilizzati per il banner companion. Al momento è supportato un solo valore per l'asset banner companion.

breadcrumb1

string

Prima parte di testo visualizzata nell'annuncio con l'URL visualizzato.

breadcrumb2

string

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 (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco.

descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco.

path1

string

Prima parte di testo che può essere aggiunta all'URL nell'annuncio.

path2

string

Seconda parte di testo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche path1.

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 (DisplayAdFormatSetting),
  "shortHeadline": string,
  "longHeadline": string,
  "description": string,
  "businessName": string,
  "allowFlexibleColor": boolean,
  "accentColor": string,
  "mainColor": string,
  "callToActionText": string,
  "logoImage": string,
  "squareLogoImage": string,
  "marketingImage": string,
  "squareMarketingImage": string,
  "pricePrefix": string,
  "promoText": string
}
Campi
formatSetting

enum (DisplayAdFormatSetting)

Specifica il formato in cui verrà pubblicato l'annuncio. Il valore predefinito è ALL_FORMATS.

shortHeadline

string

La versione breve del titolo dell'annuncio.

longHeadline

string

La versione lunga del titolo dell'annuncio.

description

string

La descrizione dell'annuncio.

businessName

string

Il nome dell'attività nell'annuncio.

allowFlexibleColor

boolean

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 è true. Deve essere true se mainColor e accentColor non sono impostati.

accentColor

string

Il colore di accento dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori mainColor e accentColor, è obbligatorio anche l'altro.

mainColor

string

Il colore principale dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori mainColor e accentColor, è obbligatorio anche l'altro.

callToActionText

string

Il testo dell'invito all'azione per l'annuncio.

logoImage

string

Il nome della risorsa MediaFile dell'immagine del logo utilizzata nell'annuncio.

squareLogoImage

string

Il nome della risorsa MediaFile dell'immagine del logo quadrato utilizzata nell'annuncio.

marketingImage

string

Il nome della risorsa MediaFile dell'immagine di marketing utilizzata nell'annuncio.

squareMarketingImage

string

Il nome della risorsa MediaFile dell'immagine di marketing quadrata utilizzata nell'annuncio.

pricePrefix

string

Prefisso prima del prezzo. Ad esempio, "a partire da".

promoText

string

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 (AdTextAsset)
  },
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "html5MediaBundles": [
    {
      object (AdMediaBundleAsset)
    }
  ],
  "appDeepLink": {
    object (AdAppDeepLinkAsset)
  }
}
Campi
mandatoryAdText

object (AdTextAsset)

Testo dell'annuncio obbligatorio.

headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco.

descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco.

images[]

object (AdImageAsset)

Elenco di asset immagine che possono essere visualizzati con l'annuncio.

youtubeVideos[]

object (AdVideoAsset)

Elenco di asset video di YouTube che potrebbero essere visualizzati con l'annuncio.

html5MediaBundles[]

object (AdMediaBundleAsset)

Elenco degli asset del pacchetto di media che possono essere utilizzati con l'annuncio.

AdMediaBundleAsset

Un asset bundle multimediale utilizzato all'interno di un annuncio.

Rappresentazione JSON
{
  "asset": string
}
Campi
asset

string

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

string

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 (LegacyAppInstallAdAppStore),
  "appId": string,
  "headline": string,
  "description1": string,
  "description2": string
}
Campi
appStore

enum (LegacyAppInstallAdAppStore)

L'app store in cui è disponibile l'app mobile.

appId

string

L'ID dell'app mobile.

headline

string

Titolo dell'annuncio.

description1

string

La prima riga descrittiva dell'annuncio.

description2

string

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 (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "squareLogoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadline": {
    object (AdTextAsset)
  },
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ],
  "formatSetting": enum (DisplayAdFormatSetting),
  "controlSpec": {
    object (ResponsiveDisplayAdControlSpec)
  },
  "businessName": string,
  "mainColor": string,
  "accentColor": string,
  "allowFlexibleColor": boolean,
  "callToActionText": string,
  "pricePrefix": string,
  "promoText": string
}
Campi
marketingImages[]

object (AdImageAsset)

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 marketingImage. Se combinato con squareMarketingImages, il numero massimo è 15.

squareMarketingImages[]

object (AdImageAsset)

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 marketingImage. Se combinato con marketingImages, il numero massimo è 15.

logoImages[]

object (AdImageAsset)

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, il valore massimo è 5.

squareLogoImages[]

object (AdImageAsset)

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 logoImages, il valore massimo è 5.

headlines[]

object (AdTextAsset)

Titoli nel formato breve per l'annuncio. La lunghezza massima è di 30 caratteri. È possibile specificare almeno 1 e un massimo di 5 titoli.

longHeadline

object (AdTextAsset)

Un titolo lungo obbligatorio. La lunghezza massima è di 90 caratteri.

descriptions[]

object (AdTextAsset)

Testi descrittivi per l'annuncio. La lunghezza massima è di 90 caratteri. È possibile specificare almeno 1 e un massimo di 5 titoli.

youtubeVideos[]

object (AdVideoAsset)

Video di YouTube facoltativi per l'annuncio. È possibile specificare un massimo di 5 video.

formatSetting

enum (DisplayAdFormatSetting)

Specifica il formato in cui verrà pubblicato l'annuncio. Il valore predefinito è ALL_FORMATS.

controlSpec

object (ResponsiveDisplayAdControlSpec)

Specifiche per vari controlli delle creatività.

businessName

string

Il nome dell'inserzionista/del brand. La larghezza massima del display è 25.

mainColor

string

Il colore principale dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori mainColor e accentColor, è obbligatorio anche l'altro.

accentColor

string

Il colore di accento dell'annuncio in formato esadecimale, ad esempio #ffffff per il bianco. Se è impostato uno dei valori mainColor e accentColor, è obbligatorio anche l'altro.

allowFlexibleColor

boolean

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 è true. Deve essere true se mainColor e accentColor non sono impostati.

callToActionText

string

Il testo dell'invito all'azione per l'annuncio. La larghezza massima del display è 30.

pricePrefix

string

Prefisso prima del prezzo. Ad esempio, "a partire da".

promoText

string

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

boolean

Indica se l'inserzionista ha attivato la funzionalità di miglioramento degli asset.

enableAutogenVideo

boolean

Indica se l'inserzionista ha attivato la funzionalità di generazione automatica di video.

LocalAdInfo

Un annuncio locale.

Rappresentazione JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "callToActions": [
    {
      object (AdTextAsset)
    }
  ],
  "marketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "path1": string,
  "path2": string
}
Campi
headlines[]

object (AdTextAsset)

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[]

object (AdTextAsset)

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[]

object (AdTextAsset)

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[]

object (AdImageAsset)

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[]

object (AdImageAsset)

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[]

object (AdVideoAsset)

Elenco di asset video di YouTube che potrebbero essere visualizzati con l'annuncio. È necessario specificare almeno 1 e massimo 20 asset video.

path1

string

Prima parte di testo facoltativo che può essere aggiunto all'URL nell'annuncio.

path2

string

Seconda parte di testo facoltativo che può essere aggiunta all'URL nell'annuncio. Questo campo può essere impostato solo se è impostato anche path1.

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 (DisplayUploadProductType),

  // Union field media_asset can be only one of the following:
  "mediaBundle": {
    object (AdMediaBundleAsset)
  }
  // End of list of possible types for union field media_asset.
}
Campi
displayUploadProductType

enum (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

object (AdMediaBundleAsset)

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 (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco.

descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco.

images[]

object (AdImageAsset)

Elenco di asset immagine che possono essere visualizzati con l'annuncio.

videos[]

object (AdVideoAsset)

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

string

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 (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "images": [
    {
      object (AdImageAsset)
    }
  ],
  "youtubeVideos": [
    {
      object (AdVideoAsset)
    }
  ]
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo per i titoli. Quando l'annuncio viene pubblicato, i titoli verranno selezionati da questo elenco.

descriptions[]

object (AdTextAsset)

Elenco di asset di testo per le descrizioni. Quando l'annuncio viene pubblicato, le descrizioni verranno selezionate da questo elenco.

images[]

object (AdImageAsset)

Elenco di ID asset immagine le cui immagini possono essere visualizzate con l'annuncio.

youtubeVideos[]

object (AdVideoAsset)

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 (AdImageAsset)
    }
  ],
  "squareMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "portraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "tallPortraitMarketingImages": [
    {
      object (AdImageAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "businessName": string,
  "callToActionText": string,
  "leadFormOnly": boolean
}
Campi
marketingImages[]

object (AdImageAsset)

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, portraitMarketingImages e tallPortraitMarketingImages, il numero massimo è 20.

squareMarketingImages[]

object (AdImageAsset)

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 marketingImages, portraitMarketingImages e tallPortraitMarketingImages, il numero massimo è 20.

portraitMarketingImages[]

object (AdImageAsset)

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 marketingImages, squareMarketingImages e tallPortraitMarketingImages, il numero massimo è 20.

tallPortraitMarketingImages[]

object (AdImageAsset)

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 marketingImages, squareMarketingImages e portraitMarketingImages, il numero massimo è 20.

logoImages[]

object (AdImageAsset)

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[]

object (AdTextAsset)

Asset di testo del titolo dell'annuncio. La larghezza massima del display è 30. È possibile specificare almeno 1 e un massimo di 5 titoli.

descriptions[]

object (AdTextAsset)

Il testo descrittivo dell'annuncio. La larghezza massima del display è 90. È possibile specificare almeno 1 e un massimo di 5 descrizioni.

businessName

string

Il nome dell'inserzionista/del brand. La larghezza massima del display è 25. Obbligatorio.

callToActionText

string

Testo dell'invito all'azione.

leadFormOnly

boolean

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 (AdImageAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "callToActionText": string,
  "carouselCards": [
    {
      object (AdDemandGenCarouselCardAsset)
    }
  ]
}
Campi
businessName

string

Obbligatorio. Il nome dell'inserzionista/del brand.

logoImage

object (AdImageAsset)

Obbligatorio. Immagine del logo da utilizzare nell'annuncio. Le dimensioni minime sono 128 x 128 e le proporzioni devono essere 1:1 (+-1%).

headline

object (AdTextAsset)

Obbligatorio. Titolo dell'annuncio.

description

object (AdTextAsset)

Obbligatorio. Il testo descrittivo dell'annuncio.

callToActionText

string

Testo dell'invito all'azione.

carouselCards[]

object (AdDemandGenCarouselCardAsset)

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

string

Il nome della risorsa Asset di questa scheda del carosello discovery.

DemandGenVideoResponsiveAdInfo

Un annuncio video Demand Gen adattabile.

Rappresentazione JSON
{
  "headlines": [
    {
      object (AdTextAsset)
    }
  ],
  "longHeadlines": [
    {
      object (AdTextAsset)
    }
  ],
  "descriptions": [
    {
      object (AdTextAsset)
    }
  ],
  "videos": [
    {
      object (AdVideoAsset)
    }
  ],
  "logoImages": [
    {
      object (AdImageAsset)
    }
  ],
  "breadcrumb1": string,
  "breadcrumb2": string,
  "businessName": {
    object (AdTextAsset)
  },
  "callToActions": [
    {
      object (AdCallToActionAsset)
    }
  ]
}
Campi
headlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo breve.

longHeadlines[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per il titolo lungo.

descriptions[]

object (AdTextAsset)

Elenco di asset di testo utilizzati per la descrizione.

videos[]

object (AdVideoAsset)

Elenco degli asset video di YouTube utilizzati per l'annuncio.

logoImages[]

object (AdImageAsset)

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

string

Prima parte di testo visualizzata nell'annuncio con l'URL visualizzato.

breadcrumb2

string

Seconda parte di testo visualizzata nell'annuncio con l'URL visualizzato.

businessName

object (AdTextAsset)

Obbligatorio. Il nome dell'inserzionista/del brand.

callToActions[]

object (AdCallToActionAsset)

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

string

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 (AdTextAsset)
  },
  "headline": {
    object (AdTextAsset)
  },
  "description": {
    object (AdTextAsset)
  },
  "logoImage": {
    object (AdImageAsset)
  },
  "callToAction": {
    object (AdCallToActionAsset)
  }
}
Campi
breadcrumb1

string

Prima parte di testo visualizzata nell'annuncio con l'URL visualizzato.

breadcrumb2

string

Seconda parte di testo visualizzata nell'annuncio con l'URL visualizzato.

businessName

object (AdTextAsset)

Obbligatorio. Il nome dell'inserzionista/del brand.

headline

object (AdTextAsset)

Obbligatorio. Asset di testo utilizzato per il titolo breve.

description

object (AdTextAsset)

Obbligatorio. Asset di testo utilizzato per la descrizione.

logoImage

object (AdImageAsset)

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

object (AdCallToActionAsset)

Asset di tipo CallToActionAsset utilizzato per il pulsante "Invito all'azione".

TravelAdInfo

Questo tipo non contiene campi.

Un annuncio di viaggi.