Intégration de Domaine de Première Partie

Cette page explique comment configurer une intégration de domaine de première partie pour le SDK Web de Rokt, qui s'applique à la fois à la suite de produits Rokt Ecommerce (Rokt Thanks, Rokt Pay+, etc.) et à Rokt Ads. L'utilisation d'un domaine de première partie, spécifique au client, aide à garantir que le SDK se charge de manière fiable, même dans des environnements avec des contrôles de confidentialité stricts ou des bloqueurs de publicités, tout en offrant une expérience plus fluide et alignée sur la marque pour vos clients.

Recommandé pour les intégrations web

L'intégration de domaine de première partie utilisant des enregistrements CNAME offre des avantages de performance limités pour les SDK mobiles en raison des pratiques actuelles de blocage des publicités et du contenu.

Prérequis

Avant de commencer, assurez-vous que :

• Votre équipe technique a accès à vos paramètres DNS et peut créer un enregistrement CNAME et un enregistrement TXT.
• Votre site web autorise les requêtes web vers les sous-domaines de première partie.

1. Choisir un sous-domaine

Sélectionnez un sous-domaine à partir duquel le SDK Rokt sera chargé. Par exemple : rkt.yourcompany.com

Évitez d'inclure "Rokt" ou des mots-clés liés à la publicité comme "Ads" ou "Offers", car cela pourrait entraîner le blocage de vos placements. Une fois que vous avez décidé d'un sous-domaine à utiliser, partagez-le avec votre représentant de compte Rokt.

2. Rokt crée votre certificat SSL

Cette étape est gérée par Rokt. Vous n'avez pas besoin d'agir jusqu'à l'étape suivante.

Votre équipe dédiée Rokt s'occupera de l'émission du certificat SSL après avoir reçu votre sous-domaine. Ils vous fourniront ensuite un jeton unique nécessaire pour créer l'enregistrement TXT et le domaine cible CNAME à l'étape suivante.

3. Créez vos enregistrements DNS

Après avoir reçu le jeton unique et le domaine cible CNAME de votre équipe Rokt, mettez à jour vos paramètres DNS comme suit :

1. Créez un enregistrement TXT pour la validation SSL.

   • Cela permet à Rokt de valider le certificat SSL pour votre sous-domaine
   • Veuillez noter que le jeton unique expire après 5 jours

   Exemple d'enregistrement TXT

   Type: TXT
   Nom: _acme-challenge.rkt.yourcompany.com.
   Cible: {token_provided_by_Rokt}
   TTL: 600 secondes

2. Créez un enregistrement CNAME.

   • Votre enregistrement CNAME redirigera les requêtes envoyées au sous-domaine que vous spécifiez vers Rokt. Exemple d'enregistrement CNAME

   Type: CNAME
   Nom: rkt (la partie sous-domaine de votre URL complète)
   Cible: rkt.yourcompany.com.akamaized.net (fourni par Rokt)
   TTL: 600 secondes

3. Informez votre équipe Rokt une fois que vous avez créé un enregistrement TXT et CNAME.

4. Mettez à jour votre script d'initialisation SDK

Une fois que votre équipe dédiée Rokt a validé que vos enregistrements TXT et CNAME fonctionnent, mettez à jour votre script d'initialisation SDK pour faire référence à votre nouveau sous-domaine choisi. Dans votre script d'initialisation, recherchez la ligne où DOMAIN est spécifié :

const DOMAIN = "https://apps.rokt-api.com";

Changez la valeur du domaine de Rokt par le vôtre :

const DOMAIN = "https://rkt.yourcompany.com";

Enfin, informez Rokt une fois que vous avez mis à jour le paramètre de domaine dans votre script afin qu'ils puissent s'assurer que le SDK s'initialise automatiquement en utilisant votre nouveau domaine.