REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Risorsa: AssignedTargetingOption

Una singola opzione di targeting assegnata, che definisce lo stato di un'opzione di targeting per un'entità con impostazioni di targeting.

Rappresentazione JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "assignedTargetingOptionIdAlias": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Campi
name

string

Solo output. Il nome della risorsa per questa opzione di targeting assegnata.

assignedTargetingOptionId

string

Solo output. L'ID univoco dell'opzione di targeting assegnata. L'ID è univoco solo all'interno di una determinata risorsa e di un determinato tipo di targeting. Possono essere riutilizzati in altri contesti.

assignedTargetingOptionIdAlias

string

Solo output. Un alias di assignedTargetingOptionId. Questo valore può essere utilizzato al posto di assignedTargetingOptionId durante il recupero o l'eliminazione del targeting esistente.

Questo campo sarà supportato solo per tutte le opzioni di targeting assegnate dei seguenti tipi di targeting:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Questo campo è supportato anche per le opzioni di targeting assegnate agli elementi pubblicitari dei seguenti tipi di targeting:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Solo output. Identifica il tipo di opzione di targeting assegnata.

inheritance

enum (Inheritance)

Solo output. Lo stato di ereditarietà dell'opzione di targeting assegnata.

Campo di unione details. Informazioni dettagliate sull'opzione di targeting assegnata. È possibile compilare un solo campo dettagliato e deve corrispondere a targeting_type; details può essere solo uno dei seguenti:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Dettagli del canale. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Dettagli sulle categorie di app. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Dettagli sull'app. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Dettagli URL. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Dettagli su giorno e ora. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Dettagli sulla fascia d'età. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Dettagli dell'elenco di località regionali. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Dettagli dell'elenco di località di prossimità. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Dettagli sul genere. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Dettagli sulle dimensioni del video player. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Dettagli dei contenuti con premio dell'utente. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Dettagli sullo stato parentale. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione dei contenuti in-stream. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione del outstream dei contenuti. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Dettagli sul tipo di dispositivo. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Dettagli sul targeting per pubblico. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_AUDIENCE_GROUP. Puoi scegliere come target una sola opzione di gruppo di pubblico per risorsa.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Dettagli del browser. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Dettagli sul reddito del nucleo familiare. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione sullo schermo. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Dettagli operatore e ISP. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Dettagli parola chiave. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_KEYWORD.

A una risorsa è possibile assegnare un massimo di 5000 parole chiave escluse dirette. Nessun limite al numero di parole chiave positive che possono essere assegnate.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Dettagli parola chiave. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

È possibile assegnare un massimo di 4 elenchi di parole chiave escluse a una risorsa.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Dettagli del sistema operativo. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Dettagli di marca e modello del dispositivo. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Dettagli ambiente. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Dettagli sull'origine dell'inventario. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Dettagli categoria. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_CATEGORY.

Scegliere come target una categoria sceglierà come target anche le relative categorie secondarie. Se una categoria viene esclusa dal targeting e viene inclusa una sottocategoria, l'esclusione avrà la precedenza.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Dettagli sulla visibilità. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_VIEWABILITY.

Puoi scegliere come target una sola opzione di visibilità per risorsa.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Dettagli sullo stato del venditore autorizzato. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Puoi scegliere come target una sola opzione di stato di venditore autorizzato per risorsa.

Se per una risorsa non è disponibile un'opzione relativa allo stato di venditore autorizzato, tutti i venditori autorizzati indicati come DIRECT o RESELLER nel file ads.txt vengono scelti come target per impostazione predefinita.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Dettagli sulla lingua. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Dettagli sulla regione geografica. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Dettagli del gruppo di origini dell'inventario. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Dettagli sulle etichette contenuti digitali. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Le etichette contenuti digitali hanno come target esclusioni. Le esclusioni delle etichette contenuti digitali a livello di inserzionista, se impostate, vengono sempre applicate nella pubblicazione, anche se non sono visibili nelle impostazioni delle risorse. Le impostazioni delle risorse possono escludere le etichette contenuti oltre alle esclusioni degli inserzionisti, ma non possono eseguirne l'override. Un elemento pubblicitario non viene pubblicato se tutte le etichette contenuti digitali sono escluse.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Dettagli sulle categorie sensibili. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Le categorie sensibili hanno come target esclusioni. Le esclusioni di categorie sensibili a livello di inserzionista, se impostate, vengono sempre applicate nella pubblicazione, anche se non sono visibili nelle impostazioni delle risorse. Le impostazioni delle risorse possono escludere categorie sensibili oltre alle esclusioni degli inserzionisti, ma non possono sostituirle.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Dettagli della piattaforma di scambio pubblicitario. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Dettagli della piattaforma di scambio pubblicitario secondaria. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Dettagli sulla verifica di terze parti. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Dettagli PDI. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Dettagli della catena commerciale. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Dettagli sulla durata dei contenuti. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Dettagli sulla durata dei contenuti. Questo campo verrà compilato quando il valore TargetingType sarà TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione dei contenuti nativi. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Dettagli dell'inventario abilitato per Open Measurement. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Dettagli sul tipo di contenuti audio. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Dettagli sul genere dei contenuti. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_CONTENT_GENRE.

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Dettagli dei video di YouTube. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_YOUTUBE_VIDEO.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Dettagli del canale YouTube. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione della sessione. Questo campo verrà compilato quando targetingType sarà TARGETING_TYPE_SESSION_POSITION.

Eredità

Indica se l'opzione di targeting assegnata viene ereditata da un'entità di livello superiore come un partner o un inserzionista. Le opzioni di targeting assegnate ereditate hanno la precedenza, vengono sempre applicate nella pubblicazione al targeting assegnato al livello corrente e non possono essere modificate tramite il servizio entità corrente. Devono essere modificati tramite il servizio entità da cui vengono ereditati. L'ereditarietà viene applicata solo ai canali con targeting per esclusione, alle esclusioni di categorie sensibili ed alle etichette contenuti digitali se sono configurate al livello principale.

Enum
INHERITANCE_UNSPECIFIED L'ereditarietà non è specificata o è sconosciuta.
NOT_INHERITED L'opzione di targeting assegnata non viene ereditata dall'entità di livello superiore.
INHERITED_FROM_PARTNER L'opzione di targeting assegnata viene ereditata dalle impostazioni di targeting del partner.
INHERITED_FROM_ADVERTISER L'opzione di targeting assegnata viene ereditata dalle impostazioni di targeting dell'inserzionista.

ChannelAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per canale assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_CHANNEL.

Rappresentazione JSON
{
  "channelId": string,
  "negative": boolean
}
Campi
channelId

string (int64 format)

obbligatorio. ID del canale. Deve fare riferimento al campo dell'ID canale su una risorsa canale di proprietà del partner o canale di proprietà dell'inserzionista.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione. Per l'opzione di targeting assegnata a livello di inserzionista, questo campo deve essere true.

AppCategoryAssignedTargetingOptionDetails

Dettagli relativi all'opzione di targeting per categoria di app assegnata. Verrà compilato nel campo appCategoryDetails di un AssignedTargetingOption quando targetingType è TARGETING_TYPE_APP_CATEGORY.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato della categoria di app.

targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_APP_CATEGORY.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

AppAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per app assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_APP.

Rappresentazione JSON
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Campi
appId

string

obbligatorio. L'ID dell'app.

L'app Play Store di Android utilizza un ID bundle, ad esempio com.google.android.gm. L'ID app dell'App Store di Apple utilizza una stringa di 9 cifre, ad esempio 422689480.

displayName

string

Solo output. Il nome visualizzato dell'app.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

appPlatform

enum (AppPlatform)

Indica la piattaforma dell'app scelta come target. Se questo campo non viene specificato, si presume che la piattaforma dell'app sia mobile (ad es. Android o iOS) e ricaveremo la piattaforma mobile appropriata dall'ID app.

AppPlatform

Possibili opzioni di targeting per piattaforma di app.

Enum
APP_PLATFORM_UNSPECIFIED Valore predefinito se la piattaforma app non è specificata in questa versione. Questa enum è un segnaposto per il valore predefinito e non rappresenta un'opzione della piattaforma reale.
APP_PLATFORM_IOS La piattaforma dell'app è iOS.
APP_PLATFORM_ANDROID La piattaforma delle app è Android.
APP_PLATFORM_ROKU La piattaforma dell'app è Roku.
APP_PLATFORM_AMAZON_FIRETV La piattaforma dell'app è Amazon FireTV.
APP_PLATFORM_PLAYSTATION La piattaforma dell'app è Playstation.
APP_PLATFORM_APPLE_TV La piattaforma dell'app è Apple TV.
APP_PLATFORM_XBOX La piattaforma dell'app è Xbox.
APP_PLATFORM_SAMSUNG_TV La piattaforma dell'app è Samsung TV.
APP_PLATFORM_ANDROID_TV La piattaforma dell'app è Android TV.
APP_PLATFORM_GENERIC_CTV Si tratta di una piattaforma per TV connesse a internet (CTV) che non è elencata esplicitamente altrove.

UrlAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting per URL assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_URL.

Rappresentazione JSON
{
  "url": string,
  "negative": boolean
}
Campi
url

string

obbligatorio. L'URL, ad esempio example.com.

DV360 supporta due livelli di targeting per sottodirectory, ad esempio www.example.com/one-subdirectory-level/second-level, e cinque livelli di targeting per sottodominio, ad esempio five.four.three.two.one.example.com.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

DayAndTimeAssignedTargetingOptionDetails

Rappresentazione di un segmento di tempo definito in un giorno specifico della settimana e con un'ora di inizio e di fine. L'ora rappresentata da startHour deve essere precedente all'ora rappresentata da endHour.

Rappresentazione JSON
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Campi
dayOfWeek

enum (DayOfWeek)

obbligatorio. Il giorno della settimana per questa impostazione di targeting per giorno e ora.

startHour

integer

obbligatorio. L'ora di inizio del targeting per giorno e ora. Il valore deve essere compreso tra 0 (inizio giornata) e 23 (1 ora prima della fine della giornata).

endHour

integer

obbligatorio. L'ora di fine del targeting per giorno e ora. Il valore deve essere compreso tra 1 (1 ora dopo l'inizio della giornata) e 24 (fine giornata).

timeZoneResolution

enum (TimeZoneResolution)

obbligatorio. Il meccanismo utilizzato per determinare il fuso orario da utilizzare per questa impostazione di targeting per giorno e ora.

DayOfWeek

Rappresenta un giorno della settimana.

Enum
DAY_OF_WEEK_UNSPECIFIED Il giorno della settimana non è specificato.
MONDAY Lunedì
TUESDAY Martedì
WEDNESDAY Mercoledì
THURSDAY Giovedì
FRIDAY venerdì
SATURDAY Sabato
SUNDAY domenica

TimeZoneResolution

Possibili approcci per la risoluzione del fuso orario.

Enum
TIME_ZONE_RESOLUTION_UNSPECIFIED La risoluzione del fuso orario è inspecifica o sconosciuta.
TIME_ZONE_RESOLUTION_END_USER Le ore vengono risolte nel fuso orario dell'utente che ha visualizzato l'annuncio.
TIME_ZONE_RESOLUTION_ADVERTISER Le ore vengono risolte nel fuso orario dell'inserzionista che ha pubblicato l'annuncio.

AgeRangeAssignedTargetingOptionDetails

Rappresenta una fascia d'età utilizzabile per il targeting. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_AGE_RANGE.

Rappresentazione JSON
{
  "ageRange": enum (AgeRange)
}
Campi
ageRange

enum (AgeRange)

obbligatorio. La fascia d'età di un segmento di pubblico. Supportiamo solo il targeting di una fascia d'età continua del pubblico. Pertanto, la fascia d'età rappresentata in questo campo può essere 1) scelta come target esclusivamente oppure 2) parte di una fascia d'età continua più ampia. La copertura del targeting per fascia d'età continua può essere ampliata scegliendo come target anche un segmento di pubblico di età sconosciuta.

RegionalLocationListAssignedTargetingOptionDetails

Dettagli del targeting per l'elenco di località a livello di regione. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_REGIONAL_LOCATION_LIST.

Rappresentazione JSON
{
  "regionalLocationListId": string,
  "negative": boolean
}
Campi
regionalLocationListId

string (int64 format)

obbligatorio. ID dell'elenco di località a livello di regione. Deve fare riferimento al campo locationListId di una risorsa LocationList il cui tipo è TARGETING_LOCATION_TYPE_REGIONAL.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

ProximityLocationListAssignedTargetingOptionDetails

Dettagli sul targeting per l'elenco di località di prossimità. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

Rappresentazione JSON
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
Campi
proximityLocationListId

string (int64 format)

obbligatorio. ID dell'elenco di località di prossimità. Deve fare riferimento al campo locationListId di una risorsa LocationList il cui tipo è TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadius

number

obbligatorio. Raggio espresso nelle unità di distanza impostate in proximityRadiusUnit. Rappresenta le dimensioni dell'area attorno a una località scelta che verrà scelta come target. Il raggio deve essere compreso tra 1 e 500 miglia o 800 chilometri.

proximityRadiusUnit

enum (ProximityRadiusUnit)

obbligatorio. Unità distanza raggio.

ProximityRadiusUnit

Enum delle unità di distanza per ProximityRadius.

Enum
PROXIMITY_RADIUS_UNIT_UNSPECIFIED Valore predefinito se in questa versione non sono specificate unità di misura. Questa enum è un segnaposto per il valore predefinito e non rappresenta un'unità di distanza reale.
PROXIMITY_RADIUS_UNIT_MILES Unità di distanza raggio in miglia.
PROXIMITY_RADIUS_UNIT_KILOMETERS Unità raggio in chilometri

GenderAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per genere assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_GENDER.

Rappresentazione JSON
{
  "gender": enum (Gender)
}
Campi
gender

enum (Gender)

obbligatorio. Il genere del pubblico.

VideoPlayerSizeAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per dimensione del video player. Verrà inserito nel campo videoPlayerSizeDetails quando targetingType sarà TARGETING_TYPE_VIDEO_PLAYER_SIZE. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto, rimuovi tutte le opzioni di targeting per dimensione del video player.

Rappresentazione JSON
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Campi
videoPlayerSize

enum (VideoPlayerSize)

obbligatorio. Le dimensioni del video player.

UserRewardedContentAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per contenuti con premio dell'utente. Verrà inserito nel campo userRewardedContentDetails quando targetingType sarà TARGETING_TYPE_USER_REWARDED_CONTENT.

Rappresentazione JSON
{
  "targetingOptionId": string,
  "userRewardedContent": enum (UserRewardedContent)
}
Campi
targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_USER_REWARDED_CONTENT.

userRewardedContent

enum (UserRewardedContent)

Solo output. Stato dei contenuti con premio dell'utente per gli annunci video.

ParentalStatusAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per stato parentale assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_PARENTAL_STATUS.

Rappresentazione JSON
{
  "parentalStatus": enum (ParentalStatus)
}
Campi
parentalStatus

enum (ParentalStatus)

obbligatorio. Lo stato parentale del segmento di pubblico.

ContentInstreamPositionAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per posizione in-stream dei contenuti assegnati. Verrà inserito nel campo contentInstreamPositionDetails quando targetingType sarà TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Rappresentazione JSON
{
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
Campi
contentInstreamPosition

enum (ContentInstreamPosition)

obbligatorio. La posizione dei contenuti in-stream per gli annunci video o audio.

adType

enum (AdType)

Solo output. Il tipo di annuncio da scegliere come target. Applicabile solo al targeting dell'ordine di inserzione e i nuovi elementi pubblicitari che supportano il tipo di annuncio specificato erediteranno questa opzione di targeting per impostazione predefinita. I valori possibili sono:

  • AD_TYPE_VIDEO, l'impostazione verrà ereditata dal nuovo elemento pubblicitario quando lineItemType sarà LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, l'impostazione verrà ereditata dal nuovo elemento pubblicitario quando lineItemType sarà LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Rappresenta il tipo di creatività associato agli annunci.

Enum
AD_TYPE_UNSPECIFIED Il tipo di annuncio non è specificato o è sconosciuto in questa versione.
AD_TYPE_DISPLAY Creatività display, ad esempio immagine e HTML5.
AD_TYPE_VIDEO Creatività video, ad esempio annunci video riprodotti durante la riproduzione in streaming di contenuti nei video player.
AD_TYPE_AUDIO Creatività audio, ad esempio annunci audio riprodotti durante la riproduzione di contenuti audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per posizione outstream dei contenuti assegnati. Verrà inserito nel campo contentOutstreamPositionDetails quando targetingType sarà TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Rappresentazione JSON
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
Campi
contentOutstreamPosition

enum (ContentOutstreamPosition)

obbligatorio. La posizione dei contenuti outstream.

adType

enum (AdType)

Solo output. Il tipo di annuncio da scegliere come target. Applicabile solo al targeting dell'ordine di inserzione e i nuovi elementi pubblicitari che supportano il tipo di annuncio specificato erediteranno questa opzione di targeting per impostazione predefinita. I valori possibili sono:

  • AD_TYPE_DISPLAY, l'impostazione verrà ereditata dal nuovo elemento pubblicitario quando lineItemType sarà LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, l'impostazione verrà ereditata dal nuovo elemento pubblicitario quando lineItemType sarà LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Dettagli sul targeting per tipo di dispositivo. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_DEVICE_TYPE.

Rappresentazione JSON
{
  "deviceType": enum (DeviceType),
  "youtubeAndPartnersBidMultiplier": number
}
Campi
deviceType

enum (DeviceType)

obbligatorio. Il nome visualizzato del tipo di dispositivo.

youtubeAndPartnersBidMultiplier

number

Solo output. Il moltiplicatore di offerta consente di mostrare gli annunci più o meno spesso in base al tipo di dispositivo. Verrà applicato un moltiplicatore al prezzo di offerta originale. Se questo campo è pari a 0, significa che non è applicabile, anziché moltiplicare 0 per il prezzo dell'offerta originale.

Ad esempio, se il prezzo dell'offerta senza moltiplicatore è di 10 € e il moltiplicatore è 1,5 per i tablet, il prezzo dell'offerta risultante per i tablet sarà di 15 €.

Valido solo per gli elementi pubblicitari YouTube e partner.

AudienceGroupAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting del gruppo di pubblico assegnato. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_AUDIENCE_GROUP. La relazione tra ciascun gruppo è UNION, ad eccezione di excludedFirstAndthirdPartyAudienceGroup ed excludedGoogleAudienceGroup, di cui COMPLEMENT viene utilizzato come Mediazione con altri gruppi.

Rappresentazione JSON
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
Campi
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

Gli ID e le origini dei segmenti di pubblico proprietari e di terze parti dei gruppi di segmenti di pubblico proprietari e di terze parti inclusi. Ogni gruppo di segmenti di pubblico proprietario e di terze parti contiene solo ID segmenti di pubblico proprietari e di terze parti. La relazione tra ogni gruppo di pubblico proprietario e di terze parti è Mediazione e il risultato è UNION con altri gruppi di pubblico. I gruppi ripetuti con le stesse impostazioni verranno ignorati.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Gli ID segmenti di pubblico Google del gruppo di segmenti di pubblico Google incluso. Contiene solo gli ID segmenti di pubblico di Google.

includedCustomListGroup

object (CustomListGroup)

Gli ID elenco personalizzati del gruppo di elenchi personalizzato incluso. Contiene solo gli ID elenco personalizzati.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

Gli ID dei segmenti di pubblico combinati del gruppo di segmenti di pubblico combinato incluso. Contiene solo ID segmenti di pubblico combinati.

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Gli ID e le recency dei segmenti di pubblico proprietari e di terze parti del gruppo di segmenti di pubblico proprietario e di terze parti escluso. Utilizzato per il targeting per esclusione. Il COMPLEMENTAZIONE dell'UNIONE di questo gruppo e di altri gruppi di segmenti di pubblico esclusi viene utilizzato come incrocio per qualsiasi targeting per pubblico positivo. Tutti gli elementi sono logicamente "OR" l'uno dall'altro.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Gli ID dei segmenti di pubblico di Google del gruppo di pubblico di Google escluso. Utilizzato per il targeting per esclusione. Il COMPLEMENTAZIONE dell'UNIONE di questo gruppo e di altri gruppi di segmenti di pubblico esclusi viene utilizzato come incrocio per qualsiasi targeting per pubblico positivo. Contiene solo segmenti di pubblico Google di tipo Affinità, In-market e App installate. Tutti gli elementi sono logicamente "OR" l'uno dall'altro.

FirstAndThirdPartyAudienceGroup

Dettagli del gruppo di pubblico proprietario e di terze parti. Tutte le impostazioni di targeting per pubblico proprietario e di terze parti presentano logicamente "OR" l'una dell'altra.

Rappresentazione JSON
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
Campi
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

obbligatorio. Tutte le impostazioni di targeting per pubblico proprietari e di terze parti nel gruppo di segmenti di pubblico proprietari e di terze parti. Non sono consentite impostazioni ripetute con lo stesso ID.

FirstAndThirdPartyAudienceTargetingSetting

Dettagli dell'impostazione di targeting per pubblico proprietari e di terze parti.

Rappresentazione JSON
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
Campi
firstAndThirdPartyAudienceId

string (int64 format)

obbligatorio. ID segmento di pubblico proprietario e di terze parti dell'impostazione di targeting per pubblico proprietario e di terze parti. Questo ID è firstAndThirdPartyAudienceId.

recency

enum (Recency)

La recency dell'impostazione di targeting per pubblico proprietario e di terze parti. Applicabile solo ai segmenti di pubblico proprietari, altrimenti verranno ignorati. Per ulteriori informazioni, consulta la pagina https://support.google.com/displayvideo/answer/2949947#recency. Se non specificati, non verrà utilizzato alcun limite di recency.

Recency

Tutti i valori di recency dei segmenti di pubblico proprietari e di terze parti supportati.

Enum
RECENCY_NO_LIMIT Nessun limite di recency.
RECENCY_1_MINUTE La più recente è 1 minuto.
RECENCY_5_MINUTES La più recente è 5 minuti.
RECENCY_10_MINUTES La più recente è 10 minuti.
RECENCY_15_MINUTES La più recente è 15 minuti.
RECENCY_30_MINUTES La più recente è 30 minuti.
RECENCY_1_HOUR La data più recente è 1 ora.
RECENCY_2_HOURS La data più recente è di 2 ore.
RECENCY_3_HOURS L'attualità è di 3 ore.
RECENCY_6_HOURS L'attualità è di 6 ore.
RECENCY_12_HOURS La data più recente è 12 ore.
RECENCY_1_DAY La data più recente è 1 giorno.
RECENCY_2_DAYS La data più recente è 2 giorni.
RECENCY_3_DAYS La data più recente è 3 giorni.
RECENCY_5_DAYS La data più recente è di 5 giorni.
RECENCY_7_DAYS La data più recente è 7 giorni.
RECENCY_10_DAYS La data più recente è 10 giorni.
RECENCY_14_DAYS La data più recente è 14 giorni.
RECENCY_15_DAYS La data più recente è 15 giorni.
RECENCY_21_DAYS La data più recente è 21 giorni.
RECENCY_28_DAYS La data più recente è 28 giorni.
RECENCY_30_DAYS La data più recente è 30 giorni.
RECENCY_40_DAYS La data più recente è 40 giorni.
RECENCY_45_DAYS La data più recente è 45 giorni.
RECENCY_60_DAYS La data più recente è 60 giorni.
RECENCY_90_DAYS La data più recente è 90 giorni.
RECENCY_120_DAYS La data più recente è 120 giorni.
RECENCY_180_DAYS La data più recente è 180 giorni.
RECENCY_270_DAYS La data più recente è 270 giorni.
RECENCY_365_DAYS La data più recente è 365 giorni.

GoogleAudienceGroup

Dettagli del gruppo di pubblico di Google. Tutte le impostazioni di targeting per pubblico di Google sono logicamente "OR" l'una dell'altra.

Rappresentazione JSON
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Campi
settings[]

object (GoogleAudienceTargetingSetting)

obbligatorio. Tutte le impostazioni del targeting per pubblico Google nel gruppo di pubblico di Google. Le impostazioni ripetute con lo stesso ID verranno ignorate.

GoogleAudienceTargetingSetting

Dettagli dell'impostazione del targeting per pubblico di Google.

Rappresentazione JSON
{
  "googleAudienceId": string
}
Campi
googleAudienceId

string (int64 format)

obbligatorio. ID pubblico di Google dell'impostazione di targeting per pubblico di Google. Questo ID è googleAudienceId.

CustomListGroup

Dettagli del gruppo di elenchi personalizzati. Tutte le impostazioni di targeting dell'elenco personalizzato sono logicamente "OR" l'una dall'altra.

Rappresentazione JSON
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
Campi
settings[]

object (CustomListTargetingSetting)

obbligatorio. Tutte le impostazioni di targeting dell'elenco personalizzato nel gruppo di elenchi personalizzato. Le impostazioni ripetute con lo stesso ID verranno ignorate.

CustomListTargetingSetting

Dettagli dell'impostazione di targeting per elenco personalizzato.

Rappresentazione JSON
{
  "customListId": string
}
Campi
customListId

string (int64 format)

obbligatorio. ID personalizzato dell'impostazione di targeting per elenco personalizzato. Questo ID è customListId.

CombinedAudienceGroup

Dettagli del gruppo di pubblico combinato. Tutte le impostazioni di targeting per pubblico combinato sono logicamente "OR" l'una dall'altra.

Rappresentazione JSON
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Campi
settings[]

object (CombinedAudienceTargetingSetting)

obbligatorio. Tutte le impostazioni di targeting per pubblico combinato nel gruppo di segmenti di pubblico combinato. Le impostazioni ripetute con lo stesso ID verranno ignorate. Il numero di impostazioni del segmento di pubblico combinato non deve essere superiore a cinque, altrimenti verrà generato un errore.

CombinedAudienceTargetingSetting

Dettagli dell'impostazione del targeting per pubblico combinato.

Rappresentazione JSON
{
  "combinedAudienceId": string
}
Campi
combinedAudienceId

string (int64 format)

obbligatorio. ID pubblico combinato dell'impostazione di targeting per pubblico combinato. Questo ID è combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting del browser assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_BROWSER.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato del browser.

targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_BROWSER.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione. Tutte le opzioni di targeting del browser assegnate sulla stessa risorsa devono avere lo stesso valore per questo campo.

HouseholdIncomeAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per reddito del nucleo familiare assegnato. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_HOUSEHOLD_INCOME.

Rappresentazione JSON
{
  "householdIncome": enum (HouseholdIncome)
}
Campi
householdIncome

enum (HouseholdIncome)

obbligatorio. Il reddito del nucleo familiare del segmento di pubblico.

OnScreenPositionAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per posizione sullo schermo. Verrà inserito nel campo onScreenPositionDetails quando targetingType sarà TARGETING_TYPE_ON_SCREEN_POSITION.

Rappresentazione JSON
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
Campi
targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_ON_SCREEN_POSITION.

onScreenPosition

enum (OnScreenPosition)

Solo output. La posizione sullo schermo.

adType

enum (AdType)

Solo output. Il tipo di annuncio da scegliere come target. Applicabile solo al targeting dell'ordine di inserzione e i nuovi elementi pubblicitari che supportano il tipo di annuncio specificato erediteranno questa opzione di targeting per impostazione predefinita. I valori possibili sono:

  • AD_TYPE_DISPLAY, l'impostazione verrà ereditata dal nuovo elemento pubblicitario quando lineItemType sarà LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, l'impostazione verrà ereditata dal nuovo elemento pubblicitario quando lineItemType sarà LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per operatore e ISP assegnati. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_CARRIER_AND_ISP.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato dell'operatore o dell'ISP.

targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione. Tutte le opzioni di targeting per operatore e ISP assegnate sulla stessa risorsa devono avere lo stesso valore per questo campo.

KeywordAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per parole chiave assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_KEYWORD.

Rappresentazione JSON
{
  "keyword": string,
  "negative": boolean
}
Campi
keyword

string

obbligatorio. La parola chiave, ad esempio car insurance.

La parola chiave positiva non può essere una parola offensiva. Deve essere codificata in UTF-8 con una dimensione massima di 255 byte. Il numero massimo di caratteri è 80. Il numero massimo di parole è 10.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

NegativeKeywordListAssignedTargetingOptionDetails

Dettagli sul targeting per l'elenco di parole chiave escluse. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Rappresentazione JSON
{
  "negativeKeywordListId": string
}
Campi
negativeKeywordListId

string (int64 format)

obbligatorio. ID dell'elenco di parole chiave escluse. Deve fare riferimento al campo negativeKeywordListId di una risorsa NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting del sistema operativo assegnato. Verrà inserito nel campo operatingSystemDetails quando targetingType sarà TARGETING_TYPE_OPERATING_SYSTEM.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato del sistema operativo.

targetingOptionId

string

obbligatorio. L'ID opzione di targeting inserito nel campo targetingOptionId quando targetingType è TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

DeviceMakeModelAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per marca e modello del dispositivo assegnato. Verrà inserito nel campo deviceMakeModelDetails quando targetingType sarà TARGETING_TYPE_DEVICE_MAKE_MODEL.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato della marca e del modello del dispositivo.

targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

EnvironmentAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per ambiente assegnato. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_ENVIRONMENT.

Rappresentazione JSON
{
  "environment": enum (Environment)
}
Campi
environment

enum (Environment)

obbligatorio. L'ambiente di pubblicazione.

InventorySourceAssignedTargetingOptionDetails

Dettagli sul targeting per l'origine dell'inventario. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_INVENTORY_SOURCE.

Rappresentazione JSON
{
  "inventorySourceId": string
}
Campi
inventorySourceId

string (int64 format)

obbligatorio. ID dell'origine dell'inventario. Deve fare riferimento al campo inventorySourceId di una risorsa InventorySource.

CategoryAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per categoria assegnata. Verrà inserito nel campo categoryDetails quando targetingType sarà TARGETING_TYPE_CATEGORY.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato della categoria.

targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_CATEGORY.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

ViewabilityAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per visibilità assegnata. Verrà compilato nel campo viewabilityDetails di un AssignedTargetingOption quando targetingType è TARGETING_TYPE_VIEWABILITY.

Rappresentazione JSON
{
  "viewability": enum (Viewability)
}
Campi
viewability

enum (Viewability)

obbligatorio. La percentuale di visibilità prevista.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Rappresenta lo stato di venditore autorizzato assegnato. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Se a una risorsa non è stata assegnata un'opzione di targeting TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, utilizza l'opzione "Rivenditori e venditori diretti autorizzati".

Rappresentazione JSON
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus),
  "targetingOptionId": string
}
Campi
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Solo output. Lo stato di venditore autorizzato da scegliere come target.

targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per lingua assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_LANGUAGE.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato della lingua (ad es. "Francese").

targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_LANGUAGE.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione. Tutte le opzioni di targeting per lingua assegnate sulla stessa risorsa devono avere lo stesso valore per questo campo.

GeoRegionAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per area geografica assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_GEO_REGION.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "geoRegionType": enum (GeoRegionType),
  "negative": boolean
}
Campi
displayName

string

Solo output. Il nome visualizzato della regione geografica (ad es. "Ontario, Canada").

targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

Solo output. Il tipo di targeting per area geografica.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

InventorySourceGroupAssignedTargetingOptionDetails

Dettagli di targeting per il gruppo di origini dell'inventario. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

Rappresentazione JSON
{
  "inventorySourceGroupId": string
}
Campi
inventorySourceGroupId

string (int64 format)

obbligatorio. ID del gruppo di origini dell'inventario. Deve fare riferimento al campo inventorySourceGroupId di una risorsa InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Dettagli sul targeting per l'etichetta per contenuti digitali. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Rappresentazione JSON
{
  "excludedContentRatingTier": enum (ContentRatingTier)
}
Campi
excludedContentRatingTier

enum (ContentRatingTier)

obbligatorio. Il nome visualizzato del livello di classificazione delle etichette per contenuti digitali da ESCLUDERE.

SensitiveCategoryAssignedTargetingOptionDetails

Dettagli sul targeting per categoria sensibile. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Rappresentazione JSON
{
  "excludedSensitiveCategory": enum (SensitiveCategory)
}
Campi
excludedSensitiveCategory

enum (SensitiveCategory)

obbligatorio. Un'enumerazione per i contenuti della categoria sensibile DV360 classificati come ESCLUSI.

ExchangeAssignedTargetingOptionDetails

Dettagli relativi all'opzione di targeting della piattaforma di scambio assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_EXCHANGE.

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

enum (Exchange)

obbligatorio. Il valore enum per la piattaforma di scambio pubblicitario.

SubExchangeAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting della piattaforma di scambio pubblicitario secondaria assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_SUB_EXCHANGE.

Rappresentazione JSON
{
  "targetingOptionId": string
}
Campi
targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting dello strumento di verifica di terze parti assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_THIRD_PARTY_VERIFIER.

Rappresentazione JSON
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Campi
Campo di unione verifier. Può scegliere come target un verificatore di terze parti per applicare soglie di sicurezza del brand per le impressioni. verifier può essere solo uno dei seguenti:
adloox

object (Adloox)

Strumento di verifica del brand di terze parti - Adloox.

doubleVerify

object (DoubleVerify)

Strumento di verifica del brand di terze parti - DoubleVerify.

integralAdScience

object (IntegralAdScience)

Strumento di verifica del brand di terze parti: Integral Ad Science.

Adloox

Dettagli delle impostazioni di Adloox.

Rappresentazione JSON
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
Campi
excludedAdlooxCategories[]

enum (AdlooxCategory)

Impostazioni di sicurezza del brand di Adloox.

AdlooxCategory

Possibili opzioni di Adloox.

Enum
ADLOOX_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione Adloox.
ADULT_CONTENT_HARD Contenuti per adulti (non presenti).
ADULT_CONTENT_SOFT Contenuti per adulti (soft-core).
ILLEGAL_CONTENT Contenuti illegali.
BORDERLINE_CONTENT Contenuti che rappresentano casi limite.
DISCRIMINATORY_CONTENT Contenuti discriminatori.
VIOLENT_CONTENT_WEAPONS Armi e contenuti violenti.
LOW_VIEWABILITY_DOMAINS Domini a bassa visibilità.
FRAUD Attività fraudolenta.

DoubleVerify

Dettagli delle impostazioni di DoubleVerify.

Rappresentazione JSON
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
Campi
brandSafetyCategories

object (BrandSafetyCategories)

Controlli di sicurezza del brand DV.

avoidedAgeRatings[]

enum (AgeRating)

Evita di fare offerte per app con classificazione per età.

appStarRating

object (AppStarRating)

Evita di fare offerte per app con valutazioni a stelle.

displayViewability

object (DisplayViewability)

Impostazioni di visibilità display (applicabili solo agli elementi pubblicitari display).

videoViewability

object (VideoViewability)

Impostazioni di visibilità video (applicabili solo agli elementi pubblicitari video).

fraudInvalidTraffic

object (FraudInvalidTraffic)

Evita i siti e le app con tassi storici di attività fraudolenta e traffico non valido.

customSegmentId

string (int64 format)

L'ID segmento personalizzato fornito da DoubleVerify. L'ID deve iniziare con "51" ed essere composto da otto cifre. L'ID segmento personalizzato non può essere specificato insieme a nessuno dei seguenti campi:

BrandSafetyCategories

Impostazioni per i controlli di sicurezza del brand.

Rappresentazione JSON
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
Campi
avoidUnknownBrandSafetyCategory

boolean

Sconosciuto o non valutabili.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Categorie di sicurezza ad alta gravità per la sicurezza del brand.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Categorie di evitamento con gravità media di sicurezza del brand.

HighSeverityCategory

Possibili opzioni per le categorie con gravità alta.

Enum
HIGHER_SEVERITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica categorie con gravità alta.
ADULT_CONTENT_PORNOGRAPHY Contenuti per adulti: pornografia, argomenti inappropriati per i minori e nudità.
COPYRIGHT_INFRINGEMENT Violazione del copyright.
SUBSTANCE_ABUSE Droghe/alcol/sostanze controllate: abuso di sostanze stupefacenti.
GRAPHIC_VIOLENCE_WEAPONS Violenza estrema/violenza esplicita/armi.
HATE_PROFANITY Odio o linguaggio volgare.
CRIMINAL_SKILLS Attività illegali: abilità criminali.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incentivato/malware/disordine.

MediumSeverityCategory

Possibili opzioni per le categorie con gravità media.

Enum
MEDIUM_SEVERITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica categorie con gravità media.
AD_SERVERS ad server.
ADULT_CONTENT_SWIMSUIT Contenuti per adulti: costumi da bagno.
ALTERNATIVE_LIFESTYLES Temi controversi: stili di vita alternativi.
CELEBRITY_GOSSIP Temi controversi: gossip sulle celebrità.
GAMBLING Temi controversi: giochi e scommesse.
OCCULT Temi controversi: occulto.
SEX_EDUCATION Temi controversi: educazione sessuale.
DISASTER_AVIATION Catastrofe: aviazione.
DISASTER_MAN_MADE Calamità: causata dall'uomo.
DISASTER_NATURAL Catastrofi: naturale.
DISASTER_TERRORIST_EVENTS Catastrofi: eventi terroristici.
DISASTER_VEHICLE Catastrofe: veicolo.
ALCOHOL Droghe/alcol/sostanze controllate: alcol.
SMOKING Droghe/alcol/sostanze controllate: fumo.
NEGATIVE_NEWS_FINANCIAL Notizie negative: finanziarie.
NON_ENGLISH Contenuti non standard: non in inglese.
PARKING_PAGE Contenuti non standard: pagina di parcheggio.
UNMODERATED_UGC Contenuti generati dagli utenti non moderati: forum, immagini e video.
INFLAMMATORY_POLITICS_AND_NEWS Temi controversi: politica e notizie provocatorie.
NEGATIVE_NEWS_PHARMACEUTICAL Notizie negative: farmaceutica.

AgeRating

Possibili opzioni per le classificazioni in base alla fascia d'età.

Enum
AGE_RATING_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di valutazione per età.
APP_AGE_RATE_UNKNOWN App con classificazione per età sconosciuta.
APP_AGE_RATE_4_PLUS App classificate per tutti (4+).
APP_AGE_RATE_9_PLUS App classificate per tutti (9+).
APP_AGE_RATE_12_PLUS App classificate per adolescenti (12+).
APP_AGE_RATE_17_PLUS App classificate per adulti (dai 17 anni in su).
APP_AGE_RATE_18_PLUS App classificate solo per adulti (dai 18 anni in su).

AppStarRating

Dettagli delle impostazioni della valutazione a stelle di DoubleVerify.

Rappresentazione JSON
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
Campi
avoidedStarRating

enum (StarRating)

Evita di fare offerte per app con valutazioni a stelle.

avoidInsufficientStarRating

boolean

Evita di fare offerte per app con valutazioni a stelle insufficienti.

StarRating

Possibili opzioni per le valutazioni a stelle.

Enum
APP_STAR_RATE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione di valutazione a stelle dell'app.
APP_STAR_RATE_1_POINT_5_LESS App ufficiali con valutazione < 1,5 stelle.
APP_STAR_RATE_2_LESS App ufficiali con valutazione < 2 stelle.
APP_STAR_RATE_2_POINT_5_LESS App ufficiali con valutazione < 2,5 stelle.
APP_STAR_RATE_3_LESS App ufficiali con valutazione < 3 stelle.
APP_STAR_RATE_3_POINT_5_LESS App ufficiali con valutazione < 3,5 stelle.
APP_STAR_RATE_4_LESS App ufficiali con valutazione < 4 stelle.
APP_STAR_RATE_4_POINT_5_LESS App ufficiali con valutazione < 4,5 stelle.

DisplayViewability

Dettagli delle impostazioni di visibilità di DoubleVerify.

Rappresentazione JSON
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
Campi
iab

enum (IAB)

Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB.

viewableDuring

enum (ViewableDuring)

Scegli come target l'inventario web e per app per massimizzare il 100% della durata della visibilità.

IAB

Possibili opzioni per il tasso di visibilità IAB.

Enum
IAB_VIEWED_RATE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione di tariffa visualizzata da IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore all'80%.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 75%.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 70%.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 65%.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 60%.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 55%.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 50%.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 40%.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 30%.

ViewableDuring

Possibili opzioni per la durata di visibilità.

Enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni relative alla durata di visualizzazione media.
AVERAGE_VIEW_DURATION_5_SEC Scegli come target l'inventario web e per app per massimizzare il 100% della durata di visibilità di almeno 5 secondi.
AVERAGE_VIEW_DURATION_10_SEC Scegli come target l'inventario web e per app per massimizzare il 100% della durata di visibilità per almeno 10 secondi.
AVERAGE_VIEW_DURATION_15_SEC Scegli come target l'inventario web e per app per massimizzare il 100% della durata di visibilità per almeno 15 secondi.

VideoViewability

Dettagli delle impostazioni di visibilità dei video di DoubleVerify.

Rappresentazione JSON
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
Campi
videoIab

enum (VideoIAB)

Scegli come target l'inventario web per massimizzare il tasso di visibilità IAB.

videoViewableRate

enum (VideoViewableRate)

Scegli come target l'inventario web per massimizzare il tasso di visibilità completa.

playerImpressionRate

enum (PlayerImpressionRate)

Scegli come target l'inventario per massimizzare le impressioni con dimensioni del player pari o superiori a 400 x 300.

VideoIAB

Possibili opzioni del tasso di visibilità IAB.

Enum
VIDEO_IAB_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione per il tasso di visibilità IAB video.
IAB_VIEWABILITY_80_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore all'80%.
IAB_VIEWABILITY_75_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 75%.
IAB_VIEWABILITY_70_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 70%.
IAB_VIEWABILITY_65_PERCENT_HIHGER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 65%.
IAB_VIEWABILITY_60_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 60%.
IAB_VIEWABILITY_55_PERCENT_HIHGER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 55%.
IAB_VIEWABILITY_50_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 50%.
IAB_VIEWABILITY_40_PERCENT_HIHGER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 40%.
IAB_VIEWABILITY_30_PERCENT_HIHGER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB pari o superiore al 30%.

VideoViewableRate

Possibili opzioni per il tasso di visibilità completa.

Enum
VIDEO_VIEWABLE_RATE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni per il tasso di visibilità video.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare un tasso di visibilità completa pari o superiore al 40%.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare un tasso di visibilità completa pari o superiore al 35%.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare un tasso di visibilità completa pari o superiore al 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare un tasso di visibilità completa pari o superiore al 25%.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare un tasso di visibilità completa pari o superiore al 20%.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare un tasso di visibilità completa pari o superiore al 10%.

PlayerImpressionRate

Possibili opzioni di impressioni.

Enum
PLAYER_SIZE_400X300_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di impressione.
PLAYER_SIZE_400X300_95 Siti con più del 95%di impressioni.
PLAYER_SIZE_400X300_70 Siti con più del 70%di impressioni.
PLAYER_SIZE_400X300_25 Siti con più del 25%di impressioni.
PLAYER_SIZE_400X300_5 Siti con più del 5%di impressioni.

FraudInvalidTraffic

Impostazioni fraudolente e traffico non valido di DoubleVerify.

Rappresentazione JSON
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
Campi
avoidedFraudOption

enum (FraudOption)

Evita siti e app con dati storici su attività fraudolenta e traffico non valido.

avoidInsufficientOption

boolean

Statistiche storiche su attività fraudolenta e traffico non valido insufficienti.

FraudOption

Possibili opzioni del tasso storico di attività fraudolenta e traffico non valido.

Enum
FRAUD_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di attività fraudolenta o traffico non valido.
AD_IMPRESSION_FRAUD_100 100% di attività fraudolenta e traffico non valido.
AD_IMPRESSION_FRAUD_50 Attività fraudolenta e traffico non valido pari o superiori al 50%.
AD_IMPRESSION_FRAUD_25 Attività fraudolenta e traffico non valido pari o superiori al 25%.
AD_IMPRESSION_FRAUD_10 Attività fraudolenta e traffico non valido pari o superiori al 10%.
AD_IMPRESSION_FRAUD_8 Attività fraudolenta e traffico non valido pari o superiore all'8%.
AD_IMPRESSION_FRAUD_6 Attività fraudolenta e traffico non valido pari o superiori al 6%.
AD_IMPRESSION_FRAUD_4 Attività fraudolenta e traffico non valido pari o superiori al 4%.
AD_IMPRESSION_FRAUD_2 Attività fraudolenta e traffico non valido pari o superiore al 2%.

IntegralAdScience

Dettagli delle impostazioni di Integral Ad Science.

Rappresentazione JSON
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
Campi
traqScoreOption

enum (TRAQScore)

Qualità pubblicitaria reale (applicabile solo agli elementi pubblicitari display).

excludeUnrateable

boolean

Sicurezza del brand - Non valutabile.

excludedAdultRisk

enum (Adult)

Sicurezza del brand - Contenuti per adulti.

excludedAlcoholRisk

enum (Alcohol)

Sicurezza del brand - Alcolici.

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Sicurezza del brand - Download illegali.

excludedDrugsRisk

enum (Drugs)

Sicurezza del brand - Droghe.

excludedHateSpeechRisk

enum (HateSpeech)

Sicurezza del brand - Incitamento all'odio.

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Sicurezza del brand - Linguaggio offensivo.

excludedViolenceRisk

enum (Violence)

Sicurezza del brand - Violenza.

excludedGamblingRisk

enum (Gambling)

Sicurezza del brand - Giochi e scommesse.

excludedAdFraudRisk

enum (AdFraudPrevention)

Impostazioni della frode pubblicitaria.

displayViewability

enum (DisplayViewability)

Sezione Visibilità display (applicabile solo agli elementi pubblicitari display).

videoViewability

enum (VideoViewability)

Sezione Visibilità video (applicabile solo agli elementi pubblicitari video).

customSegmentId[]

string (int64 format)

L'ID del segmento personalizzato fornito da Integral Ad Science. L'ID deve essere compreso tra 1000001 e 1999999 inclusi.

TRAQScore

Possibili intervalli di punteggi TRAQ (True Advertising Quality) di Integral Ad Science.

Enum
TRAQ_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcun punteggio di qualità della pubblicità reale.
TRAQ_250 Punteggio TRAQ: 250-1000.
TRAQ_500 Punteggio TRAQ: 500-1000.
TRAQ_600 Punteggio TRAQ: 600-1000.
TRAQ_700 Punteggio TRAQ: 700-1000.
TRAQ_750 Punteggio TRAQ: 750-1000.
TRAQ_875 Punteggio TRAQ 875-1000.
TRAQ_1000 Punteggio TRAQ 1000.

Adulto

Possibili opzioni per adulti di Integral Ad Science.

Enum
ADULT_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni per adulti.
ADULT_HR Adulto - Escludi ad alto rischio.
ADULT_HMR Adulto - Escludi ad alto rischio e a rischio moderato.

Alcolici

Possibili opzioni di alcolici di Integral Ad Science.

Enum
ALCOHOL_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di alcolici.
ALCOHOL_HR Alcol - Escludi ad alto rischio.
ALCOHOL_HMR Alcol - Escludi ad alto rischio e a rischio moderato.

IllegalDownloads

Possibile opzione di download illegali di Integral Ad Science.

Enum
ILLEGAL_DOWNLOADS_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di download illegali.
ILLEGAL_DOWNLOADS_HR Download illegali - Escludi ad alto rischio.
ILLEGAL_DOWNLOADS_HMR Download illegali - Escludi ad alto rischio e a rischio moderato.

Droghe

Possibili opzioni di Integral Ad Science Drugs.

Enum
DRUGS_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni per i farmaci.
DRUGS_HR Droghe - Escludi ad alto rischio.
DRUGS_HMR Droghe - Escludi ad alto rischio e a rischio moderato.

HateSpeech

Possibili opzioni di incitamento all'odio di Integral Ad Science.

Enum
HATE_SPEECH_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni per l'incitamento all'odio.
HATE_SPEECH_HR Incitamento all'odio - Escludi ad alto rischio.
HATE_SPEECH_HMR Incitamento all'odio - Escludi ad alto rischio e a rischio moderato.

OffensiveLanguage

Possibile opzione di linguaggio offensivo di Integral Ad Science.

Enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di lingua.
OFFENSIVE_LANGUAGE_HR Linguaggio offensivo - Escludi ad alto rischio.
OFFENSIVE_LANGUAGE_HMR Linguaggio offensivo - Escludi ad alto rischio e a rischio moderato.

Violenza

Opzioni di possibile violenza di Integral Ad Science.

Enum
VIOLENCE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni relative alla violenza.
VIOLENCE_HR Violenza - Escludi ad alto rischio.
VIOLENCE_HMR Violenza - Escludi ad alto rischio e a rischio moderato.

Giochi e scommesse

Possibili opzioni per giochi e scommesse di Integral Ad Science.

Enum
GAMBLING_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di giochi e scommesse.
GAMBLING_HR Giochi e scommesse - Escludi giochi e scommesse ad alto rischio.
GAMBLING_HMR Giochi e scommesse - Escludi ad alto rischio e a rischio moderato.

AdFraudPrevention

Possibili opzioni di prevenzione delle frodi pubblicitarie di Integral Ad Science.

Enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di prevenzione di frodi pubblicitarie.
SUSPICIOUS_ACTIVITY_HR Frode pubblicitaria - Escludi ad alto rischio.
SUSPICIOUS_ACTIVITY_HMR Frode pubblicitaria - Escludi ad alto rischio e a rischio moderato.

DisplayViewability

Possibili opzioni di visibilità di Integral Ad Science Display.

Enum
PERFORMANCE_VIEWABILITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di visibilità display.
PERFORMANCE_VIEWABILITY_40 Scegli come target il 40% della visibilità o una percentuale superiore.
PERFORMANCE_VIEWABILITY_50 Scegli come target il 50% della visibilità o una percentuale superiore.
PERFORMANCE_VIEWABILITY_60 Scegli come target il 60% della visibilità o una percentuale superiore.
PERFORMANCE_VIEWABILITY_70 Scegli come target il 70% della visibilità o una percentuale superiore.

VideoViewability

Possibili opzioni di visibilità di Integral Ad Science Video.

Enum
VIDEO_VIEWABILITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di visibilità video.
VIDEO_VIEWABILITY_40 Più del 40%visualizzato (standard IAB di visibilità video).
VIDEO_VIEWABILITY_50 Più del 50%visualizzato (standard IAB di visibilità video).
VIDEO_VIEWABILITY_60 Più del 60%visualizzato (standard IAB di visibilità video).
VIDEO_VIEWABILITY_70 Più del 70%visualizzato (standard IAB di visibilità video).

PoiAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per PDI assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_POI.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Campi
displayName

string

Solo output. Il nome visualizzato di un PDI, ad esempio "Times Square", "Space Needle", seguito dall'indirizzo completo, se disponibile.

targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_POI.

Gli ID delle opzioni di targeting per PDI accettati possono essere recuperati utilizzando targetingTypes.targetingOptions.search.

Se scegli come target una coordinata di latitudine/longitudine specifica rimossa dal nome di un indirizzo o di un PDI, puoi generare l'ID dell'opzione di targeting necessario arrotondando i valori delle coordinate desiderati alla sesta posizione decimale, rimuovendo i numeri decimali e concatenando i valori di stringa separati da un punto e virgola. Ad esempio, puoi scegliere come target la coppia latitudine/longitudine di 40.7414691, -74.003387 utilizzando l'ID opzione di targeting "40741469;-74003387". Al momento della creazione, questo valore di campo verrà aggiornato per aggiungere un punto e virgola e un valore hash alfanumerico se vengono fornite solo le coordinate di latitudine/longitudine .

latitude

number

Solo output. Latitudine del PDI che viene arrotondata alla sesta posizione decimale.

longitude

number

Solo output. Longitudine del PDI che viene arrotondata alla sesta posizione decimale.

proximityRadiusAmount

number

obbligatorio. Il raggio dell'area attorno al PDI che verrà scelto come target. Le unità del raggio sono specificate da proximityRadiusUnit. Deve essere compreso tra 1 e 800 se l'unità è DISTANCE_UNIT_KILOMETERS e tra 1 e 500 se l'unità è DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

obbligatorio. L'unità di distanza con cui viene misurato il raggio di targeting.

DistanceUnit

Possibili opzioni di unità di misura.

Enum
DISTANCE_UNIT_UNSPECIFIED Il valore del tipo non è specificato o è sconosciuto in questa versione.
DISTANCE_UNIT_MILES Miglia.
DISTANCE_UNIT_KILOMETERS Chilometri.

BusinessChainAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting per catena aziendale assegnata. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_BUSINESS_CHAIN.

Rappresentazione JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Campi
displayName

string

Solo output. Il nome visualizzato di una catena commerciale, ad esempio "KFC", "Chase Bank".

targetingOptionId

string

obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_BUSINESS_CHAIN.

Gli ID delle opzioni di targeting della catena commerciale accettate possono essere recuperati utilizzando SearchTargetingOptions.

proximityRadiusAmount

number

obbligatorio. Il raggio dell'area attorno alla catena commerciale che verrà scelta come target. Le unità del raggio sono specificate da proximityRadiusUnit. Deve essere compreso tra 1 e 800 se l'unità è DISTANCE_UNIT_KILOMETERS e tra 1 e 500 se l'unità è DISTANCE_UNIT_MILES. L'incremento minimo per entrambi i casi è 0,1. Se è troppo granulare, gli input verranno arrotondati al valore accettabile più vicino, ad esempio 15,57 diventerà 15,6.

proximityRadiusUnit

enum (DistanceUnit)

obbligatorio. L'unità di distanza con cui viene misurato il raggio di targeting.

ContentDurationAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting assegnata alla durata dei contenuti. Verrà inserito nel campo contentDurationDetails quando targetingType sarà TARGETING_TYPE_CONTENT_DURATION. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto, rimuovi tutte le opzioni di targeting per durata dei contenuti.

Rappresentazione JSON
{
  "targetingOptionId": string,
  "contentDuration": enum (ContentDuration)
}
Campi
targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_CONTENT_DURATION.

contentDuration

enum (ContentDuration)

Solo output. La durata dei contenuti.

ContentStreamTypeAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata al tipo di stream di contenuti. Verrà inserito nel campo contentStreamTypeDetails quando targetingType sarà TARGETING_TYPE_CONTENT_STREAM_TYPE. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto, rimuovi tutte le opzioni di targeting per tipo di stream di contenuti.

Rappresentazione JSON
{
  "targetingOptionId": string,
  "contentStreamType": enum (ContentStreamType)
}
Campi
targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_CONTENT_STREAM_TYPE.

contentStreamType

enum (ContentStreamType)

Solo output. Il tipo di stream di contenuti.

NativeContentPositionAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata alla posizione dei contenuti nativi. Verrà inserito nel campo nativeContentPositionDetails quando targetingType sarà TARGETING_TYPE_NATIVE_CONTENT_POSITION. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto, rimuovi tutte le opzioni di targeting per posizioni di contenuti nativi.

Rappresentazione JSON
{
  "contentPosition": enum (NativeContentPosition)
}
Campi
contentPosition

enum (NativeContentPosition)

obbligatorio. La posizione dei contenuti.

OmidAssignedTargetingOptionDetails

Rappresenta un tipo di inventario abilitato per il targeting di Open Measurement. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_OMID.

Rappresentazione JSON
{
  "omid": enum (Omid)
}
Campi
omid

enum (Omid)

obbligatorio. Il tipo di inventario abilitato per Open Measurement.

AudioContentTypeAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata al tipo di contenuti audio. Verrà inserito nel campo audioContentTypeDetails quando targetingType sarà TARGETING_TYPE_AUDIO_CONTENT_TYPE. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto, rimuovi tutte le opzioni di targeting per tipo di contenuto audio.

Rappresentazione JSON
{
  "audioContentType": enum (AudioContentType)
}
Campi
audioContentType

enum (AudioContentType)

obbligatorio. Il tipo di contenuti audio.

ContentGenreAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata per genere di contenuti. Verrà inserito nel campo contentGenreDetails quando targetingType sarà TARGETING_TYPE_CONTENT_GENRE. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto, rimuovi tutte le opzioni di targeting per genere di contenuti.

Rappresentazione JSON
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
Campi
targetingOptionId

string

obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_CONTENT_GENRE.

displayName

string

Solo output. Il nome visualizzato del genere di contenuti.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

YoutubeVideoAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata al video di YouTube. Verrà inserito nel campo youtubeVideoDetails quando targetingType sarà TARGETING_TYPE_YOUTUBE_VIDEO.

Rappresentazione JSON
{
  "videoId": string,
  "negative": boolean
}
Campi
videoId

string

ID video di YouTube così come appare sulla pagina di visualizzazione di YouTube.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

YoutubeChannelAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata al canale YouTube. Verrà inserito nel campo youtubeChannelDetails quando targetingType sarà TARGETING_TYPE_YOUTUBE_CHANNEL.

Rappresentazione JSON
{
  "channelId": string,
  "negative": boolean
}
Campi
channelId

string

L'ID del canale del caricamento di YouTube o il codice del canale di un canale YouTube.

negative

boolean

Indica se questa opzione è stata scelta come target per esclusione.

SessionPositionAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting assegnata alla posizione della sessione. Verrà inserito nel campo sessionPositionDetails quando targetingType sarà TARGETING_TYPE_SESSION_POSITION.

Rappresentazione JSON
{
  "sessionPosition": enum (SessionPosition)
}
Campi
sessionPosition

enum (SessionPosition)

La posizione in cui verrà visualizzato l'annuncio in una sessione.

SessionPosition

Possibili posizioni in una sessione.

Enum
SESSION_POSITION_UNSPECIFIED Si tratta di un segnaposto e non indica alcuna posizione.
SESSION_POSITION_FIRST_IMPRESSION La prima impressione della sessione.

Metodi

get

Viene assegnata una singola opzione di targeting a una campagna.

list

Elenca le opzioni di targeting assegnate a una campagna per un tipo di targeting specificato.