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)
  },
  "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. O tipo desta opção de segmentação.
Campo de união details. Informações detalhadas sobre as opções de segmentação. Somente um campo nos detalhes pode ser preenchido e precisa corresponder a targeting_type. details só pode ser um dos seguintes campos:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

Detalhes do rótulo de conteúdo digital.
sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

Detalhes da categoria sensível.
appCategoryDetails

object (AppCategoryTargetingOptionDetails)

Detalhes da categoria do app.
onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

Nos 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 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 do recurso 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 idioma.
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 ponto de interesse.
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. Esse valor 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. Um tipo enumerado para as camadas de brand safety do rótulo de conteúdo.

SensitiveCategoryTargetingOptionDetails

Representa uma categoria sensível segmentável. Esse valor 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. Um tipo enumerado para o classificador de conteúdo da categoria sensível do DV360.

AppCategoryTargetingOptionDetails

Representa uma coleção segmentável de apps. 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 coletânea de apps.

OnScreenPositionTargetingOptionDetails

Representa uma posição na tela que pode ser segmentada, que pode ser usada por anúncios de display e em vídeo. Isso 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 de conteúdo out-stream 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 out-stream do conteúdo.

ContentInstreamPositionTargetingOptionDetails

Representa uma posição in-stream de conteúdo segmentável, que pode ser usada por anúncios em vídeo e áudio. Isso 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 do conteúdo no stream.

VideoPlayerSizeTargetingOptionDetails

Representa um tamanho de player de vídeo segmentável. Isso 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. Esse valor 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. Esse valor 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. 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. Esse valor 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 que é 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. 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 é uma operadora ou um 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. Esse valor 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. Esse valor 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. Esse valor 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. Esse valor 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 que pode ser segmentado. 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, "Ontario, Canadá").
geoRegionType

enum (GeoRegionType)

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

ExchangeTargetingOptionDetails

Representa uma troca segmentável. Esse valor 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 subexchange segmentável. Esse valor 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 subcorretora.

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 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 PDI (por exemplo, "Times Square", "Space Needle"), seguido do endereço completo, se disponível.

BusinessChainTargetingOptionDetails

Representa uma cadeia de negócios 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 de 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 stream 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 o 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 o 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. Isso 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.