Tagging côté serveur

Les clients de Rokt Ads configurés pour le tagging côté serveur via Google Tag Manager peuvent tirer parti de 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 séparation 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 de rapports de conversion sans PII, veuillez parler à votre gestionnaire de compte de l'utilisation du Rokt Click ID comme identifiant.

Approche d'Intégration Recommandée

Le reporting des conversions en utilisant l'API d'événements (Event API) 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 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 ] Conserver 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, intégrer 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, envoyer 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éclencher conditionnellement une balise de requête HTTP pour envoyer une requête POST vers l'endpoint de l'API d'événements de Rokt (https://api.rokt.com/v2/events). Référez-vous à la documentation de l'API d'é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 gestionnaire 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 (informations personnelles identifiables) de quelque nature que ce soit, Rokt expose également un endpoint 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 (Event API) doit être privilégié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	Oui	3051387316918867566
passbackconversiontrackingid	ID de 32 caractères utilisé pour le reporting de conversion sans PII	Oui	qjkp3xy7dtf9wvneazc5r2bh8ls1m06g
conversiontype	Une chaîne pour différencier les différents événements de conversion	Optionnel (sauf si plusieurs événements sont reportés)	signup, purchase, freetrial