メインコンテンツへスキップ

​
リンクの仕組み

すべてのOneSignalメッセージ（プッシュ、メール、アプリ内メッセージ、SMS、RCS）には、クリックするとユーザーを特定の場所に誘導するURLを含めることができます。その場所はブラウザで開くWebページ、またはディープリンクによってアプリ内で直接開くコンテンツです。 URLの設定方法はチャネルによって異なります：
  • プッシュ：ダッシュボードのLaunch URLフィールド、またはAPIのurlパラメータを使用します。
  • メール：メールエディタまたはHTMLでリンクを追加します。OneSignalはクリックを自動的に追跡します。
  • アプリ内メッセージ：ボタン、画像、背景にクリックアクションを設定します。
  • SMS/RCS：リンクをインラインで追加します。ダッシュボードのInsert Trackable Linkを使用すると、自動短縮と追跡が適用されます。SMS/RCS追跡可能リンクを参照してください。

​
ディープリンク

ブラウザではなくアプリ内でコンテンツを開くには、ディープリンクを使用します。ディープリンクのサポートはチャネルによって異なります：
  • プッシュとアプリ内メッセージ：your-app://product/123のようなカスタムURLスキームやhttps://ユニバーサルリンク / App Linksをサポートします。
  • メールとSMS：https://ユニバーサルリンク / App Linksのみサポートされます。メールクライアントやSMSアプリはカスタムURLスキームを処理しないため、カスタムURLスキームは機能しません。

ディープリンク

カスタムURLスキーム、ユニバーサルリンク、アプリ固有のルーティングの完全なセットアップガイド。

​
プッシュ

​
Launch URL

Launch URLは、ユーザーがプッシュ通知をクリックしたときに開きます。https://で始まる必要があります。
Apple デバイスでhttp:// URLを使用するには、アプリのInfo.plistファイルでNSAppTransportSecurityプロパティを設定する必要があります。
WebユーザーとモバイルユーザーのSubscription両方に単一のメッセージを送信する場合は、プラットフォーム固有のURLフィールドを使用します：
  • url — すべてのプラットフォームをターゲットにします
  • web_url — WebプッシュのSubscriptionのみをターゲットにします
  • app_url — モバイルのSubscriptionのみをターゲットにします
プッシュ通知のLaunch URL入力フィールドが表示されているOneSignalダッシュボード
Webプッシュ通知をページを開かずに閉じるには、Launch URLに?_osp=do_not_openを追加します（例：https://yoursite.com/page?_osp=do_not_open）。これはWebプッシュのみで機能します。

​
Additional data

Launch URLの代わりに、Additional Dataフィールド（APIではdata）を使用してカスタムキーと値のペアを送信できます。アプリはadditionalDataプロパティを通じてSDKの通知クリックリスナーでこのデータを読み取ります。単一のURLよりも柔軟性が必要な場合に便利です。
カスタムキーと値のペアを持つAdditional Dataフィールドが表示されているOneSignalダッシュボード
OneSignalはメール内のリンククリックを、メールまたはテンプレートでTrack link clicksが有効になっている場合（デフォルトで有効）に自動的に追跡します。OneSignalはメール全体および個別リンクごとの合計クリック数とユニーククリック数を追跡します（メールあたり最大30件のリンク）。これらの統計はEmail Message Reportsで確認できます。
購読解除リンクについては、Unsubscribe Links & Email Subscriptionsを参照してください。
リンクごとの合計クリック数とユニーククリック数を示すクリックアクティビティが表示されているOneSignalメールメッセージレポート
追跡はURLを書き換えてクリックイベントをキャプチャし、ユーザーを元の宛先にリダイレクトすることで機能します。これはほぼ瞬時に行われますが、ディープリンクで予期しない動作を引き起こす場合があります。例えば：https://some-domain.com/the-pageは次のようになります：https://some-domain/c/eJxU0D2uGzEMBODTrDoZJPW3...ユーザーはすぐに元のURLにリダイレクトされます。
Liquid構文でリンクを構築している場合、OneSignalがリンクを自動的に検出できないことがあります。リンクを追跡可能として明示的にマークします： 
{{ 'https://some-domain.com/the-page' | track_link }}
メール全体の追跡を無効にするには、ダッシュボードのメールエディタでTrack link clicksのチェックを外すか、APIでdisable_email_click_tracking: trueを設定します。
Track link clicksのチェックが外れているOneSignalダッシュボードのメール設定
特定のリンクのみ追跡を無効にし、他のリンクの追跡は有効のままにするには： 
{{ 'https://some-domain.com/the-page' | do_not_track_link }}
メール全体の追跡を無効にすると、クリックデータは収集されず、Email Message ReportsのCTRは「N/A」と表示されます。
OneSignalは1sgnl.coドメインを使用してSMS/RCSメッセージ用の追跡可能な短縮リンクを提供します。URLを{{ "https://your-url.com" | track_link }}で囲むだけで、メッセージ送信時にリンクが追跡可能なリンクに置き換えられます。APIの使用方法については、SMS/RCSメッセージ作成APIリファレンスを参照してください。 SMS/RCSメッセージごとに追跡可能なリンクは1件のみ使用できます。 ダッシュボードを使用する場合は、メッセージ入力ボックスの下にあるInsert Trackable LinkボタンをクリックしてURLを入力します：
SMSメッセージに追跡可能な短縮リンクを挿入するためのOneSignalダッシュボードのモーダル
Insert trackable linkをクリックして、短縮リンクをメッセージに追加します： 
Your order is on its way!
Track it here: {{ "https://your-url.com" | track_link }}
メッセージ送信時に、二重波括弧とその中のすべての内容が1sgnl.co/XXXXの追跡可能なリンクに置き換えられます：
追跡可能な短縮リンクが表示されているモバイルデバイスのSMS通知

​
動的URL

Liquid構文を使用して、パーソナライズされたユーザー固有のURLを作成できます。例えば、URLにユーザーのIDを含めてそれぞれのプロフィールページに誘導したり、最近のイベントの商品IDを挿入して関連アイテムに直接リンクしたりできます。 動的URLは以下のデータを参照できます：
  • ユーザープロパティ（例：external_id、email）
  • OneSignalに保存されたタグ
  • APIを介して送信されるcustom_data
  • カスタムイベント（ジャーニー内）
external_idやemailなどの値をURLに直接注入します。
https://yourdomain.com/profile/user={{subscription.external_id}}
ユーザーのexternal_idが12345の場合、最終的なURLは次のようになります：
https://yourdomain.com/profile/user=12345
同様に：
https://yourdomain.com/profile/email={{subscription.email}}
ユーザーのメールアドレスがjohn@example.comの場合、最終的なURLは次のようになります：
https://yourdomain.com/profile/email=john@example.com
URLの一部にのみデータを挿入してください。プロトコル（https://）とドメインは静的なテキストとして保持します。値が存在しない場合のフォールバックを設定するにはdefaultフィルターを使用します。

​
UTMパラメータ

UTMパラメータは、URLにsource、medium、campaignの詳細を追加することでキャンペーンのパフォーマンスを追跡します。メッセージ内のURLにUTMパラメータを直接追加するだけです。 ダッシュボードから送信されるプッシュ通知については、OneSignalがUTMを自動的に追加できます。
Settings > Push & In-app > UTM Settingsに移動し、Turn on automated UTM taggingを有効にします。有効にすると、OneSignalは以下の値を追加します（編集可能）：
  • Source = utm_source — デフォルトはonesignal
  • Medium = utm_medium — デフォルトはpush
  • Campaign = utm_campaign — デフォルトは{{ sendDate }}-{{ title }}
    • sendDate：送信日
    • title：メッセージタイトルからの最初の15個の英数字、アンダースコア、またはハイフン
例：
https://test.com?utm_source=onesignal&utm_medium=push&utm_campaign=2020-06-03-sale-today
自動UTMタグ付けはダッシュボードから送信されるプッシュ通知にのみ適用されます。以下では機能しません：
  • メール、SMS、アプリ内メッセージ
  • ジャーニー、テンプレート、自動メッセージ
  • APIリクエスト
  • 「Send Test Message」ボタン
  • Additional dataフィールド
これらの場合は、テンプレートまたはAPIペイロードにUTMパラメータを手動で追加する必要があります。

​
URLの処理と上書き

自動タグ付けが有効な状態でLaunch URLにUTMパラメータを手動で追加した場合、手動で設定したUTMが自動設定の値を上書きします。

​
FAQ

​
アプリストアにリンクするにはどうすればよいですか？

ストアURLをLaunch URLとして使用します：
  • Android：Google Playリンクを使用します（例：https://play.google.com/store/apps/details?id=com.example.app）。Google Playへのリンクを参照してください。
  • iOS：App StoreリンクのURLを使用しますが、https://をitms-apps://に置き換えてApp Storeアプリを直接開きます（例：itms-apps://apps.apple.com/app/id123456789）。

​
別のアプリにリンクできますか？

プッシュとアプリ内メッセージでは、URLスキームを使用して別のアプリにディープリンクできます。例えば、WhatsAppへのディープリンクにはwhatsapp://wa.me/15551234567を使用します。 メールとSMSでは、代わりにhttps://リンクを使用してください。カスタムURLスキームはサポートされていません。

​
Launch URLが機能しないのはなぜですか？

よくある原因：
  • URLの形式：URLはhttps://で始まる必要があります。Apple デバイスでhttp://を使用している場合は、NSAppTransportSecurityの設定が必要です。
  • モバイルでのカスタムスキーム：your-app://pathのようなディープリンクは、すべてのプラットフォームでLaunch URLとして機能しない場合があります。Additional Dataフィールドを使用するか、ディープリンクを参照して確実なアプリルーティングを設定してください。
  • Webプッシュのデフォルト動作：Launch URLが設定されていない場合、Webプッシュはホームページを開きます。宛先を制御するにはLaunch URLを明示的に設定してください。
  • クリック追跡の干渉：メールでは、クリック追跡のためのURL書き換えがディープリンクを壊す場合があります。特定のリンクのクリック追跡を無効にすることを試してください。

​
UTMパラメータはメールとSMSで機能しますか？

いいえ。自動UTMタグ付けはダッシュボードから送信されるプッシュ通知にのみ適用されます。メールとSMSの場合は、テンプレートまたはAPIペイロードのURLにUTMパラメータを手動で追加してください。制限の完全なリストについてはUTMパラメータを参照してください。

​
プッシュ通知がURLを開かないようにできますか？

モバイルでは、プッシュ通知をクリックすると常にアプリが開きます。 Webでは、Launch URLに?_osp=do_not_openを追加することで、ページを開かずに通知を閉じることができます。例についてはLaunch URLのヒントを参照してください。

ディープリンク

プッシュとアプリ内メッセージのカスタムURLスキームとアプリ固有のルーティングを設定します。

パーソナライゼーション

Liquid構文とタグを使用してメッセージに動的なユーザーデータを挿入します。

Liquid構文の使用

OneSignalテンプレートにおけるLiquidフィルター、タグ、変数のリファレンスガイド。

メールメッセージレポート

メールキャンペーンの配信数、開封数、クリック率の指標を確認します。

アクションボタン

カスタムURLを使用してプッシュ通知にコールトゥアクションボタンを追加します。