Last updated 31 mars 2025

Tagging côté serveur

Les clients de 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 des 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 la déclaration des conversions

Il est fortement recommandé aux annonceurs d'utiliser des identifiants persistants (par exemple, des valeurs d'e-mail ou d'e-mail hachées) pour boucler la boucle. Les identifiants persistants permettent à Rokt d'attribuer plus précisément les conversions aux événements de référence d'origine à travers les canaux et dans le temps.

Cependant, si vous avez besoin de rapports de conversion sans PII, veuillez parler à votre responsable de compte de l'utilisation de l'identifiant de clic Rokt comme identifiant.

Approche d'intégration recommandée

Le reporting des conversions en utilisant l'API d'évé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 sauter ces étapes.

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

   • L'identifiant (par exemple, email, Rokt Click ID) peut être conservé en poussant sa valeur vers le dataLayer côté client sur la page de destination.
   • Ensuite, lors de chaque conversion, incorporez la valeur en tant que paramètre d'événement GA4 pour qu'elle soit ensuite envoyée vers votre conteneur côté serveur.

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

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

3. [ Côté serveur ] Revendiquer la requête contenant le RCLID avec un client GA4.

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

   • Assurez-vous d'inclure un objet metaData avec des paires clé/valeur : { "name": "source", "value": "sgtm" }
   • Si la requête réussit, la balise devrait recevoir une réponse 200 avec le corps : {"data":{"unprocessedRecords":[]}}
   • 

Vérification des conversions reçues

Dans le cadre du processus d'assurance qualité, votre responsable de compte vérifiera que toutes les conversions ont été reçues correctement par Rokt.

API de Reporting de Conversion

Pour les cas d'utilisation qui n'impliquent en aucun cas les PII, Rokt expose également un point de terminaison GET (https://apps.rokt.com/api/conv) pour le reporting de conversion, qui attend les paramètres de requête ci-dessous. Lorsque cela est possible, l'API d'Event doit être préférée en raison de sa sécurité et de sa flexibilité par rapport à l'API de Reporting 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 reporting de conversion sans PII	Vrai	qjkp3xy7dtf9wvneazc5r2bh8ls1m06g
conversiontype	Une chaîne pour différencier les différents événements de conversion	Optionnel (sauf pour le reporting de plusieurs événements)	signup, purchase, freetrial