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 del tipo di targeting. Può essere riutilizzato in altri contesti.

assignedTargetingOptionIdAlias

string

Solo output. Un alias per 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 all'elemento pubblicitario dei seguenti tipi di targeting:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
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 unione details. Informazioni dettagliate sull'opzione di targeting assegnata. È possibile compilare un solo campo dettagliato, che deve corrispondere a targeting_type. details può essere solo uno dei seguenti:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

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

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Dettagli sulle categorie di app. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

Dettagli dell'URL. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Dettagli sulla fascia d'età. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

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

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

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

genderDetails

object (GenderAssignedTargetingOptionDetails)

Dettagli sul genere. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Dettagli sulle dimensioni del video player. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Dettagli dei contenuti con premio per l'utente. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione in-stream dei contenuti. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Dettagli della posizione outstream dei contenuti. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Dettagli del tipo di dispositivo. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Dettagli sul reddito del nucleo familiare. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione sullo schermo. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Dettagli parola chiave. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_KEYWORD.

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

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Dettagli parola chiave. Questo campo verrà compilato quando targetingType è 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 è TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

Scegliendo come target una categoria, verranno scelte come target anche le relative sottocategorie. Se una categoria viene esclusa dal targeting ed è inclusa una sottocategoria, l'esclusione avrà la precedenza.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

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

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

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Dettagli della lingua. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Dettagli delle etichette dei contenuti digitali. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Le etichette contenuti digitali sono esclusioni dal targeting. Le esclusioni di 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 dei contenuti, oltre a quelle degli inserzionisti, ma non possono ignorarle. Un elemento pubblicitario non verrà pubblicato se vengono escluse tutte le etichette dei contenuti digitali.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Dettagli della categoria sensibile. Questo campo verrà compilato quando il valore di 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 le 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 è TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Dettagli della verifica di terze parti. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Dettagli dei PDI. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Dettagli della catena commerciale. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

Dettagli dell'inventario abilitato per Open Measurement. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Dettagli sul genere di contenuti. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_CONTENT_GENRE.

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Dettagli del video di YouTube. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_YOUTUBE_VIDEO.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

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

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Dettagli della posizione della sessione. Questo campo verrà compilato quando targetingType è 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 alla pubblicazione rispetto al targeting assegnato al livello attuale e non possono essere modificate tramite il servizio entità corrente. Devono essere modificati tramite il servizio entità da cui vengono ereditati. L'ereditarietà si applica solo ai canali con targeting per esclusioni, alle esclusioni di categorie sensibili e alle esclusioni di etichette di contenuti digitali se sono configurate a livello di gruppo 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 per l'opzione di targeting per canale assegnata. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnato 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 di 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. Questo campo verrà inserito nel campo appCategoryDetails di un'opzione 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 è scelta come target escluso.

AppAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per app assegnata. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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 è scelta come target escluso.

appPlatform

enum (AppPlatform)

Indica la piattaforma dell'app di destinazione. Se questo campo non viene specificato, si presume che la piattaforma dell'app sia mobile (ovvero Android o iOS) e noi dedurremo 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 di app è Android.
APP_PLATFORM_ROKU La piattaforma dell'app è Roku.
APP_PLATFORM_AMAZON_FIRETV La piattaforma dell'app è Amazon Fire TV.
APP_PLATFORM_PLAYSTATION La piattaforma dell'app è PlayStation.
APP_PLATFORM_APPLE_TV La piattaforma dell'app è Apple TV.
APP_PLATFORM_XBOX La piattaforma di 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) non elencata esplicitamente altrove.
APP_PLATFORM_LG_TV La piattaforma di app è LG TV.
APP_PLATFORM_VIZIO_TV La piattaforma dell'app è VIZIO TV.

UrlAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting per URL assegnata. Questo campo 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 è scelta come target escluso.

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 a quella rappresentata da endHour.

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

enum (DayOfWeek)

Obbligatorio. Il giorno della settimana di 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. Deve essere compreso tra 1 (1 ora dopo l'inizio della giornata) e 24 (fine della giornata).

timeZoneResolution

enum (TimeZoneResolution)

Obbligatorio. Il meccanismo utilizzato per determinare il fuso orario da utilizzare per l'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 risolvere il problema con 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 può essere scelta come target. Questo campo 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 il targeting solo per una fascia d'età continua di un segmento di pubblico. Di conseguenza, la fascia d'età rappresentata in questo campo può essere 1) scelta come target esclusivamente o 2) parte di una fascia d'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.

RegionalLocationListAssignedTargetingOptionDetails

Dettagli sul targeting per l'elenco di località regionali. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata quando targetingType è TARGETING_TYPE_REGIONAL_LOCATION_LIST.

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

string (int64 format)

Obbligatorio. ID dell'elenco di località regionali. 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à. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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à nelle vicinanze. Deve fare riferimento al campo locationListId di una risorsa LocationList di tipo TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadius

number

Obbligatorio. Raggio espresso nelle unità di misura impostate in proximityRadiusUnit. Indica le dimensioni dell'area intorno 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 quando le unità di misura non sono specificate in questa versione. Questa enum è un segnaposto per il valore predefinito e non rappresenta un'unità di distanza reale.
PROXIMITY_RADIUS_UNIT_MILES Unità di misura della distanza del raggio in miglia.
PROXIMITY_RADIUS_UNIT_KILOMETERS Unità distanza raggio in chilometri

GenderAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per genere assegnata. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata quando targetingType è TARGETING_TYPE_GENDER.

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

enum (Gender)

Obbligatorio. Il genere del segmento di pubblico.

VideoPlayerSizeAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per le dimensioni del video player. Questo valore verrà inserito nel campo videoPlayerSizeDetails quando targetingType è TARGETING_TYPE_VIDEO_PLAYER_SIZE. Il targeting esplicito di tutte le opzioni non è supportato. Per ottenere questo effetto devi rimuovere tutte le opzioni di targeting per le dimensioni del video player.

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

enum (VideoPlayerSize)

Obbligatorio. Le dimensioni del video player.

UserRewardedContentAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per contenuti con premio per l'utente. Questo valore verrà inserito 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 per l'opzione di targeting per stato parentale assegnato. Questo campo 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 dell'opzione di targeting per posizione in-stream dei contenuti assegnati. Questo valore verrà inserito nel campo contentInstreamPositionDetails quando targetingType è TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

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

enum (ContentInstreamPosition)

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

adType

enum (AdType)

Solo output. Il tipo di annuncio da scegliere come target. L'opzione applicabile solo al targeting degli ordini di inserzione e ai 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 dei contenuti nei video player.
AD_TYPE_AUDIO Creatività audio, ad esempio annunci audio che vengono riprodotti durante i contenuti audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per posizione outstream dei contenuti assegnati. Questo campo verrà compilato nel campo contentOutstreamPositionDetails quando targetingType è TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

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

enum (ContentOutstreamPosition)

Obbligatorio. La posizione outstream dei contenuti.

adType

enum (AdType)

Solo output. Il tipo di annuncio da scegliere come target. 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 è LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Dettagli sul targeting per tipo di dispositivo. Questo campo 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 con una frequenza maggiore o minore in base al tipo di dispositivo. Verrà applicato un moltiplicatore al prezzo dell'offerta originale. Se questo campo è pari a 0, indica che il campo non è applicabile e non viene moltiplicato per 0 sul prezzo dell'offerta originale.

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

Applicabile solo agli elementi pubblicitari YouTube e partner.

AudienceGroupAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting a livello di gruppo di pubblico assegnata. Questo campo 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 Interazioni 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 dei segmenti di pubblico proprietari e di terze parti e le relative frequenze dei gruppi di segmenti di pubblico proprietari e di terze parti inclusi. Ogni gruppo di segmenti di pubblico proprietari e di terze parti contiene solo ID di segmenti di pubblico proprietari e di terze parti. La relazione tra ciascun gruppo di pubblico proprietario e di terze parti è Interazioni e il risultato è UNION con altri gruppi di pubblico. I gruppi ripetuti con le stesse impostazioni verranno ignorati.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

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

includedCustomListGroup

object (CustomListGroup)

Gli ID elenchi personalizzati del gruppo di elenchi personalizzati incluso. Contiene solo ID elenchi personalizzati.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Gli ID e le occorrenze 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 COMPLEMENT dell'UNION di questo gruppo e di altri gruppi di pubblico esclusi viene utilizzato come INTERESSE per qualsiasi targeting per pubblico positivo. Tutti gli elementi sono logicamente "OR" tra loro.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Gli ID segmento di pubblico Google del gruppo di segmenti di pubblico Google escluso. Utilizzato per il targeting per esclusione. Il COMPLEMENT dell'UNION di questo gruppo e di altri gruppi di pubblico esclusi viene utilizzato come INTERESSE 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 sono logicamente "OR" l'una rispetto all'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 sull'impostazione del targeting per pubblico proprietario 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 del targeting per pubblico proprietario e di terze parti. Applicabile solo ai segmenti di pubblico proprietari, altrimenti verrà ignorato. Per ulteriori informazioni, consulta https://support.google.com/displayvideo/answer/2949947#recency. Se non specificato, non verrà utilizzato alcun limite di tempestività.

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 frequenza è di 1 minuto.
RECENCY_5_MINUTES La frequenza è di 5 minuti.
RECENCY_10_MINUTES La frequenza è di 10 minuti.
RECENCY_15_MINUTES La frequenza è di 15 minuti.
RECENCY_30_MINUTES La frequenza è di 30 minuti.
RECENCY_1_HOUR L'attualità è 1 ora.
RECENCY_2_HOURS La frequenza è di 2 ore.
RECENCY_3_HOURS La data più recente è di 3 ore.
RECENCY_6_HOURS La data di ultima interazione è di 6 ore.
RECENCY_12_HOURS La frequenza è di 12 ore.
RECENCY_1_DAY La data più recente è di 1 giorno.
RECENCY_2_DAYS La data di ultima interazione è di 2 giorni.
RECENCY_3_DAYS La data di ultima interazione è di 3 giorni.
RECENCY_5_DAYS La data di ultima interazione è di 5 giorni.
RECENCY_7_DAYS La data più recente è di 7 giorni.
RECENCY_10_DAYS La data di ultima interazione è di 10 giorni fa.
RECENCY_14_DAYS La data di ultima interazione è di 14 giorni.
RECENCY_15_DAYS La data di ultima interazione è di 15 giorni.
RECENCY_21_DAYS La data di ultima interazione è di 21 giorni.
RECENCY_28_DAYS La data di ultima interazione è di 28 giorni.
RECENCY_30_DAYS La data più recente è di 30 giorni.
RECENCY_40_DAYS La data di ultima interazione è di 40 giorni fa.
RECENCY_45_DAYS La data di ultima interazione è di 45 giorni.
RECENCY_60_DAYS La data di ultima interazione è di 60 giorni.
RECENCY_90_DAYS La data più recente è di 90 giorni.
RECENCY_120_DAYS La data di ultima interazione è di 120 giorni fa.
RECENCY_180_DAYS La data più recente è di 180 giorni.
RECENCY_270_DAYS La data di ultima interazione è di 270 giorni fa.
RECENCY_365_DAYS La data di ultima interazione è di 365 giorni.

GoogleAudienceGroup

Dettagli del gruppo di pubblico di 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 di targeting per pubblico di 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 del targeting per pubblico di Google. Questo ID è googleAudienceId.

CustomListGroup

Dettagli del gruppo di elenchi personalizzato. 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 personalizzati. 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 rispetto all'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 dei segmenti di pubblico combinati non deve superare 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 del segmento di pubblico combinato dell'impostazione di targeting per pubblico combinato. Questo ID è combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per browser assegnata. Questo campo 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. Il 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 per browser assegnate alla stessa risorsa devono avere lo stesso valore per questo campo.

HouseholdIncomeAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per il reddito del nucleo familiare assegnato. Questo campo 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 dell'opzione di targeting per posizione sullo schermo. Questo campo 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 da scegliere come target. L'opzione applicabile solo al targeting degli ordini di inserzione e ai 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 assegnata. Questo campo 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. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

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

KeywordAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per parole chiave assegnata. Questo campo 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 offensiva. Deve essere codificato 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 un elenco di parole chiave escluse. Questo campo 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 dell'opzione di targeting per sistema operativo assegnata. Questo campo 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. ID opzione di targeting compilato nel campo targetingOptionId quando targetingType è TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Indica se questa opzione è scelta come target escluso.

DeviceMakeModelAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per marca e modello del dispositivo assegnati. Questo valore verrà inserito 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 è scelta come target escluso.

EnvironmentAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting dell'ambiente assegnato. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnato 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 dell'opzione di targeting per categoria assegnata. Questo valore verrà inserito 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 Visibilità assegnata. Questo campo verrà inserito nel campo viewabilityDetails di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

Obbligatorio. La percentuale di visibilità prevista.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Rappresenta uno stato del venditore autorizzato assegnato. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata quando targetingType è TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

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

enum (AuthorizedSellerStatus)

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

targetingOptionId

string

Obbligatorio. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per lingua assegnata. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_LANGUAGE.

negative

boolean

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

GeoRegionAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per regione geografica assegnata. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

Solo output. Il tipo di targeting per regione geografica.

negative

boolean

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

InventorySourceGroupAssignedTargetingOptionDetails

Dettagli sul targeting per il gruppo di origini dell'inventario. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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 dei contenuti digitali. Questo campo 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 dell'etichetta dei contenuti digitali da ESCLUDERE.

SensitiveCategoryAssignedTargetingOptionDetails

Dettagli sul targeting per la categoria sensibile. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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 dell'opzione di targeting per gli scambi assegnata. Questo campo 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 enumerato per la piattaforma di scambio pubblicitario.

SubExchangeAssignedTargetingOptionDetails

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

Rappresentazione JSON
{
  "targetingOptionId": string
}
Campi
targetingOptionId

string

Obbligatorio. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting dell'azienda addetta alla verifica di terze parti assegnata. Questo campo 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 unione verifier. Puoi scegliere come target uno degli strumenti di verifica di terze parti per applicare soglie di sicurezza del brand per le impressioni. verifier può essere solo uno dei seguenti:
adloox

object (Adloox)

Verificatore del brand di terze parti -- Adloox.

doubleVerify

object (DoubleVerify)

Verificatore del brand di terze parti -- DoubleVerify.

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)

Le impostazioni di sicurezza del brand di Adloox.

AdlooxCategory

Possibili opzioni di Adloox.

Enum
ADLOOX_UNSPECIFIED Questo enum è solo un segnaposto e non specifica alcuna opzione 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 Contenuti violenti e armi.
LOW_VIEWABILITY_DOMAINS Domini con scarsa 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 le app con la 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 siti e 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 valutabile.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

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

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Categorie di sicurezza del brand per contenuti con rischio medio.

HighSeverityCategory

Possibili opzioni per le categorie di gravità elevata.

Enum
HIGHER_SEVERITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica categorie di gravità elevata.
ADULT_CONTENT_PORNOGRAPHY Contenuti per adulti: pornografia, argomenti per adulti e Nudità.
COPYRIGHT_INFRINGEMENT Violazione del copyright.
SUBSTANCE_ABUSE Droghe/alcolici/sostanze controllate: abuso di sostanze stupefacenti.
GRAPHIC_VIOLENCE_WEAPONS Violenza estrema/violenza esplicita/armi.
HATE_PROFANITY Odio/linguaggio.
CRIMINAL_SKILLS Attività illegali: abilità criminali.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Traffico incentivato/malware/spyware.

MediumSeverityCategory

Possibili opzioni per le categorie di gravità media.

Enum
MEDIUM_SEVERITY_UNSPECIFIED Questo enum è solo un segnaposto e non specifica categorie di gravità media.
AD_SERVERS Ad server.
ADULT_CONTENT_SWIMSUIT Contenuti per adulti: costumi da bagno.
ALTERNATIVE_LIFESTYLES Argomenti controversi: stili di vita alternativi.
CELEBRITY_GOSSIP Argomenti controversi: gossip sulle celebrità.
GAMBLING Temi controversi: giochi e scommesse.
OCCULT Temi controversi: occultismo.
SEX_EDUCATION Argomenti controversi: educazione sessuale.
DISASTER_AVIATION Catastrofe: aviazione.
DISASTER_MAN_MADE Catastrofe: provocata dall'uomo.
DISASTER_NATURAL Catastrofi: naturale.
DISASTER_TERRORIST_EVENTS Catastrofe: 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 che suscitano forti reazioni.
NEGATIVE_NEWS_PHARMACEUTICAL Notizie negative: farmaceutiche.

AgeRating

Possibili opzioni per le classificazioni per età.

Enum
AGE_RATING_UNSPECIFIED Questo enum è solo un segnaposto e non specifica alcuna opzione di classificazione 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 come adatte agli adolescenti (12 anni e più).
APP_AGE_RATE_17_PLUS App classificate come Per adulti (17+).
APP_AGE_RATE_18_PLUS App classificate come per soli adulti (18+).

AppStarRating

Dettagli delle impostazioni delle valutazioni 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 Questo enum è solo un segnaposto e non specifica alcuna opzione di valutazione a stelle per le app.
APP_STAR_RATE_1_POINT_5_LESS App ufficiali con valutazione inferiore a 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 inferiore a 3 stelle.
APP_STAR_RATE_3_POINT_5_LESS App ufficiali con valutazione inferiore a 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 inferiore a 4,5 stelle.

DisplayViewability

Dettagli delle impostazioni di visibilità della visualizzazione di DoubleVerify.

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

enum (IAB)

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

viewableDuring

enum (ViewableDuring)

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

IAB

Opzioni possibili per il tasso di visibilità IAB.

Enum
IAB_VIEWED_RATE_UNSPECIFIED Questo enum è solo un segnaposto e non specifica alcuna opzione per il tasso di visualizzazione IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Scegli come target l'inventario web e per app al fine di 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 del 75% o superiore.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 70% o superiore.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 65% o superiore.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 60% o superiore.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Scegli come target l'inventario web e per app al fine di 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 al fine di 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 al fine di 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 al fine di massimizzare il tasso di visibilità IAB pari o superiore al 30%.

ViewableDuring

Possibili opzioni per la durata visibile.

Enum
AVERAGE_VIEW_DURATION_UNSPECIFIED Questo enum è solo un segnaposto e non specifica opzioni per la durata media delle visualizzazioni.
AVERAGE_VIEW_DURATION_5_SEC Scegli come target l'inventario web e per app al fine di massimizzare il 100% della durata della visibilità di almeno 5 secondi.
AVERAGE_VIEW_DURATION_10_SEC Scegli come target l'inventario web e per app al fine di massimizzare il 100% della durata della visibilità di almeno 10 secondi.
AVERAGE_VIEW_DURATION_15_SEC Scegli come target l'inventario web e per app al fine di massimizzare il 100% della durata della visibilità di 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 la percentuale 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 per il tasso di visibilità IAB.

Enum
VIDEO_IAB_UNSPECIFIED Questo enum è solo un segnaposto e non specifica alcuna opzione per il tasso di visibilità video IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Scegli come target l'inventario web e per app al fine di 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 del 75% o superiore.
IAB_VIEWABILITY_70_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 70% o superiore.
IAB_VIEWABILITY_65_PERCENT_HIHGER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 65% o superiore.
IAB_VIEWABILITY_60_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 60% o superiore.
IAB_VIEWABILITY_55_PERCENT_HIHGER Scegli come target l'inventario web e per app al fine di 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 al fine di 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 al fine di 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 al fine di massimizzare il tasso di visibilità IAB pari o superiore al 30%.

VideoViewableRate

Possibili opzioni di tasso di visibilità completa.

Enum
VIDEO_VIEWABLE_RATE_UNSPECIFIED Questo enum è solo un segnaposto e non specifica alcuna opzione per il tasso di visibilità dei video.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare il tasso di visibilità completa pari o superiore al 40%.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare il tasso di visibilità completa pari o superiore al 35%.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare il tasso di visibilità completa pari o superiore al 30%.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare il 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 pari o superiore al 20%.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Scegli come target l'inventario web per massimizzare il 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 alcuna opzione di impressioni.
PLAYER_SIZE_400X300_95 Siti con oltre il 95% delle impressioni.
PLAYER_SIZE_400X300_70 Siti con oltre il 70% delle impressioni.
PLAYER_SIZE_400X300_25 Siti con oltre il 25% delle impressioni.
PLAYER_SIZE_400X300_5 Siti con oltre il 5% delle impressioni.

FraudInvalidTraffic

Verifica frode e Impostazioni relative al traffico non valido.

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

enum (FraudOption)

Evita siti e app con dati storici di attività fraudolenta e IVT.

avoidInsufficientOption

boolean

Attività fraudolenta e dati storici insufficienti Statistiche IVT.

FraudOption

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

Enum
FRAUD_UNSPECIFIED Questo enum è solo un segnaposto e non specifica opzioni di attività fraudolenta e traffico non valido.
AD_IMPRESSION_FRAUD_100 100% attività fraudolenta e traffico non valido.
AD_IMPRESSION_FRAUD_50 50% o più di attività fraudolente e IVT.
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 aumento pari o superiori all'8% IVT.
AD_IMPRESSION_FRAUD_6 6% o più di attività fraudolente e IVT.
AD_IMPRESSION_FRAUD_4 Attività fraudolenta e traffico non valido pari o superiori al 4%.
AD_IMPRESSION_FRAUD_2 Attività fraudolenta e livelli superiori al 2% IVT.

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)

True Advertising Quality (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: farmaci.

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

Possibili intervalli di punteggi TRAQ (qualità della pubblicità reale) 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 compreso tra 700 e 1000.
TRAQ_750 punteggio TRAQ 750-1000.
TRAQ_875 punteggio TRAQ 875-1000.
TRAQ_1000 punteggio TRAQ 1000.

Adulto

Possibili opzioni di Integral Ad Science per gli annunci per adulti.

Enum
ADULT_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione per adulti.
ADULT_HR Contenuti per adulti - Escludi contenuti ad alto rischio.
ADULT_HMR Adulti: escludi rischio elevato e moderato.

Alcolici

Possibili opzioni di Integral Ad Science soluzioni alcolici.

Enum
ALCOHOL_UNSPECIFIED Questo enum è solo un segnaposto e non specifica alcuna opzione per le bevande alcoliche.
ALCOHOL_HR Alcol: escludi ad alto rischio.
ALCOHOL_HMR Alcol: escludi rischio elevato e moderato.

IllegalDownloads

Possibili opzioni di download illegali di Integral Ad Science.

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

Droghe

Possibili opzioni di farmaci di Integral Ad Science.

Enum
DRUGS_UNSPECIFIED Questo enum è solo un segnaposto e non specifica opzioni per i farmaci.
DRUGS_HR Droghe: escludi ad alto rischio.
DRUGS_HMR Droghe: escludi rischio elevato e moderato.

HateSpeech

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

Enum
HATE_SPEECH_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione di incitamento all'odio.
HATE_SPEECH_HR Incitamento all'odio - Escludi contenuti ad alto rischio.
HATE_SPEECH_HMR Incitamento all'odio - Escludi contenuti ad alto rischio e a rischio moderato.

OffensiveLanguage

Possibili opzioni di linguaggio offensivo di Integral Ad Science.

Enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Questo 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 rischio elevato e moderato.

Violenza

Possibili 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 contenuti 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 alcuna opzione relativa a giochi e scommesse.
GAMBLING_HR Giochi e scommesse - Escludi contenuti ad alto rischio.
GAMBLING_HMR Giochi e scommesse - Escludi contenuti ad alto rischio e a rischio moderato.

AdFraudPrevention

Possibili opzioni di prevenzione della frode pubblicitaria di Integral Ad Science.

Enum
SUSPICIOUS_ACTIVITY_UNSPECIFIED Questa enumerazione è solo un segnaposto e non specifica opzioni di prevenzione della frode pubblicitaria.
SUSPICIOUS_ACTIVITY_HR Frode pubblicitaria: Escludi ad alto rischio.
SUSPICIOUS_ACTIVITY_HMR Frode pubblicitaria: escludi contenuti ad alto rischio e a rischio moderato.

DisplayViewability

Possibili opzioni di visibilità display di Integral Ad Science.

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

VideoViewability

Possibili opzioni di visibilità video di Integral Ad Science.

Enum
VIDEO_VIEWABILITY_UNSPECIFIED Questo enum è solo un segnaposto e non specifica alcuna opzione di visibilità dei video.
VIDEO_VIEWABILITY_40 Visibilità superiore al 40% (standard di visibilità video IAB).
VIDEO_VIEWABILITY_50 Più del 50% in vista (standard di visibilità video IAB).
VIDEO_VIEWABILITY_60 Visibilità superiore al 60% (standard di visibilità video IAB).
VIDEO_VIEWABILITY_70 Più del 70%visualizzato (standard IAB di visibilità dei video).

PoiAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per PDI assegnata. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnato 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. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_POI.

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

Se scegli come target una specifica coordinata di latitudine/longitudine da un indirizzo o dal nome di un PDI, puoi generare l'ID dell'opzione di targeting necessaria arrotondando i valori delle coordinate 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 di 40.7414691, -74.003387 utilizzando l'ID opzione di targeting "40741469;-74003387". Dopo la creazione, questo valore del 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 arrotondato alla sesta posizione decimale.

longitude

number

Solo output. La longitudine del PDI arrotondata alla sesta cifra decimale.

proximityRadiusAmount

number

Obbligatorio. Il raggio dell'area intorno 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à di misura è DISTANCE_UNIT_KILOMETERS e tra 1 e 500 se l'unità di misura è DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

Obbligatorio. L'unità di distanza in base alla quale viene misurato il raggio di targeting.

DistanceUnit

Possibili opzioni di unità di misura della distanza.

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 la catena commerciale assegnata. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_BUSINESS_CHAIN.

Gli ID opzione di targeting per le catene di attività accettati possono essere recuperati utilizzando SearchTargetingOptions.

proximityRadiusAmount

number

Obbligatorio. Il raggio dell'area intorno alla catena di attività che verrà scelta come target. Le unità del raggio sono specificate da proximityRadiusUnit. Il valore deve essere compreso tra 1 e 800 se l'unità è DISTANCE_UNIT_KILOMETERS e da 1 a 500 se l'unità è DISTANCE_UNIT_MILES. L'incremento minimo per entrambi i casi è 0,1. I valori 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 con cui viene misurato il raggio di targeting.

ContentDurationAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata in base alla durata dei contenuti. Questo campo 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 per la 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. Questo campo verrà compilato nel campo contentStreamTypeDetails quando targetingType è 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. Questo valore verrà inserito 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
{
  "contentPosition": enum (NativeContentPosition)
}
Campi
contentPosition

enum (NativeContentPosition)

Obbligatorio. La posizione dei contenuti.

OmidAssignedTargetingOptionDetails

Rappresenta un tipo di inventario abilitato per Open Measurement disponibile per il targeting. Questo valore verrà inserito nel campo dei dettagli di un'opzione di targeting assegnata 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. Questo campo 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
{
  "audioContentType": enum (AudioContentType)
}
Campi
audioContentType

enum (AudioContentType)

Obbligatorio. Il tipo di contenuti audio.

ContentGenreAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata in base al genere di contenuti. Questo valore verrà inserito nel campo contentGenreDetails quando targetingType è 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 è scelta come target escluso.

YoutubeVideoAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata al video di YouTube. Questo campo verrà compilato nel campo youtubeVideoDetails quando targetingType è TARGETING_TYPE_YOUTUBE_VIDEO.

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

string

L'ID video di YouTube visualizzato nella pagina di visualizzazione di YouTube.

negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting assegnata al canale YouTube. Questo valore verrà inserito nel campo youtubeChannelDetails quando targetingType è TARGETING_TYPE_YOUTUBE_CHANNEL.

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

string

L'ID canale che ha caricato il video su YouTube o il codice canale di un canale YouTube.

negative

boolean

Indica se questa opzione è scelta come target escluso.

SessionPositionAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata alla posizione della sessione. Questo valore verrà inserito nel campo sessionPositionDetails quando targetingType è TARGETING_TYPE_SESSION_POSITION.

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

enum (SessionPosition)

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

SessionPosition

Possibili posizioni in una sessione.

Enum
SESSION_POSITION_UNSPECIFIED Questo è un segnaposto, non indica alcuna posizione.
SESSION_POSITION_FIRST_IMPRESSION La prima impressione della sessione.

Metodi

get

Consente di ottenere una singola opzione di targeting assegnata a una campagna.

list

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