DocumentationObjectifs et identify

04 · Suivi

Compter les objectifs, et identifier les clients par e-mail

Un objectif est un moment qui vaut la peine d’être compté : une inscription, un paiement commencé, un téléchargement. Identify lie un visiteur à l’e-mail avec lequel il paie.

01Objectifs depuis votre code

Appelez tally avec le nom de l’objectif, et jusqu’à 10 propriétés si vous le souhaitez :

JavaScript
// Once, before your first call: it keeps calls made before the script has loaded.
window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };

tally('signup');
tally('checkout_started', { plan: 'pro', seats: 3 });

Le window.datafast(name, props) de DataFast est le même appel : les objectifs écrits pour lui continuent donc d’être comptés.

02Objectifs depuis votre HTML

Donnez à n’importe quel élément un attribut data-tally-goal, et chaque clic dessus compte comme cet objectif. Ses attributs data-tally-goal-<key> deviennent des propriétés, les tirets étant changés en tirets bas : data-tally-goal-plan-type devient ainsi plan_type :

HTML
<button data-tally-goal="signup">Start free</button>

<button data-tally-goal="upgrade" data-tally-goal-plan-type="pro">Upgrade</button>

data-fast-goal fonctionne de la même façon. Une touche du clavier pressée sur un bouton compte une seule fois : elle déclenche le clic.

03Noms et propriétés

  • Un nom est débarrassé de ses espaces de début et de fin, passé en minuscules, et ses espaces deviennent des tirets bas ; il doit ensuite compter au plus 64 caractères parmi les lettres, les chiffres, _, : et -, sinon l’objectif n’est pas envoyé.
  • Jusqu’à 10 propriétés sont conservées. Une clé est passée en minuscules et doit compter au plus 32 caractères parmi les lettres, les chiffres, _ et - ; les autres sont écartées. Les valeurs sont envoyées sous forme de texte, de 255 caractères au plus.
  • Une propriété qui ne peut pas être convertie en texte fait abandonner l’objectif, et aucune erreur n’est levée dans votre page.

04Où apparaissent les objectifs

La page Goals du site liste chaque objectif avec ses réalisations et ses visiteurs, et chaque objectif se déplie pour afficher ses propriétés. Un entonnoir y compte de 2 à 8 étapes, chacune une page ou un objectif, qu’un visiteur franchit dans l’ordre dans un délai que vous choisissez, de 30 minutes à 30 jours.

05Identifier un client par e-mail

Quand quelqu’un se connecte, ou arrive sur votre page de confirmation, appelez identify avec l’e-mail qu’il utilise pour payer. Un paiement dont l’e-mail client correspond est alors lié à ce visiteur, avec une confiance moyenne : c’est la voie d’accès pour les paiements qui ne portent aucun identifiant de visiteur, comme les factures, ou sur un site sans cookie.

JavaScript
// Once the customer is signed in (or on your success page), with the email they pay with.
// It is hashed when it arrives; only the hash is kept.
window.tally = window.tally || function () { (tally.q = tally.q || []).push(arguments); };
tally('identify', { email: user.email });

L’e-mail est haché dès son arrivée et seul le hachage est conservé. Tout ce qui n’est pas une adresse e-mail est écarté. Le datafast('identify', { user_id }) de DataFast fonctionne quand le user_id est un e-mail.

06Vérifier que ça marche

07Ce qui n’est pas compté

Il manque quelque chose, ou ce n’est pas ce que vous voyez ? Écrivez à support@tallybyoutpost.com en précisant la page.