- Recurso: LineItem
- LineItemType
- LineItemFlight
- LineItemFlightDateType
- LineItemBudget
- LineItemBudgetAllocationType
- PartnerRevenueModel
- PartnerRevenueModelMarkupType
- ConversionCountingConfig
- TrackingFloodlightActivityConfig
- TargetingExpansionConfig.
- TargetingExpansionLevel
- LineItemWarningMessage
- MobileApp
- Plataforma
- Métodos
Recurso: LineItem
Es una sola línea de pedido.
Representación JSON |
---|
{ "name": string, "advertiserId": string, "campaignId": string, "insertionOrderId": string, "lineItemId": string, "displayName": string, "lineItemType": enum ( |
Campos | |
---|---|
name |
Solo salida. El nombre del recurso de la línea de pedido. |
advertiserId |
Solo salida. Es el ID único del anunciante al que pertenece la línea de pedido. |
campaignId |
Solo salida. Indica el ID único de la campaña a la que pertenece la línea de pedido. |
insertionOrderId |
Obligatorio. Inmutable. Es el ID único del pedido de inserción al que pertenece la línea de pedido. |
lineItemId |
Solo salida. El ID único de la línea de pedido. Lo asigna el sistema. |
displayName |
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 |
Obligatorio. Inmutable. El tipo de línea de pedido. |
entityStatus |
Obligatorio. Controla si la línea de pedido puede invertir su presupuesto y ofertar en el inventario.
|
updateTime |
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: |
partnerCosts[] |
Es el costo del socio asociado a la línea de pedido. Si está ausente o vacío en el método |
flight |
Obligatorio. Hora de inicio y finalización del período de publicación de la línea de pedido. |
budget |
Obligatorio. La configuración de asignación de presupuesto de la línea de pedido. |
pacing |
Obligatorio. Es la configuración de velocidad de inversión del presupuesto de la línea de pedido. |
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 |
partnerRevenueModel |
Obligatorio. La configuración del modelo de ingresos de socios de la línea de pedido. |
conversionCounting |
Es la configuración del seguimiento de conversiones de la línea de pedido. |
creativeIds[] |
Son los ID de las creatividades asociadas con la línea de pedido. |
bidStrategy |
Obligatorio. Es la estrategia de ofertas de la línea de pedido. |
integrationDetails |
Son los detalles de integración de la línea de pedido. |
inventorySourceIds[] |
Son los IDs de las fuentes de inventario privado asignadas a la línea de pedido. |
targetingExpansion |
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. |
warningMessages[] |
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. |
mobileApp |
Es la aplicación para dispositivos móviles que promociona la línea de pedido. Esto es aplicable solo cuando |
reservationType |
Solo salida. El tipo de reserva de la línea de pedido. |
excludeNewExchanges |
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. |
LineItemType
Tipos posibles de una línea de pedido.
El tipo de línea de pedido determina qué configuración y opciones son aplicables, 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. Las líneas de pedido de este tipo y su segmentación no se pueden crear ni actualizar con la API. |
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 el CPM para diversos 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 Las líneas de pedido de este tipo y su segmentación no se pueden crear ni actualizar con la API. |
LINE_ITEM_TYPE_VIDEO_MOBILE_APP_INVENTORY |
Anuncios de video que se publican en el inventario de la aplicación para dispositivos móviles Las líneas de pedido de este tipo y su segmentación no se pueden crear ni actualizar con la API. |
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 |
Los anuncios de transmisión libre están 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 . |
LineItemFlight
Es la configuración que controla la duración activa de una línea de pedido.
Representación JSON |
---|
{ "flightDateType": enum ( |
Campos | |
---|---|
flightDateType |
Obligatorio. El tipo de fechas de publicación de la línea de pedido. |
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.
|
triggerId |
El ID del activador manual asociado con la línea de pedido.
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. |
LineItemFlightDateType
Son los 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. |
LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER |
La línea de pedido usa un activador. Advertencia: Las líneas de pedido que usan activadores manuales ya no se publican en Display & Video 360. Este valor dejará de estar disponible el 1 de agosto de 2023. Lee nuestro anuncio de baja de funciones para obtener más información. |
LineItemBudget
Configuración que controla cómo se asigna el presupuesto.
Representación JSON |
---|
{ "budgetAllocationType": enum ( |
Campos | |
---|---|
budgetAllocationType |
Obligatorio. El tipo de asignación de presupuesto.
|
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. |
maxAmount |
El importe de presupuesto máximo que invertirá la línea de pedido. Debe ser mayor que 0. Cuando
|
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 de presupuesto máximo fijo a la línea de pedido. |
LINE_ITEM_BUDGET_ALLOCATION_TYPE_UNLIMITED |
No se aplica un límite de presupuesto a la línea de pedido. |
PartnerRevenueModel
Es la configuración que controla cómo se calculan los ingresos del socio.
Representación JSON |
---|
{
"markupType": enum ( |
Campos | |
---|---|
markupType |
Obligatorio. Es el tipo de lenguaje de marcado del modelo de ingresos de socios. |
markupAmount |
Obligatorio. Es el importe del margen del modelo de ingresos de socios. Debe ser mayor o igual que 0.
|
PartnerRevenueModelMarkupType
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 del costo de medios total, que incluye todos los costos del socio y los costos de datos. |
ConversionCountingConfig
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 recuento de conversiones posteriores a la vista.
Representación JSON |
---|
{
"postViewCountPercentageMillis": string,
"floodlightActivityConfigs": [
{
object ( |
Campos | |
---|---|
postViewCountPercentageMillis |
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. |
floodlightActivityConfigs[] |
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. |
TrackingFloodlightActivityConfig
Son parámetros que controlan el comportamiento de una sola configuración de actividad de Floodlight.
Representación JSON |
---|
{ "floodlightActivityId": string, "postClickLookbackWindowDays": integer, "postViewLookbackWindowDays": integer } |
Campos | |
---|---|
floodlightActivityId |
Obligatorio. El ID de la actividad de Floodlight. |
postClickLookbackWindowDays |
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. |
postViewLookbackWindowDays |
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. |
TargetingExpansionConfig
Son los parámetros de configuración que controlan la configuración de la segmentación optimizada de la línea de pedido.
Representación JSON |
---|
{
"targetingExpansionLevel": enum ( |
Campos | |
---|---|
targetingExpansionLevel |
Obligatorio. Indica si se activó la segmentación optimizada. Este campo admite los siguientes valores:
Si este campo se establece en cualquier otro valor, se establecerá automáticamente en
|
excludeFirstPartyAudience |
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 |
TargetingExpansionLevel
La configuración de la segmentación optimizada
Enumeradores | |
---|---|
TARGETING_EXPANSION_LEVEL_UNSPECIFIED |
No se especificó el parámetro de configuración de la segmentación optimizada o se desconoce en esta versión. |
NO_EXPANSION |
La segmentación optimizada está desactivada. |
LEAST_EXPANSION |
La segmentación optimizada está activada. |
SOME_EXPANSION |
Si se usa, se establecerá automáticamente en |
BALANCED_EXPANSION |
Si se usa, se establecerá automáticamente en |
MORE_EXPANSION |
Si se usa, se establecerá automáticamente en |
MOST_EXPANSION |
Si se usa, se establecerá automáticamente en |
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 bloquearla para que no se ejecute.
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 publicará 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 publicará la línea de pedido. |
INVALID_INVENTORY_SOURCE |
No se orientan fuentes de inventario activas. No se publicará 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 aplicaciones para dispositivos móviles en la segmentación de su canal, lista de sitios o aplicaciones. No se publicará la línea de pedido. |
APP_INVENTORY_INVALID_AUDIENCE_LISTS |
Esta línea de pedido no se orienta a 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. No se publicará la línea de pedido. |
NO_VALID_CREATIVE |
Esta línea de pedido no contiene ninguna creatividad válida. No se publicará la línea de pedido. |
PARENT_INSERTION_ORDER_PAUSED |
El pedido de inserción de esta línea de pedido está detenido. No se publicará 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 publicará la línea de pedido. |
NO_POSITIVE_AUDIENCE_LIST_TARGETED |
Esta línea de pedido no se orienta a ninguna lista de público. Eso puede hacer que su presupuesto se invierta demasiado rápido. |
APP_INSTALL_NO_CONVERSION_PIXEL |
Esta línea de pedido de instalación de aplicación no tiene configurado ningún píxel de conversión. |
TARGETING_REVOKED_OR_CLOSED_USER_LIST |
Esta línea de pedido se orienta a una o más listas de usuarios que ya no están disponibles. En el futuro, esto impedirá que la línea de pedido se publique, por lo que debes considerar quitar estas listas de tu segmentación. |
APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY |
Esta línea de pedido de instalación de aplicaciones no tiene una estrategia de oferta óptima. |
CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS |
Los acuerdos a los que se orienta esta línea de pedido aceptan tamaños de creatividad que no están en uso. Esto puede limitar su publicación o rendimiento. |
NO_CREATIVE_FOR_TARGETED_DEALS |
Esta línea de pedido no contiene ninguna creatividad para los acuerdos segmentados. |
TARGETING_DEPRECATED_GEO_TARGET |
Esta línea de pedido se orienta a una segmentación geográfica que ya no está disponible. |
DEPRECATED_FIRST_PARTY_AUDIENCE_EXCLUSION |
Esta línea de pedido usa el parámetro de configuración Actualiza la integración de tu API para excluir directamente cualquier público propio mediante la segmentación por público antes del 25 de marzo de 2023 para tener en cuenta que el campo |
MobileApp
Una app para dispositivos móviles promocionada mediante una línea de pedido de instalación de app para dispositivos móviles
Representación JSON |
---|
{
"appId": string,
"platform": enum ( |
Campos | |
---|---|
appId |
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 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 |
platform |
Solo salida. La plataforma de la app |
displayName |
Solo salida. Es el nombre de la app. |
publisher |
Solo salida. Es el publicador de la app. |
Plataforma
Posibles plataformas de aplicaciones para dispositivos móviles
Enumeradores | |
---|---|
PLATFORM_UNSPECIFIED |
No se especificó la plataforma. |
IOS |
plataforma de iOS. |
ANDROID |
plataforma de Android. |
Métodos |
|
---|---|
|
Edita de forma masiva las opciones de segmentación en una sola línea de pedido. |
|
Se muestran las opciones de segmentación asignadas de una línea de pedido para todos los tipos de segmentación. |
|
Crea una línea de pedido nueva. |
|
Borra una línea de pedido. |
|
Crea una nueva línea de pedido con una configuración (incluida la segmentación) heredada del pedido de inserción y una entity_status con ENTITY_STATUS_DRAFT . |
|
Obtiene una línea de pedido. |
|
Muestra una lista de las líneas de pedido de un anunciante. |
|
Actualiza una línea de pedido existente. |