REST Resource: advertisers.creatives

Risorsa: creatività

Una singola creatività.

Rappresentazione JSON 
{
  "name": string,
  "advertiserId": string,
  "creativeId": string,
  "cmPlacementId": string,
  "displayName": string,
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "createTime": string,
  "creativeType": enum (CreativeType),
  "hostingSource": enum (HostingSource),
  "dynamic": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "additionalDimensions": [
    {
      object (Dimensions)
    }
  ],
  "mediaDuration": string,
  "creativeAttributes": [
    enum (CreativeAttribute)
  ],
  "reviewStatus": {
    object (ReviewStatusInfo)
  },
  "assets": [
    {
      object (AssetAssociation)
    }
  ],
  "exitEvents": [
    {
      object (ExitEvent)
    }
  ],
  "timerEvents": [
    {
      object (TimerEvent)
    }
  ],
  "counterEvents": [
    {
      object (CounterEvent)
    }
  ],
  "appendedTag": string,
  "integrationCode": string,
  "notes": string,
  "iasCampaignMonitoring": boolean,
  "companionCreativeIds": [
    string
  ],
  "skippable": boolean,
  "skipOffset": {
    object (AudioVideoOffset)
  },
  "progressOffset": {
    object (AudioVideoOffset)
  },
  "universalAdId": {
    object (UniversalAdId)
  },
  "thirdPartyUrls": [
    {
      object (ThirdPartyUrl)
    }
  ],
  "transcodes": [
    {
      object (Transcode)
    }
  ],
  "trackerUrls": [
    string
  ],
  "jsTrackerUrl": string,
  "cmTrackingAd": {
    object (CmTrackingAd)
  },
  "obaIcon": {
    object (ObaIcon)
  },
  "thirdPartyTag": string,
  "requireMraid": boolean,
  "requireHtml5": boolean,
  "requirePingForAttribution": boolean,
  "expandingDirection": enum (ExpandingDirection),
  "expandOnHover": boolean,
  "vastTagUrl": string,
  "vpaid": boolean,
  "html5Video": boolean,
  "lineItemIds": [
    string
  ],
  "mp3Audio": boolean,
  "oggAudio": boolean
}
Campi
name

string

Solo output. Il nome della risorsa della creatività.
advertiserId

string (int64 format)

Solo output. L'ID univoco dell'inserzionista a cui appartiene la creatività.
creativeId

string (int64 format)

Solo output. L'ID univoco della creatività. Assegnato dal sistema.
cmPlacementId

string (int64 format)

Solo output. L'ID univoco del posizionamento Campaign Manager 360 associato alla creatività. Questo campo è applicabile solo alle creatività sincronizzate da Campaign Manager.
displayName

string

Obbligatorio. Il nome visualizzato della creatività.

Deve essere codificata in UTF-8 con una dimensione massima di 240 byte.
entityStatus

enum (EntityStatus)

Obbligatorio. Controlla se la creatività può essere pubblicata o meno.

I valori accettati sono:

  • ENTITY_STATUS_ACTIVE
  • ENTITY_STATUS_ARCHIVED
  • ENTITY_STATUS_PAUSED
updateTime

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento della creatività da parte dell'utente o del sistema (ad es. verifica della creatività). Assegnato dal sistema.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
createTime

string (Timestamp format)

Solo output. Il timestamp della creazione della creatività. Assegnato dal sistema.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
creativeType

enum (CreativeType)

Obbligatorio. Immutabile. Il tipo di creatività.
hostingSource

enum (HostingSource)

Obbligatorio. Indica dove è ospitata la creatività.
dynamic

boolean

Solo output. Indica se la creatività è dinamica.
dimensions

object (Dimensions)

Obbligatorio. Dimensioni principali della creatività. Applicabile a tutti i tipi di creatività. Il valore predefinito di widthPixels e heightPixels è 0 quando creativeType è uno dei seguenti:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
additionalDimensions[]

object (Dimensions)

Dimensioni aggiuntive. Applicabile quando creativeType è uno dei seguenti valori:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_LIGHTBOX
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Se questo campo è specificato, widthPixels e heightPixels sono entrambi obbligatori e devono essere maggiori o uguali a 0.
mediaDuration

string (Duration format)

Solo output. Durata dei contenuti multimediali della creatività. Applicabile quando creativeType è uno dei seguenti valori:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Durata in secondi con un massimo di nove cifre frazionarie e termina con "s". Esempio: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

Solo output. Un elenco di attributi della creatività generati dal sistema.
reviewStatus

object (ReviewStatusInfo)

Solo output. Lo stato corrente della procedura di revisione delle creatività.
assets[]

object (AssetAssociation)

Obbligatorio. Asset associati a questa creatività.
exitEvents[]

object (ExitEvent)

Obbligatorio. Eventi di uscita per questa creatività. Un'uscita, chiamata anche clicktag, è un'area nella tua creatività su cui l'utente può fare clic o che può toccare per aprire la pagina di destinazione di un inserzionista. Ciascuna creatività deve includere almeno un'uscita. Puoi aggiungere un'uscita alla tua creatività in uno dei seguenti modi:

  • Utilizza l'area tocco di Google Web Designer.
  • Definisci una variabile JavaScript denominata "clickTag".
  • Utilizza l'enabler (enabler.exit()) per monitorare le uscite nei formati rich media.
timerEvents[]

object (TimerEvent)

Timer degli eventi personalizzati per una creatività rich media. I timer monitorano il tempo durante il quale un utente visualizza e interagisce con una parte specifica di una creatività rich media. Una creatività può essere caratterizzata da più eventi timer, ciascuno con tempi di attivazione diversi. Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.
counterEvents[]

object (CounterEvent)

Eventi contatore per una creatività rich media. I contatori monitorano il numero di volte in cui un utente interagisce con qualsiasi parte di una creatività rich media in un modo specifico (passaggi del mouse sopra, passaggi del mouse fuori, clic, tocchi, caricamento di dati, digitazione e così via). Qualsiasi evento che può essere acquisito nella creatività può essere registrato come contatore. Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.
appendedTag

string

Tag di monitoraggio HTML di terze parti da aggiungere al tag della creatività.
integrationCode

string

Informazioni sull'ID utilizzate per collegare questa creatività a un sistema esterno. Deve essere codificato in UTF-8 e non deve superare i 10.000 caratteri.
notes

string

Note dell'utente per questa creatività. Deve essere codificato in UTF-8 e non deve superare i 20.000 caratteri.
iasCampaignMonitoring

boolean

Indica se il monitoraggio della campagna di Integral Ad Science (IAS) è attivo. Per attivare questa opzione per la creatività, assicurati che Advertiser.creative_config.ias_client_id sia impostato sul tuo ID client IAS.
companionCreativeIds[]

string (int64 format)

Gli ID delle creatività companion per una creatività video.

Puoi assegnare creatività display esistenti (con asset immagine o HTML5) da pubblicare intorno al video player del publisher. Le creatività companion vengono visualizzate intorno al video player durante la riproduzione e fino al termine del video.

Le creatività che contengono additional dimensions non possono essere creatività companion.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Indica se l'utente può scegliere di saltare una creatività video.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

La durata della riproduzione del video prima che venga visualizzato il pulsante Salta.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

La durata del video necessaria per conteggiare una visualizzazione.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

(Facoltativo) Un identificatore della creatività facoltativo fornito da un registry univoco su tutte le piattaforme.

L'ID annuncio universale fa parte dello standard VAST 4.0. Può essere modificato dopo la creazione della creatività.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyUrls[]

object (ThirdPartyUrl)

URL di monitoraggio di terze parti per monitorare le interazioni con una creatività video.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Solo output. Transcodifica audio/video.

Transcodifica l'asset principale in diverse versioni alternative che utilizzano o presentano formati file e proprietà differenti (risoluzione, frequenza bit audio e frequenza bit video) e ciascuna pensata per specifici video player e larghezze di banda.

Queste transcodifiche offrono al sistema del publisher più opzioni tra cui scegliere per ogni impressione relativa al video e assicurano che il file appropriato venga pubblicato in base alla connessione e alle dimensioni dello schermo dello spettatore.

Questo campo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_AUDIO
trackerUrls[]

string

URL di monitoraggio per i fornitori di analisi dati o i fornitori di tecnologie pubblicitarie di terze parti.

Gli URL devono iniziare con https (tranne nell'inventario che non richiede la conformità a SSL). Se utilizzi macro nell'URL, usa solo macro supportate da Display & Video 360.

Solo URL standard (i tag IMG o SCRIPT non sono supportati).

Questo campo è scrivibile solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

URL di misurazione JavaScript di fornitori di servizi di verifica di terze parti supportati (ComScore, DoubleVerify, IAS, Moat). I tag script HTML non sono supportati.

Questo campo è scrivibile solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

L'annuncio di monitoraggio di Campaign Manager 360 associato alla creatività.

Facoltativo per i seguenti creativeType se creati da un inserzionista che utilizza sia Campaign Manager 360 sia la pubblicazione di annunci di terze parti:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Viene visualizzato solo per altri casi.
obaIcon

object (ObaIcon)

Specifica l'icona OBA per una creatività video.

Questo campo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
thirdPartyTag

string

(Facoltativo) Il tag di terze parti originale utilizzato per la creatività.

Obbligatorio e valido solo per le creatività tag di terze parti.

Le creatività con tag di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

(Facoltativo) Indica che la creatività richiede MRAID (sistema Mobile Rich Media Ad Interface Definitions).

Imposta questo valore se la creatività si basa su gesti per l'interattività sui dispositivi mobili, come lo scorrimento o il tocco.

Facoltativo e valido solo per le creatività tag di terze parti.

Le creatività tag di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

(Facoltativo) Indica che la creatività si basa su HTML5 per il rendering corretto.

Facoltativo e valido solo per le creatività tag di terze parti. Le creatività tag di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

(Facoltativo) Indica che la creatività attenderà un ping di ritorno per l'attribuzione.

Valido solo se utilizzi un annuncio di monitoraggio Campaign Manager 360 con un parametro dell'ad server di terze parti e la macro ${DC_DBM_TOKEN}.

Facoltativo e valido solo per le creatività tag di terze parti o le creatività tag VAST di terze parti.

Le creatività con tag di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

Le creatività tag VAST di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

(Facoltativo) Specifica la direzione di espansione della creatività.

Obbligatorio e valido solo per le creatività espandibili di terze parti.

Le creatività espandibili di terze parti sono creatività con la seguente origine di hosting:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

(Facoltativo) Indica che la creatività si espanderà automaticamente al passaggio del mouse.

Facoltativo e valido solo per le creatività espandibili di terze parti. Le creatività espandibili di terze parti sono creatività con le seguenti origini di hosting:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

(Facoltativo) L'URL del tag VAST per una creatività con tag VAST di terze parti.

Obbligatorio e valido solo per le creatività con tag VAST di terze parti.

Le creatività con tag VAST di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Solo output. Indica che la creatività del tag VAST di terze parti richiede VPAID (Digital Video Player-Ad Interface).

Solo output e valido solo per le creatività con tag VAST di terze parti.

Le creatività con tag VAST di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

Solo output. Indica che la creatività con tag VAST di terze parti richiede il supporto di video HTML5.

Solo output e valido solo per le creatività con tag VAST di terze parti.

Le creatività tag VAST di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_VIDEO
lineItemIds[]

string (int64 format)

Solo output. Gli ID degli elementi pubblicitari a cui è associata questa creatività.

Per associare una creatività a un elemento pubblicitario, utilizza LineItem.creative_ids.
mp3Audio

boolean

Solo output. Indica che la creatività audio di terze parti supporta il formato MP3.

Solo per l'output e solo per le creatività audio di terze parti.

Le creatività audio di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

Solo output. Indica che la creatività audio di terze parti supporta OGG.

Solo per l'output e solo per le creatività audio di terze parti.

Le creatività audio di terze parti sono creatività con i seguenti hostingSource:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

Possibili origini hosting per una creatività. Indica dove viene creata e ospitata una creatività.

Enum
HOSTING_SOURCE_UNSPECIFIED L'origine host non è specificata o è sconosciuta in questa versione.
HOSTING_SOURCE_CM

Una creatività sincronizzata da Campaign Manager 360.

I metodi di creazione e aggiornamento non sono supportati per questo tipo di hosting.
HOSTING_SOURCE_THIRD_PARTY

Una creatività ospitata da un ad server di terze parti (3PAS).

I metodi di creazione e aggiornamento sono supportati per questo tipo di hosting se creativeType è uno dei seguenti:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_EXPANDABLE
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_HOSTED

Una creatività creata in DV360 e ospitata da Campaign Manager 360.

I metodi di creazione e aggiornamento sono supportati per questo tipo di hosting se creativeType è uno dei seguenti:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_VIDEO
HOSTING_SOURCE_RICH_MEDIA

Una creatività rich media creata in Studio e ospitata da Campaign Manager 360.

I metodi di creazione e aggiornamento non sono supportati per questo tipo di hosting.

CreativeAttribute

Possibili attributi di una creatività.

Enum
CREATIVE_ATTRIBUTE_UNSPECIFIED L'attributo della creatività non è specificato o è sconosciuto in questa versione.
CREATIVE_ATTRIBUTE_VAST La creatività è una creatività VAST.
CREATIVE_ATTRIBUTE_VPAID_LINEAR La creatività è una creatività VPAID lineare.
CREATIVE_ATTRIBUTE_VPAID_NON_LINEAR La creatività è una creatività VPAID non lineare.

ReviewStatusInfo

Esamina gli stati della creatività.

Rappresentazione JSON 
{
  "approvalStatus": enum (ApprovalStatus),
  "creativeAndLandingPageReviewStatus": enum (ReviewStatus),
  "contentAndPolicyReviewStatus": enum (ReviewStatus),
  "exchangeReviewStatuses": [
    {
      object (ExchangeReviewStatus)
    }
  ],
  "publisherReviewStatuses": [
    {
      object (PublisherReviewStatus)
    }
  ]
}
Campi
approvalStatus

enum (ApprovalStatus)

Rappresenta l'approvazione di base necessaria perché una creatività possa essere pubblicata. Riepilogo di creativeAndLandingPageReviewStatus e contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

Stato di revisione della creatività e della pagina di destinazione per la creatività.
contentAndPolicyReviewStatus

enum (ReviewStatus)

Stato di revisione dei contenuti e delle norme per la creatività.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Stati di revisione della creatività nella piattaforma di scambio pubblicitario.
publisherReviewStatuses[]
(deprecated)

object (PublisherReviewStatus)

Stati di revisione del publisher relativi alla creatività.

StatoApprovazione

Possibili tipi di stato di approvazione. È il riepilogo di creativeAndLandingPageReviewStatus e contentAndPolicyReviewStatus.

Enum
APPROVAL_STATUS_UNSPECIFIED Il valore del tipo non è specificato o è sconosciuto in questa versione.
APPROVAL_STATUS_PENDING_NOT_SERVABLE La creatività è ancora in fase di revisione e non può essere pubblicata.
APPROVAL_STATUS_PENDING_SERVABLE La creatività ha superato la revisione della creatività e della pagina di destinazione ed è pubblicabile, ma è in attesa della revisione dei contenuti aggiuntivi e secondo le norme.
APPROVAL_STATUS_APPROVED_SERVABLE Sia la revisione della creatività e della pagina di destinazione sia la revisione dei contenuti e della conformità alle norme sono state approvate. La creatività è pubblicabile.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Si è presentato un problema con la creatività che deve essere risolto prima che possa essere pubblicata.

ReviewStatus

Possibili tipi di stato della revisione.

Enum
REVIEW_STATUS_UNSPECIFIED Il valore del tipo non è specificato o è sconosciuto in questa versione.
REVIEW_STATUS_APPROVED La creatività è stata approvata.
REVIEW_STATUS_REJECTED La creatività è stata rifiutata.
REVIEW_STATUS_PENDING La creatività è in attesa di revisione.

ExchangeReviewStatus

Stato di revisione della piattaforma di scambio pubblicitario per la creatività.

Rappresentazione JSON 
{
  "exchange": enum (Exchange),
  "status": enum (ReviewStatus)
}
Campi
exchange

enum (Exchange)

La piattaforma di scambio pubblicitario che esamina la creatività.
status

enum (ReviewStatus)

Stato della revisione della piattaforma di scambio pubblicitario.

PublisherReviewStatus

Stato della revisione del publisher per la creatività.

Rappresentazione JSON 
{
  "publisherName": string,
  "status": enum (ReviewStatus)
}
Campi
publisherName

string

Il publisher che esamina la creatività.
status

enum (ReviewStatus)

Stato della revisione del publisher.

AssetAssociation

Associazione degli asset per la creatività.

Rappresentazione JSON 
{
  "asset": {
    object (Asset)
  },
  "role": enum (AssetRole)
}
Campi
asset

object (Asset)

La risorsa associata.
role

enum (AssetRole)

Il ruolo di questo asset per la creatività.

Asset

Una singola risorsa.

Rappresentazione JSON 
{
  "mediaId": string,
  "content": string
}
Campi
mediaId

string (int64 format)

ID media della risorsa caricata. Si tratta di un identificatore univoco della risorsa. Questo ID può essere passato ad altre chiamate API, ad esempio creatives.create per associare l'asset a una creatività.

Lo spazio ID media è stato aggiornato il 5 aprile 2023. Aggiorna gli ID media memorizzati nella cache prima del 5 aprile 2023 recuperando il nuovo ID media dalle risorse delle creatività associate o ricaricando la risorsa.
content

string

I contenuti della risorsa. Per gli asset caricati, i contenuti sono il percorso di pubblicazione.

AssetRole

Il ruolo di questa risorsa per la creatività.

Enum
ASSET_ROLE_UNSPECIFIED Il ruolo della risorsa non è specificato o è sconosciuto in questa versione.
ASSET_ROLE_MAIN L'asset è l'asset principale della creatività.
ASSET_ROLE_BACKUP L'asset è un asset di backup della creatività.
ASSET_ROLE_POLITE_LOAD L'asset è un asset di caricamento cortese della creatività.
ASSET_ROLE_HEADLINE

Titolo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 25 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_HEADLINE

Titolo lungo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 50 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Testo del corpo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 90 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_LONG_BODY

Corpo del testo lungo di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 150 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CAPTION_URL

Una versione breve e intuitiva dell'URL pagina di destinazione da mostrare nella creatività. Questo URL dà agli utenti un'idea di dove arriveranno dopo aver fatto clic sulla creatività.

content deve essere codificato in UTF-8 e avere una lunghezza massima di 30 caratteri.

Ad esempio, se l'URL pagina di destinazione è "http://www.example.com/page", l'URL didascalia può essere "example.com". Il protocollo (http://) è facoltativo, ma l'URL non può contenere spazi o caratteri speciali.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_CALL_TO_ACTION

Il testo da utilizzare nel pulsante di invito all'azione di una creatività nativa.

content deve essere codificato in UTF-8 e non deve superare i 15 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_ADVERTISER_NAME

Il testo che identifica il nome dell'inserzionista o del brand.

content deve essere codificato in UTF-8 e non deve superare i 25 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_PRICE

Il prezzo di acquisto della tua app nel Google Play Store o nell'App Store iOS (ad esempio 5,99 $).

Tieni presente che questo valore non viene sincronizzato automaticamente con il valore effettivo indicato nel negozio. Sarà sempre quello fornito al momento del salvataggio della creatività.

Il campo content deve utilizzare la codifica UTF-8 con una lunghezza massima di 15 caratteri.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_ANDROID_APP_ID

L'ID di un'app per Android nel Google Play Store.

Puoi trovare questo ID nell'URL del Google Play Store dell'app dopo "id". Ad esempio, in https://play.google.com/store/apps/details?id=com.company.appname l'identificatore è com.company.appname.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_IOS_APP_ID

L'ID di un'app per iOS nell'Apple App Store.

Questo numero di ID si trova nell'URL dell'Apple App Store come stringa di numeri direttamente dopo "id". Ad esempio, in https://apps.apple.com/it/app/gmail-email-by-google/id422689480 l'ID è 422689480.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_RATING

La valutazione di un'app nel Google Play Store o nell'App Store iOS.

Tieni presente che questo valore non viene sincronizzato automaticamente con la valutazione effettiva nello store. Sarà sempre quella fornita al momento del salvataggio della creatività.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_ICON

L'icona di una creatività.

Questo ruolo è supportato ed è richiesto solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
ASSET_ROLE_COVER_IMAGE

L'immagine di copertina di una creatività video nativa.

Questo ruolo è supportato e obbligatorio solo nei seguenti creativeType:

  • CREATIVE_TYPE_VIDEO

ExitEvent

Evento di uscita della creatività.

Rappresentazione JSON 
{
  "type": enum (ExitEventType),
  "url": string,
  "name": string,
  "reportingName": string
}
Campi
type

enum (ExitEventType)

Obbligatorio. Il tipo di evento di uscita.
url

string

Obbligatorio. L'URL di clickthrough dell'evento di uscita. Questo valore è obbligatorio quando type è:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Il nome del tag di clic dell'evento di uscita.

Il nome deve essere univoco all'interno di una creatività.

Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.
reportingName

string

Il nome utilizzato per identificare questo evento nei report. Lascia vuoto o non impostato per le creatività contenenti solo asset immagine.

ExitEventType

Il tipo di evento di uscita.

Enum
EXIT_EVENT_TYPE_UNSPECIFIED Il tipo di evento di uscita non è specificato o è sconosciuto in questa versione.
EXIT_EVENT_TYPE_DEFAULT L'evento di uscita è quello predefinito.
EXIT_EVENT_TYPE_BACKUP L'evento di uscita è un evento di uscita di backup. In una creatività potrebbero essere presenti più eventi di uscita di riserva.

TimerEvent

Evento timer della creatività.

Rappresentazione JSON 
{
  "name": string,
  "reportingName": string
}
Campi
name

string

Obbligatorio. Il nome dell'evento timer.
reportingName

string

Obbligatorio. Il nome utilizzato per identificare questo evento timer nei report.

CounterEvent

Evento contatore della creatività.

Rappresentazione JSON 
{
  "name": string,
  "reportingName": string
}
Campi
name

string

Obbligatorio. Il nome dell'evento contatore.
reportingName

string

Obbligatorio. Il nome utilizzato per identificare questo evento contatore nei report.

AudioVideoOffset

La durata della riproduzione di un audio o di un video.

Rappresentazione JSON 
{

  // Union field offset can be only one of the following:
  "percentage": string,
  "seconds": string
  // End of list of possible types for union field offset.
}
Campi
Campo unione offset. Il valore dell'offset. offset può essere solo uno dei seguenti:
percentage

string (int64 format)

L'offset in percentuale della durata dell'audio o del video.
seconds

string (int64 format)

L'offset in secondi dall'inizio dell'audio o del video.

UniversalAdId

Un identificatore di creatività fornito da un registro, univoco su tutte le piattaforme. Questo fa parte dello standard VAST 4.0.

Rappresentazione JSON 
{
  "id": string,
  "registry": enum (UniversalAdRegistry)
}
Campi
id

string

L'identificatore univoco della creatività.
registry

enum (UniversalAdRegistry)

Il registry fornisce identificatori univoci delle creatività.

UniversalAdRegistry

Il registry fornisce identificatori unici delle creatività in un ID annuncio universale.

Enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Il registry degli annunci universali non è specificato o è sconosciuto in questa versione.
UNIVERSAL_AD_REGISTRY_OTHER Utilizza un provider personalizzato per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_AD_ID Utilizza Ad-ID per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_CLEARCAST Utilizza clearcast.co.uk per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_DV360 Utilizza Display & Video 360 per fornire l'ID annuncio universale.
UNIVERSAL_AD_REGISTRY_CM Utilizza Campaign Manager 360 per fornire l'ID annuncio universale.

ThirdPartyUrl

URL di monitoraggio di terze parti per monitorare le interazioni con una creatività audio o video.

Rappresentazione JSON 
{
  "type": enum (ThirdPartyUrlType),
  "url": string
}
Campi
type

enum (ThirdPartyUrlType)

Il tipo di interazione deve essere monitorato dall'URL di monitoraggio
url

string

URL di monitoraggio utilizzato per monitorare l'interazione.

Fornisci un URL con percorso o stringa di query facoltativi, che inizi con https:. Ad esempio, https://www.example.com/path

ThirdPartyUrlType

Il tipo di interazione deve essere monitorato dall'URL di monitoraggio di terze parti.

Enum
THIRD_PARTY_URL_TYPE_UNSPECIFIED Il tipo di URL di terze parti non è specificato o è sconosciuto in questa versione.
THIRD_PARTY_URL_TYPE_IMPRESSION Utilizzato per conteggiare le impressioni della creatività dopo aver completato il buffering audio o video.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Utilizzato per monitorare i clic degli utenti sull'audio o sul video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Viene utilizzato per monitorare il numero di volte in cui un utente avvia l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Viene utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino al 25% della sua durata.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MIDPOINT Viene utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino al 50% della sua durata.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_THIRD_QUARTILE Viene utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino al 75% della sua durata.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_COMPLETE Viene utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino alla fine.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Viene utilizzato per monitorare il numero di volte in cui un utente disattiva l'audio del video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Viene utilizzato per monitorare il numero di volte in cui un utente mette in pausa l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Viene utilizzato per monitorare il numero di volte in cui un utente riproduce di nuovo l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Utilizzato per monitorare il numero di volte in cui un utente espande il player alla dimensione schermo intero.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Viene utilizzato per monitorare il numero di volte in cui un utente interrompe l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Viene utilizzato per monitorare il numero di volte in cui un utente esegue un clic personalizzato, ad esempio facendo clic sull'area selezionabile di un video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Utilizzato per monitorare il numero di volte in cui l'audio o il video è stato saltato.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Utilizzato per monitorare il numero di volte in cui l'audio o il video viene riprodotto fino a un offset determinato da progressOffset.

Transcodifica

Rappresenta le informazioni sul file audio o video transcodificato.

Rappresentazione JSON 
{
  "name": string,
  "mimeType": string,
  "transcoded": boolean,
  "dimensions": {
    object (Dimensions)
  },
  "bitRateKbps": string,
  "frameRate": number,
  "audioBitRateKbps": string,
  "audioSampleRateHz": string,
  "fileSizeBytes": string
}
Campi
name

string

Il nome del file transcodificato.
mimeType

string

Il tipo MIME del file transcodificato.
transcoded

boolean

Indica se la transcodifica è andata a buon fine.
dimensions

object (Dimensions)

Le dimensioni del video transcodificato.
bitRateKbps

string (int64 format)

La frequenza in bit di transcodifica del video transcodificato, in kilobit al secondo.
frameRate

number

La frequenza fotogrammi del video transcodificato, in frame al secondo.
audioBitRateKbps

string (int64 format)

La frequenza in bit dello stream audio del video transcodificato o la frequenza in bit dell'audio transcodificato, in kilobit al secondo.
audioSampleRateHz

string (int64 format)

La frequenza di campionamento per lo stream audio del video transcodificato o la frequenza di campionamento per l'audio transcodificato, in hertz.
fileSizeBytes

string (int64 format)

Le dimensioni del file transcodificato, espresse in byte.

CmTrackingAd

Un annuncio di monitoraggio di Campaign Manager 360.

Rappresentazione JSON 
{
  "cmPlacementId": string,
  "cmCreativeId": string,
  "cmAdId": string
}
Campi
cmPlacementId

string (int64 format)

L'ID posizionamento dell'annuncio di monitoraggio di Campaign Manager 360.
cmCreativeId

string (int64 format)

L'ID creatività dell'annuncio di monitoraggio Campaign Manager 360.
cmAdId

string (int64 format)

L'ID annuncio dell'annuncio di monitoraggio di Campaign Manager 360.

ObaIcon

Icona OBA per una creatività

Rappresentazione JSON 
{
  "resourceUrl": string,
  "resourceMimeType": string,
  "position": enum (ObaIconPosition),
  "dimensions": {
    object (Dimensions)
  },
  "program": string,
  "landingPageUrl": string,
  "clickTrackingUrl": string,
  "viewTrackingUrl": string
}
Campi
resourceUrl

string

L'URL della risorsa dell'icona OBA.
resourceMimeType

string

Tipo MIME della risorsa dell'icona OBA.
position

enum (ObaIconPosition)

La posizione dell'icona OBA nella creatività.
dimensions

object (Dimensions)

Le dimensioni dell'icona OBA.
program

string

Il programma dell'icona OBA. Ad esempio: "AdChoices".
landingPageUrl

string

Obbligatorio. L'URL pagina di destinazione dell'icona OBA.

Sono consentiti solo gli URL dei seguenti domini:
clickTrackingUrl

string

Obbligatorio. L'URL di monitoraggio dei clic dell'icona OBA.

Sono consentiti solo gli URL dei seguenti domini:
viewTrackingUrl

string

Obbligatorio. L'URL di monitoraggio delle visualizzazioni dell'icona OBA.

Sono consentiti solo gli URL dei seguenti domini:

ObaIconPosition

La posizione dell'icona OBA nella creatività.

Enum
OBA_ICON_POSITION_UNSPECIFIED La posizione dell'icona OBA non è specificata.
OBA_ICON_POSITION_UPPER_RIGHT Nella parte in alto a destra della creatività.
OBA_ICON_POSITION_UPPER_LEFT Nella parte in alto a sinistra della creatività.
OBA_ICON_POSITION_LOWER_RIGHT Nella parte in basso a destra della creatività.
OBA_ICON_POSITION_LOWER_LEFT Nella parte in basso a sinistra della creatività.

ExpandingDirection

La direzione di espansione della creatività espandibile di terze parti.

Enum
EXPANDING_DIRECTION_UNSPECIFIED La direzione di espansione non è specificata.
EXPANDING_DIRECTION_NONE Non si espande in nessuna direzione.
EXPANDING_DIRECTION_UP Si espande verso l'alto.
EXPANDING_DIRECTION_DOWN Si espande verso il basso.
EXPANDING_DIRECTION_LEFT Si espande verso sinistra.
EXPANDING_DIRECTION_RIGHT Si espande verso destra.
EXPANDING_DIRECTION_UP_AND_LEFT Si espande verso l'alto e verso sinistra.
EXPANDING_DIRECTION_UP_AND_RIGHT Si espande verso l'alto e verso destra.
EXPANDING_DIRECTION_DOWN_AND_LEFT Si espande verso il basso e verso sinistra.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Si espande verso il basso e verso destra.
EXPANDING_DIRECTION_UP_OR_DOWN Si espande verso l'alto o verso il basso.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Si espande verso sinistra o verso destra.
EXPANDING_DIRECTION_ANY_DIAGONAL Può espandersi in qualsiasi direzione diagonale.

Metodi

create

 Crea una nuova creatività.

delete

 Elimina una creatività.

get

 Recupera una creatività.

list

 Elenca le creatività in un inserzionista.

patch

 Aggiorna una creatività esistente.