CDDC Piano-managed - Guide de configuration

Configuration en 3 étapes

Étape 1 : Choisir votre sous-domaine

Sélectionnez un sous-domaine dédié à la collecte Piano Analytics. L’idéal étant de choisir un sous-domaine avec un nom aléatoire.

📋 Bonnes pratiques :

✅ Recommandé :
- ignis.votredomaine.com
- laguna.votredomaine.com
- nox.votredomaine.com

❌ À éviter :
- analytics.votredomaine.com
- data.votredomaine.com

Stratégie multi-sites :

Étape 2 : Créer le CDDC dans le Data Collection Portal

1. Accédez au Data Collection Portal : https://analytics.piano.io/datacollection/#/dashboard

2. Naviguez vers "Collection Domains"

3. Cliquez sur "+"

4. Sélectionnez "CNAME" puis "Certificat géré par Piano”.

5. Renseignez votre sous-domaine : ignis.votredomaine.com

6. Validez : Piano génère automatiquement :

   • Un alias CNAME à renseigner dans votre configuration DNS

   • Un certificat SSL valide

Étape 3 : Configurer votre DNS

Piano vous fournit un alias CNAME à ajouter dans votre zone DNS.

Vérification :
Une fois le DNS propagé, le statut dans le Data Collection Portal passe automatiquement à "Active".

Mise à jour du tagging

Une fois votre CDDC actif, mettez à jour votre configuration Piano Analytics.

Piano Analytics SDK (JavaScript)

pa.setConfigurations({
    site: 123456, // Votre site ID
    collectDomain: 'ignis.votredomaine.com',
});

Gestion des cookies

Configuration recommandée

Pour bénéficier de cookies optimaux, notre recommendation reste d’utiliser des cookies client-side, first-party. Pour cela aucune surchage de la configuration n’est nécessaire.

Sécurité : Cookies sensibles

Important : Les cookies déposés sur votre domaine parent (.votredomaine.com) sont automatiquement envoyés avec les requêtes vers votre CDDC.

Bonnes pratiques :

• Utilisez des sous-domaines spécifiques pour vos cookies sensibles

• Déposez vos cookies d'authentification sur un domaine dédié

• Piano Analytics n'exploite pas vos cookies, mais ils transitent jusqu'à nos serveurs (comportement standard des cookies). Ceux-ci ne sont en aucun cas conservés suite à la requête du visiteur

💡 Si vous avez des contraintes de sécurité strictes : Nous vous recommandons alors une collecte type CDN/Reverse Proxy.

Monitoring & Maintenance

Tableau de bord

Dans le Data Collection Portal, vous pouvez suivre :

• Statut : Valide / En attente / Invalide

• Entrée DNS (CNAME) : Configuration DNS actuelle, xxx-at-o-dev-net-cddc.at-o.net

• Emails : Contacts notifiés (en suppléments des administrateurs de votre organisation)

Migration depuis Custom Certificate (recommandé)

Vous utilisez actuellement un certificat custom (BYOC) ? Migrez vers Piano-managed en 2 clics.

Process de migration

1. Accédez à votre CDDC dans le Data Collection Portal

2. Cliquez sur "Passer à un certificat géré par Piano" dans le menu latéral

3. Confirmez : Piano génère automatiquement le nouveau certificat

4. Aucun changement DNS requis : L'alias reste identique

Durée : Migration instantanée, aucune interruption de service.

Impact financier : Suppression de la facturation liée au certificat custom.

❓ FAQ

Puis-je utiliser un wildcard (*.votredomaine.com) ?

Non, pour des raisons de sécurité, Piano n'autorise que des sous-domaines spécifiques.

Combien de temps avant que mon CDDC soit actif ?

Une fois le DNS configuré : 15 minutes à 48h selon la propagation DNS. Piano vérifie automatiquement toutes les 15 minutes.

Que se passe-t-il si j'oublie de renouveler mon certificat custom ?

Interruption totale de la collecte dès l'expiration. C'est pourquoi nous recommandons fortement Piano-managed.

Puis-je avoir plusieurs CDDC pour différents domaines ?

Oui, vous pouvez créer autant de CDDC que nécessaire (un par domaine parent recommandé).

Le CDDC fonctionne-t-il avec les adblockers ?

Les adblockers avancés détectent les CNAME. Pour une couverture maximale, considérez une architecture CDN/Reverse Proxy (contactez votre CSM).