Cómo filtrar fuentes antes de la atribución con alcances de atribución

Los alcances de atribución permiten que los llamadores de la API especifiquen una lista de cadenas durante el registro de la fuente y el activador que se pueden usar para filtrar antes de que se realice la atribución. Esto permite un filtrado más detallado para aumentar la eficiencia de la API y brindar más flexibilidad. Por ejemplo, permite hacer un seguimiento distinto de anunciantes independientes en el mismo sitio. También facilita el seguimiento de varias campañas o productos en un solo banner de anuncio.

Los alcances de atribución son campos opcionales que se pueden establecer durante el registro de la fuente y el activador. Durante la atribución, solo se considerarán para la atribución las fuentes cuyos valores de alcance de atribución contengan al menos uno de los valores de alcance de atribución del activador. Si no se especifica ningún alcance en el activador, se considerarán todas las fuentes. Antes de continuar, debes familiarizarte con la API de Attribution Reporting y los filtros de alto nivel.

Durante el registro de la fuente

Se agrega un parámetro opcional attribution_scopes al encabezado Attribution-Reporting-Register-Source, que contiene dos parámetros obligatorios: values y limit, y un parámetro opcional: max_event_states.

  • limit: Representa la cantidad total de alcances distintos permitidos por destino para el origen de informes de la fuente. Se borrarán todas las fuentes registradas existentes con el mismo origen y destino de los informes, pero con un límite menor.
  • values: Representa la lista de alcances de atribución de una fuente en particular. Estos valores deben ser cadenas con una longitud máxima de 50.
  • max_event_states (opcional): Representa la cantidad máxima de estados de eventos que un llamador de API planea usar en todos los registros de fuentes de eventos posteriores. Ten en cuenta que se borrarán todas las fuentes registradas existentes con el mismo origen y destino de los informes, pero con un max_event_states value diferente. El valor predeterminado de este campo opcional es 3.

Ejemplo de registro de fuentes

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

Durante el registro del activador

Se agrega un parámetro opcional attribution_scopes al encabezado Attribution-Reporting-Register-Trigger durante el registro del activador. Asegúrate de que el valor del parámetro sea una lista de cadenas que representen los alcances del activador. El activador solo coincidirá con las fuentes cuyo parámetro de valores de attribution_scopes contenga al menos uno de los attribution_scopes del activador, si se especifica.

Ejemplo de registro de activador

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

Ejemplo de alcances de atribución

En el siguiente ejemplo, se muestra el caso en el que un activador se atribuye a una fuente mientras se usan alcances de atribución.

Registro de la fuente n° 1

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

Registro de la fuente n° 2

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

Registro de activación

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

Cuando se produce el registro del activador, la API selecciona las fuentes que se deben considerar para la atribución que tienen valores de attribution_scopes que se cruzan con los valores del registro del activador. Los registros de fuentes coincidentes continuarán con el resto del flujo de atribución. En este ejemplo, el llamador de la API recibirá un informe de atribución que atribuirá el registro del activador al primer registro de fuente.

Comparación entre los alcances de atribución y los filtros

Si bien la funcionalidad de los alcances y los filtros de atribución puede parecer similar, el factor distintivo es dónde se aplican en el flujo de registro del activador. El filtrado de alcances de atribución ocurre antes de la atribución. Esto significa que reduce el grupo de fuentes candidatas sin vencer que tienen el mismo sitio de destino y el mismo origen de informes, según qué fuentes tengan alcances que se cruzan con los alcances que se encuentran en el activador. Sin embargo, los filtros de nivel superior se aplican después de que se atribuye un activador a una sola fuente. Si los filtros de fuente y activador no se cruzan, no se generarán informes.

En la siguiente imagen, se muestra un grupo de fuentes y un activador que tienen el mismo sitio de destino, el mismo origen de informes y no están vencidos. Hablaremos brevemente sobre cómo se usan los alcances y los filtros de atribución, y si se generará un informe en función de las fuentes y los activadores disponibles.

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="An image showing 4 boxes labelled sources numbered 1 through 4 and a single box labelled " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="Example on how attribution works with attribution scopes and filters" trigger="" />

Antes de la atribución

  • La fuente 1 se filtra porque su alcance de atribución no coincide con el alcance de casualwear del activador. Tener la prioridad más alta entre todas las fuentes disponibles no evita que se filtre, ya que el filtrado previo a la atribución se realiza antes de que se verifiquen las prioridades.
  • La fuente 2 también se filtra porque no tiene el mismo alcance que el activador. Esta fuente también tiene el mismo filtro que el activador, pero los filtros de alto nivel no se aplican hasta después de la atribución.

Durante la atribución

  • La fuente 3 no se selecciona para la atribución, ya que tiene una prioridad más baja que la fuente 4.
  • Se selecciona la fuente n.° 4 porque tiene un alcance de atribución coincidente con el activador y tiene la prioridad más alta. Los filtros de alto nivel se aplican después de la atribución para que no se tengan en cuenta durante el proceso de atribución.

Atribución posterior

  • No se genera ningún informe, ya que los filtros de alto nivel de la fuente seleccionada (fuente n° 4) y el activador no se cruzan.

El ejemplo anterior no genera un informe. Sin embargo, si se quita por completo la cuarta fuente, ocurrirá lo siguiente:

La misma imagen con 4 cuadros etiquetados como fuentes numeradas del 1 al 4 y un solo cuadro etiquetado

Durante la atribución

  • Se selecciona la fuente 3 porque tiene un alcance de atribución que se superpone con el activador.

Atribución posterior

  • La fuente 3 no se rechaza porque su filtro se cruza con el filtro del activador. Luego, la atribución pasará por el resto de las verificaciones posteriores a la atribución y, si aprueba todas, se generará un informe.

Los alcances de atribución reducen la cantidad de fuentes que se consideran para la atribución. Luego, los pasos de atribución restantes se aplican a este grupo más pequeño de fuentes, lo que puede generar un informe.

Ubicación de los alcances de atribución en el flujo de atribución

Los alcances de atribución se aplican antes de que se seleccione una fuente para la atribución. Esto también precede a los filtros de nivel superior y al filtrado de ventanas de informes personalizados. En el siguiente diagrama, se muestra una versión simplificada del flujo de atribución general, en el que el alcance de la atribución se produce antes de la atribución y el resto de las verificaciones de atribución.

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="An image showing a simplified version of the attribution flow with each step represented as a square linked to the next step by a arrow. Los pasos en orden son " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Simplified attribution flow diagram" />

Operaciones del flujo de atribución

A continuación, se muestra un resumen de las diversas operaciones que se realizan durante el flujo de atribución:

  • Registro de la fuente: Cuando un usuario interactúa con un anuncio en el sitio del anunciante, se registra un evento de fuente. Luego, el dispositivo envía una solicitud al extremo del origen de los informes, que responde con un encabezado que contiene datos del evento de origen.
  • Registro del activador: Cuando se produce una conversión en el sitio del anunciante, se registra un evento activador. El dispositivo envía otra solicitud al origen de informes, que responde con un encabezado que contiene datos del evento activador.
  • Coincidencia de fuentes: El dispositivo hace coincidir la fuente y activa los eventos en función de criterios como el sitio de destino, el origen de los informes y el vencimiento.
  • Verificación de los alcances de atribución: Las fuentes se filtran en función de la intersección entre los valores de attribution_scopes de la fuente y del activador.
  • Atribución: El dispositivo selecciona la fuente de prioridad más alta para la atribución si coinciden varias fuentes. Si las prioridades son iguales, se selecciona la más reciente.
  • Verificación de filtros: El dispositivo compara los filtros de la fuente y del activador para determinar si coinciden. Si los filtros no coinciden, se descarta la atribución.
  • Desactivación de otras fuentes: Si los filtros de la fuente elegida coinciden, el dispositivo desactiva las fuentes que coinciden durante la etapa de coincidencia de fuentes. Las fuentes que se desactivarán incluirán aquellas cuyos alcances de atribución no coincidan con los alcances de los activadores.
  • Verificaciones posteriores a la atribución: El dispositivo realiza más verificaciones en la atribución seleccionada, como verificar si la fuente tiene ruido con informes falsos, verificar las atribuciones duplicadas con claves de anulación de duplicación, verificar si el activador se encuentra dentro del período del informe de la fuente y verificar los límites de frecuencia.
  • Generación de informes: Si se aprueban todas las verificaciones, el dispositivo genera y programa un informe de atribución para que se envíe al extremo del origen de informes.

Próximos pasos