REST Resource: curators.curatedPackages

Risorsa: CuratedPackage

Rappresenta un pacchetto di inventario selezionato, creato e gestito da un curatore.

Rappresentazione JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
Campi
name

string

Identificatore. Il nome univoco della risorsa per il pacchetto selezionato. Formato: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Obbligatorio. Il nome visualizzato assegnato al pacchetto selezionato dal curatore. Può essere utilizzato per filtrare la risposta del metodo curatedPackages.list.

description

string

Facoltativo. Una descrizione del pacchetto selezionato, fornita dal curatore.

createTime

string (Timestamp format)

Solo output. Il timestamp di creazione del pacchetto selezionato. Può essere utilizzato per filtrare la risposta del metodo curatedPackages.list.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo output. Il timestamp dell'ultimo aggiornamento del pacchetto selezionato. Può essere utilizzato per filtrare la risposta del metodo curatedPackages.list.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

Facoltativo. Il CPM minimo che un acquirente deve offrire per partecipare alle aste per l'inventario in questo pacchetto selezionato. Può essere utilizzato per filtrare la risposta del metodo curatedPackages.list.

state

enum (State)

Solo output. Lo stato del pacchetto selezionato. Può essere utilizzato per filtrare la risposta del metodo curatedPackages.list.

accessSettings

object (AccessControlSettings)

Obbligatorio. Impostazioni per controllare l'accesso al pacchetto selezionato.

L'accesso a questo pacchetto selezionato è limitato ai media planner inclusi nella lista consentita e al creator. Gli acquirenti e gli offerenti non possono essere inseriti nella lista consentita o avere accesso diretto a questa risorsa.

targeting

object (PackageTargeting)

Facoltativo. Criteri di targeting per il pacchetto selezionato.

curationFeeVisibility

enum (CurationFeeVisibility)

Facoltativo. Immutabile. La visibilità della tariffa combinata del pacchetto selezionato e delle tariffe dei segmenti di dati (la tariffa di selezione totale).

Commissione pagata al curatore per questo pacchetto. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
feeCpm

object (Money)

Facoltativo. La tariffa CPM addebitata dal curatore agli acquirenti che utilizzano questo pacchetto selezionato. Può essere utilizzato per filtrare la risposta del metodo curatedPackages.list.

millipercentOfMediaFee

string (int64 format)

Facoltativo. La tariffa verrà addebitata come percentuale del costo delle impressioni, rappresentata in millesimi di percentuale. Ad esempio, l'1% è rappresentato come 1000.

Fine dei campi che si escludono a vicenda.

Stato

Lo stato del pacchetto selezionato.

Enum
STATE_UNSPECIFIED Valore predefinito.
ACTIVE Il pacchetto selezionato è attivo.
INACTIVE Il pacchetto selezionato non è attivo.

AccessControlSettings

Impostazioni per controllare l'accesso a un pacchetto selezionato.

Rappresentazione JSON
{
  "allowlistedMediaPlanners": [
    string
  ]
}
Campi
allowlistedMediaPlanners[]

string

Obbligatorio. Immutabile. L'elenco dei media planner a cui è stato concesso esplicitamente l'accesso al pacchetto selezionato. I media planner idonei sono disponibili nel metodo mediaPlanners.list. Al momento, è possibile inserire nella lista consentita un solo media planner.

Formato: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Criteri di targeting per i pacchetti selezionati e di aste.

Rappresentazione JSON
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Campi
includedDeviceTypes[]

enum (DeviceType)

Facoltativo. L'elenco dei tipi di dispositivi inclusi da scegliere come target. Se il campo è vuoto, il targeting viene applicato a tutti i tipi di dispositivi.

includedEnvironment

enum (Environment)

Facoltativo. L'ambiente da scegliere come target. Se non viene specificato, il targeting viene applicato a tutti gli ambienti.

includedCreativeFormat

enum (CreativeFormat)

Facoltativo. Il formato della creatività da scegliere come target. Se non viene impostato, vengono scelti come target tutti i tipi di markup delle creatività.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

Facoltativo. Il tipo di pagina AMP (Accelerated Mobile Pages) scelto come target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dallo stato AMP.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

Facoltativo. L'elenco incluso degli stati dei venditori autorizzati scelti come target. Se il campo è vuoto, l'inventario verrà scelto come target indipendentemente dallo stato del venditore.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

Facoltativo. I tipi di inventario nativo scelti come target. Se il campo è vuoto, l'inventario verrà scelto come target indipendentemente dal tipo di inventario nativo.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

Facoltativo. L'elenco dei tipi di Open Measurement scelti come target. Se il campo è vuoto, l'inventario verrà scelto come target indipendentemente dal supporto di Open Measurement.

includedRestrictedCategories[]

enum (RestrictedCategory)

Facoltativo. L'elenco delle categorie con restrizioni scelte come target. Se vuoto, l'inventario verrà scelto come target indipendentemente dalle categorie con restrizioni.

includedRewardedType

enum (RewardedType)

Facoltativo. Il tipo di annuncio con premio scelto come target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dal tipo di annuncio con premio.

videoTargeting

object (PackageVideoTargeting)

Facoltativo. Criteri di targeting specifici per i video.

minimumPredictedViewabilityPercentage

string (int64 format)

Facoltativo. La percentuale di visibilità minima prevista target.

Questo valore deve essere un multiplo di 10 compreso tra 10 e 90 (inclusi). Ad esempio, 10 è un valore valido, ma 0, 15 e 100 non lo sono. Un valore pari a 10 indica che la configurazione corrisponderà solo alle aree annuncio per le quali prevediamo una visibilità di almeno il 10%.

Un valore non impostato indica che l'inventario verrà scelto come target indipendentemente dalla visibilità prevista.

languageTargeting

object (StringTargetingDimension)

Facoltativo. Le lingue da scegliere come target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dalla lingua. Consulta la pagina https://developers.google.com/google-ads/api/data/codes-formats#languages per l'elenco dei codici lingua supportati.

includedAdSizes[]

object (AdSize)

Facoltativo. L'elenco delle dimensioni degli annunci da scegliere come target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dalle dimensioni dell'annuncio.

I pacchetti selezionati supportano le dimensioni degli annunci PIXEL e INTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

Facoltativo. I publisher target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dal publisher. I publisher vengono identificati dal loro ID publisher dai file ads.txt/app-ads.txt. Per maggiori dettagli, visita le pagine https://iabtechlab.com/ads-txt/ e https://iabtechlab.com/app-ads-txt/.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

Facoltativo. La percentuale di clic minima prevista target, con valori compresi tra [10, 10000] (0,01% - 10%). Un valore pari a 50 indica che la configurazione corrisponderà solo alle aree annuncio per le quali prevediamo una percentuale di clic di almeno lo 0,05%.

Un valore non impostato indica che l'inventario verrà scelto come target indipendentemente dalla percentuale di clic prevista.

verticalTargeting

object (CriteriaTargeting)

Facoltativo. I verticali inclusi o esclusi come definiti in https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dal verticale.

geoTargeting

object (CriteriaTargeting)

Facoltativo. Gli ID criteri geografici da includere o escludere, come definiti in https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. Se non viene impostato alcun valore, l'inventario verrà scelto come target indipendentemente dalla località geografica.

includedDataSegments[]

string

Facoltativo. I segmenti di dati attivi da scegliere come target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dai segmenti di dati. Formato: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

Facoltativo. Informazioni sul targeting per posizionamento, ad esempio URL, app mobile.

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

Facoltativo. Gli indicatori forniti dal publisher da scegliere come target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dagli indicatori forniti dal publisher.

DeviceType

Il tipo generale di dispositivo da scegliere come target.

Enum
DEVICE_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
DEVICE_TYPE_PERSONAL_COMPUTER Sceglie come target i computer desktop o laptop.
DEVICE_TYPE_CONNECTED_TV Sceglie come target le TV connesse: dispositivi che riproducono contenuti TV in streaming, tra cui smart TV, console per videogiochi e streaming box/chiavette.
DEVICE_TYPE_PHONE Sceglie come target i dispositivi mobili di fascia alta.
DEVICE_TYPE_TABLET Sceglie come target i dispositivi tablet.

Ambiente

L'ambiente da scegliere come target.

Enum
ENVIRONMENT_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
ENVIRONMENT_SITE Sceglie come target l'inventario visualizzato all'interno di un sito web con pubblicità.
ENVIRONMENT_APP Sceglie come target l'inventario all'interno di un'applicazione mobile.

CreativeFormat

Il formato della creatività che può essere scelto come target.

Enum
CREATIVE_FORMAT_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
CREATIVE_FORMAT_DISPLAY Sceglie come target le aree annuncio destinate alle creatività display HTML.
CREATIVE_FORMAT_VIDEO Sceglie come target le aree annuncio destinate alle creatività video.
CREATIVE_FORMAT_AUDIO Sceglie come target le aree annuncio destinate alle creatività audio.

AcceleratedMobilePageType

Il tipo di implementazione di Accelerated Mobile Pages (AMP) da scegliere come target.

Enum
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP Sceglie come target l'inventario su pagine web standard che non utilizzano alcun framework AMP.
ACCELERATED_MOBILE_PAGE_TYPE_AMP Sceglie come target l'inventario nelle pagine create utilizzando il framework HTML AMP di base.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY Sceglie come target l'inventario sulle pagine che utilizzano il formato AMP Story (STAMP), ottimizzato per lo storytelling visivo (ad es. esperienze a schermo intero toccabili).

AuthorizedSellerStatus

Rappresenta la relazione tra il publisher e il venditore, come dichiarato in un file ads.txt o app-ads.txt.

Enum
AUTHORIZED_SELLER_STATUS_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
AUTHORIZED_SELLER_STATUS_DIRECT Sceglie come target l'inventario in cui il venditore è dichiarato come "DIRECT". Questo indica che il publisher (proprietario dei contenuti) controlla direttamente l'account venditore e ha un contratto commerciale diretto con il sistema pubblicitario per questo account.
AUTHORIZED_SELLER_STATUS_RESELLER Sceglie come target l'inventario in cui il venditore è dichiarato come "RESELLER". Questo indica che il publisher ha autorizzato un'altra persona giuridica a gestire l'account venditore elencato e a rivendere il proprio spazio pubblicitario.

NativeInventoryType

Rappresenta il tipo di rendering della creatività supportato da un'area annuncio, in particolare in relazione agli annunci nativi.

Enum
NATIVE_INVENTORY_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY Sceglie come target le aree annuncio che accettano e mostrano solo annunci nativi.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER Sceglie come target le aree annunci che accettano e mostrano annunci nativi o annunci banner.

OpenMeasurementType

Il tipo di Open Measurement Interface Definition (OMID) da scegliere come target.

Enum
OPEN_MEASUREMENT_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
OPEN_MEASUREMENT_TYPE_OMID_V1 Seleziona come target l'inventario che supporta la versione 1 di Open Measurement Interface Definition (OMID).

RestrictedCategory

Rappresenta le categorie specifiche di annunci il cui targeting è limitato dalle norme.

Enum
RESTRICTED_CATEGORY_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
RESTRICTED_CATEGORY_ALCOHOL Sceglie come target l'inventario in cui gli annunci correlati ad alcolici sono consentiti dal publisher.
RESTRICTED_CATEGORY_GAMBLING Sceglie come target l'inventario in cui gli annunci di giochi e scommesse sono consentiti dal publisher.

RewardedType

Definisce i criteri di targeting in base al fatto che l'inventario pubblicitario offra o meno un premio all'utente per la visualizzazione di un annuncio.

Enum
REWARDED_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
REWARDED_TYPE_NON_REWARDED Sceglie come target l'inventario che NON offre un premio esplicito all'utente per la visualizzazione o l'interazione con l'annuncio.
REWARDED_TYPE_REWARDED Sceglie come target l'inventario che offre un premio all'utente in cambio della visualizzazione o dell'interazione con l'annuncio.

PackageVideoTargeting

Criteri di targeting specifici per i video.

Rappresentazione JSON
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Campi
includedMimeTypes[]

enum (VideoMimeType)

Facoltativo. L'elenco dei tipi MIME video target utilizzando le stringhe dei tipi MIME pubblicate da IANA (https://www.iana.org/assignments/media-types/media-types.xhtml). Se il campo è vuoto, l'inventario verrà scelto come target indipendentemente dal tipo MIME del video.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

Facoltativo. La durata massima degli annunci video target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dalla durata massima dell'annuncio video.

includedPositionTypes[]

enum (PositionType)

Facoltativo. I tipi di posizione degli annunci video scelti come target. Se il campo è vuoto, l'inventario verrà scelto come target indipendentemente dal tipo di posizione dell'annuncio video.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

Facoltativo. Il metodo di pubblicazione dei video scelto come target. Se non viene impostato, l'inventario verrà scelto come target indipendentemente dal metodo di pubblicazione dei video.

plcmtTargeting

object (VideoPlcmtTargeting)

Facoltativo. I tipi di posizionamento video target. Se non viene impostato alcun valore, l'inventario verrà scelto come target indipendentemente dal tipo di plcmt video.

includedPlaybackMethods[]

enum (PlaybackMethod)

Facoltativo. L'elenco dei metodi di riproduzione video scelti come target. Se il campo è vuoto, l'inventario verrà scelto come target indipendentemente dal metodo di riproduzione video.

minimumPredictedCompletionRatePercentage

string (int64 format)

Facoltativo. La percentuale della percentuale di completamento minima prevista target.

Questo valore deve essere un multiplo di 10 compreso tra 10 e 90 (inclusi). Ad esempio, 10 è un valore valido, ma 0, 15 e 100 non lo sono. Un valore pari a 10 indica che la configurazione corrisponderà solo alle aree annuncio per le quali prevediamo una percentuale di completamento di almeno il 10%.

Un valore non impostato indica che l'inventario verrà scelto come target indipendentemente dalla percentuale di completamento prevista.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

Facoltativo. Le dimensioni del video player target. Se non viene impostato alcun valore, l'inventario verrà scelto come target indipendentemente dalle dimensioni del video player.

VideoMimeType

I tipi MIME video da scegliere come target.

Enum
VIDEO_MIME_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
VIDEO_MIME_TYPE_THREEGPP Formato container 3GPP utilizzato sugli smartphone 3G.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 Contenitore MPEG-4, in genere con codec H.264.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH.
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (utilizzato per gli annunci VPAID).
VIDEO_MIME_TYPE_WEBM Container WebM che presuppone il codec VP9.

MaximumVideoAdDuration

Il limite massimo della durata della creatività dell'annuncio video da scegliere come target. I valori enum definiscono i bucket e la selezione di un valore indica che la durata della creatività deve essere inferiore o uguale al tempo specificato.

Enum
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS Si applica agli annunci video con una durata massima di 15 secondi (0 < durata <= 15 s).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS Si applica agli annunci video con una durata massima di 20 secondi (0 < durata <= 20 s).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS Si applica agli annunci video con una durata massima di 30 secondi (0 < durata <= 30 s).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS Si applica agli annunci video con una durata massima di 60 secondi (0 < durata <= 60 s).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS Si applica agli annunci video con una durata massima di 90 secondi (0 < durata <= 90 s).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS Si applica agli annunci video con una durata massima di 120 secondi (0 < durata <= 120 s).

PositionType

La posizione targetizzabile dell'annuncio all'interno di un video.

Enum
POSITION_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
POSITION_TYPE_MIDROLL L'annuncio viene riprodotto durante la riproduzione dei contenuti video.
POSITION_TYPE_POSTROLL L'annuncio viene riprodotto dopo il contenuto video.
POSITION_TYPE_PREROLL L'annuncio viene riprodotto prima dei contenuti video.

ContentDeliveryMethod

Criteri di targeting basati sul metodo di pubblicazione dei contenuti video.

Enum
CONTENT_DELIVERY_METHOD_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
CONTENT_DELIVERY_METHOD_STREAMING Sceglie come target i contenuti video trasmessi in diretta.
CONTENT_DELIVERY_METHOD_PROGRESSIVE Sceglie come target i contenuti video che vengono trasferiti in modo incrementale in base alle esigenze di riproduzione del client.

VideoPlcmtTargeting

Definisce i criteri di targeting in base al tipo di posizionamento video, che spesso corrisponde al campo "plcmt" di OpenRTB di IAB.

Rappresentazione JSON
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Campi
selectionType

enum (SelectionType)

Obbligatorio. Il tipo di selezione per l'elenco dei posizionamenti video.

videoPlcmtTypes[]

enum (VideoPlcmtType)

Obbligatorio. L'elenco dei tipi di posizionamenti video scelti come target. Se il campo è vuoto, l'inventario verrà scelto come target indipendentemente dal tipo di plcmt del video.

SelectionType

Enum per i possibili tipi di selezione utilizzati dalle dimensioni di targeting.

Enum
SELECTION_TYPE_UNSPECIFIED Tipo di selezione non specificato. Non deve essere utilizzato.
SELECTION_TYPE_INCLUDE I valori nella dimensione di targeting sono inclusi.
SELECTION_TYPE_EXCLUDE I valori nella dimensione di targeting sono esclusi.

VideoPlcmtType

Rappresenta il tipo di posizionamento video, in linea con gli standard OpenRTB.

Enum
VIDEO_PLCMT_TYPE_UNSPECIFIED Valore predefinito. Non deve essere utilizzato nelle specifiche di targeting.
INSTREAM Annunci pre-roll, mid-roll e post-roll riprodotti prima, durante o dopo i contenuti video in streaming richiesti dal consumatore. I video in-stream devono essere impostati su "audio attivo" per impostazione predefinita all'avvio del player o avere un user intent esplicitamente chiaro di guardare i contenuti video. Anche se potrebbero essere presenti altri contenuti intorno al player, i contenuti video devono essere l'oggetto della visita dell'utente. Deve rimanere il contenuto principale della pagina e l'unico video player visibile in grado di riprodurre l'audio durante la riproduzione. Se il player diventa mobile/sticky, le chiamate dell'annuncio successive devono indicare con precisione le dimensioni aggiornate del player.
ACCOMPANYING_CONTENT Annunci pre-roll, mid-roll e post-roll riprodotti prima, durante o dopo lo streaming di contenuti video. Il video player viene caricato e riprodotto prima, tra o dopo i paragrafi di testo o i contenuti grafici e inizia la riproduzione solo quando entra nell'area visibile. La riproduzione dei contenuti aggiuntivi deve iniziare solo quando entrano nell'area visibile. Può essere convertito in un player mobile/fisso quando l'utente scorre la pagina.
INTERSTITIAL Annunci video riprodotti senza contenuti video. Durante la riproduzione, deve essere l'elemento principale della pagina, occupare la maggior parte dell'area visibile e non può essere rimosso dalla visualizzazione tramite scorrimento. Ciò può avvenire in posizionamenti come video in-app o presentazioni.
NO_CONTENT Annunci video riprodotti senza contenuti video in streaming. Può trattarsi di posizionamenti come presentazioni, feed nativi, contenuti o annunci fissi/mobili.

PlaybackMethod

Il metodo di riproduzione da scegliere come target.

Enum
PLAYBACK_METHOD_UNSPECIFIED Metodo di riproduzione video non specificato. Non deve essere utilizzato.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON La riproduzione inizia automaticamente quando la pagina o i contenuti vengono caricati.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF La riproduzione inizia automaticamente quando la pagina o i contenuti vengono caricati, ma con l'audio disattivato.
PLAYBACK_METHOD_CLICK_TO_PLAY La riproduzione viene avviata da un'azione dell'utente (ad es. il clic su un pulsante di riproduzione).

VideoPlayerSizeTargeting

Rappresenta le dimensioni del video player che può essere scelto come target. Sia la larghezza che l'altezza devono essere impostate su valori diversi da zero.

Rappresentazione JSON
{
  "minimumWidth": string,
  "minimumHeight": string
}
Campi
minimumWidth

string (int64 format)

Obbligatorio. La larghezza minima del video player in pixel.

minimumHeight

string (int64 format)

Obbligatorio. L'altezza minima del video player in pixel.

StringTargetingDimension

Targeting generico con valori di stringa.

Rappresentazione JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Campi
selectionType

enum (SelectionType)

Obbligatorio. Come devono essere scelti come target gli elementi di questo elenco.

values[]

string

Obbligatorio. I valori specificati.

AdSize

Rappresenta le dimensioni di una singola area annuncio o di una creatività.

Rappresentazione JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Campi
width

string (int64 format)

La larghezza dell'area annunci in pixel. Questo campo sarà presente solo se il tipo di dimensione è PIXEL.

height

string (int64 format)

L'altezza dell'area annunci in pixel. Questo campo sarà presente solo se il tipo di dimensione è PIXEL.

type

enum (Type)

Il tipo di dimensione dell'area annuncio.

Tipo

Rappresenta diversi tipi di dimensioni di aree annuncio/creatività.

Enum
TYPE_UNSPECIFIED Un segnaposto per un tipo di dimensione non definito.
PIXEL Area annunci con dimensioni specificate in base ad altezza e larghezza in pixel.
INTERSTITIAL Dimensioni speciali per descrivere un'area annuncio interstitial.
NATIVE Annunci nativi (per dispositivi mobili) di cui il publisher esegue il rendering.
FLUID Le dimensioni fluide (dimensioni adattabili) possono essere ridimensionate automaticamente in base al cambiamento dell'ambiente esterno.

CriteriaTargeting

Targeting generico utilizzato per le dimensioni di targeting che contengono un elenco di ID numerici inclusi ed esclusi. Non è possibile applicare un filtro utilizzando la sintassi del filtro elenco.

Rappresentazione JSON
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
Campi
targetedCriteriaIds[]

string (int64 format)

Un elenco di ID numerici da includere.

excludedCriteriaIds[]

string (int64 format)

Un elenco di ID numerici da escludere.

PackagePlacementTargeting

Rappresenta il targeting relativo ai luoghi in cui possono essere pubblicati gli annunci, ad esempio determinati siti o applicazioni mobile. I diversi tipi di targeting per posizionamento verranno combinati con l'operatore logico OR.

Rappresentazione JSON
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Campi
uriTargeting

object (StringTargetingDimension)

Facoltativo. L'elenco degli URL target o esclusi. I domini non devono contenere http/https (ad esempio google.com) e possono contenere un massimo di 5 percorsi per URL.

mobileAppTargeting

object (StringTargetingDimension)

Facoltativo. L'elenco degli ID applicazione mobile targetizzati o esclusi di proprietà dei publisher. Al momento sono supportate solo le app Android e Apple.

L'ID app per Android, ad esempio com.google.android.apps.maps, è disponibile nell'URL del Google Play Store. L'ID app per iOS (che è un numero) è disponibile alla fine dell'URL dell'iTunes Store. Le applicazioni mobile proprietarie sono incluse o escluse.

includedMobileAppCategoryTargeting[]

string (int64 format)

Facoltativo. L'elenco delle categorie di app mobile scelte come target.

PackagePublisherProvidedSignalsTargeting

Rappresenta il targeting relativo agli indicatori forniti dal publisher. I diversi tipi di indicatori forniti dal publisher verranno combinati con l'operatore logico OR.

Rappresentazione JSON
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Campi
audienceTargeting

object (TaxonomyTargeting)

Facoltativo. L'elenco degli ID dei segmenti di pubblico target o esclusi. Basata sulla tassonomia del pubblico IAB versione 1.1 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv)

contentTargeting

object (TaxonomyTargeting)

Facoltativo. L'elenco degli ID Content ID scelti come target o esclusi. Basata sulla tassonomia dei contenuti IAB versione 2.2 (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv)

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

Facoltativo. L'elenco degli ID dei segnali video e audio scelti come target ed esclusi. Questi sono indicatori aggiuntivi supportati dagli indicatori forniti dal publisher.

TaxonomyTargeting

Definisce i criteri di targeting per la gestione dello spazio degli ID della tassonomia dei contenuti e del pubblico IAB.

Rappresentazione JSON
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
Campi
targetedTaxonomyIds[]

string

Facoltativo. L'elenco degli ID della tassonomia dei contenuti target.

excludedTaxonomyIds[]

string

Facoltativo. L'elenco degli ID della tassonomia dei contenuti esclusi.

CurationFeeVisibility

La visibilità della tariffa combinata del pacchetto selezionato e delle tariffe dei segmenti di dati (la tariffa di selezione totale). Le tariffe sono sempre visibili al creator del pacchetto.

Enum
CURATION_FEE_VISIBILITY_UNSPECIFIED La visibilità della tariffa di selezione totale non è specificata.
DISCLOSED La tariffa di selezione totale è visibile a tutti gli acquirenti. Questo è il valore predefinito se non viene impostato.
NON_DISCLOSED La tariffa di selezione totale non è visibile a tutti gli acquirenti.

Metodi

activate

Attiva un pacchetto selezionato esistente.

create

Crea un nuovo pacchetto selezionato.

deactivate

Disattiva un pacchetto selezionato esistente.

get

Recupera un pacchetto selezionato in base al nome della risorsa.

list

Elenca i pacchetti selezionati di proprietà del curatore specificato.

patch

Aggiorna un pacchetto selezionato esistente.