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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "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)
  },
  "contentThemeExclusionDetails": {
    object (ContentThemeAssignedTargetingOptionDetails)
  },
  "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)
  },
  "lookalikeAudienceDetails": {
    object (LookalikeAudienceAssignedTargetingOptionDetails)
  },
  "googleAudienceDetails": {
    object (GoogleAudienceAssignedTargetingOptionDetails)
  },
  "customListDetails": {
    object (CustomListAssignedTargetingOptionDetails)
  },
  "combinedAudienceDetails": {
    object (CombinedAudienceAssignedTargetingOptionDetails)
  },
  "firstPartyAndPartnerAudienceDetails": {
    object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)
  },
  "auctionPackageDetails": {
    object (AuctionPackageAssignedTargetingOptionDetails)
  },
  "youtubeChannelPackDetails": {
    object (YoutubeChannelPackAssignedTargetingOptionDetails)
  }
  // End of mutually exclusive fields.
}
Campi
name

string

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

string

Solo output. L'ID univoco dell'opzione di targeting assegnata. L'ID è univoco solo all'interno di una determinata risorsa e di un determinato tipo di targeting. Potrebbe 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.
Informazioni dettagliate sull'opzione di targeting assegnata. È possibile compilare un solo campo nei dettagli, che deve corrispondere a targeting_type. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

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

object (AppCategoryAssignedTargetingOptionDetails)

Dettagli della categoria di app. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_APP_CATEGORY.
appDetails

object (AppAssignedTargetingOptionDetails)

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

object (UrlAssignedTargetingOptionDetails)

Dettagli URL. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_URL.
dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

object (AgeRangeAssignedTargetingOptionDetails)

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

object (RegionalLocationListAssignedTargetingOptionDetails)

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

object (ProximityLocationListAssignedTargetingOptionDetails)

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

object (GenderAssignedTargetingOptionDetails)

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

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

object (UserRewardedContentAssignedTargetingOptionDetails)

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

object (ParentalStatusAssignedTargetingOptionDetails)

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

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Dettagli della posizione in-stream dei contenuti. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_CONTENT_INSTREAM_POSITION.
contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

object (DeviceTypeAssignedTargetingOptionDetails)

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

object (AudienceGroupAssignedTargetingOptionDetails)

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

object (BrowserAssignedTargetingOptionDetails)

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

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

object (OnScreenPositionAssignedTargetingOptionDetails)

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

object (CarrierAndIspAssignedTargetingOptionDetails)

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

object (KeywordAssignedTargetingOptionDetails)

Dettagli delle parole chiave. Questo campo verrà compilato quando 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 possono essere assegnate.
negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Dettagli delle parole chiave. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

object (OperatingSystemAssignedTargetingOptionDetails)

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

object (DeviceMakeModelAssignedTargetingOptionDetails)

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

object (EnvironmentAssignedTargetingOptionDetails)

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

object (InventorySourceAssignedTargetingOptionDetails)

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

object (CategoryAssignedTargetingOptionDetails)

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

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

object (ViewabilityAssignedTargetingOptionDetails)

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

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

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Dettagli dello stato di venditore autorizzato. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

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

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

object (LanguageAssignedTargetingOptionDetails)

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

object (GeoRegionAssignedTargetingOptionDetails)

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

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

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

object (SensitiveCategoryAssignedTargetingOptionDetails)

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

Le categorie sensibili sono esclusioni di targeting. Se impostate, le esclusioni di categorie sensibili a livello di inserzionista vengono sempre applicate alla pubblicazione (anche se non sono visibili nelle impostazioni delle risorse). Le impostazioni delle risorse possono escludere categorie sensibili oltre alle esclusioni degli inserzionisti, ma non possono eseguirne l'override.
contentThemeExclusionDetails

object (ContentThemeAssignedTargetingOptionDetails)

Dettagli del tema dei contenuti. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

I temi dei contenuti sono esclusioni di targeting. Le esclusioni dei temi dei contenuti 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 il tema dei contenuti escluso oltre alle esclusioni degli inserzionisti.
exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Dettagli della permuta. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_EXCHANGE.
subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

object (PoiAssignedTargetingOptionDetails)

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

object (BusinessChainAssignedTargetingOptionDetails)

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

object (ContentDurationAssignedTargetingOptionDetails)

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

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

object (NativeContentPositionAssignedTargetingOptionDetails)

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

object (OmidAssignedTargetingOptionDetails)

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

object (AudioContentTypeAssignedTargetingOptionDetails)

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

object (ContentGenreAssignedTargetingOptionDetails)

Dettagli del genere dei contenuti. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_CONTENT_GENRE.
youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

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

object (YoutubeChannelAssignedTargetingOptionDetails)

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

object (SessionPositionAssignedTargetingOptionDetails)

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

object (LookalikeAudienceAssignedTargetingOptionDetails)

Dettagli sul segmento di pubblico simile. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_LOOKALIKE_AUDIENCE.
googleAudienceDetails

object (GoogleAudienceAssignedTargetingOptionDetails)

Dettagli sul pubblico Google. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_GOOGLE_AUDIENCE.
customListDetails

object (CustomListAssignedTargetingOptionDetails)

Dettagli dell'elenco personalizzato. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_CUSTOM_LIST.
combinedAudienceDetails

object (CombinedAudienceAssignedTargetingOptionDetails)

Dettagli del segmento di pubblico combinato. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_COMBINED_AUDIENCE.
firstPartyAndPartnerAudienceDetails

object (FirstPartyAndPartnerAudienceAssignedTargetingOptionDetails)

Dettagli sui segmenti di pubblico proprietari e dei partner. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_FIRST_PARTY_AND_PARTNER_AUDIENCE.
auctionPackageDetails

object (AuctionPackageAssignedTargetingOptionDetails)

Dettagli del pacchetto di aste. Questo campo viene compilato quando targetingType è TARGETING_TYPE_AUCTION_PACKAGE.
youtubeChannelPackDetails

object (YoutubeChannelPackAssignedTargetingOptionDetails)

Dettagli del pacchetto di canali YouTube. Questo campo verrà compilato quando targetingType è TARGETING_TYPE_YOUTUBE_CHANNEL_PACK.
Fine dei campi che si escludono a vicenda.

Metodi

create

 Assegna un'opzione di targeting a un inserzionista.

delete

 Elimina un'opzione di targeting assegnata da un inserzionista.

get

 Recupera una singola opzione di targeting assegnata a un inserzionista.

list

 Elenca le opzioni di targeting assegnate a un inserzionista.