Aquí te indicamos dónde comenzar, incluida la configuración y una breve descripción general.
Elige un tipo de informe
Con la API de Attribution Reporting, puedes generar dos tipos de informes: informes a nivel del evento y resumidos. Los informes a nivel del evento requieren menos configuración que los informes agregables o de resumen, por lo que pueden ser un buen punto de partida. Los informes de resumen requieren integración con el servicio de agregación; los informes a nivel del evento no.
Puedes configurar informes para los informes a nivel del evento y de resumen. Son complementarias.
Informes a nivel del evento
Los informes a nivel del evento asocian una vista o un clic específico en el anuncio (en el lado del anuncio) con los datos de la conversión. Para preservar la privacidad del usuario mediante la limitación de la identificación de identidades del usuario en diferentes sitios, los datos orientados a las conversiones son muy limitados y los datos son ruidosos.
Resumen de informes
Un informe de resumen es un tipo de informe de la API de Attribution Reporting y de la API de Private Aggregate. Un informe de resumen incluye datos agregados del usuario y puede contener datos de conversiones detallados, a los que se agregue ruido. Los informes de resumen se componen de informes agregados.
Implementación
Para comenzar, sigue los pasos que se indican a continuación.
Ten en cuenta que, para una fuente de evento determinada, es posible generar un informe a nivel del evento y un informe agregable. La demostración te guiará a través del proceso.
Generación de informes a nivel del evento
Estos son los pasos mínimos que debes seguir para generar informes a nivel del evento:
Registra una fuente. Consulta Registra fuentes de atribución para obtener instrucciones. Ten en cuenta que los pasos son diferentes para los clics y las vistas.
Registra un activador. Consulta Registra activadores de atribución para obtener las instrucciones.
Configura un extremo con la siguiente URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
Consulta el código de ejemplo en adtech.js para ver el métodopost
. Aquí puedes obtener más información sobre .well-known.
Obtén más detalles sobre los informes a nivel del evento aquí.
Generación de informes de resumen
Para generar informes de resumen, sigue estos pasos de alto nivel:
Registra una fuente. Consulta Registra fuentes de atribución para obtener instrucciones. Ten en cuenta que los pasos son diferentes para los clics y las vistas. Puedes encontrar detalles adicionales en Registro de la fuente de atribución.
Registra un activador. Consulta Registra activadores de atribución para obtener las instrucciones.
Configura un extremo para informes agregables con la siguiente URL:
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
Consulta el código de ejemplo en adtech.js para ver el métodopost
. Aquí puedes obtener más información sobre .well-known.Agrupa y envía los informes por lotes para que el servicio de agregación produzca informes de resumen para su procesamiento posterior. Consulta los informes agregables por lotes.
Obtén más detalles sobre los informes de resumen aquí.
Obtén información para configurar informes de depuración en la serie de depuración de informes de atribución.
Conceptos adicionales de los informes de resumen
Además de comprender los pasos de implementación que se indican aquí, los siguientes conceptos te ayudarán a planificar tu estrategia de informes de resumen:
Pasos opcionales
- Configura filtros (opcional):
- Sigue las instrucciones que se indican en Define reglas personalizadas con filtros.
- Revisa los detalles específicos de los filtros de informes agregables en la sección de activadores de la explicación.
No olvides la detección de funciones
Antes de usar la API, detecta si no se ha bloqueado en la página mediante una política de permisos. Para ello, ejecuta el siguiente código:
if (document.featurePolicy.allowsFeature('attribution-reporting')) {
// the Attribution Reporting API is enabled
}
Si esta verificación de detección de funciones muestra el valor true, se permite la API en el contexto (página) en el que se ejecuta la verificación.
Ten en cuenta que esta comprobación por sí sola no garantiza que la API se pueda usar en esa página; es posible que el usuario haya inhabilitado la API mediante la configuración de su navegador o que tenga otras configuraciones que impidan que se use la API. Para proteger la privacidad del usuario, no hay forma de verificar esto de forma programática.
Próximos pasos
Si tienes todo listo para comenzar la implementación, consulta estos documentos:
Configuración
- Registra una fuente de atribución
- Registra un activador de atribución
- Cómo priorizar clics, vistas o conversiones específicos
- Cómo depurar Attribution Reporting
- Claves de agregación
Información general
- Informes de atribución con informes a nivel del evento
- Informes de atribución con informes agregables
- Restricciones de los datos de los informes de agregación
- Información sobre el ruido
- Cómo trabajar con ruido
Demostraciones y herramientas
- Demostración de la API de Attribution Reporting
- Laboratorio de ruido
- Validador de encabezados de Attribution Reporting
Planificación
Si todavía te encuentras en la etapa de planificación, echa un vistazo a estos documentos: