Table of contents
Criteo Resellers Program API V2 - Guía de referencia completa
Conceptos
Los siguientes conceptos se utilizan en la API del programa de revendedores de Criteo
- Presupuesto : un presupuesto limita el gasto de un vendedor en una o más campañas. Tiene una cantidad inicial, así como una cantidad gastada. También tiene una fecha de inicio y finalización. Los clics en un anuncio vendido a través de una campaña de vendedor se facturan con el presupuesto asociado de acuerdo con la tarifa negociada. Un presupuesto puede ser consumido por varias campañas de vendedores siempre que pertenezcan al mismo vendedor.
- Campaña : una campaña es un curso de acción para promocionar productos de sus vendedores.
- Anunciante : el anunciante es la entidad que anuncia en nombre del Vendedor. Por lo general, el anunciante es un mercado que utiliza la solución CRP para monetizar el presupuesto publicitario del vendedor. Alias: Mercado
- Vendedor : un vendedor que vende productos en su mercado. Un vendedor se beneficia de una campaña al obtener una mayor exposición de los productos en Internet a través de la plataforma Criteo. Sin embargo, un Vendedor no interactúa financieramente con Criteo.
- Campaña del vendedor : una campaña del vendedor es un recurso que encapsula las reglas comerciales acordadas por el vendedor para usar en una campaña específica. Por ejemplo, contiene la oferta máxima que el vendedor está dispuesto a realizar en alguna campaña. Las diferentes plataformas (web vs móvil) suelen tener diferentes campañas.
Los recursos expuestos en esta API son los siguientes:
- Anunciantes (anunciantes)
- Vendedor (vendedores)
- Campaña de vendedor (vendedor-campañas)
- presupuesto (presupuestos)
Además, también se hace referencia al recurso de la campaña v1 (/marketing/v1/campaigns) desde la API.
Cada uno de estos recursos tiene identificadores únicos a nivel mundial, excepto para la campaña del vendedor, para la cual el ID de vendedor y el ID de campaña sirven como identificador único.
El recurso del vendedor está asociado con un anunciante y también tiene un nombre único en ese contexto.
Diseño
El diseño del esquema v2 se basa en el siguiente diagrama de relaciones para los recursos más importantes.
Tenga en cuenta que cada campaña de vendedor utiliza una clave principal compuesta que consta de un solo vendedor y una sola campaña. Se puede asociar a múltiples recursos de Budget. Un presupuesto puede ser consumido por varias campañas de vendedores siempre que pertenezcan al mismo vendedor. Sin embargo, las reglas comerciales estipulan que hay como máximo un presupuesto diario actual y un presupuesto no diario actual. Se puede configurar un presupuesto diario sin un presupuesto no diario detrás, pero un presupuesto diario por sí solo no es suficiente para activar una campaña de vendedor y comenzar a publicar anuncios; se requiere un presupuesto no diario (también conocido como "total").
Puntos finales de la API
- Este documento de diseño describe los servicios que se encuentran en la siguiente raíz de servicio: https://api.criteo.com/marketing/v2/crp
- Una descripción swagger de la API estará disponible aquí: https://api.criteo.com/marketing/swagger
Esta raíz de servicio se utilizará exclusivamente para el dominio del Programa de revendedores. En el pasado, el Programa de revendedores formaba parte de la raíz del servicio https://api.criteo.com/marketing/v1/ en el segmento de ruta URI de vendedores.
El resto de esta sección está organizado por dirección URI. Hay cuatro subsecciones principales:
- anunciantes
- vendedores (vendedores)
- Campañas de vendedores (campañas de vendedores)
- Presupuestos (presupuestos)
Cada subsección comienza con una tabla de puntos finales admitidos.