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 esta 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á exclusiva.
targetingType

enum (TargetingType)

Apenas saída. 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 "Detalhes" pode ser preenchido e precisa corresponder a targeting_type. details pode ser apenas uma das seguintes opções:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

Detalhes do rótulo 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 do conteúdo outstream.
contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Detalhes da posição do conteúdo no stream.
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 do 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 do recurso do modelo e marca do dispositivo.
viewabilityDetails

object (ViewabilityTargetingOptionDetails)

Detalhes do recurso de visibilidade.
categoryDetails

object (CategoryTargetingOptionDetails)

Detalhes do recurso da categoria.
languageDetails

object (LanguageTargetingOptionDetails)

Detalhes do recurso de idioma.
authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

Detalhes do recurso de status de vendedor autorizado.
geoRegionDetails

object (GeoRegionTargetingOptionDetails)

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

object (ExchangeTargetingOptionDetails)

Trocar detalhes.
subExchangeDetails

object (SubExchangeTargetingOptionDetails)

Detalhes da subtroca.
poiDetails

object (PoiTargetingOptionDetails)

Detalhes do recurso de PDI.
businessChainDetails

object (BusinessChainTargetingOptionDetails)

Detalhes do recurso da cadeia de negócios.
contentDurationDetails

object (ContentDurationTargetingOptionDetails)

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

object (ContentStreamTypeTargetingOptionDetails)

Detalhes do recurso do tipo de stream de conteúdo.
nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

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

object (OmidTargetingOptionDetails)

Detalhes do inventário com o Open Measurement ativado.
audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

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

object (ContentGenreTargetingOptionDetails)

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

DigitalContentLabelTargetingOptionDetails

Representa um nível de classificação do rótulo de conteúdo digital segmentável. Isso será preenchido no campo digitalContentLabelDetails da 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 do rótulo de conteúdo.

SensitiveCategoryTargetingOptionDetails

Representa uma categoria sensível segmentável. Isso será preenchido no campo sensitiveCategoryDetails da 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 de categoria sensível do DV360.

ContentThemeTargetingOptionDetails

Representa um tema de conteúdo segmentável. Isso será preenchido no campo contentThemeDetails da 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 de conteúdo do DV360.

AppCategoryTargetingOptionDetails

Representa uma coleção segmentável de aplicativos. Uma coleção permite segmentar grupos dinâmicos de apps relacionados que são mantidos pela plataforma, por exemplo, All Apps/Google Play/Games. Esse campo 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 segmentável na tela, que pode ser usada por anúncios de display e em vídeo. Esse campo 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. Esse campo 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 segmentável de conteúdo que pode ser usada por anúncios em vídeo e áudio. Esse campo 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 in-stream do conteúdo.

VideoPlayerSizeTargetingOptionDetails

Representa um tamanho de player de vídeo segmentável. Esse campo 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. Esse campo 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. Isso 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 que pode ser segmentado pelo usuário apenas para anúncios em vídeo. Esse campo 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. Isso 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 sexo segmentável. Isso 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. Isso 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 ser segmentado.

BrowserTargetingOptionDetails

Representa um navegador segmentável. Esse campo 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 ISP segmentável. Isso 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 é da operadora ou do ISP.

CarrierAndIspType

Tipo de CarrierAndIsp TargetingOption.

Enums
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 este recurso de segmentação se refere a um ISP.
CARRIER_AND_ISP_TYPE_CARRIER Indica que este recurso de segmentação se refere a uma operadora de celular.

EnvironmentTargetingOptionDetails

Representa um ambiente segmentável. Isso 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. Isso 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ável. Isso 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. Isso 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. Isso 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. Esse campo 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. Esse campo 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. Esse campo 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, "Ontario, Canadá").
geoRegionType

enum (GeoRegionType)

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

ExchangeTargetingOptionDetails

Representa uma troca segmentável. Isso 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. Isso 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 subtroca.

PoiTargetingOptionDetails

Representa um ponto de interesse(PDI) segmentável. Esse campo 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 ponto de interesse arredondado para a sexta casa decimal.
longitude

number

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

string

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

BusinessChainTargetingOptionDetails

Representa uma rede de negócios segmentável em uma região geográfica. Esse campo 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 negócios, 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 de região geográfica.

ContentDurationTargetingOptionDetails

Representa uma duração de conteúdo segmentável. Esse campo 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 fluxo de conteúdo segmentável. Esse campo 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. Esse campo 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 o Open Measurement ativado. Esse campo 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 o Open Measurement ativado.

AudioContentTypeTargetingOptionDetails

Representa um tipo de conteúdo de áudio segmentável. Esse campo 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. Esse campo 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 do 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.
Procura opções de segmentação de um determinado tipo com base nos termos de pesquisa informados.