REST Resource: targetingTypes.targetingOptions

Recurso: TargetingOption

Representa uma única opção de segmentação, que é um conceito segmentável no DV360.

Representação JSON 
{
  "name": string,
  "targetingOptionId": string,
  "targetingType": enum (TargetingType),

  // Union field details can be only one of the following:
  "digitalContentLabelDetails": {
    object (DigitalContentLabelTargetingOptionDetails)
  },
  "sensitiveCategoryDetails": {
    object (SensitiveCategoryTargetingOptionDetails)
  },
  "contentThemeDetails": {
    object (ContentThemeTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Campos
name

string

Apenas saída. O nome do recurso para essa opção de segmentação.
targetingOptionId

string

Apenas saída. Um identificador exclusivo para essa opção de segmentação. A tupla {targetingType, targetingOptionId} será única.
targetingType

enum (TargetingType)

Apenas saída. O tipo dessa opção de segmentação.
Campo de união details. Informações detalhadas sobre as opções de segmentação. Apenas um campo em "details" pode ser preenchido, e ele precisa corresponder a targeting_type. details pode ser apenas uma das seguintes opções:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

Detalhes da classificação de conteúdo digital.
sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

Detalhes da categoria sensível.
contentThemeDetails

object (ContentThemeTargetingOptionDetails)

Detalhes do tema do conteúdo.
appCategoryDetails

object (AppCategoryTargetingOptionDetails)

Detalhes da categoria do app.
onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

Detalhes da posição na tela.
contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Detalhes da posição outstream do conteúdo.
contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Detalhes da posição instream do conteúdo.
videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

Detalhes do tamanho do player de vídeo.
ageRangeDetails

object (AgeRangeTargetingOptionDetails)

Detalhes da faixa etária.
parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

Detalhes do status parental.
userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

Detalhes do conteúdo com prêmio para o usuário.
householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

Detalhes da renda familiar.
genderDetails

object (GenderTargetingOptionDetails)

Detalhes de gênero.
deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

Detalhes do tipo de dispositivo.
browserDetails

object (BrowserTargetingOptionDetails)

Detalhes do navegador.
carrierAndIspDetails

object (CarrierAndIspTargetingOptionDetails)

Detalhes da operadora e do ISP.
environmentDetails

object (EnvironmentTargetingOptionDetails)

Detalhes do ambiente.
operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

Detalhes dos recursos do sistema operacional.
deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

Detalhes de recursos de marca e modelo do dispositivo.
viewabilityDetails

object (ViewabilityTargetingOptionDetails)

Detalhes do recurso de visibilidade.
categoryDetails

object (CategoryTargetingOptionDetails)

Detalhes do recurso de categoria.
languageDetails

object (LanguageTargetingOptionDetails)

Detalhes do recurso de linguagem.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

Detalhes do recurso de status do vendedor autorizado.
geoRegionDetails

object (GeoRegionTargetingOptionDetails)

Detalhes do recurso de região geográfica.
exchangeDetails

object (ExchangeTargetingOptionDetails)

Detalhes da troca.
subExchangeDetails

object (SubExchangeTargetingOptionDetails)

Detalhes da subtroca.
poiDetails

object (PoiTargetingOptionDetails)

Detalhes do recurso de PDI.
businessChainDetails

object (BusinessChainTargetingOptionDetails)

Detalhes do recurso da rede de empresas.
contentDurationDetails

object (ContentDurationTargetingOptionDetails)

Detalhes do recurso de duração do conteúdo.
contentStreamTypeDetails

object (ContentStreamTypeTargetingOptionDetails)

Detalhes do recurso de tipo de transmissão de conteúdo.
nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

Detalhes da posição do conteúdo nativo.
omidDetails

object (OmidTargetingOptionDetails)

Detalhes do inventário com Open Measurement ativado.
audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

Detalhes do tipo de conteúdo de áudio.
contentGenreDetails

object (ContentGenreTargetingOptionDetails)

Detalhes do recurso de gênero de conteúdo.

DigitalContentLabelTargetingOptionDetails

Representa um nível de classificação de conteúdo digital segmentável. Ele será preenchido no campo digitalContentLabelDetails de TargetingOption quando targetingType for TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Representação JSON 
{
  "contentRatingTier": enum (ContentRatingTier)
}
Campos
contentRatingTier

enum (ContentRatingTier)

Apenas saída. Uma enumeração para as camadas de brand safety da classificação de conteúdo.

SensitiveCategoryTargetingOptionDetails

Representa uma categoria sensível segmentável. Ele será preenchido no campo sensitiveCategoryDetails de TargetingOption quando targetingType for TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Representação JSON 
{
  "sensitiveCategory": enum (SensitiveCategory)
}
Campos
sensitiveCategory

enum (SensitiveCategory)

Apenas saída. Uma enumeração para o classificador de conteúdo da categoria sensível do DV360.

ContentThemeTargetingOptionDetails

Representa um tema de conteúdo segmentável. Ele será preenchido no campo contentThemeDetails de TargetingOption quando targetingType for TARGETING_TYPE_CONTENT_THEME_EXCLUSION.

Representação JSON 
{
  "contentTheme": enum (ContentTheme)
}
Campos
contentTheme

enum (ContentTheme)

Apenas saída. Uma enumeração para o classificador de conteúdo de tema do DV360.

AppCategoryTargetingOptionDetails

Representa uma coleção de apps segmentáveis. Com uma coleção, você pode segmentar grupos dinâmicos de apps relacionados mantidos pela plataforma, por exemplo, All Apps/Google Play/Games. Ele será preenchido no campo appCategoryDetails quando targetingType for TARGETING_TYPE_APP_CATEGORY.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome da coleção de apps.

OnScreenPositionTargetingOptionDetails

Representa uma posição na tela segmentável, que pode ser usada por anúncios de display e em vídeo. Ele será preenchido no campo onScreenPositionDetails quando targetingType for TARGETING_TYPE_ON_SCREEN_POSITION.

Representação JSON 
{
  "onScreenPosition": enum (OnScreenPosition)
}
Campos
onScreenPosition

enum (OnScreenPosition)

Apenas saída. A posição na tela.

ContentOutstreamPositionTargetingOptionDetails

Representa uma posição out-stream de conteúdo segmentável, que pode ser usada por anúncios de display e em vídeo. Ele será preenchido no campo contentOutstreamPositionDetails quando targetingType for TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Representação JSON 
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
Campos
contentOutstreamPosition

enum (ContentOutstreamPosition)

Apenas saída. A posição do conteúdo outstream.

ContentInstreamPositionTargetingOptionDetails

Representa uma posição in-stream de conteúdo segmentável, que pode ser usada por anúncios em vídeo e áudio. Ele será preenchido no campo contentInstreamPositionDetails quando targetingType for TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Representação JSON 
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
Campos
contentInstreamPosition

enum (ContentInstreamPosition)

Apenas saída. A posição instream do conteúdo.

VideoPlayerSizeTargetingOptionDetails

Representa um tamanho de player de vídeo segmentável. Ele será preenchido no campo videoPlayerSizeDetails quando targetingType for TARGETING_TYPE_VIDEO_PLAYER_SIZE.

Representação JSON 
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Campos
videoPlayerSize

enum (VideoPlayerSize)

Apenas saída. O tamanho do player de vídeo.

AgeRangeTargetingOptionDetails

Representa uma faixa etária segmentável. Ele será preenchido no campo ageRangeDetails quando targetingType for TARGETING_TYPE_AGE_RANGE.

Representação JSON 
{
  "ageRange": enum (AgeRange)
}
Campos
ageRange

enum (AgeRange)

Apenas saída. A faixa etária de um público-alvo.

ParentalStatusTargetingOptionDetails

Representa um status parental segmentável. Ele será preenchido no campo parentalStatusDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_PARENTAL_STATUS.

Representação JSON 
{
  "parentalStatus": enum (ParentalStatus)
}
Campos
parentalStatus

enum (ParentalStatus)

Apenas saída. O status parental de um público-alvo.

UserRewardedContentTargetingOptionDetails

Representa um status de conteúdo premiado do usuário segmentável apenas para anúncios em vídeo. Ele será preenchido no campo userRewardedContentDetails quando targetingType for TARGETING_TYPE_USER_REWARDED_CONTENT.

Representação JSON 
{
  "userRewardedContent": enum (UserRewardedContent)
}
Campos
userRewardedContent

enum (UserRewardedContent)

Apenas saída. Status do conteúdo com prêmio para o usuário em anúncios em vídeo.

HouseholdIncomeTargetingOptionDetails

Representa uma renda familiar segmentável. Ele será preenchido no campo householdIncomeDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_HOUSEHOLD_INCOME.

Representação JSON 
{
  "householdIncome": enum (HouseholdIncome)
}
Campos
householdIncome

enum (HouseholdIncome)

Apenas saída. A renda familiar de um público-alvo.

GenderTargetingOptionDetails

Representa um gênero segmentável. Ele será preenchido no campo genderDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_GENDER.

Representação JSON 
{
  "gender": enum (Gender)
}
Campos
gender

enum (Gender)

Apenas saída. O gênero de um público-alvo.

DeviceTypeTargetingOptionDetails

Representa um tipo de dispositivo segmentável. Ele será preenchido no campo deviceTypeDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_DEVICE_TYPE.

Representação JSON 
{
  "deviceType": enum (DeviceType)
}
Campos
deviceType

enum (DeviceType)

Apenas saída. O tipo de dispositivo usado para segmentação.

BrowserTargetingOptionDetails

Representa um navegador segmentável. Ele será preenchido no campo browserDetails quando targetingType for TARGETING_TYPE_BROWSER.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome de exibição do navegador.

CarrierAndIspTargetingOptionDetails

Representa uma operadora ou um ISP segmentável. Ele será preenchido no campo carrierAndIspDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_CARRIER_AND_ISP.

Representação JSON 
{
  "displayName": string,
  "type": enum (CarrierAndIspType)
}
Campos
displayName

string

Apenas saída. O nome de exibição da operadora ou do ISP.
type

enum (CarrierAndIspType)

Apenas saída. O tipo que indica se é uma operadora ou um ISP.

CarrierAndIspType

Tipo de CarrierAndIspTargetingOption.

Tipos enumerados
CARRIER_AND_ISP_TYPE_UNSPECIFIED Valor padrão quando o tipo não é especificado ou é desconhecido nesta versão.
CARRIER_AND_ISP_TYPE_ISP Indica que esse recurso de segmentação se refere a um ISP.
CARRIER_AND_ISP_TYPE_CARRIER Indica que esse recurso de segmentação se refere a uma operadora de celular.

EnvironmentTargetingOptionDetails

Representa um ambiente segmentável. Ele será preenchido no campo environmentDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_ENVIRONMENT.

Representação JSON 
{
  "environment": enum (Environment)
}
Campos
environment

enum (Environment)

Apenas saída. O ambiente de veiculação.

OperatingSystemTargetingOptionDetails

Representa um sistema operacional segmentável. Ele será preenchido no campo operatingSystemDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_OPERATING_SYSTEM.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome de exibição do sistema operacional.

DeviceMakeModelTargetingOptionDetails

Representa uma marca e um modelo de dispositivo segmentáveis. Ele será preenchido no campo deviceMakeModelDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_DEVICE_MAKE_MODEL.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome de exibição da marca e do modelo do dispositivo.

ViewabilityTargetingOptionDetails

Representa uma visibilidade segmentável. Ele será preenchido no campo viewabilityDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_VIEWABILITY.

Representação JSON 
{
  "viewability": enum (Viewability)
}
Campos
viewability

enum (Viewability)

Apenas saída. A porcentagem de visibilidade prevista.

CategoryTargetingOptionDetails

Representa uma categoria segmentável. Ele será preenchido no campo categoryDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_CATEGORY.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome de exibição da categoria.

LanguageTargetingOptionDetails

Representa um idioma segmentável. Ele será preenchido no campo languageDetails quando targetingType for TARGETING_TYPE_LANGUAGE.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome de exibição do idioma (por exemplo, "Francês").

AuthorizedSellerStatusTargetingOptionDetails

Representa um status de vendedor autorizado segmentável. Ele será preenchido no campo authorizedSellerStatusDetails quando targetingType for TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Representação JSON 
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
Campos
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Apenas saída. O status do vendedor autorizado.

GeoRegionTargetingOptionDetails

Representa uma região geográfica segmentável. Ele será preenchido no campo geoRegionDetails quando targetingType for TARGETING_TYPE_GEO_REGION.

Representação JSON 
{
  "displayName": string,
  "geoRegionType": enum (GeoRegionType)
}
Campos
displayName

string

Apenas saída. O nome de exibição da região geográfica (por exemplo, "Ontário, Canadá").
geoRegionType

enum (GeoRegionType)

Apenas saída. O tipo de segmentação por região geográfica.

ExchangeTargetingOptionDetails

Representa uma troca segmentável. Ele será preenchido no campo exchangeDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_EXCHANGE.

Representação JSON 
{
  "exchange": enum (Exchange)
}
Campos
exchange

enum (Exchange)

Apenas saída. O tipo de troca.

SubExchangeTargetingOptionDetails

Representa uma subtroca segmentável. Ele será preenchido no campo subExchangeDetails de uma TargetingOption quando targetingType for TARGETING_TYPE_SUB_EXCHANGE.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome de exibição da subexchange.

PoiTargetingOptionDetails

Representa um ponto de interesse(PDI) segmentável. Ele será preenchido no campo poiDetails quando targetingType for TARGETING_TYPE_POI.

Representação JSON 
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
Campos
latitude

number

Apenas saída. Latitude do PDI arredondada para a sexta casa decimal.
longitude

number

Apenas saída. Longitude do PDI arredondada para a sexta casa decimal.
displayName

string

Apenas saída. O nome de exibição de um PDI(por exemplo, "Times Square", "Space Needle"), seguido do endereço completo, se disponível.

BusinessChainTargetingOptionDetails

Representa uma rede de empresas segmentável em uma região geográfica. Ele será preenchido no campo businessChainDetails quando targetingType for TARGETING_TYPE_BUSINESS_CHAIN.

Representação JSON 
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
Campos
businessChain

string

Apenas saída. O nome de exibição da rede de empresas, por exemplo, "KFC", "Chase Bank".
geoRegion

string

Apenas saída. O nome de exibição da região geográfica, por exemplo, "Ontário, Canadá".
geoRegionType

enum (GeoRegionType)

Apenas saída. O tipo da região geográfica.

ContentDurationTargetingOptionDetails

Representa uma duração de conteúdo segmentável. Ele será preenchido no campo contentDurationDetails quando targetingType for TARGETING_TYPE_CONTENT_DURATION.

Representação JSON 
{
  "contentDuration": enum (ContentDuration)
}
Campos
contentDuration

enum (ContentDuration)

Apenas saída. A duração do conteúdo.

ContentStreamTypeTargetingOptionDetails

Representa um tipo de stream de conteúdo segmentável. Ele será preenchido no campo contentStreamTypeDetails quando targetingType for TARGETING_TYPE_CONTENT_STREAM_TYPE.

Representação JSON 
{
  "contentStreamType": enum (ContentStreamType)
}
Campos
contentStreamType

enum (ContentStreamType)

Apenas saída. O tipo de transmissão de conteúdo.

NativeContentPositionTargetingOptionDetails

Representa uma posição de conteúdo nativo segmentável. Ele será preenchido no campo nativeContentPositionDetails quando targetingType for TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Representação JSON 
{
  "contentPosition": enum (NativeContentPosition)
}
Campos
contentPosition

enum (NativeContentPosition)

Apenas saída. A posição do conteúdo.

OmidTargetingOptionDetails

Representa um tipo de inventário segmentável com Open Measurement ativado. Ele será preenchido no campo omidDetails quando targetingType for TARGETING_TYPE_OMID.

Representação JSON 
{
  "omid": enum (Omid)
}
Campos
omid

enum (Omid)

Apenas saída. O tipo de inventário com Open Measurement ativado.

AudioContentTypeTargetingOptionDetails

Representa um tipo de conteúdo de áudio segmentável. Ele será preenchido no campo audioContentTypeDetails quando targetingType for TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Representação JSON 
{
  "audioContentType": enum (AudioContentType)
}
Campos
audioContentType

enum (AudioContentType)

Apenas saída. O tipo de conteúdo de áudio.

ContentGenreTargetingOptionDetails

Representa um gênero de conteúdo segmentável. Ele será preenchido no campo contentGenreDetails quando targetingType for TARGETING_TYPE_CONTENT_GENRE.

Representação JSON 
{
  "displayName": string
}
Campos
displayName

string

Apenas saída. O nome de exibição do gênero de conteúdo

Métodos

get

 Recebe uma única opção de segmentação.

list

 Lista as opções de segmentação de um determinado tipo.
Pesquisa opções de segmentação de um determinado tipo com base nos termos de pesquisa fornecidos.