Servicio de elementos de línea: ALI

Nota:

En esta página se describe el servicio de elementos de línea para los elementos de línea aumentadas. Se vincula a otra documentación de API que está diseñada para elementos de línea heredados y puede mencionar campos y objetos que no se usan con elementos de línea aumentadas. Lo más importante es que los elementos de línea aumentadas solo se pueden usar con pedidos de inserción sin problemas, no con pedidos de inserción heredados, que no admiten intervalos presupuestados (es decir, no usan la budget_intervals matriz).

Para crear un elemento de línea aumentada, debe establecer el line_item_type campo en 'standard_v2' y asociar el elemento de línea con un orden de inserción sin problemas a través de la insertion_orders matriz.

Un elemento de línea define su relación financiera con un anunciante, incluido el presupuesto, el tipo de ingresos, los objetivos de rendimiento, las estrategias de puja y la segmentación de inventario. El elemento de línea aumentada debe usarse con el orden de inserción sin problemas. Le sugerimos que optimice la configuración para las relaciones de anunciantes de larga duración agregando intervalos de presupuesto a los pedidos de inserción.

API de REST

Http (método)	Endpoint	Description
POST	https://api.appnexus.com/line-item?advertiser_id=ADVERTISER_ID (JSON de elemento de línea)	Agregue un nuevo elemento de línea.
PUT	- https://api.appnexus.com/line-item?id=LINEITEM_ID& advertiser_id=ADVERTISER_ID - https://api.appnexus.com/line-item?code=LINE-ITEM_CODE& advertiser_code=ADVERTISER_CODE (JSON de elemento de línea)	Modificar un elemento de línea existente.
GET	- https://api.appnexus.com/line-item?advertiser_id=ADVERTISER_ID - https://api.appnexus.com/line-item?code=LINE-ITEM_CODE& advertiser_code=ADVERTISER_CODE	Ver todos los artículos de línea de un anunciante.
GET	https://api.appnexus.com/line-item?id=1,2,3 Nota: Filtros de cadena de consulta útiles - Puede filtrar por artículos de línea en función de cuándo se atienden por primera y última vez. Esto resulta especialmente útil cuando se está aproximando al límite de objetos y es necesario identificar los elementos de línea que se pueden eliminar del sistema. Para obtener más información, consulte Primera ejecución o última ejecución. - Puede filtrar por la línea que no está sirviendo debido a varias condiciones. Para obtener más información, consulte Alertas a continuación.	Vea varios elementos de línea por identificador mediante una lista separada por comas.
GET	https://api.appnexus.com/line-item?search=SEARCH_TERM	Busque elementos de línea con identificadores o nombres que contengan determinados caracteres.
DELETE	- https://api.appnexus.com/line-item?id=LINEITEM_ID& advertiser_id=ADVERTISER_ID - https://api.appnexus.com/line-item?code=LINE-ITEM_CODE& advertiser_code=ADVERTISER_CODE Advertencia: La eliminación es recursiva y permanente Al eliminar un elemento de línea también se eliminarán todos sus rastreadores de impresiones, seguimientos de clics, intervalos de presupuesto asociados y divisiones. Las eliminaciones son permanentes y no se pueden revertir. Aunque los objetos eliminados siguen estando disponibles en los informes, ya no tendrá visibilidad sobre su configuración específica (por ejemplo, presupuesto de ingresos, seguimiento, presupuesto de costos y segmentación).	Eliminar un elemento de línea.

Nota:

Acerca de los objetivos de rendimiento

Los píxeles objetivo se usan para realizar un seguimiento y medir el revenue_typegoal_type rendimiento cuando y no se miden de la misma manera. Por ejemplo, una revenue_type de "cpm" puede coincidir con una goal_type de "cpa" porque el anunciante quiere medir el logro del objetivo en términos de conversiones, pero pagar en CPM.

• CPA: para establecer objetivos de rendimiento para los elementos de línea con goal_type"cpa", use la matriz Goal Pixels de objetos y el objeto Valuation siguiente. La goal_pixels matriz contiene información sobre los objetivos y umbrales de CPA. Consulte CPC a continuación para obtener una explicación básica del valuation objeto.
• CPC: para establecer objetivos de rendimiento para los elementos de goal_type"cpc"línea con , use el valuation objeto . El valuation objeto contiene el umbral del objetivo de rendimiento, que determina el límite de puja/sin puja en los elementos de línea optimizados y el objetivo de rendimiento, que representa los clics deseados o la tasa de clics. Para obtener más información sobre los campos que se van a establecer, consulte la descripción del valuation objeto siguiente.

Acerca de la segmentación geográfica

En el caso del elemento de línea aumentada, es obligatorio establecer al menos un país como destino de geografía. Para agregar la segmentación geográfica, vea Destinos de país en la sección Segmentación en la página Servicio de perfiles .

Campos JSON

General

Campo	Tipo	Descripción
id	Entero	Identificador del elemento de línea. Obligatorio On:PUT, en la cadena de consulta.
code	string (100)	Código personalizado para el elemento de línea. El código solo puede contener caracteres alfanuméricos, puntos, caracteres de subrayado o guiones. El código especificado no distingue mayúsculas de minúsculas (los caracteres de mayúsculas y minúsculas se tratan igual). No hay 2 objetos en el mismo nivel (por ejemplo, pedidos de inserción o artículos de línea) que puedan usar el mismo código por anunciante. Por ejemplo, dos elementos de línea no pueden usar el código "XYZ", pero un único orden de inserción y su elemento de línea secundario pueden. Predeterminado:null
name	string (255)	Nombre del elemento de línea. Obligatorio activado:POST
advertiser_id	Entero	Identificador del anunciante al que pertenece el elemento de línea.
state	enumeración	Estado del elemento de línea. Valores posibles: "active" o "inactive". Predeterminado:"active"
line_item_type	enumeración	Tipo de elemento de línea. Los posibles valores son: - "standard_v1": elemento de línea estándar (que no es ALI). - "standard_v2": elemento de línea aumentada (ALI). - "guaranteed_delivery": elemento de línea garantizado (GDLI). - "curated": elemento de línea seleccionado. Nota: Asegúrese de que este campo está establecido en "standard_v2" para las ALIs. Predeterminado:"standard_v2"
start_date	Timestamp	No use este campo. En su lugar, use los start_date campos y end_date de la budget_intervals matriz para designar cuándo se debe ejecutar el elemento de línea. Predeterminado:null (inmediatamente)
end_date	Timestamp	No use este campo. En su lugar, use los start_date campos y end_date de la budget_intervals matriz para designar cuándo se debe ejecutar el elemento de línea. Predeterminado:null (indefinidamente)
timezone	enumeración	Zona horaria por la que se cuenta el presupuesto y el gasto. Para más información y valores aceptados, consulte Zonas horarias de API. Nota: En el caso de las ALIs, asegúrese de usar este campo (y no el de la budget_intervals matriz) para establecer la zona horaria del elemento de línea. Predeterminado:"UTC" o la zona horaria del anunciante.
ad_types	matriz de cadenas	Tipo de creatividad que se usa para este elemento de línea. Posibles valores: - "banner" - "video" - "native" - "audio" La matriz solo debe tener un valor único. Este valor determina cómo se realiza el seguimiento de los elementos de la subasta para la estrategia de compra del artículo de línea, la estrategia de pago, las opciones de optimización, la asociación creativa y las opciones de selección de destino. Nota: Todas las creatividades asociadas a un elemento de línea deben tener el mismo tipo de anuncio, que debe coincidir con el ad_types seleccionado aquí. Predeterminado:"banner" Obligatorio activado:POST/PUT
discrepancy_pct	double	Obsolescente.
publishers_allowed	string	Obsoleto. Use los valores de la supply_strategies matriz para establecer los tipos de suministro (por ejemplo, RTB/Open Exchange, Deals, Managed).
revenue_value	double	Cantidad pagada a la red por el anunciante. Nota: En función de lo que establezca el revenue_type campo en , este campo debe establecerse en el valor real de ese tipo de ingresos (por ejemplo, el CPC deseado). revenue_type Si es "cost_plus_margin", establezca este campo en el margen de porcentaje que el cliente le paga (por ejemplo, .20 el 20 %). Obligatorio activado:POST/PUT
revenue_type	enumeración	La forma en que el anunciante ha aceptado pagarle (también denominados Ingresos reservados). A continuación se enumeran los valores posibles. - "cpm": seleccione este valor si se le está pagando el pago plano por 1000 impresiones (CPM), por clic (CPC) o por vista (CPM visible):   - Si CPM, establézcalo en "cpm", el revenue_value campo en el valor de CPM y establezca los max_avg_cpm campos y min_avg_cpm en null.   - Si CPC, establézcalo en , el revenue_value campo en el valor de CPC y establezca en "click""revenue_auction_event_type" , "revenue_auction_event_type_code" en "click"y en "revenue_auction_type_id"3."cpm"   - Si se puede ver CPM, establézcalo en , el revenue_value campo en el valor de CPM visible, el revenue_auction_event_type campo en "view", el revenue_auction_event_type_code campo en "view_display_50pv1s_an"y en "revenue_auction_type_id"2."cpm" Solo se contarán las impresiones visualizables medidas, de acuerdo con la medición de visualización Xandr, mediante la definición de IAB.   - Si CPCV, establézcalo en , el ad_types campo en "video", "revenue_auction_event_type" en "video", "video_completion""revenue_auction_event_type_code" en y en "revenue_auction_type_id"10."cpm" - "vcpm": un CPM dinámico (donde ingresos reservados es igual al costo de la impresión antes de la reducción de la oferta). Si "vcpm" se selecciona aquí, goal_type se ha establecido en 'none'y no se ha asociado ningún 'expected_value' modelo, debe establecer un 'max_avg_cpm' valor. Nota: Si programmatic_guaranteed (en ) está establecido trueen , revenue_type debe establecerse en cost_plus_marginsupply_strategieso cost_plus_cpm. - "cost_plus_margin": costo de medios (lo que se gasta en el inventario) más un porcentaje de lo que se gasta. Si está seleccionado, también debe establecer en un margen porcentual que reciba (por ejemplo, .2 para el revenue_value 20 %). Los costos de datos también se agregarán si participa en la compensación de datos de terceros (por ejemplo, segmentos). Si deshabilita la optimización de Cost Plus (a través del goal_type campo ), debe establecer un CPM plano para Cost Plus a través del max_avg_cpm campo (en el valuation objeto ). - "cost_plus_cpm": costo multimedia (lo que se gasta en el inventario) más una tarifa de servicio que cobras al anunciante en función de los ingresos de CPM. Si está seleccionado, también debe establecer en revenue_value un margen de CPM plano que reciba (por ejemplo, 1 para un CPM de 1 USD). Los costos de datos también se agregarán si participa en la compensación de datos de terceros (por ejemplo, segmentos). Si deshabilita la optimización de Cost Plus (a través del goal_type campo ), debe establecer un CPM plano para Cost Plus a través del max_avg_cpm campo (en el valuation objeto ). Nota: Si se establecen los campos o daily_budget_imps o el orden de inserción primario del elemento budget_type de línea se establece en impression, es revenue_type posible que no se establezca en "CPC".lifetime_budget_imps Predeterminado:"none"
goal_type	enumeración	Para los elementos de línea que hacen uso de los objetivos de rendimiento. Valores posibles: null, "cpc", "cpa", "ctr"o "custom". - Si desea optimizar un objetivo de rendimiento de CPA para conversiones posteriores al clic y posteriores a la vista, establezca este campo en "cpa". También debe establecer los post_click_goal_threshold campos y post_videw_goal_threshold (en la matriz de objetos) en el goal_pixels objetivo de CPA. Estos valores deben ser los mismos, ya que Xandr se optimizará en un valor. Además, debe establecer en campaign_group_valuation_strategy "retargeting" o "prospecting". Para obtener más información, vea campaign_valuation_strategy en Valoración a continuación. - Si desea optimizar un objetivo de rendimiento de CPA solo para conversiones posteriores al clic, establezca este campo en "cpa". También debe establecer los post_click_goal_target campos y post_click_goal_threshold (en la matriz de objetos) en el goal_pixels objetivo de CPA. - Si desea optimizar un objetivo de CPC, establezca este campo en "cpc". También debe establecer los goal_target campos y goal_threshold (en el objeto) en el valuation objetivo de CPC y establecer en nullgoal_pixel . - Si desea optimizar un objetivo de CPM visible, establezca este campo en null. También debe establecer los goal_target campos y goal_threshold (en el objeto de valoración) y goal_pixels en null. Además, también debe establecer los siguientes campos en el auction_event objeto : kpi_auction_event_type, kpi_auction_event_type_code, kpi_auction_type_idy kpi_value. - Si desea optimizar un objetivo de CTR, establezca este campo en "ctr". Además, también debe establecer y goal_target en goal_threshold el valuation objeto en la velocidad de clic deseada (un valor decimal entre 0 y 1). - Si desea cargar su propio modelo ev personalizado (valoración esperada), en lugar de un click_imp modelo o ev_click , establezca este campo en "custom". Para obtener más información, consulte Modelos personalizados. - Si desea deshabilitar la optimización, establezca este campo en null. Además, para PUT las llamadas, si el elemento de línea se estableció anteriormente para optimizarse en un CPM visible, también debe establecer los siguientes campos (en el auction_event objeto ) como se indica a continuación:   - "kpi_auction_event_type": "impression"   - "kpi_auction_event_type_code": "impression"   - "kpi_auction_type_id": 1   - "kpi_value": null Predeterminado:"none"
goal_value	double	Obsoleto. Use valuation el objeto en su lugar. Para obtener más información, consulte Valoración a continuación.
last_modified	Timestamp	Hora de la última modificación en este elemento de línea. Solo lectura.
click_url	string (1000)	Dirección URL del clic que se va a aplicar en el nivel de elemento de línea.
currency	string (3)	Moneda usada para este elemento de línea. Para obtener una lista de las monedas admitidas, consulte Servicio de divisas. Nota: Una vez creado el elemento de línea, no se puede cambiar la moneda. Propina: Como procedimiento recomendado, alinee la moneda con la moneda de facturación para lograr la mejor experiencia de moneda local posible. Predeterminado: Moneda predeterminada del anunciante.
require_cookie_for_tracking	booleano	Indica si desea servir solo a los usuarios identificados con fines de seguimiento de conversiones. Si se establece en true, no servirá a los usuarios anónimos porque tienen un menor potencial para la atribución de conversión. Si se establece falseen , esto indica que servirá a usuarios anónimos y solo aceptará la atribución de conversión basada en IP para esos usuarios (si está activado). La configuración de este campo solo es relevante cuando se ha aplicado un píxel de conversión, por lo que establecerlo true en no requerirá identificadores para un elemento de línea que no tenga píxeles de conversión. - Si truees , se requiere un identificador para el seguimiento de conversiones. - Si programmatic_guaranteed (en ) está establecido trueen , require_cookie_for_tracking debe establecerse en falsesupply_strategies. Predeterminado:true
profile_id	Entero	Puede asociar un elemento opcional profile_id a este elemento de línea. Un perfil es un conjunto genérico de reglas para el inventario de destino. Para obtener más información, consulte El servicio de perfiles.
member_id	Entero	Identificador del miembro propietario del elemento de línea.
comments	string	Comentarios sobre el elemento de línea.
remaining_days	Entero	Número de días entre hoy y el end_date de la línea de pedido. Nota: Esto será null si es start_date en el futuro o si start_date está establecido o end_date no. Solo lectura.
total_days	Entero	Número de días entre y start_dateend_date para el elemento de línea. Nota: Esto será null si start_dateend_date o no está establecido. Solo lectura.
advertiser	objeto	Objeto que describe el anunciante con el que está asociado este elemento de línea. Para obtener más información, consulta Anunciante a continuación. Solo lectura.
labels	matriz	Etiquetas opcionales aplicadas al elemento de línea. Actualmente, las etiquetas disponibles son: "Trafficker" y "Sales Rep". Para obtener más información, vea Etiquetas a continuación. Nota: Puede informar sobre etiquetas de elementos de línea con los informes de Network Analytics y Network Advertiser Analytics . Por ejemplo, si usa la "Trafficker" etiqueta para especificar el nombre del tratante responsable de cada elemento de línea, puede ejecutar el informe de Network Analytics filtrado por "trafficker_for_line_item" para centrarse en los elementos de línea de los que es responsable un tratante determinado o agruparlo por "trafficker_for_line_item" para clasificar el rendimiento de los tratantes.
broker_fees	matriz	Obsoleto. Use partner_fees en su lugar.
pixels	matriz de objetos	Píxeles de conversión usados para realizar un seguimiento de los ingresos de CPA. Se pueden especificar ingresos posteriores al clic y a la vista. Solo puede adjuntar 20 píxeles a un elemento de línea. Si necesita adjuntar más, hable con su consultor de implementación de Xandr o soporte técnico. Para obtener más información, consulte Píxeles y el ejemplo siguiente para obtener un ejemplo del formato. Predeterminado:null
broker_fees	matriz	Obsoleto. Use partner_fees en su lugar.
pixels	matriz de objetos	Píxeles de conversión usados para realizar un seguimiento de los ingresos de CPA. Se pueden especificar ingresos posteriores al clic y a la vista. Solo puede adjuntar 20 píxeles a un elemento de línea. Si necesita adjuntar más, hable con su consultor de implementación de Xandr o soporte técnico. Para obtener más información, consulte Píxeles y el ejemplo siguiente para obtener un ejemplo del formato. Predeterminado:null
insertion_orders	matriz de objetos	Objetos que contienen metadatos para los pedidos de inserción a los que está asociado este elemento de línea. Para obtener más información, vea Pedidos de inserción a continuación. Nota: Una vez que un elemento de línea está asociado a un orden de inserción sin problemas, no se puede asociar a un orden de inserción heredado.
goal_pixels	matriz de objetos	Para un elemento de línea con goal_type"cpa", los píxeles usados para el seguimiento de conversiones, así como los ingresos posteriores y posteriores al clic. Para obtener más información, consulte Píxeles de objetivo y el ejemplo siguiente para obtener un ejemplo del formato.
imptrackers	matriz de objetos	Rastreadores de impresiones de terceros asociados al elemento de línea. Para obtener más información, consulte Servicio de seguimiento de impresiones. Solo lectura.
clicktrackers	matriz de objetos	Seguimientos de clics de terceros asociados al elemento de línea. Para obtener más información, vea Click Tracker Service. Solo lectura.
valuation	objeto	En el caso de un elemento de línea con o goal_type"cpc""cpa", el umbral de objetivo de rendimiento, que determina el límite de puja o sin puja en los elementos de línea optimizados, y el objetivo de rendimiento, que representa los clics deseados (las conversiones para "cpa" se establecen en la matriz Goal Pixels de objetos). Para obtener más información, consulte Valoración a continuación.
creatives	matriz de objetos	Las creatividades asociadas al elemento de línea. Para obtener más detalles, consulte Creatives a continuación.
budget_intervals	matriz de objetos	Los intervalos de presupuesto permiten asociar varios intervalos de fecha a un elemento de línea, cada uno con los valores presupuestados correspondientes. Para obtener más información, consulte Intervalos de presupuesto a continuación. Nota: Si usa budget_intervals, no se deben usar los siguientes campos en el objeto de elemento de línea: - lifetime_pacing - lifetime_budget - lifetime_budget_imps - enable_pacing - lifetime_pacing_span - allow_safety_pacing - daily_budget - daily_budget_imps - lifetime_pacing_pct - subflights
lifetime_budget	double	No use este campo. En su lugar, use los campos de presupuesto dentro de la budget_intervals matriz. Predeterminado:null (ilimitado)
lifetime_budget_imps	Entero	No use este campo. En su lugar, use los campos de presupuesto dentro de la budget_intervals matriz. Predeterminado:null (ilimitado)
daily_budget	double	No use este campo. En su lugar, use los campos de presupuesto dentro de la budget_intervals matriz. Predeterminado:null (ilimitado)
daily_budget_imps	double	No use este campo. En su lugar, use los campos de presupuesto dentro de la budget_intervals matriz. Predeterminado:null (ilimitado)
enable_pacing	booleano	Si truees , el gasto presupuestado diario se distribuye uniformemente a lo largo de un día. Solo se aplica si hay un presupuesto diario. Es por eso que el valor predeterminado true es si se establece el presupuesto diario; de lo contrario, tiene como valor predeterminado null. Predeterminado:null
allow_safety_pacing	booleano	Obsoleto. Es posible que no se establezca este campo.
lifetime_pacing	booleano	Si truees , el elemento de línea intentará gastar su presupuesto total de duración uniformemente en las fechas de vuelo del elemento de línea. Si truees , no se puede establecer un daily_budget, no se puede establecer enable_pacingfalseen , y primero debe establecer un lifetime_budget, un start_datey un end_date para el elemento de línea. Predeterminado:null
lifetime_pacing_span	Entero	Nota: No use ni edite el valor de este campo. Predeterminado:null (3 días)
lifetime_pacing_pct	double	Un entero doble entre 50 y 150 incluidos, que se usa para establecer el ritmo a lo largo de un intervalo de presupuesto. Los valores posibles pueden ser dobles entre 50 y 150 en la siguiente escala: - 50: ritmo de retraso programado. - 100: pace uniformemente. - 150: el ritmo se adelanta a lo programado. Predeterminado:100
payout_margin	double	Margen de pago de los artículos de línea de la oferta de rendimiento.
insertion_order_id	Entero	Identificador del orden de inserción activo actual (cuando corresponda). Debe anexarse include_insertion_order_id=true para devolver este campo en una GET llamada. Para obtener más información, consulte el servicio de pedido de inserción.
stats	objeto	El objeto stats ha quedado en desuso (a partir del 17 de octubre de 2016). Use el servicio de informes para obtener información estadística en su lugar.
all_stats	matriz	Para mostrar informes rápidos para todos los intervalos disponibles (hoy, ayer, los últimos 7 días, tiempo de vida), pase all_status=true la cadena de consulta de una GET solicitud. Solo lectura.
first_run	Timestamp	Fecha y hora en que el elemento de línea tuvo su primera impresión, actualizada cada hora. Este valor refleja la zona horaria UTC. Para incluir esta información en una GET respuesta, pase flight_info=true la cadena de consulta. Para obtener más información sobre cómo filtrar los elementos de línea en función de cuándo se han proporcionado por primera vez, consulte Primera ejecución o última ejecución a continuación. Solo lectura.
last_run	Timestamp	Fecha y hora en que el elemento de línea tuvo su última impresión, actualizada cada hora. Este valor refleja la zona horaria UTC. Para incluir esta información en una GET respuesta, pase flight_info=true la cadena de consulta. Para obtener más información sobre cómo filtrar los elementos de línea en función de cuándo se sirvieron por última vez, consulte Primera ejecución o última ejecución a continuación. Solo lectura.
expected_pacing	double	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
total_pacing	double	Obsolescente. Nota: Los stats quickstats y han quedado en desuso (a partir del 17 de octubre de 2016).
has_pacing_dollars	enumeración	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
has_pacing_imps	enumeración	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
imps_pacing_percent	Entero	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
rev_pacing_percent	Entero	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
alerts	objeto	Condiciones que impiden que el elemento de línea sirva. Hay dos tipos de alertas: pausas y advertencias. Las pausas se consideran intencionadas y controladas por el usuario, mientras que las advertencias se consideran involuntarias. Para recuperar elementos de línea basados en pausas, debe pasar determinados parámetros de cadena de consulta en la GET solicitud. Para obtener más información, incluida una lista completa de posibles pausas, consulte Alertas a continuación. Solo lectura.
inventory_type	enumeración	Obsolescente. Tipo de inventario destinado a este elemento de línea. Valores posibles: "real_time", "direct"o "both". "Real-time" incluye todo el inventario de terceros no administrado por la red que se ha habilitado para revender (incluidos los asociados de suministro externos, como Microsoft Advertising Exchange y Google Ad Manager). "Direct" incluye solo el inventario administrado por la red. Nota: Aunque puede seguir usando este campo, los campos dentro supply_strategies del objeto son el mecanismo preferido para designar orígenes de suministro de inventario. Sin embargo, una vez establecido cualquiera de los campos booleanos dentro del objeto trueen supply_strategies , el valor del inventory_type campo se omitirá de forma permanente y no podrá establecerse para ese elemento de línea aumentada. Predeterminado:"real_time"
supply_strategies	objeto	Objeto que contiene varios campos booleanos que se usan para designar los orígenes de suministro de inventario a los que desea dirigirse. Los valores de los campos booleanos de este objeto reemplazan la configuración del inventory_type campo y una vez establecido hará que el inventory_type campo se bloquee e ignore de forma permanente. Para obtener más información, consulte Estrategias de suministro a continuación.
creative_distribution_type	enumeración	Cuando varias creatividades del mismo tamaño se trafican a través de un elemento de línea, la configuración de este campo se usa para determinar la estrategia de rotación creativa que se usará. Valores permitidos: - even: nuestro sistema controla automáticamente la rotación uniforme. Seleccione también esta opción si desea que la rotación creativa se controle en el nivel de divisiones. - weighted: la rotación creativa se basa en un peso proporcionado por el usuario. - ctr-optimized: la creatividad en el cubo de tamaño con el CTR más alto ofrece la mayor cantidad. Predeterminado:null Nota: Si no se pasa un valor específico creative_distribution_type a través de la API (null se pasa el valor ), el valor de creative_distribution_type se establece en even.
prefer_delivery_over_performance	booleano	Este campo se usa para indicar la prioridad del objetivo (si desea dar mayor prioridad a la entrega, el rendimiento o el margen). Las opciones son: - true: esta opción (entrega) prioriza el volumen de impresiones multiplicando las pujas hasta 2 veces en respuesta a la entrega. Al optimizar los clics, también permite que los elementos de línea detecten el inventario con CPC históricos hasta 10 veces el objetivo. Advertencia: Esto puede hacer que el margen y el rendimiento se desprioriticen, lo que puede dar lugar a un margen negativo. - false: seleccione esta opción para realizar una de las siguientes acciones:   - Priorizar el rendimiento (por ejemplo, clics). Esto prioriza el objetivo del anunciante sobre el volumen de impresiones y las ganancias. Si selecciona esta opción, también debe establecer min_margin_pct (en el valuation objeto ) nullen .   - Priorizar margen. Esto reduce las pujas optimizadas por el margen de beneficio deseado. Se puede obtener margen adicional a través del pacing adaptable si el tipo de ingresos es CPM, CPM dinámico, CPM visible o CPC. Si selecciona esta opción, también debe establecer el min_margin_pct campo (en el objeto) en el margen deseado (por ejemplo10, para el valuation 10 %) Predeterminado:false
use_ip_tracking	booleano	Determina si la atribución IP está habilitada o no para un elemento de línea determinado.
viewability_vendor	string	Este campo determina qué proveedor mide la visibilidad de la unidad de anuncio. El único valor que es válido actualmente es "appnexus". Predeterminado:"appnexus"
is_archived	booleano	Solo lectura. Indica si el elemento de línea se ha archivado automáticamente debido a que no se está usando. Una vez establecido en true, el valor no se puede cambiar y las únicas llamadas que se pueden realizar en el objeto de elemento de línea son GET y DELETE. Nota: Si un elemento de línea se archiva automáticamente, su perfil también se archivará y las únicas llamadas que se pueden realizar en cualquiera de esos objetos son GET y DELETE. Además, una vez archivado, es posible que el elemento de línea no esté asociado a ningún pedido de inserción. Predeterminado:false
archived_on	Timestamp	Fecha y hora en que se archivó el elemento de línea (es decir, cuando el is_archived campo se estableció en true). Predeterminado:null Solo lectura.
partner_fees	Matriz	Matriz de tarifas de asociados aplicadas a este elemento de línea. Puede crear o ver tarifas de asociados de terceros con el Servicio de tarifas de asociados. Para obtener más información, consulte Cuotas de asociados a continuación.
line_item_subtype	enumeración	Subtipo del elemento de línea. El line_item_subtype campo no se puede cambiar después de crear el elemento de línea. Para los compradores de Invest, los valores admitidos son los siguientes: - standard_buying: elemento de línea aumentada apto para servir en ofertas administradas, RTB o . La omisión de la line_item_subtype en POST las solicitudes tendrá como valor predeterminado este comportamiento de subtipo. - pg_buying: solo es apto para realizar transacciones en ofertas de PG. Si el subtipo se pasa a los POSTcampos , line_item_type, bid_object_type, delivery_model_typey supply_strategies no son necesarios. - standard_curated: para los artículos de línea de oferta seleccionados. Para obtener más información, consulte line_item_subtype la Guía de configuración de la API de artículos de línea de oferta curada. Predeterminado:standard_buying

Presupuestación/precios

Campo	Tipo	Descripción
lifetime_budget	double	El presupuesto de duración en dólares (costo multimedia). Null corresponde a "unlimited". Advertencia: Si lifetime_budget se establece en null (ilimitado) y los presupuestos de duración de los artículos de línea y del pedido de inserción también se establecen en null, se puede producir un sobrespendido grave. Predeterminado:null
lifetime_budget_imps	Entero	Presupuesto de duración en impresiones. Null corresponde a "unlimited". Predeterminado:null
daily_budget	double	El presupuesto diario en dólares (ingresos). Null corresponde a "unlimited". Predeterminado:null
daily_budget_imps	Entero	El presupuesto diario en impresiones. Null corresponde a "unlimited". Predeterminado:null
learn_budget	double	Obsolescente. Predeterminado:null
learn_budget_imps	Entero	Obsolescente. Predeterminado:null
learn_budget_daily_cap	double	Obsolescente. Predeterminado:null
learn_budget_daily_imps	Entero	Obsolescente. Predeterminado:null
enable_pacing	booleano	Si truees , el gasto presupuestado diario del elemento de línea se distribuye uniformemente a lo largo de cada día. Esto solo es aplicable si daily_budget se establece. Predeterminado:false
lifetime_pacing	booleano	Si truees , el elemento de línea intentará gastar su presupuesto total de duración uniformemente en las fechas de vuelo del elemento de línea. Si truees , no se puede establecer un daily_budget, no se puede establecer enable_pacingfalseen , y primero debe establecer un lifetime_budget, un start_datey un end_date para el elemento de línea. Predeterminado:false
lifetime_pacing_span	Entero	En caso de que se produzca un evento de suspensión, esto indica el número de días en los que se distribuirá la cantidad infraestinada. El valor predeterminado de null indica un valor de tres (3) días. Predeterminado:null
priority	Entero	Para un artículo de línea destinado al inventario administrado (inventory_type es "direct"), ya que ya ha pagado por el inventario, no es necesario introducir una estrategia de compra. Sin embargo, puede establecer la prioridad del elemento de línea para ponderar el elemento de línea con respecto a otros elementos de línea directos dentro de su cuenta. El elemento de línea con la prioridad más alta siempre ganará, incluso si un elemento de línea de prioridad inferior puja más. Predeterminado:5
expected_pacing	double	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
total_pacing	double	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
has_pacing_dollars	enumeración	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
has_pacing_imps	enumeración	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
imps_pacing_percent	Entero	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).
media_cost_pacing_percent	Entero	Obsolescente. Nota: El stats objeto y Quickstats han quedado en desuso (a partir del 17 de octubre de 2016).

Estrategias de suministro

El supply_strategies objeto se usa para designar el origen de suministro al que desea dirigirse al comprar el inventario. Puede establecer como destino cualquier combinación de rtb los campos (Abrir Exchange), managedo deals estableciendo cada uno en true o false. Si tiene como destino una oferta garantizada mediante programación, establezca el programmatic_guaranteed campo true en y los rtbcampos , managedy deals en false. Al menos uno de estos supply_strategies campos de objeto debe establecerse en true.

Nota:

En el caso de las ofertas, además de establecer el deals campo true en dentro de este objeto, también debe asegurarse de proporcionar una lista de ofertas para dirigirse o excluir en la deal_targets matriz y establecer el deal_action_include campo true en o false (en función de la inclusión o exclusión) en el servicio de perfil.

Advertencia

Los valores de los campos booleanos de este objeto reemplazan la configuración del inventory_type campo. Una vez que cualquiera de estos campos se establece true en en una ALI, el inventory_type campo se omitirá y no se podrá establecer para ese elemento de línea. Si intenta realizar una PUT llamada en el valor del inventory_type campo después de que uno o varios de estos campos se hayan establecido en true , se generará el siguiente mensaje de error: "inventory_type cannot be updated once supply_strategies has been set".

Nota:

El servicio DE API de elemento de línea solo admite Roadblocks si supply_strategy es managed.

Campo	Tipo	Descripción
rtb	booleano	Designa si desea dirigirse al inventario en Open Exchange. Esto incluye todo el inventario de terceros no administrado por la red que se ha habilitado para revender (incluidos los asociados de suministro externos, como Microsoft Advertising Exchange y Google Ad Manager).
managed	booleano	Designa si desea dirigirse al inventario administrado. Esto solo incluye el inventario administrado por la red.
deals	booleano	Designa si desea dirigirse al inventario de la oferta. Esto incluye las ofertas en las que es elegible para pujar.
programmatic_guaranteed	booleano	Designa si desea dirigirse a un trato garantizado mediante programación con este elemento de línea. Si se establece en true, los rtbcampos , managedy deals deben establecerse en false.

Intercambio abierto de destino y 2 ofertas, pero no inventario administrado

{code} $ cat LI-supply-strategies.json

{
    "line-item": {
      ...
      "supply_strategies": {
          "managed": false,
          "rtb": true,
          "deals": true
      }
      ...
    }
}
 
$ cat profile-supply-strategies.json 
{
    "profile": {
      "deal_action_include": true,
      "deal_targets": [
          {
              "id": 44,
              "name": "Deal with external supply partner",
              "code": "APN-1234-2200f"
          },
          {
              "id": 45,
              "name": "Deal with Console seller",
              "code": null
          }
      ]
  }
}
{code}

Anunciante

Puede usar el Servicio de anunciantes para crear o ver anunciantes.

Campo	Tipo	Descripción
id	Entero	Identificador único de este anunciante.
name	string	Nombre del anunciante asociado al identificador único anterior.

Etiquetas

Puede usar el servicio de etiquetas de solo lectura para ver todas las etiquetas posibles para artículos de línea, anunciantes, pedidos de inserción y publicadores. Este servicio también permite ver las etiquetas que ya se han aplicado a los objetos.

Campo	Tipo	Descripción
id	Entero	Identificador de la etiqueta. Valores posibles: 7, 8, 11.
name	enumeración	Solo lectura. Nombre de la etiqueta. Valores posibles: "Trafficker" o "Sales Rep".
value	string (100)	Valor asignado a la etiqueta. Por ejemplo, para la "Sales Rep" etiqueta, podría ser un nombre como "Michael Sellers".

Tasas de broker

Las tarifas de broker están en desuso para los artículos de línea aumentadas. Cree tarifas de asociados y aplíquelas al artículo de línea mediante el Servicio de tarifas de asociados.

Cuotas de asociados

Si necesita reservar una parte de su presupuesto para los costos de terceros (costos que se deben a terceros que no sean el publicador), puede definir esta información con el Servicio de tarifas de asociados. Las tarifas se pueden realizar en función de un CPM, un recurso compartido de costos o un recurso compartido de ingresos, y se pueden aplicar a varios anunciantes y artículos de línea, si lo desea. Un solo anunciante o artículo de línea puede tener varias tarifas aplicadas.

La partner fee matriz incluye el campo siguiente:

Campo	Tipo	Descripción
id	Entero	El identificador de una cuota de asociado aplicada a este artículo de línea.

Aplicar una cuota a un artículo de línea

$cat LI-update.json

{
    "line-item": {
        "partner_fees": [
            {"id": 4401
            },
            { "id": 4402
            }
    ]
}

$curl -b cookie -X PUT -d @LI-update.json "https://api.appnexus.com/line-item?id=2345432"

{
    "response": {
        "status" : "OK",
        "id": 2345432
    }
}

Eliminación de una cuota de un artículo de línea

Nota:

No se puede quitar una cuota de un artículo de línea si required la tarifa del asociado es true. Primero debe establecer en requiredfalse y, a continuación, quitar la cuota del artículo de línea.

$curl -b cookie -x GET "https://api.appnexus.com/line-item?id=2345432"

 {
    "line-item": {
        ...,
        "partner_fees": [
            {
                "id": 1
            },
            {"id": 2
            }, 
            {"id": 3
            }
        ],
        ...
    }
}

$cat LI-update.json

{
    "line-item": {
        "partner_fees": [
            {
                "id": 1
            },
            {
                "id": 3
            }, 
    ]
                }
}

$curl -b cookie -X PUT -d @LI-update.json "https://api.appnexus.com/line-item?id=2345432"

{
    "line-item": {
        ...,
        "partner_fees": [
            {
                "id": 1
            },
            {
                "id": 3
            }
        ],
        ...
    }
}

Pixels

Cada objeto de la pixels matriz incluye los campos siguientes:

Campo	Tipo	Descripción
id	Entero	Identificador del píxel de conversión.
state	enumeración	Estado del píxel. Valores posibles: "active" o "inactive".
post_click_revenue	double	Valor de ingresos del clic posterior para el píxel. Este campo solo se puede establecer cuando el campo del elemento de revenue_type línea se ha establecido cpa en (como resultado, este campo no se puede usar con elementos de línea aumentadas).
post_view_revenue	double	Valor de ingresos de la vista posterior para el píxel. Este cab de campo solo se establece cuando el campo del elemento de revenue_type línea se ha establecido cpa en (como resultado, este campo no se puede usar con elementos de línea aumentadas).
name	string	Nombre del píxel de conversión. Solo lectura.
trigger_type	enumeración	Tipo de evento necesario para una conversión con atributos. Valores posibles: "view", "click"o "hybrid". Solo lectura.

Pedidos de inserción

Campo	Tipo	Descripción
id	Entero	Identificador único del orden de inserción. Nota: Una vez que un elemento de línea está asociado a un orden de inserción sin problemas, no se puede asociar a un orden de inserción heredado.
state	enumeración	Estado de este orden de inserción: "active" o "inactive".
code	string	Código personalizado opcional que se usa para identificar este orden de inserción.
name	string	Nombre de este orden de inserción.
advertiser_id	Entero	Identificador único del anunciante asociado a este pedido de inserción.
start_date	date	Fecha de inicio de este pedido de inserción.
end_date	date	Fecha de finalización de este pedido de inserción.
timezone	enumeración	Zona horaria a la que está asociado este orden de inserción. Para obtener una lista de los valores permitidos, consulte Zonas horarias de API.
last_modified	date	Fecha en la que se actualizó por última vez este objeto de orden de inserción.
currency	enumeración	Tipo de moneda asociado a este orden de inserción. Para obtener una lista de las monedas admitidas, consulte Servicio de divisas. Nota: Para obtener los mejores resultados, establezca la moneda en el orden de inserción primario. Para obtener más información, vea Servicio de pedido de inserción.
budget_intervals	matriz de objetos	Metadatos de los intervalos de presupuesto del orden de inserción asociado. Los intervalos de presupuesto permiten adjuntar varios intervalos de fecha a un pedido de inserción, cada uno con los valores presupuestados correspondientes. Para obtener más información, vea Servicio de pedido de inserción.

Valoración

El objeto de valoración se usa para establecer los objetivos de rendimiento de las partidas individuales con el goal_type de "cpc" o "cpa". Contiene el umbral del objetivo de rendimiento, que determina el límite de puja/sin puja en los elementos de línea optimizados y el objetivo de rendimiento, que representa los clics o conversiones deseados.

El valuation objeto contiene los campos siguientes:

Campo	Tipo	Descripción
min_margin_pct	decimal	Establezca solo este campo si se ha establecido en prefer_delivery_over_performancefalse y revenue_type no se ha establecido en cost_plus_margin. Establézcalo en el margen mínimo deseado (por ejemplo, 10 para el 10 %). Esto puede hacer que la entrega y el rendimiento se desprioriticen. Predeterminado:null
goal_threshold	decimal	El umbral del objetivo de rendimiento determina las pujas, la detección de inventario y la comprobación de pujas o no pujas en los artículos de línea optimizados. Aquí se requiere un valor cuando se optimiza a un objetivo de CTR o CPC, o un objetivo de CPA solo para conversiones posteriores al clic. - Si está optimizando una CTR, escriba la tasa de clics deseada (un valor entre 0 y 1). Si está optimizando un objetivo de CPC, escriba el objetivo de CPC. - Si está optimizando un objetivo de CPA solo para conversiones posteriores al clic, escriba el objetivo de CPC (no el objetivo de CPA) y establezca los post_click_goal_task campos y post_click_goal_threshold en la goal_pixels matriz de objetos. Nota: - Si está optimizando un objetivo de CPA con conversiones posteriores al clic y posteriores a la vista, consulte Píxeles de objetivo a continuación para obtener la configuración necesaria. Predeterminado:null
goal_target	decimal	El objetivo de rendimiento es un valor necesario cuando se optimiza a un objetivo de CTR, CPC, objetivo de CPA (solo para conversiones posteriores al clic) o objetivo de CPM visible. - Si está optimizando una CTR, escriba la tasa de clics deseada (un valor entre 0 y 1). - Si está optimizando un objetivo de CPC, escriba su objetivo de CPC. - Si está optimizando un objetivo de CPA solo para conversiones posteriores al clic, escriba el objetivo de CPC (no el objetivo de CPA) y establezca los post_click_goal_target campos y post_click_goal_threshold en la goal_pixels matriz de objetos. - Si está optimizando un CPM visible, establezca este campo en null.
campaign_group_valuation_strategy	enumeración	Determina si un elemento de línea que tiene un objetivo de CPA para conversiones posteriores al clic y a la vista está optimizado para redestinación o prospección. - Se establece "retargeting" en para un elemento de línea de redestinación (un elemento de línea que tiene como objetivo impulsar a los usuarios que ya han mostrado interés en la marca más abajo en un embudo de conversión). El perfil de elemento de línea debe tener como destino al menos un segmento que no esté en el marketplace de datos. Use profile service para configurar la segmentación de destino. - Se establece "prospecting" en para un elemento de línea de prospección (un elemento de línea que tiene como objetivo conducir a nuevos usuarios a un embudo de conversión).
min_avg_cpm	double	Valor por debajo del cual el promedio de CPM puede no caer. Si el max_avg_cpm campo también está establecido, min_avg_cpm actúa como un límite inferior de un intervalo. Debe establecer este campo si establece en revenue_type"vcpm" (CPM dinámico) o "cost_plus_margin". Si establece en revenue_type"cpm", debe establecer este campo en null.
max_avg_cpm	double	Valor por encima del cual es posible que el promedio de CPM no suba. Si también se establece el min_avg_cpm campo, max_avg_cpm actúa como límite superior de un intervalo. Debe establecer este campo si establece revenue_type"vcpm" en o "cost_plus_margin" si establece en revenue_type"cpm", debe establecer este campo en null. Si ha deshabilitado la optimización de Cost Plus (a través del goal_type campo ), debe establecer un CPM plano para Cost Plus. Use este campo para establecer el valor de CPM plano.
min_margin_cpm	double	Valor de margen cuando el tipo de margen es CPM. Nota: Los min_margin_cpm campos y min_margin_pct no se pueden establecer al mismo tiempo. Si se establece uno, el otro debe ser null. Xandr valida los derechos del cliente cuando los clientes usan estos campos. Predeterminado:null
min_margin_pct	double	Valor de margen cuando Tipo de margen es Porcentaje. Nota: Los min_margin_cpm campos y min_margin_pct no se pueden establecer al mismo tiempo. Si se establece uno, el otro debe ser null. Xandr valida los derechos del cliente cuando los clientes usan estos campos. Predeterminado:null

Evento de subasta

Los campos siguientes están incluidos en el auction_event objeto .

Nota:

No proporcione valores para los campos de este objeto que terminan en _code o _id. Proporcione solo valores para los campos del auction_event objeto que terminan en _type . El objeto devolverá los campos que terminan en _code y _id, pero se omitirán en POST las llamadas y PUT .

Campo	Tipo	Descripción
revenue_auction_event_type	string	Este campo se usa junto con la configuración del revenue_type campo. Las opciones son: - "impression": use este valor cuando el tipo de ingreso sea CPM, CPM dinámico o margen de costo más. - "view": use este valor cuando el tipo de ingreso sea CPM visible. Solo se contarán las impresiones visualizables medidas, de acuerdo con la medición de visualización Xandr, mediante la definición de IAB. - "click": use este valor cuando el tipo de ingreso sea CPC. - "video": use este valor cuando el tipo de ingreso sea CPCV.
revenue_auction_event_type_code	string	Este campo se usa junto con la configuración del revenue_type campo. Las opciones son: - "impression": use este valor cuando el tipo de ingreso sea CPM, CPM dinámico o margen de costo más. - "view_display_50pv1s_an": use este valor cuando el tipo de ingreso sea CPM visible. - "click": use este valor cuando el tipo de ingreso sea CPC. - "video_completion": use este valor cuando el tipo de ingreso sea CPCV.
revenue_auction_type_id	Entero	Este campo se usa junto con la configuración del revenue_type campo. Las opciones son: - 1: use este valor cuando el tipo de ingreso sea CPM, CPM dinámico o margen de costo más. - 2: use este valor cuando el tipo de ingreso sea CPM visible. - 3: use este valor cuando el tipo de ingreso sea CPC. - 10: use este valor cuando el tipo de ingreso sea CPCV.
kpi_auction_event_type	string	Este campo se usa junto con la configuración del goal_type campo. Las opciones son: - "impression": use este valor cuando opte por la optimización en CPC, CPA, CTR o no use la optimización. - "view": use este valor cuando esté optimizando un CPM visible. - "click": use este valor cuando el tipo de ingreso sea CPC. - "video": use este valor cuando esté optimizando cpcv o VCR.
kpi_auction_event_type_code	string	Este campo se usa junto con la configuración del campo goal_type. Las opciones son: - "impression": use este valor cuando opte por la optimización en CPC, CPA, CTR o no use la optimización. - "view_display_50pv1s_an": use este valor cuando esté optimizando un CPM visible. - "video_completion": use este valor cuando esté optimizando cpcv o VCR.
kpi_auction_type_id	Entero	Este campo se usa junto con la configuración del campo goal_type. Las opciones son: - 1: use este valor cuando esté optimizando el CPC, CPA, CTR o no use la optimización. - 2: use este valor cuando esté optimizando un CPM visible. - 10: use este valor cuando el tipo de ingreso sea CPCV o VCR.
kpi_value	double	Este campo se usa junto con la configuración del goal_type campo. Establézcalo en una de las siguientes opciones: - null: si está optimizando el CPC, CPA, CTR o no usa la optimización. - your goal: si está optimizando el objetivo de CPM visible (por ejemplo, 5)., CPCV o VCR. Los objetivos de VCR deben estar entre 0 y 1.
kpi_value_type	string	Este campo se usa junto con la configuración del kpi_code campo. Establézcalo en una de las siguientes opciones: - none: si está optimizando el CPC, CPA, CTR o no usa la optimización. - goal_value: si está optimizando un objetivo basado en costos no cubierto anteriormente (CPCV). - rate_threshold: si está optimizando un objetivo basado en la tasa no cubierto anteriormente (VCR).
payment_auction_event_type	string	Este campo solo es relevante si se ha establecido inventory_type"real_time" en (RTB) o si se ha establecido el campo rtb del supply_strategies objeto trueen . Las opciones son: - "impression": si desea pagar por impresión. - "view": si desea pagar por vista. Esta opción solo se permite cuando se ha establecido el revenue_type campo para usar CPM visible o Cost Plus (y la optimización deshabilitada). - "click": use este valor cuando el tipo de ingreso sea CPC. - "video": si desea pagar por vídeo completado.
payment_auction_event_type_code	string	Este campo solo es relevante si se ha establecido inventory_type"real_time" en (RTB) o si se ha establecido el campo rtb del supply_strategies objeto trueen . Las opciones son: - "impression": si desea pagar por impresión. - "view_display_50pv1s_an": si desea pagar por vista. Esta opción solo se permite cuando se ha establecido el revenue_type campo para usar CPM visible o Cost Plus (y la optimización deshabilitada). - "video_completion": si desea pagar por vídeo completado.
payment_auction_type_id	Entero	Este campo solo es relevante si se ha establecido inventory_type"real_time" en (RTB) o si se ha establecido el campo rtb del supply_strategies objeto trueen . Las opciones son: - 1: si desea pagar por impresión. - 2: si desea pagar por vista. Esta opción solo se permite cuando se ha establecido el revenue_type campo para usar CPM visible o Cost Plus (y la optimización deshabilitada). - 10: si desea pagar por vídeo completado.

Configuración de programación presupuestaria

Los campos siguientes están incluidos en el budget_scheduling_settings objeto .

Campo	Tipo (longitud)	Descripción
underspend_catchup_type	enumeración	Determina cómo el sistema de Xandr se ocupa de un presupuesto diario no entregado. Use el "evenly" valor si desea que las partes no gastadas de su presupuesto se gasten uniformemente durante el resto del vuelo, o "ASAP" si desea que el presupuesto no gastado se gaste lo antes posible. Valores posibles: "evenly" o "ASAP".

Medición demográfica

El in_demo_measurement objeto permite la medición demográfica y sus especificaciones pertinentes para el elemento de línea. El in_demo_measurement objeto forma parte de la característica Nielsen Digital Ad Ratings (DAR), que cuesta 0,25 USD por uso.

Nota:

Para usar la medición demográfica para tv conectada (CTV), el elemento de línea debe tener una configuración de destino que se dirija exclusivamente a los Estados Unidos.

Ejemplo del in_demo_measurement objeto dentro de una respuesta JSON

"in_demo_measurement": {
    "campaign_group_id": 12795878,
    "provider": "nielsen-dar",
    "status": "active",
    "pixel": null,
    "attributes": [{
            "key": "on_target_goal_pct",
            "value": "50"
        },
        {
            "key": "target_gender",
            "value": "all"
        },
        {
            "key": "target_age_lower",
            "value": "13"
        },
        {
            "key": "target_age_upper",
            "value": "99"
        }
    ]
},
...

Campo	Tipo (longitud)	Descripción
campaign_group_id	Entero	Este campo se usa para asociar el in_demo_measurement objeto a este elemento de línea. El valor de este campo es el identificador del elemento de línea. Solo lectura.
provider	string	Este campo indica qué proveedor de terceros proporciona el servicio de medición demográfica. Actualmente, el único valor posible para este campo es "nielsen-dar". Necesario.
status	booleano	Este campo indica si el elemento seleccionado provider ha confirmado y iniciado la medición demográfica para el elemento de línea. Para activar la medición demográfica, establezca este campo en "active". Un proveedor de medida de terceros puede tardar hasta 24 horas en comenzar a realizar un seguimiento de las impresiones del elemento de línea, durante el cual el valor de este campo se establece en "active-pending". Posibles valores: - "active": se ha activado la medición para este elemento de línea y Xandr ha recibido una confirmación de la API de un proveedor de medidas de terceros. Se están midiendo las impresiones. - "active-pending": se ha activado la medición para este elemento de línea, pero las impresiones no se miden cuando el elemento de línea espera la confirmación de la API de un proveedor de medida de terceros. - "inactive": la medida no está habilitada actualmente para este elemento de línea. - "inactive-pending": este valor es similar a "inactive", pero indica que la API del proveedor de medidas de terceros seleccionado aún no ha procesado la solicitud de desactivación del elemento de línea. Una vez que el proveedor de medidas de terceros ha confirmado la desactivación de medidas del elemento de línea, este valor cambia a "inactive". Necesario.
pixel	matriz de objetos	El valor predeterminado de este campo es null. Solo lectura.
attributes	matriz de objetos	La attributes matriz de objetos se compone de cuatro objetos clave-valor que contienen valores para especificar con qué demografía mide el rendimiento de destino del elemento de línea. Para obtener más información sobre la attributes matriz de objetos clave-valor, vea la tabla Atributos demográficos a continuación. Necesario.

Objetos attributes

"attributes":[
{
"key":"on_target_goal_pct",
"value":"50"
},
{
"key":"target_gender",
"value":"all"
},
{
"key":"target_age_lower",
"value":"13"
},
{
"key":"target_age_upper",
"value":"99"
}
]

Atributos demográficos

Clave	Tipo (longitud)	Descripción
on_target_goal_pct	double	Indica la frecuencia con la que desea que el elemento de línea se entregue a la demografía especificada (dicha especificación se realiza insertando valores para las claves siguientes). Este porcentaje de objetivo de referencia se usa en los informes y no afecta al rendimiento de los elementos de línea. Valores posibles: 1 a 100.
target_gender	string	Especifica el género de la demografía a la que intenta dirigirse. Valores posibles: "all", "male"o "female".
target_age_lower	Entero	Especifica el umbral de edad del intervalo de edad demográfica al que intenta dirigirse. Valores posibles: 13, 18, 21, 25, 30, 35, 40, , 45, 50, 55, 60o 65.
target_age_upper	Entero	Especifica el límite de edad para el intervalo de edad demográfica al que intenta dirigirse. Valores posibles: 17, 20, 24, 29, , 3934, 44, , 49, 54, 59, , 64o 99 (que representa las edades65+).

Atribución sin conexión

El offline_attribution objeto habilita la atribución de ventas sin conexión para el elemento de línea. La atribución de ventas sin conexión es una característica beta proporcionada por Nielsen Catalina Solutions (NCS), por lo que tendrá que obtener acceso de prueba beta a esta característica antes de usarla. Para obtener acceso, póngase en contacto con el representante de su cuenta de Xandr.

Nota:

Para usar la atribución de ventas sin conexión, el elemento de línea debe tener una configuración de destino que se dirija exclusivamente a Estados Unidos.

Ejemplo del offline_attribution objeto dentro de una solicitud JSON PUT

$ cat line-item.json

{
    "line-item": {
        "id": 1,
        ...
        "offline_attribution": {
            "product_group_id": 123,
            "report_level_type": "line_item",
            "frequency_type": "weekly",
            "lookback_type": "flight_lifetime"
        }
    }
}

$ curl -b cookies -c cookies -X PUT -d @line-item.json "https://api.appnexus.com/line-item?id=ID_INTEGER&advertiser_id=ID_INTEGER"

Ejemplo del offline_attribution objeto dentro de una respuesta JSON

{
    "line-item": {
        "id": 1,
        ...
        "offline_attribution": {
            "product_group_id": 123,
            "product_group": {
                "provider_member_name": "ncs",
                "category_name": "CATEGORY NAME",
                "brand_name": "BRAND NAME",
                "product_high_name": "PRODUCT HIGH NAME",
                "product_low_name": "PRODUCT LOW NAME",
            }
            "report_level_type": "line_item",
            "frequency_type": "weekly",
            "lookback_type": "flight_lifetime"
        }
    }
}
...

Ejemplo del offline_attribution objeto que se elimina dentro de una solicitud JSON PUT

$ cat line-item.json

{
    "line-item": {
        "id": 1,
        ...
        "offline_attribution": null
    }
}

$ curl -b cookies -c cookies -X PUT -d @line-item.json "https://api.appnexus.com/line-item?id=ID_INTEGER&advertiser_id=ID_INTEGER"

Campo	Tipo	Descripción
product_group_id	Entero	Entrada del grupo de productos sobre la que se va a informar. Puede encontrar un identificador de grupo de productos mediante el servicio de grupo de productos de atribución sin conexión. Necesario.
offline_attribution_product_group	objeto	Objeto que devuelve información sobre el grupo de productos en el que se realiza el seguimiento (en función de la product_group_id selección), como su - provider_member_name - category_name - brand_name - product_high_name - product_low_name Solo lectura.
report_level_type	string	Para qué desea mostrar los datos de atribución de ventas en los informes generados. Valores potenciales: - "line_item" - "split" Necesario.
frequency_type	string	Pertenece a cuándo comenzará a recibir informes de datos de atribución de ventas sin conexión para el elemento de línea y la frecuencia con la que se realizarán nuevos informes. Valores potenciales: - "weekly" - "per_flight" Necesario.
lookback_type	string	Pertenece a la cantidad de datos de elementos de línea que se muestran en cada informe generado (este campo también se basa en la frequency_type selección). Valores potenciales: - "flight_lifetime" - "last_week" Necesario.

Creativos

Cada objeto de la creatives matriz incluye los campos siguientes. Para obtener información sobre "id" o "code" campos, puede usar el Servicio Creativo.

Campo	Tipo (longitud)	Descripción
is_expired	booleano	Si truees , la creatividad ha expirado. Si falsees , la creatividad está activa. Solo lectura.
is_prohibited	booleano	Si truees , la creatividad entra en una categoría prohibida en la plataforma Xandr. Solo lectura.
width	Entero	Ancho de la creatividad. Solo lectura.
audit_status	enumeración	Estado de auditoría de la creatividad. Valores posibles: "no_audit", "pending", "rejected", "audited"o "unauditable". Solo lectura.
name	string	Nombre de la creatividad. Solo lectura.
pop_window_maximize	booleano	Si truees , la etiqueta del publicador maximizará la ventana. Solo es relevante para creativos con formato "url-html" y "url-js". Si pop_window_maximize se establece en true, no se debe establecer ni height en width la creatividad. Solo lectura.
height	Entero	El alto de la creatividad. Solo lectura.
state	enumeración	El estado de la creatividad. Valores posibles: "active" o "inactive". Solo lectura.
format	enumeración	Formato del archivo creativo. Valores posibles: "url-html", "url-js", "flash", "image", "raw-js", "raw-html", o "iframe-html""text". Solo lectura.
is_self_audited	booleano	Si truees , la creatividad se audita por sí misma. Solo lectura.
id	Entero	Identificador de la creatividad. code O id es necesario al actualizar la asociación creativa.
code	string	Código personalizado para la creatividad. code O id es necesario al actualizar la asociación creativa.
weight	Entero	Peso proporcionado por el usuario que determina la estrategia de rotación creativa para las creatividades del mismo tamaño administradas en el nivel de elemento de línea. Para usar este campo, el valor de creative_distribution_type debe ser "weighted". Valor permitido: un entero mayor 0 que y menor o igual que 1000.
ad_type	string	Tipo de anuncio creativo. Valores posibles: "banner", "video", "native", "audio". Nota: Todas las creatividades asociadas a un elemento de línea deben tener el mismo tipo de anuncio, que debe coincidir con el ad_types seleccionado para el elemento de línea. Solo lectura.
all_budget_intervals	booleano	Indica si la creatividad servirá durante todos los intervalos presupuestarios, incluidos todos los intervalos presupuestarios futuros. Los posibles valores son: - True (valor predeterminado) - False Si truees , custom_date_ranges en la creatives matriz y creatives en la budget_intervals matriz debe establecerse nullen . Por el contrario, si desea usar intervalos de fechas personalizados o creatividades, all_budget_intervals debe establecerse en false.
custom_date_ranges	matriz de objetos	Los intervalos de fechas establecen los períodos en los que la creatividad servirá. Si se especifica: all_budget_intervals debe establecerse en false. Para obtener más información, vea Intervalos de fechas personalizados a continuación.

Intervalos de fechas personalizados

La custom_date_ranges matriz establece los intervalos de fechas durante los cuales una creatividad servirá.

Las fechas deben tener el formato YYYY-MM-DD hh:mm:ss.

Todos los intervalos de fechas deben cumplir las siguientes especificaciones:

• No pueden incluir ninguna fecha antes del inicio o después del final de los intervalos de presupuesto definidos para esta línea de pedido.
• Los intervalos de fechas deben tener al menos una hora de duración.
• Las fechas de finalización no pueden ser posteriores a 2038-01-19 00:00:00.

Campo	Tipo (longitud)	Descripción
start_date	Timestamp	Fecha de inicio del intervalo de fechas personalizado. El formato debe ser YYYY-MM-DD hh:mm:ss (hh:mm:ss debe ser hh:00:00).
end_date	Timestamp	Fecha de finalización del intervalo presupuestado. El formato debe ser YYYY-MM-DD hh:mm:ss (hh:mm:ss debe establecerse en hh:59:59).

Programar una creatividad para servir durante un intervalo de presupuesto personalizado

$cat line-item-with-custom-budget-intervals
{
    line_item: {
        budget_intervals: [
            {
                start_date: 1/1/2020,
                end_date: 2/1/2020,
                lifetime_budget: 1000,
                id: 7777,                                  
                creatives: [12345]                          
            },
            {
                start_date: 2/1/2020,
                end_date: 3/1/2020,
                lifetime_budget: 2000,
                id: 8888,                                  
                creatives: null
            }
        ],
        creatives: [
            {
                id: 12345,
                weight: 1,
                all_budget_intervals: false,                
                custom_date_ranges: [
                    {                                      
                        start_date: 2/5/2020 00:00:00,      
                        end_date: 2/10/2020 00:00:00                     
                    }
                ]
            },
            {
                id: 56789,
                weight: 2,
                all_budget_intervals: true,                 
                custom_date_ranges: null                                                   
            }
        ],
        creative_distribution_type: weighted
    }
}

Intervalos de presupuesto

Los intervalos presupuestados de un elemento de línea aumentada deben estar dentro de los intervalos presupuestados definidos en los pedidos de inserción primarios del elemento de línea. Los intervalos presupuestados de las partidas individuales deben tener presupuestos distintos de los de los pedidos de inserción primarios. Estas funciones funcionan como "subs budgets" específicos del elemento de línea del presupuesto en el intervalo de presupuesto de pedido de inserción correspondiente.

Al crear un nuevo elemento de línea aumentada, asegúrese de que y start_dateend_date de cada uno de sus budget_intervals objetos de matriz se encuentren dentro de uno de los intervalos presupuestados definidos en el orden de inserción primario (los pedidos de inserción están asociados a elementos de línea a través de la insertion_orders matriz en el servicio de elementos de línea).

Nota:

( parent_interval_id en la budget_intervals matriz) ha quedado en desuso y se omitirá su valor.

Tenga en cuenta también lo siguiente al usar la budget_interval matriz:

• Los intervalos de presupuesto del mismo elemento de línea no se pueden superponer.
• Los intervalos presupuestados en el elemento de línea pueden tener presupuestos de duración ilimitada (es decir, si todos los campos de presupuesto se dejan establecidos en null).
• Los intervalos de presupuesto no se pueden usar si se establecen los campos de presupuesto en el nivel superior del line_item objeto (como se describe en la sección General de esta página).
• Si va a aumentar el presupuesto para el intervalo presupuestado del elemento de línea, primero debe aumentar el presupuesto para el intervalo presupuestado en el orden de inserción primario (de lo contrario, es posible que no tenga presupuesto suficiente). Para obtener más información, vea Servicio de pedido de inserción.
• Para que la optimización funcione mejor, los intervalos de presupuesto deben tener una duración de al menos 4 horas.

Nota:

• Si el campo del orden de inserción primario del elemento de budget_type línea está establecido en impression :

  • Los lifetime_budget campos y daily_budget de esta matriz deben establecerse en null.
  • Use el campo o daily_budget_imps de esta matriz para establecer el lifetime_budget_imps presupuesto del elemento de línea.

• Si el campo del orden de inserción primario del elemento de budget_type línea está establecido en revenue :

  • Los lifetime_budget_imps campos y daily_budget_imps de esta matriz deben establecerse en null.
  • Use el campo o daily_budget de esta matriz para establecer el lifetime_budget presupuesto del elemento de línea.

Cada objeto de la budget_intervals matriz contiene los campos siguientes.

Campo	Tipo (longitud)	Descripción
id	Entero	Identificador del intervalo presupuestado.
start_date	Timestamp	Fecha de inicio del intervalo presupuestado. El formato debe ser YYYY-MM-DD hh:mm:ss (hh:mm:ss debe ser hh:00:00).
end_date	Timestamp	Fecha de finalización del intervalo presupuestado. El formato debe ser YYYY-MM-DD hh:mm:ss (hh:mm:ss debe establecerse en hh:59:59). Para que la optimización funcione mejor, los intervalos de presupuesto deben tener una duración de al menos 4 horas. Si este campo se establece nullen , el intervalo presupuestado del elemento de línea se ejecutará indefinidamente. Si establece este campo en 'null': - Puede que no haya más de un objeto en la budget_intervals matriz (es decir, un intervalo de presupuesto máximo de 1). - El lifetime_pacing campo debe establecerse "false"en . "lifetime_budget"- Debe establecerse en null y el "daily_budget" campo debe establecerse en un valor distinto de null o distinto de 0.
timezone	string	Zona horaria por la que se cuenta el presupuesto y el gasto. Para obtener una lista de valores de zona horaria aceptables, consulte Zonas horarias de API.
parent_interval_id	Entero	Obsoleto. Se omitirá el valor de este campo. En su lugar, use los start_date campos y end_date de esta matriz para definir cuándo se debe ejecutar el elemento de línea.
lifetime_budget	double	Presupuesto de duración en ingresos para el intervalo presupuestado. El campo del objeto define la currency moneda de insertion_order ingresos. Nota: Si también establece el lifetime_budget_imps campo en esta matriz, el presupuesto que se agote primero hará que se detenga el gasto. El procedimiento recomendado consiste en establecer solo uno de estos campos.
lifetime_budget_imps	double	Presupuesto de duración en impresiones para el intervalo presupuestado. Nota: Si agrega elementos de línea a este orden de inserción, cualquier gasto ya asociado a esos elementos de línea antes de que se agreguen al orden de inserción NO se cuenta con respecto al presupuesto de duración del pedido de inserción. Solo se cuenta el gasto que se produce mientras el elemento de línea es un elemento secundario del orden de inserción. Nota: Si también establece el lifetime_budget campo en esta matriz, el presupuesto que se agote primero hará que se detenga el gasto. El procedimiento recomendado consiste en establecer solo uno de estos campos.
lifetime_pacing	booleano	Si truees , el elemento de línea intentará mantener el ritmo del presupuesto de duración uniformemente durante el intervalo presupuestado. Si truees , debe establecer lifetime_budget o lifetime_budget_imps.
daily_budget	double	Presupuesto diario en ingresos para el intervalo presupuestado. El campo del objeto define la currency moneda de insertion_order ingresos. Nota: Si agrega elementos de línea a este orden de inserción, las impresiones asociadas a esos elementos de línea cuando se agregan al orden de inserción NO se cuentan en el presupuesto de duración del pedido de inserción. Solo se cuentan las impresiones que se producen mientras el elemento de línea es un elemento secundario del orden de inserción. Nota: Si también establece el daily_budget_imps campo, el presupuesto que se agote primero hará que se detenga el gasto. El procedimiento recomendado consiste en establecer solo uno de estos campos.
daily_budget_imps	double	El presupuesto diario en impresiones. Nota: Si el campo del pedido de budget_type inserción primario se ha establecido en "impression"y el campo de elementos revenue_type de línea se ha establecido en CPM visualizable, solo las impresiones visibles cuentan con los presupuestos de pedido de inserción y de artículo de línea. Si también establece el daily_budget campo, el presupuesto que se agote primero hará que se detenga el gasto. El procedimiento recomendado consiste en establecer solo uno de estos campos.
enable_pacing	booleano	Si truees , los gastos se recorrerán a lo largo del día. Solo se aplica si hay un objeto daily_budget.
creatives	matriz	Especifica las creatividades asociadas a este intervalo presupuestado. Para servir, las creatividades también deben especificarse en el campo de elemento de línea creatives y all_budget_intervals deben ser false.

Eliminación de un intervalo de presupuesto

Nota:

Puede quitar los intervalos presupuestados de una línea de pedido aumentada. Sin embargo, si desea quitar un intervalo presupuestado del orden de inserción primario, primero debe quitar los intervalos presupuestados (que se encuentran dentro del intervalo presupuestado del pedido de inserción primario) de todos los elementos de línea aumentadas asociados al orden de inserción. Solo entonces puede quitar el intervalo presupuestado del orden de inserción. Para obtener más información, vea Servicio de pedido de inserción.

$ cat delete-budget-interval
{
  "line-item": {
    "budget_intervals": [
      {
        "id": 79970,
        "start_date": null,
        "end_date": null
      }
    ]
  }
}

Creación de un subluz

$ cat create-subflight

{
  "line-item": {
    ...,
    "budget_intervals": [
      {
        "id": 342856,
        "lifetime_pacing_percent": 150,
        "lifetime_budget": 10000,
        "lifetime_budget_imps": null,
        "start_date": "2022-04-01 00:00:00",
        "end_date": "2022-04-30 11:59:59",
        ...,
        "subflights": [
          {
            "id": 1, // ID generated on LI creation or update
            "name": "spend 200 every weekend for entire flight",
            "is_recurring": true,
            "use_flight_date_range": true,
            "recurring_day_of_week": [0,1,6],
            "start_date": null,
            "end_date": null,
            "daily_budget": 80,
            "daily_budget_imps": null,
            "subflight_pacing_percent": null,
          }
        ]
      }
    ],
    ...
  }
}

Eliminación de un subluz

$ cat delete-subflight

{
  "line-item": {
    ...,
    "budget_intervals": [
      {
        "id": 342856,
        "subflights": [
          {
            "id": 1,
            "use_flight_date_range": false,
            "start_date": null,
            "end_date": null,
          }
        ]
      }
    ],
    ...
  }
}

Campo	Tipo (longitud)	Descripción
id	Entero	Id. de subluz generado al crear un nuevo subluz. Solo lectura.
name	string	Nombre dado al subluz. Necesario.
is_recurring	booleano	Determina si el subluz va a ser recurrente. Tener un subligero periódico significa que puede seleccionar determinados días de la semana para los que su subluz surtirá efecto, mientras que un subluz estándar funciona constantemente bajo sus fechas de inicio y finalización. Valores posibles: - true: subluz recurrente. - false: (valor predeterminado) Subluz estándar. Necesario.
recurring_day_of_week	matriz de enteros	Determina qué días de la semana surtirá efecto el subluz recurrente. Seleccione un solo día o hasta seis días consecutivos. Valores posibles: - 0 (Domingo) - 1 (Lunes) - 2 (Martes) - 3 (Miércoles) - 4 (Jueves) - 5 (Viernes) - 6 (Sábado) Ejemplo de sábado a lunes:"recurring_day_of_week": [0, 1, 6]. Obligatorio siis_recurringtruees igual.
use_flight_date_range	booleano	Determina si el subligero usa el intervalo de fechas de su vuelo primario o su propio intervalo de fechas, según lo determinado por las selecciones y end_date del start_date subligero. Valores posibles: - true: el subluz usará el intervalo de fechas de su vuelo primario. - false: el subluz usará su propia fecha de inicio y finalización. Nota: Si establece en is_recurring , también debe establecer en use_flight_date_rangefalse.false Necesario.
start_date	date (aaaa-mm-dd)	La fecha de inicio del subluz (en relación con la zona horaria designada del elemento de línea). La selección de la fecha de inicio debe coincidir o iniciarse más tarde que la fecha de inicio seleccionada para el intervalo presupuestado del subluz. Nota: Si use_flight_date_range se establece en true, el valor de este campo debe establecerse en null. Obligatorio siis_recurringfalsees igual.
end_date	date (aaaa-mm-dd)	Fecha de finalización del subluz (en relación con la zona horaria designada del elemento de línea). La selección de la fecha de finalización debe coincidir o finalizar antes de la fecha de finalización seleccionada para el intervalo presupuestado de la subluz. Nota: Si use_flight_date_range se establece en true, el valor de este campo debe establecerse en null . Obligatorio siis_recurringfalsees igual.
daily_budget	Entero	Determina cuánto dinero quieres que tu subluz pueda gastar diariamente. Para realizar una selección para este campo, debe establecer la selección de campo del lifetime_pacing_percent vuelo primario en null. Nota: Si el elemento de línea no depende de la utilización de subluces con presupuestos diarios, la configuración de puesta al día de la suspensión surtirá efecto en la siguiente fecha que no sea de subluz. Obligatorio sidaily_budgetno se proporciona para el vuelo primario.
daily_budget_imps	double	El número diario de impresiones que el subluz puede ganar. Nota: Si el elemento de línea no depende de la utilización de subluces con presupuestos diarios, la configuración de puesta al día de la suspensión surtirá efecto en la siguiente fecha que no sea de subluz. Obligatorio si: - El vuelodaily_budget primarioIgualestruey el subluzdaily_budgetnulles igual. - El vuelolifetime_pacing_percent primarionulles igual.
subflight_pacing_percent	double	Determina la distribución uniforme del presupuesto del subligero entre su fecha de inicio y finalización. Si se establece en 100, el ritmo presupuestado del subligero no se modifica y se distribuye a lo largo de todos los días aplicables para el subligero, con importes presupuestados aproximadamente similares que se gastan diariamente. Si se establece más alto que 100, el subluz pasa más por día al principio de su intervalo de fechas y menos al final. El inverso se produce si el ritmo es menor que 100. Valores posibles:50-150 Obligatorio sidaily_budgetno se proporciona.

Píxeles objetivo

La goal_pixels matriz de objetos se usa al trabajar con goal_type"cpa" y contiene información sobre los objetivos de rendimiento y los umbrales. Cada objeto de la goal_pixels matriz de objetos incluye los campos siguientes:

Campo	Tipo	Descripción
id	Entero	Identificador del píxel de conversión.
state	enumeración	Estado del píxel. Valores posibles: "active" o "inactive".
post_click_goal	double	Obsoleto. Use post_click_goal_target y post_click_goal_threshold en su lugar.
post_view_goal	double	Obsoleto. Use post_view_goal_target y post_view_goal_threshold en su lugar.
trigger_type	enumeración	Tipo de evento necesario para una conversión con atributos. Valores posibles: "view", "click"o "hybrid". Solo lectura.
post_click_goal_target	double	Valor objetivo del anunciante para las conversiones posteriores al clic para el píxel. Si desea establecer un objetivo de CPA y optimizarlo solo para conversiones posteriores al clic, establezca este campo en el valor del objetivo de CPA.
post_view_goal_target	double	Valor objetivo del anunciante para las conversiones posteriores a la vista del píxel (comparable a goal_value para goal_type"cpc"). Si desea establecer un objetivo de CPA y optimizar solo para las conversiones posteriores a la vista, asegúrese de que este campo está establecido en null.
post_click_goal_threshold	double	Umbral de objetivo del anunciante para las conversiones posteriores al clic para el píxel. Esto determina el límite de puja o sin puja en los artículos de línea optimizados. Si desea establecer un objetivo de CPA y optimizarlo en conversiones posteriores al clic y posteriores a la vista, este campo debe contener el mismo valor que post_view_goal_threshold.
post_view_goal_threshold	double	Umbral de objetivo del anunciante para las conversiones posteriores a la vista para el píxel. Esto determina el límite de puja o sin puja en los artículos de línea optimizados. Si desea establecer un objetivo de CPA y optimizarlo en conversiones posteriores al clic y posteriores a la vista, este campo debe contener el mismo valor que post_click_goal_threshold.

Estadísticas

Nota:

El stats objeto ha quedado en desuso (a partir del 17 de octubre de 2016). Use el servicio de informes para obtener información estadística en su lugar.

Primera ejecución/última ejecución

Para incluir los first_run campos y last_run en una GET respuesta, pase flight_info=true la cadena de consulta. También puede filtrar los elementos de línea en función de cuándo se atienden por primera y última vez, como se indica a continuación:

Recuperar solo los elementos de línea que nunca han servido

Pase never_run=true la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/line-item?advertiser_id=100&flight_info=true&never_run=true'

Nota:

Puede usar never_run=true en combinación con otros filtros, pero tenga en cuenta que siempre será una relación OR. Por ejemplo, si pasa tanto never_run=true como min_first_run=2012-01-01 00:00:00 en la cadena de consulta, buscará elementos de línea que nunca hayan servido elementos de línea OR que se hayan servido por primera vez en o después de 2012-01-01.

Recuperar solo los elementos de línea que se sirvieron por primera vez en o después de una fecha específica

Pase min_first_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/line-item?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00'

Recuperar solo los elementos de línea que se sirvieron por primera vez en o antes de una fecha específica

Pase max_first_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/line-item?advertiser_id=100&flight_info=true&max_first_run=2012-08-01 00:00:00'

Recuperar solo los elementos de línea que se sirvieron por primera vez dentro de un intervalo de fechas específico

Pase min_first_run=YYYY-MM-DD HH:MM:SS&max_first_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/line-item?advertiser_id=100&flight_info=true&min_first_run=2012-01-01 00:00:00&max_first_run=2012-08-01 00:00:00'

Recuperar solo los elementos de línea que se sirvieron por última vez en o después de una fecha específica

Pase min_last_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/line-item?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00'

Recuperar solo los elementos de línea que se sirvieron por última vez en o antes de una fecha específica

Pase max_last_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/line-item?advertiser_id=100&flight_info=true&max_last_run=2012-08-01 00:00:00'

Recuperar solo los elementos de línea que se sirvieron por última vez dentro de un intervalo de fechas específico

Pase min_last_run=YYYY-MM-DD HH:MM:SS&max_last_run=YYYY-MM-DD HH:MM:SS la cadena de consulta.

curl -b cookies -c cookies 'https://api.appnexus.com/line-item?advertiser_id=100&flight_info=true&min_last_run=2012-01-01 00:00:00&max_last_run=2012-08-01 00:00:00'

Los campos de la fecha de tipo también se pueden filtrar por nmin y nmax . El nmin filtro le permite encontrar fechas que son null o posteriores a la fecha especificada, y el nmax filtro le permite encontrar fechas que son null o antes de la fecha especificada.

Alertas

Este campo le notifica las condiciones que impiden que el elemento de línea sirva. Hay dos tipos de alertas: pausas y advertencias. Las pausas se consideran intencionadas y controladas por el usuario, mientras que las advertencias se consideran involuntarias.

Para recuperar elementos de línea basados en pausas, debe pasar determinados parámetros de cadena de consulta en la GET solicitud. Consulte a continuación los casos de uso con parámetros y ejemplos de cadena de consulta.

Nota:

Puede usar estos parámetros de cadena de consulta al recuperar todos los elementos de línea o elementos de línea específicos, pero los ejemplos siguientes solo cubren la recuperación de todos los elementos de línea, ya que es donde esta característica ofrece más valor.

Recuperar todos los elementos de línea y mostrar alertas

Pase show_alerts=true la cadena de consulta. Este parámetro agregará el alerts objeto a cada elemento de línea de la respuesta, independientemente de si el elemento de línea tiene pausas.

Nota:

Para cada uno de los casos de uso siguientes, debe pasar show_alerts=true si desea que el alerts objeto aparezca en la respuesta.

$ curl -b cookies -c cookies 'https://api.appnexus.com/line-item?show_alerts=true'

{
    "response": {
        "status": "OK",
        "line-items": [

            {
                "id": 45047,
                "code": null,
                "name": "Line Item 1",
                "advertiser_id": 35081,
                "state": "active",
                "start_date": "2012-04-01 00:00:00",
                "end_date": "2012-05-01 00:00:00",
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 4,
                            "message": "Flight end date is in the past."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 45048,
                "code": null,
                "name": "Line Item 2",
                "advertiser_id": 35081,
                "state": "inactive",
                "start_date": "2012-05-21 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 1,
                            "message": "State is set to inactive."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 46308,
                "code": null,
                "name": "Test Line Item",
                "advertiser_id": 45278,
                "state": "inactive",
                "start_date": "2012-06-06 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 1,
                            "message": "State is set to inactive."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            ...
        ],
        ...
        }
    }
}

Recuperar solo elementos de línea que tengan al menos una pausa

Pase show_alerts=true&pauses=true la cadena de consulta.

$ curl -b cookies -c cookies 'https://api.appnexus.com/line-item?show_alerts=true&pauses=true'

{
    "response": {
        "status": "OK",
        "line-items": [
            {
                "id": 45047,
                "code": null,
                "name": "Line Item 1",
                "advertiser_id": 35081,
                "state": "active",
                "start_date": "2012-04-01 00:00:00",
                "end_date": "2012-05-01 00:00:00",
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 4,
                            "message": "Flight end date is in the past."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 45048,
                "code": null,
                "name": "Line Item 2",
                "advertiser_id": 35081,
                "state": "inactive",
                "start_date": "2012-05-21 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 1,
                            "message": "State is set to inactive."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 46308,
                "code": null,
                "name": "Line Item 6",
                "advertiser_id": 45278,
                "state": "inactive",
                "start_date": "2012-06-06 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 1,
                            "message": "State is set to inactive."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            ...
        ],
        ...
        }
    }
}

Recuperar solo los elementos de línea que no tienen pausas

Pase show_alerts=true&pauses=false la cadena de consulta.

$ curl -b cookies -c cookies 'https://api.appnexus.com/line-item?show_alerts=true&pauses=false'

{
    "response": {
        "status": "OK",
        "line-items": [
            {
                "id": 45054,
                "code": null,
                "name": "Line Item 7",
                "advertiser_id": 35081,
                "state": "active",
                "start_date": "2012-04-01 00:00:00",
                "end_date": "2012-05-01 00:00:00",
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [

                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 45057,
                "code": null,
                "name": "Line Item 9",
                "advertiser_id": 35081,
                "state": "active",
                "start_date": "2012-05-21 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [

                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 46345,
                "code": null,
                "name": "Line Item 12",
                "advertiser_id": 45278,
                "state": "active",
                "start_date": "2012-06-06 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [

                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            ...
        ],
        ...
        }
    }
}

Recuperar solo los elementos de línea que tienen una pausa específica

Pase show_alerts=true&pauses=PAUSE_ID la cadena de consulta. Para los identificadores de pausa, consulte la tabla Pausas siguiente.

En este ejemplo, usamos el identificador de pausa 2 para recuperar todos los elementos de línea con fechas de inicio de vuelos que están en el futuro.

$ curl -b cookies -c cookies 'https://api.appnexus.com/line-item?show_alerts=true&pauses=2'

{
    "response": {
        "status": "OK",
        "line-items": [
            {
                "id": 45047,
                "code": null,
                "name": "Line Item 5",
                "advertiser_id": 35081,
                "state": "active",
                "start_date": "2012-11-01 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 2,
                            "message": "Flight start is in the future."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 45048,
                "code": null,
                "name": "Line Item 7",
                "advertiser_id": 35081,
                "state": "active",
                "start_date": "2012-10-15 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 2,
                            "message": "Flight start is in the future."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },

            ...
        ],
        ...
        }
    }
}

Recuperar solo elementos de línea que tengan dos o más pausas específicas

Pase show_alerts=true&pauses=SUM_OF_PAUSE_IDS la cadena de consulta. Para los identificadores de pausa, consulte la tabla Pausas siguiente.

En este ejemplo, agregamos juntos el identificador 1 de pausa y el identificador 2 de pausa para recuperar todos los elementos de línea que están establecidos en inactivos y tienen una fecha de estado de vuelo en el futuro.

$ curl -b cookies -c cookies 'https://api.appnexus.com/line-item?show_alerts=true&pauses=3'

{
    "response": {
        "status": "OK",
        "line-items": [
            {
                "id": 45047,
                "code": null,
                "name": "Line Item 3",
                "advertiser_id": 35081,
                "state": "inactive",
                "start_date": "2012-11-01 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 1,
                            "message": "State is set to inactive."
                        },
                        {
                            "id": 2,
                            "message": "Flight start is in the future."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },
            {
                "id": 45048,
                "code": null,
                "name": "Line Item 7",
                "advertiser_id": 35081,
                "state": "inactive",
                "start_date": "2012-10-15 00:00:00",
                "end_date": null,
                ...
                "alerts": {
                    "warnings": [

                    ],
                    "pauses": [
                        {
                            "id": 1,
                            "message": "State is set to inactive."
                        },
                        {
                            "id": 2,
                            "message": "Flight start is in the future."
                        }
                    ],
                    "warnings_last_checked": null,
                    "pauses_last_checked": "2012-07-27 19:01:07"
                }
            },

            ...
        ],
        ...
        }
    }
}

Pausas

Id.	Descripción
1	El estado se establece en inactivo.
2	El inicio del vuelo es en el futuro.
4	El final del vuelo está en el pasado.

Ejemplos

Actualización de un elemento de línea para usar un objetivo de rendimiento de CPC

En este ejemplo, actualizaremos un elemento de línea para usar un objetivo de rendimiento de CPC. Estamos estableciendo un umbral de objetivo de costo por clic de 3 USD.

$ cat line-item
{
    "line-item": {
    "name": "Weekday French Speakers Q3 2012",
    "state": "inactive",
    "comments": "The name says it all -- that's who we're trying to advertise to",
    "daily_budget": null,
    "revenue_type": "cpm",
    "goal_type": "cpc",
    "valuation": {
        "goal_target":3,
        "goal_threshold":3
    }
    "lifetime_budget": null,
    "end_date": null,
    "enable_pacing": null,
    "allow_safety_pacing": null,
    "publishers_allowed": "all"
    }
}

curl -b cookies -c cookies -X PUT -d @line-item "https://api.appnexus.com/line-item?id=152083&advertiser_id=51"

Actualización de un elemento de línea para usar un objetivo de rendimiento de CPC y CPA

En este ejemplo, actualizaremos un elemento de línea para usar un objetivo de rendimiento de CPC y CPA. Estamos estableciendo el objetivo de CPC de 5 USD y el objetivo de CPA a $10.

$ cat line-item
{
    "line-item": {
    "name": "Weekday French Speakers Q3 2012",
    "state": "inactive",
    "comments": "The name says it all -- that's who we're trying to advertise to",
    "daily_budget": null,
    "revenue_type": "cpm",
    "goal_type": "cpa",
    "pixels": [
        {
        "id": "123456"
        }
    ],
    "goal_pixels":[
        {
        "id":"123456",
        "post_click_goal_threshold":10,
        "post_click_goal_target":10
        }
    ],
    “valuation”: {
        “goal_target”: 5,
        “goal_threshold”: 5
        }
    }
}

curl -b cookies -X PUT -d @line-item "https://api.appnexus.com/line-item?id=152083&advertiser_id=51"

Visualización de un elemento de línea

Para ver un elemento de línea específico, debemos pasar los identificadores de línea y anunciante a través de la cadena de consulta.

$ curl -b cookies -c cookies 'https://api.appnexus.com/line-item?id=4979347&advertiser_id=1887392'
{
    "response": {
        "count": 1,
        "dbg_info": {
            "output_term": "line-item",
            "version": "1.18.227",
            "warnings": []
        },
        "line-item": {
            "ad_types": [
                "banner"
            ],
            "advertiser": {
                "id": 1887392,
                "name": "ALI Closed Beta Demo Advertiser"
            },
            "advertiser_id": 1887392,
            "allow_safety_pacing": null,
            "auction_event": null,
            "bid_object_type": "creative",
            "broker_fees": null,
            "budget_intervals": [
                {
                    "code": null,
                    "enable_pacing": true,
                    "end_date": "2017-12-02 23:59:59",
                    "id": 2509919,
                    "lifetime_budget": 1,
                    "lifetime_budget_imps": null,
                    "lifetime_pacing": true,
                    "lifetime_pacing_pct": 100,
                    "object_id": 4979347,
                    "object_type": "campaign_group",
                    "parent_interval_id": null,
                    "start_date": "2017-11-30 00:00:00",
                    "timezone": "US/Eastern"
                }
            ],
            "budget_set_per_flight": true,
            "campaigns": null,
            "click_url": null,
            "clicktrackers": null,
            "code": null,
            "comments": null,
            "creative_distribution_type": null,
            "creatives": null,
            "currency": "USD",
            "custom_models": [
                {
                    "active": "1",
                    "id": 477441,
                    "name": "cadence 2017-11-07 18:03:37.738",
                    "type": "cadence"
                }
            ],
            "custom_optimization_note": null,
            "daily_budget": null,
            "daily_budget_imps": null,
            "deals": null,
            "delivery_goal": null,
            "discrepancy_pct": 0,
            "enable_pacing": null,
            "enable_v8": false,
            "end_date": null,
            "goal_pixels": [
                {
                    "id": 932952,
                    "name": "Test Pixel",
                    "post_click_goal": null,
                    "post_click_goal_confidence_threshold": null,
                    "post_click_goal_target": 10,
                    "post_click_goal_threshold": 10,
                    "post_click_model_id": null,
                    "post_view_goal": null,
                    "post_view_goal_confidence_threshold": null,
                    "post_view_goal_target": null,
                    "post_view_goal_threshold": null,
                    "post_view_model_id": null,
                    "state": "active",
                    "trigger_type": "hybrid"
                }
            ],
            "goal_type": "cpc",
            "goal_value": null,
            "id": 4979347,
            "imptrackers": null,
            "incrementality": null,
            "insertion_orders": [
                {
                    "advertiser_id": 1887392,
                    "budget_intervals": [
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": null,
                            "id": 2509856,
                            "lifetime_budget": 1,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 676605,
                            "object_type": "insertion_order",
                            "start_date": "2017-11-30 00:00:00",
                            "timezone": "US/Eastern"
                        }
                    ],
                    "code": null,
                    "currency": "USD",
                    "end_date": null,
                    "id": 676605,
                    "last_modified": "2017-12-01 02:44:34",
                    "name": "Swetha_Seamless_IO",
                    "start_date": null,
                    "state": "active",
                    "timezone": "US/Eastern"
                }
            ],
            "inventory_discovery": {
                "fail_criteria_amount": 9.486486,
                "fail_criteria_type": "booked_revenue",
                "use_ranked_discovery": true
            },
            "inventory_discovery_budget": null,
            "inventory_type": "real_time",
            "labels": null,
            "last_modified": "2017-12-02 05:30:29",
            "lifetime_budget": null,
            "lifetime_budget_imps": null,
            "lifetime_pacing": null,
            "lifetime_pacing_pct": null,
            "lifetime_pacing_span": null,
            "line_item_type": "standard_v2",
            "manage_creative": true,
            "member_id": 1370,
            "name": "Swetha_ALI_Basic_API1",
            "pixels": [
                {
                    "id": 932952,
                    "name": "Test Pixel",
                    "post_click_revenue": null,
                    "post_view_revenue": null,
                    "state": "active",
                    "trigger_type": "hybrid"
                }
            ],
            "prefer_delivery_over_performance": false,
            "priority": "5",
            "profile_id": 96266622,
            "publishers_allowed": "all",
            "remaining_days": null,
            "require_cookie_for_tracking": true,
            "revenue_type": "vcpm",
            "revenue_value": null,
            "roadblock": null,
            "start_date": null,
            "state": "active",
            "timezone": "US/Eastern",
            "total_days": null,
            "valuation": {
                "bid_price_pacing_enabled": false,
                "bid_price_pacing_lever": 0,
                "goal_confidence_threshold": null,
                "goal_target": 5,
                "goal_threshold": 5,
                "max_avg_cpm": 3,
                "max_revenue_value": null,
                "min_avg_cpm": 2,
                "min_margin_pct": null,
                "min_revenue_value": null,
                "no_revenue_log": false
            }
        },
        "num_elements": 100,
        "start_element": 0,
        "status": "OK"
    }
}

Visualización de todos los artículos de línea de un anunciante

A diferencia de los ejemplos anteriores, este elemento de línea tiene una goal_pixels matriz de objetos adjuntos. Tenga en cuenta que, aunque este anunciante solo tiene un elemento de línea, se devuelve a través de la line-items matriz JSON.

$ curl -b cookies 'https://api.appnexus.com/line-item?advertiser_id=51'
{
    "response": {
        "count": 3,
        "line-items": [
            { ..."id": 4274691,...},
            { ..."id": 4983291,...},
            { ..."id": 4983258,...}
        ]
    }
}

Crear un elemento de línea con un tipo de ingresos de CPM, optimizado para un objetivo de CPA (conversiones posteriores al clic y posteriores a la vista)

cat li_cpa.json

{
    "line-item": {
    "name": "LI CPA Test",
    "state": "inactive",
    "daily_budget": null,
    "revenue_type": "cpm",
    "goal_type": "cpa",
    "goal_pixels": [
        {
            "id": 987654321,
            "name": "Confirmation Page",
            "post_click_goal": null,
            "post_click_goal_confidence_threshold": null,
            "post_click_goal_target": 1,
            "post_click_goal_threshold": 1,
            "post_click_model_id": null,
            "post_view_goal": null,
            "post_view_goal_confidence_threshold": null,
            "post_view_goal_target": 1,
            "post_view_goal_threshold": 1,
            "post_view_model_id": null,
            "state": "active",
            "trigger_type": "hybrid"
                }
            ], 
    "valuation": {
        "bid_price_pacing_enabled": false,
        "bid_price_pacing_lever": 0,
        "campaign_group_valuation_strategy": "retargeting",
        "goal_confidence_threshold": null,
        "goal_target": null,
        "goal_threshold": null,
        "max_avg_cpm": null,
        "max_revenue_value": null,
        "min_avg_cpm": null,
        "min_margin_pct": null,
        "min_revenue_value": null,
        "no_revenue_log": false
            },
}

$curl -b cookies -X POST -d @li_cpa.json 'https://api.appnexus.com/line-item?advertiser_id=12345'
{
    "response": {
        "count": 1,
        "dbg_info": {
            "output_term": "line-item",
            "version": "1.18.1023",
            "warnings": []
        },
        "line-item": {
            "ad_types": [
                "banner"
            ],
            "advertiser": {
                "id": 12345,
                "name": "Console Challenge (Please Do Not Modify)"
            },
            "advertiser_id": 12345,
            "allow_safety_pacing": null,
            "archived_on": null,
            "auction_event": {
                "kpi_auction_event_type": "impression",
                "kpi_auction_event_type_code": "impression",
                "kpi_auction_type_id": 1,
                "kpi_value": null,
                "payment_auction_event_type": "impression",
                "payment_auction_event_type_code": "impression",
                "payment_auction_type_id": 1,
                "revenue_auction_event_type": "impression",
                "revenue_auction_event_type_code": "impression",
                "revenue_auction_type_id": 1
            },
            "bid_object_type": "creative",
            "broker_fees": null,
            "budget_intervals": [
                {
                    "code": null,
                    "enable_pacing": true,
                    "end_date": "2019-02-11 23:59:59",
                    "id": 3886503,
                    "lifetime_budget": 0.01,
                    "lifetime_budget_imps": null,
                    "lifetime_pacing": true,
                    "lifetime_pacing_pct": 100,
                    "object_id": 7358523,
                    "object_type": "campaign_group",
                    "parent_interval_id": null,
                    "start_date": "2019-02-10 00:00:00",
                    "timezone": "US/Eastern"
                }
            ],
            "budget_set_per_flight": false,
            "campaigns": null,
            "click_url": null,
            "clicktrackers": null,
            "code": null,
            "comments": null,
            "creative_distribution_type": "ctr-optimized",
            "creatives": null,
            "currency": "USD",
            "custom_models": [
                {
                    "active": "1",
                    "experiment": "control",
                    "id": 222333,
                    "name": "Test 001",
                    "origin": "optimization",
                    "type": "conv_imp"
                },
                {
                    "active": "1",
                    "experiment": "control",
                    "id": 222334,
                    "name": "Test 002",
                    "origin": "optimization",
                    "type": "cadence"
                },
                {
                    "active": "1",
                    "experiment": "control",
                    "id": 222335,
                    "name": "Budget Splitter - 7358523 - Mon Feb 11 2019 04:08:49 GMT+0000",
                    "origin": "splitters",
                    "type": "budget_splitter"
                }
            ],
            "custom_optimization_note": null,
            "daily_budget": null,
            "daily_budget_imps": null,
            "deals": null,
            "delivery_goal": null,
            "discrepancy_pct": 0,
            "enable_pacing": null,
            "enable_v8": false,
            "end_date": null,
            "flat_fee": null,
            "flat_fee_type": null,
            "goal_pixels": [
                {
                    "id": 987654321,
                    "name": "Confirmation Page",
                    "post_click_goal": null,
                    "post_click_goal_confidence_threshold": null,
                    "post_click_goal_target": 1,
                    "post_click_goal_threshold": 1,
                    "post_click_model_id": null,
                    "post_view_goal": null,
                    "post_view_goal_confidence_threshold": null,
                    "post_view_goal_target": 1,
                    "post_view_goal_threshold": 1,
                    "post_view_model_id": null,
                    "state": "active",
                    "trigger_type": "hybrid"
                }
            ],
            "goal_type": "cpa",
            "goal_value": null,
            "id": 87654321,
            "imptrackers": null,
            "incrementality": null,
            "insertion_orders": [
                {
                    "advertiser_id": 12345,
                    "budget_intervals": [
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2018-05-31 23:59:59",
                            "id": 2957582,
                            "lifetime_budget": 100,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2018-05-23 00:00:00",
                            "timezone": "US/Eastern"
                        },
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2018-09-24 23:59:59",
                            "id": 3331427,
                            "lifetime_budget": 100,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2018-09-23 00:00:00",
                            "timezone": "US/Eastern"
                        },
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2018-11-30 23:59:59",
                            "id": 3494586,
                            "lifetime_budget": 600,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2018-10-31 00:00:00",
                            "timezone": "US/Eastern"
                        },
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2018-12-12 23:59:59",
                            "id": 3636004,
                            "lifetime_budget": 300,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2018-12-07 00:00:00",
                            "timezone": "US/Eastern"
                        },
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2019-01-14 23:59:59",
                            "id": 3746556,
                            "lifetime_budget": 400,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2019-01-07 00:00:00",
                            "timezone": "US/Eastern"
                        },
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2019-01-22 23:59:59",
                            "id": 3773032,
                            "lifetime_budget": 0.01,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2019-01-15 00:00:00",
                            "timezone": "US/Eastern"
                        },
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2019-02-06 23:59:59",
                            "id": 3857762,
                            "lifetime_budget": 0.01,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2019-02-04 00:00:00",
                            "timezone": "US/Eastern"
                        },
                        {
                            "code": null,
                            "daily_budget": null,
                            "daily_budget_imps": null,
                            "enable_pacing": false,
                            "end_date": "2019-02-28 23:59:59",
                            "id": 3886493,
                            "lifetime_budget": 600,
                            "lifetime_budget_imps": null,
                            "lifetime_pacing": false,
                            "object_id": 811332,
                            "object_type": "insertion_order",
                            "start_date": "2019-02-10 00:00:00",
                            "timezone": "US/Eastern"
                        }
                    ],
                    "code": null,
                    "currency": "USD",
                    "end_date": null,
                    "id": 811332,
                    "last_modified": "2019-02-25 15:36:24",
                    "name": "Natasha Test IO",
                    "start_date": null,
                    "state": "active",
                    "timezone": "US/Eastern"
                }
            ],
            "inventory_discovery": null,
            "inventory_type": "both",
            "is_archived": false,
            "labels": null,
            "last_modified": "2019-03-01 21:12:45",
            "lifetime_budget": null,
            "lifetime_budget_imps": null,
            "lifetime_pacing": null,
            "lifetime_pacing_pct": null,
            "lifetime_pacing_span": null,
            "line_item_type": "standard_v2",
            "manage_creative": true,
            "member_id": 1370,
            "name": "Copy test2_01_17",
            "pixels": [
                {
                    "id": 1017110,
                    "name": "Confirmation Page",
                    "post_click_revenue": null,
                    "post_view_revenue": null,
                    "state": "active",
                    "trigger_type": "hybrid"
                }
            ],
            "prefer_delivery_over_performance": false,
            "priority": "5",
            "profile_id": 109625231,
            "publishers_allowed": "all",
            "remaining_days": null,
            "require_cookie_for_tracking": true,
            "revenue_type": "cpm",
            "revenue_value": 1,
            "roadblock": null,
            "start_date": null,
            "state": "inactive",
            "supply_strategies": {
                "deals": false,
                "managed": false,
                "rtb": true
            },
            "timezone": "US/Eastern",
            "total_days": null,
            "user_info": {
                "creator_id": 17707,
                "owner_id": 17707
            },
            "valuation": {
                "bid_price_pacing_enabled": false,
                "bid_price_pacing_lever": 0,
                "campaign_group_valuation_strategy": "retargeting",
                "goal_confidence_threshold": null,
                "goal_target": null,
                "goal_threshold": null,
                "max_avg_cpm": null,
                "max_revenue_value": null,
                "min_avg_cpm": null,
                "min_margin_pct": null,
                "min_revenue_value": null,
                "no_revenue_log": false
            },
            "viewability_vendor": "appnexus"
        },
        "num_elements": 100,
        "start_element": 0,
        "status": "OK"
    }
}

Creación de un elemento de línea con un tipo de ingresos de CPM dinámico y optimizado para un objetivo de CPC

En este ejemplo, establecemos el objetivo de CPC en $5 y el promedio mínimo de CPM en $2 y el promedio máximo de CPM en $3.

{code}$ cat line_item_dcp_cpc
{
  "line-item": {
    "ad_types": [
      "banner"
     ],
    "advertiser": {
      "id": 1887392,
      "name": "ALI Closed Beta Demo Advertiser"
     },
    "currency": "USD",
    "insertion_orders": [{
      "advertiser_id": 1887392,
      "budget_intervals": [{
            "code": null,
            "daily_budget": null,
            "daily_budget_imps": null,
            "enable_pacing": false,
            "end_date": null,
            "id": 2509856,
            "lifetime_budget": 1,
            "lifetime_budget_imps": null,
            "lifetime_pacing": false,
            "object_id": 676605,
            "object_type": "insertion_order",
            "start_date": "2017-11-30 00:00:00",
            "timezone": "US/Eastern"
        }],
        "code": null,
        "currency": "USD",
        "end_date": null,
        "id": 676605,
        "last_modified": "2017-12-01 02:44:34",
        "name": "Swetha_Seamless_IO",
        "start_date": null,
        "state": "active",
        "timezone": "US/Eastern"
    }],
    "advertiser_id": 1887392,
    "budget_intervals": [{
        "code": null,
        "enable_pacing": true,
        "end_date": "2017-12-02 23:59:59",
        "lifetime_budget": 1,
        "lifetime_budget_imps": null,
        "lifetime_pacing": true,
        "lifetime_pacing_pct": 100,
        "parent_interval_id": null,
        "start_date": "2017-11-30 00:00:00",
        "timezone": "US/Eastern"
    }],
        "goal_pixels": null,
        "goal_type": "cpc",
        "goal_value": null,
        "inventory_type": "real_time",
        "line_item_type": "standard_v2",
        "manage_creative": true,
        "name": "Swetha_ALI_Basic_API1",
        "profile_id": 96266482,
        "revenue_type": "vcpm",
        "revenue_value": null,
        "state": "active",
        "valuation": {
            "goal_target": 5,
            "goal_threshold": 5,
            "min_avg_cpm": 2,
            "max_avg_cpm": 3
        }
    }
}
{code}

{code}
curl -b cookies -X POST -d  @line_item_dcp_cpc.json  "https://api.appnexus.com/line-item?&advertiser_id=1887392"
{code}

Creación de un elemento de línea con un tipo de ingresos de CPM visible y optimizado para un objetivo de CPC y CPA

En este ejemplo, se crea un elemento de línea con un tipo de ingresos de CPM visible, un objetivo de CPC de 5 USD y un objetivo de CPA de 10 USD.

{code}$ cat line_item_dcp_vcpm_cpaopt
{
    "line-item": {
        "ad_types": [
            "banner"
        ],
        "advertiser": {
            "id": 1887392,
            "name": "ALI Closed Beta Demo Advertiser"
        },
        "currency": "USD",
        "insertion_orders": [{
            "advertiser_id": 1887392,
            "budget_intervals": [{
                "code": null,
                "daily_budget": null,
                "daily_budget_imps": null,
                "enable_pacing": false,
                "end_date": null,
                "id": 2509856,
                "lifetime_budget": 1,
                "lifetime_budget_imps": null,
                "lifetime_pacing": false,
                "object_id": 676605,
                "object_type": "insertion_order",
                "start_date": "2017-11-30 00:00:00",
                "timezone": "US/Eastern"
            }],
            "code": null,
            "currency": "USD",
            "end_date": null,
            "id": 676605,
            "last_modified": "2017-12-01 02:44:34",
            "name": "Swetha_Seamless_IO",
            "start_date": null,
            "state": "active",
            "timezone": "US/Eastern"
        }],

        "advertiser_id": 1887392,
        "budget_intervals": [{
            "code": null,
            "enable_pacing": true,
            "end_date": "2017-12-02 23:59:59",
            "lifetime_budget": 1,
            "lifetime_budget_imps": null,
            "lifetime_pacing": true,
            "lifetime_pacing_pct": 100,
            "parent_interval_id": null,
            "start_date": "2017-11-30 00:00:00",
            "timezone": "US/Eastern"
        }],
        "goal_type": "cpa",
        "goal_value": null,
        "inventory_type": "real_time",
        "line_item_type": "standard_v2",
        "manage_creative": true,
        "name": "Swetha_ALI_VCPM_CPA",
        "profile_id": 96293804,
        "revenue_type": "cpm",
        "revenue_value": 3,
        "state": "active",
        "goal_pixels": [{
            "id": 932952,
            "post_click_goal_target": 10,
            "post_click_goal_threshold": 10
        }],
        "pixels": [{
            "id": 932952
        }],

        "valuation": {
            "goal_target": 5,
            "goal_threshold": 5
        },
        "auction_event": {
            "revenue_auction_event_type": "view",
            "revenue_auction_event_type_code": "view_display_50pv1s_an",
            "revenue_auction_type_id": 2}
    }
}
{code}

{code}
curl -b cookies -X POST -d @line_item_dcp_vcpm_cpaopt.json “https://api.appnexus.com/line-item?&advertiser_id=1887392”
{code}

Creación de un elemento de línea con un tipo de ingresos de CPM optimizado para un objetivo de VCR

En este ejemplo, establecemos el objetivo de VCR en el 50 % y el valor de los ingresos de CPM en $3.

Nota:

La estrategia de suministro administrada debe establecerse en false para aplicar un objetivo de VCR al elemento de línea. No se admite la optimización de VCR para los elementos de línea destinados al inventario administrado.

$ cat line_item_vcr 
{
 "line-item": {
 
     "ad_types": [
         "video"
     ],
     "advertiser": {
         "id": 4127136,
         "name": "VCR Test Advertiser"
     },
     "advertiser_id": 4127136,
     "inventory_type": "both",
     "name": "Test VCR LI",
     "state": "active",
     "currency": "USD",
     "timezone": "US/Eastern",
     "revenue_type": "cpm",
     "revenue_value": 3,
     "supply_strategies": {
         "managed": false,
         "rtb": true,
         "deals": false,
         "programmatic_guaranteed": false
     },
     "goal_type": "none",
     "budget_intervals": [
         {
             "id": 12024043,
             "object_id": 14286184,
             "object_type": "campaign_group",
             "start_date": "2021-03-19 00:00:00",
             "end_date": "2021-04-30 23:59:59",
             "timezone": "US/Eastern",
             "code": null,
             "parent_interval_id": null,
             "creatives": null,
             "subflights": null,
             "lifetime_budget": 2,
             "lifetime_budget_imps": null,
             "lifetime_pacing": true,
             "enable_pacing": true,
             "lifetime_pacing_pct": 100,
             "daily_budget_imps_opt": null,
             "daily_budget_opt": null
         }
     ],
     "insertion_orders": [
         {
             "id": 3205367,
             "state": "inactive"
             "name": "VCR Test IO",
             "advertiser_id": 4127136,
             "currency": "USD",
             "budget_intervals": [
                 {
                     "id": 6461220,
                     "object_id": 3205367,
                     "object_type": "insertion_order",
                     "start_date": "2019-11-30 00:00:00",
                     "end_date": "2019-12-31 23:59:59",
                     "timezone": "US/Eastern",
                     "code": null,
                     "lifetime_budget": 1,
                     "lifetime_budget_imps": null,
                     "lifetime_pacing": false,
                     "enable_pacing": false,
                     "daily_budget_imps": null,
                     "daily_budget": null,
                     "daily_budget_imps_opt": null,
                     "daily_budget_opt": null
                 }
             ],
         }
     ],
     "auction_event": {
         "payment_auction_event_type_code": "impression",
         "payment_auction_event_type": "impression",
         "payment_auction_type_id": 1,
         "revenue_auction_event_type_code": "impression",
         "revenue_auction_event_type": "impression",
         "revenue_auction_type_id": 1,
         "kpi_auction_event_type_code": "video_completion",
         "kpi_auction_event_type": "video",
         "kpi_auction_type_id": 10,
         "kpi_value_type": "rate_threshold",
         "kpi_value": 0.5
     },
     "valuation": {
         "min_margin_pct": null,
         "min_margin_cpm": null,
         "max_avg_cpm": null,
         "min_avg_cpm": null,
         "min_revenue_value": null,
         "max_revenue_value": null,
         "goal_target": null,
         "goal_threshold": null,
         "no_revenue_log": false,
         "bid_price_pacing_enabled": false,
         "bid_price_pacing_lever": 0,
         "campaign_group_valuation_strategy": null,
         "goal_confidence_threshold": null
     }
  } 
} 

Actualización de un elemento de línea para optimizar a un objetivo de CPM visible

En este ejemplo, estamos actualizando un elemento de línea para optimizar a es un objetivo de CPM visible de 5 USD.

{code}$ cat line_item_vcpmopt.json
{
    "line-item": {
        "goal_type": "none",
        "goal_value": null,
        "name": "ALI_VCPMOpt",
        "state": "active",
        "goal_pixels": null,
        "auction_event": {
            "kpi_auction_event_type": "view",
            "kpi_auction_event_type_code": "view_display_50pv1s_an",
            "kpi_auction_type_id": 2,
            "kpi_value": 5
        }
    }
}
{code}

{code}
curl -b cookies -X PUT -d @line_item_vcpmopt.json "https://api.appnexus.com/line-item?id=152083&advertiser_id=1887392"
{code}

Actualizar un elemento de línea para usar un tipo de ingresos de CPM visible

En este ejemplo, estamos actualizando un elemento de línea para usar un tipo de ingresos de VCPM y estableciendo el valor en $3.

{code}$ cat lineitem_vcpm.json
{
    "line-item": {
        "goal_type": "none",
        "goal_value": null,
        "inventory_type": "real_time",
        "line_item_type": "standard_v2",
        "revenue_type": "cpm",
        "revenue_value": 3,
        "state": "active",
        "auction_event": {               
            "revenue_auction_event_type": "view",
            "revenue_auction_event_type_code": "view_display_50pv1s_an",
            "revenue_auction_type_id": 2}
    }
}
{code}

{code}
curl -b cookies -X PUT -d @lineitem_vcpm.json "https://api.appnexus.com/line-item?id=152083&advertiser_id=1887392"
{code}

Actualizar un elemento de línea para usar un tipo de ingresos de CPC

En este ejemplo, estamos actualizando un elemento de línea para usar un tipo de ingresos de CPC y estableciendo el valor de ingresos en $3.

{code}$ cat line_item_cpc.json
{
    "line-item": {
        "inventory_type": "real_time",
        "line_item_type": "standard_v2",
        "revenue_type": "cpm",
        "revenue_value": 3,
        "state": "active",
        "auction_event": {
        "revenue_auction_event_type": "click",
        "revenue_auction_event_type_code": "click",
        "revenue_auction_type_id": 3
        }
    }
}
{code}
{code}
curl -b cookies -X PUT -d @line_item_cpc.json "https://api.appnexus.com/line-item?id=152083&advertiser_id=1887392"
{code}

Actualizar un elemento de línea para usar un tipo de ingresos de Margen de costo más (pagar un CPM plano) y deshabilitar la optimización

En este ejemplo, estamos actualizando un elemento de línea para usar un tipo de ingresos de margen de costo más con un margen del 20 % y con la optimización deshabilitada. El CPM es un CPM plano de 11.

{code}$ cat line_item_costplus_base.json
{
    "line-item": {
        "goal_type": "none",
        "goal_value": null,
        "inventory_type": "real_time",
        "line_item_type": "standard_v2",
        "revenue_type": "cost_plus_margin",
        "revenue_value": 0.20,
        "state": "active",
        "goal_pixels": null,
        "valuation":{"max_avg_cpm": 11}
    }
}
{code}

{code}
curl -b cookies -X PUT -d @line_item_costplus_base.json "https://api.appnexus.com/line-item?id=152083&advertiser_id=1887392"
{code}

Actualización de un elemento de línea para deshabilitar la optimización

En este ejemplo, estamos actualizando un elemento de línea para deshabilitar la optimización.

{code}$ cat line_item_no_opt.json
{
    "line-item": {
        "auction_event": {
        "kpi_auction_event_type": "impression",
        "kpi_auction_event_type_code": "impression",
        "kpi_auction_type_id": 1,
        "kpi_value": null,
        "payment_auction_event_type": "impression",
        "payment_auction_event_type_code": "impression",
        "payment_auction_type_id": 1,
        "revenue_auction_event_type": "impression",
        "revenue_auction_event_type_code": "impression",
        "revenue_auction_type_id": 1
        },
        "goal_pixels": null,
        "goal_type": "none",
        "goal_value": null
    }
}
{code}

{code}
$ curl -b cookies -X PUT -d @line_item_no_opt.json "https://api.appnexus.com/line-item?&id=152083&advertiser_id=1887392"
{code}

Creación de un elemento de línea de compra garantizado mediante programación

Escenario: Ha negociado una oferta con garantía programática (acuerdo PG) con un vendedor y le gustaría dirigirse a este trato con un artículo de línea de compra garantizado mediante programación (artículo de línea de compra de PG).

1. Cree un perfil de oferta PG y anote el identificador de este perfil (consulte Ejemplo de oferta garantizada mediante programación en Profile Service).

2. Cree un json de línea de compra de PG (necesitará un identificador de pedido de inserción y un identificador de perfil existentes).

   $ cat pg_buying_line_item
   {
     "line-item": {
       "insertion_orders": [
         {
           "id": 1234
         }
       ],
       "name": "My PG Buying Line Item",
       "state": "active",
       "ad_types": [
         "banner"
       ],
       "profile_id": 123456,
       "currency": "USD",
       "supply_strategies": {
         "rtb": false,
         "managed": false,
         "deals": false,
         "programmatic_guaranteed": true
       },
       "revenue_value": 0.0,
       "revenue_type": "cost_plus_margin",
       "creatives": [],
       "require_cookie_for_tracking": false,
       "line_item_type": "standard_v2",
       "manage_creative": true
     }
   }
   

3. Realice una POST solicitud al punto de https://api.appnexus.com/line-item conexión mediante este archivo JSON de línea de compra de PG y el elemento de línea adecuado advertiser_id.

   $ curl -b cookies -X POST -d @pg_buying_line_item 'https://api.appnexus.com/line-item?advertiser_id=123'
   {
       "response": {
           "status": "OK",
           "count": 1,
           "id": 8757356,
           "start_element": 0,
           "num_elements": 100,
           "line-item": {
               "id": 8757356,
               "code": null,
               "name": "My PG Buying Line Item",
               "advertiser_id": 123,
               "state": "active",
               "start_date": null,
               "end_date": null,
               "timezone": "CET",
               "discrepancy_pct": 0,
               "publishers_allowed": "all",
               "revenue_value": 0,
               "revenue_type": "cost_plus_margin",
               "goal_type": "none",
               "goal_value": null,
               "last_modified": "2019-08-07 19:49:45",
               "click_url": null,
               "currency": "USD",
               "require_cookie_for_tracking": false,
               "profile_id": 123456,
               "member_id": 958,
               "flat_fee_type": null,
               "comments": null,
               "remaining_days": null,
               "total_days": null,
               "manage_creative": true,
               "budget_set_per_flight": true,
               "creative_distribution_type": null,
               "line_item_type": "standard_v2",
               "bid_object_type": "creative",
               "prefer_delivery_over_performance": false,
               "priority": "5",
               "enable_v8": false,
               "viewability_vendor": null,
               "is_archived": false,
               "archived_on": null,
               "delivery_model_type": "standard",
               "advertiser": {
                   "id": 123,
                   "name": "My Advertiser"
               },
               "flat_fee": null,
               "supply_strategies": {
                   "managed": false,
                   "rtb": false,
                   "deals": false,
                   "programmatic_guaranteed": true
               },
               "deals": null,
               "delivery_goal": null,
               "labels": null,
               "broker_fees": null,
               "pixels": null,
               "insertion_orders": [
                   {
                       "id": 1234,
                       "state": "active",
                       "code": null,
                       "name": "Test IO",
                       "advertiser_id": 123,
                       "start_date": null,
                       "end_date": null,
                       "timezone": "CET",
                       "last_modified": "2018-03-06 21:16:47",
                       "currency": "USD",
                       "budget_intervals": [
                           {
                               "id": 2436841,
                               "object_id": 1234,
                               "object_type": "insertion_order",
                               "start_date": "2017-11-08 00:00:00",
                               "end_date": "2017-11-13 23:59:59",
                               "timezone": "CET",
                               "code": null,
                               "lifetime_budget": 10,
                               "lifetime_budget_imps": null,
                               "lifetime_pacing": false,
                               "enable_pacing": false,
                               "daily_budget_imps": null,
                               "daily_budget": null
                           }
                       ]
                   }
               ],
               "goal_pixels": null,
               "imptrackers": null,
               "clicktrackers": null,
               "campaigns": null,
               "valuation": null,
               "creatives": null,
               "budget_intervals": null,
               "custom_models": null,
               "inventory_discovery": null,
               "incrementality": null,
               "auction_event": null,
               "custom_optimization_note": null,
               "roadblock": null,
               "ad_types": null,
               "user_info": null,
               "partner_fees": null,
               "product": null,
               "in_demo_measurement": null,
               "lifetime_budget": null,
               "lifetime_budget_imps": null,
               "daily_budget": null,
               "daily_budget_imps": null,
               "enable_pacing": null,
               "allow_safety_pacing": null,
               "lifetime_pacing": null,
               "lifetime_pacing_span": null,
               "lifetime_pacing_pct": null,
               "inventory_type": "both"
           },
           "dbg_info": {
               "warnings": [],
               "version": "1.18.1247",
               "output_term": "line-item"
           }
       }
   }
   

Eliminación de un elemento de línea

curl -b cookies -X DELETE "https://api.appnexus.com/line-item?id=5851054&advertiser_id=5413231"

{"response":
    {
        "status":"OK",
        "count":1,
        "start_element":null,
        "num_elements":null,
        "dbg_info":
            {
                "warnings":[],
                "version":"1.0.190",
                "output_term":"not_found"}
            }
    }
}

Actualización de un elemento de línea para optimizar para CPCV

En este ejemplo, estamos actualizando un elemento de línea para optimizar a CPCV $0,08.

{code}$ cat line_item_CPCV.json
{
    "line-item": {
        "goal_type": "none",
        "goal_value": null,
        "name": "ALI_CPCV",
        "state": "active",
        "goal_pixels": null,
        "auction_event": {
                "payment_auction_event_type_code": "impression",
                "payment_auction_event_type": "impression",
                "payment_auction_type_id": 1,
                "revenue_auction_event_type_code": "impression",
                "revenue_auction_event_type": "impression",
                "revenue_auction_type_id": 1,
                "kpi_auction_event_type_code": "video_completion",
                "kpi_auction_event_type": "video",
                "kpi_auction_type_id": 10,
                "kpi_value_type": "goal_value",
                "kpi_value": 0.08
            }
    }
}
{code}
{code}
curl -b cookies -X PUT -d @line_item_CPCV.json "https://api.appnexus.com/line-item?id=152083&advertiser_id=1887392"
{code}

Un elemento de línea que no está optimizado para CPCV

En este ejemplo, tenemos un elemento de línea que no está optimizado para CPCV.

{code}$ cat line_item_CPCV.json
{
    "line-item": {
        "goal_type": "none",
        "goal_value": null,
        "name": "ALI_CPCV",
        "state": "active",
        "goal_pixels": null,
        "auction_event": { 
                "kpi_auction_event_type": "impression", 
                "kpi_auction_event_type_code": "impression", 
                "kpi_auction_type_id": 1, 
                "kpi_value": null, 
                "kpi_value_type": "none", 
                "payment_auction_event_type": "impression",
                "payment_auction_event_type_code": "impression", 
                "payment_auction_type_id": 1, 
                "revenue_auction_event_type": "impression",
                "revenue_auction_event_type_code": 
                "impression", "revenue_auction_type_id": 1 }
    }
}
{code}

{code}
curl -b cookies -X PUT -d @line_item_CPCV.json "https://api.appnexus.com/line-item?id=152083&advertiser_id=1887392"
{code}

Temas relacionados

• Procedimientos recomendados de API
• Semántica de API
• Servicio de píxeles de conversión
• Servicio de pedido de inserción