REST Resource: targetingTypes.targetingOptions

Recurso: TargetingOption

Representa una sola opción de segmentación, que es un concepto segmentable 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 segmentació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, y 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 la app

onScreenPositionDetails

object (OnScreenPositionTargetingOptionDetails)

Detalles de la posición en la pantalla

contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Detalles de la posición del contenido fuera del flujo

contentInstreamPositionDetails

object (ContentInstreamPositionTargetingOptionDetails)

Detalles de la posición in-stream del contenido

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 operador y el ISP

environmentDetails

object (EnvironmentTargetingOptionDetails)

Detalles del entorno.

operatingSystemDetails

object (OperatingSystemTargetingOptionDetails)

Detalles de los recursos del sistema operativo

deviceMakeModelDetails

object (DeviceMakeModelTargetingOptionDetails)

Detalles del recurso de la marca y el modelo del dispositivo

viewabilityDetails

object (ViewabilityTargetingOptionDetails)

Detalles del recurso de visibilidad

categoryDetails

object (CategoryTargetingOptionDetails)

Detalles del recurso de la 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 lugar 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 de 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 clasificación de etiquetas de contenido digital que se puede orientar. Se propagará en el campo digitalContentLabelDetails de TargetingOption 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. Este valor se propagará en el campo sensitiveCategoryDetails de TargetingOption cuando targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

enum (SensitiveCategory)

Solo salida. Es una enumeración para el clasificador de contenido de categorías sensibles de DV360.

AppCategoryTargetingOptionDetails

Representa una colección de apps aptas para segmentación. Una colección te permite segmentar anuncios para grupos dinámicos de apps relacionadas que mantiene la plataforma, por ejemplo, All Apps/Google Play/Games. Se propagará 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 la app.

OnScreenPositionTargetingOptionDetails

Representa una posición en pantalla segmentable que pueden usar los anuncios gráficos y de video. Se propagará 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 la pantalla.

ContentOutstreamPositionTargetingOptionDetails

Representa una posición outstream de contenido orientable, que podría utilizarse 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 del anuncio out-stream.

ContentInstreamPositionTargetingOptionDetails

Representa una posición in-stream de contenido segmentable que podrían usar los anuncios de audio y video. Se propagará 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 segmentable. Se propagará 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 apto para segmentación. 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. Es el rango de edad de un público.

ParentalStatusTargetingOptionDetails

Representa un estado parental apto para segmentación. 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 un estado de contenido recompensado del usuario segmentable solo para 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 apto para segmentación. Se propagará en el campo householdIncomeDetails de una TargetingOption cuando targetingType sea TARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

Solo salida. Es el 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. Es el género de un 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 usa para segmentar.

BrowserTargetingOptionDetails

Representa un navegador segmentable. Se completará en el campo browserDetails cuando targetingType sea TARGETING_TYPE_BROWSER.

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

string

Solo salida. Es el nombre visible del navegador.

CarrierAndIspTargetingOptionDetails

Representa un operador o ISP segmentable. Se propagará en el campo carrierAndIspDetails de una TargetingOption 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 propagará en el campo environmentDetails de una TargetingOption 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 orientable. Se propagará en el campo operatingSystemDetails de una TargetingOption 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 segmentable. 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 propagará en el campo viewabilityDetails de una TargetingOption 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 segmentable. Se propagará en el campo categoryDetails de una TargetingOption 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 apto para 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 segmentable. Se propagará 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 propagará 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 submercado segmentable. Se propagará en el campo subExchangeDetails de una TargetingOption cuando targetingType sea TARGETING_TYPE_SUB_EXCHANGE.

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

string

Solo salida. Es el nombre visible del submercado.

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. Latitud del lugar de interés redondeada al 6º decimal

longitude

number

Solo salida. Es la longitud del lugar de interés redondeada 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 segmentable 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. Es 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 segmentable. 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 segmentable. Se propagará 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 para Open Measurement.

AudioContentTypeTargetingOptionDetails

Representa un tipo de contenido de audio segmentable. 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 propagará en el campo contentGenreDetails cuando targetingType sea TARGETING_TYPE_CONTENT_GENRE.

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

string

Solo salida. Es 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 determinados.