Intégrations et migrations de plateformes Croct

Que fait Intégrations et migrations de plateformes Croct ?

Chaque intégration ici repose sur un SDK Croct fonctionnel. Elles alimentent Croct en données (événements, attributs de profil), envoient des données Croct vers l'extérieur (Clarity), ou affichent le contenu d'un slot dans le rendu d'une plateforme (CMS, ID de formulaire HubSpot). Les migrations remplacent les indicateurs ou expériences d'un autre outil par des slots.

Choisir l'intégration

Plateforme / objectif	Ce que fait l'intégration	Méthode d'installation	Référence
Storyblok	L'application Optimize lie les blocs aux slots ; le SDK échange les blocs liés lors des récupérations d'articles (JS, PHP)	Application Storyblok + croct init ou @croct/plug-storyblok / croct/plug-storyblok	storyblok.md
Sanity	Récupération de slot avec le contenu Sanity comme fallback ; aucun paquet Croct	croct init + fetchContent	headless-cms.md
Strapi	Mappe les composants de zone dynamique vers des slots via un slot de mappage	croct init + fetchContent	headless-cms.md
Shopify Hydrogen	Événements automatiques de boutique en ligne, identification client ; utilisation du SDK dans le skill croct-integrate-sdk	croct init (SDK Hydrogen)	ecommerce.md
Shopify checkout / commandes (Liquid ou Hydrogen)	Pixel personnalisé qui suit checkoutStarted, orderPlaced, plus des événements personnalisés	Plugin Storefront + pixel Shopify personnalisé	ecommerce.md
Thème Liquid Shopify	SDK JavaScript pour le contenu ; intégration GTM pour les événements ; pixel pour le checkout	Balises de script	ecommerce.md
Store Framework VTEX (VTEX IO)	Transfère les événements de la boutique comme objectifs et événements e-commerce ; enrichit les profils	Script vtex.js ou GTM	ecommerce.md
Google Tag Manager / couche de données GA4	Transfère les événements recommandés de la couche de données comme objectifs et événements e-commerce	Script google-tag-manager.js ou GTM	analytics-and-crm.md
Microsoft Clarity	Étiquette les sessions Clarity avec les expériences, audiences et variantes d'expérience Croct	Script clarity.js ou GTM	analytics-and-crm.md
Formulaires HubSpot	Objectifs de soumission, enrichissement de profil, ID de formulaire servi depuis un slot pour les tests	Code autour de l'intégration HubSpot	analytics-and-crm.md
6sense, Demandbase	Écrit les attributs riches firmographics dans le profil	Script Croct ou GTM	firmographics.md
Clearbit Reveal, ZoomInfo WebSights	Écrit les attributs d'entreprise dans le profil via du code que vous ajoutez	GTM Custom HTML	firmographics.md
Migration depuis Mutiny, Ninetailed	Mappage conceptuel et remplacement pas à pas par des slots, audiences, expériences	croct init + slots par zone	migrations.md

Lisez uniquement la référence pour la plateforme concernée. Si la plateforme n'est pas listée, la documentation n'a pas d'intégration dédiée : dites-le et vérifiez https://docs.croct.com/llms.txt avant d'improviser.

Règles transversales

1. SDK d'abord. Chaque intégration nécessite le SDK Croct sur la page ou le serveur. Les scripts d'intégration ne font rien sans lui. Configurez-le avec croct init ou consultez le skill croct-integrate-sdk.
2. Privilégiez croct init pour Storyblok, Sanity, Strapi, Hydrogen et les migrations. Il détecte la stack et branche le SDK (et pour Storyblok JS, encapsule storyblokInit avec withCroct). N'utilisez les étapes manuelles que si l'utilisateur le demande ou si le CLI ne peut pas le brancher (par exemple, Storyblok PHP sans framework supporté).
3. Le contenu CMS est toujours le fallback. Passez le CMS existant ou le contenu codé en dur comme fallback afin que les requêtes échouées ou lentes affichent la page actuelle. Pour Sanity, Strapi et Ninetailed, demandez à l'utilisateur où le contenu par défaut doit vivre (Croct, recommandé, ou le CMS via metadata.contentSource === 'slot'). Voir headless-cms.md.
4. Les composants Croct reflètent le schéma CMS avec les mêmes noms d'attributs, afin que le contenu des slots et le contenu CMS soient interchangeables dans le même composant de rendu.
5. Suivez les objectifs avant de publier toute expérience ou expérience, car des données précoces montreraient des expositions sans conversions.
6. Les données firmographiques ne sont pas disponibles dès la première page vue. Concevez les expériences basées sur les comptes pour s'activer lors des pages vues suivantes ; utilisez la campagne, le référent ou l'emplacement pour la première impression.
7. Les attributs personnalisés dans CQL abandonnent le préfixe custom. : custom.firmographics.profile.industry devient user's firmographics's profile's industry. Les profils autorisent au maximum 10 attributs personnalisés. Pour tout ce qui dépasse ces exemples, consultez le skill croct-cql.
8. Spécificités Storyblok : Optimize nécessite le plan Scale et l'approbation du fournisseur Storyblok (via le support Croct). Les champs de table et de référence ne peuvent pas être personnalisés.

Scripts d'intégration CDN

Tous se chargent depuis https://cdn.croct.io/plug-integration/ :

Script	Où	Moment du chargement
google-tag-manager.js	<head> ou <body>, ou GTM	N'importe quand ; rejoue la couche de données
clarity.js	<head> ou <body>, ou GTM	N'importe quand ; attend Clarity
vtex.js	<head> ou <body>, ou GTM	Le plus tôt possible ; les événements antérieurs sont perdus
6sense.js, demandbase.js	<head> ou <body>, ou GTM	Attend que le fournisseur identifie le visiteur
shopify-pixel.js	Liquid layout/theme.liquid avant </head>, avec defer	N'importe quand ; s'enregistre auprès du SDK quand il se charge
shopify-pixel-tracker.js	Importé dans le pixel Shopify personnalisé	n/a

Recette GTM (à relayer à l'utilisateur)

Pour tout script ci-dessus proposé "via GTM" : Tags > Nouveau ; nommez-le (par exemple, Envoyer les événements de couche de données à Croct) ; type de balise Custom HTML ; collez la balise `<script src=