REST Resource: advertisers.creatives

Risorsa: creatività

Una sola 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 per le 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 è possibile pubblicare o meno la creatività.

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 esempio, verifica della creatività). Assegnato dal sistema.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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 del momento in cui è stata creata la creatività. Assegnato dal sistema.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi 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. Le 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 di:

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

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

string (Duration format)

Solo output. Durata multimediale della creatività. Applicabile quando creativeType è uno di:

  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_NATIVE_VIDEO
  • CREATIVE_TYPE_PUBLISHER_HOSTED

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
creativeAttributes[]

enum (CreativeAttribute)

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

object (ReviewStatusInfo)

Solo output. Lo stato attuale 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 (nota anche come clicktag) è un'area della creatività che un utente può selezionare o toccare per aprire la pagina di destinazione di un inserzionista. Ogni creatività deve includere almeno un'uscita. Puoi aggiungere un'uscita alla 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)

Imposta la durata degli eventi personalizzati per una creatività rich media. Le durate tracciano 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 il campo vuoto o non impostato per le creatività che contengono solo asset immagine.
counterEvents[]

object (CounterEvent)

Eventi contatore per una creatività rich media. I contatori tengono traccia del numero di volte in cui un utente interagisce con qualsiasi parte di una creatività rich media in un modo specificato (mouseover, mouseout, clic, caricamento dati, pressione di tasti e così via). Qualsiasi evento che può essere acquisito nella creatività può essere registrato come contatore. Lascia il campo vuoto o non impostato per le creatività che contengono 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 codificata in UTF-8 con una lunghezza non superiore a 10.000 caratteri.
notes

string

Note per l'utente per questa creatività. Deve essere codificata in UTF-8 con una lunghezza non superiore a 20.000 caratteri.
iasCampaignMonitoring

boolean

Indica se il monitoraggio della campagna di Integral Ad Science (IAS) è abilitato. Per attivare questa funzionalità per la creatività, assicurati che Advertiser.creative_config.ias_client_id sia stato impostato sull'ID cliente 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 del video e rimangono 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 ignorare una creatività video.

Questo campo è supportato solo per il seguente creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Durata della riproduzione del video prima che diventi disponibile il pulsante per saltare l'annuncio.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per il seguente creativeType:

  • CREATIVE_TYPE_VIDEO
progressOffset

object (AudioVideoOffset)

Durata della riproduzione del video prima del conteggio di una visualizzazione.

Questo campo è obbligatorio quando skippable è true.

Questo campo è supportato solo per il seguente creativeType:

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

Campo facoltativo. Un identificatore di creatività facoltativo fornito da un registro e univoco su tutte le piattaforme.

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

Questo campo è supportato solo per il seguente 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 il seguente creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
  • CREATIVE_TYPE_NATIVE_VIDEO
transcodes[]

object (Transcode)

Solo output. Transcodifiche audio/video.

Display & Video 360 transcodifica l'asset principale in una serie di versioni alternative che utilizzano formati file o proprietà differenti (risoluzione, velocità in bit audio e velocità in bit video) e ciascuna concepita per specifici video player o larghezze di banda.

Queste transcodifiche offrono al sistema del publisher più opzioni tra cui scegliere per ogni impressione sul tuo 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 fornitori di analisi o fornitori di tecnologia pubblicitaria di terze parti.

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

Solo URL standard, nessun tag IMG o SCRIPT.

Questo campo può essere scritto solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
jsTrackerUrl

string

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

Questo campo può essere scritto solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
cmTrackingAd

object (CmTrackingAd)

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

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

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE

Output 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

Campo facoltativo. Il tag di terze parti originale utilizzato per la creatività.

Obbligatorio 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

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

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

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireHtml5

boolean

Campo facoltativo. Indica che la creatività si basa su HTML5 per una visualizzazione corretta.

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requirePingForAttribution

boolean

Campo facoltativo. Indica che la creatività attende un ping di ritorno per l'attribuzione.

Valido solo quando 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 creatività tag di terze parti o creatività tag VAST di terze parti.

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
expandingDirection

enum (ExpandingDirection)

Campo 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

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_EXPANDABLE
expandOnHover

boolean

Campo 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 la seguente origine di hosting:

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

Campo facoltativo. L'URL del tag VAST per una creatività tag VAST di terze parti.

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

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
html5Video

boolean

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

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

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti 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 invece LineItem.creative_ids.
mp3Audio

boolean

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

Solo output e valido solo per creatività audio di terze parti.

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
oggAudio

boolean

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

Solo output e valido solo per creatività audio di terze parti.

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

  • HOSTING_SOURCE_THIRD_PARTY

combinata con i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO

HostingSource

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

Enum
HOSTING_SOURCE_UNSPECIFIED L'origine hosting 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 per la pubblicazione di una creatività. Riepilogo di creativeAndLandingPageReviewStatus e contentAndPolicyReviewStatus.
creativeAndLandingPageReviewStatus

enum (ReviewStatus)

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

enum (ReviewStatus)

Stato di revisione dei contenuti e della revisione secondo le norme della creatività.
exchangeReviewStatuses[]

object (ExchangeReviewStatus)

Stati di revisione della piattaforma di scambio pubblicitario per la creatività.
publisherReviewStatuses[]

object (PublisherReviewStatus)

Stati di revisione della creatività da parte del publisher.

ApprovalStatus

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 corso di revisione e non può essere pubblicata.
APPROVAL_STATUS_PENDING_SERVABLE La creatività ha superato la revisione della creatività e della pagina di destinazione e può essere pubblicata, ma è in attesa di revisione secondo le norme e i contenuti aggiuntivi.
APPROVAL_STATUS_APPROVED_SERVABLE Sono approvati sia la revisione di creatività e pagine di destinazione, sia la revisione dei contenuti e delle norme. La creatività è pubblicabile.
APPROVAL_STATUS_REJECTED_NOT_SERVABLE Si è verificato un problema con la creatività che deve essere risolto prima di poter 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 che esamina la creatività.
status

enum (ReviewStatus)

Lo stato della revisione della piattaforma di scambio pubblicitario.

PublisherReviewStatus

Stato di revisione della creatività da parte del publisher.

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 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 elemento multimediale dell'asset caricato. Si tratta di un identificatore univoco della risorsa. Questo ID può essere trasmesso ad altre chiamate API, ad esempio creatives.create per associare l'asset a una creatività.

Lo spazio ID media aggiornato il 5 aprile 2023. Aggiorna gli ID multimediali memorizzati nella cache prima del 5 aprile 2023 recuperando il nuovo ID multimediale dalle risorse delle creatività associate o caricando di nuovo l'asset.
content

string

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

AssetRole

Il ruolo di questo asset per la creatività.

Enum
ASSET_ROLE_UNSPECIFIED Il ruolo dell'asset 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 Si tratta di un asset con caricamento "polite" della creatività.
ASSET_ROLE_HEADLINE

Titolo di una creatività nativa.

L'elemento content deve utilizzare la codifica UTF-8 e avere una lunghezza massima di 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.

L'elemento content deve utilizzare la codifica UTF-8 e avere una lunghezza massima di 50 caratteri.

Questo ruolo è supportato solo nei seguenti creativeType:

  • CREATIVE_TYPE_NATIVE
  • CREATIVE_TYPE_NATIVE_SITE_SQUARE
  • CREATIVE_TYPE_NATIVE_VIDEO
ASSET_ROLE_BODY

Corpo del testo di una creatività nativa.

L'elemento content deve utilizzare la codifica UTF-8 e avere una lunghezza massima di 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.

L'elemento content deve utilizzare la codifica UTF-8 e avere una lunghezza massima di 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 offre agli utenti un'idea della pagina alla quale verranno indirizzati dopo aver fatto clic sulla creatività.

L'elemento content deve utilizzare la codifica 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 della 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.

Il content deve essere codificato in UTF-8 con una lunghezza non superiore a 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.

L'elemento content deve utilizzare la codifica UTF-8 e avere una lunghezza massima di 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 nello store. Sarà sempre quello fornito al momento del salvataggio della creatività.

Il content deve essere codificato in UTF-8 con una lunghezza non superiore a 15 caratteri.

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_ANDROID_APP_ID

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

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

Gli asset di questo ruolo sono di sola lettura.
ASSET_ROLE_IOS_APP_ID

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

Questo ID è indicato nell'URL dell'Apple App Store sotto forma di stringa di numeri direttamente dopo "id". Ad esempio, in https://apps.apple.com/us/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 di iOS.

Tieni presente che questo valore non viene sincronizzato automaticamente con la valutazione effettiva nello store. Sarà sempre quello fornito 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 è obbligatorio 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 ed è 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. Il campo type è obbligatorio quando:

  • EXIT_EVENT_TYPE_DEFAULT
  • EXIT_EVENT_TYPE_BACKUP
name

string

Il nome del clicktag dell'evento di uscita.

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

Lascia il campo vuoto o non impostato per le creatività che contengono solo asset immagine.
reportingName

string

Il nome utilizzato per identificare questo evento nei report. Lascia il campo vuoto o non impostato per le creatività che contengono 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 esserci più eventi di uscita di backup.

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 di unione offset. Il valore dell'offset. offset può essere solo uno dei seguenti:
percentage

string (int64 format)

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

string (int64 format)

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

UniversalAdId

Un identificatore di creatività fornito da un registry e univoco su tutte le piattaforme. 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 Registro di sistema fornisce identificatori univoci delle creatività.

UniversalAdRegistry

Il registry fornisce identificatori univoci di creatività in un ID annuncio universale.

Enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Universal Ad registry 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 l'ID annuncio 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 tenere traccia delle 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 un percorso o una stringa di query facoltativa, 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 che è stato completato il buffering audio o video.
THIRD_PARTY_URL_TYPE_CLICK_TRACKING Utilizzato per tenere traccia dei clic dell'utente sull'audio o sul video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_START Utilizzato per tenere traccia del numero di volte in cui un utente avvia l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FIRST_QUARTILE Utilizzato per tenere traccia del 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 Utilizzato per tenere traccia del 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 Utilizzato per tenere traccia del 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 Utilizzato per tenere traccia del numero di volte in cui l'audio o il video viene riprodotto fino alla fine.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_MUTE Utilizzato per tenere traccia del numero di volte in cui un utente disattiva l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PAUSE Utilizzato per tenere traccia del numero di volte in cui un utente mette in pausa l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_REWIND Utilizzato per tenere traccia del numero di volte in cui un utente ha ripetuto l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Utilizzato per tenere traccia del numero di volte in cui l'utente espande il player a schermo intero.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_STOP Utilizzato per tenere traccia del numero di volte in cui un utente interrompe l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_CUSTOM Utilizzato per tenere traccia del numero di volte in cui un utente esegue un clic personalizzato, ad esempio un clic su un'area sensibile del video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_SKIP Utilizzato per tenere traccia del numero di volte in cui l'audio o il video sono stati ignorati.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Utilizzato per tenere traccia del numero di volte in cui l'audio o il video viene riprodotto con un offset determinato dal progressOffset.

Transcodifica

Rappresenta le informazioni relative al 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 è avvenuta correttamente.
dimensions

object (Dimensions)

Le dimensioni del video transcodificato.
bitRateKbps

string (int64 format)

La velocità 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 velocità in bit per lo stream audio del video transcodificato o la velocità in bit per l'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, 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 del gestore della campagna 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

Il 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: "Scegli Tu!".
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 superiore destra della creatività.
OBA_ICON_POSITION_UPPER_LEFT Nella parte superiore sinistra della creatività.
OBA_ICON_POSITION_LOWER_RIGHT Nella parte inferiore destra della creatività.
OBA_ICON_POSITION_LOWER_LEFT Nella parte inferiore 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 a sinistra.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Si espande verso il basso e a destra.
EXPANDING_DIRECTION_UP_OR_DOWN Si espande verso l'alto o verso il basso.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Si espande a sinistra o a destra.
EXPANDING_DIRECTION_ANY_DIAGONAL Espansione in qualsiasi direzione diagonale.

Metodi

create

 Crea una nuova creatività.

delete

 Elimina una creatività.

get

 Genera una creatività.

list

 Elenca le creatività in un inserzionista.

patch

 Consente di aggiornare una creatività esistente.