Skip to main content

Tangiblee Help Center

Integration gérée (recommandée)

Last Updated:
May 6, 2026

Tangiblee recommande cette intégration car elle est utilisée par 95 % de nos clients de détail. Avec cette option, l'équipe de Tangiblee réalise 99 % de l'intégration. Ajoutez simplement notre script à votre site Web et le tour est joué. Tangiblee fournit au client une ligne de code qui adapte Tangiblee à la mise en page PDP actuelle et garantit que le CTA de Tangiblee est affiché sur les PDP pertinents.

L'adaptation de Tangiblee au PDP du client se fait via un script de code de mappage (alias) tangiblee-mapper.js). L'équipe de Tangiblee créera le tangiblee-mapper.js and maintenez-le pour le client dans le cas d'une intégration gérée. Le script créé pour le client est un wrapper pour tangiblee-mapper.js qui charge depuis Tangiblee CDN le tangiblee-mapper.js fourni avec le script d'Api Tangiblee (tangiblee.js) dans un bundle tangible.min.js.

Tangiblee recommande d'installer le script directement sur les pages SKU des produits concernés, généralement dans le corps avant la balise de fermeture. Tangiblee ne recommande pas de publier notre script via l'installation de Google Tag Manager (GTM) étant donné dernières mises à jour d'iOS 17. L'installation directe permettra également d'accélérer le temps de chargement des appels à l'action (CTA).

Le script Tangiblee doit être installé directement :

  • <body>dans la plupart des cas, généralement avant la balise fermante de <body>et nous vous recommandons d'utiliser l'attribut Async !
  • Ou dans la <head>balise Async ! the attribute is requis
  • peut être ajouté à TOUTES les pages détaillées des produits car le CTA ne s'affichera que sur les produits approuvés

Le script de Tangiblee a été :

  • Optimisé pour les performances et testé périodiquement avec PageSpeed
  • construit avec la fonctionnalité de chargement différé, pour charger un minimum de ressources avant que l'utilisateur ne clique sur Tangiblee CTA, et charger le reste une fois que l'utilisateur a ouvert Tangiblee.

Dans certains cas, les clients ont besoin de plusieurs scripts tangibles, par exemple un script pour le site Web de production (PRD) et un script pour le site Web de préparation (STG), chacun devant afficher une configuration différente de Tangiblee. Pour prendre en charge plusieurs environnements pour un même client, chacun ayant une configuration différente, chaque script est défini avec sa propre révision. La version client est le dernier dossier sur le chemin du script de script, comme vous pouvez le voir dans l'exemple ci-dessous, révision est révision_1 who is the default value révision.

[.bad] The script is added to of illustration only. [.bad]

<script async src="https://cdn.tangiblee.com/integration/3.1/managed/www.tangiblee-integration.com/revision_1/variation_original/tangiblee-bundle.min.js"></script>

[.bad]Please note : il ne s'agit pas de votre extrait d'intégration, mais d'un exemple pour les besoins de ce guide. Your contact Tangiblee partagera un extrait d'intégration spécifique à votre site Web pendant le processus d'intégration. [.bad]

Vous trouverez ci-dessous quelques exemples illustrant le fonctionnement de l'intégration gérée dans différents cas d'utilisation à l'aide de balises, chacune ayant ses propres révision.

Integration gérée selon les cas d'utilisation typiques

Cet exemple et cette explication couvrent le cas d'utilisation typique de l'utilisation de Tangiblee Managed Integration. Cela se fait généralement lors de l'intégration d'un script unique sur le site Web du client (PRD).

This demonstration link de Tangiblee Managed Integration a la révision par défaut définie sur le script : révision_1

Comme indiqué dans l'exemple de lien, révision_1 fait partie du chemin vers bundle tangible.min.js. Il s'agit d'une version par défaut que l'équipe de Tangiblee fournira lors de l'utilisation Integration gérée sur un type de PDP donné.

Lorsqu'un client envisage de déployer une mise à jour du code PDP, il est important d'en informer l'équipe de Tangiblee et de fournir à Tangiblee un lien vers l'environnement STG ou DEV avant de déployer la mise à jour. En informant Tangiblee à l'avance, l'équipe peut mettre à jour le tangiblee-mapper.js, si nécessaire, et testez-le sur le nouveau PDP pour garantir un service continu sur le PRD après le déploiement.

Si un changement est détecté par l'équipe de Tangiblee, nous travaillerons le plus rapidement possible compte tenu de la charge de travail de notre équipe. Cependant, il ne s'agit pas d'un processus infaillible à 100 % et les mises à jour effectuées par Tangiblee ne peuvent pas refléter 100 % des modifications apportées par le client.

Par conséquent, nous vous recommandons vivement de mettre à jour l'équipe de Tangiblee chaque fois que vous apportez des modifications au code, à la structure ou à la mise en page de votre PDP.

Vous trouverez ci-dessous les points forts de l'exemple de configuration ci-dessus, ainsi que la balise :

  1. Un SKU sur un PDP
  2. Une région active,
  3. No Prix/Devise/ATC in the widget
  4. Pas de suivi des commandes

[.bad] The script is added to of illustration only. [.bad]

<script async src="https://cdn.tangiblee.com/integration/3.1/clients/www.tangiblee-integration.com/revision_1/variation_original/tangiblee-bundle.min.js"></script>

[.bad]Please note : il ne s'agit pas de votre extrait d'intégration, mais d'un exemple pour les besoins de ce guide. Your contact Tangiblee partagera un extrait d'intégration spécifique à votre site Web pendant le processus d'intégration. [.bad]

Intégration avancée gérée par cas d'utilisation

Le cas d'utilisation classique pour utiliser un autre tag avec un autre révision est destiné à un nouveau site Web ou à une nouvelle conception PDP, généralement sur l'environnement de mise en scène (STG). Dans ce cas, Tangiblee peut fournir un tag avec un nouveau révision pour que le STG s'assure que chaque environnement possède sa propre configuration.

Cette nouvelle version sera dotée d'une version plus récente Révision_X parameter in a path to the bundle tangible.min.js dossier.

Vous trouverez ci-dessous les points forts de la configuration et du tag :

  1. Un SKU sur un PDP
  2. Une région active
  3. No Prix/Devise/ATC in the widget
  4. Pas de suivi des commandes

[.bad] The script is added to of illustration only. [.bad]

<script async src="https://cdn.tangiblee.com/integration/3.1/managed/www.tangiblee-integration.com/revision_2/variation_original/tangiblee-bundle.min.js"></script>

Related Resources