REST Resource: targetingTypes.targetingOptions

Recurso: TargetOption

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á ú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. Só é possível preencher um campo detalhado, que deve corresponder a targeting_type. O valor details só pode ser de uma das seguintes opções:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

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

object (SensitiveCategoryTargetingOptionDetails)

Detalhes da categoria sensível.
appCategoryDetails

object (AppCategoryTargetingOptionDetails)

Detalhes da categoria do app.
onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

Detalhes de posição na tela.
contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Detalhes da posição out-stream do conteúdo
contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Detalhes da posição in-stream 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 premiado para o usuário
householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

Detalhes da renda familiar.
genderDetails

object (GenderTargetingOptionDetails)

Detalhes do sexo.
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 da 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 do vendedor autorizado.
geoRegionDetails

object (GeoRegionTargetingOptionDetails)

Detalhes do recurso da 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 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 de conteúdo.

DigitalContentLabelTargetingOptionDetails

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

AppCategoryTargetingOptionDetails

Representa uma coleção segmentável de apps. Com uma coleção, é possível segmentar grupos dinâmicos de apps relacionados que são mantidos pela plataforma, por exemplo, All Apps/Google Play/Games. Isso 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 do app.

OnScreenPositionTargetingOptionDetails

Representa uma posição segmentável na tela 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 out-stream de conteúdo segmentável que pode ser usada por anúncios de display e em vídeo. Isso 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 in-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. Isso 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 SegmentOption 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. Isso 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 premiado pelo usuário para anúncios em vídeo.

HouseholdIncomeTargetingOptionDetails

Representa uma renda familiar segmentável. Isso será preenchido no campo householdIncomeDetails de uma SegmentOption 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 SegmentOption 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 SegmentOption 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. Isso 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 SegmentOption 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 é a operadora ou o ISP.

CarrierAndIspType

Tipo de CarrierAndIspSegmentaçãoOption.

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 o recurso de segmentação se refere a um ISP.
CARRIER_AND_ISP_TYPE_CARRIER Indica que o 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 SegmentOption quando targetingType for TARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

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

OperatingSystemTargetingOptionDetails

Representa um sistema operacional segmentável. Isso será preenchido no campo operatingSystemDetails de uma SegmentOption 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 a marca e o modelo de um dispositivo segmentável. Isso será preenchido no campo deviceMakeModelDetails de uma SegmentOption 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 SegmentOption 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 SegmentOption 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. Isso 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 segmentável de vendedor autorizado. Isso 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. Isso 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. Isso será preenchido no campo exchangeDetails de uma SegmentOption 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 SegmentOption 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. Isso 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 com arredondamento para a 6a casa decimal.
longitude

number

Apenas saída. Longitude do PDI com arredondamento para a 6a casa decimal.
displayName

string

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

BusinessChainTargetingOptionDetails

Representa uma cadeia de negócios segmentável em uma região geográfica. Isso 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", "Banco do Chator".
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. Tipo de região geográfica.

ContentDurationTargetingOptionDetails

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

AudioContentTypeTargetingOptionDetails

Representa um tipo de conteúdo de áudio segmentável. Isso 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 fornecidos.