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 el endpoint /resource/. Las impresiones deben dirigirse al recurso first-i , mientras que los clics deben comunicarse al recurso second-c .
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_IDSustituya AD_ID por el adId proporcionado para el anuncio que está registrando.
Por ejemplo, la siguiente solicitud GET informa de una impresión para el adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdTInformació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_IDSustituya AD_ID por el adId proporcionado para el anuncio que está registrando.
Por ejemplo, la siguiente solicitud GET informa de una impresión para el adId, display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT.
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdTValidació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
"Invalid ad ID. Must be properly encoded and prefixed with 'display_', 'banner_', or 'shotgun_'."