Cómo se decide si el anunciante aceptó el lead (Mapeo de Respuestas)

Para qué sirve

Una venta suma en los topes de la asignación, avisa al afiliado y es lo que se cobra al anunciante y se paga al afiliado. Por eso importa que sólo cuente como venta lo que el anunciante ha aceptado de verdad. Cada anunciante contesta a su manera; aquí le dices a la plataforma qué respuesta significa «aceptado».

Quién puede usarlo

Necesitas Permitido en Gestionar (Editar / Operar), en la fila Campañas de Affiliate Cloud del panel de permisos. Si no lo tienes, pídeselo a un administrador de tu cuenta. Para ver qué contestó el anunciante a cada lead hace falta además poder abrir el Directorio de Leads: Directorio de Leads: buscar, filtrar e inspeccionar la entrega.

Dónde se configura

En la ficha de la campaña, pestaña Integración, con Host & Post (API): el bloque Mapeo de Respuestas (Validación S2S), debajo de las reglas de transformación. Se guarda con Guardar Cambios.

La caja ① lleva un JSON; debajo, la pantalla explica la regla «presente» ② y qué pasa si la dejas en blanco ③.

Las claves del JSON

Tres formas habituales:

{ "success_key": "result", "success_value": "OK", "error_message_key": "message" }

{ "success_key": "contactId", "success_rule": "presente", "error_message_key": "message" }

{ "success_key": "status", "success_value": "ok", "estricto": true, "error_message_key": "error" }

Cómo se decide

De más estricta a más permisiva:

1. Modo estricto o regla «presente». Sólo es venta una respuesta correcta (HTTP 2xx), en JSON, que trae la clave con un valor simple: el de success_value o, con «presente», cualquiera que no esté vacío. 0 cuenta; false, vacío o null, no. Todo lo demás es rechazo, y no se siguen redirecciones.
2. Mapeo sin estricto, y la respuesta trae la clave. Venta si el valor coincide con success_value y la respuesta no es un error HTTP. Si no coincide, rechazo.
3. Reglas estándar: sin mapeo, o con mapeo pero sin la clave en la respuesta. Venta si el JSON trae "error": false, "status": "success" (sin importar mayúsculas) o un "Message" que contenga exitoso.
4. La respuesta no es JSON. Venta si no es una página web y contiene success o true en cualquier parte, sin importar mayúsculas: también unsuccessful.

En las cuatro, un 4xx o un 5xx nunca es venta, traiga lo que traiga, y una respuesta vacía tampoco.

Verdadero/falso y números

success_value se compara como texto:

• con números da igual poner comillas: 1 acepta 1 y "1";
• con verdadero/falso no: si el anunciante responde {"estado": true}, escribe "success_value": true sin comillas. Con comillas, el lead aceptado quedaría como rechazo.

Lo que recibe el afiliado

• Venta: success, con Lead successfully registered.
• Rechazo: rejected_by_advertiser, con Lead rejected by the advertiser: y el motivo, o sólo Lead rejected by the advertiser. si no hay motivo. Sale de error_message_key o, con las reglas estándar, de message (o Message). Antes de enviarlo se quitan el HTML, las direcciones web, los correos y los números largos, como un teléfono, y se corta a 200 caracteres.

Con OAuth2, un 401 o un 403 del anunciante no llega como rechazo sino como campaign_not_ready: Autenticación OAuth2 de la entrega por API. Los demás códigos de la API, en API de leads: mensajes y códigos de error. Lo que pasa con cada lead al enviarlo (tiempo de espera, sin reintentos, cuándo es advertiser_unreachable), en Entregar los leads por API (Host & Post).

Lo que conviene saber

• Sin mapeo, o con mapeo y sin estricto, se aceptan respuestas que no son una venta. Una respuesta sin la clave del mapeo cae en las reglas estándar: {"status":"success"} es venta aunque esperaras result. Si el anunciante sólo factura una respuesta concreta, usa "estricto": true o «presente».
• Un JSON mal escrito se guarda vacío, sin aviso, y la campaña pasa a las reglas estándar. Comprueba la caja después de guardar.
• Un rechazo ya está guardado. Si el afiliado reenvía el mismo contacto, cuenta como duplicado, salvo lo que diga la casilla de los aceptados en Requisitos del lead de una campaña: qué se exige y qué se rechaza.
• La caja se conserva aunque cambies la campaña a correo o píxel.
• La misma lectura vale cuando la campaña sirve de conector a un comprador de Lead Gen.
• Para ver qué contestó el anunciante, abre el Log del lead en el Directorio de Leads: enseña lo enviado y lo respondido, con los datos personales tapados.

Lo que no hace

• No lee claves anidadas ni listas.
• No admite varios valores de éxito: uno solo.
• No mira el código HTTP para aceptar, salvo exigir 2xx en modo estricto o con OAuth2, y que un 4xx o 5xx nunca sea venta.
• No reintenta un rechazo.

Errores frecuentes

Relacionado

• Entregar los leads por API (Host & Post)
• Enviar un lead de prueba desde la ficha de la campaña
• Directorio de Leads: buscar, filtrar e inspeccionar la entrega
• API de leads: mensajes y códigos de error
• Ficha de campaña: las cuatro pestañas