Comienza a usar Attribution Reporting

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:

  1. 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.

  2. Registra un activador. Consulta Registra activadores de atribución para obtener las instrucciones.

  3. 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étodo post. 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:

  1. 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.

  2. Registra un activador. Consulta Registra activadores de atribución para obtener las instrucciones.

  3. 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étodo post. Aquí puedes obtener más información sobre .well-known.

  4. 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

  1. Configura filtros (opcional):
    1. Sigue las instrucciones que se indican en Define reglas personalizadas con filtros.
    2. 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

Información general

Demostraciones y herramientas

Planificación

Si todavía te encuentras en la etapa de planificación, echa un vistazo a estos documentos: