REST Resource: advertisers.lineItems

{
  "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)
  },
  "inventorySourceIds": [
    string
  ],
  "targetingExpansion": {
    object (TargetingExpansionConfig)
  },
  "warningMessages": [
    enum (LineItemWarningMessage)
  ],
  "mobileApp": {
    object (MobileApp)
  },
  "reservationType": enum (ReservationType),
  "excludeNewExchanges": boolean
}

string

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

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.

enum (LineItemType)

Obligatorio. Inmutable. El tipo de línea de pedido.

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.
• No se puede volver a cambiar una línea de pedido 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, no podrá invertir su presupuesto, incluso si su propio estado es ENTITY_STATUS_ACTIVE.

string (Timestamp format)

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

object (PartnerCost)

Es el costo del socio asociado a la línea de pedido.

Si está ausente o 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.

object (LineItemFlight)

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

object (LineItemBudget)

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

object (Pacing)

Obligatorio. Es la configuración de velocidad de inversión del presupuesto de la línea de pedido.

object (FrequencyCap)

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

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

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

Es la configuración del seguimiento de conversiones de la línea de pedido.

string (int64 format)

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

object (BiddingStrategy)

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

object (IntegrationDetails)

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

string (int64 format)

Son los IDs de las fuentes de inventario privado asignadas a la línea de pedido.

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 segmentan de forma positiva para listas de público aptas.

enum (LineItemWarningMessage)

Solo salida. 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 impidan su publicación.

object (MobileApp)

Es la aplicación para dispositivos móviles que promociona 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.

enum (ReservationType)

Solo salida. El tipo de reserva de la línea de pedido.

boolean

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

{
  "flightDateType": enum (LineItemFlightDateType),
  "dateRange": {
    object (DateRange)
  },
  "triggerId": string
}

enum (LineItemFlightDateType)

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

object (DateRange)

Son las fechas de inicio y finalización del período de publicación de la línea de pedido. Se resuelven según 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, los valores de startDate y endDate deben estar en el futuro.
• Un vuelo existente con un startDate en el pasado tiene un endDate mutable, pero un startDate inmutable.
• endDate debe ser la startDate o una posterior, ambos antes del año 2037.

string (int64 format)

El ID del activador manual asociado con la línea de pedido.

• Obligatorio cuando flightDateType es LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER. No debe establecerse de otra manera.
• Cuando se establece, las fechas de publicación de la línea de pedido se heredan de su pedido de inserción superior.
• Las líneas de pedido activas se invertirán cuando se active el activador seleccionado en las fechas de publicación del pedido de inserción superior.

Advertencia: Las líneas de pedido que usan activadores manuales ya no se publican en Display & Video 360. Este campo dejará de estar disponible el 1 de agosto de 2023. Lee nuestro anuncio de baja de funciones para obtener más información.

{
  "budgetAllocationType": enum (LineItemBudgetAllocationType),
  "budgetUnit": enum (BudgetUnit),
  "maxAmount": string
}

enum (LineItemBudgetAllocationType)

Obligatorio. El tipo de asignación de 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.

enum (BudgetUnit)

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

string (int64 format)

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

Cuando budgetAllocationType sea:

• 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 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á.

{
  "markupType": enum (PartnerRevenueModelMarkupType),
  "markupAmount": string
}

enum (PartnerRevenueModelMarkupType)

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

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 micros de la moneda del anunciante. Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda.
• Cuando markupType se configura como PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, este campo representa el margen de beneficio porcentual del costo de medios en milisegundos. Por ejemplo, 100 representa 0.1% (0.001 decimal).
• Cuando markupType se configura como PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, este campo representa el margen de beneficio porcentual del costo total de medios en milisegundos. Por ejemplo, 100 representa 0.1% (0.001 decimal).

{
  "postViewCountPercentageMillis": string,
  "floodlightActivityConfigs": [
    {
      object (TrackingFloodlightActivityConfig)
    }
  ]
}

string (int64 format)

Es el porcentaje de conversiones posteriores a la vista que se cuentan, 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.

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 que se contabilizan por todos los IDs de actividad de Floodlight especificados en este campo.

{
  "floodlightActivityId": string,
  "postClickLookbackWindowDays": integer,
  "postViewLookbackWindowDays": integer
}

string (int64 format)

Obligatorio. El ID de la actividad de Floodlight.

integer

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

integer

Obligatorio. Indica la cantidad de días posteriores a la visualización de un anuncio en los que se puede registrar una conversión. Debe estar comprendido entre 0 y 90 inclusive.

{
  "targetingExpansionLevel": enum (TargetingExpansionLevel),
  "excludeFirstPartyAudience": boolean
}

enum (TargetingExpansionLevel)

Obligatorio. Indica si se activó la segmentación optimizada.

Este campo admite los siguientes valores:

• NO_EXPANSION: La segmentación optimizada está desactivada
• LEAST_EXPANSION: La segmentación optimizada está activada

Si este campo se establece en cualquier otro valor, se establecerá automáticamente en LEAST_EXPANSION.

NO_EXPANSION será el valor predeterminado para el campo y se asignará automáticamente si no lo configuras.

boolean

Indica si se deben excluir los públicos propios para que no se usen en la expansión de la segmentación.

Este campo dejó de estar disponible con el lanzamiento de la segmentación optimizada.

Este campo se establecerá como false. Si este campo se configura como true cuando deje de estar disponible, toda la segmentación positiva por público propio asignada a esta línea de pedido se reemplazará por la segmentación negativa de los mismos públicos propios para garantizar la exclusión continua de esos públicos.

{
  "appId": string,
  "platform": enum (Platform),
  "displayName": string,
  "publisher": string
}

string

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

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

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

enum (Platform)

Solo salida. La plataforma de la app

string

Solo salida. Es el nombre de la app.

string

Solo salida. Es el publicador de la app.