概要：OneLink APIでは、SMS、メール、Web、QRコードなどのオウンドメディアからユーザーをモバイルアプリへ直接誘導する、パーソナライズされた短縮リンクを大規模に自動生成できます。チャネルをまたいだスムーズなユーザージャーニーを構築し、エンゲージメントの強化とコンバージョンの向上につなげられます。
OneLink APIについて
OneLink APIは、あらゆるオウンドチャネルをモバイルアプリへの直接的な導線として活用できるプレミアム機能です。パーソナライズされた短縮リンクをプログラムから自動生成することで、SMS、メール、Webサイト、ソーシャル投稿など、さまざまなチャネルでユーザーごとに最適化されたジャーニーを大規模に提供し、エンゲージメントの強化とコンバージョンの向上を実現できます。 OneLink APIでは、以下のことができます。
- 短縮リンクをプログラムから作成、取得、更新、削除する。
- より詳細な計測を行うために、アトリビューションパラメーター（例：メディアソース、キャンペーン、アセット）を動的に追加する。
注意：メディアソース（pid）パラメーターは必須です。 - パーソナライズされたリダイレクトパラメーターやディープリンクパラメーターを追加し、商品ページ、クーポン、プロモーションなど、ユーザーごとに最適化されたアプリ内またはWeb上のコンテンツへ誘導する。
- 大量の短縮リンクやQRコードを自動生成する。
- ユースケースに応じて、TTL（Time To Live：有効期間）や更新時の動作をカスタマイズする。詳細はこちら
- 厳格なパラメーターバリデーションにより、想定どおりのリダイレクト動作と安定した計測を実現する。
-
利用量を管理するため、クオータ使用状況を取得する。
例
あるグローバル旅行アプリでは、CRM、メール、QRコードなどのユーザー体験を通じて、コンテキストに応じた数百万件の短縮リンクを毎日生成しています。 OneLink API v2.0を活用し、地域、ロイヤルティランク、特定のアプリ内遷移先に応じて、ユーザーごとのディープリンクを自動生成しています。同時に、すべての市場でガバナンスを維持し、一貫した計測を実現しています。
利用開始手順
OneLink APIの利用を開始するには、以下の手順を行います。
前提条件：AppsFlyerアカウント。 OneLink APIを利用するには、CSMまたはhello@appsflyer.comまでお問い合わせください。
OneLink APIの設定手順：
- OneLink APIトークンを生成します（管理者権限が必要です）。
- OneLinkテンプレートを作成します。
-
テンプレートIDをコピーします。
- テンプレートIDとAPIトークンを開発者に共有し、こちらの手順に従って実装するよう依頼します。
ダッシュボード
OneLink APIダッシュボードでは、日次、月次、および直近3か月のAPI利用状況を確認できます。月間クオータ上限に対する利用状況を把握するのに役立ちます。
OneLink APIダッシュボードの確認方法：
AppsFlyerのサイドメニューから、［エンゲージメント］ > ［OneLink API］の順に選択します。
ユースケース
以下では、OneLink APIを使って、コンテキストに応じたスムーズなアプリへの導線を構築する代表的なユースケースを紹介します。
クロスプラットフォームジャーニー（CTV、デスクトップ、Web-to-app）
有効期間の短いリンクやセッション単位のリンクを生成し、ユーザーがデバイス間をスムーズに移動できるようにします。代表的な例として、テレビ広告に表示するQRコードや、デスクトップ上の「スキャンして続行」フローがあります。ユーザーをアプリ内の適切なステップへ直接誘導できます。
メリット：デバイスをまたいだスムーズな体験の継続とコンバージョンの向上。
CRMを活用したチャネル（SMS、メール、WhatsApp）
値下げ通知、ウェイトリスト、休眠ユーザーの呼び戻し、請求リマインダー、マジックリンクによるサインインなど、ユーザーの意向が高いメッセージを送信する際に、ユーザーごとにパーソナライズされた短縮リンクを生成します。
メリット：一貫したアトリビューションを維持しながら、大規模なパーソナライゼーションを実現。
オフライン／QRコードを活用したエンゲージメント
店頭ツール、レシート、商品パッケージ、イベント会場の掲示物などに掲載できる、スキャン可能なリンクを生成します。印刷物などの物理アセットを作り直すことなく、リンクの遷移先設定を後から更新できます。
メリット：物理アセットを再印刷することなく、動的なルーティングとオフラインアトリビューションを実現。
紹介／アドボケイトによるシェア
インフルエンサー、クリエイター、顧客による紹介プログラム向けに、パラメーターをカスタマイズでき、アトリビューションに対応した共有用短縮リンクを作成できます。
メリット：紹介施策を大規模に計測し、正確にアトリビューション。
特性と制限事項
このセクションでは、OneLink APIの主な特性と制限事項を紹介します。詳細は、完全な一覧を参照してください。
| 特性 | 備考 |
|---|---|
| APIクオータ上限 |
|
| リンクの表示 |
|
注意
OneLink APIの新バージョン（v2.0）は、2025年12月にリリースされました。旧バージョン（v1.0）は非推奨となっており、2026年6月までは引き続き動作しますが、それ以降はメンテナンスされません。新規連携では、OneLink API v2.0を使用してください。移行方法については、Dev Hubの移行ガイドを参照してください。