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. Es 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 pantalla

contentOutstreamPositionDetails

object (ContentOutstreamPositionTargetingOptionDetails)

Detalles de la posición de out-stream 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 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 del intercambio.

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 para 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 etiqueta de contenido digital segmentable. 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. Es una enumeración para los niveles de seguridad de la marca de las etiquetas de contenido.

SensitiveCategoryTargetingOptionDetails

Representa una categoría sensible segmentable. 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 segmentables. Una colección te permite orientar 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 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 la pantalla.

ContentOutstreamPositionTargetingOptionDetails

Representa una posición out-stream de contenido segmentable que podrían usar los anuncios gráficos y de video. Se propagará 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 del contenido.

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 que se puede orientar. 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 propagará 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 al que se puede orientar. Se propagará en el campo parentalStatusDetails de una TargetingOption 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 propagará 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 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. Es el ingreso familiar de un público.

GenderTargetingOptionDetails

Representa un género al que se puede orientar. Se propagará en el campo genderDetails de una TargetingOption 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 propagará en el campo deviceTypeDetails de una TargetingOption 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 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 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 Es el valor predeterminado cuando no se especifica el tipo o es desconocido 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 se refiere 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 publicación

OperatingSystemTargetingOptionDetails

Representa un sistema operativo apto para segmentación. 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. Es el nombre visible del sistema operativo.

DeviceMakeModelTargetingOptionDetails

Representa la marca y el modelo de un dispositivo segmentable. Se propagará en el campo deviceMakeModelDetails de una TargetingOption cuando targetingType sea TARGETING_TYPE_DEVICE_MAKE_MODEL.

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

string

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

ViewabilityTargetingOptionDetails

Representa una visibilidad segmentable. 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 segmentable. 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. Es el nombre visible de la categoría.

LanguageTargetingOptionDetails

Representa un idioma de segmentación. Se propagará 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., "French").

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 segmentable. 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 segmentable. Se propagará en el campo exchangeDetails de una TargetingOption 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. El nombre visible del intercambio secundario.

PoiTargetingOptionDetails

Representa un lugar de interés (POI) segmentable. Se propagará 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 que se redondea al sexto decimal.

displayName

string

Solo salida. Es el nombre visible de un lugar de interés (p. ej., "Times Square", "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 propagará 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. Es el nombre visible de la cadena comercial, 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 segmentable. Se propagará 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 de 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 apto para segmentación y habilitado para Open Measurement. Se propagará 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 orientable. Se propagará 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 segmentable. 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.