Este documento explica cómo registrar impresiones y clics mediante las API de Epsilon Retail Media, con pasos para la integración y una validación mejorada del ID de anuncio.
Para registrar de forma eficaz las impresiones y los clics, utilice /resource/ el endpoint. Las impresiones deben dirigirse al first-i recurso, mientras que los clics se notifican al second-c recurso.
Requisito
Consulte a su administrador técnico de cuentas para obtener la URL base antes de registrar impresiones y clics.
Integración de llamadas a endpoints
Las llamadas a endpoints deben ejecutarse dentro de su aplicación o sitio web. En Epsilon Retail Media, el proceso de integración es similar tanto para las aplicaciones móviles como para los sitios web debido a su enfoque de integración de backend a backend. Este enfoque garantiza que las solicitudes de anuncios sean coherentes tanto en las plataformas de escritorio como en las móviles. Sin embargo, dado que las aplicaciones móviles no admiten bibliotecas JS, debe realizar solicitudes de backend a nuestros endpoints de clic e impresión.
Información de impresiones
Para registrar una impresión, envíe una solicitud GET con el siguiente formato:
https://$BASE_URL.citrusad.com/v1/resource/first-i/AD_ID
Reemplazar AD_ID con el adId proporcionado para el anuncio que está registrando.
Por ejemplo, la siguiente solicitud GET registra una impresión para el adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
Información de clics
Para registrar un clic, debe enviar una solicitud GET en el formato que se indica a continuación:
https://$BASE_URL.citrusad.com/v1/resource/second-c/AD_ID
Reemplazar AD_ID con el adId proporcionado para el anuncio que está registrando.
Por ejemplo, la siguiente solicitud GET registra una impresión para el adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
Validación de API para ID de anuncios realizados
La API incluye la validación de los ID de anuncios para garantizar la precisión de los datos y reducir los errores. Las solicitudes con identificadores de anuncios codificados o con prefijos incorrectos devuelven un error 400 y un mensaje de error detallado.
Ventajas clave
- Resolución de problemas más rápida: Una respuesta rápida ayuda a los minoristas a solucionar los problemas con mayor rapidez.
- Más precisión: La reducción de errores permite obtener informes y datos más precisos.
Mensaje de error de ejemplo
"ID de anuncio no válido. Debe estar codificado correctamente y llevar como prefijo 'display', 'banner' o 'shotgun_'."