Skip to main content
Skip table of contents

Portée de propriétés (Scopes)

Dans Piano Analytics, chaque propriété a une portée.

Cette portée a un impact sur la donnée et vos analyses.

Définition d'une portée

Portée

Une portée permet de faire persister une donnée provenant du marquage à travers plusieurs événements.

Cette persistance est liée à un visiteur et limitée dans le temps. Elle est rétroactive.

La durée maximale d'une portée est celle de la visite, soit 24H.

 Cela signifie que vous pouvez ajouter une information sur un événement, et la propager sur d'autres événements qui partagent une caractéristique commune (voir les différentes portées disponibles plus bas).

Prenons l'exemple d'une portée "Visite" sur une propriété "User" :

mceclip2-20240918-134008.png

L'information concernant l'utilisateur n'a été renseignée qu'une seule fois, sur l'événement de page "Login page".

Grâce à la portée "Visite", l'information a été propagée sur tous les événements de la visite. Même ceux ayant eu lieu avant que l'information de User soit renseignée.

Rétroactivité

La rétroactivité n'est disponible qu'à J+1. Sur les données en temps réel (sur la solution, mais aussi sur Data Flow et Data Sharing, une portée n'est pas rétroactive).

Caractéristiques d'une portée

La portée est définie par deux éléments.

La portée :

Définie les événements sur lesquels est propagée la valeur de la propriété.

  • Visite : Une propriété à portée visite est propagée sur tous les événements de la visite. La clé de propagation est le "visit_id".

  • Page vue : Une propriété à portée page vue est propagée sur tous les événements ayant eu lieu sur un même chargement de page. La clé de la propagation est le "pageview_id".

  • Événement : Une propriété à portée événement n'est pas propagée. Elle n'existe que pour l'événement sur lequel elle est liée.

Portée page vue

À date, la portée "Page vue" n'est disponible qu'avec les événements provenant du SDK Javascript. Les SDKs mobiles (Android et IOS) ne génèrent pas de pageview_id, nécessaire au bon fonctionnement du scope.

L'assignation :

Dans le cas où le marquage renvoie plusieurs valeur pour une propriété, définie la valeur qui est assignée à la portée.

  • Première valeur : Si la valeur de la propriété varie au cours de la visite, la première valeur est gardée en mémoire et est propagée sur tous les événements de la portée.

  • Dernière valeur : Si la valeur de la propriété varie au cours de la visite, la dernière valeur est gardée en mémoire et est propagée sur tous les événements de la portée. La dernière valeur sera rétroactivement appliquée à J+1 aux événements ultérieurs. 

  • Première valeur (réinitialisable) : Si la valeur de la propriété varie au cours de la visite, la première valeur est gardée en mémoire et est propagée sur tous les événements de la portée. Il est possible de remettre à zéro la valeur propagée via une action spécifique (voir le cas du "src_force" pour les campagnes marketing).

Il existe une quatrième assignation "Métier analytique" utilisée uniquement par Piano Analytics pour des calculs spécifiques. 

Voir la portée d'une propriété

La portée d'une propriété spécifique est visible depuis Data Management.

Vous pouvez cliquer sur une propriété et regarder la section "Portée" des metadata :

mceclip0-20240918-134926.png

Attribuer une portée à une propriété

Vous pouvez ajouter une portée, ainsi qu'une assignation, à vos propriétés personnalisées.

Cela se fait lors de l'étape de création de la propriété.

Information

La modification de la portée d'une propriété déjà existante n'est pas disponible dans l'interface. En effet, changer le scope d'une propriété qui a déjà collecté de la donnée peut avoir des impacts métiers importants.

Si vous souhaitez malgré tout modifier la portée d'une propriété personnalisée déjà existante, contactez le centre support.

Limites par scopes

Vous pouvez vérifier le nombre de propriétés personnalisées disponibles, ventilées par portées, depuis le la tuile "validé":

Screenshot 2025-02-17 at 11.03.05.png

En cliquant sur le bouton, vous aurez accès au panel de propriétés personnalisées. Cela vous indiquera le nombre de propriété que vous pouvez créer par portée.

Screenshot 2024-08-28 at 14.57.38-20240918-135157.png

Par défaut, vous pouvez créer 500 propriétés personnalisées dont :

  • Jusqu'à 500 à la portée "événement"

  • 50 à la portée visite

  • 50 à la portée page vue

Vous pouvez aussi souscrire à l'option "1000 propriétés personnalisées" pour bénéficier de 1000 propriétés dont :

  • Jusqu'à 1000 à la portée "événement"

  • 100 à la portée visite

  • 100 à la portée page vue

Si vous voulez souscrire à cette option, vous pouvez contacter votre chargé de compte.

Information

Pour qu'une propriété soit comptée il faut qu'elle soit :

  • Origine : Personnalisée

  • Statut : Validé

  • Traitement : Processée ou Enrichie (retroactif)

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.