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 è valido 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 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. revisione creatività). Assegnato dal sistema.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 di creazione della creatività. Assegnato dal sistema.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 tra:

  • 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 dei contenuti multimediali della creatività. Applicabile quando creativeType è uno tra:

  • 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à generata 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à su cui un utente può fare clic o che può 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)

Timer degli eventi personalizzati per una creatività rich media. I timer tengono traccia del 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 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, tocchi, caricamento dati, pressione di tasti 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 la creatività a un sistema esterno. Deve avere codifica UTF-8 con una lunghezza massima di 10.000 caratteri.

notes

string

Note utente per questa creatività. Deve avere codifica UTF-8 con una lunghezza massima di 20.000 caratteri.

iasCampaignMonitoring

boolean

Indica se il monitoraggio della campagna Integral Ad Science (IAS) è attivato. Per attivare questa opzione 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 di 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à contenenti additional dimensions non possono essere creatività companion.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
skippable

boolean

Se l'utente può scegliere di ignorare una creatività video.

Questo campo è supportato solo per i seguenti creativeType:

  • CREATIVE_TYPE_VIDEO
skipOffset

object (AudioVideoOffset)

Durata della riproduzione del video prima che appaia il pulsante Salta.

Questo campo è obbligatorio quando skippable è true.

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

  • CREATIVE_TYPE_VIDEO
universalAdId

object (UniversalAdId)

(Facoltativo) Un identificatore di creatività facoltativo fornito da un registro, 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. Transcodifiche audio/video.

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

Queste transcodifiche offrono al sistema di un publisher più opzioni tra cui scegliere per ogni impressione relativa al video e garantiscono 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 provider di analisi dei dati o fornitori di tecnologia pubblicitaria di terze parti.

Gli URL devono iniziare con https (tranne nell'inventario che non richiede la conformità SSL). Se utilizzi macro nell'URL, utilizza solo quelle supportate da Display & Video a 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, DoubleVerify, IAS, Moat). I tag 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 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

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

(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

combinato con il seguente creativeType:

  • CREATIVE_TYPE_STANDARD
  • CREATIVE_TYPE_EXPANDABLE
requireMraid

boolean

(Facoltativo) Indica che la creatività richiede il protocollo 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 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 essere visualizzata correttamente.

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 tag VAST 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

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 le seguenti origini 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 hosting:

  • HOSTING_SOURCE_THIRD_PARTY

combinato con il seguente creativeType:

  • CREATIVE_TYPE_EXPANDABLE
vastTagUrl

string

(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

combinato con il seguente creativeType:

  • CREATIVE_TYPE_AUDIO
  • CREATIVE_TYPE_VIDEO
vpaid

boolean

Solo output. Indica che la creatività tag VAST di terze parti richiede VPAID (interfaccia annuncio video player digitale).

Solo output valido 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

combinato con il seguente 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 valido 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

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 invece LineItem.creative_ids.

mp3Audio

boolean

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

Solo output valido e valido 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 output valido e valido 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 è stata 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

Controlla 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 avviare la pubblicazione di una creatività. 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[]

object (PublisherReviewStatus)

Stati di revisione del publisher relativi alla creatività.

StatoApprovazione

Possibili tipi di stato di approvazione. Questo è 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 è pubblicabile.
APPROVAL_STATUS_PENDING_SERVABLE La creatività ha trasmesso la creatività & la revisione della pagina di destinazione ed è pubblicabile, ma è in attesa di contenuti aggiuntivi e revisione secondo le norme.
APPROVAL_STATUS_APPROVED_SERVABLE Sia creativi che la revisione della pagina di destinazione, i contenuti revisione secondo le norme è approvata. 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 creatività nella piattaforma di scambio pubblicitario.

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

Un singolo asset.

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

string (int64 format)

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

Lo spazio dell'ID multimediale è stato aggiornato il 5 aprile 2023. Aggiorna gli ID media memorizzati nella cache prima del 5 aprile 2023 recuperando il nuovo ID multimediale dalle risorse delle creatività associate o ricaricando l'asset.

content

string

I contenuti della risorsa. Per gli asset caricati, i contenuti rappresentano 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 L'asset è un asset con caricamento "polite" della creatività.
ASSET_ROLE_HEADLINE

Titolo di una creatività nativa.

Il campo content deve utilizzare la codifica UTF-8 con 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.

Il campo content deve utilizzare la codifica UTF-8 con 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.

Il campo content deve utilizzare la codifica UTF-8 con 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.

Il campo content deve utilizzare la codifica UTF-8 con 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 vengono indirizzati dopo aver fatto clic sulla creatività.

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

Ad esempio, se l'URL pagina di destinazione è "http://www.example.com/page", l'URL del sottotitolo 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 campo content deve utilizzare la codifica UTF-8 con una lunghezza massima di 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.

Il campo content deve utilizzare la codifica UTF-8 con 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 nello store iOS (ad esempio, 5,99 €).

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

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

Gli asset con 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 con questo ruolo sono di sola lettura.

ASSET_ROLE_IOS_APP_ID

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

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

Gli asset con questo ruolo sono di sola lettura.

ASSET_ROLE_RATING

La valutazione di un'app nel Google Play Store o nello store di 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 con questo ruolo sono di sola lettura.

ASSET_ROLE_ICON

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 ed è richiesto 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. Questa operazione è necessaria se type è:

  • 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 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 un 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. Una creatività potrebbe contenere 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 di 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. 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 di creatività univoci in un ID annuncio universale.

Enum
UNIVERSAL_AD_REGISTRY_UNSPECIFIED Il registro di annunci universali non è specificato o è sconosciuto in questa versione.
UNIVERSAL_AD_REGISTRY_OTHER Utilizza un fornitore 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 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 un percorso facoltativo o una stringa di query, 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 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 Tiene 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 riproduce l'audio o il video.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_FULLSCREEN Utilizzato per tenere traccia del numero di volte in cui un 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 è stato saltato.
THIRD_PARTY_URL_TYPE_AUDIO_VIDEO_PROGRESS Utilizzato per tenere traccia del numero di volte in cui l'audio o il video viene riprodotto fino a un offset determinato da progressOffset.

Transcodifica

Rappresenta 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 è riuscita.

dimensions

object (Dimensions)

Le dimensioni del video transcodificato.

bitRateKbps

string (int64 format)

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 dello 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 Campaign Manager 360.

cmAdId

string (int64 format)

L'ID annuncio dell'annuncio di monitoraggio 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: "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 Sul lato superiore destro della creatività.
OBA_ICON_POSITION_UPPER_LEFT Sul lato superiore sinistro 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 verso sinistra.
EXPANDING_DIRECTION_DOWN_AND_RIGHT Si espande verso il basso e verso destra.
EXPANDING_DIRECTION_UP_OR_DOWN Espande verso l'alto o verso il basso.
EXPANDING_DIRECTION_LEFT_OR_RIGHT Si espande a sinistra o a destra.
EXPANDING_DIRECTION_ANY_DIAGONAL Può espandersi in qualsiasi direzione diagonale.

Metodi

create

Genera una nuova creatività.

delete

Elimina una creatività.

get

Recupera una creatività.

list

Elenca le creatività in un inserzionista.

patch

Aggiorna una creatività esistente.