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. 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. Asignada por 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 oferta 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 su creación.
• Una línea de pedido no se puede volver al estado ENTITY_STATUS_DRAFT desde ningún otro estado.
• Si el pedido de inserción principal de la línea de pedido no está activo, esta no puede 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. Asignada por el sistema.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una 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)

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

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

object (LineItemFlight)

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

object (LineItemBudget)

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

object (Pacing)

Obligatorio. La configuración de la 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.

El campo maxImpressions de este objeto de configuración se debe usar si se asigna un límite limitado.

object (PartnerRevenueModel)

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

object (ConversionCountingConfig)

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

string (int64 format)

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

object (BiddingStrategy)

Obligatorio. 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 privadas asignadas a la línea de pedido.

object (TargetingExpansionConfig)

Es la configuración de la 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 utilizan ofertas automáticas y se orientan de forma positiva a listas de público aptas.

enum (LineItemWarningMessage)

Solo salida. Son los mensajes de advertencia que genera la línea de pedido. Estas advertencias no bloquean el guardado de la línea de pedido, pero algunas pueden impedir su publicación.

object (MobileApp)

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.

enum (ReservationType)

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

boolean

Establece si se deben excluir nuevos intercambios para que no se orienten automáticamente a la línea de pedido. Este campo es falso de forma predeterminada.

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

enum (LineItemFlightDateType)

Obligatorio. El tipo de las 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. Resultado solo de lo contrario.
• Cuando creas un nuevo vuelo, tanto startDate como endDate deben ser en el futuro.
• Un vuelo existente con un startDate del pasado tiene un endDate mutable, pero un startDate inmutable.
• endDate debe ser startDate o posterior, ambos antes del año 2037.

string (int64 format)

Es el ID del activador manual asociado a la línea de pedido.

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

Advertencia: Las líneas de pedido que utilizan activadores manuales ya no se publican en Display ni Video en 360° Este campo se desactivará el 1 de agosto de 2023. Lee el anuncio de la baja de la función para obtener más información.

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

enum (LineItemBudgetAllocationType)

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

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.

string (int64 format)

El importe máximo del presupuesto 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. El tipo de margen de beneficios del modelo de ingresos de socios.

string (int64 format)

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

• Cuando el valor de markupType es PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM, este campo representa el lenguaje de marcado de CPM en micros de la moneda del anunciante. Por ejemplo, 1500000 representa 1.5 unidades estándar de la moneda.
• Cuando se establece markupType en PARTNER_REVENUE_MODEL_MARKUP_TYPE_MEDIA_COST_MARKUP, este campo representa el margen de beneficios del costo de medios en milésimas de segundo. Por ejemplo, 100 representa 0.1% (0.001 decimal).
• Cuando se establece markupType en PARTNER_REVENUE_MODEL_MARKUP_TYPE_TOTAL_MEDIA_COST_MARKUP, este campo representa el margen de beneficios del costo total de medios en milésimas de segundo. 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 reproducción que se deben registrar, en milisegundos (1/1,000 de un porcentaje). El valor debe estar comprendido entre 0 y 100,000, inclusive.

Por ejemplo, para realizar un seguimiento del 50% de las conversiones posteriores al clic, establece un valor de 50,000.

object (TrackingFloodlightActivityConfig)

La configuración de la actividad de Floodlight que se utiliza 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.

{
  "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 posteriores a un clic en un anuncio en los que se puede registrar una conversión. Debe estar comprendido entre 0 y 90 inclusive.

integer

Obligatorio. Es 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. Si la segmentación optimizada está activada

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 configura con cualquier otro valor, se establecerá automáticamente en LEAST_EXPANSION.

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

boolean

Indica si se deben excluir públicos propios para evitar su uso 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á en false. Si estableces este campo como true cuando deje de estar disponible, toda la segmentación por público propia que se haya asignado a esta línea de pedido se reemplazará por una 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 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.

enum (Platform)

Solo salida. La plataforma de la app

string

Solo salida. Es el nombre de la app.

string

Solo salida. El publicador de la app