[Beta] API Server-to-Server (S2S) para atribución web

{"user_id":{"customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_name":"af_purchase","event_revenue":49.99,"event_revenue_currency":"USD","event_value":{"af_content_id":"SKU-001","af_quantity":2,"custom_parameters":{"promo_code":"SUMMER10"}},"event_url":"https://example.com/checkout/success","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ...","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

{"user_id":{"appsflyer_id":"1234567890abcdef","customer_user_id":"15667737-366d-4994-ac8b-653fe6b2be4a"},"event_url":"https://example.com/products/sneakers","timestamp":1712000000000,"ip":"35.244.183.10","user_agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) ...","http_referrer":"https://www.google.com/","email_hashed":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"}

Una visita conlleva los parámetros de atribución en los que se basa cada evento posterior, y el sistema espera una visita antes de cualquier evento por parte de un usuario. Si envías un evento antes de una visita, el sistema lo clasifica como orgánico.

Como no hay un Web SDK que establezca la cookie afUserId por ti, debes asignarla y gestionarla tú mismo como una cookie HTTP configurada en el encabezado de respuesta Set-Cookie, no como una cookie del lado del cliente creada con JavaScript.

Por qué es importante: una cookie del lado del cliente (establecida a través de document.cookie) caduca rápidamente, en tan solo 7 días en Safari o en 24 horas en dominios bajo ITP. Una vez que caduca, el identificador se restablece y un visitante recurrente aparece como nuevo. Una cookie que establece su servidor no está sujeta a ese límite y puede persistir hasta el máximo permitido por el navegador (Chrome permite hasta 400 días). También se puede marcar HttpOnly, por lo que los scripts de la página y los bloqueadores de anuncios no pueden leerlo ni eliminarlo, y no depende de ningún script en la página.

Para configurarlo y leerlo:

1. Ante la primera solicitud de un visitante sin cookies, genere un ID único y estable en su servidor (por ejemplo, un UUID).

2. Devuélvelo en una cookie de first-party:

   Set-Cookie: af_web_id=<generated-id>; Max-Age=34128000; Path=/; Secure; HttpOnly; SameSite=Lax

3. En todas las solicitudes posteriores, lee el valor del encabezado Cookie entrante y reutilízalo. No lo regeneres.
4. Envía ese valor a AppsFlyer en cada llamada como appsflyer_id dentro de la solicitud objeto user_id.

Puedes nombrar la cookie como quieras; AppsFlyer lee el valor que envías, no el nombre de la cookie. Asegúrate de configurarlo desde tu propio dominio de first-party.

Cada llamada requiere un objeto user_id con al menos uno de estos identificadores: appsflyer_id (el valor de la cookie) o customer_user_id (tu ID de usuario interno). Enviar ambos documentos, cuando se tienen, mejora la resolución de identidades.

Ten en cuenta: las visitas son mayoritariamente anónimas, así que envía siempre el valor de la cookie. En el caso de los eventos on-site, añade customer_user_id una vez que se identifique al usuario y sigue enviando la cookie junto con ese identificador. Para los eventos que no se originan en el navegador, basta con customer_user_id, siempre que AppsFlyer ya conozca a ese usuario gracias a una sesión identificada anterior.

El objeto user_id es obligatorio en cada solicitud. Se debe proporcionar al menos uno de los siguientes identificadores.

Los eventos y las visitas deben recibirse a más tardar a las 00:30 del siguiente día calendario, según la zona horaria de la aplicación. Los eventos tardíos se rigen por el tiempo de recepción del servidor.

Todos los campos de datos personales deben ser sometidos a un hash SHA256 antes de su envío. Normaliza el texto (minúsculas, recortado) antes de aplicar el cifrado (hash). Cada hash debe tener exactamente 64 caracteres hexadecimales (sin distinción entre mayúsculas y minúsculas).

• Patrón para todos los campos hash: ^[a-fA-F0-9]{64}$
• Números de teléfono que utilizan el campo phone_number_e164_hashed debe ajustarse al formato E.164 (por ejemplo,+14155552671 ) antes del hash.

• El parámetro afUserId es un identificador único que el SDK web establece cuando un usuario visita tu sitio por primera vez.
• Si necesitas afUserId, utiliza uno de los métodos que se indican a continuación.

Obtener afUserId del encabezado de la cookie HTTP

• El navegador del visitante envía afUserId en las solicitudes a tu sitio.
• Si es necesario, extráelo del encabezado de la cookie HTTP.

Ver afUserId en el navegador del visitante

• Consulta afUserId en el navegador del visitante para solucionar problemas y realizar tareas de depuración.
• Para que esté disponible, el visitante debe haber visitado al menos una vez una página que utilice el SDK web.
• La cookie que contiene afUserId es una cookie propia de tu dominio.
• El siguiente procedimiento se preparó con Chrome 81. Puede haber diferencias entre navegadores y sistemas operativos.

Para obtener el afUserId del navegador del visitante:

1. En el navegador, ve a tu sitio web.
2. Haz clic con el botón derecho y selecciona Inspeccionar. Se abre la ventana de herramientas para desarrolladores del navegador.
3. Ve a la pestaña (A) Aplicación.
4. En el menú lateral, (B) expande Cookies.
5. Selecciona tu sitio web. Si no aparece, actualiza el navegador.
6. En el (C) filtro, introduce afUserId. Se muestra el valor de afUserID.