Last updated 31 janv. 2025

Tagging côté serveur

Les clients Rokt Ads configurés pour le tagging côté serveur via Google Tag Manager peuvent exploiter l'API d'événements de Rokt pour intégrer les données de conversion en temps réel.

Limitations du cas d'utilisation

Le tagging côté serveur est uniquement applicable aux annonceurs dans le but de rapporter les conversions en raison de sa dissociation de l'application frontale.

Identifiants pour le rapport de conversion

Il est fortement recommandé aux annonceurs d'utiliser des identifiants persistants (par exemple, des e-mails ou des valeurs de courriels hachés) pour boucler la boucle. Les identifiants persistants permettent à Rokt d’attribuer plus précisément les conversions aux événements de référence originaux à travers les canaux et au fil du temps.

Cependant, si vous avez besoin de rapports de conversion sans PII, veuillez parler à votre responsable de compte pour utiliser le Rokt ID en tant qu'identifiant.

Approche d'Intégration Recommandée

Rapporter les conversions en utilisant l'API d'Evénements depuis un conteneur côté serveur implique les étapes suivantes, qui correspondent aux numéros dans le diagramme ci-dessus.

Emplacement de l'identifiant

Les étapes 1 et 2 ci-dessous supposent qu'un identifiant nécessaire pour l'attribution doit d'abord être passé de l'application côté client au conteneur côté serveur. Si un identifiant existe déjà côté serveur, vous pouvez ignorer ces étapes.

1. [ Côté client ] Conserver l'identifiant de choix jusqu'aux événements de conversion.

   • L'identifiant (par ex. email, ID Rokt) peut être conservé en poussant sa valeur vers le dataLayer côté client sur la page de destination.
   • Ensuite, à chaque conversion, intégrer la valeur en tant que paramètre d'Evénement GA4 pour ensuite l'envoyer vers votre conteneur côté serveur.

2. [ Client → Serveur ] Lors de la conversion, envoyer l'identifiant à votre conteneur serveur via un Evénement GA4.

   • 
   • La règle de déclenchement de l'Evénement GA4 doit être liée à l'événement de conversion.

3. [ Côté serveur ] Réclamer la requête contenant le RTID avec un client GA4.

4. [ Côté serveur ] En fonction du nom d'événement GA4 entrant, déclencher conditionnellement une Balise de Requête HTTP pour envoyer une requête POST vers le point d'extrémité de l'API d'Evénements de Rokt (https://api.rokt.com/v2/events). Référez-vous à la documentation de l'API d'Evénements pour plus de détails sur la façon d'authentifier et d'interagir avec l'API, y compris comment construire un payload valide.

   • 
   • Si réussie, la balise devrait recevoir une réponse 200 avec le corps : {"data":{"unprocessedRecords":[]}}

Vérification des Conversions Reçues

Dans le cadre du processus de QA, votre gestionnaire de compte vérifiera que toutes les conversions ont été correctement reçues par Rokt.

API de Rapport de Conversion

Pour les cas d'utilisation qui n'impliquent aucun type de PII, Rokt expose également un point de terminaison GET (https://apps.rokt.com/api/conv) pour le rapport de conversion, qui attend les paramètres de requête ci-dessous. Lorsque cela est possible, l'API Event devrait être préférée en raison de sa sécurité et de sa flexibilité par rapport à l'API de Rapport de Conversion.

Paramètre	Définition	Requis	Exemple
id	Votre ID de compte Rokt	Vrai	3051387316918867566
passbackconversiontrackingid	ID de 32 caractères utilisé pour le rapport de conversion sans PII	Vrai	qjkp3xy7dtf9wvneazc5r2bh8ls1m06g
conversiontype	Une chaîne pour différencier les différents événements de conversion	Facultatif (à moins de signaler plusieurs événements)	signup, purchase, freetrial