연동 파트너를 위한 추가 가이드 • 고객을 위한 Singular Links 추가 가이드
추적 링크 파라미터는 광고 네트워크 파트너에 대한 정확한 데이터 수집과 어트리뷰션을 보장하는 데 중요한 역할을 합니다. Singular 추적 링크는 광고 네트워크가 클릭 및 노출에 관한 유용한 정보를 추가할 수 있도록 다양한 파라미터를 지원합니다. 이러한 파라미터를 채움으로써 광고 네트워크는 중요한 데이터를 Singular로 전달할 수 있으며, 이를 통해 캠페인 성과를 보다 정밀하게 측정할 수 있습니다.
추적 링크가 트리거되면 Singular 트래커는 포함된 파라미터를 처리하여 다음과 같은 다양한 방식으로 활용합니다:
- 결정론적 또는 확률론적 어트리뷰션 정확도 향상
- 보다 심층적인 캠페인 인사이트 제공: 캠페인, 서브 캠페인(광고 그룹/광고 세트), 크리에이티브 등에 관한 모든 데이터는 Singular 트래커에 저장되어 집계 리포트 및 유저 레벨 로그에서 추가적인 분류를 제공하는 데 사용됩니다 ( 로그 및 유저 레벨 데이터 내보내기 FAQ ).
- Singular Links 리디렉션 동작 결정: 일부 파라미터는 추적 링크의 동작 방식을 결정하는 데 사용됩니다. 이러한 특수 파라미터는 네트워크가 채울 필요가 없으며, 고객이 Singular 플랫폼에서 Singular Link를 생성할 때 링크에 추가됩니다.
추적 링크는 Singular의 연동 미디어 소스로서 여러분의 연동에 있어 핵심 구성 요소입니다. 추적 링크를 통해 클릭 및 노출에 관한 필수 데이터를 전달하여 정확한 어트리뷰션과 캠페인 측정을 보장할 수 있습니다. 귀사가 포스트백도 지원하는 경우, Singular에 연동 요청을 제출하기 전에 광고 네트워크를 위한 포스트백 매크로 및 패스스루 파라미터 섹션을 반드시 검토하시기 바랍니다. 필요한 모든 세부 정보를 수집한 후에는 여기에서 신청 하여 Singular의 연동 미디어 소스가 될 수 있습니다.
표시: 전체 기기 데이터 세분화 파라미터 Singular 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 설치 리퍼러(Install Referrer). Android 기기에서 설치 리퍼러 기반 어트리뷰션을 활성화하려면 S2S 어트리뷰션 링크 연동이 있는 경우 이 파라미터를 사용하세요.
자세히 알아보기
|
Device and Other Data | ||||
| ua |
기기의 사용자 에이전트(user agent)
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 | 서브 캠페인의 이름. 서브 캠페인은 일부 네트워크에서 캠페인 레벨 아래의 추가적인 분류입니다. 광고 세트(Ad Set) 또는 광고 그룹(Ad Group)이라고도 합니다. | Sub Campaign Name | sub_campaign_name | Sub Campaign Name |
sub_campaign_name
|
Granularity Parameters |
| pscid | 서브 캠페인의 ID. 서브 캠페인은 일부 네트워크에서 캠페인 레벨 아래의 추가적인 분류입니다. 광고 세트(Ad Set) 또는 광고 그룹(Ad Group)이라고도 합니다. | Sub Campaign ID | sub_campaign_id | Sub Campaign ID |
sub_campaign_id
|
Granularity Parameters |
| pcrn | 크리에이티브의 이름(네트워크에 따라 Singular의 "크리에이티브"가 네트워크의 "광고"와 동일할 수도 있고, 하나의 광고에 여러 크리에이티브가 있을 수도 있습니다). | Creative Name |
creative_name
|
Creative Name | creative_name | Granularity Parameters |
| pcrid | 크리에이티브의 ID(네트워크에 따라 Singular의 "크리에이티브"가 네트워크의 "광고"와 동일할 수도 있고, 하나의 광고에 여러 크리에이티브가 있을 수도 있습니다). | 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)의 이름(이를 보고하는 제휴 네트워크용) | Affiliate Name |
affiliate_name
|
Affiliate Name |
affiliate_name
|
Granularity Parameters |
| paffid | 제휴사(affiliate)의 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가 아닌 플랫폼용 폴백 리디렉션(일반적으로 웹에 사용됨). 이 파라미터에는 URL 인코딩이 필요합니다 | Singular Links Redirect Behavior | ||||
| _android_redirect | Android 리디렉션: Android에서 앱이 설치되어 있지 않은 경우의 리디렉션 URL. 일반적으로 앱 스토어 URL입니다. 이 파라미터에는 URL 인코딩이 필요합니다 | Singular Links Redirect Behavior | ||||
| _samsung_redirect | 삼성 기기용 Android 리디렉션: 삼성 기기에서 앱이 설치되어 있지 않은 경우의 리디렉션 URL. 삼성 앱 스토어 값이 지원됩니다 ( 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 | 패스스루(passthrough) 파라미터는 딥링크 및 디퍼드 딥링크 구성에 사용됩니다. 프로모션 코드나 제휴사/인플루언서 이름과 같은 정보를 전달하도록 커스터마이징할 수 있습니다. 이 파라미터에는 URL 인코딩이 필요합니다 | Passthrough | passthrough | Singular Links Redirect Behavior | ||
| _force_redirect=1 | 강제 리디렉션: iOS Universal Links가 딥링크되지 않을 수 있는 경우, &_force_redirect=1(또는 &_force_redirect=true)을 추가하면 Singular Link가 앱 스킴 기반 딥링킹을 사용하여 최종 사용자에게 딥링크를 강제할 수 있습니다. 자세한 내용은 Singular Links 동적 리디렉션 처리 에서 확인하세요 | Singular Links Redirect Behavior | ||||
| redirect=false | 이 파라미터는 파트너가 사용자를 자체적으로 스토어로 리디렉션하려는 경우에 사용해야 합니다. &redirect=false가 포함된 링크를 클릭하면 스토어로 이동하지 않습니다. | Singular Links Redirect Behavior | ||||
| _forward_params=1 |
파라미터 전달(forward) 옵션:
|
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
|
웹 랜딩 페이지 URL의 utm_campaign 파라미터 값. * Singular 웹 어트리뷰션을 사용하고 "wpcn" 파라미터를 구현하지 않은 경우, 이 값이 Campaign Name으로 사용됩니다. | UTM Campaign* | UTM Campaign | utm_campaign | Website Links Parameters | |
|
utm_medium
|
웹 랜딩 페이지 URL의 utm_medium 파라미터 값 | UTM Medium | UTM Medium | utm_medium | Website Links Parameters | |
|
utm_source
|
웹 랜딩 페이지 URL의 utm_source 파라미터 값. ** Singular 웹 어트리뷰션을 사용하고 "wpsrc" 파라미터를 구현하지 않은 경우, 이 값이 Source로 사용됩니다. | UTM Source** | UTM Source | utm_source | Website Links Parameters | |
| utm_term | 웹 랜딩 페이지 URL의 utm_term 파라미터 값 | UTM Term | UTM Term | utm_term | Website Links Parameters | |
| utm_content | 웹 랜딩 페이지 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의 "크리에이티브"가 네트워크의 "광고"와 동일할 수도 있고, 하나의 광고에 여러 크리에이티브가 있을 수도 있습니다). | Creative ID | creative_id | Creative ID | creative_id | Website Links Parameters |
|
wpcrn
|
크리에이티브의 이름(네트워크에 따라 Singular의 "크리에이티브"가 네트워크의 "광고"와 동일할 수도 있고, 하나의 광고에 여러 크리에이티브가 있을 수도 있습니다). | Creative Name | creative_name | Creative Name | creative_name | Website Links Parameters |
|
wpkmatch
|
매치 유형(Match Type) | Website Links Parameters | ||||
|
wpkwid
|
타깃 ID(Target ID) | Website Links Parameters | ||||
|
wpkwn
|
검색 키워드(Search Keyword) | Keyword | keyword | Keyword | Website Links Parameters | |
|
wpscid
|
서브 캠페인의 ID. 서브 캠페인은 일부 네트워크에서 캠페인 레벨 아래의 추가적인 분류입니다. 광고 세트(Ad Set) 또는 광고 그룹(Ad Group)이라고도 합니다. | Sub Campaign ID | sub_campaign_id | Sub Campaign ID | sub_campaign_id | Website Links Parameters |
|
wpscn
|
서브 캠페인의 이름. 서브 캠페인은 일부 네트워크에서 캠페인 레벨 아래의 추가적인 분류입니다. 광고 세트(Ad Set) 또는 광고 그룹(Ad Group)이라고도 합니다. | 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
값을 자동으로 상속합니다. 추가 구성은 필요하지 않습니다.
제한 사항
- 이 기능은 커스텀(소스) 링크에만 사용할 수 있습니다. 파트너 링크에는 사용할 수 없습니다.
- 이는 링크별 설정 입니다. 모든 링크에서 허용되는 리디렉션 대상에 대한 계정 레벨 제어는 재정의 대상 제한 을 참조하세요.
동적 딥링크 및 서드파티 스토어 리디렉션에 URL 인코딩 필요
모든 동적 딥링크 파라미터 및 서드파티 스토어 리디렉션 파라미터(예:
_samsung_redirect
또는
_android_dl
)에는 URL 인코딩이
필수
입니다.
고객이나 파트너가 쿼리 파라미터 값을 URL 인코딩하지 않고 Singular 링크에 추가하여 링크가 올바르게 확인되지 않거나 예기치 않게 Play Store로 폴백되는 여러 사례를 확인했습니다.
기기와 브라우저 전반에서 일관되고 신뢰할 수 있는 동작을 보장하려면 항상 URL 인코딩된 값을 사용하세요. 올바른 인코딩은:
- 동적 딥링크의 올바른 확인을 보장합니다
- 신뢰할 수 있는 서드파티 스토어 리디렉션을 가능하게 합니다
- 의도하지 않은 폴백 동작(예: Play Store 리디렉션)을 방지합니다
예시
올바른 예(URL 인코딩됨):
&_samsung_redirect=samsungapps%3A%2F%2FProductDetail%2Fnet.singular.deviceassist2잘못된 예(인코딩되지 않음):
&_samsung_redirect=samsungapps://ProductDetail/net.singular.deviceassist2참고: 쿼리 파라미터 값을 Singular 링크에 추가하기 전에 항상 URL 인코딩하세요.