Donner la priorité à des clics, vues ou conversions spécifiques

Configurez l'API pour qu'elle donne la priorité à des sources ou des déclencheurs spécifiques.

Prioriser des clics ou des vues spécifiques pour les rapports au niveau des événements ou les rapports agrégables

Les priorités côté source vous permettent de modifier le comportement par défaut de l'API Attribution Reporting. Par défaut, le modèle d'attribution est "Dernière interaction", ce qui signifie qu'une conversion est attribuée à l'événement source correspondant le plus récent. Vous pouvez ajuster ce comportement pour les rapports au niveau des événements et les rapports agrégables.

Pour modifier la priorité par défaut, ajoutez la clé priority à l'en-tête d'enregistrement de votre source.

Attribuez une priorité plus élevée aux sources que vous souhaitez privilégier. Plus la valeur est élevée, plus la priorité est élevée. Par exemple, un événement source avec une valeur priority de 2 est prioritaire par rapport à une source avec une valeur priority de 1.

Seul le rapport correspondant à l'événement source ayant la priorité la plus élevée est envoyé.

Exemple de code

Modifiez l'attribution pour sélectionner des sources moins récentes (premier clic) :

const currentTimestamp = Date.now();
const priority = -currentTimestamp;

res.set(
  "Attribution-Reporting-Register-Source",
  JSON.stringify({
    // … all usual fields for that header
    priority: `${priority}`
  })
);

Prioriser des conversions spécifiques pour les rapports au niveau des événements

Contrairement aux priorités côté source, la définition de priorités côté déclencheur n'est disponible que pour les rapports au niveau des événements.

Imaginons qu'un utilisateur clique sur une annonce et effectue quatre conversions : il accède à la page d'accueil du site de l'annonceur, puis à une page produit, s'inscrit à la newsletter et, enfin, effectue un achat.

Toutefois, en raison de la limite de trois rapports pour les clics, tous les rapports ultérieurs à l'inscription (troisième conversion) sont supprimés par défaut, y compris le rapport sur l'achat.

En revanche, vous pouvez configurer l'API de sorte à recevoir des rapports sur les conversions que vous jugez les plus importantes, comme le rapport sur les achats.

Pour ce faire, ajoutez la clé priority à votre en-tête d'enregistrement du déclencheur et définissez une priorité plus élevée pour les conversions que vous souhaitez privilégier.

Lorsqu'une attribution est déclenchée pour un événement source donné, si le nombre maximal d'attributions (trois pour les clics, une pour les vues) a été atteint pour cette source, le navigateur effectue les actions suivantes :

  • Comparez la priorité du nouveau rapport avec celles des rapports planifiés existants pour la même source.

  • Supprimez le rapport dont la priorité est la plus faible pour programmer le nouveau rapport. Si le nouveau rapport est celui dont la priorité est la plus faible, il est ignoré et vous ne le recevrez pas.

Si aucune priorité n'est définie, le navigateur revient à son comportement par défaut : toute conversion ayant lieu après la troisième conversion pour les clics ou la première conversion pour les vues est abandonnée.

Examinez l'exemple de code : prioriser les conversions de type "checkout"

Étapes suivantes

Pour savoir comment définir des sources et des déclencheurs, consultez les pages suivantes :