Marquage côté serveur

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

Limitations du cas d'utilisation

Le marquage côté serveur n'est applicable qu'aux annonceurs dans le but de rapporter les conversions en raison de son découplage de l'application frontale

Identifiants pour le rapport de conversion

Il est fortement recommandé aux annonceurs d'utiliser des identifiants persistants (par exemple, des valeurs d'email ou d'email haché) 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 au fil du temps.

Cependant, si vous avez besoin d'un rapport de conversion sans PII, parlez à votre responsable de compte de l'utilisation de l'ID de clic Rokt comme identifiant.

Approche d'intégration recommandée

Rapporter les conversions en utilisant l'API des événements à partir d'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 transmis 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 ] Conservez l'identifiant de choix jusqu'aux événements de conversion.

   • L'identifiant (par exemple, email, ID de clic Rokt) 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 ensuite l'envoyer 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 ] Réclamez 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 des événements de Rokt (https://api.rokt.com/v2/events). Référez-vous à la documentation de l'API des événements pour des détails sur la façon d'authentifier et d'interfacer avec l'API, y compris comment construire une charge utile valide.

   • Assurez-vous d'inclure un objet metaData avec des paires clé/valeur : { "name": "source", "value": "sgtm" }
   • Si la requête est 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 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 pas de PII de quelque nature que ce soit, 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'Événement devrait ê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 si plusieurs événements sont signalés)	signup, purchase, freetrial