REST Resource: advertisers.campaigns.targetingTypes.assignedTargetingOptions

Recurso: AssignedTargetingOption

Una única opción de segmentación asignada, que define el estado de una opción de segmentación para una entidad con configuración de segmentación.

Representación JSON
{
  "name": string,
  "assignedTargetingOptionId": string,
  "targetingType": enum (TargetingType),
  "inheritance": enum (Inheritance),

  // Union field details can be only one of the following:
  "channelDetails": {
    object (ChannelAssignedTargetingOptionDetails)
  },
  "appCategoryDetails": {
    object (AppCategoryAssignedTargetingOptionDetails)
  },
  "appDetails": {
    object (AppAssignedTargetingOptionDetails)
  },
  "urlDetails": {
    object (UrlAssignedTargetingOptionDetails)
  },
  "dayAndTimeDetails": {
    object (DayAndTimeAssignedTargetingOptionDetails)
  },
  "ageRangeDetails": {
    object (AgeRangeAssignedTargetingOptionDetails)
  },
  "regionalLocationListDetails": {
    object (RegionalLocationListAssignedTargetingOptionDetails)
  },
  "proximityLocationListDetails": {
    object (ProximityLocationListAssignedTargetingOptionDetails)
  },
  "genderDetails": {
    object (GenderAssignedTargetingOptionDetails)
  },
  "videoPlayerSizeDetails": {
    object (VideoPlayerSizeAssignedTargetingOptionDetails)
  },
  "userRewardedContentDetails": {
    object (UserRewardedContentAssignedTargetingOptionDetails)
  },
  "parentalStatusDetails": {
    object (ParentalStatusAssignedTargetingOptionDetails)
  },
  "contentInstreamPositionDetails": {
    object (ContentInstreamPositionAssignedTargetingOptionDetails)
  },
  "contentOutstreamPositionDetails": {
    object (ContentOutstreamPositionAssignedTargetingOptionDetails)
  },
  "deviceTypeDetails": {
    object (DeviceTypeAssignedTargetingOptionDetails)
  },
  "audienceGroupDetails": {
    object (AudienceGroupAssignedTargetingOptionDetails)
  },
  "browserDetails": {
    object (BrowserAssignedTargetingOptionDetails)
  },
  "householdIncomeDetails": {
    object (HouseholdIncomeAssignedTargetingOptionDetails)
  },
  "onScreenPositionDetails": {
    object (OnScreenPositionAssignedTargetingOptionDetails)
  },
  "carrierAndIspDetails": {
    object (CarrierAndIspAssignedTargetingOptionDetails)
  },
  "keywordDetails": {
    object (KeywordAssignedTargetingOptionDetails)
  },
  "negativeKeywordListDetails": {
    object (NegativeKeywordListAssignedTargetingOptionDetails)
  },
  "operatingSystemDetails": {
    object (OperatingSystemAssignedTargetingOptionDetails)
  },
  "deviceMakeModelDetails": {
    object (DeviceMakeModelAssignedTargetingOptionDetails)
  },
  "environmentDetails": {
    object (EnvironmentAssignedTargetingOptionDetails)
  },
  "inventorySourceDetails": {
    object (InventorySourceAssignedTargetingOptionDetails)
  },
  "categoryDetails": {
    object (CategoryAssignedTargetingOptionDetails)
  },
  "viewabilityDetails": {
    object (ViewabilityAssignedTargetingOptionDetails)
  },
  "authorizedSellerStatusDetails": {
    object (AuthorizedSellerStatusAssignedTargetingOptionDetails)
  },
  "languageDetails": {
    object (LanguageAssignedTargetingOptionDetails)
  },
  "geoRegionDetails": {
    object (GeoRegionAssignedTargetingOptionDetails)
  },
  "inventorySourceGroupDetails": {
    object (InventorySourceGroupAssignedTargetingOptionDetails)
  },
  "digitalContentLabelExclusionDetails": {
    object (DigitalContentLabelAssignedTargetingOptionDetails)
  },
  "sensitiveCategoryExclusionDetails": {
    object (SensitiveCategoryAssignedTargetingOptionDetails)
  },
  "exchangeDetails": {
    object (ExchangeAssignedTargetingOptionDetails)
  },
  "subExchangeDetails": {
    object (SubExchangeAssignedTargetingOptionDetails)
  },
  "thirdPartyVerifierDetails": {
    object (ThirdPartyVerifierAssignedTargetingOptionDetails)
  },
  "poiDetails": {
    object (PoiAssignedTargetingOptionDetails)
  },
  "businessChainDetails": {
    object (BusinessChainAssignedTargetingOptionDetails)
  },
  "contentDurationDetails": {
    object (ContentDurationAssignedTargetingOptionDetails)
  },
  "contentStreamTypeDetails": {
    object (ContentStreamTypeAssignedTargetingOptionDetails)
  },
  "nativeContentPositionDetails": {
    object (NativeContentPositionAssignedTargetingOptionDetails)
  },
  "omidDetails": {
    object (OmidAssignedTargetingOptionDetails)
  },
  "audioContentTypeDetails": {
    object (AudioContentTypeAssignedTargetingOptionDetails)
  },
  "contentGenreDetails": {
    object (ContentGenreAssignedTargetingOptionDetails)
  }
  // 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 asignada.

assignedTargetingOptionId

string

Solo salida. El ID único de la opción de segmentación asignada. El ID solo es único dentro de un recurso y un tipo de segmentación determinados. Podría reutilizarse en otros contextos.

targetingType

enum (TargetingType)

Solo salida. Identifica el tipo de esta opción de segmentación asignada.

inheritance

enum (Inheritance)

Solo salida. El estado de herencia de la opción de segmentación asignada.

Campo de unión details. Información detallada sobre la opción de segmentación que se asigna. Solo se puede completar un campo con detalles, que debe corresponder a targeting_type. details solo puede ser una de las siguientes opciones:
channelDetails

object (ChannelAssignedTargetingOptionDetails)

Detalles del canal Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

Detalles de la categoría de app Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_APP_CATEGORY.

appDetails

object (AppAssignedTargetingOptionDetails)

Detalles de la app Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_APP.

urlDetails

object (UrlAssignedTargetingOptionDetails)

Detalles de la URL. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_URL.

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

Detalles del día y la hora Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DAY_AND_TIME.

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

Detalles del rango de edad. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AGE_RANGE.

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Detalles de la lista de ubicaciones regionales. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_REGIONAL_LOCATION_LIST.

proximityLocationListDetails

object (ProximityLocationListAssignedTargetingOptionDetails)

Detalles de la lista de ubicaciones de proximidad. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

Detalles del género. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_GENDER.

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

Detalles del tamaño del reproductor de video Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_VIDEO_PLAYER_SIZE.

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

Detalles del contenido recompensado del usuario Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_USER_REWARDED_CONTENT.

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

Detalles del estado parental Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_PARENTAL_STATUS.

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

Detalles de la posición in-stream del contenido Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

Detalles de la posición de outstream de contenido. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

Detalles del tipo de dispositivo Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DEVICE_TYPE.

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

Detalles de la Segmentación por público. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AUDIENCE_GROUP. Solo puedes orientar a una opción de grupo de público por recurso.

browserDetails

object (BrowserAssignedTargetingOptionDetails)

Detalles del navegador. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_BROWSER.

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

Detalles del ingreso familiar Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_HOUSEHOLD_INCOME.

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

Detalles de posición en pantalla Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_ON_SCREEN_POSITION.

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

Detalles del ISP y el operador. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CARRIER_AND_ISP.

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalles de la palabra clave Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_KEYWORD.

Se puede asignar un máximo de 5,000 palabras clave negativas directas a un recurso. No hay límite para la cantidad de palabras clave positivas que se pueden asignar.

negativeKeywordListDetails

object (NegativeKeywordListAssignedTargetingOptionDetails)

Detalles de la palabra clave Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

Se puede asignar un máximo de 4 listas de palabras clave negativas a un recurso.

operatingSystemDetails

object (OperatingSystemAssignedTargetingOptionDetails)

Detalles de los sistemas operativos Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_OPERATING_SYSTEM.

deviceMakeModelDetails

object (DeviceMakeModelAssignedTargetingOptionDetails)

Detalles de la marca y el modelo del dispositivo Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

Detalles del entorno. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_ENVIRONMENT.

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

Detalles de la fuente de inventario Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_INVENTORY_SOURCE.

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

Detalles de la categoría Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CATEGORY.

Al segmentar una categoría, también se orientarán sus subcategorías. Si se excluye una categoría de la segmentación y se incluye una subcategoría, prevalecerá la exclusión.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

Detalles de visibilidad Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_VIEWABILITY.

Solo se puede orientar a una opción de visibilidad por recurso.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

Detalles del estado de vendedor autorizado Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Solo puedes orientar una opción de estado de vendedor autorizado por recurso.

Si un recurso no tiene una opción de estado de vendedor autorizado, se segmentará de forma predeterminada a todos los vendedores autorizados indicados como DIRECTO o DISTRIBUIDOR en el archivo ads.txt.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

Detalles del idioma Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_LANGUAGE.

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

Detalles de la región geográfica Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_GEO_REGION.

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

Detalles del grupo de fuentes de inventario. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

Detalles de la etiqueta de contenido digital. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

Las etiquetas de contenido digital son exclusiones de segmentación. Si se configuran, las exclusiones de etiquetas de contenido digital a nivel del anunciante siempre se aplican en la publicación (aunque no se puedan ver en la configuración de recursos). La configuración de recursos puede excluir etiquetas de contenido además de las exclusiones de anunciantes, pero no puede anularlas. No se publicará una línea de pedido si se excluyen todas las etiquetas de contenido digital.

sensitiveCategoryExclusionDetails

object (SensitiveCategoryAssignedTargetingOptionDetails)

Detalles de categorías sensibles. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Las categorías sensibles son exclusiones de segmentación. Si se configuran, las exclusiones de categorías sensibles a nivel del anunciante siempre se aplican en la publicación (aunque no se puedan ver en la configuración de recursos). La configuración de recursos puede excluir categorías sensibles además de las exclusiones de anunciantes, pero no puede anularlas.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Detalles del intercambio. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

Detalles de intercambio secundario Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_SUB_EXCHANGE.

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

Detalles de la verificación de terceros Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_THIRD_PARTY_VERIFIER.

poiDetails

object (PoiAssignedTargetingOptionDetails)

Detalles del lugar de interés. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_POI.

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

Detalles de la cadena de empresas Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_BUSINESS_CHAIN.

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

Detalles de la duración del contenido Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_DURATION.

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

Detalles de la duración del contenido Este campo se propagará cuando el tipo de segmentación sea TARGETING_TYPE_CONTENT_STREAM_TYPE.

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

Detalles de posición de contenido nativo. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_NATIVE_CONTENT_POSITION.

omidDetails

object (OmidAssignedTargetingOptionDetails)

Detalles del inventario habilitado para Open Measurement. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_OMID.

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

Detalles del tipo de contenido de audio. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_AUDIO_CONTENT_TYPE.

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

Detalles del género del contenido. Este campo se propagará cuando el valor de targetingType sea TARGETING_TYPE_CONTENT_GENRE.

Herencia

Indica si la opción de segmentación asignada se hereda de una entidad de nivel superior, como un socio o un anunciante. Las opciones de segmentación heredadas y asignadas tienen prioridad, siempre se aplican en la publicación sobre la segmentación asignada en el nivel actual y no se pueden modificar mediante el servicio de entidad actual. Se deben modificar a través del servicio de entidad desde el que se heredan. La herencia solo se aplica a los canales con segmentación negativa, las exclusiones de categorías sensibles y las exclusiones de etiquetas de contenido digital si se configuran a nivel del nivel superior.

Enumeradores
INHERITANCE_UNSPECIFIED La herencia no se especifica o se desconoce.
NOT_INHERITED La opción de segmentación asignada no se hereda de la entidad de nivel superior.
INHERITED_FROM_PARTNER La opción de segmentación asignada se hereda de la configuración de la segmentación de socios.
INHERITED_FROM_ADVERTISER La opción de segmentación asignada se hereda de la configuración de la segmentación del anunciante.

ChannelAssignedTargetingOptionDetails

Detalles de la opción de segmentación del canal asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_CHANNEL.

Representación JSON
{
  "channelId": string,
  "negative": boolean
}
Campos
channelId

string (int64 format)

Obligatorio. Es el ID del canal. Debe referirse al campo del ID del canal en un recurso del canal perteneciente al socio o del canal del anunciante.

negative

boolean

Indica si esta opción se está segmentando de forma negativa. En el caso de la opción de segmentación asignada a nivel del anunciante, este campo debe ser verdadero.

AppCategoryAssignedTargetingOptionDetails

Detalles de la opción de segmentación por categoría de app asignada. Se propagará en el campo appCategoryDetails de una AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_APP_CATEGORY.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

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

targetingOptionId

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_APP_CATEGORY.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

AppAssignedTargetingOptionDetails

Detalles de la opción de segmentación de la app asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_APP.

Representación JSON
{
  "appId": string,
  "displayName": string,
  "negative": boolean,
  "appPlatform": enum (AppPlatform)
}
Campos
appId

string

Obligatorio. El ID de la app

La app de Play Store de Android usa el ID del paquete, por ejemplo, com.google.android.gm. El ID de la aplicación de App Store de Apple usa una cadena de 9 dígitos, por ejemplo, 422689480.

displayName

string

Solo salida. El nombre visible de la app.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

appPlatform

enum (AppPlatform)

Indica la plataforma de la aplicación objetivo. Si no se especifica este campo, se supondrá que la plataforma de la aplicación es móvil (es decir, Android o iOS), y obtendremos la plataforma móvil adecuada a partir del ID de la aplicación.

AppPlatform

Posibles opciones de segmentación por plataforma de apps.

Enumeradores
APP_PLATFORM_UNSPECIFIED El valor predeterminado cuando la plataforma de la app no se especifica en esta versión. Esta enumeración es un marcador de posición para el valor predeterminado y no representa una opción de plataforma real.
APP_PLATFORM_IOS La plataforma de aplicaciones es iOS.
APP_PLATFORM_ANDROID La plataforma de apps es Android.
APP_PLATFORM_ROKU La plataforma de apps es Roku.
APP_PLATFORM_AMAZON_FIRETV La plataforma de apps es Amazon FireTV.
APP_PLATFORM_PLAYSTATION La plataforma de apps es Playstation.
APP_PLATFORM_APPLE_TV La plataforma de apps es Apple TV.
APP_PLATFORM_XBOX La plataforma de apps es Xbox.
APP_PLATFORM_SAMSUNG_TV La plataforma de apps es Samsung TV.
APP_PLATFORM_ANDROID_TV La plataforma de apps es Android TV.
APP_PLATFORM_GENERIC_CTV La plataforma de apps es una plataforma de CTV que no aparece explícitamente en otra lista.

UrlAssignedTargetingOptionDetails

Detalles de la opción de segmentación por URL asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_URL.

Representación JSON
{
  "url": string,
  "negative": boolean
}
Campos
url

string

Obligatorio. La URL, por ejemplo, example.com

DV360 admite dos niveles de segmentación de subdirectorio, por ejemplo, www.example.com/one-subdirectory-level/second-level, y cinco niveles de segmentación de subdominio, como five.four.three.two.one.example.com.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

DayAndTimeAssignedTargetingOptionDetails

Representación de un segmento de tiempo definido en un día específico de la semana y con horas de inicio y finalización. La hora que representa startHour debe ser anterior a la hora que representa endHour.

Representación JSON
{
  "dayOfWeek": enum (DayOfWeek),
  "startHour": integer,
  "endHour": integer,
  "timeZoneResolution": enum (TimeZoneResolution)
}
Campos
dayOfWeek

enum (DayOfWeek)

Obligatorio. El día de la semana para esta configuración de la segmentación por día y hora.

startHour

integer

Obligatorio. La hora de inicio para la segmentación por día y hora. Debe ser un valor entre 0 (inicio del día) y 23 (1 hora antes del final del día).

endHour

integer

Obligatorio. Es la hora de finalización de la segmentación por día y hora. Debe ser un valor entre 1 (1 hora después del inicio del día) y 24 (final del día).

timeZoneResolution

enum (TimeZoneResolution)

Obligatorio. Es el mecanismo utilizado para determinar qué zona horaria usar para este parámetro de configuración de la segmentación de día y hora.

DayOfWeek

Representa un día de la semana.

Enumeradores
DAY_OF_WEEK_UNSPECIFIED No se especifica el día de la semana.
MONDAY Lunes
TUESDAY Martes
WEDNESDAY miércoles".
THURSDAY Jueves
FRIDAY Viernes
SATURDAY Sábado
SUNDAY Domingo

TimeZoneResolution

Posibles enfoques para resolver la zona horaria.

Enumeradores
TIME_ZONE_RESOLUTION_UNSPECIFIED La resolución de la zona horaria es desconocida o no es específica.
TIME_ZONE_RESOLUTION_END_USER Los horarios se resuelven en la zona horaria del usuario que vio el anuncio.
TIME_ZONE_RESOLUTION_ADVERTISER Los horarios se resuelven en la zona horaria del anunciante que publicó el anuncio.

AgeRangeAssignedTargetingOptionDetails

Representa un rango de edad al que se puede orientar. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

El rango de edad de un público. Solo admitimos la segmentación para un rango de edad continuo de un público. Por lo tanto, el rango de edad representado en este campo puede 1) orientarse solo o 2) formar parte de un rango de edad continuo más amplio. El alcance de la segmentación continua por rango de edad puede expandirse si también se segmenta para un público de edad desconocida.

Resultado solo en la versión v1. Obligatorio en la v2.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_AGE_RANGE.

RegionalLocationListAssignedTargetingOptionDetails

Detalles de segmentación de la lista de ubicaciones regionales. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_REGIONAL_LOCATION_LIST.

Representación JSON
{
  "regionalLocationListId": string,
  "negative": boolean
}
Campos
regionalLocationListId

string (int64 format)

Obligatorio. Es el ID de la lista de ubicaciones regionales. Debe hacer referencia al campo locationListId de un recurso LocationList cuyo tipo es TARGETING_LOCATION_TYPE_REGIONAL.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

ProximityLocationListAssignedTargetingOptionDetails

Detalles de segmentación de la lista de ubicaciones de proximidad. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

Representación JSON
{
  "proximityLocationListId": string,
  "proximityRadiusRange": enum (ProximityRadiusRange)
}
Campos
proximityLocationListId

string (int64 format)

Obligatorio. ID de la lista de ubicaciones de proximidad. Debe hacer referencia al campo locationListId de un recurso LocationList cuyo tipo es TARGETING_LOCATION_TYPE_PROXIMITY.

proximityRadiusRange

enum (ProximityRadiusRange)

Obligatorio. Rango del radio de la lista de ubicaciones de proximidad. Representa el tamaño del área alrededor de la ubicación elegida para la segmentación.

La segmentación geográfica por proximidad de All en un solo recurso debe tener el mismo valor de rango de radio. Establece este valor para que coincida con cualquier segmentación existente. Si se actualiza, este campo cambiará el intervalo de radio de todas las orientaciones por proximidad del recurso.

ProximityRadiusRange

Es un tipo de rango de radio para una opción asignada geográficamente de proximidad. El rango del radio es relativo a la densidad poblacional. Por ejemplo, PROXIMITY_RADIUS_RANGE_SMALL en un área rural será diferente de PROXIMITY_RADIUS_RANGE_SMALL en una ciudad muy poblada.

Enumeradores
PROXIMITY_RADIUS_RANGE_UNSPECIFIED No se especificó el rango del radio de segmentación o se desconoce. El valor predeterminado cuando el rango de radio no se especifica en esta versión. Esta enumeración es un marcador de posición para el valor predeterminado y no representa una opción de rango de radio real.
PROXIMITY_RADIUS_RANGE_SMALL El rango del radio de orientación es pequeño.
PROXIMITY_RADIUS_RANGE_MEDIUM El rango del radio de segmentación es medio.
PROXIMITY_RADIUS_RANGE_LARGE El rango del radio de orientación es amplio.

GenderAssignedTargetingOptionDetails

Detalles de la opción de segmentación por género asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_GENDER.

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

enum (Gender)

Indica el género del público.

Resultado solo en la versión v1. Obligatorio en la v2.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_GENDER.

VideoPlayerSizeAssignedTargetingOptionDetails

Detalles de la opción de segmentación por tamaño del reproductor de video. Se propagará en el campo videoPlayerSizeDetails cuando targetingType sea TARGETING_TYPE_VIDEO_PLAYER_SIZE. No se admite la segmentación explícita a todas las opciones. Para lograr este efecto, quita todas las opciones de segmentación por tamaño del reproductor de video.

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

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_VIDEO_PLAYER_SIZE.

videoPlayerSize

enum (VideoPlayerSize)

Es el tamaño del reproductor de video.

Resultado solo en la versión v1. Obligatorio en la v2.

UserRewardedContentAssignedTargetingOptionDetails

Detalles de la opción de segmentación de contenido recompensado del usuario. Se propagará en el campo userRewardedContentDetails cuando targetingType sea TARGETING_TYPE_USER_REWARDED_CONTENT.

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

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_USER_REWARDED_CONTENT.

userRewardedContent

enum (UserRewardedContent)

Solo salida. Es el estado del contenido recompensado del usuario para los anuncios de video.

ParentalStatusAssignedTargetingOptionDetails

Detalles de la opción de segmentación por estado parental asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_PARENTAL_STATUS.

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

enum (ParentalStatus)

Es el estado parental del público.

Resultado solo en la versión v1. Obligatorio en la v2.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_PARENTAL_STATUS.

ContentInstreamPositionAssignedTargetingOptionDetails

Detalles de la opción de segmentación por posición in-stream de contenido asignado. Se propagará en el campo contentInstreamPositionDetails cuando targetingType sea TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

Representación JSON
{
  "targetingOptionId": string,
  "contentInstreamPosition": enum (ContentInstreamPosition),
  "adType": enum (AdType)
}
Campos
targetingOptionId

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_CONTENT_INSTREAM_POSITION.

contentInstreamPosition

enum (ContentInstreamPosition)

Es la posición in-stream de contenido para anuncios de audio o video.

Resultado solo en la versión v1. Obligatorio en la v2.

adType

enum (AdType)

Solo salida. El tipo de anuncio para el que se segmentará Solo se aplica a la segmentación de pedidos de inserción y a las nuevas líneas de pedido que admitan el tipo de anuncio especificado heredarán esta opción de segmentación de forma predeterminada. Los valores posibles son:

  • AD_TYPE_VIDEO, la nueva línea de pedido heredará la configuración cuando el valor de lineItemType sea LINE_ITEM_TYPE_VIDEO_DEFAULT.
  • AD_TYPE_AUDIO, la nueva línea de pedido heredará la configuración cuando el valor de lineItemType sea LINE_ITEM_TYPE_AUDIO_DEFAULT.

AdType

Representa el tipo de creatividad asociado con los anuncios.

Enumeradores
AD_TYPE_UNSPECIFIED No se especificó el tipo de anuncio en esta versión o se desconoce.
AD_TYPE_DISPLAY Mostrar creatividades, p. ej., imagen y HTML5
AD_TYPE_VIDEO Creatividades de video, p. ej., anuncios de video que se reproducen durante la transmisión de contenido en reproductores de video
AD_TYPE_AUDIO Creatividades de audio, p. ej., anuncios de audio que se reproducen durante contenido de audio

ContentOutstreamPositionAssignedTargetingOptionDetails

Detalles de la opción de segmentación de posición outstream del contenido asignado. Se propagará en el campo contentOutstreamPositionDetails cuando targetingType sea TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

Representación JSON
{
  "targetingOptionId": string,
  "contentOutstreamPosition": enum (ContentOutstreamPosition),
  "adType": enum (AdType)
}
Campos
targetingOptionId

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION.

contentOutstreamPosition

enum (ContentOutstreamPosition)

Es la posición de outstream de contenido.

Resultado solo en la versión v1. Obligatorio en la v2.

adType

enum (AdType)

Solo salida. El tipo de anuncio para el que se segmentará Solo se aplica a la segmentación de pedidos de inserción y a las nuevas líneas de pedido que admitan el tipo de anuncio especificado heredarán esta opción de segmentación de forma predeterminada. Los valores posibles son:

  • AD_TYPE_DISPLAY, la nueva línea de pedido heredará la configuración cuando el valor de lineItemType sea LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, la nueva línea de pedido heredará la configuración cuando el valor de lineItemType sea LINE_ITEM_TYPE_VIDEO_DEFAULT.

DeviceTypeAssignedTargetingOptionDetails

Detalles de segmentación por tipo de dispositivo. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_DEVICE_TYPE.

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

string

Obligatorio. ID del tipo de dispositivo.

deviceType

enum (DeviceType)

El nombre visible del tipo de dispositivo.

Resultado solo en la versión v1. Obligatorio en la v2.

AudienceGroupAssignedTargetingOptionDetails

Detalles de la opción de segmentación del grupo de público asignado. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_AUDIENCE_GROUP. La relación entre cada grupo es UNION, excepto para excludedFirstAndThirdPartyAudienceGroup y excludedGoogleAudienceGroup, de los cuales COMPLEMENT se use como PCollection con otros grupos.

Representación JSON
{
  "includedFirstAndThirdPartyAudienceGroups": [
    {
      object (FirstAndThirdPartyAudienceGroup)
    }
  ],
  "includedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  },
  "includedCustomListGroup": {
    object (CustomListGroup)
  },
  "includedCombinedAudienceGroup": {
    object (CombinedAudienceGroup)
  },
  "excludedFirstAndThirdPartyAudienceGroup": {
    object (FirstAndThirdPartyAudienceGroup)
  },
  "excludedGoogleAudienceGroup": {
    object (GoogleAudienceGroup)
  }
}
Campos
includedFirstAndThirdPartyAudienceGroups[]

object (FirstAndThirdPartyAudienceGroup)

Son las reservas y los IDs de público propios y de terceros de los grupos de público incluidos, propios y de terceros. Cada grupo de público propio y de terceros solo contiene IDs de público propios y de terceros. La relación entre cada grupo de público propio y externo es PCollection, y el resultado es UNION con otros grupos de público. Se ignorarán los grupos repetidos con la misma configuración.

includedGoogleAudienceGroup

object (GoogleAudienceGroup)

Los IDs de público de Google del grupo de público de Google incluido. Contiene solo los ID de público de Google.

includedCustomListGroup

object (CustomListGroup)

Los IDs de lista personalizada del grupo de listas personalizadas incluido. Contiene solo ID de lista personalizada.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

Son los IDs de público combinado del grupo de público combinado incluido. Contiene solo ID de públicos combinados.

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Son los IDs de público propios y de terceros, y las reservas del grupo de público excluido y de terceros. Se utiliza para la segmentación negativa. El COMPLEMENTO de la UNIÓN de este grupo y de otros grupos de público excluidos se utiliza como una Referencia para cualquier segmentación por público positiva. Lógicamente, todos los elementos están ubicados en un operador "OR" entre sí.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Son los IDs de público de Google del grupo de público de Google excluido. Se utiliza para la segmentación negativa. El COMPLEMENTO de la UNIÓN de este grupo y de otros grupos de público excluidos se utiliza como una Referencia para cualquier segmentación por público positiva. Solo contiene los públicos de Google afines, en el mercado y de aplicaciones instaladas. Lógicamente, todos los elementos están ubicados en un operador "OR" entre sí.

FirstAndThirdPartyAudienceGroup

Detalles del grupo de público propio y de terceros. Todas las configuraciones de segmentación por público propias y de terceros utilizan lógicamente "OR".

Representación JSON
{
  "settings": [
    {
      object (FirstAndThirdPartyAudienceTargetingSetting)
    }
  ]
}
Campos
settings[]

object (FirstAndThirdPartyAudienceTargetingSetting)

Obligatorio. Toda la configuración de la segmentación por público propia y de terceros del grupo de público propio y de terceros No se permiten los parámetros de configuración repetidos con el mismo ID.

FirstAndThirdPartyAudienceTargetingSetting

Detalles de la configuración de la segmentación por público propia y de terceros

Representación JSON
{
  "firstAndThirdPartyAudienceId": string,
  "recency": enum (Recency)
}
Campos
firstAndThirdPartyAudienceId

string (int64 format)

Obligatorio. Es el ID de público propio y de terceros de la configuración de la segmentación por público propia y de terceros. Este ID es firstAndThirdPartyAudienceId.

recency

enum (Recency)

Indica qué tan recientes son las opciones de configuración de la segmentación por público propia y de terceros. Solo se aplica a públicos propios; de lo contrario, se ignorará. Para obtener más información, consulta https://support.google.com/displayvideo/answer/2949947#recency Si no se especifica un límite, no se utilizará ningún límite de visitas recientes.

Visitas recientes

Todos los valores de visitas recientes de públicos propios y de terceros admitidos.

Enumeradores
RECENCY_NO_LIMIT Sin límite de compras recientes.
RECENCY_1_MINUTE El valor de visitas recientes es de 1 minuto.
RECENCY_5_MINUTES El valor de visitas recientes es de 5 minutos.
RECENCY_10_MINUTES El valor de visitas recientes es de 10 minutos.
RECENCY_15_MINUTES El valor de visitas recientes es de 15 minutos.
RECENCY_30_MINUTES El valor de visitas recientes es de 30 minutos.
RECENCY_1_HOUR El valor de visitas recientes es de 1 hora.
RECENCY_2_HOURS El valor de visitas recientes es de 2 horas.
RECENCY_3_HOURS El valor de visitas recientes es de 3 horas.
RECENCY_6_HOURS El valor de visitas recientes es de 6 horas.
RECENCY_12_HOURS El valor de visitas recientes es de 12 horas.
RECENCY_1_DAY El valor reciente es de 1 día.
RECENCY_2_DAYS El valor de visitas recientes es de 2 días.
RECENCY_3_DAYS El valor de visitas recientes es de 3 días.
RECENCY_5_DAYS El valor de visitas recientes es de 5 días.
RECENCY_7_DAYS El valor de visitas recientes es de 7 días.
RECENCY_10_DAYS El valor de visitas recientes es de 10 días.
RECENCY_14_DAYS El valor de visitas recientes es de 14 días.
RECENCY_15_DAYS El valor de visitas recientes es de 15 días.
RECENCY_21_DAYS El valor de visitas recientes es de 21 días.
RECENCY_28_DAYS El valor de visitas recientes es de 28 días.
RECENCY_30_DAYS El valor de visitas recientes es de 30 días.
RECENCY_40_DAYS El valor de visitas recientes es de 40 días.
RECENCY_45_DAYS El valor de visitas recientes es de 45 días.
RECENCY_60_DAYS El valor de visitas recientes es de 60 días.
RECENCY_90_DAYS El valor de visitas recientes es de 90 días.
RECENCY_120_DAYS El valor de visitas recientes es de 120 días.
RECENCY_180_DAYS El valor de visitas recientes es de 180 días.
RECENCY_270_DAYS El valor de visitas recientes es de 270 días.
RECENCY_365_DAYS El valor de visitas recientes es de 365 días.

GoogleAudienceGroup

Detalles del grupo de público de Google. Todas las configuraciones de Segmentación por público de Google funcionan con "O" entre sí de forma lógica.

Representación JSON
{
  "settings": [
    {
      object (GoogleAudienceTargetingSetting)
    }
  ]
}
Campos
settings[]

object (GoogleAudienceTargetingSetting)

Obligatorio. Toda la configuración de la segmentación por público de Google en el grupo de público de Google Se ignorarán las configuraciones repetidas con el mismo ID.

GoogleAudienceTargetingSetting

Detalles de la configuración de la segmentación por público de Google

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

string (int64 format)

Obligatorio. Es el ID de público de Google de la configuración de Segmentación por público de Google. Este ID es googleAudienceId.

CustomListGroup

Detalles del grupo de listas personalizadas. Todas las configuraciones de segmentación por listas personalizadas utilizan lógicamente "OR" entre sí.

Representación JSON
{
  "settings": [
    {
      object (CustomListTargetingSetting)
    }
  ]
}
Campos
settings[]

object (CustomListTargetingSetting)

Obligatorio. Toda la configuración de segmentación por listas personalizadas en el grupo de listas personalizadas. Se ignorarán las configuraciones repetidas con el mismo ID.

CustomListTargetingSetting

Detalles de la configuración de segmentación de lista personalizada.

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

string (int64 format)

Obligatorio. ID personalizado de la configuración de segmentación de lista personalizada. Este ID es customListId.

CombinedAudienceGroup

Detalles del grupo de público combinado. Todas las configuraciones de la segmentación por público combinada incluyen lógicamente "O".

Representación JSON
{
  "settings": [
    {
      object (CombinedAudienceTargetingSetting)
    }
  ]
}
Campos
settings[]

object (CombinedAudienceTargetingSetting)

Obligatorio. Toda la configuración de la segmentación por público combinado en un grupo de público combinado Se ignorarán las configuraciones repetidas con el mismo ID. La cantidad de parámetros de configuración de público combinado no debe ser superior a cinco; de lo contrario, se mostrará un error.

CombinedAudienceTargetingSetting

Detalles de la configuración de la segmentación por público combinado

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

string (int64 format)

Obligatorio. Es el ID de público combinado de la configuración de la Segmentación por público combinada. Este ID es combinedAudienceId.

BrowserAssignedTargetingOptionDetails

Detalles de la opción de segmentación por navegador asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_BROWSER.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Solo salida. Es el nombre visible del navegador.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_BROWSER.

negative

boolean

Indica si esta opción se está segmentando de forma negativa. Todas las opciones de segmentación de navegador asignadas en el mismo recurso deben tener el mismo valor para este campo.

HouseholdIncomeAssignedTargetingOptionDetails

Detalles de la opción de segmentación por ingreso familiar asignado. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_HOUSEHOLD_INCOME.

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

enum (HouseholdIncome)

Indica el ingreso familiar del público.

Resultado solo en la versión v1. Obligatorio en la v2.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_HOUSEHOLD_INCOME.

OnScreenPositionAssignedTargetingOptionDetails

Detalles de la opción de segmentación por posición en la pantalla. Se propagará en el campo onScreenPositionDetails cuando targetingType sea TARGETING_TYPE_ON_SCREEN_POSITION.

Representación JSON
{
  "targetingOptionId": string,
  "onScreenPosition": enum (OnScreenPosition),
  "adType": enum (AdType)
}
Campos
targetingOptionId

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_ON_SCREEN_POSITION.

onScreenPosition

enum (OnScreenPosition)

Solo salida. La posición en pantalla

adType

enum (AdType)

Solo salida. El tipo de anuncio para el que se segmentará Solo se aplica a la segmentación de pedidos de inserción y a las nuevas líneas de pedido que admitan el tipo de anuncio especificado heredarán esta opción de segmentación de forma predeterminada. Los valores posibles son:

  • AD_TYPE_DISPLAY, la nueva línea de pedido heredará la configuración cuando el valor de lineItemType sea LINE_ITEM_TYPE_DISPLAY_DEFAULT.
  • AD_TYPE_VIDEO, la nueva línea de pedido heredará la configuración cuando el valor de lineItemType sea LINE_ITEM_TYPE_VIDEO_DEFAULT.

CarrierAndIspAssignedTargetingOptionDetails

Detalles del operador asignado y la opción de segmentación de ISP. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_CARRIER_AND_ISP.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

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

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Indica si esta opción se está segmentando de forma negativa. Todas las opciones de segmentación por ISP y operadores de telefonía celular asignadas en el mismo recurso deben tener el mismo valor para este campo.

KeywordAssignedTargetingOptionDetails

Detalles de la opción de segmentación por palabras clave asignadas. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_KEYWORD.

Representación JSON
{
  "keyword": string,
  "negative": boolean
}
Campos
keyword

string

Obligatorio. La palabra clave, por ejemplo, car insurance.

Las palabras clave positivas no pueden ser ofensivas. Debe estar codificado en UTF-8 con un tamaño máximo de 255 bytes. La cantidad máxima de caracteres es 80. La cantidad máxima de palabras es 10.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

NegativeKeywordListAssignedTargetingOptionDetails

Detalles de segmentación de la lista de palabras clave negativas. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_NEGATIVE_KEYWORD_LIST.

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

string (int64 format)

Obligatorio. ID de la lista de palabras clave negativas. Debe hacer referencia al campo negativeKeywordListId de un recurso NegativeKeywordList.

OperatingSystemAssignedTargetingOptionDetails

Detalles de la opción de segmentación por sistema operativo asignado. Se propagará en el campo operatingSystemDetails cuando targetingType sea TARGETING_TYPE_OPERATING_SYSTEM.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

Solo salida. El nombre visible del sistema operativo.

targetingOptionId

string

Obligatorio. El ID de la opción de segmentación se propaga en el campo targetingOptionId cuando targetingType es TARGETING_TYPE_OPERATING_SYSTEM.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

DeviceMakeModelAssignedTargetingOptionDetails

Detalles de la opción de segmentación por modelo y marca de dispositivo asignado Se propagará en el campo deviceMakeModelDetails cuando targetingType sea TARGETING_TYPE_DEVICE_MAKE_MODEL.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

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

targetingOptionId

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_DEVICE_MAKE_MODEL.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

EnvironmentAssignedTargetingOptionDetails

Detalles de la opción de segmentación por entorno asignado. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_ENVIRONMENT.

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

enum (Environment)

El entorno de entrega

Resultado solo en la versión v1. Obligatorio en la v2.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_ENVIRONMENT (p.ej., "508010" para segmentar la opción ENVIRONMENT_WEB_OPTIMIZED).

InventorySourceAssignedTargetingOptionDetails

Detalles de segmentación de la fuente de inventario Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_INVENTORY_SOURCE.

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

string (int64 format)

Obligatorio. Es el ID de la fuente de inventario. Debe hacer referencia al campo inventorySourceId de un recurso InventorySource.

CategoryAssignedTargetingOptionDetails

Detalles de la opción de segmentación por categoría asignada. Se propagará en el campo categoryDetails cuando targetingType sea TARGETING_TYPE_CATEGORY.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

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

targetingOptionId

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_CATEGORY.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

ViewabilityAssignedTargetingOptionDetails

Detalles de la opción de segmentación por visibilidad asignada. Se propagará en el campo viewabilityDetails de una AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_VIEWABILITY.

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

enum (Viewability)

Es el porcentaje de visibilidad previsto.

Resultado solo en la versión v1. Obligatorio en la v2.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_VIEWABILITY (p.ej., "509010" para segmentar la opción VIEWABILITY_10_PERCENT_OR_MORE).

AuthorizedSellerStatusAssignedTargetingOptionDetails

Representa un estado asignado de vendedor autorizado. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

Si un recurso no tiene una opción de segmentación asignada de TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, se usa la opción "Vendedores directos y revendedores autorizados".

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

enum (AuthorizedSellerStatus)

Solo salida. Es el estado de vendedor autorizado al que se debe segmentar.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_AUTHORIZED_SELLER_STATUS.

LanguageAssignedTargetingOptionDetails

Detalles de la opción de segmentación por idioma asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_LANGUAGE.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "negative": boolean
}
Campos
displayName

string

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

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_LANGUAGE.

negative

boolean

Indica si esta opción se está segmentando de forma negativa. Todas las opciones de segmentación por idioma asignadas en el mismo recurso deben tener el mismo valor para este campo.

GeoRegionAssignedTargetingOptionDetails

Detalles de la opción de segmentación por región geográfica asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_GEO_REGION.

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

string

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

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_GEO_REGION.

geoRegionType

enum (GeoRegionType)

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

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

InventorySourceGroupAssignedTargetingOptionDetails

Detalles de segmentación del grupo de fuentes de inventario. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_INVENTORY_SOURCE_GROUP.

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

string (int64 format)

Obligatorio. Es el ID del grupo de fuentes de inventario. Debe hacer referencia al campo inventorySourceGroupId de un recurso InventorySourceGroup.

DigitalContentLabelAssignedTargetingOptionDetails

Detalles de segmentación para la etiqueta de contenido digital. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

string

Obligatorio. ID de la etiqueta de contenido digital que se EXCLUYE

contentRatingTier

enum (ContentRatingTier)

Solo salida. El nombre visible del nivel de clasificación de las etiquetas de contenido digital.

SensitiveCategoryAssignedTargetingOptionDetails

Detalles de segmentación de la categoría sensible. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

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

string

Obligatorio. ID de la categoría sensible que se EXCLUIRá.

sensitiveCategory

enum (SensitiveCategory)

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

ExchangeAssignedTargetingOptionDetails

Detalles de la opción de segmentación de intercambio asignado. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_EXCHANGE.

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

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_EXCHANGE.

SubExchangeAssignedTargetingOptionDetails

Detalles de la opción de segmentación de subintercambio asignado. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_SUB_EXCHANGE.

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

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_SUB_EXCHANGE.

ThirdPartyVerifierAssignedTargetingOptionDetails

Detalles de la opción de segmentación del verificador de terceros asignado Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_THIRD_PARTY_VERIFIER.

Representación JSON
{

  // Union field verifier can be only one of the following:
  "adloox": {
    object (Adloox)
  },
  "doubleVerify": {
    object (DoubleVerify)
  },
  "integralAdScience": {
    object (IntegralAdScience)
  }
  // End of list of possible types for union field verifier.
}
Campos
Campo de unión verifier. Puede orientarse a uno de los verificadores externos a fin de aplicar los umbrales de seguridad de la marca para las impresiones. Las direcciones (verifier) solo pueden ser una de las siguientes opciones:
adloox

object (Adloox)

Verificador de marca de terceros: Adloox.

doubleVerify

object (DoubleVerify)

Verificador de marca externo: DoubleVerify.

integralAdScience

object (IntegralAdScience)

Verificador de marca de terceros: Integral Ad Science

Adloox

Detalles de la configuración de Adloox.

Representación JSON
{
  "excludedAdlooxCategories": [
    enum (AdlooxCategory)
  ]
}
Campos
excludedAdlooxCategories[]

enum (AdlooxCategory)

Configuración de seguridad de la marca de Adloox.

AdlooxCategory

Posibles opciones de Adloox.

Enumeradores
ADLOOX_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de Adloox.
ADULT_CONTENT_HARD Contenido para adultos (difícil).
ADULT_CONTENT_SOFT Contenido para adultos (blanda).
ILLEGAL_CONTENT Contenido ilegal
BORDERLINE_CONTENT Contenido que se encuentra en el límite de lo aceptable.
DISCRIMINATORY_CONTENT Contenido discriminatorio.
VIOLENT_CONTENT_WEAPONS Armas y contenido violento.
LOW_VIEWABILITY_DOMAINS dominios de baja visibilidad.
FRAUD Fraude

DoubleVerify

Detalles de la configuración de DoubleVerify.

Representación JSON
{
  "brandSafetyCategories": {
    object (BrandSafetyCategories)
  },
  "avoidedAgeRatings": [
    enum (AgeRating)
  ],
  "appStarRating": {
    object (AppStarRating)
  },
  "displayViewability": {
    object (DisplayViewability)
  },
  "videoViewability": {
    object (VideoViewability)
  },
  "fraudInvalidTraffic": {
    object (FraudInvalidTraffic)
  },
  "customSegmentId": string
}
Campos
brandSafetyCategories

object (BrandSafetyCategories)

Controles de seguridad de la marca de DV.

avoidedAgeRatings[]

enum (AgeRating)

Evita ofertar en aplicaciones con clasificación por edad.

appStarRating

object (AppStarRating)

Evita ofertar en aplicaciones con calificaciones por estrellas.

displayViewability

object (DisplayViewability)

Configuración de visibilidad en Display (aplicable solo para líneas de pedido de anuncios gráficos)

videoViewability

object (VideoViewability)

Configuración de visibilidad de video (aplicable solo a las líneas de pedido de video)

fraudInvalidTraffic

object (FraudInvalidTraffic)

Evite los sitios y las aplicaciones con tasas históricas de fraude y IVT.

customSegmentId

string (int64 format)

El ID de segmento personalizado proporcionado por DoubleVerify. El ID debe comenzar con "51" y tener ocho dígitos. El ID del segmento personalizado no se puede especificar junto con ninguno de los siguientes campos:

BrandSafetyCategories

Configuración de los controles de seguridad de la marca.

Representación JSON
{
  "avoidUnknownBrandSafetyCategory": boolean,
  "avoidedHighSeverityCategories": [
    enum (HighSeverityCategory)
  ],
  "avoidedMediumSeverityCategories": [
    enum (MediumSeverityCategory)
  ]
}
Campos
avoidUnknownBrandSafetyCategory

boolean

Desconocido o incalificado

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

Categorías de prevención de gravedad alta de seguridad de la marca.

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

Categorías de prevención de gravedad media de seguridad de la marca.

HighSeverityCategory

Posibles opciones para categorías de gravedad alta.

Enumeradores
HIGHER_SEVERITY_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna categoría de gravedad alta.
ADULT_CONTENT_PORNOGRAPHY Contenido para adultos: Pornografía, temas para mayores de edad e imágenes de desnudos.
COPYRIGHT_INFRINGEMENT Infracción de derechos de autor
SUBSTANCE_ABUSE Drogas, alcohol o sustancias controladas: abuso de sustancias.
GRAPHIC_VIOLENCE_WEAPONS Violencia gráfica extrema o armas.
HATE_PROFANITY Odio o lenguaje obsceno.
CRIMINAL_SKILLS Actividades ilegales: destrezas criminales.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incentivo/software malicioso/desordenado.

MediumSeverityCategory

Posibles opciones para las categorías de gravedad media.

Enumeradores
MEDIUM_SEVERITY_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna categoría de gravedad media.
AD_SERVERS Servidores de anuncios.
ADULT_CONTENT_SWIMSUIT Contenido para adultos: Trajes de baño.
ALTERNATIVE_LIFESTYLES Temas polémicos: estilos de vida alternativos.
CELEBRITY_GOSSIP Temas polémicos: chismes sobre celebridades.
GAMBLING Temas polémicos: Juegos de apuestas.
OCCULT Temas polémicos: Ocultismo.
SEX_EDUCATION Temas polémicos: Educación sexual.
DISASTER_AVIATION Desastre: aviación.
DISASTER_MAN_MADE Desastre: Artificial.
DISASTER_NATURAL Desastre: natural.
DISASTER_TERRORIST_EVENTS Desastre: Acontecimientos terroristas.
DISASTER_VEHICLE Desastre: vehículo.
ALCOHOL Drogas/alcohol/Sustancias controladas: alcohol.
SMOKING Drogas, alcohol o sustancias controladas: fumar.
NEGATIVE_NEWS_FINANCIAL Noticias negativas: finanzas.
NON_ENGLISH Contenido no estándar: no está en inglés.
PARKING_PAGE Contenido no estándar: Página de estacionamiento.
UNMODERATED_UGC CGU no moderado: Foros, imágenes y videos.
INFLAMMATORY_POLITICS_AND_NEWS Temas polémicos: política y noticias polémicas.
NEGATIVE_NEWS_PHARMACEUTICAL Noticias negativas: productos farmacéuticos.

AgeRating

Opciones posibles de clasificaciones por edad.

Enumeradores
AGE_RATING_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de clasificación por edad.
APP_AGE_RATE_UNKNOWN Apps con clasificación por edad desconocida
APP_AGE_RATE_4_PLUS Apps clasificadas para todo público (4 o más).
APP_AGE_RATE_9_PLUS Apps clasificadas para todo público (mayores de 9 años)
APP_AGE_RATE_12_PLUS Aplicaciones clasificadas para adolescentes (mayores de 12 años).
APP_AGE_RATE_17_PLUS Apps clasificadas para mayores de 17 años
APP_AGE_RATE_18_PLUS Apps clasificadas como solo para adultos (mayores de 18 años).

AppStarRating

Detalles de la configuración de calificación por estrellas en DoubleVerify.

Representación JSON
{
  "avoidedStarRating": enum (StarRating),
  "avoidInsufficientStarRating": boolean
}
Campos
avoidedStarRating

enum (StarRating)

Evita ofertar en aplicaciones con calificaciones por estrellas.

avoidInsufficientStarRating

boolean

Evita ofertar en aplicaciones que no cuentan con suficientes calificaciones por estrellas.

StarRating

Posibles opciones de calificación por estrellas

Enumeradores
APP_STAR_RATE_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de calificación por estrellas de la app.
APP_STAR_RATE_1_POINT_5_LESS Apps oficiales con menos de 1.5 estrellas.
APP_STAR_RATE_2_LESS Apps oficiales con una calificación de menos de 2 estrellas.
APP_STAR_RATE_2_POINT_5_LESS Apps oficiales con una calificación de menos de 2.5 estrellas.
APP_STAR_RATE_3_LESS Apps oficiales con una calificación de menos de 3 estrellas.
APP_STAR_RATE_3_POINT_5_LESS Apps oficiales con una calificación de < 3.5 estrellas.
APP_STAR_RATE_4_LESS Apps oficiales con menos de 4 estrellas.
APP_STAR_RATE_4_POINT_5_LESS Apps oficiales con menos de 4.5 estrellas.

DisplayViewability

Detalles de la configuración de visibilidad de Display de DoubleVerify.

Representación JSON
{
  "iab": enum (IAB),
  "viewableDuring": enum (ViewableDuring)
}
Campos
iab

enum (IAB)

Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB.

viewableDuring

enum (ViewableDuring)

Segmenta el inventario web y de aplicaciones para maximizar la duración visible del 100%.

IAB

Posibles opciones para la tasa visible de IAB

Enumeradores
IAB_VIEWED_RATE_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de tasa de vistas de IAB.
IAB_VIEWED_RATE_80_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 80% o más.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 75% o superior.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 70% o más.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 65% o más.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 60% o más.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 55% o más.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 50% o más.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 40% o más.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 30% o más.

ViewableDuring

Opciones posibles para la duración visible.

Enumeradores
AVERAGE_VIEW_DURATION_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de duración promedio de vistas.
AVERAGE_VIEW_DURATION_5_SEC Segmenta el inventario web y de aplicaciones para maximizar la duración del 100% visible de 5 segundos o más.
AVERAGE_VIEW_DURATION_10_SEC Segmenta el inventario web y de aplicaciones para maximizar la duración visible del 100% durante 10 segundos o más.
AVERAGE_VIEW_DURATION_15_SEC Segmenta el inventario web y de aplicaciones para maximizar la duración del 100% visible de 15 segundos o más.

VideoViewability

Detalles de la configuración de visibilidad de video de DoubleVerify.

Representación JSON
{
  "videoIab": enum (VideoIAB),
  "videoViewableRate": enum (VideoViewableRate),
  "playerImpressionRate": enum (PlayerImpressionRate)
}
Campos
videoIab

enum (VideoIAB)

Segmenta el inventario web para maximizar la tasa visible de IAB.

videoViewableRate

enum (VideoViewableRate)

Segmenta el inventario web para maximizar la tasa completamente visible.

playerImpressionRate

enum (PlayerImpressionRate)

Segmenta el inventario para maximizar las impresiones con un tamaño de reproductor de 400 x 300 o superior.

VideoIAB

Posibles opciones de porcentaje de visibilidad de IAB

Enumeradores
VIDEO_IAB_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de tasa visible de video de IAB.
IAB_VIEWABILITY_80_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 80% o más.
IAB_VIEWABILITY_75_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 75% o superior.
IAB_VIEWABILITY_70_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 70% o más.
IAB_VIEWABILITY_65_PERCENT_HIHGER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 65% o más.
IAB_VIEWABILITY_60_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 60% o más.
IAB_VIEWABILITY_55_PERCENT_HIHGER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 55% o más.
IAB_VIEWABILITY_50_PERCENT_HIGHER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 50% o más.
IAB_VIEWABILITY_40_PERCENT_HIHGER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 40% o más.
IAB_VIEWABILITY_30_PERCENT_HIHGER Segmenta el inventario web y de aplicaciones para maximizar la tasa visible de IAB en un 30% o más.

VideoViewableRate

Opciones posibles de porcentaje de visibilidad total.

Enumeradores
VIDEO_VIEWABLE_RATE_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de tasa de visibilidad de video.
VIEWED_PERFORMANCE_40_PERCENT_HIGHER Segmenta el inventario web para maximizar la tasa de visibilidad total en un 40% o más.
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Segmenta el inventario web para maximizar la tasa de visibilidad total del 35% o más.
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Segmenta el inventario web para maximizar la tasa de visibilidad total en un 30% o más.
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Segmenta el inventario web para maximizar la tasa de visibilidad total del 25% o más.
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Segmenta el inventario web para maximizar la tasa de visibilidad total en un 20% o más.
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Segmenta el inventario web para maximizar la tasa de visibilidad total del 10% o más.

PlayerImpressionRate

Opciones posibles de impresiones.

Enumeradores
PLAYER_SIZE_400X300_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de impresión.
PLAYER_SIZE_400X300_95 Sitios con más del 95%de impresiones.
PLAYER_SIZE_400X300_70 Sitios con más del 70%de impresiones.
PLAYER_SIZE_400X300_25 Sitios con más del 25%de impresiones.
PLAYER_SIZE_400X300_5 Sitios con un 5%o más de impresiones.

FraudInvalidTraffic

Configuración de fraude y tráfico no válido de DoubleVerify.

Representación JSON
{
  "avoidedFraudOption": enum (FraudOption),
  "avoidInsufficientOption": boolean
}
Campos
avoidedFraudOption

enum (FraudOption)

Evite los sitios y aplicaciones que tengan un historial de fraude y IVT.

avoidInsufficientOption

boolean

Estadísticas de fraude histórico y IVT insuficientes.

FraudOption

Posibles opciones de porcentaje histórico de fraude y de IVT.

Enumeradores
FRAUD_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de fraude ni tráfico no válido.
AD_IMPRESSION_FRAUD_100 100% de fraude y IVT.
AD_IMPRESSION_FRAUD_50 50% o más de fraude y IVT.
AD_IMPRESSION_FRAUD_25 un 25% o más de fraude y IVT.
AD_IMPRESSION_FRAUD_10 un 10% o más de fraude y IVT.
AD_IMPRESSION_FRAUD_8 8% o más de fraude y IVT.
AD_IMPRESSION_FRAUD_6 un 6% o más de fraude y IVT.
AD_IMPRESSION_FRAUD_4 un 4% o más de fraude y IVT.
AD_IMPRESSION_FRAUD_2 un 2% o más de fraude y IVT.

IntegralAdScience

Detalles de la configuración de Integral Ad Science

Representación JSON
{
  "traqScoreOption": enum (TRAQScore),
  "excludeUnrateable": boolean,
  "excludedAdultRisk": enum (Adult),
  "excludedAlcoholRisk": enum (Alcohol),
  "excludedIllegalDownloadsRisk": enum (IllegalDownloads),
  "excludedDrugsRisk": enum (Drugs),
  "excludedHateSpeechRisk": enum (HateSpeech),
  "excludedOffensiveLanguageRisk": enum (OffensiveLanguage),
  "excludedViolenceRisk": enum (Violence),
  "excludedGamblingRisk": enum (Gambling),
  "excludedAdFraudRisk": enum (AdFraudPrevention),
  "displayViewability": enum (DisplayViewability),
  "videoViewability": enum (VideoViewability),
  "customSegmentId": [
    string
  ]
}
Campos
traqScoreOption

enum (TRAQScore)

Es la verdadera calidad de la publicidad (aplicable solo a las líneas de pedido de Display).

excludeUnrateable

boolean

Seguridad de la marca: inaltable.

excludedAdultRisk

enum (Adult)

Seguridad de la marca: Contenido para adultos.

excludedAlcoholRisk

enum (Alcohol)

Seguridad de la marca: Alcohol.

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Seguridad de la marca: Descargas ilegales.

excludedDrugsRisk

enum (Drugs)

Seguridad de la marca: drogas.

excludedHateSpeechRisk

enum (HateSpeech)

Seguridad de la marca: incitación al odio o a la violencia.

excludedOffensiveLanguageRisk

enum (OffensiveLanguage)

Seguridad de la marca: Lenguaje ofensivo.

excludedViolenceRisk

enum (Violence)

Seguridad de la marca: Violencia.

excludedGamblingRisk

enum (Gambling)

Seguridad de la marca: Juegos de apuestas

excludedAdFraudRisk

enum (AdFraudPrevention)

Configuración de fraude publicitario.

displayViewability

enum (DisplayViewability)

Sección Visibilidad de Display (aplicable solo para las líneas de pedido de anuncios gráficos).

videoViewability

enum (VideoViewability)

Sección Visibilidad de Video (aplicable solo a las líneas de pedido de video).

customSegmentId[]

string (int64 format)

El ID de segmento personalizado que proporciona Integral Ad Science El ID debe estar entre 1000001 y 1999999 inclusive.

TRAQScore

Posibles rangos de puntuación del TRAQ (calidad de la publicidad real) de Integral Ad Science

Enumeradores
TRAQ_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ningún nivel de calidad de la publicidad verdadero.
TRAQ_250 Una puntuación de TRAQ: 250-1,000.
TRAQ_500 Una puntuación de TRAQ: 500-1,000.
TRAQ_600 La puntuación de TRAQ es de 600 a 1,000.
TRAQ_700 La puntuación de TRAQ es de 700 a 1,000.
TRAQ_750 Una puntuación de TRAQ: 750-1,000.
TRAQ_875 La puntuación de TRAQ es de 875 a 1,000.
TRAQ_1000 Una puntuación de TRAQ: 1,000.

Adult

Posibles opciones para adultos de Integral Ad Science

Enumeradores
ADULT_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción "adulto".
ADULT_HR Adultos: Excluir el riesgo alto.
ADULT_HMR Adultos: Excluya el riesgo alto y moderado.

Bebidas alcohólicas

Posibles opciones de bebidas alcohólicas de Integral Ad Science

Enumeradores
ALCOHOL_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de bebidas alcohólicas.
ALCOHOL_HR Bebidas alcohólicas: Excluya el riesgo alto.
ALCOHOL_HMR Bebidas alcohólicas: Excluya el riesgo alto y moderado.

IllegalDownloads

Posibles opciones de descarga ilegal de Integral Ad Science

Enumeradores
ILLEGAL_DOWNLOADS_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de descarga ilegal.
ILLEGAL_DOWNLOADS_HR Descargas ilegales: excluye el riesgo alto.
ILLEGAL_DOWNLOADS_HMR Descargas ilegales: excluye el riesgo alto y moderado.

Fármacos

Posibles opciones de Integral Ad Science Drugs.

Enumeradores
DRUGS_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de drogas.
DRUGS_HR Medicamentos: Excluya el riesgo alto.
DRUGS_HMR Medicamentos: Excluya el riesgo alto y moderado.

HateSpeech

Posibles opciones de Integral Ad Science sobre la incitación al odio o a la violencia.

Enumeradores
HATE_SPEECH_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de incitación al odio o a la violencia.
HATE_SPEECH_HR Incitación al odio o a la violencia: excluir alto riesgo.
HATE_SPEECH_HMR Incitación al odio o a la violencia: excluya el riesgo alto y moderado.

OffensiveLanguage

Posibles opciones de lenguaje ofensivo de Integral Ad Science.

Enumeradores
OFFENSIVE_LANGUAGE_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de idioma.
OFFENSIVE_LANGUAGE_HR Lenguaje ofensivo: Excluye el alto riesgo.
OFFENSIVE_LANGUAGE_HMR Lenguaje ofensivo: Excluya el riesgo alto y moderado.

Violencia

Posibles opciones de Violencia de Integral Ad Science

Enumeradores
VIOLENCE_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de violencia.
VIOLENCE_HR Violencia: excluir alto riesgo.
VIOLENCE_HMR Violencia: excluir el riesgo alto y moderado.

Juegos de apuestas

Posibles opciones de juegos de apuestas de Integral Ad Science

Enumeradores
GAMBLING_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica opciones de juegos de apuestas.
GAMBLING_HR Juegos de apuestas: excluir el riesgo alto.
GAMBLING_HMR Juegos de apuestas: excluya el riesgo alto y moderado.

AdFraudPrevention

Posibles opciones de prevención de fraudes relacionados con anuncios de Integral Ad Science

Enumeradores
SUSPICIOUS_ACTIVITY_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de prevención de fraude publicitario.
SUSPICIOUS_ACTIVITY_HR Fraude publicitario: Excluir el riesgo alto.
SUSPICIOUS_ACTIVITY_HMR Fraude Publicitario: Excluya el riesgo alto y moderado.

DisplayViewability

Posibles opciones de visibilidad de Display de Integral Ad Science

Enumeradores
PERFORMANCE_VIEWABILITY_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de visibilidad de visualización.
PERFORMANCE_VIEWABILITY_40 Objetivo de visibilidad del 40% o superior.
PERFORMANCE_VIEWABILITY_50 Orientar a un 50% de visibilidad o a uno superior.
PERFORMANCE_VIEWABILITY_60 Objetivo de visibilidad del 60% o superior
PERFORMANCE_VIEWABILITY_70 Objetivo de visibilidad del 70% o superior.

VideoViewability

Posibles opciones de visibilidad de video de Integral Ad Science

Enumeradores
VIDEO_VIEWABILITY_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de visibilidad de video.
VIDEO_VIEWABILITY_40 Es de más del 40%visible (estándar de visibilidad de video de la IAB).
VIDEO_VIEWABILITY_50 Más del 50%visibles (estándar de visibilidad de video de la IAB).
VIDEO_VIEWABILITY_60 Más del 60%de vistas (estándar de visibilidad de video de la IAB).
VIDEO_VIEWABILITY_70 Más del 70%de vistas (estándar de visibilidad de video de la IAB).

PoiAssignedTargetingOptionDetails

Detalles de la opción de segmentación de lugares de interés asignados. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_POI.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "latitude": number,
  "longitude": number,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Campos
displayName

string

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

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_POI.

Los IDs de opciones de segmentación de lugares de interés aceptados se pueden recuperar mediante SearchTargetingOptions.

Si quitas una coordenada de latitud y longitud específica de una dirección o del nombre de un lugar de interés, puedes generar el ID de opción de segmentación necesario redondeando los valores de coordenadas deseados al sexto decimal, quitando los decimales y concatenando los valores de cadena separados por punto y coma. Por ejemplo, puedes orientar al par latitud-longitud de 40,7414691, -74,003387 mediante el ID de opción de segmentación "40741469;-74003387".

latitude

number

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

longitude

number

Solo salida. Longitud del lugar de interés que se redondea al sexto decimal.

proximityRadiusAmount

number

Obligatorio. Es el radio del área alrededor del lugar de interés a la que deseas apuntar. Las unidades del radio se especifican mediante proximityRadiusUnit. Debe ser de 1 a 800 si la unidad es DISTANCE_UNIT_KILOMETERS y de 1 a 500 si la unidad es DISTANCE_UNIT_MILES.

proximityRadiusUnit

enum (DistanceUnit)

Obligatorio. Es la unidad de distancia por la que se mide el radio de orientación.

DistanceUnit

Posibles opciones de unidades de distancia.

Enumeradores
DISTANCE_UNIT_UNSPECIFIED No se especificó el valor del tipo o se desconoce en esta versión.
DISTANCE_UNIT_MILES Millas.
DISTANCE_UNIT_KILOMETERS Kilómetros.

BusinessChainAssignedTargetingOptionDetails

Detalles de la opción de segmentación de la cadena empresarial asignada. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_BUSINESS_CHAIN.

Representación JSON
{
  "displayName": string,
  "targetingOptionId": string,
  "proximityRadiusAmount": number,
  "proximityRadiusUnit": enum (DistanceUnit)
}
Campos
displayName

string

Solo salida. El nombre visible de una cadena de empresas, p.ej., "KFC" o "Chase Bank".

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_BUSINESS_CHAIN.

Los IDs de las opciones de segmentación de la cadena de empresas aceptadas se pueden recuperar mediante SearchTargetingOptions.

proximityRadiusAmount

number

Obligatorio. El radio del área alrededor de la cadena de empresas de segmentación. Las unidades del radio se especifican mediante proximityRadiusUnit. Debe ser de 1 a 800 si la unidad es DISTANCE_UNIT_KILOMETERS y de 1 a 500 si la unidad es DISTANCE_UNIT_MILES. El incremento mínimo en ambos casos es de 0.1. Las entradas se redondearán al valor aceptable más cercano si son demasiado detallados, p.ej., 15.57 se convertirá en 15.6.

proximityRadiusUnit

enum (DistanceUnit)

Obligatorio. Es la unidad de distancia por la que se mide el radio de orientación.

ContentDurationAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada por la duración del contenido. Se propagará en el campo contentDurationDetails cuando targetingType sea TARGETING_TYPE_CONTENT_DURATION. No se admite la segmentación explícita a todas las opciones. Para lograr este efecto, quita todas las opciones de segmentación por duración del contenido.

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

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_CONTENT_DURATION.

contentDuration

enum (ContentDuration)

Solo salida. Es la duración del contenido.

ContentStreamTypeAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada al tipo de transmisión de contenido. Se propagará en el campo contentStreamTypeDetails cuando targetingType sea TARGETING_TYPE_CONTENT_STREAM_TYPE. No se admite la segmentación explícita a todas las opciones. Para lograr este efecto, quita todas las opciones de segmentación por tipo de transmisión de contenido.

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

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_CONTENT_STREAM_TYPE.

contentStreamType

enum (ContentStreamType)

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

NativeContentPositionAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada a la posición del contenido nativo. Se propagará en el campo nativeContentPositionDetails cuando targetingType sea TARGETING_TYPE_NATIVE_CONTENT_POSITION. No se admite la segmentación explícita a todas las opciones. Para lograr este efecto, quita todas las opciones de segmentación de posición del contenido nativo.

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

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_NATIVE_CONTENT_POSITION.

contentPosition

enum (NativeContentPosition)

Es la posición del contenido.

Resultado solo en la versión v1. Obligatorio en la v2.

OmidAssignedTargetingOptionDetails

Representa un tipo de inventario habilitado de Open Measurement que se puede orientar. Se propagará en el campo de detalles de una opción AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_OMID.

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

enum (Omid)

Es el tipo de inventario habilitado para Open Measurement.

Resultado solo en la versión v1. Obligatorio en la v2.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_OMID.

AudioContentTypeAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada por el tipo de contenido de audio. Se propagará en el campo audioContentTypeDetails cuando targetingType sea TARGETING_TYPE_AUDIO_CONTENT_TYPE. No se admite la segmentación explícita a todas las opciones. Para lograr este efecto, quita todas las opciones de segmentación por tipo de contenido de audio.

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

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_AUDIO_CONTENT_TYPE.

audioContentType

enum (AudioContentType)

Es el tipo de contenido de audio.

Resultado solo en la versión v1. Obligatorio en la v2.

ContentGenreAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada por género del contenido. Se propagará en el campo contentGenreDetails cuando targetingType sea TARGETING_TYPE_CONTENT_GENRE. No se admite la segmentación explícita a todas las opciones. Para lograr este efecto, quita todas las opciones de segmentación por género de contenido.

Representación JSON
{
  "targetingOptionId": string,
  "displayName": string,
  "negative": boolean
}
Campos
targetingOptionId

string

Obligatorio. El campo targetingOptionId cuando targetingType es TARGETING_TYPE_CONTENT_GENRE.

displayName

string

Solo salida. Es el nombre visible del género del contenido.

negative

boolean

Indica si esta opción se está segmentando de forma negativa.

Métodos

get

Obtiene una sola opción de segmentación asignada a una campaña.

list

Muestra las opciones de segmentación asignadas a una campaña para un tipo de segmentación específico.