概要：OneLink API を使うと、SMS、メール、Web、QR コードなど、あらゆる自社メディアからユーザーを直接モバイルアプリへ誘導する「パーソナライズされた短縮リンク」を大量に自動生成できます。これにより、チャネルを横断したスムーズなユーザージャーニーを実現し、エンゲージメントとコンバージョンを向上させます。
OneLink APIについて
OneLink API は、任意の自社チャネルをモバイルアプリへの直接導線に変えるためのプレミアム機能です。 パーソナライズされた短縮リンクをプログラムで自動生成することで、スケールの大きいカスタマイズされたユーザージャーニーを実現し、SMS・メール・Web・ソーシャル投稿など、あらゆるチャネルでのエンゲージメントとコンバージョンを高められます。OneLink API を使うことで、次のことが可能になります。
- プログラムを使って、短縮リンクを作成・取得・更新・削除できます。
- 配信元の詳細な計測のために、アトリビューションパラメータ（media source、campaign、asset など）を動的に追加できます。
注意：メディアソースパラメータ（pid）は必須です。 - ユーザーごとに最適化されたリダイレクト遷移やディープリンクを設定し、商品ページやクーポン、キャンペーンページなど、個別のアプリ内／Web コンテンツへ誘導できます。
- 大量の短縮リンクや QR コード を自動生成できます。
- TTL（Time To Live）と更新動作をユースケースごとにカスタマイズできます。（詳細はこちら）
- 厳密なパラメータバリデーションにより、予測可能なリダイレクト動作と確実な計測を保証します。
-
利用量取得 API によって、クオータの消費量を管理できます。
例
あるグローバルの旅行アプリでは、CRM、メール、QR など複数チャネルにおいて、数百万規模の文脈に応じた短縮リンクを毎日生成しています。OneLink API v2.0 を利用することで、地域・会員ランク・アプリ内の遷移先に応じたユーザー専用のディープリンクを自動で構築しつつ、すべてのマーケットでガバナンスと計測の一貫性を保つことができています。
利用開始手順
OneLink API を利用するには、以下の手順に従ってください：
前提条件：AppsFlyer アカウントが必要です。OneLink API へのアクセスをご希望の場合は CSM または hello@appsflyer.com までお問い合わせください。
OneLink APIの設定方法：
- OneLink API トークン を生成してください。（Admin 権限が必要です）
- OneLinkテンプレートを作成してください。
-
テンプレート ID をコピーしてください。
- テンプレート ID と API トークンを開発者に共有し、以下の開発者向けガイドに沿って実装を依頼してください。
ダッシュボード
OneLink API ダッシュボードでは、日次・月次・3 か月分の API 利用状況を確認できます。これにより、月間クオータ上限に対する消費状況を把握できます。
OneLink API管理画面を表示する方法：
AppsFlyer管理画面 左メニュー エンゲージメント > OneLink管理へ移動します。
使用事例
次に挙げるユースケースは、OneLink API を使ってアプリへのシームレスで文脈に沿ったジャーニーを構築する代表的な方法を示しています。
クロスプラットフォームのユーザージャーニー（CTV・デスクトップ・Web-to-app）
短い有効期限のリンクやセッション単位のリンクを生成し、ユーザーがデバイス間を途切れなく移動できるようにします。代表的な例として、テレビ CM に表示する QR コードや、デスクトップから「スマホで続行」するための QR コードなどが挙げられ、ユーザーを適切なアプリ内ステップに直接誘導できます。
メリット：デバイスをまたいだスムーズな継続体験とコンバージョン向上
CRMを活用するチャネル（SMS・メール・WhatsApp）
プッシュ通知やメール送信時に、ユーザーごとにパーソナライズした短縮リンクを生成します。例えば、値下げ通知、ウェイトリスト、復帰施策（win-back）、請求リマインダー、マジックリンクログインなど、高い意図を持つメッセージで活用できます。
メリット：大規模パーソナライゼーションと一貫したアトリビューション
オフラインおよびQRでののエンゲージメント
店頭ツール、レシート、パッケージ、イベント看板などからスキャンできるリンクを生成します。リンクの遷移先は後から更新できるため、物理的な素材を再印刷する必要がありません。
メリット：物理媒体の再印刷なしで動的なルーティングとオフライン計測を実現
ユーザー紹介および支持者によるシェア
インフルエンサー、クリエイター、既存ユーザーの紹介プログラム向けに、シェア可能な短縮リンクを用意できます。パラメータも柔軟にカスタマイズでき、計測可能なルーティングを設定できます。
メリット：紹介施策を正確に測定し、スケールさせることが可能
特性と制限
以下は OneLink API の主な特徴と制限事項の抜粋です。詳細は完全版ドキュメントを参照してください。
| 特性 | 備考 |
|---|---|
| API回数制限 |
|
| リンクの可視性 |
|
注意：
OneLink API の新バージョン（v2.0）が 2025 年 12 月にリリースされました。旧バージョン（v1.0）は非推奨となっており、2026 年 6 月までは動作しますが、それ以降はサポートされません。新規実装は OneLink API v2.0 を使用してください。移行方法については Dev Hub の移行ガイドをご覧ください。