딥링킹 동작 방식

설정

원링크를 설정하려면 기관 내에서 개발자와 마케터가 각자의 리소스를 사용하여 협업해야 합니다.

Marketer role

Marketers plan the marketing campaigns and set up the OneLink URLs. The OneLink URLs are set up to carry parameters (for example, deep_link_value) and data that are used to give users a personalized experience when deep linking and deferred deep linking.

📘

마케팅 담당자와 개발자는 주요 활동의 방법에 대한 최적의 장기 시스템을 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**...

Developer role

개발자는 앱에서 원링크 설정을 수행합니다.

  • Initial setup
  • Implementing the UDL API
  • Implementing extended deferred deep linking

Initial setup

안드로이드iOS 용 초기 앱 설정: 앱을 엽니다(안드로이드 앱 링크, 유니버설 링크 또는 URI 스키마 사용)

Implement Unified Deep Linking (UDL)

Implement the unified deep linking (UDL) API for Android and iOS 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.

Note: For new users, the UDL method only returns parameters relevant to 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.

[Optional] 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 Facebook or Twitter.
- A user clicks a link that doesn't contain parameters like deep_link_value or deep_link_sub1-10.
- The time period between click and install exceeds the UDL lookback window of 15 minutes.
To guarantee deferred deep-linking works in such cases, we recommend implementing the onConversionDataSuccess (OCDS) method, which is part of the GCD API. OCDS is usually used to retrieve conversion data and prior to UDL, was the exclusive method for handling deferred deep linking.
Important: When implementing both UDL and OCDS, it is the developer's responsibility to guarantee that only one of the methods handles deferred deep linking.
See instructions for implementing extended deferred deep linking for Android and iOS.

Legacy: Use only GCD API for Deep-Linking

Developers already using OneLink may be using the legacy methods for deep linking and deferred deep linking, instead of UDL.
The legacy methods exclusively use the GCD API, which consists of two methods: onConversionDataSuccess for deferred deep linking and onAppOpenAttribution for deep linking. See information about the legacy methods for Android and iOS.

Recommended: Apps with only the GCD API implemented should implement UDL and extended deferred deep linking.

User invites

Allow users to refer others to the app using OneLink links by creating user invites