La ficha de una oferta: integración, requisitos, horario y material

Para qué sirve

Reúne lo que necesitas para trabajar una campaña concreta: lo que te paga, cómo enviarle leads por la API, qué datos tiene que traer cada lead, en qué horario los recibe, por qué canales puedes promocionarla y el material aprobado.

Quién puede usarlo

Tú, con tu sesión del portal, en las campañas que la red te ha asignado. Si la campaña deja de estar asignada a tu cuenta, al intentar abrirla vuelves a la lista de ofertas sin ningún mensaje.

Paso a paso

1. En Ofertas (Offers), pulsa Ver Oferta → en la campaña. Arriba ves su nombre, su país, Campaña ID: #… y, a la derecha, tu Payout con el modelo de pago de la campaña (por ejemplo, /CPL).
2. Mira Integración Técnica: la dirección a la que se envían los leads, https://app.affiliatracker.com/api/lead, por POST con JSON, y un Ejemplo de Request (①) con tu token y el número de esta campaña.

   

3. Para todo el detalle, Ver documentación completa de la API (②) abre tu guía en otra pestaña.
4. Lee Requisitos del lead: lo que esta campaña pide además de lo obligatorio, la regla de duplicados y, si lo tiene, el horario.

   

5. A la derecha, Reglas de Tráfico te dice por qué canales puedes promocionarla: en verde los permitidos y en rojo los que no.

   

6. Si la red ha subido material, lo descargas en Creatividades (Assets) con Descargar. Si la campaña tiene asuntos o remitentes aprobados para correo, salen en la tarjeta amarilla Asuntos Aprobados.

El ejemplo de petición

No lo copies tal cual. Es el mismo en todas las campañas y le faltan dos datos obligatorios, country_lead e id_source: enviado así, la API lo rechaza con «The country format is incorrect.». Tampoco incluye lo que pide cada campaña. Un ejemplo que sí sirve, con datos ficticios:

{
  "token_affiliate": "TU_TOKEN",
  "id_campaign": 1,
  "id_source": 1,
  "email_lead": "ana.martin@ejemplo.test",
  "country_lead": "ES",
  "ip_lead": "203.0.113.45",
  "name_lead": "Ana",
  "phone_lead": "+34600000001",
  "custom_data": {
    "tipo_vivienda": "Piso"
  }
}

Pon el número de tu campaña en id_campaign (el de Campaña ID: #…), en id_source la fuente que te indique tu red (si no te dice nada, 1) y en custom_data las preguntas que pida la campaña en Requisitos del lead; tipo_vivienda es sólo un ejemplo. Todos los parámetros, en API de leads: enviar un lead (referencia).

Cómo leer los requisitos

• La frase Además de los parámetros obligatorios de la API (email, país, IP, token y fuente), esta campaña pide: va seguida de una línea por dato: su nombre técnico (name_lead, custom_data.tipo_vivienda…), qué es, la regla que tiene que cumplir y una etiqueta.
  • Obligatorio: si falta o no cumple la regla, el lead se rechaza.
  • Si lo mandas: es opcional, pero si lo mandas tiene que cumplirla.
• Nada más. quiere decir que la campaña sólo pide lo obligatorio de la API.
• Duplicados: dice cuándo se rechaza un lead por repetido: con el mismo email o teléfono que otro ya enviado a esta campaña, y a veces sólo en los últimos días o contando sólo los que el anunciante aceptó.
• Horario de recepción, si la campaña lo tiene: los días y horas en que recibe, en la hora de su zona, y los días sin recepción que vengan. Fuera de ese horario el lead se rechaza con outside_schedule y la hora a la que vuelve a abrir, para que lo reenvíes entonces.

Un lead que no cumple se rechaza al llegar y no se guarda: corrígelo y reenvíalo. Qué te responde la API en cada caso: API de leads: mensajes y códigos de error. La misma información de todas tus campañas está en el apartado 5 de tu guía: API de leads: requisitos, duplicados y horario de cada campaña.

Lo que conviene saber

• El ejemplo lleva tu token de verdad. No compartas capturas de esta pantalla ni la enseñes en una pantalla compartida. Ver Tu guía de la API (API Docs).
• La dirección de la API es la misma en todas las campañas, también en las que la red entrega al anunciante por correo: tú siempre envías por la API.
• Las reglas de tráfico son un acuerdo con la red: la API no comprueba por qué canal llega cada lead. Si tienes dudas sobre un canal que no aparece en la lista, por ejemplo el telemarketing, pregunta a tu gestor.
• La ficha se abre aunque la campaña esté pausada, sin indicarlo. Si te rechaza todos los leads, pregunta a tu gestor.
• Lo que te paga cada lead y tu cupo están también en Tus ofertas. Esta ficha no enseña lo enviado ni el cupo.
• No hay un botón para probar el envío desde aquí.

Errores frecuentes

Relacionado

• Tus ofertas
• Tu guía de la API (API Docs)
• API de leads: enviar un lead (referencia)
• API de leads: requisitos, duplicados y horario de cada campaña
• API de leads: mensajes y códigos de error