Configurez l'API pour donner la priorité à des sources ou des déclencheurs spécifiques.
Donner la priorité à des clics ou des vues spécifiques pour les rapports au niveau des événements ou les rapports cumulables
L'utilisation des priorités côté source vous permet de modifier le comportement par défaut de l'API Attribution Reporting. Par défaut, le modèle d'attribution est basé sur le dernier contact, 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 la source.
Définissez une priorité plus élevée pour les sources à privilégier. Plus la valeur est élevée, plus la priorité est élevée. Par exemple, un événement source avec un priority de 2 est prioritaire sur une source avec un priority de 1.
Seul le rapport correspondant à l'événement source avec la priorité la plus élevée est envoyé.
Exemple de code
Modifier 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}`
})
);
Donner la priorité à 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.
Supposons qu'un utilisateur clique sur une annonce et effectue quatre conversions: il consulte la page d'accueil du site de l'annonceur, puis une page de produit, s'inscrit à la newsletter et effectue un achat.
Toutefois, en raison de la limite de trois rapports pour les clics, tous les rapports ultérieurs après l'inscription (troisième conversion) sont supprimés par défaut, y compris le rapport sur les achats.
À la place, vous pouvez configurer l'API de sorte que vous receviez des rapports sur les conversions que vous considérez comme plus importantes (le rapport sur les achats, par exemple).
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 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 et une pour les vues) a été atteint pour cette source, le navigateur va:
Comparez la priorité du nouveau rapport à celle des rapports planifiés existants pour la même source.
Supprimez le rapport avec 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 comportement par défaut du navigateur est rétabli: toute conversion effectuée après la troisième conversion pour les clics ou la première conversion pour les vues est ignorée.
Examinez l'exemple de code: prioriser les conversions de type règlement.
Étapes suivantes
Pour en savoir plus sur la définition des sources et des déclencheurs, consultez les articles suivants: