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

Los permisos 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 puede 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 de anunciantes independientes en el mismo sitio de forma distinta. También facilita el seguimiento de varias campañas o productos en un solo banner publicitario.

Los ámbitos de atribución son campos opcionales que se pueden configurar durante el registro de la fuente y el activador. Durante la atribución, solo se considerará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 permisos 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 informes, pero con un límite menor.
• values: Representa la lista de los diferentes tipos de alcance de la atribución para 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 la API planea usar en todos los registros posteriores de fuentes de eventos. Ten en cuenta que se borrarán todas las fuentes registradas existentes con el mismo origen y destino de informes, pero con un max_event_states value diferente. El valor predeterminado de este campo opcional es 3.

Muestra de registro de fuente

  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 attribution_scopes contenga al menos uno de los attribution_scopes del activador, si se especifica.

Muestra de registro de activación

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

Ejemplo de ámbitos de atribución

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

Registro de origen núm. 1

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

Registro de origen núm. 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 considerarán para la atribución y que tienen valores de attribution_scopes que se cruzan con los valores del registro del activador. Los registros de la fuente coincidente 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 atribuye el registro del activador al primer registro de la fuente.

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

Si bien la funcionalidad de los filtros y los alcances de atribución puede parecer similar, el factor distintivo es dónde se aplican en el flujo de registro del activador. El filtrado de los ámbitos de atribución se realiza antes de la atribución. Esto significa que reduce el grupo de fuentes candidatas no vencidas que tienen el mismo sitio de destino y el mismo origen de informes, según las fuentes que tienen 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 un activador se atribuye a una sola fuente. Si los filtros de fuente y de activador no se intersecan, 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 y origen del informe, y que no vencieron. Hablaremos brevemente sobre cómo se usan los filtros y los alcances de atribución, y si se generará un informe en función de las fuentes y los activadores disponibles.

Antes de la atribución

• La fuente 1 se filtra porque su alcance de atribución no coincide con el alcance del activador de casualwear. Tener la prioridad más alta entre todas las fuentes disponibles no impide que se filtre, ya que el filtrado previo a la atribución se produce 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úm. 4, ya que tiene un alcance de atribución coincidente con el activador y la prioridad más alta. Los filtros de alto nivel se aplican después de la atribución, por lo que no se tienen en cuenta durante el proceso de atribución.

Atribución de la publicación

• No se genera ningún informe, ya que los filtros de nivel superior para la fuente seleccionada (fuente núm. 4) y el activador no se intersecan.

En el ejemplo anterior, no se genera un informe. Sin embargo, si se quita la cuarta fuente por completo, sucede lo siguiente:

Durante la atribución

• Se selecciona la fuente núm. 3, ya que tiene un alcance de atribución que se cruza con el del activador.

Atribución de la publicación

• 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 de atribución de la publicación y, si supera todas las verificaciones, 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.

Lugar 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 la ventana del informe personalizado. En el siguiente diagrama, se muestra una versión simplificada del flujo de atribución general, en la que el alcance de la atribución se produce antes de la atribución y del resto de las verificaciones de atribución.

Operaciones de flujo de atribución

A continuación, se muestra un resumen de las distintas 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 informes, que responde con un encabezado que contiene datos del evento fuente.
• Registro del activador: Cuando se produce una conversión en el sitio del anunciante, se registra un evento de activador. El dispositivo envía otra solicitud al origen de informes, que responde con un encabezado que contiene datos del evento de activación.
• Coincidencia de la fuente: El dispositivo hace coincidir los eventos de fuente y de activación según criterios como el sitio de destino, el origen del informe y el vencimiento.
• Verificación de los alcances de atribución: Las fuentes se filtran según la intersección entre los valores de attribution_scopes de la fuente y el activador.
• Atribución: El dispositivo selecciona la fuente de mayor prioridad 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 origen y de activación para determinar si coinciden. Si los filtros no coinciden, se descarta la atribución.
• Desactivación de otras fuentes: Si coinciden los filtros de la fuente elegida, el dispositivo desactiva las fuentes que coincidieron durante la etapa de coincidencia de fuentes. Las fuentes desactivadas incluirán aquellas cuyos alcances de atribución no coincidan con los alcances de activación.
• Verificaciones posteriores a la atribución: El dispositivo realiza más verificaciones sobre la atribución seleccionada, como verificar si la fuente se distorsionó con informes falsos, verificar si hay atribuciones duplicadas con claves de eliminación de duplicados, verificar si el activador se encuentra dentro del período de informes de la fuente y verificar los límites de frecuencia.
• Generación de informes: Si todas las verificaciones se realizan correctamente, el dispositivo genera y programa un informe de atribución para que se envíe al extremo del origen del informe.

Próximos pasos

• Obtén más información sobre los alcances de atribución en la explicación de GitHub sobre el filtrado previo a la atribución.
• Obtén más información sobre los filtros en Cómo definir reglas del cliente con filtros.