Knowledgebase: API
Planificador de inventarios
on 16 December 2016 06:43 PM

Brinda una estimación de tráfico e impresiones vendidas para fechas futuras.
 

URL para obtener el resultado de la planificación:

/admin/jsapi/espacio?op=i&ejecutar=1

 

Si la tarea aún está en proceso devuelve el porcentaje de progreso de la misma, además del estado actual. En caso de que haya finalizado, devuelve el resultado de la planificación en planificacion_resultado.

Parámetros obligatorios:

  • planificacion_id Obtenido usando la URL anterior
  • tipoventa_id: Posibles valores:
    			1	Impresiones
    			2	Clics
    			3	Conversiones
  • cantidad_total: Cantidad de impresiones/clicks a consultar.
  • prioridad: Indicar la prioridad de corte. Valores posibles: de 1 a 10
  • ajuste:  valor entero entre -100 y 100) 
  • base_de_estimacion:  Base histórica. Posibles valores:
    			0	7 dí­as
    			1	15 días
    			2	30 días
    			3	90 días 
  • CTR: Decimal entre 0 y 100 (solo para calcular clics) 
  • tasa_conversion: Decimal entre 0 y 100 (solo para calcular conversiones) 
  • target_sitio_id: listado de sitios, separados por +, donde se quiere planificar.  Utilizar los identificadores.
  • target_espacio_id: listado de espacios, separados por +, donde se quiere planificar.  Utilizar los identificadores.
  • intervalo_activacion:1
                                          - fecha_inicio / fecha_fin

Parámetros opcionales (idem para Pauta):
  • target_country: Segmentación por país. Listado de códigos ISO-3166 de países separados por espacio  (ej: “US CA MX”)
  • max_acciones: Frecuencia de usuarios. Opciones:
max_acciones_hora
max_acciones_dia       
max_acciones_semana
max_acciones_mes
max_impresiones_sesion
max_impresiones_usuario
  •  intervalo_sesiones
    		sin_fecha_fin
    		hora_inicio
    		hora_fin
    		fecha_inicio_0
    		fecha_fin_0
    		fecha_inicio_1
    		fecha_fin_1
    		fecha_inicio_2
    		fecha_fin_2
    		fecha_inicio_3
    		fecha_fin_3
    		fecha_inicio_4
    		fecha_fin_4
    		fecha_inicio_5
    		fecha_fin_5
    		fecha_inicio_6
    		fecha_fin_6
    		fecha_inicio_7
    		fecha_fin_7
    		fecha_inicio_8
    		fecha_fin_8
    		fecha_inicio_9
    		fecha_fin_9

 

Ejemplo de URLs con parámetros:
/admin/jsapi/espacio?op=i&ejecutar=1&tipoventa_id=1&cantidad_total=1000&prioridad=1&ajuste=0&base_de_estimacion=0&target_sitio_id=15892+16147+16150+43700+43707+47484+252210+672594+1318483+1520549&target_espacio_id=12394+12395+12430&intervalo_activacion=1&fecha_inicio=02/12/2016+00:00:00&fecha_fin=25/12/2016+00:00:00

Respuesta:

Primer llamada: (la planificación aún se está ejecutando)

/admin/jsapi/espacio?op=i&ejecutar=1
Ejemplo de respuesta
{"planificacion_id":"13509"}





Segunda llamada: (la planificación ya finalizó)

/admin/jsapi/espacio?op=i&ejecutar=1&planificacion_id=13509


Ejemplo de respuesta
{
 "planificacion_id":"13509",
"estado":"En Proceso"
"progreso":"50%", }










Resultado:
{
	   "planificacion_id":"13509",
	   "estado":"Finalizada"
	   "progreso":"100%",
	   "planificacion_resultado":{
	      "descripcion":"Stock limitado, no hay garantia de disponibilidad",
	      "tipo_cantidad":"Impresiones",
	      "cantidad_requerida":"1.000"
	      "cantidad_vendida":"500",
	      "cantidad_disponible":"1.000",
	      "cantidad_reservada":"300",
	      "detalle_por_dia":[
	         {
	            "fecha":"02/12/2016",
	            "cantidad_vendida":"500",
	            "cantidad_disponible":"1.000"
	            "cantidad_reservada":"300",
	            "porcentaje_vendido":"27,78%",
	            "porcentaje_disponible":"55,56%",
	            "porcentaje_reservado":"16,67%",
	         }
	      ],
	      "detalle_por_hora":[
	         {
	            "fecha":"02/12/2016 15:00:00",
	            "cantidad_vendida":"500",
	            "cantidad_disponible":"1.000"
	            "cantidad_reservada":"300",
	            "porcentaje_vendido":"27,78%",
	            "porcentaje_disponible":"55,56%",
	            "porcentaje_reservado":"16,67%",
	         }
      	],
	      "pautas_en_conflicto":[
	         "43247"
	      ],
	   },
	}


(0 votes)
This article was helpful
This article was not helpful