Servicio de informes de elementos de línea
Nota:
Este servicio está disponible actualmente para un conjunto limitado de clientes y empleados de Microsoft.
Este campo o característica forma parte de la funcionalidad actualmente en la fase Alfa o Beta. Por lo tanto, está sujeto a cambios.
Los administradores de Xandr pueden usar este servicio para crear el elemento de standard_v2 línea.
API de REST
| Métodos HTTP | Endpoint | Description |
|---|---|---|
POST |
https://sor-api.adnxs.net/standard_v2(standard_v2 JSON) |
Agregue un nuevo elemento de línea de destino aumentada y un perfil asociado. |
PUT |
https://sor-api.adnxs.net/standard_v2(standard_v2 JSON) |
Modifique un elemento de línea de destino aumentada y un perfil asociado. |
Campos JSON
| Campo | Tipo | Descripción |
|---|---|---|
line_item |
matriz | Consulte Matriz de elementos de línea. |
campaigns |
matriz | Consulta Matriz de campañas. |
Matriz de elementos de línea
La matriz de elementos de línea funciona como el servicio de elementos de línea.
| Campo | Tipo | Descripción |
|---|---|---|
id |
Entero | Identificador del elemento de línea. Obligatorio On: PUT, en la cadena de consulta. |
name |
string | Nombre del elemento de línea. Obligatorio activado: POST |
line_item_type |
enumeración | Para que el servicio de informes de elementos de línea funcione correctamente, seleccione standard_v2.Predeterminado: standard_v1Obligatorio activado: POST |
revenue_type |
enumeración | La forma en que el anunciante ha aceptado pagarle. Los valores posibles para line_item_type = standard_v2 se enumeran a continuación:- "cpm": un pago plano por cada 1000 impresiones. Requiere un .revenue_value- "vcpm": valor esperado para cada impresión.Para un tipo de ingresos de "cpm" o "vcpm", se requiere una de las siguientes opciones:- goal_type:- cpa: use la matriz Goal Pixels. - cpc: use la matriz de valoración.Cada uno también puede incluir: - max_avg_cpm en la matriz Valoración.Obligatorio activado: POST |
revenue_value |
double | Cantidad pagada a la red por el anunciante. Obligatorio activado: POST |
budget_intervals |
matriz | Consulte Intervalos de presupuesto. Nota: - Establezca en enable_pacingtrue.Y - Establecer lifetime_budget o lifetime_budget_imp y lifetime_pacing.OR - Establecer lifetime_budget o lifetime_budget_imps y daily_budget o daily_budget_imps.Obligatorio activado: POST |
creative |
matriz | Las creatividades asociadas al elemento de línea. Primero debe agregar la creatividad a través del Servicio creativo si aún no tiene una creatividad que usar. Consulte Matriz creativa. |
profile |
matriz | Consulte Servicio de perfiles. |
Matriz creativa
| Campo | Tipo | Descripción |
|---|---|---|
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. |
Matriz de valoración
| Campo | Tipo | Descripción |
|---|---|---|
goal_threshold |
decimal | En el caso de los artículos de línea con goal_type"cpc", el umbral del objetivo de rendimiento, que determina el límite de puja o no puja en las campañas optimizadas.Predeterminado: null |
goal_target |
decimal | Para los elementos de línea con goal_type"cpc", el objetivo de rendimiento, que representa los clics deseados o la tasa de clics.Predeterminado: null |
performance_mkt_managed |
booleano |
Predeterminado: Establezca en false. |
min_margin_pct |
decimal | Para las partidas individuales con revenue_type"cpm", "cpa"o "cpc" el margen mínimo PCT.Predeterminado: null |
min_avg_cpm |
decimal | Los ingresos por partidas de línea no pueden ser inferiores a este promedio mínimo de eCPM. Predeterminado: null |
max_avg_cpm |
decimal | Los ingresos por artículo de línea no pueden superar este promedio máximo de eCPM. Predeterminado: null |
Matriz de campañas
A continuación se muestra la campaña predeterminada que tiene que alimentar El servicio de informes de elementos de línea al crear un nuevo elemento de línea. Siempre tendrá que construir una campaña con los siguientes campos y valores, y el servicio de informes de elementos de línea creará y asociará la campaña real automáticamente. El servicio de informes de elementos de línea espera la campaña en una lista, aunque solo colocaría una campaña.
| Campo | Tipo | Valor |
|---|---|---|
name |
string | Nombre del elemento de línea. |
state |
enumeración | Estado del elemento de línea. |
inventory_type |
enumeración | "both" |
cpm_bid_type |
enumeración | "bpp" |
require_cookie_for_tracking |
enumeración | "false" |
Ejemplo
Crear un nuevo elemento de línea de trading aumentada
$ cat standard_v2.json
{
"standard_v2": {
"line_item": {
"line_item_type": "standard_v2",
"payout_margin": null,
"require_cookie_for_tracking": true,
"name": "Tst",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"click_url": null,
"lifetime_budget": null,
"lifetime_budget_imps": null,
"lifetime_pacing": null,
"enable_pacing": null,
"daily_budget": null,
"daily_budget_imps": null,
"budget_intervals": [
{
"start_date": "2016-01-08 00:00:00",
"end_date": "2016-01-09 00:00:00",
"lifetime_budget": 1,
"lifetime_budget_imps": null,
"parent_interval_id": 7103,
"lifetime_pacing": false,
"enable_pacing": true,
"daily_budget": 1,
"daily_budget_imps": null
}
],
"insertion_orders": [
{
"id": 269592,
"name": "First Test",
"code": null,
"state": "active",
"advertiser_id": 764141,
"start_date": null,
"end_date": null,
"remaining_days": null,
"total_days": null,
"last_modified": "2016-01-08 21:57:18",
"timezone": "EST5EDT",
"currency": "JPY",
"comments": null,
"billing_code": null,
"line_items": [
{
"id": 2621282,
"name": "First LI",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"timezone": "EST5EDT"
},
{
"id": 2621320,
"name": "TEst 2",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"timezone": "EST5EDT"
},
{
"id": 2621351,
"name": "Test",
"code": null,
"state": "active",
"start_date": null,
"end_date": null,
"timezone": "EST5EDT"
}
],
"spend_protection_pixels": null,
"labels": null,
"broker_fees": null,
"budget_intervals": [
{
"id": 7103,
"object_id": 269592,
"object_type": "insertion_order",
"start_date": "2016-01-08 00:00:00",
"end_date": "2016-01-09 00:00:00",
"timezone": "EST5EDT",
"lifetime_budget": 1,
"lifetime_budget_imps": null,
"lifetime_pacing": false,
"enable_pacing": false,
"daily_budget_imps": null,
"daily_budget": null
}
],
"tpas_details": null,
"lifetime_pacing": null,
"lifetime_budget": null,
"lifetime_budget_imps": null,
"enable_pacing": null,
"lifetime_pacing_span": null,
"allow_safety_pacing": null,
"daily_budget": null,
"daily_budget_imps": null,
"lifetime_pacing_pct": null
}
],
"currency": "JPY",
"broker_fees": [],
"manage_creative": true,
"creative_distribution_type": "even",
"creatives": [],
"labels": [],
"revenue_type": "vcpm",
"revenue_value": null,
"track_revenue": "track",
"pixels": [],
"valuation": {
"goal_target": 1,
"goal_threshold": 1,
"performance_mkt_managed": false,
"min_margin_pct": 1,
"min_avg_cpm": 1,
"max_avg_cpm": 1
},
"goal_type": "cpc",
"goal_value": null,
"goal_pixels": null,
"comments": null,
"profile": {
"require_cookie_for_freq_cap": true,
"max_day_imps": null,
"max_lifetime_imps": null,
"min_minutes_per_imp": null,
"max_page_imps": null,
"device_type_action": "exclude",
"device_type_targets": null,
"supply_type_action": "exclude",
"supply_type_targets": null,
"city_targets": null,
"city_action": "exclude",
"country_action": "exclude",
"country_targets": null,
"region_targets": null,
"region_action": "exclude",
"dma_targets": null,
"dma_action": "exclude",
"location_target_latitude": null,
"location_target_longitude": null,
"location_target_radius": null,
"zip_targets": null,
"postal_code_targets": null,
"content_category_targets": null,
"domain_action": "exclude",
"domain_targets": null,
"domain_list_action": "exclude",
"domain_list_targets": null,
"inventory_action": "exclude",
"placement_targets": null,
"publisher_targets": null,
"site_targets": null,
"mobile_app_instance_action_include": false,
"mobile_app_instance_targets": null,
"mobile_app_instance_list_action_include": false,
"mobile_app_instance_list_targets": null,
"member_targets": null,
"platform_content_category_targets": null,
"platform_placement_targets": null,
"platform_publisher_targets": null,
"segment_boolean_operator": "or",
"segment_group_targets": [],
"daypart_targets": null,
"daypart_timezone": null,
"querystring_action": "exclude",
"querystring_boolean_operator": "and",
"querystring_targets": null,
"position_targets": {
"allow_unknown": true,
"positions": null
},
"gender_targets": null,
"age_targets": null,
"certified_supply": false,
"allow_unaudited": false,
"trust": "appnexus",
"video_targets": {
"contexts": null,
"playback_methods": null,
"player_sizes": null,
"allow_unknown_playback_method": false,
"allow_unknown_context": false,
"allow_unknown_player_size": false
},
"inventory_attribute_targets": [
{
"id": "2"
},
{
"id": "4"
},
{
"id": "6"
},
{
"id": "8"
},
{
"id": "10"
},
{
"id": "14"
},
{
"id": "16"
},
{
"id": "18"
}
],
"intended_audience_targets": [
"general",
"children",
"young_adult"
],
"use_inventory_attribute_targets": true,
"use_operating_system_extended_targeting": true,
"operating_system_extended_targets": null,
"operating_system_family_action": "exclude",
"operating_system_family_targets": null,
"operating_system_action": "exclude",
"operating_system_targets": null,
"language_action": "exclude",
"language_targets": null,
"browser_action": "exclude",
"browser_targets": null,
"carrier_action": "exclude",
"carrier_targets": null,
"device_model_action": "exclude",
"device_model_targets": null
},
"id": 0
},
"campaigns": [
{
"name": "Tst",
"state": "active",
"inventory_type": "both",
"cpm_bid_type": "bpp",
"require_cookie_for_tracking": false
}
]
}
}
$ curl -b cookies -c cookies -X POST -d @standard_v2.json "http://sor-api.adnxs.net/standard_v2"