Guide de migration consommateurs

Qui doit lire ce guide

Utilisez ce guide si vous avez deja integre Pomelo et que vous :

• installez encore un snippet manuel par défaut
• lisez les routes mixtes comme si elles etaient totalement disponibles ou totalement verrouillees
• consommez encore les miroirs depreciés de /v1/me
• envoyez encore les anciens parametres de date sur l’API publique
• codez en dur collection_profile, les capacites du plan ou les classes de route

Remplacements canoniques

Ancien pattern	Chemin canonique maintenant	Statut	Sunset / revue
Snippet écrit à la main avec configuration runtime dans le HTML	Utiliser la balise script unique générée par le dashboard	à migrer maintenant	immédiat
Lire plan_id dans GET /v1/me	Lire product.runtime_plan_id	miroir deprecie	pas de suppression avant 2026-07-03T00:00:00Z
Lire retention_days dans GET /v1/me	Lire product.product_retention.api_retention_days	miroir deprecie	pas de suppression avant 2026-07-03T00:00:00Z
Envoyer start / end sur les routes publiques /v1/*	Envoyer from / to	deja retire du runtime public	a migrer maintenant
Lire seulement availability.sections sur overview, acquisition ou actions	Lire d’abord availability.readModel, puis availability.sections	a migrer maintenant	immediate
Coder en dur collection_profile ou les classes de route dans le client	Lire plutot product, product_configuration et availability	a migrer maintenant	immediate

Migration du snippet

Chemin recommande :

1. Copiez le snippet genere depuis le dashboard.
2. Collez la balise analytics unique dans le head de votre site.
3. Gardez le profil de collecte, l’autocapture et les réglages tenant dans Pomelo.

Si votre framework injecte les scripts depuis du code au lieu de coller le HTML brut, rendez le même contrat :

• https://cdn.pomeloanalytics.com/latest/analytics.js
• le data-site-id fourni par Pomelo

N’embarquez pas de JSON de configuration runtime dans votre app. Le SDK charge la configuration active du site depuis Pomelo au démarrage.

Ne vous appuyez pas sur des attributs legacy comme :

• data-autocapture-ui
• data-autocapture-forms
• data-autocapture-errors
• data-capture-localhost
• data-allow-params

Voir aussi : Integration du SDK.

Les requetes publiques /v1/* doivent deja utiliser from et to. Seul le proxy interne du dashboard /metrics/* conserve encore start/end dans son propre contrat partage.

Migration des routes mixtes

Lisez les routes mixtes dans cet ordre :

1. availability.readModel
2. availability.sections

Interpretation :

• availability.readModel.strictSafe = socle utile toujours retourne en Strict
• availability.readModel.extended = couche enrichie debloquee par Extended
• availability.sections = etat de disponibilite, verrouillage ou partiel des slices enrichies pour la periode choisie

Une reponse HTTP 200 sur une route mixte ne veut pas dire que tout a reussi.

Voir aussi : Strict, Extended et rapports mixtes.

Non-retroactivite

Passer un site de Strict a Extended est uniquement prospectif.

Cela signifie :

• les donnees futures compatibles peuvent devenir plus riches
• les periodes plus anciennes ne sont pas reenrichies
• un onglet deja ouvert peut garder l’ancien runtime jusqu’au rechargement

Ce qu’il ne faut plus coder en dur

Ne codez plus en dur :

• collection_profile
• les capacites du plan
• les classes de route
• la disponibilite des slices sur les routes mixtes
• les miroirs depreciés de /v1/me

Les ids backend comme audience_summary ou technology sont des identifiants internes de read-model, pas des routes publiques supplementaires.