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,
  "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)
  }
  // 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 risorsa e di un tipo di targeting specifici. Potrebbe essere riutilizzato in altri contesti.

targetingType

enum (TargetingType)

Solo output. Identifica il tipo di questa 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. Può essere compilato un solo campo di dettagli, che deve corrispondere a targeting_type; details può essere solo uno dei seguenti:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Dettagli del canale. Questo campo verrà completato quando targetingType è TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Dettagli sulla categoria di app. Questo campo verrà completato quando targetingType è TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Dettagli sull'app. Questo campo verrà completato quando targetingType è TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Dettagli URL. Questo campo verrà completato quando targetingType è TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Dettagli su giorno e ora. Questo campo verrà completato quando targetingType è TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Dettagli sulla fascia d'età. Questo campo verrà completato quando targetingType è TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Dettagli dell'elenco di località regionali. Questo campo verrà completato quando targetingType è TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Dettagli dell'elenco delle località di prossimità. Questo campo verrà completato quando targetingType è TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Dettagli sul genere. Questo campo verrà completato quando targetingType è TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Dettagli sulle dimensioni del video player. Questo campo verrà completato quando targetingType è TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Dettagli dei contenuti con premio per l'utente. Questo campo verrà completato quando targetingType è TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Dettagli sullo stato parentale. Questo campo verrà completato quando targetingType è TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione outstream dei contenuti. Questo campo verrà completato quando targetingType è TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Dettagli sul tipo di dispositivo. Questo campo verrà completato quando targetingType è TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Dettagli sul targeting per pubblico. Questo campo verrà completato quando targetingType è 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à completato quando targetingType è TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Dettagli sul reddito del nucleo familiare. Questo campo verrà completato quando targetingType è TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione sullo schermo. Questo campo verrà completato quando targetingType è TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Dettagli operatore e ISP. Questo campo verrà completato quando targetingType è TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Dettagli parola chiave. Questo campo verrà completato quando targetingType è TARGETING_TYPE_KEYWORD.

A una risorsa possono essere assegnate 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à completato quando targetingType è TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

A una risorsa è possibile assegnare un massimo di 4 elenchi di parole chiave escluse.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Dettagli del sistema operativo. Questo campo verrà completato quando targetingType è TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Dettagli su marca e modello del dispositivo. Questo campo verrà completato quando targetingType è TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Dettagli dell'ambiente. Questo campo verrà completato quando targetingType è TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Dettagli dell'origine dell'inventario. Questo campo verrà completato quando targetingType è TARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Dettagli della categoria. Questo campo verrà completato quando targetingType è TARGETING_TYPE_CATEGORY.

Come target di una categoria, verranno scelte come target anche le relative categorie secondarie. Se una categoria è esclusa dal targeting ed è inclusa una sottocategoria, l'esclusione avrà la precedenza.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Dettagli sulla visibilità. Questo campo verrà completato quando targetingType è 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à completato quando targetingType è TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

Se una risorsa non dispone di un'opzione per lo 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 lingua. Questo campo verrà completato quando targetingType è TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Dettagli della regione geografica. Questo campo verrà completato quando targetingType è TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Dettagli sulle etichette contenuti digitali. Questo campo verrà completato quando targetingType è 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 etichette contenuti oltre alle esclusioni degli inserzionisti, ma non possono sostituirle. Se tutte le etichette contenuti digitali sono escluse, un elemento pubblicitario non viene pubblicato.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Dettagli delle categorie sensibili. Questo campo verrà completato quando targetingType è TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Le categorie sensibili sono esclusioni di targeting. 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 piattaforma di scambio pubblicitario. Questo campo verrà completato quando targetingType è TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Dettagli della piattaforma di scambio pubblicitario secondaria. Questo campo verrà completato quando targetingType è TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Dettagli sulla verifica di terze parti. Questo campo verrà completato quando targetingType è TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Dettagli PDI. Questo campo verrà completato quando targetingType è TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Dettagli della catena commerciale. Questo campo verrà completato quando targetingType è TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Dettagli sulla durata dei contenuti. Questo campo verrà completato quando targetingType è 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à completato quando targetingType è TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Dettagli sul tipo di contenuti audio. Questo campo verrà completato quando targetingType è TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Dettagli sul genere dei contenuti. Questo campo verrà completato quando targetingType è TARGETING_TYPE_CONTENT_GENRE.

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 rispetto al targeting assegnato al livello corrente e non possono essere modificate tramite il servizio entità attuale. Devono essere modificati tramite il servizio entità da cui vengono ereditati. L'ereditarietà si applica solo ai canali con targeting per esclusione, alle esclusioni di categorie sensibili ed a quelle etichette contenuti digitali se sono configurate a 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 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 dell'opzione di targeting per categoria di app assegnata. Verrà compilato nel campo appCategoryDetails di un valore 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 relativi all'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 l'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, la piattaforma dell'app viene considerata mobile (ad esempio Android o iOS) e ricavare la piattaforma mobile appropriata dall'ID app.

AppPlatform

Possibili opzioni di targeting per piattaforma di app.

Enum
APP_PLATFORM_UNSPECIFIED Valore predefinito quando la piattaforma dell'app non è specificata in questa versione. Questa enum è un segnaposto per il valore predefinito e non rappresenta un'opzione di piattaforma reale.
APP_PLATFORM_IOS La piattaforma dell'app è iOS.
APP_PLATFORM_ANDROID La piattaforma dell'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 La piattaforma dell'app è una piattaforma per TV connesse a internet (CTV) che non è esplicitamente elencata altrove.

UrlAssignedTargetingOptionDetails

Dettagli dell'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 l'impostazione del 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 risolvere il fuso orario.

Enum
TIME_ZONE_RESOLUTION_UNSPECIFIED La risoluzione del fuso orario non è specifica 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à che è possibile scegliere come target. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

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

Output solo in v1. Obbligatorio nella versione v2.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_AGE_RANGE.

RegionalLocationListAssignedTargetingOptionDetails

Dettagli sul 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 delle località a livello di regione. Deve fare riferimento al campo locationListId di una risorsa LocationList di 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,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
Campi
proximityLocationListId

string (int64 format)

Obbligatorio. ID dell'elenco delle località di prossimità. Deve fare riferimento al campo locationListId di una risorsa LocationList di tipo TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadiusRange

enum (ProximityRadiusRange)

Obbligatorio. Intervallo di raggio per l'elenco delle località di prossimità. Rappresenta le dimensioni dell'area intorno a una località scelta come target.

Il targeting per località di prossimità All in una singola risorsa deve avere lo stesso valore di intervallo di raggio. Imposta questo valore in modo che corrisponda a qualsiasi targeting esistente. Se viene aggiornato, questo campo modificherà l'intervallo di raggio per tutto il targeting di prossimità all'interno della risorsa.

ProximityRadiusRange

Tipo di un intervallo di raggio per le opzioni assegnate con tipo geografico di prossimità. L'intervallo del raggio è relativo alla densità di popolazione. Ad esempio, PROXIMITY_RADIUS_RANGE_SMALL in un'area rurale sarà diverso da PROXIMITY_RADIUS_RANGE_SMALL in una città densamente popolata.

Enum
PROXIMITY_RADIUS_RANGE_UNSPECIFIED L'intervallo di raggi target non è specificato o è sconosciuto. Valore predefinito quando l'intervallo del raggio non è specificato in questa versione. Questa enum è un segnaposto per il valore predefinito e non rappresenta un'opzione di intervallo di raggio reale.
PROXIMITY_RADIUS_RANGE_SMALL L'intervallo del raggio target è ridotto.
PROXIMITY_RADIUS_RANGE_MEDIUM L'intervallo di raggio target è medio.
PROXIMITY_RADIUS_RANGE_LARGE L'intervallo di raggio target è ampio.

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),
  "targetingOptionId": string
}
Campi
gender

enum (Gender)

Il genere del pubblico.

Output solo in v1. Obbligatorio nella versione v2.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_GENDER.

VideoPlayerSizeAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per dimensione del video player. Verrà compilato nel campo videoPlayerSizeDetails quando targetingType è 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
{
  "targetingOptionId": string,
  "videoPlayerSize": enum (VideoPlayerSize)
}
Campi
targetingOptionId

string

Obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_VIDEO_PLAYER_SIZE.

videoPlayerSize

enum (VideoPlayerSize)

Le dimensioni del video player.

Output solo in v1. Obbligatorio nella versione v2.

UserRewardedContentAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting dei contenuti con premio per l'utente. Verrà compilato nel campo userRewardedContentDetails quando targetingType è 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 per l'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),
  "targetingOptionId": string
}
Campi
parentalStatus

enum (ParentalStatus)

Lo stato parentale del segmento di pubblico.

Output solo in v1. Obbligatorio nella versione v2.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_PARENTAL_STATUS.

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

string

Obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentInstreamPosition

enum (ContentInstreamPosition)

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

Output solo in v1. Obbligatorio nella versione v2.

adType

enum (AdType)

Solo output. Il tipo di annuncio target. L'opzione di targeting è applicabile solo al targeting per 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 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 i contenuti audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per posizione outstream dei contenuti assegnata. Verrà compilato nel campo contentOutstreamPositionDetails quando targetingType è TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

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

string

Obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

contentOutstreamPosition

enum (ContentOutstreamPosition)

La posizione outstream dei contenuti.

Output solo in v1. Obbligatorio nella versione v2.

adType

enum (AdType)

Solo output. Il tipo di annuncio target. L'opzione di targeting è applicabile solo al targeting per 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
{
  "targetingOptionId": string,
  "deviceType": enum (DeviceType)
}
Campi
targetingOptionId

string

Obbligatorio. ID del tipo di dispositivo.

deviceType

enum (DeviceType)

Il nome visualizzato del tipo di dispositivo.

Output solo in v1. Obbligatorio nella versione v2.

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 excludedFirstAnd ThirdPartyAudienceGroup ed excludedGoogleAudienceGroup, di cui COMPLEMENT viene utilizzato come incrocio 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 recency 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 di prima parte e quello di terze parti è incrocio e il risultato è UNION abbinato ad 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 pubblico Google incluso. Contiene solo gli ID dei segmenti di pubblico di Google.

includedCustomListGroup

object (CustomListGroup)

Gli ID degli elenchi personalizzati del gruppo di elenchi personalizzati 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 COMPLEMENTO dell'UNIONE di questo gruppo e di altri gruppi di pubblico esclusi viene utilizzato come punto di incontro per qualsiasi targeting per pubblico positivo. Tutti gli elementi sono logicamente "OR" l'uno dall'altro.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Gli ID segmenti di pubblico Google del gruppo di segmenti di pubblico Google escluso. Utilizzato per il targeting per esclusione. Il COMPLEMENTO dell'UNIONE di questo gruppo e di altri gruppi di pubblico esclusi viene utilizzato come punto di incontro per qualsiasi targeting per pubblico positivo. Contiene solo segmenti di pubblico di 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 sono logicamente "OR" l'una dall'altra.

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

object (FirstAndThirdPartyAudienceTargetingSetting)

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

FirstAndThirdPartyAudienceTargetingSetting

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

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

string (int64 format)

Obbligatorio. ID 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 del pubblico proprietario e di terze parti supportati.

Enum
RECENCY_NO_LIMIT Nessun limite di recency.
RECENCY_1_MINUTE La data 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 La data più recente è di 3 ore.
RECENCY_6_HOURS La più recente è 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 più recente è 3 giorni.
RECENCY_5_DAYS La più recente è 5 giorni.
RECENCY_7_DAYS La 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 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 Google. Tutte le impostazioni di targeting per pubblico di Google sono logicamente "OR" l'una dall'altra.

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

object (GoogleAudienceTargetingSetting)

Obbligatorio. Tutte le impostazioni del targeting per pubblico Google nel gruppo di pubblico 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 del targeting per pubblico Google. Questo ID è googleAudienceId.

CustomListGroup

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

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

object (CustomListTargetingSetting)

Obbligatorio. Tutte le impostazioni di targeting per 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 pubblico combinato. Le impostazioni ripetute con lo stesso ID verranno ignorate. Il numero di impostazioni dei segmenti di pubblico combinati 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 del targeting per pubblico combinato. Questo ID è combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Dettagli relativi all'opzione di targeting per 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),
  "targetingOptionId": string
}
Campi
householdIncome

enum (HouseholdIncome)

Il reddito del nucleo familiare del segmento di pubblico.

Output solo in v1. Obbligatorio nella versione v2.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_HOUSEHOLD_INCOME.

OnScreenPositionAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per posizione sullo schermo. Verrà compilato nel campo onScreenPositionDetails quando targetingType è 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 target. L'opzione di targeting è applicabile solo al targeting per 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 assegnato. 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à compilato nel campo operatingSystemDetails quando targetingType è 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 viene compilato nel campo targetingOptionId quando targetingType è TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

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

DeviceMakeModelAssignedTargetingOptionDetails

Dettagli sulle opzioni di targeting per marca e modello del dispositivo assegnato. Verrà compilato nel campo deviceMakeModelDetails quando targetingType è 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),
  "targetingOptionId": string
}
Campi
environment

enum (Environment)

L'ambiente di pubblicazione.

Output solo in v1. Obbligatorio nella versione v2.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_ENVIRONMENT (ad es. "508010" per il targeting dell'opzione ENVIRONMENT_WEB_OPTIMIZED).

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à compilato nel campo categoryDetails quando targetingType è 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 valore AssignedTargetingOption quando targetingType è TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

La percentuale di visibilità prevista.

Output solo in v1. Obbligatorio nella versione v2.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_VIEWABILITY (ad es. "509010" per il targeting dell'opzione VIEWABILITY_10_PERCENT_OR_MORE).

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 una risorsa non ha un'opzione di targeting assegnata a 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 regione 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 sul targeting del 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 contenuti digitali. Verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Rappresentazione JSON
{
  "excludedTargetingOptionId": string,
  "contentRatingTier": enum (ContentRatingTier)
}
Campi
excludedTargetingOptionId

string

Obbligatorio. ID dell'etichetta di contenuti digitali da ESCLUDERE.

contentRatingTier

enum (ContentRatingTier)

Solo output. Il nome visualizzato del livello di classificazione dell'etichetta contenuti digitali.

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
{
  "excludedTargetingOptionId": string,
  "sensitiveCategory": enum (SensitiveCategory)
}
Campi
excludedTargetingOptionId

string

Obbligatorio. ID della categoria sensibile da ESCLUDERE.

sensitiveCategory

enum (SensitiveCategory)

Solo output. Un'enumerazione per la categoria di classificazione dei contenuti DV360.

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
{
  "targetingOptionId": string
}
Campi
targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_EXCHANGE.

SubExchangeAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting della piattaforma di scambio 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: Dataplex.

integralAdScience

object (IntegralAdScience)

Verificatore 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 di Adloox.
ADULT_CONTENT_HARD Contenuti per adulti (hard).
ADULT_CONTENT_SOFT Contenuti per adulti (soft).
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 Dataplex.

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 le app con classificazione per età.

appStarRating

object (AppStarRating)

Non fare offerte per le 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 IVT.

customSegmentId

string (int64 format)

L'ID del segmento personalizzato fornito da Dataplex. 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 dei controlli di sicurezza del brand.

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

boolean

Sconosciuto o non valutabile.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

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

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Categorie di evitare sicurezza del brand con gravità media.

HighSeverityCategory

Opzioni possibili 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 per adulti 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/linguaggio volgare.
CRIMINAL_SKILLS Attività illegali: abilità criminali.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incentivo/malware/disordine.

MediumSeverityCategory

Opzioni possibili 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: pettegolezzi sulle celebrità.
GAMBLING Temi controversi: giochi e scommesse.
OCCULT Temi controversi: occulto.
SEX_EDUCATION Temi controversi: educazione sessuale.
DISASTER_AVIATION Catastrofi: aviazione.
DISASTER_MAN_MADE Catastrofi: causata dall'uomo.
DISASTER_NATURAL Catastrofi: naturale.
DISASTER_TERRORIST_EVENTS Catastrofi: eventi terroristici.
DISASTER_VEHICLE Catastrofi: 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 che suscitano forti reazioni.
NEGATIVE_NEWS_PHARMACEUTICAL Notizie negative: farmaceutica.

AgeRating

Possibili opzioni relative alle classificazioni in base all'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 (17+).
APP_AGE_RATE_18_PLUS App classificate solo per adulti (18+).

AppStarRating

Dettagli sulle impostazioni delle valutazioni a stelle di Dataplex.

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

enum (StarRating)

Non fare offerte per le app con valutazioni a stelle.

avoidInsufficientStarRating

boolean

Evita di fare offerte per le 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 DoubleClick Ads.

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 la durata di visibilità del 100%.

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 percentuale di visualizzazione IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB dell'80% o superiore.
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 del 40% o superiore.
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à per 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 Dataplex.

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 di tasso di visibilità IAB per video.
IAB_VIEWABILITY_80_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB dell'80% o superiore.
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 del 40% o superiore.
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 enumerazione è solo un segnaposto e non specifica alcuna opzione 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 il tasso di visibilità completa del 20% o superiore.
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 almeno il 95%di impressioni.
PLAYER_SIZE_400X300_70 Siti con almeno il 70%di impressioni.
PLAYER_SIZE_400X300_25 Siti con almeno il 25%di impressioni.
PLAYER_SIZE_400X300_5 Siti con almeno il 5%di impressioni.

FraudInvalidTraffic

Impostazioni antifrode e traffico non valido di DoubleClick.

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

enum (FraudOption)

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

avoidInsufficientOption

boolean

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

FraudOption

Possibili opzioni del tasso storico di attività fraudolenta e IVT.

Enum
FRAUD_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di attività fraudolenta o traffico non valido.
AD_IMPRESSION_FRAUD_100 100% 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 superiori 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 superiori 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à della pubblicità 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 relative alla 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 segmento personalizzato fornito da Integral Ad Science. L'ID deve essere compreso tra 1000001 e 1999999 inclusi.

TRAQScore

Possibile intervallo di punteggi TRAQ (true Advertising Quality) di Integral Ad Science.

Enum
TRAQ_UNSPECIFIED Questa enum è solo un segnaposto e non specifica punteggi di qualità pubblicitari reali.
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

È possibile scegliere le opzioni per adulti di Integral Ad Science.

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

Alcolici

È possibile scegliere le opzioni 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.

Sostanze stupefacenti

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

Possibile opzioni di violenza di Integral Ad Science.

Enum
VIOLENCE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni di violenza.
VIOLENCE_HR Violenza - Escludi contenuti 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 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 alcuna opzione di visibilità.
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%visualizzate (standard IAB di visibilità dei video).
VIDEO_VIEWABILITY_50 Più del 50%visualizzato (standard IAB di visibilità dei video).
VIDEO_VIEWABILITY_60 Più del 60%visualizzato (standard IAB di visibilità dei video).
VIDEO_VIEWABILITY_70 Più del 70%visualizzato (standard IAB di visibilità dei 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 dal suo indirizzo completo, se disponibile.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_POI.

Gli ID delle opzioni di targeting dei PDI accettati possono essere recuperati utilizzando SearchTargetingOptions.

Se scegli come target una coordinata di latitudine/longitudine specifica rimossa dal nome di un indirizzo o di un PDI, puoi generare l'ID opzione di targeting necessario arrotondando i valori delle coordinate desiderati alla sesta posizione decimale, rimuovendo i decimali e concatenando i valori delle stringhe separati da un punto e virgola. Ad esempio, puoi scegliere come target la coppia latitudine/longitudine 40.7414691, -74.003387 utilizzando l'ID opzione di targeting "40741469;-74003387".

latitude

number

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

longitude

number

Solo output. Longitudine del PDI che viene arrotondata al sesto decimale.

proximityRadiusAmount

number

Obbligatorio. Il raggio dell'area attorno al luogo di interesse 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 per 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 commerciale 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 opzione di targeting per catena commerciale accettati 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. Gli input verranno arrotondati al valore accettabile più vicino se è troppo granulare, ad esempio 15,57 diventerà 15,6.

proximityRadiusUnit

enum (DistanceUnit)

Obbligatorio. L'unità di distanza per cui viene misurato il raggio di targeting.

ContentDurationAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting assegnata alla durata dei contenuti. Verrà compilato nel campo contentDurationDetails quando targetingType è TARGETING_TYPE_CONTENT_DURATION. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto, rimuovi tutte le opzioni di targeting relative alla 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 dell'opzione di targeting assegnata al tipo di stream di contenuti. Verrà compilato nel campo contentStreamTypeDetails quando targetingType è TARGETING_TYPE_CONTENT_STREAM_TYPE. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo risultato, 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 dell'opzione di targeting assegnata alla posizione dei contenuti nativi. Verrà compilato nel campo nativeContentPositionDetails quando targetingType è 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 posizione dei contenuti nativi.

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

string

Obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_NATIVE_CONTENT_POSITION.

contentPosition

enum (NativeContentPosition)

La posizione dei contenuti.

Output solo in v1. Obbligatorio nella versione v2.

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),
  "targetingOptionId": string
}
Campi
omid

enum (Omid)

Il tipo di inventario abilitato per Open Measurement.

Output solo in v1. Obbligatorio nella versione v2.

targetingOptionId

string

Obbligatorio. targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_OMID.

AudioContentTypeAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting assegnata ai tipi di contenuti audio. Verrà compilato nel campo audioContentTypeDetails quando targetingType è 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 contenuti audio.

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

string

Obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_AUDIO_CONTENT_TYPE.

audioContentType

enum (AudioContentType)

Il tipo di contenuti audio.

Output solo in v1. Obbligatorio nella versione v2.

ContentGenreAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting assegnata al genere di contenuti. Verrà compilato nel campo contentGenreDetails quando targetingType è TARGETING_TYPE_CONTENT_GENRE. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo risultato, 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.

Metodi

get

A una campagna viene assegnata una singola opzione di targeting.

list

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