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)
  },
  "demandGenSettings": {
    object (DemandGenSettings)
  },
  "containsEuPoliticalAds": enum (EuPoliticalAdvertisingStatus),
  "optimizeFixedBidding": boolean
}
Campos
name

string

Solo salida. Es 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. Es el ID único de la campaña a la que pertenece la línea de pedido.
insertionOrderId

string (int64 format)

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

string (int64 format)

Solo salida. Es el ID único de la línea de pedido. Asignado por el sistema.
displayName

string

Obligatorio. Es 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 por 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 podrá 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. Asignado por el sistema.

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".
partnerCosts[]

object (PartnerCost)

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

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

object (LineItemFlight)

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

object (LineItemBudget)

Obligatorio. Es el parámetro de configuración de asignación de presupuesto de la línea de pedido.
pacing

object (Pacing)

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

object (FrequencyCap)

Opcional. Es obligatorio si el tipo de línea de pedido no es LINE_ITEM_TYPE_DEMAND_GEN. Es la configuración de la limitación de frecuencia de impresiones de la línea de pedido.

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

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

Es el parámetro de configuración del seguimiento de conversiones de la línea de pedido.
creativeIds[]

string (int64 format)

Son los IDs de las creatividades asociadas a la línea de pedido.
bidStrategy

object (BiddingStrategy)

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

object (IntegrationDetails)

Son los detalles de integración de la línea de pedido.
targetingExpansion

object (TargetingExpansionConfig)

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

Este parámetro de 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 segmentan de forma positiva para las 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 algunas pueden impedir que se ejecute.
mobileApp

object (MobileApp)

Es la app para dispositivos móviles que se promociona en la línea de pedido.

Esto solo se aplica 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 los intercambios nuevos de la segmentación automática de la línea de pedido. Este campo es falso de forma predeterminada.
youtubeAndPartnersSettings

object (YoutubeAndPartnersSettings)

Solo salida. Son parámetros de configuración específicos de las líneas de pedido de YouTube y socios.
demandGenSettings

object (DemandGenSettings)

Opcional. Configuración específica para las líneas de pedido de campaña de generación de demanda

Solo se aplica a las líneas de pedido de campaña de generación de demanda.
containsEuPoliticalAds

enum (EuPoliticalAdvertisingStatus)

Indica si esta línea de pedido publicará anuncios políticos de la Unión Europea.

Si se estableció containsEuPoliticalAds en DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING en el anunciante superior, se asignará DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING a este campo, a menos que se especifique lo contrario. Luego, este campo se puede actualizar con la IU, la API o los archivos de datos estructurados.

Este campo se debe asignar cuando se crea una línea de pedido nueva. De lo contrario, la solicitud advertisers.lineItems.create fallará.
optimizeFixedBidding

boolean

Opcional. Indica si se debe habilitar la optimización de ofertas de DV360 para las líneas de pedido con ofertas fijas.

De forma predeterminada, DV360 optimiza tu oferta fija disminuyendo automáticamente las ofertas para las impresiones que tienen menos probabilidades de tener un buen rendimiento. Esta optimización está habilitada de forma predeterminada (el valor es verdadero).

Cuando este campo se establece en false, se inhabilita esta optimización y la oferta no se reducirá por ningún motivo.

Este parámetro de configuración solo se aplica a las líneas de pedido con un biddingStrategy del tipo FIXED_BID.

LineItemType

Son los posibles tipos de una línea de pedido.

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

Enums
LINE_ITEM_TYPE_UNSPECIFIED

El valor del tipo no se especificó o es desconocido en esta versión.

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

Son los anuncios gráficos que se publican en el inventario de apps para dispositivos móviles.

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

Son anuncios de video que se publican en el inventario de apps para dispositivos móviles.

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

Son anuncios de video de YouTube que promueven las conversiones.

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

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

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

Son anuncios de video de YouTube que muestran una historia en una secuencia particular con una combinación de formatos.

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

Anuncios de audio de YouTube

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

Son anuncios de video de YouTube que se optimizan para llegar a más usuarios únicos a un costo más bajo. Pueden incluir anuncios bumper, anuncios in-stream que se pueden omitir o una combinación de tipos.

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

Anuncios de video de YouTube predeterminados

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

Son anuncios de video de YouTube para TVs conectadas (de hasta 15 segundos) que no se pueden omitir.

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

Son anuncios de video de YouTube para TVs conectadas que se optimizan para llegar a más usuarios únicos a un costo más bajo. Pueden incluir anuncios bumper, anuncios in-stream que se pueden omitir o una combinación de tipos.

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

Anuncios de video de YouTube predeterminados para TV conectada Solo incluye el formato de anuncio in-stream.

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

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

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

Son anuncios de video de YouTube que tienen como objetivo obtener más vistas con una variedad de formatos de anuncios.

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

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

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

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

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

LineItemFlight

Son los 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. Es el tipo de fechas de publicación de la línea de pedido.
dateRange

object (DateRange)

Son las fechas de inicio y finalización del período de publicación de la línea de pedido. Se resuelven en relación con la zona horaria del anunciante superior.

  • Es obligatorio cuando flightDateType es LINE_ITEM_FLIGHT_DATE_TYPE_CUSTOM. De lo contrario, solo salida.
  • Cuando crees un vuelo nuevo, tanto startDate como endDate deben ser 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

Son los posibles tipos de fechas de publicación de una línea de pedido.

Enums
LINE_ITEM_FLIGHT_DATE_TYPE_UNSPECIFIED El valor del tipo no se especificó o es desconocido 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

Parámetros de configuración que controlan 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 se aplica cuando la asignación automática de presupuesto está habilitada para el pedido de inserción superior.

Este campo debe establecerse en LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED para las líneas de pedido de campaña de generación de demanda.
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 máximo del presupuesto que se invertirá en la línea de pedido. Debe ser mayor que 0.

Cuando budgetAllocationType es:

  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_AUTOMATIC, este campo es inmutable y lo establece el sistema.
  • LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED, si budgetUnit es:
    • BUDGET_UNIT_CURRENCY, este campo representa el importe máximo del presupuesto que se puede invertir, en microunidades 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 corresponde y el sistema lo ignorará.

LineItemBudgetAllocationType

Son los posibles tipos de asignación de presupuesto.

Enums
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNSPECIFIED El valor del tipo no se especificó o es desconocido 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 de presupuesto máximo fijo para 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

Son los parámetros de configuración que controlan 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 margen de beneficio del modelo de ingresos de socios.

Este campo debe establecerse en PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP para las líneas de pedido de campaña de generación de demanda.
markupAmount

string (int64 format)

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

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

PartnerRevenueModelMarkupType

Son los posibles tipos de margen de beneficio del modelo de ingresos de socios.

Enums
PARTNER_REVENUE_MODEL_MARKUP_TYPE_UNSPECIFIED El valor del tipo no se especificó o es desconocido en esta versión.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM Calcula los ingresos del socio en función de un CPM fijo.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP

Calcula los ingresos del socio en función de un porcentaje de cargo adicional de su costo de medios.
PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP Calcula los ingresos del socio en función de un porcentaje de cargo adicional de su costo de medios total, que incluye todos los costos del socio y de los datos.

ConversionCountingConfig

Son los parámetros de configuración que controlan cómo se registran las conversiones.

Se registrarán todas las conversiones posteriores al clic. Se puede establecer un valor porcentual para el recuento de conversiones posimpresión.

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

string (int64 format)

Es el porcentaje de conversiones posimpresión que se deben registrar, en milésimas (1/1,000 de un porcentaje). Debe estar comprendido entre 0 y 100,000, ambos incluidos.

Por ejemplo, para hacer un seguimiento del 50% de las conversiones posclic, establece un valor de 50000.
floodlightActivityConfigs[]

object (TrackingFloodlightActivityConfig)

Son los parámetros de configuración de la actividad de Floodlight que se usan para hacer un seguimiento de las conversiones.

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

Este campo no se puede actualizar si se asigna un algoritmo de ofertas personalizadas a la línea de pedido. Si configuras este campo y asignas un algoritmo de ofertas personalizadas en la misma solicitud, las actividades de Floodlight deben coincidir con las que usa el algoritmo de ofertas personalizadas.
primaryAttributionModelId

string (int64 format)

Opcional. Es el modelo de atribución que se usará para la medición de conversiones. Este modelo de atribución determinará cómo se registran las conversiones. Puedes establecer el modelo principal para un grupo o una configuración de Floodlight. Obtén más detalles aquí.

Solo se aplica a las líneas de pedido de campaña de generación de demanda.

TrackingFloodlightActivityConfig

Es la configuración que controla el comportamiento de un solo parámetro de configuración de la actividad de Floodlight.

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

string (int64 format)

Obligatorio. Es el ID de la actividad de Floodlight.
postClickLookbackWindowDays

integer

Obligatorio. Es la cantidad de días después de que se hizo clic en un anuncio en los que se puede registrar una conversión. Debe ser un valor entre 0 y 90, ambos incluidos.
postViewLookbackWindowDays

integer

Obligatorio. Es la cantidad de días posteriores a la visualización de un anuncio durante los cuales se puede registrar una conversión. Debe ser un valor entre 0 y 90, ambos incluidos.

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 pueden impedir que se publique.

Enums
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. La línea de pedido no se publicará.
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. La línea de pedido no se publicará.
INVALID_INVENTORY_SOURCE No se orientan fuentes de inventario activas. La línea de pedido no se publicará.
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. El tipo de esta línea de pedido requiere que incluyas apps para dispositivos móviles en tu segmentación por canal, lista de sitios o apps. La línea de pedido no se publicará.
APP_INVENTORY_INVALID_AUDIENCE_LISTS Esta línea de pedido no está segmentada para ningún usuario de dispositivos móviles. El tipo de esta línea de pedido requiere que segmentes tus anuncios para una lista de usuarios de dispositivos móviles. La línea de pedido no se publicará.
NO_VALID_CREATIVE Esta línea de pedido no contiene ninguna creatividad válida. La línea de pedido no se publicará.
PARENT_INSERTION_ORDER_PAUSED El pedido de inserción de esta línea de pedido está detenido. La línea de pedido no se publicará.
PARENT_INSERTION_ORDER_EXPIRED La fecha de finalización del pedido de inserción de esta línea de pedido se estableció en el pasado. La línea de pedido no se publicará.

Aplicación para dispositivos móviles

Es una app para dispositivos móviles que se promociona con 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 con el ID del paquete que usa Play Store de Android, como com.google.android.gm.

Las apps para iOS se identifican con un ID de app de nueve dígitos que usa la tienda de aplicaciones de Apple, como 422689480.
platform

enum (Platform)

Solo salida. Es 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

Son las posibles plataformas de apps para dispositivos móviles.

Enums
PLATFORM_UNSPECIFIED No se especificó la plataforma.
IOS Plataforma de 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)
  },
  "videoAdInventoryControl": {
    object (VideoAdInventoryControl)
  }
}
Campos
viewFrequencyCap

object (FrequencyCap)

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

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

object (ThirdPartyMeasurementConfigs)

Opcional. Son los parámetros de configuración de medición de terceros de la línea de pedido.
inventorySourceSettings

object (YoutubeAndPartnersInventorySourceConfig)

Son los parámetros de configuración que controlan a qué inventarios de YouTube y socios se segmentará la línea de pedido.
contentCategory

enum (YoutubeAndPartnersContentCategory)

Solo salida. Es 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. Cuando se establece la categoría de contenido tanto en la línea de pedido como en el anunciante, se aplicará la más estricta cuando se publique la línea de pedido.

Las líneas de pedido nuevas solo heredarán el parámetro de configuración a nivel del anunciante.
targetFrequency

object (TargetFrequency)

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

string (int64 format)

Opcional. Es el ID de la cuenta de Merchant Center que se usa para proporcionar un feed de productos.

Esta cuenta de Merchant Center ya debe estar vinculada al anunciante.
relatedVideoIds[]

string

Opcional. Los IDs de los videos aparecen debajo del anuncio de video principal cuando este se reproduce en la app de YouTube para dispositivos móviles.
leadFormId

string (int64 format)

Opcional. Es el ID del formulario para generar clientes potenciales.
videoAdSequenceSettings

object (VideoAdSequenceSettings)

Opcional. Es la configuración relacionada con VideoAdSequence.
videoAdInventoryControl

object (VideoAdInventoryControl)

Opcional. Es la configuración para controlar qué inventario se permite para esta línea de pedido.

ThirdPartyMeasurementConfigs

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

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_ZEFR
  • 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
  • THIRD_PARTY_VENDOR_VIDEO_RESEARCH
  • THIRD_PARTY_VENDOR_MEDIA_SCOPE
  • THIRD_PARTY_VENDOR_AUDIENCE_PROJECT
  • THIRD_PARTY_VENDOR_VIDEO_AMP
  • THIRD_PARTY_VENDOR_ISPOT_TV
  • THIRD_PARTY_VENDOR_GEMIUS
brandLiftVendorConfigs[]

object (ThirdPartyVendorConfig)

Opcional. Son los proveedores externos que miden el Brand Lift.

Se aplican los siguientes proveedores externos:

  • THIRD_PARTY_VENDOR_DYNATA
  • THIRD_PARTY_VENDOR_KANTAR
  • THIRD_PARTY_VENDOR_INTAGE
  • THIRD_PARTY_VENDOR_MACROMILL

ThirdPartyVendorConfig

Son los 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 de terceros.
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.

Enums
THIRD_PARTY_VENDOR_UNSPECIFIED Proveedor externo desconocido.
THIRD_PARTY_VENDOR_MOAT Moat.
THIRD_PARTY_VENDOR_DOUBLE_VERIFY DoubleVerify.
THIRD_PARTY_VENDOR_INTEGRAL_AD_SCIENCE 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.
THIRD_PARTY_VENDOR_TRANSUNION TransUnion
THIRD_PARTY_VENDOR_ORIGIN origen.
THIRD_PARTY_VENDOR_GEMIUS Gemius.
THIRD_PARTY_VENDOR_MEDIA_SCOPE MediaScope.
THIRD_PARTY_VENDOR_AUDIENCE_PROJECT Audience Project
THIRD_PARTY_VENDOR_VIDEO_AMP VideoAmp
THIRD_PARTY_VENDOR_ISPOT_TV iSpot.tv
THIRD_PARTY_VENDOR_INTAGE Intage.
THIRD_PARTY_VENDOR_MACROMILL Macromill.
THIRD_PARTY_VENDOR_VIDEO_RESEARCH Video Research.
THIRD_PARTY_VENDOR_AQUILA Aquila.

YoutubeAndPartnersInventorySourceConfig

Son los parámetros de configuración que controlan los inventarios relacionados con YouTube a los que 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 el inventario en YouTube. Esto incluye la búsqueda, los canales y los videos.
includeGoogleTv

boolean

Opcional. Indica si se debe segmentar el inventario en las apps de video disponibles con Google TV.
includeYoutubeVideoPartners

boolean

Indica si se debe segmentar el inventario para un conjunto de sitios y apps 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 de socios

Enums
YOUTUBE_AND_PARTNERS_CONTENT_CATEGORY_UNSPECIFIED La categoría de contenido no se especificó o es desconocida 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 de YouTube y de los socios de video que cumple con los estándares de 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 cuanto al lenguaje inapropiado y el contenido provocativo de carácter sexual.

TargetFrequency

Es el parámetro de configuración que controla la cantidad promedio de veces que se mostrarán los anuncios a la misma persona durante un período determinado.

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

string (int64 format)

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

enum (TimeUnit)

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

Se aplica la siguiente unidad de tiempo:

  • TIME_UNIT_WEEKS
timeUnitCount

integer

Es la cantidad de timeUnit 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)

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

object (VideoAdSequenceStep)

Son los pasos que componen la secuencia.

VideoAdSequenceMinimumDuration

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

Enums
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

Es el detalle de un solo paso en una VideoAdSequence.

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

string (int64 format)

Es el ID del paso.
adGroupId

string (int64 format)

Es el ID del grupo de anuncios correspondiente del paso.
previousStepId

string (int64 format)

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

enum (InteractionType)

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

InteractionType

Son los tipos de interacción en un paso.

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

VideoAdInventoryControl

Es el control del inventario de anuncios de video que se usa en ciertos tipos de líneas de pedido de YouTube.

Representación JSON 
{
  "allowInStream": boolean,
  "allowInFeed": boolean,
  "allowShorts": boolean,
  "allowNonSkippableInStream": boolean
}
Campos
allowInStream

boolean

Opcional. Indica si los anuncios se pueden publicar en formato in-stream.
allowInFeed

boolean

Opcional. Indica si los anuncios se pueden publicar en el formato in-feed.
allowShorts

boolean

Opcional. Indica si los anuncios se pueden publicar en formato de Shorts.
allowNonSkippableInStream

boolean

Opcional. Indica si los anuncios se pueden publicar en el formato in-stream que no se puede omitir.

DemandGenSettings

Configuración de las líneas de pedido de las campañas de generación de demanda.

Representación JSON 
{
  "thirdPartyMeasurementConfigs": {
    object (ThirdPartyMeasurementConfigs)
  },
  "linkedMerchantId": string,
  "geoLanguageTargetingEnabled": boolean
}
Campos
thirdPartyMeasurementConfigs

object (ThirdPartyMeasurementConfigs)

Opcional. Es la configuración de la medición de terceros para la línea de pedido de la campaña de generación de demanda.
linkedMerchantId

string (int64 format)

Opcional. Es el ID de la cuenta de Merchant Center que se usa para proporcionar un feed de productos.

Esta cuenta de Merchant Center ya debe estar vinculada al anunciante.
geoLanguageTargetingEnabled

boolean

Opcional. Inmutable. Indica si la segmentación geográfica y por idioma se puede establecer a nivel de la línea de pedido. De lo contrario, se deben asignar los tipos de segmentación pertinentes directamente a los grupos de anuncios.

Métodos

bulkEditAssignedTargetingOptions

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

bulkListAssignedTargetingOptions

 Muestra una lista de 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.

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.