ディープリンクの挙動フロー

セットアップ

OneLinkの設定には、マーケティング担当者とディベロッパーという、組織内の異なる部署の担当者が共同作業をする必要があります。

マーケティング担当者の役割

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.

📘
ヒント
The marketer and developers need to decide together on the best long-term system for the 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...

開発者の役割

ディベロッパーはアプリ内でOneLinkの設定を行います。

初期設定
UDL APIの実装
拡張ディファードディープリンクの実装

Initial setup

AndroidとiOS のアプリ初期設定：アプリを開きます（Androidアプリリンク、ユニバーサルリンク、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.

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.

Implement UDL

Android SDK iOS SDK 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- クリックからインストールまでの時間が UDLルックバック期間の15分を超えました。このような場合にディファードディープリンク作業を保証するには、 onConversionDataSuccess (OCDS) メソッドは、GCD API の一部です。OCDSは通常、コンバージョンデータを取得するために使用され、UDL以前は、ディファードディープリンクを処理するための排他的な方法でした。
重要：UDLとOCDSの両方を実装する場合、ディファードディープリンクを処理するメソッドの 1つだけ を保証するのは開発者の責任です。
Android および iOS 用の拡張ディファードディープリンクを実装する手順をご覧ください。

Legacy: Use only GCD API for Deep-Linking

注：OneLinkを既に使用している広告主様は、ディープリンクとディファードディープリンクにて、UDLではなく従来のメソッドを使用している可能性があります。
従来のメソッドは、次の2つのメソッドで構成される GCD APIのみを使用します： onConversionDataSuccess for deferred deep linking and onAppOpenAttribution for deep linking. See information about the legacy methods for Android and iOS.

推奨： GCD APIのみが実装されているアプリでは、 UDLと拡張ディファードディープリンクを実装してください。

User invites

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