Flux de deep linking

Configuration

Implémenter OneLink requiert la collaboration de deux fonctions issus d'une même organisation, et la mise en commun de leur spécialisation : le marketeur et le développeur.

Rôle du marketeur

Le marketeur planifie les campagnes marketing et configure les URL OneLink. Les URL OneLink sont configurées pour acheminer les paramètres (par exemple, deep_link_value) et les données qui permettront aux utilisateurs de profiter d'une expérience personnalisée avec le deep linking et deep linking différé.

📘
Astuce
Le marketeur et les développeurs doivent décider ensemble de la meilleure stratégie à long terme pour deep_link_value (and any other parameters/values) to minimize additional app updates.
The deep_link_value can be based on a SKU, post ID, path, or anything else. We strongly recommend agreeing on a system that allows for you to enter dynamic values on your chosen parameter, so you can generate many different deep links that go to different content within the app, without any further changes to the app code by the developers.
See the following URL examples. The deep_link_value of a fruit type was chosen by the marketer and developer together. And the developers made the values dynamic, so the marketer could enter any fruit without the need for further work by the dev team.
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=apples...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=bananas...
https://onelink-sample-app.onelink.me/H5hv?pid=Email&c=fruit_of_the_month&deep_link_value=peaches...

Rôle du développeur

Le développeur effectue la configuration OneLink au sein de l'application :

Configuration initiale
Implémentation de l'API UDL
Mise en œuvre du deep linking différé étendu

Initial setup

Configuration initiale de l'app pour Android et iOS : ouvre l'app (à l'aide des liens d'app Android, des liens universels ou des schémas d'URI)

Implement Unified Deep Linking (UDL)

Implement the unified deep linking (UDL) API to retrieve data from the click and use that data to redirect users for a personalized experience to a specific in-app activity (deep linking or deferred deep linking).
This API is fast, easy to use, and supports both owned and paid media sources.

Pour les nouveaux utilisateurs, la méthode du DLU ne renvoie que les paramètres qui concernent le deferred deep linking : deep_link_value and deep_link_sub1-10. If you try to get any other parameters (media_source, campaign, af_sub1-5, etc.), they return null.

Implement UDL

SDK Android SDK iOS Unity plugin

[Recommended] Implement extended deferred deep linking

In some cases, UDL isn't activated for deferred deep-linking. For example, when:
- A user clicks a link from a Self Reporting Network (SRN) like Meta ads or Twitter.
- A user clicks a link that doesn't contain parameters like deep_link_value or deep_link_sub1-10
- Le délai entre le clic et l'installation dépasse de 15 minutes la fenêtre d'attribution du DLU. Pour garantir que le deep-linking différé fonctionne dans de ce cas, nous vous recommandons d'implémenter la méthode onConversionDataSuccess (OCDS), qui fait partie de l'API GCD. La méthode OCDS est généralement utilisé pour récupérer les données de conversion et, avant le DLU, elle était la méthode exclusive pour gérer le deep linking différé.
Important : lors de la mise en œuvre du DLU et de l'OCDS, il incombe au développeur de garantir qu'une seule des méthodes gère le deep linking différé.
Voir les instructions d'implémentation du deep linking différé étendu pour Android et iOS.

Legacy: Use only GCD API for Deep-Linking

Les développeurs qui utilisent déjà OneLink peuvent utiliser les anciennes méthodes pour le deep linking et le deep linking différé, plutôt que le DLU.
Les anciennes méthodes utilisent exclusivement l'API GCD, qui se compose de deux méthodes : onConversionDataSuccess pour le deep linking différé et onAppOpenAttribution pour le deep linking. Voir les informations sur les anciennes méthodes pour Android et iOS.

Recommandé : les apps ne disposant que de l'API GCD doivent implémenter le DLU et le deep linking différé unifié.

User invites

Elles permettent aux utilisateurs de conseiller l'app à d'autres personnes en passant par des liens OneLink qui créent des invitations utilisateur