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 aux Rokt Ads. L'utilisation d'un domaine client spécifique de première partie 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é, 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. Choisissez 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 avant l'étape suivante.

Votre équipe dédiée Rokt se chargera 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
   Name: _acme-challenge.rkt.yourcompany.com.
   Target: {token_provided_by_Rokt}
   TTL: 600 seconds

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
   Name: rkt (the subdomain part of your full URL)
   Target: rkt.yourcompany.com.akamaized.net (provided by Rokt)
   TTL: 600 seconds

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

4. Mettez à jour votre script d'initialisation du SDK

Après que votre équipe dédiée Rokt a validé que vos enregistrements TXT et CNAME fonctionnent, mettez à jour votre script d'initialisation du 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 pour le vôtre :

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

Enfin, alertez 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.