REST Resource: targetingTypes.targetingOptions

Recurso: TargetingOption

Representa una opción de segmentación única, que es un concepto que se puede orientar en DV360.

Representación 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

Solo salida. El nombre del recurso para esta opción de segmentación.

targetingOptionId

string

Solo salida. Es un identificador único para esta opción de orientación. La tupla {targetingType, targetingOptionId} será única.

targetingType

enum (TargetingType)

Solo salida. Es el tipo de esta opción de segmentación.

Campo de unión details. Información detallada sobre las opciones de segmentación. Solo se puede completar un campo en los detalles, que debe corresponder a targeting_type. details solo puede ser una de las siguientes opciones:
digitalContentLabelDetails

object (DigitalContentLabelTargetingOptionDetails)

Detalles de la etiqueta de contenido digital

sensitiveCategoryDetails

object (SensitiveCategoryTargetingOptionDetails)

Detalles de la categoría sensible.

appCategoryDetails

object (AppCategoryTargetingOptionDetails)

Detalles de la categoría de app

onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

Detalles de la posición en la pantalla

contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Detalles de la posición de outstream del contenido

contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Detalles de la posición del contenido in-stream

videoPlayerSizeDetails

object (VideoPlayerSizeTargetingOptionDetails)

Detalles del tamaño del reproductor de video

ageRangeDetails

object (AgeRangeTargetingOptionDetails)

Detalles del rango de edad.

parentalStatusDetails

object (ParentalStatusTargetingOptionDetails)

Detalles del estado parental.

userRewardedContentDetails

object (UserRewardedContentTargetingOptionDetails)

Detalles del contenido recompensado del usuario

householdIncomeDetails

object (HouseholdIncomeTargetingOptionDetails)

Detalles del ingreso familiar.

genderDetails

object (GenderTargetingOptionDetails)

Detalles del género

deviceTypeDetails

object (DeviceTypeTargetingOptionDetails)

Detalles del tipo de dispositivo.

browserDetails

object (BrowserTargetingOptionDetails)

Detalles del navegador

carrierAndIspDetails

object (CarrierAndIspTargetingOptionDetails)

Detalles del ISP y el operador.

environmentDetails

object (EnvironmentTargetingOptionDetails)

Detalles del entorno.

operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

Detalles de los recursos del sistema operativo.

deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

Detalles de los recursos de marca y modelo del dispositivo

viewabilityDetails

object (ViewabilityTargetingOptionDetails)

Detalles del recurso de visibilidad

categoryDetails

object (CategoryTargetingOptionDetails)

Detalles del recurso de categoría.

languageDetails

object (LanguageTargetingOptionDetails)

Detalles del recurso de idioma.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusTargetingOptionDetails)

Detalles del recurso de estado del vendedor autorizado

geoRegionDetails

object (GeoRegionTargetingOptionDetails)

Detalles de los recursos de la región geográfica.

exchangeDetails

object (ExchangeTargetingOptionDetails)

Detalles de Exchange.

subExchangeDetails

object (SubExchangeTargetingOptionDetails)

Detalles del intercambio secundario.

poiDetails

object (PoiTargetingOptionDetails)

Detalles del recurso de lugares de interés

businessChainDetails

object (BusinessChainTargetingOptionDetails)

Detalles de los recursos de la cadena de negocios

contentDurationDetails

object (ContentDurationTargetingOptionDetails)

Detalles del recurso de duración del contenido.

contentStreamTypeDetails

object (ContentStreamTypeTargetingOptionDetails)

Detalles del recurso del tipo de transmisión de contenido.

nativeContentPositionDetails

object (NativeContentPositionTargetingOptionDetails)

Detalles de la posición del contenido nativo

omidDetails

object (OmidTargetingOptionDetails)

Detalles del inventario habilitado de Open Measurement.

audioContentTypeDetails

object (AudioContentTypeTargetingOptionDetails)

Detalles del tipo de contenido de audio.

contentGenreDetails

object (ContentGenreTargetingOptionDetails)

Detalles del recurso de género del contenido.

DigitalContentLabelTargetingOptionDetails

Representa un nivel de calificación de etiquetas de contenido digital que se puede orientar. Se completará en el campo digitalContentLabelDetails de la opción de segmentación cuando targetingType sea TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Representación JSON
{
  "contentRatingTier": enum (ContentRatingTier)
}
Campos
contentRatingTier

enum (ContentRatingTier)

Solo salida. Una enumeración para los niveles de seguridad de la marca de la etiqueta de contenido.

SensitiveCategoryTargetingOptionDetails

Representa una categoría sensible que se puede orientar. Se completará en el campo sensitiveCategoryDetails de la opción de segmentación cuando targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Representación JSON
{
  "sensitiveCategory": enum (SensitiveCategory)
}
Campos
sensitiveCategory

enum (SensitiveCategory)

Solo salida. Una enumeración para el clasificador de contenido de la categoría sensible de DV360.

AppCategoryTargetingOptionDetails

Representa una colección de apps que se puede orientar. Una colección te permite orientar grupos dinámicos de apps relacionadas que mantiene la plataforma, por ejemplo, All Apps/Google Play/Games. Se completará en el campo appCategoryDetails cuando targetingType sea TARGETING_TYPE_APP_CATEGORY.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. Es el nombre de la colección de apps.

OnScreenPositionTargetingOptionDetails

Representa una posición que se puede orientar en la pantalla, que podría utilizarse en los anuncios gráficos y de video. Se completará en el campo onScreenPositionDetails cuando targetingType sea TARGETING_TYPE_ON_SCREEN_POSITION.

Representación JSON
{
  "onScreenPosition": enum (OnScreenPosition)
}
Campos
onScreenPosition

enum (OnScreenPosition)

Solo salida. Es la posición en pantalla.

ContentOutstreamPositionTargetingOptionDetails

Representa una posición outstream de contenido que se puede orientar, que podría usarse en anuncios gráficos y de video. Se completará en el campo contentOutstreamPositionDetails cuando targetingType sea TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Representación JSON
{
  "contentOutstreamPosition": enum (ContentOutstreamPosition)
}
Campos
contentOutstreamPosition

enum (ContentOutstreamPosition)

Solo salida. Es la posición de out-stream del contenido.

ContentInstreamPositionTargetingOptionDetails

Representa una posición in-stream de contenido que se puede orientar, que podría utilizarse en los anuncios de audio y video. Se completará en el campo contentInstreamPositionDetails cuando targetingType sea TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Representación JSON
{
  "contentInstreamPosition": enum (ContentInstreamPosition)
}
Campos
contentInstreamPosition

enum (ContentInstreamPosition)

Solo salida. Es la posición in-stream del contenido.

VideoPlayerSizeTargetingOptionDetails

Representa un tamaño de reproductor de video que se puede orientar. Se completará en el campo videoPlayerSizeDetails cuando targetingType sea TARGETING_TYPE_VIDEO_PLAYER_SIZE.

Representación JSON
{
  "videoPlayerSize": enum (VideoPlayerSize)
}
Campos
videoPlayerSize

enum (VideoPlayerSize)

Solo salida. El tamaño del reproductor de video.

AgeRangeTargetingOptionDetails

Representa un rango de edad al que se puede orientar. Se completará en el campo ageRangeDetails cuando targetingType sea TARGETING_TYPE_AGE_RANGE.

Representación JSON
{
  "ageRange": enum (AgeRange)
}
Campos
ageRange

enum (AgeRange)

Solo salida. Indica el rango etario del público.

ParentalStatusTargetingOptionDetails

Representa un estado parental al que se puede orientar. Se completará en el campo parentalStatusDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_PARENTAL_STATUS.

Representación JSON
{
  "parentalStatus": enum (ParentalStatus)
}
Campos
parentalStatus

enum (ParentalStatus)

Solo salida. Es el estado parental de un público.

UserRewardedContentTargetingOptionDetails

Representa el estado del contenido recompensado de un usuario que puede segmentarse únicamente en el caso de los anuncios de video. Se completará en el campo userRewardedContentDetails cuando targetingType sea TARGETING_TYPE_USER_REWARDED_CONTENT.

Representación JSON
{
  "userRewardedContent": enum (UserRewardedContent)
}
Campos
userRewardedContent

enum (UserRewardedContent)

Solo salida. Estado del contenido recompensado del usuario para los anuncios de video.

HouseholdIncomeTargetingOptionDetails

Representa un ingreso familiar objetivo. Se completará en el campo householdIncomeDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_HOUSEHOLD_INCOME.

Representación JSON
{
  "householdIncome": enum (HouseholdIncome)
}
Campos
householdIncome

enum (HouseholdIncome)

Solo salida. Ingreso familiar de un público.

GenderTargetingOptionDetails

Representa un género al que se puede orientar. Se completará en el campo genderDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_GENDER.

Representación JSON
{
  "gender": enum (Gender)
}
Campos
gender

enum (Gender)

Solo salida. Indica el género del público.

DeviceTypeTargetingOptionDetails

Representa un tipo de dispositivo que se puede orientar. Se completará en el campo deviceTypeDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_DEVICE_TYPE.

Representación JSON
{
  "deviceType": enum (DeviceType)
}
Campos
deviceType

enum (DeviceType)

Solo salida. Es el tipo de dispositivo que se usará para la segmentación.

BrowserTargetingOptionDetails

Representa un navegador al que se puede orientar. Se completará en el campo browserDetails cuando targetingType sea TARGETING_TYPE_BROWSER.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. Indica el nombre visible del navegador.

CarrierAndIspTargetingOptionDetails

Representa un operador orientable o un ISP. Se completará en el campo carrierAndIspDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_CARRIER_AND_ISP.

Representación JSON
{
  "displayName": string,
  "type": enum (CarrierAndIspType)
}
Campos
displayName

string

Solo salida. Es el nombre visible del operador o del ISP.

type

enum (CarrierAndIspType)

Solo salida. Es el tipo que indica si es un operador o un ISP.

CarrierAndIspType

Es el tipo de CarrierAndIspTargetingOption.

Enumeraciones
CARRIER_AND_ISP_TYPE_UNSPECIFIED Valor predeterminado cuando el tipo no se especifica o se desconoce en esta versión.
CARRIER_AND_ISP_TYPE_ISP Indica que este recurso de segmentación hace referencia a un ISP.
CARRIER_AND_ISP_TYPE_CARRIER Indica que este recurso de segmentación hace referencia a un operador de telefonía celular.

EnvironmentTargetingOptionDetails

Representa un entorno objetivo. Se completará en el campo environmentDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_ENVIRONMENT.

Representación JSON
{
  "environment": enum (Environment)
}
Campos
environment

enum (Environment)

Solo salida. El entorno de entrega.

OperatingSystemTargetingOptionDetails

Representa un sistema operativo objetivo. Se completará en el campo operatingSystemDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_OPERATING_SYSTEM.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. El nombre visible del sistema operativo.

DeviceMakeModelTargetingOptionDetails

Representa la marca y el modelo de un dispositivo que se puede orientar. Se completará en el campo deviceMakeModelDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_DEVICE_MAKE_MODEL.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. El nombre visible de la marca y el modelo del dispositivo

ViewabilityTargetingOptionDetails

Representa una visibilidad que se puede orientar. Se completará en el campo viewabilityDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_VIEWABILITY.

Representación JSON
{
  "viewability": enum (Viewability)
}
Campos
viewability

enum (Viewability)

Solo salida. Es el porcentaje de visibilidad previsto.

CategoryTargetingOptionDetails

Representa una categoría que se puede orientar. Se completará en el campo categoryDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_CATEGORY.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. El nombre visible de la categoría.

LanguageTargetingOptionDetails

Representa un idioma de segmentación. Se completará en el campo languageDetails cuando targetingType sea TARGETING_TYPE_LANGUAGE.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. Es el nombre visible del idioma (p.ej., "francés").

AuthorizedSellerStatusTargetingOptionDetails

Representa un estado de vendedor autorizado que se puede orientar. Se completará en el campo authorizedSellerStatusDetails cuando targetingType sea TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Representación JSON
{
  "authorizedSellerStatus": enum (AuthorizedSellerStatus)
}
Campos
authorizedSellerStatus

enum (AuthorizedSellerStatus)

Solo salida. Indica el estado del vendedor autorizado.

GeoRegionTargetingOptionDetails

Representa una región geográfica a la que se pueden orientar anuncios. Se completará en el campo geoRegionDetails cuando targetingType sea TARGETING_TYPE_GEO_REGION.

Representación JSON
{
  "displayName": string,
  "geoRegionType": enum (GeoRegionType)
}
Campos
displayName

string

Solo salida. Es el nombre visible de la región geográfica (p.ej., “Ontario, Canadá”).

geoRegionType

enum (GeoRegionType)

Solo salida. Es el tipo de segmentación por región geográfica.

ExchangeTargetingOptionDetails

Representa un intercambio orientable. Se completará en el campo exchangeDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_EXCHANGE.

Representación JSON
{
  "exchange": enum (Exchange)
}
Campos
exchange

enum (Exchange)

Solo salida. Es el tipo de intercambio.

SubExchangeTargetingOptionDetails

Representa un subintercambio que se puede orientar. Se completará en el campo subExchangeDetails de una opción de segmentación cuando targetingType sea TARGETING_TYPE_SUB_EXCHANGE.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. El nombre visible del intercambio secundario.

PoiTargetingOptionDetails

Representa un lugar de interés que se puede orientar. Se completará en el campo poiDetails cuando targetingType sea TARGETING_TYPE_POI.

Representación JSON
{
  "latitude": number,
  "longitude": number,
  "displayName": string
}
Campos
latitude

number

Solo salida. La latitud del lugar de interés se redondea al sexto decimal.

longitude

number

Solo salida. Es la longitud del lugar de interés que se redondea al sexto decimal.

displayName

string

Solo salida. Indica el nombre visible de un lugar de interés(p.ej., "Times Square" o "Space Needle"), seguido de su dirección completa, si está disponible.

BusinessChainTargetingOptionDetails

Representa una cadena de empresas a la que se puede orientar dentro de una región geográfica. Se completará en el campo businessChainDetails cuando targetingType sea TARGETING_TYPE_BUSINESS_CHAIN.

Representación JSON
{
  "businessChain": string,
  "geoRegion": string,
  "geoRegionType": enum (GeoRegionType)
}
Campos
businessChain

string

Solo salida. El nombre visible de la cadena de la empresa, p.ej., “KFC” o “Chase Bank”.

geoRegion

string

Solo salida. El nombre visible de la región geográfica, p.ej., “Ontario, Canadá”.

geoRegionType

enum (GeoRegionType)

Solo salida. Es el tipo de región geográfica.

ContentDurationTargetingOptionDetails

Representa una duración de contenido orientable. Se completará en el campo contentDurationDetails cuando targetingType sea TARGETING_TYPE_CONTENT_DURATION.

Representación JSON
{
  "contentDuration": enum (ContentDuration)
}
Campos
contentDuration

enum (ContentDuration)

Solo salida. Es la duración del contenido.

ContentStreamTypeTargetingOptionDetails

Representa un tipo de transmisión de contenido que se puede orientar. Se completará en el campo contentStreamTypeDetails cuando targetingType sea TARGETING_TYPE_CONTENT_STREAM_TYPE.

Representación JSON
{
  "contentStreamType": enum (ContentStreamType)
}
Campos
contentStreamType

enum (ContentStreamType)

Solo salida. Es el tipo de transmisión del contenido.

NativeContentPositionTargetingOptionDetails

Representa una posición de contenido nativo que se puede orientar. Se completará en el campo nativeContentPositionDetails cuando targetingType sea TARGETING_TYPE_NATIVE_CONTENT_POSITION.

Representación JSON
{
  "contentPosition": enum (NativeContentPosition)
}
Campos
contentPosition

enum (NativeContentPosition)

Solo salida. Es la posición del contenido.

OmidTargetingOptionDetails

Representa un tipo de inventario habilitado de Open Measurement que se puede orientar. Se completará en el campo omidDetails cuando targetingType sea TARGETING_TYPE_OMID.

Representación JSON
{
  "omid": enum (Omid)
}
Campos
omid

enum (Omid)

Solo salida. Es el tipo de inventario habilitado de Open Measurement.

AudioContentTypeTargetingOptionDetails

Representa un tipo de contenido de audio orientable. Se completará en el campo audioContentTypeDetails cuando targetingType sea TARGETING_TYPE_AUDIO_CONTENT_TYPE.

Representación JSON
{
  "audioContentType": enum (AudioContentType)
}
Campos
audioContentType

enum (AudioContentType)

Solo salida. Es el tipo de contenido de audio.

ContentGenreTargetingOptionDetails

Representa un género de contenido al que se puede orientar. Se completará en el campo contentGenreDetails cuando targetingType sea TARGETING_TYPE_CONTENT_GENRE.

Representación JSON
{
  "displayName": string
}
Campos
displayName

string

Solo salida. El nombre visible del género del contenido

Métodos

get

Obtiene una opción de segmentación única.

list

Muestra las opciones de segmentación de un tipo determinado.
Busca opciones de segmentación de un tipo determinado según los términos de búsqueda especificados.