連携パートナー向けのその他のガイド • 顧客向けの Singular Links に関するその他のガイド
トラッキングリンクのパラメータは、広告ネットワークパートナーにとって正確なデータ収集とアトリビューションを実現するうえで重要な役割を果たします。Singular のトラッキングリンクは多様なパラメータをサポートしており、広告ネットワークがクリックやインプレッションに関する有用な情報を付加できるようにします。これらのパラメータを設定することで、広告ネットワークは重要なデータを Singular に渡すことができ、キャンペーンパフォーマンスをより正確に測定できるようになります。
トラッキングリンクが発火すると、Singular トラッカーは埋め込まれたパラメータを処理し、次のようなさまざまな方法で活用します。
- 決定論的または確率論的アトリビューションの精度向上
- より深いキャンペーンインサイトの実現： キャンペーン、サブキャンペーン（広告グループ／広告セット）、クリエイティブなどに関するあらゆるデータは Singular トラッカーによって保存され、集計レポートやユーザーレベルログにおける追加のブレイクダウンを提供するために使用されます（ Export Logs and User-Level Data FAQ ）。
- Singular Links のリダイレクト動作の決定： 一部のパラメータはトラッキングリンクの動作を決定するために使用されます。これらの特殊なパラメータはネットワーク側で設定する必要はなく、顧客が Singular プラットフォーム上で Singular Link を作成する際に追加されます。
トラッキングリンクは、Singular の連携メディアソースとしての統合における重要な構成要素です。クリックやインプレッションに関する不可欠なデータを渡すことができ、正確なアトリビューションとキャンペーン測定を実現します。貴社がポストバックもサポートしている場合は、Singular に統合リクエストを送信する前に必ず Postback Macros and Passthrough Parameters for Ad Networks のセクションをご確認ください。必要な詳細をすべて揃えたら、 こちらから申請 して Singular の連携メディアソースになることができます。
表示： すべて デバイスデータ 粒度パラメータ Singular Links の動作 Website Links パラメータ
|
トラッキングリンクパラメータ |
説明 |
Dimension Name in Singular Aggregated Reports
|
Field Name in Singular User-Level Data
|
カテゴリ | ||
|---|---|---|---|---|---|---|
|
In Web UI
|
In API/ Data Destination Schemas
|
In Web UI (Export Logs)
|
In Data Destination Schemas | |||
| ip | クリック時のデバイスの IP | IP |
ip
|
Device and Other Data | ||
| cl | クリックまたはトランザクションの ID（利用可能な場合） | Click ID |
click_id
|
Device and Other Data | ||
| ve | ユーザーのデバイス上の OS バージョン。注：数値および小数のみ。 | OS Version |
os_version
|
Device and Other Data | ||
| idfa | デバイスの iOS 広告 ID（ハッシュ化されていない生の値） | IDFA |
idfa
|
Device and Other Data | ||
| ifa1 | デバイスの iOS 広告 ID（SHA-1 形式） |
IDFA SHA1
|
idfa_sha_1
|
Device and Other Data | ||
| ifa5 | デバイスの iOS 広告 ID（MD5 形式） |
IDFA MD5
|
idfa_md5
|
Device and Other Data | ||
| idfv | iOS の Identifier for Vendor。この識別子は同一ベンダーが公開しているデバイス上のすべてのアプリで使用され、IDFA が利用できない場合にアトリビューションの判定に役立つことがあります。 | IDFV |
idfv
|
Device and Other Data | ||
| ifv1 | iOS の Identifier for Vendor（SHA-1 形式） |
IDFV SHA-1
|
Device and Other Data | |||
| ifv5 | iOS の Identifier for Vendor（MD5 形式） |
IDFV MD5
|
Device and Other Data | |||
| aifa | ユーザーのデバイスの Android 広告 ID（AAID）。別名 GAID。 | GAID |
gaid
|
Device and Other Data | ||
| aif1 | ユーザーのデバイスの Android 広告 ID（AAID）、別名 GAID（SHA-1 形式） | GAID SHA1 |
gaid_sha_1
|
Device and Other Data | ||
| aif5 | ユーザーのデバイスの Android 広告 ID（AAID）、別名 GAID（MD5 形式） | GAID MD5 |
gaid_md5
|
Device and Other Data | ||
| oaid | ユーザーのデバイスの Open Anonymous Device ID（中国で使用） | OAID | Device and Other Data | |||
|
amid
|
Amazon 広告 ID |
AMID
|
Device and Other Data | |||
|
sng_ref
|
Google Play インストールリファラー。S2S アトリビューションリンク連携がある場合、このパラメータを使用して Android デバイスでのインストールリファラーベースのアトリビューションを有効にします。
詳細はこちら
|
Device and Other Data | ||||
| ua |
デバイスのユーザーエージェント
iOS 26 以降、ユーザーエージェントにバージョンが付加されます。渡されるユーザーエージェントが、バージョンを含む完全なユーザーエージェントであることを確認してください。例： Mozilla/5.0 (iPhone; CPU iPhone OS 18_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/26.0 Mobile/15E148 Safari/604.1 |
User Agent | Device and Other Data | |||
| pssn | パブリッシャーアプリ内のサイト／プレースメントの名前。 | Sub Publisher Name |
sub_publisher_name
|
Device and Other Data | ||
| pssid | パブリッシャーアプリ内のサイト／プレースメントの ID。 | Sub Publisher ID |
sub_publisher_id
|
Device and Other Data | ||
|
p
|
デバイスのプラットフォーム（Android／iOS） | Platform |
platform
|
Platform | platform | Granularity Parameters |
| pcn | キャンペーンの名前 | Campaign Name | campaign_name | Campaign Name |
campaign_name
|
Granularity Parameters |
| pcid | キャンペーンの ID | Campaign ID | campaign_id | Campaign ID |
campaign_id
|
Granularity Parameters |
| pscn | サブキャンペーンの名前。サブキャンペーンは、一部のネットワークにおけるキャンペーンレベルの下位の追加ブレイクダウンです。広告セットまたは広告グループと呼ばれることもあります。 | Sub Campaign Name | sub_campaign_name | Sub Campaign Name |
sub_campaign_name
|
Granularity Parameters |
| pscid | サブキャンペーンの ID。サブキャンペーンは、一部のネットワークにおけるキャンペーンレベルの下位の追加ブレイクダウンです。広告セットまたは広告グループと呼ばれることもあります。 | Sub Campaign ID | sub_campaign_id | Sub Campaign ID |
sub_campaign_id
|
Granularity Parameters |
| pcrn | クリエイティブの名前（ネットワークによっては、Singular の「クリエイティブ」がネットワークの「広告」と同じ場合もあれば、1 つの広告に複数のクリエイティブが存在する場合もあります）。 | Creative Name |
creative_name
|
Creative Name | creative_name | Granularity Parameters |
| pcrid | クリエイティブの ID（ネットワークによっては、Singular の「クリエイティブ」がネットワークの「広告」と同じ場合もあれば、1 つの広告に複数のクリエイティブが存在する場合もあります）。 | Creative ID |
creative_id
|
Creative ID | creative_id | Granularity Parameters |
| pshid | 広告が配信されたアプリの ID。この ID はハッシュ化または匿名化されています。 | Publisher ID |
publisher_id
|
Publisher Hashed ID |
publisher_hashed_id
|
Granularity Parameters |
| psn | 広告が配信されたアプリの名前（通常は該当するアプリストアでのアプリ名）。 | Publisher Site Name |
publisher_site_name
|
Publisher Name |
publisher_name
|
Granularity Parameters |
| psid | 広告が配信されたアプリの公開 ID（通常は該当するアプリストアでのアプリ ID）。 | Publisher Site ID |
publisher_site_id
|
Publisher ID |
publisher_id
|
Granularity Parameters |
| kw | 検索キーワード（Google Ads および Apple Search Ads 向け） | Keyword |
keyword
|
Keyword | Granularity Parameters | |
| paffn | アフィリエイトの名前（報告するアフィリエイトネットワーク向け） | Affiliate Name |
affiliate_name
|
Affiliate Name |
affiliate_name
|
Granularity Parameters |
| paffid | アフィリエイトの ID（報告するアフィリエイトネットワーク向け） | Affiliate ID |
affiliate_id
|
Affiliate ID | affiliate_id | Granularity Parameters |
| _dl | すべてのモバイルプラットフォーム向けのディープリンク。注：このクエリパラメータの上書き／使用は、元のリンクがディープリンク有効で作成されている場合にのみ可能です。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _ddl | すべてのモバイルプラットフォーム向けの遅延ディープリンク。注：_ddl は、作成時に UI で有効化されていなくても遅延ディープリンクを有効にできます。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _global_redirect |
ユーザーがアプリをインストール済みの場合でも、すべてのプラットフォーム向けにリダイレクトします。
**同じリンク内で他の遷移先上書きパラメータ（例：_fallback_redirect）と併用した場合、_global_redirect の値がリダイレクト先を設定します。 このパラメータには URL エンコードが必要です |
Singular Links Redirect Behavior | ||||
| _fallback_redirect | Android 以外および iOS 以外のプラットフォーム向けのフォールバックリダイレクト（通常は Web 向けに使用）。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _android_redirect | Android リダイレクト：Android でアプリがインストールされていない場合のリダイレクト URL。通常はアプリストアの URL です。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _samsung_redirect | Samsung デバイス向けの Android リダイレクト：Samsung デバイスでアプリがインストールされていない場合のリダイレクト URL。Samsung アプリストアの値がサポートされています（ samsungapps://ProductDetail/com.game.app ）。なお、このリダイレクトオプションでのディープリンクは現在サポートされていません。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _android_dl | ディープリンク（Android）：これは通常、Android のディープリンク URL が iOS アプリのものと異なる場合に使用されます。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _android_ddl | 遅延ディープリンク（Android）：これは通常、Android のディープリンク URL が iOS アプリのものと異なる場合に使用されます。注：_android_ddl は、作成時に UI で有効化されていなくても遅延ディープリンクを有効にできます。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _ios_redirect | iOS リダイレクト（iOS）：iOS でアプリがインストールされていない場合のリダイレクト URL。通常はアプリストアの URL です。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _ios_dl | ディープリンク（iOS）：これは通常、iOS のディープリンク URL が Android アプリのものと異なる場合に使用されます。注：このクエリパラメータの上書き／使用は、元のリンクが iOS ディープリンク有効で作成されている場合にのみ可能です。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _ios_ddl | 遅延ディープリンク（iOS）：これは通常、iOS のディープリンク URL が Android アプリのものと異なる場合に使用されます。注：_ios_ddl は、作成時に UI で有効化されていなくても遅延ディープリンクを有効にできます。 このパラメータには URL エンコードが必要です | Singular Links Redirect Behavior | ||||
| _p | パススルーパラメータは、ディープリンクおよび遅延ディープリンクの設定で使用されます。プロモーションコードやアフィリエイト／インフルエンサー名などを渡すためにカスタマイズできます。 このパラメータには URL エンコードが必要です | Passthrough | passthrough | Singular Links Redirect Behavior | ||
| _force_redirect=1 | 強制リダイレクト：iOS Universal Links が ディープリンクしない可能性 がある場合、&_force_redirect=1（または &_force_redirect=true）を付加すると、Singular Link がアプリスキームベースのディープリンクを使用してエンドユーザーへのディープリンクを強制できます。詳細は Singular Links dynamic redirects handling をご覧ください。 | Singular Links Redirect Behavior | ||||
| redirect=false | このパラメータは、パートナーが独自にユーザーをストアへリダイレクトしたい場合に使用します。&redirect=false を含むリンクをクリックしてもストアには遷移しません。 | Singular Links Redirect Behavior | ||||
| _forward_params=1 |
パラメータ転送オプション：
|
Singular Links Redirect Behavior | ||||
| _og_title |
リンクがソーシャルプラットフォームで共有された際に表示される OG タイトル（見出し）を上書きします。
URL エンコードが必要です。 カスタムソースリンクのみ対応。 |
Singular Links Redirect Behavior | ||||
| _og_desc |
リンクがソーシャルプラットフォームで共有された際に表示される OG 説明を上書きします。
URL エンコードが必要です。 カスタムソースリンクのみ対応。 |
Singular Links Redirect Behavior | ||||
| _og_image |
リンクがソーシャルプラットフォームで共有された際に表示される OG 画像を上書きします。
公開アクセス可能な画像 URL である必要があります。 URL エンコードが必要です。 カスタムソースリンクのみ対応。 |
Singular Links Redirect Behavior | ||||
| force_ios_landing_page | iOS リンクにソーシャルランディングページを強制表示します。Manage Links の「Enable Landing Page」フラグに関係なく機能します。 | Singular Links Redirect Behavior | ||||
| force_android_landing_page | 対応する Meta アプリ（Facebook、Facebook Messenger、Facebook Messenger Lite、Instagram）上の Android リンクにソーシャルランディングページを強制表示します。Manage Links の「Enable Landing Page」フラグに関係なく機能します。 | Singular Links Redirect Behavior | ||||
|
an
|
広告ネットワークパートナー | Website Links Parameters | ||||
|
utm_campaign
|
Web ランディングページ URL の utm_campaign パラメータの値。 * Singular Web Attribution を使用し「wpcn」パラメータを実装していない場合、この値がキャンペーン名として使用されます。 | UTM Campaign* | UTM Campaign | utm_campaign | Website Links Parameters | |
|
utm_medium
|
Web ランディングページ URL の utm_medium パラメータの値 | UTM Medium | UTM Medium | utm_medium | Website Links Parameters | |
|
utm_source
|
Web ランディングページ URL の utm_source パラメータの値。 ** Singular Web Attribution を使用し「wpsrc」パラメータを実装していない場合、この値がソースとして使用されます。 | UTM Source** | UTM Source | utm_source | Website Links Parameters | |
| utm_term | Web ランディングページ URL の utm_term パラメータの値 | UTM Term | UTM Term | utm_term | Website Links Parameters | |
| utm_content | Web ランディングページ URL の utm_content パラメータの値 | UTM Content | UTM Content | utm_content | Website Links Parameters | |
|
wpcid
|
キャンペーンの ID | Campaign ID | campaign_id | Campaign ID | campaign_id | Website Links Parameters |
|
wpcn
|
キャンペーンの名前 | Campaign Name | campaign_name | Campaign Name | campaign_name | Website Links Parameters |
|
wpcrid
|
クリエイティブの ID（ネットワークによっては、Singular の「クリエイティブ」がネットワークの「広告」と同じ場合もあれば、1 つの広告に複数のクリエイティブが存在する場合もあります）。 | Creative ID | creative_id | Creative ID | creative_id | Website Links Parameters |
|
wpcrn
|
クリエイティブの名前（ネットワークによっては、Singular の「クリエイティブ」がネットワークの「広告」と同じ場合もあれば、1 つの広告に複数のクリエイティブが存在する場合もあります）。 | Creative Name | creative_name | Creative Name | creative_name | Website Links Parameters |
|
wpkmatch
|
マッチタイプ | Website Links Parameters | ||||
|
wpkwid
|
ターゲット ID | Website Links Parameters | ||||
|
wpkwn
|
検索キーワード | Keyword | keyword | Keyword | Website Links Parameters | |
|
wpscid
|
サブキャンペーンの ID。サブキャンペーンは、一部のネットワークにおけるキャンペーンレベルの下位の追加ブレイクダウンです。広告セットまたは広告グループと呼ばれることもあります。 | Sub Campaign ID | sub_campaign_id | Sub Campaign ID | sub_campaign_id | Website Links Parameters |
|
wpscn
|
サブキャンペーンの名前。サブキャンペーンは、一部のネットワークにおけるキャンペーンレベルの下位の追加ブレイクダウンです。広告セットまたは広告グループと呼ばれることもあります。 | Sub Campaign Name | sub_campaign_name | Sub Campaign Name | sub_campaign_name | Website Links Parameters |
| wpsn | パブリッシャーアプリ内のサイト／プレースメントの名前。 | Publisher Site Name | publisher_site_name | Publisher Name | publisher_name | Website Links Parameters |
|
wpsrc
|
ネットワーク | Source | source | Partner | source | Website Links Parameters |
短縮リンクのパラメータ上書きを無効にする
デフォルトでは、Singular Link にリダイレクトおよびディープリンクのパラメータ（ _dl 、 _fallback_redirect 、 _ios_redirect など）をクリック時に付加することで、リンクの保存済み設定を動的に上書きできます。これは、同じベースリンクから異なるリダイレクト先を配信する必要がある場合に便利です。
ただし、一部のワークフロー（たとえば、多くのチームメンバーが社内でリンクを共有する場合など）では、リンクの上書きや再利用を防ぎたい場合があります。
Disable short link parameters overrides 機能を使うと、短縮カスタムリンクをロックして、ベースリンクに既に設定されているパラメータが URL への付加によって上書きされないようにできます。ベースリンクに 設定されていない パラメータは、引き続き新しい値として付加できます。
仕組み
| 設定 | 動作 |
|---|---|
| チェックボックスがオフ （デフォルト） | 短縮リンクに付加されたパラメータが反映されます。リンクは標準の Singular Link と同じ動作をします。 |
| チェックボックスがオン |
ベースリンクに
既に設定されている
パラメータはロックされ、短縮リンクに付加しても上書きできません。ベースリンクに
設定されていない
パラメータ（
pcn
、
pcid
、
pcrn
などの粒度パラメータや、
_p
などのパススルーパラメータを含む）は、引き続き新しい値として付加できます。
|
次のリダイレクトおよびディープリンクのパラメータは、ベースリンクに設定されている場合、上書きから特に保護されます。
_dl
,
_android_dl
,
_ios_dl
,
_ddl
,
_android_redirect
,
_android_ddl
,
_ios_redirect
,
_ios_ddl
,
_fallback_redirect
ベースリンクに既に定義されている他のパラメータも保護されます。
有効にする方法（UI）
- Singular プラットフォームで Links → Manage Links に移動します。
- カスタムリンクを見つけてクリックし、編集します（または新規作成します）。
- Disable short link parameters overrides トグルが表示されない場合は、まず Shorten Link をオンに切り替えてみてください。
- Disable short link parameters overrides トグルを有効にします。
- リンクを保存します。
有効にする方法（API）
この設定は、
Singular Links API
でリンクを作成または更新する際にもサポートされています。リクエストボディで
disable_short_link_parameters_overrides
というブール型のオプションパラメータを渡します。
- false （デフォルト）— ベースリンクのパラメータは、短縮リンクに付加することで上書きできます。
- true — ベースリンクに既に設定されているパラメータはロックされ、上書きできません。
Dynamic Short Links API
を使用する場合、生成された短縮リンクは、そのベースとなる Singular Link から
disable_short_link_parameters_overrides
の値を自動的に継承します。追加の設定は必要ありません。
制限事項
- この機能は カスタム（ソース）リンクのみ で利用できます。パートナーリンクでは利用できません。
- これは リンクごとの設定 です。すべてのリンクにわたって許可されるリダイレクト先をアカウントレベルで制御する方法については、 Limiting Override Destinations をご覧ください。
動的ディープリンクおよびサードパーティストアリダイレクトには URL エンコードが必要
URL エンコードは、すべての動的ディープリンクパラメータおよびサードパーティストアリダイレクトパラメータ（例：
_samsung_redirect
や
_android_dl
）で
必須
です。
顧客やパートナーが Singular リンクにクエリパラメータの値を URL エンコードせずに付加した結果、リンクが正しく解決されなかったり、予期せず Play ストアにフォールバックしたりするケースが複数確認されています。
デバイスやブラウザ間で一貫した信頼性の高い動作を確保するため、常に URL エンコードされた値を使用してください。適切なエンコードは次の効果があります。
- 動的ディープリンクの正しい解決を保証します
- サードパーティストアへの信頼性の高いリダイレクトを実現します
- 意図しないフォールバック動作（Play ストアへのリダイレクトなど）を防止します
例
正しい例（URL エンコード済み）：
&_samsung_redirect=samsungapps%3A%2F%2FProductDetail%2Fnet.singular.deviceassist2誤った例（エンコードなし）：
&_samsung_redirect=samsungapps://ProductDetail/net.singular.deviceassist2注： Singular リンクに付加する前に、クエリパラメータの値を常に URL エンコードしてください。