En bref : l'API OneLink vous aide à engager les utilisateurs finaux et à tirer parti des médias propres en générant des liens personnalisés dans les campagnes à grande échelle, par SMS, etc. Nécessite une implémentation côté annonceur et côté développeur.
API OneLink
L'API OneLink est utilisée pour :
-
Créer, obtenir, mettre à jour et supprimer automatiquement les URL courtes OneLink avec des paramètres personnalisés.
Les paramètres peuvent être les suivants :- Les paramètres liés à l'attribution, utilisés pour mesurer et surveiller les efforts marketing, comme la source média, la campagne et l'actif. Note : le paramètre (pid) de la source média est obligatoire.
- Les paramètres de personnalisation, qui vous permettent de configurer une expérience utilisateur personnalisée lorsque l'app est ouverte à partir du lien correspondant. Ces paramètres vous permettent de diriger des utilisateurs vers du contenu in-app personnalisé, par exemple, une page produit spécifique, un code coupon ou une promotion.
- Permettre le partage du contenu des sites web et des apps directement avec les utilisateurs mobile (ce qui augmente l'engagement et les installations mobile).
- Générer instantanément un grand nombre de liens d'attribution personnalisés OneLink.
Remarque : pour les liens de parrainage, consultez l'article sur l'attribution des invitations utilisateurs.
Exemple
Feed Me, un service de livraison de produits alimentaires, souhaite envoyer un lien personnalisé par SMS à ses clients existants pour les encourager à télécharger l'app Feed Me et à acheter des bananes. En fonction du pays du client, Feed Me utilise l'API REST OneLink pour construire une URL OneLink personnalisée qui contient des détails spécifiques pour le pays, l'identité de l'utilisateur et une offre spéciale pour les bananes en vente.
Le nombre de requêtes API OneLink que vous pouvez lancer est limité en fonction de votre type de compte. Vous pouvez voir combien de requêtes vous avez déjà effectuées, et combien il vous en reste, dans le tableau de bord de l'API OneLink.
Vous pouvez contacter votre CSM pour augmenter le nombre de requêtes API autorisé.
Configuration
Pour configurer l'API OneLink :
- Créez un modèle OneLink.
-
Enregistrez l'ID OneLink.
-
Enregistrez la clé API OneLink.Un utilisateur admin doit forcément récupérer la clé API, les utilisateurs du compte n'y ont pas accès.
- Dans le tableau de bord AppsFlyer, allez dans Expériences et deep Linking > API OneLink > Voir la clé API OneLink
- Si l'admin ne peut pas récupérer la clé API OneLink, cela signifie que vous n'avez pas le package requis et que vous devez contacter votre CSM.
- Donnez l'ID OneLink et la clé API OneLink au développeur.
- Demandez au développeur de suivre les instructions du dev hub.
Tableau de bord
Le tableau de bord OneLink API s'affiche :
- Votre utilisation quotidienne, mensuelle et trimestrielle de l'API.
- La clé API OneLink.
Pour afficher le tableau de bord de l'API OneLink :
Dans AppsFlyer, allez dans Expériences et deep Linking > API OneLink.
Particularités et limites
Particularité |
Remarques |
---|---|
Quota de l'API |
|
Seuil limite |
|
Visibilité des liens |
|
Durée de vie |
|
Caractères spéciaux |
Les caractères suivants doivent être encodés s'ils sont utilisés pour les liens créés par l'API : ;, *, !, @, #, ?, $, ^, :, &, ~, `, =, +, ', >, <, / Si vous n'encodez pas ces caractères, ils seront remplacés par un espace vide, et le lien et sa fonctionnalité pourront être défectueux. |
Charge utile |
La chaîne de requête de la charge utile ne peut pas dépasser 2048 caractères. |
ID d'URL |
L'ID de l'URL (ou ID du lien court) peut être modifié pour mettre en avant l'offre de votre campagne.Par exemple : https://myapp.onelink.me/abc123/pommes.L'ID d'URL peut comporter au maximum 50 caractères et peut inclure des lettres et des chiffres.Par défaut, il comporte 8 caractères. Remarque :
|