연동 파트너를 위한 추가 가이드 - 고객을 위한 싱귤러 링크에 대한 추가 가이드
싱글 추적 링크는 다양한 파라미터를 지원합니다. 광고 네트워크는 싱귤러 트래킹 링크를 제공할 때 이러한 파라미터를 입력하여 클릭 또는 노출에 대한 추가 정보를 싱귤러에 전달할 수 있습니다.
추적 링크를 수신한 싱귤러 트래커는 파라미터를 읽고 다양한 방식으로 사용합니다:
- 결정론적 또는 확률론적 어트리뷰션 개선
- 집계된 보고서에서 더 높은 세분성 제공:캠페인, 하위 캠페인(광고 그룹/광고 세트), 크리에이티브 등에 대한 모든 데이터는 싱귤러 트래커에 저장되어 보고서에서 추가적인 세부 정보를 제공하는 데 사용됩니다.
- 사용자 수준(이벤트 수준) 로그에서 추가 데이터 제공: 로그 내보내기 및 사용자 수준 데이터 FAQ를 참조하세요.
- 단일 링크 리디렉션 동작 결정하기: 일부 매개변수는 추적 링크의 동작 방식을 결정하는 데 사용됩니다. 이러한 특수 매개변수는 네트워크에서 입력할 필요가 없으며, 고객이 싱귤러 플랫폼에서 생성할 때 싱귤러 링크에 추가됩니다.
표시: 전체 디바이스 데이터 세분성 매개변수 싱귤러 링크 동작 웹사이트 링크 매개변수
추적링크 매개변수 |
설명 | 단일 집계 보고서의 차원 이름 | 단일 사용자 수준 데이터의 필드 이름 | 범주 | ||
|---|---|---|---|---|---|---|
| 웹 UI에서 | API/데이터 대상 스키마 | 웹 UI에서(로그 내보내기) | 데이터 대상 스키마에서 | |||
| ip | 클릭 당시 디바이스의 IP | IP | ip |
장치 및 기타 데이터 | ||
| cl | 클릭 또는 트랜잭션의 ID(가능한 경우) | Click ID | click_id |
장치 및 기타 데이터 | ||
| ve | 사용자 디바이스의 OS 버전입니다. 참고: 숫자 및 소수점만 입력할 수 있습니다. | OS Version | os_version |
장치 및 기타 데이터 | ||
| idfa | 디바이스의 iOS 광고 ID(해시되지 않은/원시) | IDFA | idfa |
장치 및 기타 데이터 | ||
| ifa1 | 기기의 iOS 광고 ID(SHA-1 형식) | IDFA SHA1 |
idfa_sha_1 |
장치 및 기타 데이터 | ||
| ifa5 | 기기의 iOS 광고 ID(MD5 형식) | IDFA MD5 |
idfa_md5 |
장치 및 기타 데이터 | ||
| idfv | 벤더의 iOS 식별자. 이 식별자는 동일한 벤더가 퍼블리싱한 디바이스의 모든 앱에 사용되며, IDFA를 사용할 수 없는 경우 어트리뷰션을 결정하는 데 도움이 될 수 있습니다. | IDFV | idfv |
디바이스 및 기타 데이터 | ||
| ifv1 | 공급업체용 iOS 식별자(SHA-1 형식) | IDFV SHA-1 |
장치 및 기타 데이터 | |||
| ifv5 | 공급업체용 iOS 식별자(MD5 형식) | IDFV MD5 |
장치 및 기타 데이터 | |||
| aifa | 사용자 기기의 안드로이드 광고 ID(일명 GAID) | GAID | gaid |
장치 및 기타 데이터 | ||
| aif1 | 사용자 기기의 안드로이드 광고 ID, 일명 GAID(SHA-1 형식) | GAID SHA1 | gaid_sha_1 |
장치 및 기타 데이터 | ||
| aif5 | 사용자 기기의 안드로이드 광고 ID, 일명 GAID(MD5 형식) | GAID MD5 | gaid_md5 |
장치 및 기타 데이터 | ||
| andi | 사용자 기기의 안드로이드 ID(이 식별자는 GAID를 지원하지 않는 구형 기기에서 제공되기도 함). | Android ID | android_id |
디바이스 및 기타 데이터 | ||
| and1 | 사용자 디바이스의 Android ID(SHA-1 형식) | Android ID SHA-1 | android_ sha1 |
장치 및 기타 데이터 | ||
| and5 | 사용자 디바이스의 Android ID(MD5 형식) | Android ID MD5 | android_id_ md5 |
장치 및 기타 데이터 | ||
| oaid | 사용자 디바이스의 개방형 익명 디바이스 ID(중국에서 사용) | OAID | 장치 및 기타 데이터 | |||
| amid |
아마존 광고 ID | AMID |
장치 및 기타 데이터 | |||
| sng_ref |
구글 플레이 인스톨 리퍼러. 안드로이드 기기에서 인스톨 리퍼러 기반 어트리뷰션을 활성화하기 위해 S2S 통합이 있는 경우 이 파라미터를 사용합니다. 자세히알아보기 |
장치 및 기타 데이터 | ||||
| ua | 디바이스의 사용자 에이전트 | User Agent | 장치 및 기타 데이터 | |||
| lc | 디바이스의 언어 기본 설정(예: "en-US") | Locale | 장치 및 기타 데이터 | |||
| pssn | 퍼블리셔 앱 내 사이트/배치 위치의 이름입니다. | Sub Publisher Name | sub_publisher_name |
장치 및 기타 데이터 | ||
| pssid | 퍼블리셔 앱 내 사이트/배치 위치의 ID입니다. | Sub Publisher ID | sub_publisher_id |
장치 및 기타 데이터 | ||
| p |
디바이스 플랫폼(Android/iOS) | Platform | platform |
Platform | platform | 세분성 매개변수 |
| pcn | 캠페인의 이름 | Campaign Name | campaign_name | Campaign Name | campaign_name |
세분성 매개변수 |
| pcid | 캠페인의 ID | Campaign ID | campaign_id | Campaign ID | campaign_id |
세분성 매개변수 |
| pscn | 하위 캠페인의 이름입니다. 하위 캠페인은 일부 네트워크에서 캠페인 수준 아래의 추가 세분화입니다. 광고 세트 또는 광고 그룹이라고도 합니다. | Sub Campaign Name | sub_campaign_name | Sub Campaign Name | sub_campaign_name |
세분성 매개변수 |
| pscid | 하위 캠페인의 ID입니다. 하위 캠페인은 일부 네트워크에서 캠페인 수준 아래의 추가 분류입니다. 광고 세트 또는 광고 그룹이라고도 합니다. | Sub Campaign ID | sub_campaign_id | Sub Campaign ID | sub_campaign_id |
세분성 매개 변수 |
| pcrn | 크리에이티브의 이름(네트워크에 따라, 싱글의 '크리에이티브'가 네트워크의 '광고'와 동일하거나 각 광고에 대해 여러 개의 크리에이티브가 있을 수 있음). | Creative Name | creative_name |
Creative Name | creative_name | 세분성 매개변수 |
| pcrid | 크리에이티브의 ID(네트워크에 따라, 싱귤러의 '크리에이티브'가 네트워크의 '광고'와 동일하거나 각 광고에 대해 여러 개의 크리에이티브가 있을 수 있음). | Creative ID | creative_id |
Creative ID | creative_id | 세분성 매개변수 |
| pshid | 광고가 게재된 앱의 ID입니다. ID는 해시 또는 익명화됩니다. | Publisher ID | publisher_id |
Publisher Hashed ID | publisher_hashed_id |
세분성 매개변수 |
| psn | 광고가 게재된 앱의 이름(일반적으로 관련 앱 스토어에 있는 앱 이름)입니다. | Publisher Site Name | publisher_site_name |
Publisher Name | publisher_name |
세분성 매개변수 |
| psid | 광고가 게재된 앱의 공개 ID(일반적으로 관련 앱 스토어에 있는 앱의 ID)입니다. | Publisher Site ID | publisher_site_id |
Publisher ID | publisher_id |
세분성 매개변수 |
| kw | 검색 키워드(구글 광고 및 애플 검색 광고의 경우) | Keyword | keyword |
Keyword | 세분성 매개변수 | |
| paffn | 제휴사 이름(이를 보고하는 제휴 네트워크의 경우) | Affiliate Name | affiliate_name |
Affiliate Name | affiliate_name |
세분성 매개변수 |
| paffid | 제휴사의 ID(이를 보고하는 제휴 네트워크의 경우) | Affiliate ID | affiliate_id |
Affiliate ID | affiliate_id | 세분성 매개변수 |
| _dl | 모든 모바일 플랫폼에 대한 딥링크입니다. 참고: 이 쿼리 매개변수를 재정의/사용하는 것은 원본 링크가 딥링킹으로 활성화된 경우에만 가능합니다. | 단일 링크 리디렉션 동작 | ||||
| _ddl | 모든 모바일 플랫폼에 대한 디퍼드 딥링크. 참고: _ddl은 생성 시 UI를 통해 디퍼드 딥링크를 활성화하지 않았더라도 디퍼드 딥링크를 활성화할 수 있습니다. | 단일 링크 리디렉션 동작 | ||||
| _fallback_redirect | 비안드로이드 및 비iOS 플랫폼용 폴백 리디렉션(일반적으로 웹에 사용됨) | 단일 링크 리디렉션 동작 | ||||
| _android_redirect | 안드로이드 리디렉션: 앱이 Android에 설치되지 않은 경우 리디렉션 URL. 일반적으로 앱 스토어 URL입니다. | 단일 링크 리디렉션 동작 | ||||
| _samsung_redirect | 삼성 기기용 안드로이드 리디렉션: 앱이 삼성 기기에 설치되지 않은 경우 URL을 리디렉션합니다. 삼성 앱 스토어 값이 지원됩니다(samsungapps://ProductDetail/com.game.app). 이 리디렉션 옵션을 사용한 딥링킹은 현재 지원되지 않습니다. | 단일 링크 리디렉션 동작 | ||||
| _android_dl | 딥링크(안드로이드): 일반적으로 Android의 딥링크 URL이 iOS 앱과 다른 경우에 사용됩니다. | 단일 링크 리디렉션 동작 | ||||
| _android_ddl | 디퍼드 딥링크(안드로이드): 일반적으로 안드로이드의 딥링크 URL이 iOS 앱과 다른 경우 사용됩니다. 참고: _android_ddl은 생성 시 UI를 통해 활성화하지 않아도 디퍼드 딥링크를 활성화할 수 있습니다. | 단일 링크 리디렉션 동작 | ||||
| _ios_redirect | iOS 리디렉션(iOS): 앱이 iOS에 설치되지 않은 경우 URL을 리디렉션합니다. 일반적으로 앱 스토어 URL입니다. | 단일 링크 리디렉션 동작 | ||||
| _ios_dl | 딥링크(iOS): 일반적으로 iOS의 딥링크 URL이 안드로이드 앱과 다른 경우 사용됩니다. 참고: 이 쿼리 매개변수를 재정의/사용하는 것은 원본 링크가 iOS 딥링킹으로 활성화된 경우에만 가능합니다. | 단일 링크 리디렉션 동작 | ||||
| _ios_ddl | 디퍼드 딥링크(iOS): 일반적으로 iOS의 딥링크 URL이 안드로이드 앱과 다른 경우 사용됩니다. 참고: _ios_ddl은 생성 시 UI를 통해 활성화하지 않아도 디퍼드 딥링크를 활성화할 수 있습니다. | 단일 링크 리디렉션 동작 | ||||
| _p | 패스스루 매개변수는 딥링크 및 디퍼드 딥링크의 구성에 사용됩니다. 프로모션 코드나 제휴사/인플루언서 이름 등을 전달하도록 사용자 지정할 수 있습니다. | Passthrough | passthrough | 단일 링크 리디렉션 동작 | ||
| _force_redirect=1 | 강제 리디렉션: iOS 유니버설 링크가 딥링킹되지 않을 수 있는 경우, &_force_redirect=1(또는 &_force_redirect=true)을 추가하면 싱귤러 링크가 앱 스킴 기반 딥링킹을 사용하여 최종 사용자에게 강제로 딥링킹할 수 있습니다. 싱귤러 링크 동적 리디렉션 처리에서자세히 알아보세요. | 단일 링크 리디렉션 동작 | ||||
| redirect=false | 파트너가 사용자를 스토어로 독립적으로 리디렉션하려는 경우 이 매개변수를 사용해야 합니다. redirect=false인 링크를 클릭하면 스토어로 연결되지 않습니다. | 단일 링크 리디렉션 동작 | ||||
| _forward_params=1 |
전달 매개변수: 리디렉션 대상에서 단수 링크 매개변수에 포함된 모든 정보를 수신하도록 하려면 이 매개변수를 1(또는 true)로 설정하세요. |
단일 링크 리디렉션 동작 | ||||
| an |
애드 네트워크 파트너 | 웹사이트 링크 파라미터 | ||||
| utm_campaign |
웹 랜딩 페이지 URL의 utm_campaign 파라미터 값입니다. *단일 웹 어트리뷰션을 사용하고 "wpcn" 파라미터를 구현하지 않는 경우 이 값은 캠페인 이름으로 사용됩니다. | UTM Campaign* | UTM Campaign | utm_campaign | 웹사이트 링크 파라미터 | |
| utm_medium |
웹 랜딩 페이지 URL의 utm_medium 파라미터 값입니다. | UTM Medium | UTM Medium | utm_medium | 웹사이트 링크 파라미터 | |
| utm_source |
웹 랜딩 페이지 URL의 utm_source 파라미터 값입니다. **이 값은 단일 웹 어트리뷰션을 사용하고 "wpsrc" 매개변수를 구현하지 않는 경우 소스로 사용됩니다. | UTM Source** | UTM Source | utm_source | 웹사이트 링크 파라미터 | |
| utm_term | 웹 랜딩 페이지 URL의 utm_term 파라미터 값입니다. | UTM Term | UTM Term | utm_term | 웹사이트 링크 파라미터 | |
| utm_content | 웹 랜딩 페이지 URL의 utm_content 파라미터 값입니다. | UTM Content | UTM Content | utm_content | 웹사이트 링크 파라미터 | |
| wpcid |
캠페인의 ID | Campaign ID | campaign_id | Campaign ID | campaign_id | 웹사이트 링크 파라미터 |
| wpcn |
캠페인의 이름 | Campaign Name | campaign_name | Campaign Name | campaign_name | 웹사이트 링크 파라미터 |
| wpcrid |
크리에이티브의 ID(네트워크에 따라 싱글의 '크리에이티브'가 네트워크의 '광고'와 동일하거나 각 광고에 대해 여러 개의 크리에이티브가 있을 수 있음). | Creative ID | creative_id | Creative ID | creative_id | 웹사이트 링크 파라미터 |
| wpcrn |
크리에이티브의 이름(네트워크에 따라 싱귤러의 '크리에이티브'가 네트워크의 '광고'와 동일하거나 각 광고에 대해 여러 개의 크리에이티브가 있을 수 있음). | Creative Name | creative_name | Creative Name | creative_name | 웹사이트 링크 파라미터 |
| wpkmatch |
매칭 유형 | 웹사이트 링크 파라미터 | ||||
| wpkwid |
대상 ID | 웹사이트 링크 파라미터 | ||||
| wpkwn |
검색 키워드 | Keyword | keyword | Keyword | 웹사이트 링크 파라미터 | |
| wpscid |
하위 캠페인의 ID입니다. 하위 캠페인은 일부 네트워크에서 캠페인 수준 아래의 추가 분류입니다. 광고 세트 또는 광고 그룹이라고도 합니다. | Sub Campaign ID | sub_campaign_id | Sub Campaign ID | sub_campaign_id | 웹사이트 링크 파라미터 |
| wpscn |
하위 캠페인의 이름입니다. 하위 캠페인은 일부 네트워크에서 캠페인 수준 아래의 추가 분류입니다. 광고 세트 또는 광고 그룹이라고도 합니다. | Sub Campaign Name | sub_campaign_name | Sub Campaign Name | sub_campaign_name | 웹사이트 링크 파라미터 |
| wpsn | 퍼블리셔 앱 내 사이트/플레이스먼트의 이름입니다. | Publisher Site Name | publisher_site_name | Publisher Name | publisher_name | 웹사이트 링크 파라미터 |
| wpsrc |
네트워크 | Source | source | Partner | source | 웹사이트 링크 파라미터 |