Évènement in-app

Les événements in-app permettent une analyse de la manière dont les utilisateurs utilisent votre app. Les SDK AppsFlyer vous permettent de relever et consigner ces interactions très simplement.

Guides du SDK d'événements in-app

Anatomie d'un événement

Les événements in-app se composent de deux parties :

• Nom d'événement : l'identifiant unique de l'événement. C'est en général ainsi que les marketeurs voient s'afficher l'événement dans le tableau de bord.
• Valeurs d'événement : l'objet composé du binôme clé-valeur que l'on nomme paramètres d'événement. Les paramètres d'événement fournissent un contexte et des informations supplémentaires sur l'événement qui se produit.

Les noms et les paramètres d'un événement peuvent être soit prédéfinis soit personnalisés.

👍

Astuce

Vous pouvez aisément définir et générer un code d’événements in-app pour l'ensemble des principales plateformes grâce à notre outil de génération d’événements in-app.

Constantes d'événement

Dans les SDK, les événements et paramètres prédéfinis sont exposés en tant que constantes.

Lors de l'envoi d'événements, nous vous recommandons d'utiliser les constantes plutôt que les chaînes brutes :

• Vous réduisez ainsi la possibilité d'introduire des erreurs de noms.
• Les modifications apportées aux noms des paramètres/événements sous-jacents sont transparentes et exigent moins de maintenance.

Techniquement, les noms/paramètres des événements prédéfinis sont des chaînes commençant par le préfixe af_.

Événements personnalisés et paramètres d'événements personnalisés

Les noms et les paramètres d'événements personnalisés sont définis par l'utilisateur, ils se réfèrent en général à des situations propres au secteur d'activité de votre app ou à la manière dont vos utilisateurs en font usage.

🚧

Attention

Pour éviter toute confusion avec les événements prédéfinis, n'inscrivez pas le préfixe suivant devant les noms d'événements personnalisés af_.

Valid custom event names

Les noms d'événements personnalisés doivent respecter ces critères :

• Ne pas dépasser 100 caractères.
• Peuvent contenir des caractères non latin (non anglais).

Valid custom event parameters

Paramètres d'événement personnalisés :

• Ne doivent pas dépasser 1000 caractères, s'ils sont plus longs ils pourront être tronqués
• Tarification et revenu : utilisez uniquement des chiffres et des décimales, par exemple 5 ou 5,2.
• Les valeurs de tarification et de revenu peuvent comporter jusqu'à 5 chiffres après la virgule, par exemple, 5,12345

📘

Remarque

For events with revenue, including in-app purchases, subscriptions, and ad revenue events, AppsFlyer customers with an ROI360 subscription should avoid using the af_revenue parameter in their in-app events. Doing so can result in duplicate revenue being reported. Instead, they should utilize the purchase connector and the ad revenue SDK API.

Comprendre les définitions des structures d'événements

Idéalement, le marketeur doit vous définir avec précision la structure des événements, en se basant sur les instructions présentées dans la Définition des événements in-app. Exemple, la définition d'un événement af_content_view pour une app de eCommerce ressemblerait à ceci :

• La première colonne (nom de l'événement) est la valeur que vous transmettez en deuxième argument de logEventdeuxième argument.

  af_content_view : c'est ainsi que les marketeurs voient s'afficher l'événement dans le tableau de bord. Nous vous recommandons d'utiliser les constantes d'événements prédéfinies plutôt que les valeurs de chaîne brutes fournies par les marketeurs.

• La deuxième colonne (Paramètres de l'événement) répertorie les paramètres associés à l'événement. Dans ce cas, vous devez passer les paramètres d’événement suivants à logEvent:

  • af_price
  • af_content_type
  • af_content_id

• La troisième colonne (Valeurs des paramètres) contient les informations supplémentaires associées à certaines valeurs attribuées aux paramètres d'un événement. Dans l'exemple ci-dessus, le marketeur indique clairement que la valeur du paramètre d'évènement de af_content_id doit être le SKU de l'élément affiché.

• Dans la quatrième colonne, le marketeur indique à quel moment et à quel endroit de l'app l'événement doit se produire.

Cf exemple de définition ci-dessus pour voir l'implémentation sous Android et iOS.

Événements in-app hors ligne

Le SDK peut mettre en cache les événements in-app qui ont lieu lorsqu'il n'y a pas de connexion Internet :

• Le SDK envoie les événements aux serveurs AppsFlyer et attend la réponse
• Si le SDK ne reçoit pas la réponse 200, les événements sont mis en cache
• Lorsque une réponse 200 finit par être réceptionnée, l'événement stocké est envoyé à nouveau au serveur.
• S'il y a plusieurs événements dans le cache, ils sont envoyés au serveur les uns après les autres (détachés, une requête réseau par événement).

Le SDK peut mettre en cache jusqu'à 40 événements. Seuls les 40 premiers événements hors ligne sont stockés. Tout événement qui se produit ensuite est ignoré (jusqu'à réception d'une réponse 200).