REST Resource: advertisers.lineItems

Recurso: LineItem

Una sola línea de pedido.

Representación JSON 
{
  "name": string,
  "advertiserId": string,
  "campaignId": string,
  "insertionOrderId": string,
  "lineItemId": string,
  "displayName": string,
  "lineItemType": enum (LineItemType),
  "entityStatus": enum (EntityStatus),
  "updateTime": string,
  "partnerCosts": [
    {
      object (PartnerCost)
    }
  ],
  "flight": {
    object (LineItemFlight)
  },
  "budget": {
    object (LineItemBudget)
  },
  "pacing": {
    object (Pacing)
  },
  "frequencyCap": {
    object (FrequencyCap)
  },
  "partnerRevenueModel": {
    object (PartnerRevenueModel)
  },
  "conversionCounting": {
    object (ConversionCountingConfig)
  },
  "creativeIds": [
    string
  ],
  "bidStrategy": {
    object (BiddingStrategy)
  },
  "integrationDetails": {
    object (IntegrationDetails)
  },
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean,
  "youtubeAndPartnersSettings": {
    object (YoutubeAndPartnersSettings)
  }
}
Campos
name

string

Solo salida. El nombre del recurso de la línea de pedido.
advertiserId

string (int64 format)

Solo salida. Es el ID único del anunciante al que pertenece la línea de pedido.
campaignId

string (int64 format)

Solo salida. El ID único de la campaña a la que pertenece la línea de pedido.
insertionOrderId

string (int64 format)

Obligatorio. Inmutable. El ID único del pedido de inserción al que pertenece la línea de pedido.
lineItemId

string (int64 format)

Solo salida. El ID único de la línea de pedido. Lo asigna el sistema.
displayName

string

Obligatorio. El nombre visible de la línea de pedido.

Debe estar codificado en UTF-8, con un tamaño máximo de 240 bytes.
lineItemType

enum (LineItemType)

Obligatorio. Inmutable. Es el tipo de línea de pedido.
entityStatus

enum (EntityStatus)

Obligatorio. Controla si la línea de pedido puede invertir su presupuesto y ofertar en el inventario.

  • Para el método lineItems.create, solo se permite ENTITY_STATUS_DRAFT. Para activar una línea de pedido, usa el método lineItems.patch y actualiza el estado a ENTITY_STATUS_ACTIVE después de la creación.
  • Una línea de pedido no se puede volver a cambiar al estado ENTITY_STATUS_DRAFT desde ningún otro estado.
  • Si el pedido de inserción superior de la línea de pedido no está activo, esta no puede invertir su presupuesto, incluso si su propio estado es ENTITY_STATUS_ACTIVE.
updateTime

string (Timestamp format)

Solo salida. Es la marca de tiempo de la última actualización de la línea de pedido. Lo asigna el sistema.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
partnerCosts[]

object (PartnerCost)

Son los costos del socio asociados con la línea de pedido.

Si está ausente o está vacío en el método lineItems.create, la línea de pedido recién creada heredará los costos de socios de su pedido de inserción superior.
flight

object (LineItemFlight)

Obligatorio. Hora de inicio y finalización del período de publicación de la línea de pedido.
budget

object (LineItemBudget)

Obligatorio. La configuración de asignación de presupuesto de la línea de pedido.
pacing

object (Pacing)

Obligatorio. El parámetro de configuración de velocidad de inversión del presupuesto de la línea de pedido.
frequencyCap

object (FrequencyCap)

Obligatorio. La configuración de la limitación de frecuencia de impresiones de la línea de pedido.

Se debe usar el campo maxImpressions en este objeto de configuración si se asigna un límite limitado.
partnerRevenueModel

object (PartnerRevenueModel)

Obligatorio. Es la configuración del modelo de ingresos de socios de la línea de pedido.
conversionCounting

object (ConversionCountingConfig)

La configuración del seguimiento de conversiones de la línea de pedido.
creativeIds[]

string (int64 format)

Son los ID de las creatividades asociadas con la línea de pedido.
bidStrategy

object (BiddingStrategy)

Obligatorio. Indica la estrategia de ofertas de la línea de pedido.
integrationDetails

object (IntegrationDetails)

Detalles de integración de la línea de pedido.
targetingExpansion

object (TargetingExpansionConfig)

La configuración de segmentación optimizada de la línea de pedido.

Esta configuración solo se aplica a las líneas de pedido de anuncios gráficos, de video o de audio que usan ofertas automáticas y se orientan de manera positiva a listas de público aptas.
warningMessages[]

enum (LineItemWarningMessage)

Solo salida. Son los mensajes de advertencia que genera la línea de pedido. Estas advertencias no impiden que se guarde la línea de pedido, pero es posible que algunas bloqueen su ejecución.
mobileApp

object (MobileApp)

Es la aplicación para dispositivos móviles promocionada por la línea de pedido.

Esto es aplicable solo cuando lineItemType es LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL o LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL.
reservationType

enum (ReservationType)

Solo salida. Es el tipo de reserva de la línea de pedido.
excludeNewExchanges

boolean

Indica si se deben excluir intercambios nuevos para que la línea de pedido no se oriente automáticamente. Este campo se establece como falso de forma predeterminada.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Solo salida. Es la configuración específica de las líneas de pedido de YouTube y Partners.

LineItemType

Posibles tipos de una línea de pedido.

El tipo de línea de pedido determina qué configuración y opciones se aplican, como el formato de los anuncios o las opciones de segmentación.

Enumeradores
LINE_ITEM_TYPE_UNSPECIFIED

No se especificó el valor del tipo o se desconoce en esta versión.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_DISPLAY_DEFAULT Son anuncios HTML5, nativos, con imágenes o rich media.
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INSTALL Anuncios gráficos que generan instalaciones de una aplicación
LINE_ITEM_TYPE_VIDEO_DEFAULT Anuncios de video que se venden según un CPM para una variedad de entornos.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INSTALL Anuncios de video que generan instalaciones de una aplicación
LINE_ITEM_TYPE_DISPLAY_MOBILE_APP_INVENTORY

Anuncios gráficos que se publican en el inventario de la aplicación para dispositivos móviles

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY

Anuncios de video que se publican en el inventario de la aplicación para dispositivos móviles.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_AUDIO_DEFAULT Anuncios de audio de RTB que se venden para una variedad de entornos.
LINE_ITEM_TYPE_VIDEO_OVER_THE_TOP Anuncios de transmisión libre presentes en los pedidos de inserción de OTT. Este tipo solo se aplica a líneas de pedido con un pedido de inserción de insertionOrderType OVER_THE_TOP.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION

Anuncios de video de YouTube que promocionan conversiones.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE

Anuncios de video de YouTube (de hasta 15 segundos) que no se pueden omitir.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Anuncios de video de YouTube que muestran una historia en una secuencia particular mediante una combinación de formatos.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO

Anuncios de audio de YouTube.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH

Anuncios de video de YouTube que optimizan la llegada a más usuarios únicos a un costo más bajo. Puede incluir anuncios bumper, anuncios in-stream que se pueden omitir o una combinación de diferentes tipos.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE

Anuncios de video de YouTube predeterminados.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP

Anuncios de video de YouTube de TV conectada (de hasta 15 segundos) que no se pueden omitir.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP

Anuncios de video de YouTube de TV conectada que se optimizan para llegar a más usuarios únicos a un menor costo. Puede incluir anuncios bumper, anuncios in-stream que se pueden omitir o una combinación de diferentes tipos.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP

Anuncios de video de YouTube predeterminados en TV conectada. Solo incluya el formato de anuncio in-stream.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_TARGET_FREQUENCY

El objetivo de este tipo de línea de pedido es mostrar la cantidad de veces segmentadas de los anuncios de YouTube a la misma persona en un período determinado.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIEW

Anuncios de video de YouTube que apuntan a obtener más vistas con una variedad de formatos de anuncio.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_DISPLAY_OUT_OF_HOME

Anuncios gráficos que se publican en el inventario digital de publicidad exterior.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.
LINE_ITEM_TYPE_VIDEO_OUT_OF_HOME

Anuncios de video que se publican en el inventario digital de publicidad exterior.

No se pueden crear ni actualizar con la API las líneas de pedido de este tipo y su segmentación.

LineItemFlight

Son parámetros de configuración que controlan la duración activa de una línea de pedido.

Representación JSON 
{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  }
}
Campos
flightDateType

enum (LineItemFlightDateType)

Obligatorio. El tipo de fechas de publicación de la línea de pedido.
dateRange

object (DateRange)

Indica las fechas de inicio y finalización del período de publicación de la línea de pedido. Se resuelven en función de la zona horaria del anunciante principal.

  • Obligatorio cuando flightDateType es LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. Salida solo de lo contrario.
  • Cuando crees un vuelo nuevo, la información de startDate y endDate debe estar en el futuro.
  • Un vuelo existente con un startDate en el pasado tiene un endDate mutable, pero un startDate inmutable.
  • endDate debe ser startDate o posterior, ambos antes del año 2037.

LineItemFlightDateType

Posibles tipos de fechas de publicación de una línea de pedido.

Enumeradores
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED No se especificó el valor del tipo o se desconoce en esta versión.
LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED Las fechas de publicación de la línea de pedido se heredan de su pedido de inserción superior.
LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM La línea de pedido usa sus propias fechas de publicación personalizadas.

LineItemBudget

Es la configuración que controla cómo se asigna el presupuesto.

Representación JSON 
{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}
Campos
budgetAllocationType

enum (LineItemBudgetAllocationType)

Obligatorio. Es el tipo de asignación del presupuesto.

LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC solo es aplicable cuando está habilitada la asignación automática de presupuesto para el pedido de inserción superior.
budgetUnit

enum (BudgetUnit)

Solo salida. La unidad de presupuesto especifica si el presupuesto se basa en la moneda o en las impresiones. Este valor se hereda del pedido de inserción superior.
maxAmount

string (int64 format)

Es el importe de presupuesto máximo que invertirá la línea de pedido. Debe ser mayor que 0.

Cuando el valor de budgetAllocationType sea:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, este campo es inmutable y el sistema lo establece.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, si budgetUnit es:
    • BUDGET_UNIT_CURRENCY, este campo representa el importe del presupuesto máximo que se invertirá en micros de la moneda del anunciante. Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda.
    • BUDGET_UNIT_IMPRESSIONS, este campo representa la cantidad máxima de impresiones que se publicarán.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED, este campo no es aplicable y el sistema lo ignorará.

LineItemBudgetAllocationType

Tipos posibles de asignación de presupuesto.

Enumeradores
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED No se especificó el valor del tipo o se desconoce en esta versión.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC La asignación automática de presupuesto está habilitada para la línea de pedido.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED Se asigna un importe fijo de presupuesto máximo a la línea de pedido.
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED No se aplica ningún límite de presupuesto a la línea de pedido.

PartnerRevenueModel

Es la configuración que controla cómo se calculan los ingresos de los socios.

Representación JSON 
{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}
Campos
markupType

enum (PartnerRevenueModelMarkupType)

Obligatorio. Es el tipo de lenguaje de marcado del modelo de ingresos de socios.
markupAmount

string (int64 format)

Obligatorio. Es el importe del margen del modelo de ingresos de socios. Debe ser mayor o igual que 0.

  • Cuando markupType se establece en PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, este campo representa el margen de beneficio del CPM en microsegundos de la moneda del anunciante. Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda.
  • Cuando markupType se establece como PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, este campo representa el margen de porcentaje del costo de medios en milisegundos. Por ejemplo, 100 representa 0.1% (decimal 0.001).
  • Cuando markupType se establece como PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, este campo representa el margen porcentual del costo de medios total en milisegundos. Por ejemplo, 100 representa 0.1% (decimal 0.001).

PartnerRevenueModelMarkupType

Los posibles tipos de lenguaje de marcado del modelo de ingresos de socios.

Enumeradores
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED No se especificó el valor del tipo o se desconoce en esta versión.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Calcula los ingresos del socio según un CPM fijo.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Calcula los ingresos del socio según un porcentaje de recargo de su costo de medios.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Calcula los ingresos del socio según un porcentaje de recargo adicional de su costo total de medios, que incluye todos los costos del socio y los costos de datos.

ConversionCountingConfig

Es la configuración que controla cómo se registran las conversiones.

Se registrarán todas las conversiones posteriores al clic. Se puede establecer un valor porcentual para el registro de conversiones posteriores a la vista.

Representación JSON 
{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}
Campos
postViewCountPercentageMillis

string (int64 format)

El porcentaje de conversiones posvista que se debe registrar, en milisegundos (1/1,000 de un porcentaje). Debe estar comprendido entre 0 y 100,000 inclusive.

Por ejemplo, para realizar un seguimiento del 50% de las conversiones posteriores al clic, establezca un valor en 50,000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Los parámetros de configuración de la actividad de Floodlight que se utilizan para hacer un seguimiento de las conversiones

La cantidad de conversiones registradas es la suma de todas las conversiones contadas por todos los IDs de actividad de Floodlight especificados en este campo.

TrackingFloodlightActivityConfig

Son parámetros de configuración que controlan el comportamiento de una sola configuración de actividad de Floodlight.

Representación JSON 
{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}
Campos
floodlightActivityId

string (int64 format)

Obligatorio. El ID de la actividad de Floodlight.
postClickLookbackWindowDays

integer

Obligatorio. Indica la cantidad de días después de que se hizo clic en un anuncio durante los cuales se puede registrar una conversión. Debe estar comprendido entre 0 y 90 inclusive.
postViewLookbackWindowDays

integer

Obligatorio. Es la cantidad de días después de que se vio un anuncio en los que se puede registrar una conversión. Debe estar comprendido entre 0 y 90 inclusive.

LineItemWarningMessage

Son los mensajes de advertencia que genera una línea de pedido. Estos tipos de advertencias no impiden que se guarde una línea de pedido, pero sí pueden bloquear su ejecución.

Enumeradores
LINE_ITEM_WARNING_MESSAGE_UNSPECIFIED No se especificó o es desconocido.
INVALID_FLIGHT_DATES Esta línea de pedido tiene fechas de período de publicación no válidas. No se ejecutará la línea de pedido.
EXPIRED La fecha de finalización de esta línea de pedido ya pasó.
PENDING_FLIGHT Esta línea de pedido comenzará a ejecutarse en el futuro.
ALL_PARTNER_ENABLED_EXCHANGES_NEGATIVELY_TARGETED Todos los intercambios habilitados por los socios tienen una segmentación negativa. No se ejecutará la línea de pedido.
INVALID_INVENTORY_SOURCE No se orientan fuentes de inventario activas. No se ejecutará la línea de pedido.
APP_INVENTORY_INVALID_SITE_TARGETING La orientación por aplicaciones y URL de esta línea de pedido no incluye ninguna aplicación para dispositivo móvil. Este tipo de línea de pedido requiere que incluya las aplicaciones para dispositivos móviles en su segmentación de canal, lista de sitios o aplicaciones. No se ejecutará la línea de pedido.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Esta línea de pedido no está segmentada para ningún usuario de dispositivo móvil. El tipo de esta línea de pedido requiere que oriente sus anuncios a una lista de usuarios de dispositivos móviles. No se ejecutará la línea de pedido.
NO_VALID_CREATIVE Esta línea de pedido no contiene ninguna creatividad válida. No se ejecutará la línea de pedido.
PARENT_INSERTION_ORDER_PAUSED El pedido de inserción de esta línea de pedido está detenido. No se ejecutará la línea de pedido.
PARENT_INSERTION_ORDER_EXPIRED El pedido de inserción de esta línea de pedido tiene su fecha de finalización establecida en el pasado. No se ejecutará la línea de pedido.

MobileApp

Una app para dispositivos móviles promocionada por una línea de pedido de instalación de app para dispositivos móviles.

Representación JSON 
{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}
Campos
appId

string

Obligatorio. Es el ID de la app que proporciona la tienda de la plataforma.

Las apps para Android se identifican por el ID del paquete que usa Play Store de Android, como com.google.android.gm.

Las aplicaciones para iOS se identifican con un ID de aplicación de nueve dígitos que utiliza la tienda de aplicaciones de Apple, como 422689480.
platform

enum (Platform)

Solo salida. La plataforma de la app
displayName

string

Solo salida. Es el nombre de la app.
publisher

string

Solo salida. El publicador de la app

Plataforma

Posibles plataformas de aplicaciones para dispositivos móviles

Enumeradores
PLATFORM_UNSPECIFIED No se especificó la plataforma.
IOS Plataforma iOS.
ANDROID plataforma de Android.

YoutubeAndPartnersSettings

Configuración de las líneas de pedido de YouTube y Socios.

Representación JSON 
{
  "viewFrequencyCap": {
    object (FrequencyCap)
  },
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "inventorySourceSettings": {
    object (YoutubeAndPartnersInventorySourceConfig)
  },
  "contentCategory": enum (YoutubeAndPartnersContentCategory),
  "effectiveContentCategory": enum (YoutubeAndPartnersContentCategory),
  "targetFrequency": {
    object (TargetFrequency)
  },
  "linkedMerchantId": string,
  "relatedVideoIds": [
    string
  ],
  "leadFormId": string,
  "videoAdSequenceSettings": {
    object (VideoAdSequenceSettings)
  }
}
Campos
viewFrequencyCap

object (FrequencyCap)

La configuración de la limitación de frecuencia de vistas de la línea de pedido.

Se debe usar el campo maxViews en este objeto de configuración si se asigna un límite limitado.
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Opcional. La configuración de medición de terceros de la línea de pedido.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Es una configuración que controla a qué inventarios de YouTube y de socios se segmentará la línea de pedido.
contentCategory

enum (YoutubeAndPartnersContentCategory)

El tipo de contenido en el que se mostrarán los anuncios de YouTube y Socios.
effectiveContentCategory

enum (YoutubeAndPartnersContentCategory)

Solo salida. Es la categoría de contenido que se aplica cuando se publica la línea de pedido. Si se establece una categoría de contenido tanto en la línea de pedido como en el anunciante, se aplicará la más estricta al publicar la línea de pedido.
targetFrequency

object (TargetFrequency)

Es la cantidad promedio de veces que quieres que los anuncios de esta línea de pedido se muestren a la misma persona durante un período determinado.
linkedMerchantId

string (int64 format)

Es el ID del comercio vinculado a la línea de pedido del feed de productos.
relatedVideoIds[]

string

Los ID de los videos aparecen debajo del anuncio de video principal cuando este se reproduce en la aplicación de YouTube en dispositivos móviles.
leadFormId

string (int64 format)

El ID del formulario para generar clientes potenciales.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Es la configuración relacionada con VideoAdSequence.

ThirdPartyMeasurementConfigs

Son parámetros de configuración que controlan qué proveedores externos miden métricas específicas de la línea de pedido.

Representación JSON 
{
  "viewabilityVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandSafetyVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "reachVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ],
  "brandLiftVendorConfigs": [
    {
      object (ThirdPartyVendorConfig)
    }
  ]
}
Campos
viewabilityVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Son los proveedores externos que miden la visibilidad.

Se aplican los siguientes proveedores externos:

  • THIRD_PARTY_VENDOR_MOAT
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_TELEMETRY
  • THIRD_PARTY_VENDOR_MEETRICS
brandSafetyVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Son los proveedores externos que miden la seguridad de la marca.

Se aplican los siguientes proveedores externos:

  • THIRD_PARTY_VENDOR_ZERF
  • THIRD_PARTY_VENDOR_DOUBLE_VERIFY
  • THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE
reachVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Son los proveedores externos que miden el alcance.

Se aplican los siguientes proveedores externos:

  • THIRD_PARTY_VENDOR_NIELSEN
  • THIRD_PARTY_VENDOR_COMSCORE
  • THIRD_PARTY_VENDOR_KANTAR
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Son los proveedores externos que miden el reconocimiento de marca.

Se aplican los siguientes proveedores externos:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR

ThirdPartyVendorConfig

Son parámetros de configuración que controlan cómo se configuran los proveedores de medición de terceros.

Representación JSON 
{
  "vendor": enum (ThirdPartyVendor),
  "placementId": string
}
Campos
vendor

enum (ThirdPartyVendor)

Es el proveedor de medición externo.
placementId

string

Es el ID que usa la plataforma del proveedor externo para identificar la línea de pedido.

ThirdPartyVendor

Son los proveedores que realizan mediciones de terceros.

Enumeradores
THIRD_PARTY_VENDOR_UNSPECIFIED Se desconoce el proveedor externo.
THIRD_PARTY_VENDOR_MOAT Foso.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE de Integral Ad Science.
THIRD_PARTY_VENDOR_COMSCORE Comscore.
THIRD_PARTY_VENDOR_TELEMETRY Telemetría
THIRD_PARTY_VENDOR_MEETRICS Meetrics.
THIRD_PARTY_VENDOR_ZEFR ZEFR
THIRD_PARTY_VENDOR_NIELSEN Nielsen.
THIRD_PARTY_VENDOR_KANTAR Kantar.
THIRD_PARTY_VENDOR_DYNATA Dynata.

YoutubeAndPartnersInventorySourceConfig

Es una configuración que controla a qué inventarios relacionados con YouTube se segmentará la línea de pedido de YouTube y Socios.

Representación JSON 
{
  "includeYoutube": boolean,
  "includeGoogleTv": boolean,
  "includeYoutubeVideoPartners": boolean
}
Campos
includeYoutube

boolean

Opcional. Indica si se debe segmentar o no el inventario en YouTube. Esto incluye la búsqueda, los canales y los videos.
includeGoogleTv

boolean

Opcional. Indica si se debe orientar el inventario de las aplicaciones de video disponibles con Google TV.
includeYoutubeVideoPartners

boolean

Indica si se debe segmentar el inventario en una colección de sitios y aplicaciones de socios que siguen los mismos estándares de seguridad de la marca que YouTube.

YoutubeAndPartnersContentCategory

Categorías de seguridad de la marca para el contenido de YouTube y Socios.

Enumeradores
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED No se especificó la categoría del contenido o se desconoce en esta versión.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_STANDARD Es una categoría que consta de una amplia variedad de contenido apropiado para la mayoría de las marcas. El contenido se basa en los Lineamientos del Contenido Apto para Anunciantes de YouTube.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_EXPANDED Es una categoría que incluye todo el contenido en YouTube y los Socios de video que cumple con los estándares para la monetización.
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_LIMITED Es una categoría que consta de un rango reducido de contenido que cumple con requisitos más estrictos, en especial en lo que respecta al lenguaje inapropiado y el contenido provocativo de índole sexual.

TargetFrequency

Es un parámetro de configuración que controla la cantidad promedio de veces que los anuncios se muestran al mismo usuario durante un período determinado.

Representación JSON 
{
  "targetCount": string,
  "timeUnit": enum (TimeUnit),
  "timeUnitCount": integer
}
Campos
targetCount

string (int64 format)

La cantidad objetivo de veces que, en promedio, los anuncios se mostrarán a la misma persona en el período establecido por timeUnit y timeUnitCount.
timeUnit

enum (TimeUnit)

La unidad de tiempo en la que se aplicará la frecuencia objetivo.

Se aplica la siguiente unidad de tiempo:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

La cantidad de timeUnit con la que durará la frecuencia objetivo.

Se aplican las siguientes restricciones según el valor de timeUnit:

  • TIME_UNIT_WEEKS: Debe ser 1

VideoAdSequenceSettings

Es la configuración relacionada con VideoAdSequence.

Representación JSON 
{
  "minimumDuration": enum (VideoAdSequenceMinimumDuration),
  "steps": [
    {
      object (VideoAdSequenceStep)
    }
  ]
}
Campos
minimumDuration

enum (VideoAdSequenceMinimumDuration)

El intervalo de tiempo mínimo antes de que el mismo usuario vuelva a ver esta secuencia.
steps[]

object (VideoAdSequenceStep)

Son los pasos que conforman la secuencia.

VideoAdSequenceMinimumDuration

Es la enumeración del tiempo de intervalo mínimo posible antes de que el mismo usuario vuelva a ver VideoAdSequence.

Enumeradores
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_UNSPECIFIED No especificado o desconocido.
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_WEEK 7 días
VIDEO_AD_SEQUENCE_MINIMUM_DURATION_MONTH 30 días.

VideoAdSequenceStep

Detalle de un solo paso en VideoAdSequence.

Representación JSON 
{
  "stepId": string,
  "adGroupId": string,
  "previousStepId": string,
  "interactionType": enum (InteractionType)
}
Campos
stepId

string (int64 format)

El ID del paso.
adGroupId

string (int64 format)

El ID del grupo de anuncios correspondiente del paso.
previousStepId

string (int64 format)

El ID del paso anterior. El primer paso no tiene el paso anterior.
interactionType

enum (InteractionType)

La interacción en el paso anterior que dirigirá al usuario a este paso. El primer paso no tiene activityType.

InteractionType

Los tipos de interacción en un paso.

Enumeradores
INTERACTION_TYPE_UNSPECIFIED Sin especificar o desconocido
INTERACTION_TYPE_PAID_VIEW Una vista pagada
INTERACTION_TYPE_SKIP Omitida por el usuario.
INTERACTION_TYPE_IMPRESSION Una impresión de anuncios (vista)
INTERACTION_TYPE_ENGAGED_IMPRESSION Es una impresión de anuncios que el usuario no omitió de inmediato, pero que tampoco alcanzó el evento facturable.

Métodos

bulkEditAssignedTargetingOptions

 Edita de forma masiva las opciones de segmentación de varias líneas de pedido.

bulkListAssignedTargetingOptions

 Se muestran las opciones de segmentación asignadas para varias líneas de pedido en todos los tipos de segmentación.

bulkUpdate

 Actualiza varias líneas de pedido.

create

 Crea una línea de pedido nueva.

delete

 Borra una línea de pedido.

duplicate

 Duplica una línea de pedido.

generateDefault

 Crea una línea de pedido nueva con una configuración (incluida la segmentación) heredada del pedido de inserción y un entity_status de ENTITY_STATUS_DRAFT.

get

 Obtiene una línea de pedido.

list

 Muestra una lista de las líneas de pedido de un anunciante.

patch

 Actualiza una línea de pedido existente.