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

セットアップ

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

AndroidiOS のアプリ初期設定:アプリを開きます(Androidアプリリンク、ユニバーサルリンク、URIスキームのいずれかを使用)。

Implement Unified Deep Linking (UDL)

Android および iOS 向けに ユニファイドディープリンク (UDL) APIを実装し、クリックからデータを取得、そのデータを使用して、パーソナライズされた体験を提供するためにユーザーを特定のアプリ内画面(アクティビティ)にリダイレクトします(既存ユーザー向けディープリンクまたは新規ユーザー向けディファードディープリンク)。このAPIは、高速で使いやすく、オウンドメディアとペイドメディアの両方をサポートしています。

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

場合によっては、ディファードディープリンクに対して UDLが有効化されないことがあります。
例:
- ユーザーがFacebookやTwitterなどのSRN(サーバー連携媒体)の広告リンクをクリックしました。
- ユーザーが次のようなパラメーターを含まないリンクをクリックしました: 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