REST Resource: advertisers.insertionOrders.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.

Metodi

create

 Assegna un'opzione di targeting a un ordine di inserzione.

delete

 Elimina un'opzione di targeting assegnata da un ordine di inserzione.

get

 Ottiene una singola opzione di targeting assegnata a un ordine di inserzione.

list

 Elenca le opzioni di targeting assegnate a un ordine di inserzione.