REST Resource: advertisers.adGroups.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 agli elementi pubblicitari dei seguenti tipi di targeting:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

Solo output. Identifica il tipo di 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 il valore di 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 il valore di targetingType è TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Dettagli 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 il valore di 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 il valore di 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 sul 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 il valore di 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 il valore di 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. Nessun limite al numero di parole chiave positive che è possibile assegnare.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

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

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Dettagli ambiente. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

Puoi scegliere come target una sola opzione per lo 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 della lingua. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Dettagli sulla regione geografica. Questo campo verrà compilato quando il valore di 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 contenuti digitali. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Le etichette contenuti digitali hanno esclusioni come target. 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. Se tutte le etichette contenuti digitali sono escluse, un elemento pubblicitario non viene pubblicato.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Dettagli delle categorie sensibili. 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 categorie sensibili oltre alle esclusioni di inserzionisti, ma non possono ignorarle.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Dettagli della piattaforma di scambio pubblicitario. Questo campo verrà compilato quando il valore di targetingType è TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Dettagli della piattaforma di scambio pubblicitario secondaria. Questo campo verrà compilato quando il valore di 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 PDI. Questo campo verrà compilato quando il valore di 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 il valore di 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 il valore di 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 il valore di 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 il valore di targetingType è TARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Dettagli sulla posizione della sessione. Questo campo verrà compilato quando il valore di 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 esclusione, alle esclusioni di categorie sensibili e alle etichette contenuti digitali solo se sono configurati 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. Questo campo 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. Questo campo verrà compilato 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 è stata scelta come target per esclusione.

AppAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per app assegnata. Questo campo 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 pacchetto, ad esempio com.google.android.gm. L'ID app dell'App Store di Apple utilizza una stringa di 9 cifre, ad esempio 422689480.

displayName

string

Solo output. Il nome visualizzato dell'app.

negative

boolean

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

appPlatform

enum (AppPlatform)

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

AppPlatform

Possibili opzioni di targeting per piattaforma dell'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 di app è Amazon FireTV.
APP_PLATFORM_PLAYSTATION La piattaforma dell'app è Playstation.
APP_PLATFORM_APPLE_TV La piattaforma di app è Apple TV.
APP_PLATFORM_XBOX La piattaforma di app è Xbox.
APP_PLATFORM_SAMSUNG_TV La piattaforma di app è Samsung TV.
APP_PLATFORM_ANDROID_TV La piattaforma di app è Android TV.
APP_PLATFORM_GENERIC_CTV La piattaforma per app è una piattaforma per TV connesse a internet (CTV) non elencata espressamente 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 è 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 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. 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 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 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à disponibile per il targeting. 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 del targeting per l'elenco di località regionali. Questo campo verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_REGIONAL_LOCATION_LIST.

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

string (int64 format)

Obbligatorio. ID dell'elenco di località 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 del targeting per l'elenco di località di prossimità. Questo campo verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

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

string (int64 format)

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

proximityRadius

number

Obbligatorio. Raggio espresso nelle unità di distanza impostate in proximityRadiusUnit. Rappresenta 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à distanza raggio in miglia.
PROXIMITY_RADIUS_UNIT_KILOMETERS Unità distanza raggio in chilometri

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

Obbligatorio. Il genere del segmento di pubblico.

VideoPlayerSizeAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per le dimensioni del video player. Questo campo 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 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 sull'opzione di targeting dei contenuti con premio per l'utente. Questo campo 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. 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 assegnata. Questo campo verrà compilato 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 es. immagine e HTML5.
AD_TYPE_VIDEO Creatività video, ad es. Annunci video riprodotti durante la riproduzione in streaming dei contenuti nei video player.
AD_TYPE_AUDIO Creatività audio, ad esempio di annunci audio riprodotti durante i contenuti audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per la 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. 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.

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 ti consente di mostrare i tuoi annunci più o meno spesso 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 è di 10,0 $e il moltiplicatore è 1,5 per i tablet, il prezzo di offerta risultante per i tablet sarà 15,0 $.

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 e le occorrenze 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 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 segmenti 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 combinato 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" l'uno dall'altro.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Gli ID dei segmenti di pubblico di Google del gruppo di pubblico di Google escluso. Utilizzato per il targeting per esclusione. Il 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 i segmenti di pubblico Google per i tipi di app di affinità, in-market e con installazione installata. 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 di 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 di targeting per pubblico proprietario e di terze parti. Applicabile solo ai segmenti di pubblico proprietari, altrimenti verrà ignorato. Per ulteriori informazioni, consulta la pagina https://support.google.com/displayvideo/answer/2949947#recency Se non specificati, non verrà utilizzato alcun limite di recency.

Recency

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

Enum
RECENCY_NO_LIMIT Nessun limite di recency.
RECENCY_1_MINUTE L'attualità è 1 minuto.
RECENCY_5_MINUTES L'attualità è 5 minuti.
RECENCY_10_MINUTES L'attualità è 10 minuti.
RECENCY_15_MINUTES L'attualità è 15 minuti.
RECENCY_30_MINUTES L'attualità è 30 minuti.
RECENCY_1_HOUR L'attualità è 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 data più recente è di 6 ore.
RECENCY_12_HOURS La data più recente è di 12 ore.
RECENCY_1_DAY La data più recente è di 1 giorno.
RECENCY_2_DAYS La data più recente è di 2 giorni.
RECENCY_3_DAYS La data più recente è di 3 giorni.
RECENCY_5_DAYS La data più recente è di 5 giorni.
RECENCY_7_DAYS La data più recente è di 7 giorni.
RECENCY_10_DAYS La data più recente è di 10 giorni.
RECENCY_14_DAYS La data più recente è di 14 giorni.
RECENCY_15_DAYS La data più recente è di 15 giorni.
RECENCY_21_DAYS La data più recente è di 21 giorni.
RECENCY_28_DAYS La data più recente è di 28 giorni.
RECENCY_30_DAYS La data più recente è di 30 giorni.
RECENCY_40_DAYS La data più recente è 40 giorni.
RECENCY_45_DAYS La data più recente è di 45 giorni.
RECENCY_60_DAYS La data più recente è 60 giorni.
RECENCY_90_DAYS La data più recente è di 90 giorni.
RECENCY_120_DAYS La data più recente è 120 giorni.
RECENCY_180_DAYS La data più recente è di 180 giorni.
RECENCY_270_DAYS La data più recente è 270 giorni.
RECENCY_365_DAYS La data più recente è 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 del 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 di 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 segmenti di pubblico combinati. Tutte le impostazioni di targeting per pubblico combinato sono logicamente "OR" l'una dall'altra.

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

object (CombinedAudienceTargetingSetting)

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

CombinedAudienceTargetingSetting

Dettagli dell'impostazione di targeting per pubblico combinato.

Rappresentazione JSON
{
  "combinedAudienceId": string
}
Campi
combinedAudienceId

string (int64 format)

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

BrowserAssignedTargetingOptionDetails

Dettagli 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 del browser assegnate nella 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 sull'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 è stata scelta come target per esclusione. 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 un termine offensivo. 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 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 del 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 è stata scelta come target per esclusione.

DeviceMakeModelAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting per marca e modello del dispositivo assegnato. Questo campo 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 dell'opzione di targeting dell'ambiente assegnato. Questo campo verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

Obbligatorio. L'ambiente di pubblicazione.

InventorySourceAssignedTargetingOptionDetails

Dettagli sul targeting per l'origine dell'inventario. Questo campo 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. Questo campo 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 Visibilità assegnata. Questo campo verrà compilato 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 di venditore autorizzato assegnato. Questo campo verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Se a una risorsa non è assegnata un'opzione di targeting a TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, significa che utilizza "Venditori e rivenditori 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 campo 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. Il 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 nella stessa risorsa devono avere lo stesso valore per questo campo.

GeoRegionAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting per regione geografica assegnata. Questo campo 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. 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 campo 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 le etichette 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 per etichetta dei contenuti digitali da ESCLUDERE.

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

Dettagli dell'opzione di targeting della piattaforma di scambio 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 enum della 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 sull'opzione di targeting dello strumento di 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 di 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 (difficili).
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 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 dati storici di attività fraudolenta e Tariffe IVT.

customSegmentId

string (int64 format)

L'ID segmento personalizzato fornito da DoubleVerify. L'ID deve iniziare con "51" ed è 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 evitare gravità media per la sicurezza del brand.

HighSeverityCategory

Possibili opzioni per le categorie con gravità alta.

Enum
HIGHER_SEVERITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica categorie di gravità elevata.
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.
CRIMINAL_SKILLS Attività illegali: abilità criminali.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incentivati/malware/congestionati.

MediumSeverityCategory

Opzioni possibili per le categorie con gravità media.

Enum
MEDIUM_SEVERITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna categoria 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 Argomenti controversi: giochi e scommesse.
OCCULT Argomenti controversi: occulto.
SEX_EDUCATION Argomenti controversi: educazione sessuale.
DISASTER_AVIATION Catastrofi: aviazione.
DISASTER_MAN_MADE Catastrofe: causato dall'uomo.
DISASTER_NATURAL Catastrofi: naturale.
DISASTER_TERRORIST_EVENTS Catastrofi: eventi terroristici.
DISASTER_VEHICLE Catastrofe: veicolo.
ALCOHOL Droghe/alcol/sostanze controllate: alcol.
SMOKING Droghe/alcol/sostanze controllate: fumo.
NEGATIVE_NEWS_FINANCIAL Notizie negative: finanziarie.
NON_ENGLISH Contenuti non standard: non in inglese.
PARKING_PAGE Contenuti non standard: pagina di parcheggio.
UNMODERATED_UGC Contenuti generati dagli utenti non moderati: forum, immagini e Video:
INFLAMMATORY_POLITICS_AND_NEWS Argomenti controversi: politica e notizie provocatorie.
NEGATIVE_NEWS_PHARMACEUTICAL Notizie negative: farmaceutica.

AgeRating

Possibili opzioni per le classificazioni in base all'età.

Enum
AGE_RATING_UNSPECIFIED Questa 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 per adolescenti (dai 12 anni in su).
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 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 di DoubleVerify per visualizzare le impostazioni di visibilità.

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 della visibilità del 100%.

IAB

Opzioni possibili per il tasso di visibilità IAB.

Enum
IAB_VIEWED_RATE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione di tariffa visualizzata 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 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 per massimizzare il tasso di visibilità IAB del 55% o superiore.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 50% o superiore.
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 del 30% o superiore.

ViewableDuring

Opzioni possibili per la durata visibile.

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

VideoViewability

Dettagli delle impostazioni di visibilità dei video di DoubleVerify.

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

enum (VideoIAB)

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

videoViewableRate

enum (VideoViewableRate)

Scegli come target l'inventario web per massimizzare 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 Questa enum è solo un segnaposto e non specifica nessuna opzione di percentuale di visibilità IAB video.
IAB_VIEWABILITY_80_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB 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 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 per massimizzare il tasso di visibilità IAB del 55% o superiore.
IAB_VIEWABILITY_50_PERCENT_HIGHER Scegli come target l'inventario web e per app per massimizzare il tasso di visibilità IAB del 50% o superiore.
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 del 30% o superiore.

VideoViewableRate

Possibili opzioni per la percentuale di visibilità completa.

Enum
VIDEO_VIEWABLE_RATE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione di percentuale di visibilità del 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 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

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 relative ad attività fraudolente e Percentuale IVT.

Enum
FRAUD_UNSPECIFIED Questa enum è solo un segnaposto e non specifica opzioni per attività fraudolente e traffico non valido.
AD_IMPRESSION_FRAUD_100 100% attività fraudolente e IVT.
AD_IMPRESSION_FRAUD_50 50% o più di attività fraudolente e IVT.
AD_IMPRESSION_FRAUD_25 Attività fraudolente e attività fraudolente pari o superiori al 25% IVT.
AD_IMPRESSION_FRAUD_10 10% o più di attività fraudolenta e IVT.
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 4% o più di attività fraudolente e IVT.
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)

Qualità effettiva della pubblicità (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 - Sostanze stupefacenti.

excludedHateSpeechRisk

enum (HateSpeech)

Sicurezza del brand - Incitamento all'odio.

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Sicurezza del brand - Linguaggio offensivo.

excludedViolenceRisk

enum (Violence)

Sicurezza del brand - Violenza.

excludedGamblingRisk

enum (Gambling)

Sicurezza del brand - Giochi e scommesse.

excludedAdFraudRisk

enum (AdFraudPrevention)

Impostazioni della frode pubblicitaria.

displayViewability

enum (DisplayViewability)

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

videoViewability

enum (VideoViewability)

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

customSegmentId[]

string (int64 format)

L'ID 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 700-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 Adult.

Enum
ADULT_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione per adulti.
ADULT_HR Per adulti - Escludi 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 opzioni di alcolici.
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 ad alto rischio e a rischio moderato.

Droghe

Possibili opzioni di farmaci di Integral Ad Science.

Enum
DRUGS_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione di 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 ad alto rischio.
HATE_SPEECH_HMR Incitamento all'odio: escludi contenuti ad alto rischio e a rischio moderato.

OffensiveLanguage

Possibili opzioni di lingua offensive di Integral Ad Science.

Enum
OFFENSIVE_LANGUAGE_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione 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 ad alto rischio.
GAMBLING_HMR Giochi e scommesse: escludi rischio elevato e 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 alcuna opzione di prevenzione delle frodi pubblicitarie.
SUSPICIOUS_ACTIVITY_HR Frode pubblicitaria: Escludi ad alto rischio.
SUSPICIOUS_ACTIVITY_HMR Frode pubblicitaria: escludi rischio elevato e 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à display.
PERFORMANCE_VIEWABILITY_40 Scegli come target il 40% della visibilità o una percentuale superiore.
PERFORMANCE_VIEWABILITY_50 Scegli come target il 50% della visibilità o una percentuale superiore.
PERFORMANCE_VIEWABILITY_60 Scegli come target il 60% della visibilità o una percentuale superiore.
PERFORMANCE_VIEWABILITY_70 Scegli come target il 70% della visibilità o una percentuale superiore.

VideoViewability

Possibili opzioni di visibilità di Integral Ad Science Video.

Enum
VIDEO_VIEWABILITY_UNSPECIFIED Questa enum è solo un segnaposto e non specifica alcuna opzione di visibilità video.
VIDEO_VIEWABILITY_40 Più del 40%visualizzato (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. Questo campo 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 Ago" 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 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 di campo verrà aggiornato per aggiungere un punto e virgola e un valore hash alfanumerico, se vengono fornite solo le coordinate di latitudine/longitudine .

latitude

number

Solo output. Latitudine del PDI arrotondato alla sesta posizione decimale.

longitude

number

Solo output. Longitudine del PDI arrotondato alla sesta posizione decimale.

proximityRadiusAmount

number

Obbligatorio. Il raggio dell'area intorno al PDI che verrà scelto 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.

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.

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 della catena commerciale assegnata. Questo campo 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. Il targetingOptionId di un TargetingOption di tipo TARGETING_TYPE_BUSINESS_CHAIN.

Gli ID delle opzioni di targeting per le catene commerciali accettate possono essere recuperati utilizzando SearchTargetingOptions.

proximityRadiusAmount

number

Obbligatorio. Il raggio dell'area attorno alla catena commerciale che verrà scelta come target. Le unità del raggio sono specificate da proximityRadiusUnit. 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 in base alla quale viene misurato il raggio di targeting.

ContentDurationAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata 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 sull'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. Rimuovi tutte le opzioni di targeting per i tipi di stream di contenuti per ottenere questo effetto.

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 campo 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
{
  "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 campo verrà compilato nel campo dei dettagli di un'opzione AssignedTargetingOption quando targetingType è TARGETING_TYPE_OMID.

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

enum (Omid)

Obbligatorio. Il tipo di inventario abilitato per Open Measurement.

AudioContentTypeAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata al tipo di contenuti audio. Questo campo verrà compilato nel campo audioContentTypeDetails quando targetingType è TARGETING_TYPE_AUDIO_CONTENT_TYPE. Il targeting esplicito di tutte le opzioni non è supportato. Rimuovi tutte le opzioni di targeting per tipo di contenuti audio per ottenere questo effetto.

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

enum (AudioContentType)

Obbligatorio. Il tipo di contenuti audio.

ContentGenreAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting assegnata in base al genere di contenuti. Questo campo verrà compilato nel campo contentGenreDetails quando targetingType è TARGETING_TYPE_CONTENT_GENRE. Il targeting esplicito di tutte le opzioni non è supportato. Rimuovi tutte le opzioni di targeting per genere di contenuti per ottenere questo effetto.

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

string

Obbligatorio. Il campo targetingOptionId quando targetingType è TARGETING_TYPE_CONTENT_GENRE.

displayName

string

Solo output. Il nome visualizzato del genere di contenuti.

negative

boolean

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

YoutubeVideoAssignedTargetingOptionDetails

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

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

string

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

negative

boolean

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

YoutubeChannelAssignedTargetingOptionDetails

Dettagli sull'opzione di targeting assegnata al canale YouTube. Questo campo verrà compilato 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 è stata scelta come target per esclusione.

SessionPositionAssignedTargetingOptionDetails

Dettagli per l'opzione di targeting assegnata alla posizione della sessione. Questo campo verrà compilato 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 assegnare una singola opzione di targeting a un gruppo di annunci.

list

Elenca le opzioni di targeting assegnate a un gruppo di annunci.