REST Resource: advertisers.adGroups.targetingTypes.assignedTargetingOptions

Recurso: AssignedTargetingOption

Es 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,
  "assignedTargetingOptionIdAlias": 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)
  },
  "youtubeVideoDetails": {
    object (YoutubeVideoAssignedTargetingOptionDetails)
  },
  "youtubeChannelDetails": {
    object (YoutubeChannelAssignedTargetingOptionDetails)
  },
  "sessionPositionDetails": {
    object (SessionPositionAssignedTargetingOptionDetails)
  }
  // End of list of possible types for union field details.
}
Campos
name

string

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

assignedTargetingOptionId

string

Solo salida. Es el ID único de la opción de segmentación asignada. El ID solo es único dentro de un recurso y tipo de segmentación determinados. Es posible que se reutilice en otros contextos.

assignedTargetingOptionIdAlias

string

Solo salida. Es un alias para assignedTargetingOptionId. Este valor se puede utilizar en lugar de assignedTargetingOptionId cuando se recupera o se borra la segmentación existente.

Este campo solo se admitirá para todas las opciones de segmentación asignadas de los siguientes tipos de segmentación:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

Este campo también se admite para las opciones de segmentación asignadas a líneas de pedido de los siguientes tipos de segmentación:

  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
targetingType

enum (TargetingType)

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

inheritance

enum (Inheritance)

Solo salida. El estado heredado 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 en los 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 completará cuando el valor de targetingType sea TARGETING_TYPE_CHANNEL.

appCategoryDetails

object (AppCategoryAssignedTargetingOptionDetails)

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

appDetails

object (AppAssignedTargetingOptionDetails)

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

urlDetails

object (UrlAssignedTargetingOptionDetails)

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

dayAndTimeDetails

object (DayAndTimeAssignedTargetingOptionDetails)

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

ageRangeDetails

object (AgeRangeAssignedTargetingOptionDetails)

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

regionalLocationListDetails

object (RegionalLocationListAssignedTargetingOptionDetails)

Detalles de la lista de ubicaciones regionales. Este campo se completará 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 completará cuando el valor de targetingType sea TARGETING_TYPE_PROXIMITY_LOCATION_LIST.

genderDetails

object (GenderAssignedTargetingOptionDetails)

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

videoPlayerSizeDetails

object (VideoPlayerSizeAssignedTargetingOptionDetails)

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

userRewardedContentDetails

object (UserRewardedContentAssignedTargetingOptionDetails)

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

parentalStatusDetails

object (ParentalStatusAssignedTargetingOptionDetails)

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

contentInstreamPositionDetails

object (ContentInstreamPositionAssignedTargetingOptionDetails)

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

contentOutstreamPositionDetails

object (ContentOutstreamPositionAssignedTargetingOptionDetails)

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

deviceTypeDetails

object (DeviceTypeAssignedTargetingOptionDetails)

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

audienceGroupDetails

object (AudienceGroupAssignedTargetingOptionDetails)

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

browserDetails

object (BrowserAssignedTargetingOptionDetails)

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

householdIncomeDetails

object (HouseholdIncomeAssignedTargetingOptionDetails)

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

onScreenPositionDetails

object (OnScreenPositionAssignedTargetingOptionDetails)

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

carrierAndIspDetails

object (CarrierAndIspAssignedTargetingOptionDetails)

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

keywordDetails

object (KeywordAssignedTargetingOptionDetails)

Detalles de la palabra clave Este campo se completará 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 completará 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 del sistema operativo Este campo se completará 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 completará cuando el valor de targetingType sea TARGETING_TYPE_DEVICE_MAKE_MODEL.

environmentDetails

object (EnvironmentAssignedTargetingOptionDetails)

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

inventorySourceDetails

object (InventorySourceAssignedTargetingOptionDetails)

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

categoryDetails

object (CategoryAssignedTargetingOptionDetails)

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

Cuando segmentes anuncios para una categoría, también se segmentarán para sus subcategorías. Si se excluye una categoría de la orientación y se incluye una subcategoría, prevalecerá la exclusión.

viewabilityDetails

object (ViewabilityAssignedTargetingOptionDetails)

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

Solo puedes establecer como objetivo una opción de visibilidad por recurso.

authorizedSellerStatusDetails

object (AuthorizedSellerStatusAssignedTargetingOptionDetails)

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

Solo puedes segmentar la campaña para 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án de forma predeterminada todos los vendedores autorizados que se indiquen como DIRECTO o REVENDEDOR en el archivo ads.txt.

languageDetails

object (LanguageAssignedTargetingOptionDetails)

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

geoRegionDetails

object (GeoRegionAssignedTargetingOptionDetails)

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

inventorySourceGroupDetails

object (InventorySourceGroupAssignedTargetingOptionDetails)

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

digitalContentLabelExclusionDetails

object (DigitalContentLabelAssignedTargetingOptionDetails)

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

Las etiquetas de contenido digital son exclusiones de segmentación. Las exclusiones de etiquetas de contenido digital a nivel del anunciante, si se configuran, siempre se aplican durante 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 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ía sensible. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION.

Las categorías sensibles son exclusiones de segmentación. Las exclusiones de categorías sensibles a nivel del anunciante, si se configuran, 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 exclusiones de anunciantes, pero no puede anularlas.

exchangeDetails

object (ExchangeAssignedTargetingOptionDetails)

Detalles de Exchange. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_EXCHANGE.

subExchangeDetails

object (SubExchangeAssignedTargetingOptionDetails)

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

thirdPartyVerifierDetails

object (ThirdPartyVerifierAssignedTargetingOptionDetails)

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

poiDetails

object (PoiAssignedTargetingOptionDetails)

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

businessChainDetails

object (BusinessChainAssignedTargetingOptionDetails)

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

contentDurationDetails

object (ContentDurationAssignedTargetingOptionDetails)

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

contentStreamTypeDetails

object (ContentStreamTypeAssignedTargetingOptionDetails)

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

nativeContentPositionDetails

object (NativeContentPositionAssignedTargetingOptionDetails)

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

omidDetails

object (OmidAssignedTargetingOptionDetails)

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

audioContentTypeDetails

object (AudioContentTypeAssignedTargetingOptionDetails)

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

contentGenreDetails

object (ContentGenreAssignedTargetingOptionDetails)

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

youtubeVideoDetails

object (YoutubeVideoAssignedTargetingOptionDetails)

Detalles del video de YouTube. Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_YOUTUBE_VIDEO.

youtubeChannelDetails

object (YoutubeChannelAssignedTargetingOptionDetails)

Detalles del canal de YouTube Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_YOUTUBE_CHANNEL.

sessionPositionDetails

object (SessionPositionAssignedTargetingOptionDetails)

Detalles de la posición de la sesión Este campo se completará cuando el valor de targetingType sea TARGETING_TYPE_SESSION_POSITION.

Herencia

Indica si la opción de segmentación asignada se heredó de una entidad de nivel superior, como un socio o un anunciante. Las opciones de segmentación asignadas heredadas tienen precedencia y siempre se aplican cuando se publica antes que la segmentación asignada en el nivel actual y no se pueden modificar a través del servicio de entidad actual. Se deben modificar a través del servicio de entidad del 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 superior.

Enumeraciones
INHERITANCE_UNSPECIFIED La herencia no se especifica o es desconocida.
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 segmentación de socios.
INHERITED_FROM_ADVERTISER La opción de segmentación asignada se hereda de la configuración de segmentación del anunciante.

ChannelAssignedTargetingOptionDetails

Detalles de la opción de segmentación por canal asignada. Se propagará en el campo de detalles de una 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 hacer referencia al campo ID del canal en un recurso de canal propiedad del socio o canal de un anunciante.

negative

boolean

Indica si esta opción tiene una segmentación negativa. Para 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 aplicación asignada. Se completará 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 tiene una segmentación negativa.

AppAssignedTargetingOptionDetails

Detalles de la opción de segmentación de la app asignada. Se propagará en el campo de detalles de una 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 para Android usa el ID del paquete, por ejemplo, com.google.android.gm. El ID de la aplicación de la 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 tiene una segmentación negativa.

appPlatform

enum (AppPlatform)

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

AppPlatform

Posibles opciones de segmentación de la plataforma de aplicaciones.

Enumeraciones
APP_PLATFORM_UNSPECIFIED El valor predeterminado cuando no se especifica la plataforma de la app en esta versión. Esta enum es un marcador de posición para el valor predeterminado y no representa una opción real de la plataforma.
APP_PLATFORM_IOS La plataforma de la app es iOS.
APP_PLATFORM_ANDROID La plataforma de la app es Android.
APP_PLATFORM_ROKU La plataforma de la app es Roku.
APP_PLATFORM_AMAZON_FIRETV La plataforma de la app 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 la app es Xbox.
APP_PLATFORM_SAMSUNG_TV La plataforma de la app es Samsung TV.
APP_PLATFORM_ANDROID_TV La plataforma de apps es Android TV.
APP_PLATFORM_GENERIC_CTV La plataforma de la app es una plataforma de CTV que no aparece explícitamente en ninguna otra parte.
APP_PLATFORM_LG_TV La plataforma de la app es LG TV.
APP_PLATFORM_VIZIO_TV La plataforma de la app es VIZIO TV.

UrlAssignedTargetingOptionDetails

Detalles de la opción de segmentación de URL asignada. Se propagará en el campo de detalles de una 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 tiene una segmentación negativa.

DayAndTimeAssignedTargetingOptionDetails

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

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

enum (DayOfWeek)

Obligatorio. Se refiere al día de la semana de esta configuración de segmentación por día y horario.

startHour

integer

Obligatorio. Es la hora de inicio de la segmentación por día y horario. El valor debe estar comprendido entre 0 (inicio del día) y 23 (1 hora antes de que termine el día).

endHour

integer

Obligatorio. Indica la hora de finalización de la segmentación por día y horario. La duración debe estar comprendida entre 1 (1 hora después del inicio del día) y 24 (final del día).

timeZoneResolution

enum (TimeZoneResolution)

Obligatorio. Es el mecanismo que se utiliza para determinar qué zona horaria utilizar para esta configuración de segmentación por día y horario.

DayOfWeek

Representa un día de la semana.

Enumeraciones
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.

Enumeraciones
TIME_ZONE_RESOLUTION_UNSPECIFIED La resolución de la zona horaria es poco específica o desconocida.
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 AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_AGE_RANGE.

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

enum (AgeRange)

Obligatorio. Indica el rango etario del público. Solo admitimos la orientación a un rango de edad continuo de un público. Por lo tanto, el rango de edad representado en este campo puede 1) orientarse únicamente o 2) ser parte de un rango de edad continuo más amplio. El alcance de la segmentación por rango de edad continuo también se puede expandir si se segmenta para un público de edad desconocida.

RegionalLocationListAssignedTargetingOptionDetails

Detalles de segmentación para la lista de ubicaciones regionales. Se propagará en el campo de detalles de una 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 tiene una segmentación negativa.

ProximityLocationListAssignedTargetingOptionDetails

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

Representación JSON
{
  "proximityLocationListId": string,
  "proximityRadius": number,
  "proximityRadiusUnit": enum (ProximityRadiusUnit)
}
Campos
proximityLocationListId

string (int64 format)

Obligatorio. Es el 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.

proximityRadius

number

Obligatorio. El radio expresado en las unidades de distancia establecidas en proximityRadiusUnit. Representa el tamaño del área alrededor de la ubicación seleccionada que se orientará. El radio debe ser de entre 1 y 500 millas o 800 kilómetros.

proximityRadiusUnit

enum (ProximityRadiusUnit)

Obligatorio. Unidades de radio para distancia.

ProximityRadiusUnit

Enum de unidades de distancia para ProximityRadius.

Enumeraciones
PROXIMITY_RADIUS_UNIT_UNSPECIFIED El valor predeterminado cuando no se especifican las unidades de distancia en esta versión. Esta enumeración es un marcador de posición para el valor predeterminado y no representa una unidad de distancia real.
PROXIMITY_RADIUS_UNIT_MILES Unidad de distancia del radio en millas.
PROXIMITY_RADIUS_UNIT_KILOMETERS Unidad de distancia del radio en kilómetros

GenderAssignedTargetingOptionDetails

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

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

enum (Gender)

Obligatorio. Indica el género del público.

VideoPlayerSizeAssignedTargetingOptionDetails

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

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

enum (VideoPlayerSize)

Obligatorio. El tamaño del reproductor de video.

UserRewardedContentAssignedTargetingOptionDetails

Detalles de la opción de segmentación de contenido recompensado del usuario Se completará 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. 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 AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_PARENTAL_STATUS.

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

enum (ParentalStatus)

Obligatorio. Es el estado parental del público.

ContentInstreamPositionAssignedTargetingOptionDetails

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

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

enum (ContentInstreamPosition)

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

adType

enum (AdType)

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

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

AdType

Representa el tipo de creatividad asociado con los anuncios.

Enumeraciones
AD_TYPE_UNSPECIFIED No se especificó el tipo de anuncio en esta versión o se desconoce.
AD_TYPE_DISPLAY Creatividades de anuncios gráficos, 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 el contenido de audio.

ContentOutstreamPositionAssignedTargetingOptionDetails

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

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

enum (ContentOutstreamPosition)

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

adType

enum (AdType)

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

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

DeviceTypeAssignedTargetingOptionDetails

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

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

enum (DeviceType)

Obligatorio. El nombre visible del tipo de dispositivo.

youtubeAndPartnersBidMultiplier

number

Solo salida. El multiplicador de ofertas le permite mostrar sus anuncios con mayor o menor frecuencia según el tipo de dispositivo. Se aplicará un multiplicador sobre el precio de la oferta original. Cuando este campo es 0, indica que no es aplicable en lugar de multiplicar 0 sobre el precio de la oferta original.

Por ejemplo, si el precio de la oferta sin multiplicador es de USD 10.0 y el multiplicador es 1.5 para tablets, el precio de la oferta resultante para tablets será de USD 15.0.

Solo se aplica a las líneas de pedido de YouTube y Partners.

AudienceGroupAssignedTargetingOptionDetails

Detalles de la opción de segmentación del grupo de público asignado. Se propagará en el campo de detalles de una AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_AUDIENCE_GROUP. La relación entre cada grupo es UNION, excepto para excludedFirstAndThirdPartyAudienceGroup y excludedGoogleAudienceGroup, de las cuales COMPLEMENT se usa como una Interestatal 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)

Los ID de público propios y de terceros, y las frecuencias de los grupos de público propios y de terceros incluidos. Cada grupo de público propio y de terceros contiene solo ID de público propios y de terceros. La relación entre cada grupo de público propio y de terceros es Interestatal, 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)

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

includedCustomListGroup

object (CustomListGroup)

Son los IDs de las listas personalizadas del grupo incluido de listas personalizadas. Contiene solo IDs de listas personalizadas.

includedCombinedAudienceGroup

object (CombinedAudienceGroup)

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

excludedFirstAndThirdPartyAudienceGroup

object (FirstAndThirdPartyAudienceGroup)

Los IDs y las frecuencias de los públicos de origen y de terceros del grupo de público propio y de terceros excluido. Se usa para la segmentación negativa. El COMPLEMENTO de la UNIÓN de este grupo y otros grupos de público excluidos se utiliza como una intersección para cualquier segmentación por público positiva. Todos los elementos son lógicamente "OR" entre sí.

excludedGoogleAudienceGroup

object (GoogleAudienceGroup)

Son los ID de público de Google del grupo de público de Google excluido. Se usa para la segmentación negativa. El COMPLEMENTO de la UNIÓN de este grupo y otros grupos de público excluidos se utiliza como una intersección para cualquier segmentación por público positiva. Solo contiene públicos de Google de tipo público afín, en el mercado y de aplicaciones instaladas. Todos los elementos son lógicamente "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 son lógicamente "O" entre sí.

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

object (FirstAndThirdPartyAudienceTargetingSetting)

Obligatorio. Toda la configuración de segmentación por público propia y de terceros en el grupo de público propio y de terceros. No se permiten 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 segmentación por público de origen y de terceros. Este ID es firstAndThirdPartyAudienceId.

recency

enum (Recency)

Indica las visitas recientes de la configuración de 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 admitidos de visitas recientes de públicos propios y de terceros.

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

GoogleAudienceGroup

Detalles del grupo de público de Google. Todos los parámetros de configuración de la segmentación por público de Google son lógicamente "O" entre sí.

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 la Segmentación por público de Google. Este ID es googleAudienceId.

CustomListGroup

Detalles del grupo de listas personalizadas. Todas las configuraciones de segmentación de las listas personalizadas son un operador lógico "O" de la otra parte.

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

object (CustomListTargetingSetting)

Obligatorio. Todos los parámetros de configuración de la segmentación por listas personalizadas en un grupo de listas personalizadas. Se ignorarán las configuraciones repetidas con el mismo ID.

CustomListTargetingSetting

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

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

string (int64 format)

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

CombinedAudienceGroup

Detalles del grupo de público combinado. Todas las configuraciones de segmentación por público combinadas son lógicamente "O" entre sí.

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

object (CombinedAudienceTargetingSetting)

Obligatorio. Toda la configuración de la segmentación por público combinada de un grupo de público combinado. Se ignorarán las configuraciones repetidas con el mismo ID. La cantidad de configuraciones de público combinadas no debe superar los cinco. De lo contrario, se mostrará un error.

CombinedAudienceTargetingSetting

Detalles de la configuración de 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 segmentación por público combinado. 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 AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_BROWSER.

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

string

Solo salida. Indica 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 tiene una segmentación negativa. Todas las opciones de segmentación por navegador asignadas en el mismo recurso deben tener el mismo valor en este campo.

HouseholdIncomeAssignedTargetingOptionDetails

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

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

enum (HouseholdIncome)

Obligatorio. Indica el ingreso familiar del público.

OnScreenPositionAssignedTargetingOptionDetails

Detalles de la opción de segmentación por posición en pantalla. Se completará 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. Es la posición en pantalla.

adType

enum (AdType)

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

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

CarrierAndIspAssignedTargetingOptionDetails

Detalles de la opción de segmentación por operador y ISP asignadas. Se propagará en el campo de detalles de una 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 del ISP.

targetingOptionId

string

Obligatorio. El targetingOptionId de un TargetingOption de tipo TARGETING_TYPE_CARRIER_AND_ISP.

negative

boolean

Indica si esta opción tiene una segmentación negativa. Todas las opciones de segmentación por ISP y operador asignadas en el mismo recurso deben tener el mismo valor en este campo.

KeywordAssignedTargetingOptionDetails

Detalles de la opción de segmentación por palabras clave asignada. Se propagará en el campo de detalles de una 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 tiene una segmentación negativa.

NegativeKeywordListAssignedTargetingOptionDetails

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

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

string (int64 format)

Obligatorio. Es el 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 del sistema operativo asignado. Se completará 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 tiene una segmentación negativa.

DeviceMakeModelAssignedTargetingOptionDetails

Detalles de la opción de segmentación por marca y modelo de dispositivo asignados. Se completará 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 tiene una segmentación negativa.

EnvironmentAssignedTargetingOptionDetails

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

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

enum (Environment)

Obligatorio. El entorno de entrega.

InventorySourceAssignedTargetingOptionDetails

Detalles de segmentación de la fuente de inventario. Se propagará en el campo de detalles de una 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 completará 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 tiene una segmentación negativa.

ViewabilityAssignedTargetingOptionDetails

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

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

enum (Viewability)

Obligatorio. Es el porcentaje de visibilidad previsto.

AuthorizedSellerStatusAssignedTargetingOptionDetails

Representa un estado de vendedor autorizado asignado. Se propagará en el campo de detalles de una 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, utiliza la opción "Vendedores directos y revendedores autorizados". de 12 a 1 con la nueva opción de compresión.

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

enum (AuthorizedSellerStatus)

Solo salida. Indica el estado del vendedor autorizado que se debe incluir en la segmentación.

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 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 tiene una segmentación negativa. Todas las opciones de segmentación por idioma asignadas en el mismo recurso deben tener el mismo valor en 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 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. Es el tipo de segmentación por región geográfica.

negative

boolean

Indica si esta opción tiene una segmentación negativa.

InventorySourceGroupAssignedTargetingOptionDetails

Detalles de segmentación del grupo de fuentes de inventario. Se propagará en el campo de detalles de una 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 de la etiqueta de contenido digital. Se propagará en el campo de detalles de una AssignedTargetingOption cuando targetingType sea TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION.

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

enum (ContentRatingTier)

Obligatorio. El nombre visible del nivel de calificación de las etiquetas de contenido digital que se EXCLUYE.

SensitiveCategoryAssignedTargetingOptionDetails

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

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

enum (SensitiveCategory)

Obligatorio. Una enumeración para el contenido de la categoría sensible de DV360 clasificado como EXCLUIDO.

ExchangeAssignedTargetingOptionDetails

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

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

enum (Exchange)

Obligatorio. El valor de enumeración para el intercambio.

SubExchangeAssignedTargetingOptionDetails

Detalles de la opción de segmentación de intercambio secundario asignada. Se propagará en el campo de detalles de una 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 externo asignado. Se propagará en el campo de detalles de una 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. Se puede orientar a uno de los verificadores de terceros para aplicar umbrales de seguridad de la marca a 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 de terceros: 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

Opciones de Adloox posibles.

Enumeraciones
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 (no apto).
ILLEGAL_CONTENT Contenido ilegal.
BORDERLINE_CONTENT Contenido que se encuentra en el límite de lo aceptable.
DISCRIMINATORY_CONTENT Contenido discriminatorio.
VIOLENT_CONTENT_WEAPONS Contenido violento y armas.
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 del DV.

avoidedAgeRatings[]

enum (AgeRating)

Evita ofertar en aplicaciones con la clasificación por edad.

appStarRating

object (AppStarRating)

Evita ofertar en aplicaciones con calificaciones por estrellas.

displayViewability

object (DisplayViewability)

Configuración de la visibilidad de los anuncios gráficos (aplicable solo para las líneas de pedido de Display).

videoViewability

object (VideoViewability)

Configuración de la visibilidad de video (solo se aplica a las líneas de pedido de video).

fraudInvalidTraffic

object (FraudInvalidTraffic)

Evita los sitios y las aplicaciones con historiales de fraude y Tarifas de IVT.

customSegmentId

string (int64 format)

El ID del segmento personalizado proporcionado por DoubleVerify. El ID debe comenzar con "51" y constan de ocho dígitos. No se puede especificar el ID del segmento personalizado 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 que no se puede calificar.

avoidedHighSeverityCategories[]

enum (HighSeverityCategory)

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

avoidedMediumSeverityCategories[]

enum (MediumSeverityCategory)

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

HighSeverityCategory

Posibles opciones para las categorías de gravedad alta.

Enumeraciones
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 y Imágenes de desnudos
COPYRIGHT_INFRINGEMENT Incumplimiento de los Derechos de Autor.
SUBSTANCE_ABUSE Drogas/Alcohol/Sustancias controladas: Abuso de sustancias.
GRAPHIC_VIOLENCE_WEAPONS Violencia gráfica extrema, violencia explícita o armas.
HATE_PROFANITY Odio o lenguaje obsceno.
CRIMINAL_SKILLS Actividades ilegales: habilidades delictivas.
NUISANCE_INCENTIVIZED_MALWARE_CLUTTER Incentivos, software malicioso o desorden.

MediumSeverityCategory

Opciones posibles para categorías de gravedad media.

Enumeraciones
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: Traje 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: Oculto.
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: Sucesos terroristas.
DISASTER_VEHICLE Desastre: Vehículo.
ALCOHOL Drogas/Alcohol/Sustancias controladas: Alcohol.
SMOKING Drogas/Alcohol/Sustancias controladas: Tabaquismo.
NEGATIVE_NEWS_FINANCIAL Noticias negativas: finanzas.
NON_ENGLISH Contenido no estándar: idiomas distintos al inglés.
PARKING_PAGE Contenido no estándar: Página de estacionamiento.
UNMODERATED_UGC CGU no moderado: foros, imágenes y Video
INFLAMMATORY_POLITICS_AND_NEWS Temas polémicos: política polémica y noticias.
NEGATIVE_NEWS_PHARMACEUTICAL Noticias negativas: Productos farmacéuticos.

AgeRating

Posibles opciones para las clasificaciones por edad.

Enumeraciones
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 clasificaciones por edad desconocidas.
APP_AGE_RATE_4_PLUS Aplicaciones clasificadas para todo público (más de 4 años).
APP_AGE_RATE_9_PLUS Apps clasificadas para todo público (más 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 adultos (mayores de 17 años).
APP_AGE_RATE_18_PLUS Apps clasificadas para adultos (mayores de 18 años).

AppStarRating

Detalles de la configuración de calificaciones por estrellas de 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 tienen suficientes calificaciones por estrellas.

StarRating

Opciones posibles de calificaciones por estrellas.

Enumeraciones
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 Aplicaciones oficiales con calificación < 1.5 estrellas.
APP_STAR_RATE_2_LESS Aplicaciones oficiales con calificación < 2 estrellas.
APP_STAR_RATE_2_POINT_5_LESS Aplicaciones oficiales con calificación < 2.5 estrellas.
APP_STAR_RATE_3_LESS Aplicaciones oficiales con calificación < 3 estrellas.
APP_STAR_RATE_3_POINT_5_LESS Aplicaciones oficiales con calificación < 3.5 estrellas.
APP_STAR_RATE_4_LESS Aplicaciones oficiales con calificación < 4 estrellas.
APP_STAR_RATE_4_POINT_5_LESS Aplicaciones oficiales con calificación < 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)

Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB.

viewableDuring

enum (ViewableDuring)

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

IAB

Opciones posibles para la tasa visible de IAB.

Enumeraciones
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 Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 80% o más.
IAB_VIEWED_RATE_75_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 75% o más.
IAB_VIEWED_RATE_70_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 70% o más.
IAB_VIEWED_RATE_65_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 65% o más.
IAB_VIEWED_RATE_60_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 60% o más.
IAB_VIEWED_RATE_55_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 55% o más.
IAB_VIEWED_RATE_50_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 50% o más.
IAB_VIEWED_RATE_40_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 40% o más.
IAB_VIEWED_RATE_30_PERCENT_HIGHER Segmente el inventario web y de aplicaciones para maximizar la tasa de visibilidad de IAB en un 30% o más.

ViewableDuring

Opciones posibles para la duración visible.

Enumeraciones
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 Segmente la campaña para el inventario web y de aplicaciones para maximizar la duración del 100% de visibilidad durante 5 segundos o más.
AVERAGE_VIEW_DURATION_10_SEC Segmente la campaña para el inventario web y de aplicaciones para maximizar la duración del 100% de visibilidad durante 10 segundos o más.
AVERAGE_VIEW_DURATION_15_SEC Segmente el inventario web y de aplicaciones para maximizar la duración del 100% de visibilidad durante 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)

Segmentar el inventario web para maximizar la tasa de visibilidad de IAB

videoViewableRate

enum (VideoViewableRate)

Segmente el inventario web para maximizar la tasa de visibilidad total.

playerImpressionRate

enum (PlayerImpressionRate)

Segmenta el inventario para maximizar las impresiones con un tamaño de reproductor de 400 × 300 o más grande.

VideoIAB

Opciones posibles de tasa visible de IAB.

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

VideoViewableRate

Opciones posibles de tarifa completamente visible.

Enumeraciones
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 Segmentar el inventario web para maximizar la tasa de visibilidad total en un 40% o más
VIEWED_PERFORMANCE_35_PERCENT_HIGHER Segmentar el inventario web para maximizar la tasa de visibilidad total en un 35% o más
VIEWED_PERFORMANCE_30_PERCENT_HIGHER Segmentar el inventario web para maximizar la tasa de visibilidad total en un 30% o más
VIEWED_PERFORMANCE_25_PERCENT_HIGHER Segmentar el inventario web para maximizar la tasa de visibilidad total en un 25% o más
VIEWED_PERFORMANCE_20_PERCENT_HIGHER Segmentar el inventario web para maximizar la tasa de visibilidad total en un 20% o más
VIEWED_PERFORMANCE_10_PERCENT_HIGHER Segmentar el inventario web para maximizar la tasa de visibilidad total en un 10% o más

PlayerImpressionRate

Opciones posibles de impresiones.

Enumeraciones
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 de un 25%de impresiones.
PLAYER_SIZE_400X300_5 Sitios con un 5%o más de las impresiones

FraudInvalidTraffic

Fraude de DoubleVerify y La configuración de tráfico no es válida.

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

enum (FraudOption)

Evita los sitios y las aplicaciones con historiales de fraude y tráfico no válido.

avoidInsufficientOption

boolean

Fraude histórico insuficiente y Estadísticas de IVT

FraudOption

Posibles opciones del historial de fraude y Tasa de IVT

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

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)

La verdadera calidad de la publicidad (solo se aplica a las líneas de pedido de Display)

excludeUnrateable

boolean

Seguridad de la marca: Inestimable.

excludedAdultRisk

enum (Adult)

Seguridad de la marca: Contenido para adultos

excludedAlcoholRisk

enum (Alcohol)

Seguridad de la Marca - Bebidas alcohólicas.

excludedIllegalDownloadsRisk

enum (IllegalDownloads)

Seguridad de la marca: Descargas ilegales.

excludedDrugsRisk

enum (Drugs)

Seguridad de la marca: Medicamentos.

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)

Visibilidad de Display (aplicable solo a las líneas de pedido de anuncios gráficos).

videoViewability

enum (VideoViewability)

Visibilidad de Video (aplicable solo para las líneas de pedido de video).

customSegmentId[]

string (int64 format)

El ID del segmento personalizado proporcionado por Integral Ad Science. El ID debe estar entre 1000001 y 1999999, ambos incluidos.

TRAQScore

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

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

Adultos

Posibles opciones de Integral Ad Science para adultos

Enumeraciones
ADULT_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción para adultos.
ADULT_HR Adultos: Excluir los riesgos de alto riesgo.
ADULT_HMR Adultos: Excluye los riesgos de riesgo alto y moderado.

Alcohol

Posibles opciones de bebidas alcohólicas de Integral Ad Science

Enumeraciones
ALCOHOL_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de alcohol.
ALCOHOL_HR Bebidas alcohólicas: exclusión de alto riesgo.
ALCOHOL_HMR Bebidas alcohólicas: exclusión de riesgo alto y moderado.

IllegalDownloads

Posibles opciones de descargas ilegales de Integral Ad Science.

Enumeraciones
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: excluir de alto riesgo.
ILLEGAL_DOWNLOADS_HMR Descargas ilegales: excluye el riesgo alto y moderado.

Drogas

Posibles opciones de medicamentos de Integral Ad Science.

Enumeraciones
DRUGS_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de fármacos.
DRUGS_HR Drogas: Excluya el alto riesgo.
DRUGS_HMR Medicamentos: Excluya el riesgo alto y moderado.

HateSpeech

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

Enumeraciones
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: Excluye las actividades de alto riesgo.
HATE_SPEECH_HMR Incitación al odio o a la violencia - Excluye los riesgos de riesgo alto y moderado.

OffensiveLanguage

Posibles opciones de lenguaje de Integral Ad Science Of Para Integral.

Enumeraciones
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: Excluya el riesgo alto.
OFFENSIVE_LANGUAGE_HMR Lenguaje ofensivo: Excluya riesgos altos y moderados.

Violencia

Opciones de Posibles Violencia Ad Science Integral.

Enumeraciones
VIOLENCE_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de violencia.
VIOLENCE_HR Violencia: Excluya el riesgo alto.
VIOLENCE_HMR Violencia: Excluya riesgos altos y moderados.

Juegos de apuestas

Posibles opciones de juegos de apuestas de Integral Ad Science

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

AdFraudPrevention

Posibles opciones de prevención de fraudes de anuncios de Integral Ad Science.

Enumeraciones
SUSPICIOUS_ACTIVITY_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción para prevenir fraudes publicitarios.
SUSPICIOUS_ACTIVITY_HR Fraude publicitario: Excluya el alto riesgo.
SUSPICIOUS_ACTIVITY_HMR Fraude Publicitario: Excluye el riesgo alto y moderado.

DisplayViewability

Posibles opciones de visibilidad de Display de Integral Ad Science

Enumeraciones
PERFORMANCE_VIEWABILITY_UNSPECIFIED Esta enumeración es solo un marcador de posición y no especifica ninguna opción de visibilidad de la pantalla.
PERFORMANCE_VIEWABILITY_40 Segmente sus anuncios para un 40% de visibilidad o más.
PERFORMANCE_VIEWABILITY_50 Segmenta tu campaña para un 50% de visibilidad o más.
PERFORMANCE_VIEWABILITY_60 Segmenta tus anuncios para un 60% de visibilidad o más.
PERFORMANCE_VIEWABILITY_70 Segmente sus anuncios para un 70% de visibilidad o más.

VideoViewability

Posibles opciones de visibilidad de Integral Ad Science Video

Enumeraciones
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 Más del 40%a la vista (estándar de visibilidad de video de IAB).
VIDEO_VIEWABILITY_50 Más del 50%a la vista (estándar de visibilidad de video de IAB).
VIDEO_VIEWABILITY_60 Más del 60%a la vista (estándar de visibilidad de video de IAB).
VIDEO_VIEWABILITY_70 Más del 70%a la vista (estándar de visibilidad de video de IAB).

PoiAssignedTargetingOptionDetails

Son los detalles de la opción de segmentación de lugares de interés asignada. Se propagará en el campo de detalles de una 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", seguida 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 con targetingTypes.targetingOptions.search.

Si orienta sus anuncios a una coordenada de latitud y longitud específica que se quitó de una dirección o un nombre de lugar de interés, puede 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 establecer como objetivo el par latitud-longitud de 40.7414691, -74.003387 con el ID de opción de segmentación "40741469;-74003387". Tras crearlo, el valor de este campo se actualizará para agregar un punto y coma y un valor de hash alfanumérico si solo se proporcionan coordenadas de latitud y longitud.

latitude

number

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

longitude

number

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

proximityRadiusAmount

number

Obligatorio. Es el radio del área alrededor del lugar de interés que se orientará. Las unidades del radio se especifican con 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 segmentación.

DistanceUnit

Posibles opciones de unidad de distancia.

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

BusinessChainAssignedTargetingOptionDetails

Detalles de la opción de segmentación de la cadena comercial asignada. Se propagará en el campo de detalles de una 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 opciones de segmentación de la cadena comercial aceptados se pueden recuperar con SearchTargetingOptions.

proximityRadiusAmount

number

Obligatorio. El radio del área alrededor de la cadena de ubicaciones de la empresa que se orientará. Las unidades del radio se especifican con 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 para ambos casos es 0.1. Las entradas se redondearán al valor aceptable más cercano si son demasiado detalladas; 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 segmentación.

ContentDurationAssignedTargetingOptionDetails

Son los detalles de la opción de segmentación asignada por la duración del contenido. Se completará en el campo contentDurationDetails cuando targetingType sea TARGETING_TYPE_CONTENT_DURATION. No se admite la segmentación explícita para todas las opciones. Quita todas las opciones de segmentación por duración del contenido para lograr este efecto.

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 completará en el campo contentStreamTypeDetails cuando targetingType sea TARGETING_TYPE_CONTENT_STREAM_TYPE. No se admite la segmentación explícita para todas las opciones. Quita todas las opciones de segmentación del tipo de transmisión de contenido para lograr este efecto.

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 por la posición del contenido nativo. Se completará en el campo nativeContentPositionDetails cuando targetingType sea TARGETING_TYPE_NATIVE_CONTENT_POSITION. No se admite la segmentación explícita para todas las opciones. Quita todas las opciones de segmentación de posición de contenido nativo para lograr este efecto.

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

enum (NativeContentPosition)

Obligatorio. Es la posición del contenido.

OmidAssignedTargetingOptionDetails

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

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

enum (Omid)

Obligatorio. Es el tipo de inventario habilitado de Open Measurement.

AudioContentTypeAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada al tipo de contenido de audio. Se completará en el campo audioContentTypeDetails cuando targetingType sea TARGETING_TYPE_AUDIO_CONTENT_TYPE. No se admite la segmentación explícita para todas las opciones. Quita todas las opciones de segmentación por tipo de contenido de audio para lograr este efecto.

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

enum (AudioContentType)

Obligatorio. Es el tipo de contenido de audio.

ContentGenreAssignedTargetingOptionDetails

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

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. El nombre visible del género del contenido.

negative

boolean

Indica si esta opción tiene una segmentación negativa.

YoutubeVideoAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada a videos de YouTube. Se completará en el campo youtubeVideoDetails cuando targetingType sea TARGETING_TYPE_YOUTUBE_VIDEO.

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

string

Identificación de video de YouTube tal como aparece en la página de reproducción de YouTube.

negative

boolean

Indica si esta opción tiene una segmentación negativa.

YoutubeChannelAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada a canales de YouTube. Se completará en el campo youtubeChannelDetails cuando targetingType sea TARGETING_TYPE_YOUTUBE_CHANNEL.

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

string

Es el ID del canal de quien subió el video de YouTube o el código de un canal de YouTube.

negative

boolean

Indica si esta opción tiene una segmentación negativa.

SessionPositionAssignedTargetingOptionDetails

Detalles de la opción de segmentación asignada a la posición de la sesión. Se completará en el campo sessionPositionDetails cuando targetingType sea TARGETING_TYPE_SESSION_POSITION.

Representación JSON
{
  "sessionPosition": enum (SessionPosition)
}
Campos
sessionPosition

enum (SessionPosition)

Es la posición en la que se mostrará el anuncio en una sesión.

SessionPosition

Posibles puestos en una sesión.

Enumeraciones
SESSION_POSITION_UNSPECIFIED Este es un marcador de posición y no indica ninguna posición.
SESSION_POSITION_FIRST_IMPRESSION La primera impresión de la sesión.

Métodos

get

Obtiene una única opción de segmentación asignada a un grupo de anuncios.

list

Enumera las opciones de segmentación asignadas a un grupo de anuncios.