Configurez l'API pour donner 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 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 modifier 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 la 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, le paramétrage des priorités côté déclencheur n'est disponible que pour les rapports au niveau des événements.
Supposons 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 les achats.
Vous pouvez plutôt configurer l'API de sorte à recevoir des rapports sur les conversions que vous jugez plus importantes, comme le rapport "Achat".
Pour ce faire, ajoutez la clé priority
à l'en-tête d'enregistrement du déclencheur et définissez une priorité plus élevée pour les conversions que vous souhaitez prioriser.
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 :
Comparez la priorité du nouveau rapport à celle des rapports planifiés existants pour cette même source.
Supprimez le rapport ayant la priorité la plus faible pour planifier le nouveau rapport à la place. 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 qui se produit après la troisième conversion pour les clics ou la première conversion pour les vues est supprimée.
Consultez l'exemple de code : prioriser les conversions de type "checkout"
Étapes suivantes
Pour en savoir plus sur la configuration des sources et des déclencheurs, consultez les pages suivantes :