REST Resource: curators.curatedPackages

Recurso: CuratedPackage

Representa un paquete seleccionado de inventario que crea y administra un seleccionador.

Representación JSON
{
  "name": string,
  "displayName": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "floorPriceCpm": {
    object (Money)
  },
  "state": enum (State),
  "accessSettings": {
    object (AccessControlSettings)
  },
  "targeting": {
    object (PackageTargeting)
  },
  "curationFeeVisibility": enum (CurationFeeVisibility),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "feeCpm": {
    object (Money)
  },
  "millipercentOfMediaFee": string
  // End of mutually exclusive fields.
}
Campos
name

string

Es el identificador. Es el nombre único del recurso para el paquete seleccionado. Formato: curators/{accountId}/curatedPackages/{curatedPackageId}

displayName

string

Obligatorio. Es el nombre visible que el seleccionador asignó al paquete seleccionado. Se puede usar para filtrar la respuesta del método curatedPackages.list.

description

string

Opcional. Es una descripción del paquete seleccionado, proporcionada por el selector.

createTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de cuando se creó el paquete seleccionado. Se puede usar para filtrar la respuesta del método curatedPackages.list.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización del paquete seleccionado. Se puede usar para filtrar la respuesta del método curatedPackages.list.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

floorPriceCpm

object (Money)

Opcional. Es el CPM mínimo que debe ofertar un comprador para participar en las subastas de inventario de este paquete seleccionado. Se puede usar para filtrar la respuesta del método curatedPackages.list.

state

enum (State)

Solo salida. Es el estado del paquete seleccionado. Se puede usar para filtrar la respuesta del método curatedPackages.list.

accessSettings

object (AccessControlSettings)

Obligatorio. Es la configuración para controlar el acceso al paquete seleccionado.

El acceso a este paquete seleccionado se limita a los planificadores de medios incluidos en la lista de entidades permitidas y al creador. Los compradores y ofertantes no pueden incluirse en la lista de entidades permitidas para este recurso ni tener acceso directo a él.

targeting

object (PackageTargeting)

Opcional. Son los criterios de segmentación del paquete seleccionado.

curationFeeVisibility

enum (CurationFeeVisibility)

Opcional. Inmutable. La visibilidad de la tarifa combinada del paquete de selección y las tarifas de los segmentos de datos (la tarifa de selección total)

Es la tarifa que se paga al selector por este paquete. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
feeCpm

object (Money)

Opcional. Es la tarifa de CPM que el seleccionador cobra a los compradores que usan este paquete seleccionado. Se puede usar para filtrar la respuesta del método curatedPackages.list.

millipercentOfMediaFee

string (int64 format)

Opcional. La tarifa se cobrará como un porcentaje del costo de la impresión, representado en milésimas de porcentaje. Por ejemplo, el 1% se representa como 1000.

Fin de los campos mutuamente excluyentes.

Estado

Es el estado del paquete seleccionado.

Enums
STATE_UNSPECIFIED Valor predeterminado
ACTIVE El paquete seleccionado está activo.
INACTIVE El paquete seleccionado está inactivo.

AccessControlSettings

Es la configuración para controlar el acceso a un paquete seleccionado.

Representación JSON
{
  "allowlistedMediaPlanners": [
    string
  ]
}
Campos
allowlistedMediaPlanners[]

string

Obligatorio. Inmutable. Es la lista de planificadores de medios a los que se les otorga acceso explícitamente al paquete seleccionado. Los planificadores de medios aptos se pueden encontrar en el método mediaPlanners.list. Por el momento, solo se puede incluir un planificador de medios en la lista de entidades permitidas.

Formato: mediaPlanners/{mediaPlannerAccountId}

PackageTargeting

Son los criterios de segmentación para los paquetes seleccionados y de subasta.

Representación JSON
{
  "includedDeviceTypes": [
    enum (DeviceType)
  ],
  "includedEnvironment": enum (Environment),
  "includedCreativeFormat": enum (CreativeFormat),
  "includedAcceleratedMobilePageType": enum (AcceleratedMobilePageType),
  "includedAuthorizedSellerStatuses": [
    enum (AuthorizedSellerStatus)
  ],
  "includedNativeInventoryTypes": [
    enum (NativeInventoryType)
  ],
  "includedOpenMeasurementTypes": [
    enum (OpenMeasurementType)
  ],
  "includedRestrictedCategories": [
    enum (RestrictedCategory)
  ],
  "includedRewardedType": enum (RewardedType),
  "videoTargeting": {
    object (PackageVideoTargeting)
  },
  "minimumPredictedViewabilityPercentage": string,
  "languageTargeting": {
    object (StringTargetingDimension)
  },
  "includedAdSizes": [
    {
      object (AdSize)
    }
  ],
  "publisherTargeting": {
    object (StringTargetingDimension)
  },
  "minimumPredictedClickThroughRatePercentageMillis": string,
  "verticalTargeting": {
    object (CriteriaTargeting)
  },
  "geoTargeting": {
    object (CriteriaTargeting)
  },
  "includedDataSegments": [
    string
  ],
  "placementTargeting": {
    object (PackagePlacementTargeting)
  },
  "publisherProvidedSignalsTargeting": {
    object (PackagePublisherProvidedSignalsTargeting)
  }
}
Campos
includedDeviceTypes[]

enum (DeviceType)

Opcional. Es la lista de tipos de dispositivos incluidos para la segmentación. Si está vacío, se segmentará para todos los tipos de dispositivos.

includedEnvironment

enum (Environment)

Opcional. Es el entorno de destino. Si no se especifica, se segmentará para todos los entornos.

includedCreativeFormat

enum (CreativeFormat)

Opcional. Es el formato de creatividad que se segmentará. Si no se establece, se segmentará para todos los tipos de lenguaje de marcado de creatividades.

includedAcceleratedMobilePageType

enum (AcceleratedMobilePageType)

Opcional. Es el tipo de página móvil acelerada de segmentación. Si no se establece, se segmentará el inventario independientemente del estado de AMP.

includedAuthorizedSellerStatuses[]

enum (AuthorizedSellerStatus)

Opcional. Es la lista incluida de estados de vendedores autorizados segmentados. Si se deja vacío, se segmentará el inventario independientemente del estado del vendedor.

includedNativeInventoryTypes[]

enum (NativeInventoryType)

Opcional. Son los tipos de inventario nativo segmentados. Si se deja vacío, se segmentará el inventario independientemente del tipo de inventario nativo.

includedOpenMeasurementTypes[]

enum (OpenMeasurementType)

Opcional. Es la lista de tipos de medición abierta segmentados. Si está vacío, se segmentará el inventario independientemente de la compatibilidad con Open Measurement.

includedRestrictedCategories[]

enum (RestrictedCategory)

Opcional. Es la lista de categorías restringidas segmentadas. Si está vacío, se segmentará el inventario independientemente de las categorías restringidas.

includedRewardedType

enum (RewardedType)

Opcional. Es el tipo de recompensa segmentada. Si no se establece, se segmentará el inventario independientemente del tipo de recompensa.

videoTargeting

object (PackageVideoTargeting)

Opcional. Son los criterios de segmentación específicos de los videos.

minimumPredictedViewabilityPercentage

string (int64 format)

Opcional. Es el porcentaje mínimo de visibilidad prevista que se segmenta.

Este valor debe ser un múltiplo de 10 entre 10 y 90 (inclusive). Por ejemplo, 10 es válido, pero 0, 15 y 100 no lo son. Un valor de 10 significa que la configuración solo coincidirá con los espacios publicitarios para los que prevemos una visibilidad de, al menos, un 10%.

Un valor sin establecer indica que se segmentará el inventario independientemente de la visibilidad prevista.

languageTargeting

object (StringTargetingDimension)

Opcional. Son los idiomas para los que deseas segmentar tus anuncios. Si no se establece, se segmentará el inventario independientemente del idioma. Consulta https://developers.google.com/google-ads/api/data/codes-formats#languages para obtener la lista de códigos de idioma admitidos.

includedAdSizes[]

object (AdSize)

Opcional. Es la lista de tamaños de anuncios para segmentar. Si no se establece, se segmentará el inventario independientemente del tamaño del anuncio.

Los paquetes seleccionados admiten los tamaños de anuncios PIXEL y INTERSTITIAL.

publisherTargeting

object (StringTargetingDimension)

Opcional. Son los publicadores segmentados. Si no se establece, se segmentará el inventario independientemente del publicador. Los publicadores se identifican por su ID de publicador de ads.txt o app-ads.txt. Consulta https://iabtechlab.com/ads-txt/ y https://iabtechlab.com/app-ads-txt/ para obtener más detalles.

minimumPredictedClickThroughRatePercentageMillis

string (int64 format)

Opcional. Es la tasa de clics mínima prevista objetivo, que varía entre los valores [10, 10000] (0.01% -10%). Un valor de 50 significa que la configuración solo coincidirá con los espacios publicitarios para los que prevemos una tasa de clics de, al menos, un 0.05%.

Un valor sin establecer indica que se segmentará el inventario independientemente de la tasa de clics prevista.

verticalTargeting

object (CriteriaTargeting)

Opcional. Son las verticales incluidas o excluidas, según se definen en https://developers.google.com/authorized-buyers/rtb/downloads/publisher-verticals. Si no se establece, se segmentará el inventario independientemente de la vertical.

geoTargeting

object (CriteriaTargeting)

Opcional. Son los IDs de criterios geográficos que se incluirán o excluirán, según se define en https://storage.googleapis.com/adx-rtb-dictionaries/geo-table.csv. Si no se establece, se segmentará el inventario independientemente de la ubicación geográfica.

includedDataSegments[]

string

Opcional. Son los segmentos de datos activos que se segmentarán. Si no se establece, se segmentará el inventario independientemente de los segmentos de datos. Formato: curators/{accountId}/dataSegments/{data_segment_id}

placementTargeting

object (PackagePlacementTargeting)

Opcional. Información de la segmentación por posición, por ejemplo, URL, aplicaciones para dispositivos móviles.

publisherProvidedSignalsTargeting

object (PackagePublisherProvidedSignalsTargeting)

Opcional. Son los indicadores proporcionados por el publicador para la segmentación. Si no se establece, se segmentará el inventario independientemente de los indicadores proporcionados por el publicador.

DeviceType

Es el tipo general de dispositivo al que se segmentará el anuncio.

Enums
DEVICE_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
DEVICE_TYPE_PERSONAL_COMPUTER Segmenta para computadoras de escritorio o laptops.
DEVICE_TYPE_CONNECTED_TV Segmenta los anuncios para TVs conectadas, es decir, dispositivos que transmiten contenido de TV, como smart TVs, consolas de juegos y decodificadores o dispositivos de transmisión.
DEVICE_TYPE_PHONE Segmenta los anuncios para dispositivos móviles de alta gama.
DEVICE_TYPE_TABLET Se segmenta para tablets.

Entorno

Es el entorno de destino.

Enums
ENVIRONMENT_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
ENVIRONMENT_SITE Segmenta el inventario que se renderiza en un sitio web con anuncios.
ENVIRONMENT_APP Segmenta el inventario dentro de una aplicación para dispositivos móviles.

CreativeFormat

Es el formato de creatividad que se puede segmentar.

Enums
CREATIVE_FORMAT_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
CREATIVE_FORMAT_DISPLAY Segmenta los espacios publicitarios destinados a creatividades de anuncios gráficos HTML.
CREATIVE_FORMAT_VIDEO Segmenta los espacios publicitarios destinados a las creatividades de video.
CREATIVE_FORMAT_AUDIO Segmenta los espacios publicitarios destinados a las creatividades de audio.

AcceleratedMobilePageType

Es el tipo de implementación de Accelerated Mobile Pages (AMP) para la segmentación.

Enums
ACCELERATED_MOBILE_PAGE_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
ACCELERATED_MOBILE_PAGE_TYPE_NON_AMP Segmenta el inventario en páginas web estándar que no usan ningún framework de AMP.
ACCELERATED_MOBILE_PAGE_TYPE_AMP Segmenta el inventario en páginas creadas con el framework principal de AMP HTML.
ACCELERATED_MOBILE_PAGE_TYPE_AMP_STORY Segmenta el inventario en páginas que usan el formato de historia en formato AMP (STAMP), que está optimizado para la narración visual (p.ej., experiencias de pantalla completa en las que se puede presionar).

AuthorizedSellerStatus

Representa la relación entre el publicador y el vendedor, como se declara en un archivo ads.txt o app-ads.txt.

Enums
AUTHORIZED_SELLER_STATUS_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
AUTHORIZED_SELLER_STATUS_DIRECT Segmenta el inventario en el que el vendedor se declara como "DIRECTO". Esto indica que el publicador (propietario del contenido) controla directamente la cuenta de vendedor y tiene un contrato comercial directo con el sistema de publicidad para esta cuenta.
AUTHORIZED_SELLER_STATUS_RESELLER Segmenta el inventario en el que el vendedor se declara como "RESELLER". Esto indica que el publicador autorizó a otra entidad para que opere la cuenta de vendedor indicada y revenda su espacio publicitario.

NativeInventoryType

Representa el tipo de renderización de creatividades que admite un espacio publicitario, específicamente en relación con los anuncios nativos.

Enums
NATIVE_INVENTORY_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
NATIVE_INVENTORY_TYPE_NATIVE_ONLY Segmenta los espacios publicitarios que solo aceptan y renderizan anuncios nativos.
NATIVE_INVENTORY_TYPE_NATIVE_OR_BANNER Segmenta los espacios publicitarios que aceptan y renderizan anuncios nativos o de banner.

OpenMeasurementType

Es el tipo de definición de interfaz de Open Measurement (OMID) que se segmentará.

Enums
OPEN_MEASUREMENT_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
OPEN_MEASUREMENT_TYPE_OMID_V1 Segmenta los anuncios para el inventario que admite la versión 1 de la definición de interfaz de Open Measurement (OMID).

RestrictedCategory

Representa las categorías específicas de anuncios que están restringidas por la política para la segmentación.

Enums
RESTRICTED_CATEGORY_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
RESTRICTED_CATEGORY_ALCOHOL Segmenta el inventario en el que el publicador permite anuncios de bebidas alcohólicas.
RESTRICTED_CATEGORY_GAMBLING Segmenta el inventario en el que el publicador permite anuncios de juegos de apuestas.

RewardedType

Define los criterios de segmentación en función de si el inventario de anuncios ofrece una recompensa al usuario por ver un anuncio.

Enums
REWARDED_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
REWARDED_TYPE_NON_REWARDED Segmenta el inventario que NO ofrece una recompensa explícita al usuario por mirar el anuncio o interactuar con él.
REWARDED_TYPE_REWARDED Segmenta el inventario que ofrece una recompensa al usuario a cambio de mirar el anuncio o interactuar con él.

PackageVideoTargeting

Son los criterios de segmentación específicos de los videos.

Representación JSON
{
  "includedMimeTypes": [
    enum (VideoMimeType)
  ],
  "includedMaximumAdDurationTargeting": enum (MaximumVideoAdDuration),
  "includedPositionTypes": [
    enum (PositionType)
  ],
  "includedContentDeliveryMethod": enum (ContentDeliveryMethod),
  "plcmtTargeting": {
    object (VideoPlcmtTargeting)
  },
  "includedPlaybackMethods": [
    enum (PlaybackMethod)
  ],
  "minimumPredictedCompletionRatePercentage": string,
  "includedPlayerSizeTargeting": {
    object (VideoPlayerSizeTargeting)
  }
}
Campos
includedMimeTypes[]

enum (VideoMimeType)

Opcional. Es la lista de tipos de MIME de video segmentados que usan las cadenas de tipos de MIME publicadas por la IANA (https://www.iana.org/assignments/media-types/media-types.xhtml). Si se deja vacío, se segmentará el inventario independientemente del tipo de MIME del video.

includedMaximumAdDurationTargeting

enum (MaximumVideoAdDuration)

Opcional. Es la duración máxima segmentada del anuncio de video. Si no se establece, se segmentará el inventario independientemente de la duración máxima de los anuncios de video.

includedPositionTypes[]

enum (PositionType)

Opcional. Son los tipos de posiciones de anuncios de video segmentados. Si está vacío, se segmentará el inventario independientemente del tipo de posición del anuncio de video.

includedContentDeliveryMethod

enum (ContentDeliveryMethod)

Opcional. Es el método de publicación de video segmentado. Si no se establece, se segmentará el inventario independientemente del método de publicación de video.

plcmtTargeting

object (VideoPlcmtTargeting)

Opcional. Son los tipos de posiciones de video segmentadas. Si no se establece, se segmentará el inventario independientemente del tipo de plcmt de video.

includedPlaybackMethods[]

enum (PlaybackMethod)

Opcional. Es la lista de métodos de reproducción de video segmentados. Si se deja vacío, se segmentará el inventario independientemente del método de reproducción de video.

minimumPredictedCompletionRatePercentage

string (int64 format)

Opcional. Es el porcentaje objetivo de la tasa de vistas completas prevista mínima.

Este valor debe ser un múltiplo de 10 entre 10 y 90 (inclusive). Por ejemplo, 10 es válido, pero 0, 15 y 100 no lo son. Un valor de 10 significa que la configuración solo coincidirá con los espacios publicitarios para los que prevemos una tasa de vistas completas de, al menos, el 10%.

Un valor sin establecer indica que se segmentará el inventario independientemente de la tasa de vistas completas prevista.

includedPlayerSizeTargeting

object (VideoPlayerSizeTargeting)

Opcional. Es el tamaño del reproductor de video segmentado. Si no se establece, se segmentará el inventario independientemente del tamaño del reproductor de video.

VideoMimeType

Son los tipos de MIME de video para la segmentación.

Enums
VIDEO_MIME_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
VIDEO_MIME_TYPE_THREEGPP Formato de contenedor 3GPP que se usa en teléfonos 3G.
VIDEO_MIME_TYPE_APPLICATION_MPEGURL HLS/M3U8
VIDEO_MIME_TYPE_MP4 Contenedor MPEG-4, por lo general, con códec H.264.
VIDEO_MIME_TYPE_APPLICATION_MPEGDASH DASH
VIDEO_MIME_TYPE_APPLICATION_JAVASCRIPT JavaScript (se usa para los anuncios de VPAID)
VIDEO_MIME_TYPE_WEBM Contenedor WebM que asume el códec VP9.

MaximumVideoAdDuration

Es el límite superior de la duración de la creatividad del anuncio de video que se segmentará. Los valores de enumeración definen buckets, y seleccionar un valor significa que la duración de la creatividad debe ser menor o igual que el tiempo especificado.

Enums
MAXIMUM_VIDEO_AD_DURATION_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
MAXIMUM_VIDEO_AD_DURATION_FIFTEEN_SECONDS Se aplica a los anuncios de video con una duración de hasta 15 segundos (0 < duración <= 15 s).
MAXIMUM_VIDEO_AD_DURATION_TWENTY_SECONDS Se aplica a los anuncios de video con una duración de hasta 20 segundos (0 < duración <= 20 s).
MAXIMUM_VIDEO_AD_DURATION_THIRTY_SECONDS Se aplica a los anuncios de video con una duración de hasta 30 segundos (0 < duración <= 30 s).
MAXIMUM_VIDEO_AD_DURATION_SIXTY_SECONDS Se aplica a los anuncios de video con una duración de hasta 60 segundos (0 < duración <= 60 s).
MAXIMUM_VIDEO_AD_DURATION_NINETY_SECONDS Se aplica a los anuncios de video con una duración de hasta 90 segundos (0 < duración <= 90 s).
MAXIMUM_VIDEO_AD_DURATION_ONE_HUNDRED_TWENTY_SECONDS Se aplica a los anuncios de video con una duración de hasta 120 segundos (0 < duración <= 120 s).

PositionType

Es la posición segmentable del anuncio dentro de un video.

Enums
POSITION_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
POSITION_TYPE_MIDROLL El anuncio se reproduce durante el contenido de video.
POSITION_TYPE_POSTROLL El anuncio se reproduce después del contenido de video.
POSITION_TYPE_PREROLL El anuncio se reproduce antes del contenido de video.

ContentDeliveryMethod

Son los criterios de segmentación basados en el método de publicación del contenido de video.

Enums
CONTENT_DELIVERY_METHOD_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
CONTENT_DELIVERY_METHOD_STREAMING Segmenta el contenido de video que se transmite en vivo.
CONTENT_DELIVERY_METHOD_PROGRESSIVE Segmenta el contenido de video que se transfiere de forma incremental según lo requiera la reproducción del cliente.

VideoPlcmtTargeting

Define los criterios de segmentación según el tipo de posición del video, que suele corresponder al campo "plcmt" de OpenRTB de IAB.

Representación JSON
{
  "selectionType": enum (SelectionType),
  "videoPlcmtTypes": [
    enum (VideoPlcmtType)
  ]
}
Campos
selectionType

enum (SelectionType)

Obligatorio. Es el tipo de selección para la lista de posiciones de video.

videoPlcmtTypes[]

enum (VideoPlcmtType)

Obligatorio. Es la lista de tipos de posiciones de video segmentadas. Si está vacío, se segmentará el inventario independientemente del tipo de posición del video.

SelectionType

Es la enumeración de los posibles tipos de selección que usan las dimensiones de segmentación.

Enums
SELECTION_TYPE_UNSPECIFIED Indica que no se especificó el tipo de selección. No se debe usar.
SELECTION_TYPE_INCLUDE Se incluyen los valores de la dimensión de segmentación.
SELECTION_TYPE_EXCLUDE Se excluyen los valores de la dimensión de segmentación.

VideoPlcmtType

Representa el tipo de posición de video, de acuerdo con los estándares de OpenRTB.

Enums
VIDEO_PLCMT_TYPE_UNSPECIFIED Valor predeterminado No se debe usar en las especificaciones de segmentación.
INSTREAM Son anuncios previos al video, durante el video y al final del video que se reproducen antes, durante o después del contenido de video en streaming que solicitó el consumidor. Los videos in-stream deben tener el sonido activado de forma predeterminada al inicio del reproductor o tener una intención del usuario explícitamente clara de mirar el contenido de video. Si bien puede haber otro contenido alrededor del reproductor, el contenido de video debe ser el motivo principal de la visita del usuario. Debe seguir siendo el contenido principal de la página y el único reproductor de video visible que pueda reproducir audio. Si el reproductor se convierte en flotante o fijo, las llamadas de anuncios posteriores deben transmitir con precisión el tamaño actualizado del reproductor.
ACCOMPANYING_CONTENT Son los anuncios previos al video, durante el video y al final del video que se reproducen antes, durante o después de la transmisión de contenido de video. El reproductor de video se carga y se reproduce antes o después de los párrafos de texto o contenido gráfico, o entre ellos, y comienza a reproducirse solo cuando ingresa al viewport. La reproducción del contenido complementario solo debe comenzar cuando se ingresa al viewport. Puede convertirse en un reproductor flotante o fijo a medida que se desplaza fuera de la página.
INTERSTITIAL Son anuncios de video que se reproducen sin contenido de video. Durante la reproducción, debe ser el elemento principal de la página, ocupar la mayor parte del viewport y no se puede desplazar fuera de la vista. Esto puede ser en posiciones como videos en la app o presentaciones de diapositivas.
NO_CONTENT Son anuncios de video que se reproducen sin contenido de video en streaming. Esto puede ser en posiciones como presentaciones de diapositivas, feeds nativos, en el contenido o fijos/flotantes.

PlaybackMethod

Es el método de reproducción para la segmentación.

Enums
PLAYBACK_METHOD_UNSPECIFIED No se especificó el método de reproducción de video. No se debe usar.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_ON La reproducción se inicia automáticamente cuando se carga la página o el contenido.
PLAYBACK_METHOD_AUTO_PLAY_SOUND_OFF La reproducción se inicia automáticamente cuando se carga la página o el contenido, pero sin sonido.
PLAYBACK_METHOD_CLICK_TO_PLAY La reproducción se inicia con una acción del usuario (p.ej., hacer clic en un botón de reproducción).

VideoPlayerSizeTargeting

Representa el tamaño del reproductor de video que se puede segmentar. Tanto el ancho como la altura deben establecerse en valores distintos de cero.

Representación JSON
{
  "minimumWidth": string,
  "minimumHeight": string
}
Campos
minimumWidth

string (int64 format)

Obligatorio. Es el ancho mínimo del reproductor de video en píxeles.

minimumHeight

string (int64 format)

Obligatorio. Es la altura mínima del reproductor de video en píxeles.

StringTargetingDimension

Segmentación genérica con valores de cadena.

Representación JSON
{
  "selectionType": enum (SelectionType),
  "values": [
    string
  ]
}
Campos
selectionType

enum (SelectionType)

Obligatorio. Cómo se debe segmentar para los elementos de esta lista.

values[]

string

Obligatorio. Los valores especificados.

AdSize

Representa el tamaño de un solo espacio publicitario o de una creatividad.

Representación JSON
{
  "width": string,
  "height": string,
  "type": enum (Type)
}
Campos
width

string (int64 format)

Es el ancho del espacio publicitario en píxeles. Este campo solo estará presente cuando el tipo de tamaño sea PIXEL.

height

string (int64 format)

Es la altura del espacio publicitario en píxeles. Este campo solo estará presente cuando el tipo de tamaño sea PIXEL.

type

enum (Type)

Es el tipo de tamaño del espacio publicitario.

Tipo

Representa diferentes tipos de tamaños de espacios publicitarios o creatividades.

Enums
TYPE_UNSPECIFIED Es un marcador de posición para un tipo de tamaño no definido.
PIXEL Es el espacio publicitario con el tamaño especificado por la altura y el ancho en píxeles.
INTERSTITIAL Es un tamaño especial para describir un espacio publicitario de anuncio intersticial.
NATIVE Son anuncios nativos (para dispositivos móviles) renderizados por el publicador.
FLUID El tamaño fluido (tamaño responsivo) se puede cambiar automáticamente con el cambio del entorno exterior.

CriteriaTargeting

Es la segmentación genérica que se usa para las dimensiones de segmentación que contienen una lista de IDs numéricos incluidos y excluidos. No se puede filtrar con la sintaxis de filtro de lista.

Representación JSON
{
  "targetedCriteriaIds": [
    string
  ],
  "excludedCriteriaIds": [
    string
  ]
}
Campos
targetedCriteriaIds[]

string (int64 format)

Es una lista de IDs numéricos que se incluirán.

excludedCriteriaIds[]

string (int64 format)

Es una lista de IDs numéricos que se excluirán.

PackagePlacementTargeting

Representa la segmentación relacionada con los lugares donde pueden aparecer los anuncios, por ejemplo, ciertos sitios o aplicaciones para dispositivos móviles. Los diferentes tipos de segmentación por posición se combinarán con el operador lógico OR.

Representación JSON
{
  "uriTargeting": {
    object (StringTargetingDimension)
  },
  "mobileAppTargeting": {
    object (StringTargetingDimension)
  },
  "includedMobileAppCategoryTargeting": [
    string
  ]
}
Campos
uriTargeting

object (StringTargetingDimension)

Opcional. Es la lista de URLs segmentadas o excluidas. Los dominios no deben incluir http/https (por ejemplo, google.com) y pueden contener un máximo de 5 rutas de acceso por URL.

mobileAppTargeting

object (StringTargetingDimension)

Opcional. Es la lista de IDs de aplicaciones para dispositivos móviles segmentados o excluidos que pertenecen a los publicadores. Actualmente, solo se admiten apps para Android y Apple.

El ID de la app para Android, por ejemplo, com.google.android.apps.maps, se puede encontrar en la URL de Google Play Store. El ID de la app para iOS (que es un número) se puede encontrar al final de la URL de iTunes Store. Se incluyen o excluyen las aplicaciones para dispositivos móviles propias.

includedMobileAppCategoryTargeting[]

string (int64 format)

Opcional. Es la lista de categorías de apps para dispositivos móviles segmentadas.

PackagePublisherProvidedSignalsTargeting

Representa la segmentación sobre los indicadores proporcionados por el publicador. Los diferentes tipos de indicadores proporcionados por el publicador se combinarán con el operador lógico OR.

Representación JSON
{
  "audienceTargeting": {
    object (TaxonomyTargeting)
  },
  "contentTargeting": {
    object (TaxonomyTargeting)
  },
  "videoAndAudioSignalsTargeting": {
    object (StringTargetingDimension)
  }
}
Campos
audienceTargeting

object (TaxonomyTargeting)

Opcional. Es la lista de IDs de públicos segmentados o excluidos. Se basa en la versión 1.1 de la taxonomía de público de IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Audience%20Taxonomies/Audience%20Taxonomy%201.1.tsv).

contentTargeting

object (TaxonomyTargeting)

Opcional. Es la lista de IDs de Content ID segmentados o excluidos. Se basa en la versión 2.2 de la Taxonomía de contenido de IAB (https://github.com/InteractiveAdvertisingBureau/Taxonomies/blob/main/Content%20Taxonomies/Content%20Taxonomy%202.2.tsv).

videoAndAudioSignalsTargeting

object (StringTargetingDimension)

Opcional. Es la lista de IDs de indicadores de audio y video segmentados y excluidos. Estos son indicadores adicionales que se admiten en los indicadores proporcionados por el publicador.

TaxonomyTargeting

Define los criterios de segmentación para controlar el espacio de ID de taxonomía de público y contenido de IAB.

Representación JSON
{
  "targetedTaxonomyIds": [
    string
  ],
  "excludedTaxonomyIds": [
    string
  ]
}
Campos
targetedTaxonomyIds[]

string

Opcional. Es la lista de IDs de taxonomía de contenido segmentados.

excludedTaxonomyIds[]

string

Opcional. Es la lista de IDs de taxonomía de contenido excluidos.

CurationFeeVisibility

La visibilidad de la tarifa combinada del paquete de selección y las tarifas de los segmentos de datos (la tarifa de selección total) Las tarifas siempre son visibles para el creador del paquete.

Enums
CURATION_FEE_VISIBILITY_UNSPECIFIED No se especifica la visibilidad de la tarifa de selección total.
DISCLOSED Todos los compradores pueden ver la tarifa de selección total. Este es el valor predeterminado si no se configura.
NON_DISCLOSED No todos los compradores pueden ver la tarifa de selección total.

Métodos

activate

Activa un paquete seleccionado existente.

create

Crea un paquete seleccionado nuevo.

deactivate

Desactiva un paquete seleccionado existente.

get

Obtiene un paquete seleccionado según su nombre de recurso.

list

Enumera los paquetes seleccionados que pertenecen al selector especificado.

patch

Actualiza un paquete seleccionado existente.