파트너 컨피규레이션(Partner Configuration) 페이지는 여러 광고 매체와 파트너들과 협업하도록 Singular 트래커를 설정하는 페이지입니다. 시작 단계라면, 파트너 설정과 포스트 백 설정 방법에 관한 문서를 참고합니다.
주의: 이 가이드는 Singular 광고주를 위한 가이드입니다. 만약 Singular의 파트너이거나 파트너가 되기를 희망한다면, 파트너들을 위한 가이드를 참고합니다.
트러블 슈팅
만약 파트너 네트워크가 인스톨/컨버젼 또는 인 앱 이벤트를 수신하지 못한다면 다음 절차를 따릅니다.
- Attribution> Export Logs에서 파트너를 위한 포스트 백 로그를 다운로드합니다. 해당 로그를 다운로드 후, 로그 추출과 유저 레벨 데이터 FAQ를 참고합니다.
- 포스트 백이 Response HTTP Code = 200을 반환했는지 필터하여 확인합니다. HTTP 코드가 "200"을 반환했다면, 이는 파트너가 해당 포스트 백을 수신했다는 의미입니다.
- 또한, 필드에 Response HTTP Body를 선택하여 제공하면 파트너 측에서 기술 관련 이슈를 정확히 확인하는 데 도움이 될 것입니다.
- 내부적으로 데이터를 확인하도록 파트너에게 해당 로그를 공유합니다. 만약 다수의 포스트 백이 다른 응답 코드들을 갖는다면, 파트너가 Singular로부터 포스트 백을 전송받는 데에 기술적인 문제가 있을 수 있음을 알립니다.
만약 파트너 네트워크가 인스톨 또는 인 앱 이벤트들을 모두 받도록 설정했고, 해당 매체에게 이벤트들을 "send all"하는 옵션을 설정했으면, 해당 포스트 백 설정으로 인해 해당 매체에게 계속하여 포스트 백을 전송하게 됩니다. 데이터 전송을 중단하려면 Partner Configuration에서 포스트 백을 삭제하거나 "send all" 박스 체크를 해지해야 합니다. Receiving all Installs의 정의는 Singular 용어사전을 참고합니다.
원인이 될 수 있는 경우는 다음과 같습니다.
- 룩백윈도우(Lookback windows): 하나 이상의 이벤트가 포스트 백 내 각각 다르게 설정된 룩백윈도우를 갖고 있기 때문일 수 있습니다. 파트너 컨피규레이션 (Partner Configuration) 페이지 내 설정을 확인합니다.
- 기술적인 문제: 파트너 측의 기술적인 문제로 인하여 하나 이상의 포스트 백을 수신하지 못할 수 있습니다. 확인을 위해서는, 왜 네트워크 파트너가 포스트 백을 수신하지 못할까요?를 참고합니다.
- 중복 이벤트: 앱 내 Singular SDK는 __REVENUE__ 이벤트를 자동으로 생성하는데, 이것이 인 앱 구매에서 발생된 경우입니다. 이 경우, 각각 다른 종류의 인 앱 구매를 위해 SDK 매출 이벤트를 생성할 수 있습니다. 이벤트 포스트 백 설정 시, __REVENUE__ 또는 귀사가 커스텀 한 매출 이벤트 명으로 포스트 백을 전송하도록 설정할 수 있으나, 둘 다 설정할 수는 없습니다. 이때, 둘 다 설정하게 되면 Singular가 각 인 앱 구매 당 중복 포스트 백을 전송하게 되니 주의합니다.
만약 파트너에게 이벤트 속성에 대한 정보 없이 포스트 백이 전송된다면 다음 절차를 따릅니다.
- Attribution > Export Logs로 가서 파트너에 대한 포스트 백 로그를 다운로드합니다. 포스트 백의 HTTP Body 또는 Target URL 필드를 확인하여 어트리뷰션된 이벤트를 포함하는지 확인합니다. 로그 다운로드에 대한 도움이 필요하다면, 로그 추출과 유저 레벨 FAQ를 참고합니다.
- 로그의 포스트 백이 이벤트 속성 없이 전송된 것이 확실하다면, Partner Configuration 페이지 내 포스트 백 설정을 다시 한번 확인합니다. 만약 이벤트와 함께 어트리뷰션을 보내도록 설정하지 않았다면, 보내도록 설정을 변경합니다.
- 만약 설정이 올바름에도 포스트 백이 어트리뷰션된 이벤트 없이 전송된다면, Singular support에 문의합니다.
만약 네트워크에 지불하는 금액이 인스톨 또는 해당 기간 동안 Singular가 전송한 이벤트 포스트 백의 수에 기반한다면, Attribution > Export Logs의 가공되지 않은 포스트 백 로그를 확인하여 해당 기간 동안 어떤 포스트 백이 파트너로 전송되었는지 확인할 수 있습니다.
만약 네트워크에 지불하는 금액이 Singular가 해당 기간 동안 전송한 인스톨/이벤트 포스트 백 수에 기반한다면, 어트리뷰션 > 로그 추출 (Attribution > Export Logs) 페이지의 미가공 포스트 백 로그를 다운로드하여 어떤 포소트백이 파트너에게 전송됐는지를 재확인할 수 있습니다.
Export Logs 페이지에 대한 일반적인 질문에 대해서는, 로그 추출과 유저 레벨 데이터 FAQ를 참고합니다.
포스트 백을 확인하기 위해서, 다음 설정에 가서 로그를 다운로드합니다.
Response HTTP Code 내 반드시 "200"으로 필터해야 포스트 백 수신인으로부터 수신된 성공적인 포스트 백을 확인할 수 있습니다.
여기서 Partner와 Postback Recipients 필드를 혼동하지 않도록 주의합니다.
- Partner는 이벤트가 어트리뷰션된 네트워크입니다.
- Postback Recipient는 이벤트에 대한 포스트 백을 수신한 파트너입니다. 이벤트가 그 파트너에게 어트리뷰션되지 않을 수 있습니다. (몇몇 파트너들은 그 파트너 또는 다른 네트워크 파트너에 어트리뷰션된 것과 상관없이 귀사의 모든 이벤트에 대한 포스트 백을 받도록 요구합니다. 이 요구에 관하여 Partner Configuration 페이지에서 설정할 수 있습니다)
추가 필드인, Is Attributed는 포스트 백 수신자가 이벤트가 어트리뷰션된 네트워크인지에 대해 더욱 명확히 합니다. ("Y"는 같은 두 네트워크가 같은 경우를 말하며, "N"은 이벤트가 Partner 필드에 표기된 파트너와 다른 파트너에게 어트리뷰션 되었다는 의미입니다)
주의: Partners filter는 파트너 네트워크든, 귀사의 내부 BI든, 제3의 분석 툴이든 포스트 백을 받은 파트너로 필터합니다.
다른 로그 유형들에 대하여, Partner filter는 컨버전 또는 이벤트가 어트리뷰션된 (광고 네트워크) 파트너를 의미합니다.
FAQ
파트너 컨피규레이션 FAQ
Singular는 네트워크에게 어트리뷰션된 앱 인스톨이 있을 때마다 그 네트워크에게 포스트 백을 전송합니다. 이 포스트 백은 비활성화할 수 없습니다.
다른 종류의 포스트 백들은 선택 항목이며 파트너 네트워크의 선호에 기반합니다.
- 리인게이지먼트 포스트 백 (Re-engagement postback)
- 인 앱 이벤트 포스트 백 (In-app event postbacks)
- 컨버전 (인스톨/리인게이지먼트)에 관한 포스트 백과 해당 파트너에게 어트리뷰션되지 않은 이벤트
포스트 백 서버 IP 주소를 참고합니다.
- Singular가 만약 HTTPS 응답 코드 500과 599 사이를 수신한다면 포스트 백 전송을 재시도합니다.
- 메커니즘은 최대 5번까지 재시도합니다.
- 재시도는 최초 시도로부터 1, 5, 15, 30, 60분을 간격으로 진행합니다.
파트너 유형과 용어
Partner Configuration 페이지 내 파트너는 Singular 어트리뷰션 서비스와의 협업을 위해 설정하는 모든 네트워크와 서비스를 말합니다.
참고: 이것은 Singular가 Singular 리포트 내 존재하는 데이터를 표기하기 위해 캠페인 데이터를 가져오는 소스랑은 별개입니다. 이에 대한 이해를 위해서는, 광고 네트워크와 Data Connectors 페이지 내 타 미디어 소스들을 따로 설정해야 합니다. (Data Connectors FAQ를 참고합니다).
Partner Configuration 페이지는 파트너와 사이트당 다음 항목들을 설정할 수 있도록 합니다.
- 클릭 스루 어트리뷰션에 대한 룩백 윈도우(lookback window) 설정
- 파트너에게 어떤 포스트 백들을 전송할 것인지
- 해당 파트너 플랫폼의 로그인 자격증명(login credentials)을 입력하는 곳으로, 이 자격증명은 필요한 경우 Singular가 해당 파트너에게 연결할 수 있게 합니다. 이 부분은 파트너마다 상이합니다.
세부 사항에 관하여는, 하단의 셋업과 포스트 백 설정하기를 참고합니다.
-
파트너에는 광고 네트워크, 광고 에이전시, 등이 있습니다. 이 파트너들에 대한 어트리뷰션 설정을 한 후 파트너의 커스텀 매크로와 협업하는 트래킹 링크를 생성할 수 있습니다. 또, Singular가 어트리뷰션된 인스톨, 프러드 결정, 등의 정보를 자동화 포스트 백의 형식으로 전송하도록 설정할 수 있습니다.
- 다른 파트너의 종류에는 제3의 BI 시스템, 프러드 분석 서비스, 등이 있습니다. 만약 이러한 서비스들과 협업한다면, 이 서비스들이 포스트 백을 받을 수 있도록 Partner Configuration 페이지에서 설정할 수 있습니다.
"내부 BI(Internal BI)"란 특별한 파트너 유형으로써, 귀사의 내부 플랫폼이 어트리뷰션 결정, 프러드 결정, 등에 대한 포스트 백을 받을 수 있도록 설정할 수 있는 파트너입니다. 더 많은 정보는 내부 BI 포스트 백 설정하기를 참고합니다.
어트리뷰션 파트너와 연동 개발의 프로세스의 한 부분으로, Singular는 파트너로부터 지원받는 모든 필드를 포함한 포스트 백 템플릿을 생성합니다. 새 파트너 컨피규레이션을 저장하면, Singular는 그 템플릿에 기반하여 포스트 백을 생성하기 시작합니다.
- 모든 파트너에 대한 포스트 백 설정을 추출하기 위해서는, Partner Configuration 페이지의 우측 상단의 Export All을 클릭합니다.
- 선택된 파트너들을 위한 포스트 백 설정을 추출하기 위해서는, 파트너 왼쪽에 체크 박스를 클릭하여 하나 이상의 파트너를 선택하시고 Export Selected를 클릭합니다.
이를 통해 설정된 각 포스트 백에 대한 정보를 담은 CSV 파일을 다운로드할 수 있습니다.
참고:
- CSV 파일의 각 행은 파트너에 대해 설정된 하나의 포스트 백을 의미합니다.
- 신규 필드들은 2023년 5월 이후 추출된 파일들에서만 제공됩니다.
칼럼 | 설명 |
Partner | 파트너 이름 |
Agency | [신규 필드] 설정하는 에이전시 명 (해당하는 경우) |
App | 표시되는 앱 이름 |
bundle ID | Long name 또는 앱의 번들 ID |
Site Public ID | [신규 필드] 애플 앱 스토어 또는 Google Play 내 ID 또는 웹 사이트의 URL |
OS | 앱의 OS (iOS 또는 Android) |
Send View-Through Postbacks |
[신규 필드] 파트너가 뷰 스루에 관한 포스트 백을 받도록 설정했다면 True |
Click-through attribution lookback window | 해당 파트너와 앱 사이트에 설정된 룩백 윈도우 |
Postback Type | 특정 행에서 특정 포스트 백이 인스톨로 설명될지 이벤트로 설명될지의 여부 |
Event Lookback Type | 룩백 윈도우 선택사항: • 터치 포인트(touchpoint): 인스톨이 어트리뷰션된 광고 클릭/뷰로부터 시작된 타임 프레임 • 인스톨(installs): 인스톨로부터 시작된 타임프레임 • 없음(None): 이벤트 포스트 백에 시간 제약 없음 |
Event Lookback Window | 이벤트 룩백에 따라 지정된 시간 범위(일)로 이벤트 포스트 백을 제한하는 이벤트 룩백 윈도우 |
Event SDK Name |
[필드명 변경: 이전 "EVENTS"] 포스트 백에서 이 행이 이벤트에 대한 것이라 명시할 경우: Singular SDK 내 이벤트 명 |
Event Partner Name |
[신규 필드] 포스트 백에서 이 행이 이벤트에 대한 것이라 설명할 경우: 이벤트의 파트너 명이며, 파트너 컨피규레이션에 매핑됩니다. |
Attributed Only |
해당 포스트 백이 해당 타입의 모든 이벤트에 전송될 것인지 아니면 인스톨이 특정 파트너로 어트리뷰션되었을 때만 전송될 것인지 |
Postback URL | Singular 매크로를 포함한 총 포스트 백 URL |
Create Date |
[신규 필드] 설정의 생성 일자 |
Last Update Date |
[신규 필드] 설정이 된 마지막 일자 |
Is Postback URL customized | [신규 필드] Yes/no (flexible postback feature이 적용된 Singular 고객인 경우에만 제공되는 필드). |
Tracker Name Filter | [신규 필드] 필터 명 또는 "No filter" (flexible postback 기능이 활성화된 경우에만 제공되는 필터). |
Limited Data Sharing Restriction | [신규 필드] True/False (limited data sharing 기능이 활성화된 Singular 고객에게만 제공되는 필드). |
Limited Data Sharing Default | [신규 필드] True/False (limited data sharing 기능이 활성화된 Singular 고객에게만 활성화된 고객에게만 제공되는 필드). |
Country Limitation Type | [신규 필드] "Include" 또는 "Exclude" (관련 필드가 활성화된 Singular 고객에게만 제공되는 필드). |
Country Limitation | [신규 필드] 콤마로 구분된 국가 명 목록 (국가 코드가 아닌, 전체 국가 명) (관련 기능이 활성화된 Singular 고객에게만 본 필드가 활성화). |
설정과 포스트 백
파트너 설정은 각 앱 사이트마다 설정되기 때문입니다.
Singular는 해당 파트너에게 포스트 백을 전송하기 위해서 특정 자격증명(credentials)이 필요합니다. 해당 파트너에게 올바른 자격증명(credentials)에 대해 문의합니다.
이 포스트 백은 성공적인 리인게이지먼트에 대한 알림을 해당 파트너에게 보냅니다. 이 포스트 백 활성화 옵션은 파트너가 리인게이지먼트 캠페인 (리타깃팅 캠페인)을 지원할 때\만 사용 가능합니다.
뷰 스루(view-through) 어트리뷰션은 광고 클릭 대신 광고 시청에 기반하여 측정되는 어트리뷰션을 가리킵니다. 만약 뷰 스루 캠페인을 운영 중이라면, 뷰 스루 어트리뷰션 포함하기(Include View-Through attributions)를 선택하여 Singular가 해당 파트너에게 뷰 스루 어트리뷰션에 대하여 포스트 백을 전송합니다. (그렇지 않으면, Singular는 클릭 스루 어트리뷰션에 대한 포스트 백만 전송할 것입니다)
프러드 포스트 백이란 Singular의 프러드 감지 시스템에 의해 결정된 프러드라 결정된 정보를 포함합니다. 이에 관한 자세한 정보는, Fraud Postbacks를 참고합니다. 또, Singular Fraud Prevention을 통해 Singular의 고급 프러드 감지 매서드에 대한 소개를 참고합니다.
어트리뷰션 룩백윈도우를 참고합니다.
인 앱 이벤트란 컨버전 이후 앱 내에서 발생하는 모든 유저 이벤트를 가리킵니다. 예를 들어, 앱이 게임 앱이라면 유저가 앱을 인스톨하고 로그인 또는 플랫폼에 가입하여, 튜토리얼을 보고, 레벨 업을 하는 등의 이벤트들을 의미합니다. 일부 파트너들은 Singular의 어트리뷰션 서비스로부터 해당 이벤트들에 대한 포스트 백 수신을 희망합니다.
우선, 전송하고 싶은 포스트 백들을 선정합니다:
옵션 | 의미 |
All | 파트너에게 모든 인 앱 이벤트에 대한 포스트 백을 전송 |
Only if the install was attributed to... | 앱 인스톨이 해당 파트너에게 어트리뷰션되었을 때만 해당 파트너에게 인 앱 이벤트에 관한 포스트 백 전송 |
Off | 파트너에게 인 앱 이벤트에 대한 포스트 백을 절대 전송하지 않음 |
그다음, 인 앱 이벤트를 추가합니다.
드롭 다운의 In-App (SDK) Events 에서, 매출과 관련된 여러 이벤트가 있으며, 일부는 중복됩니다.
동일한 인 앱 이벤트에 대한 중복된 포스트 백이 전송되는 것을 막기 위해서는 다음 사항들을 따릅니다.
매출 이벤트 명 |
설명 |
__IAP__ |
SDK/S2S 구현 시 커스텀 명을 지정하지 않은 상태에서 모든 인 앱 구매에 의해 발생한 이벤트. |
(커스텀 매출 이벤트) |
SDK/S2S 구현 시 인 앱 구매 이벤트에 대해 커스텀 명을 부여되었고, 해당 명이 목록에 표시. |
__ADMON_ USER_LEVEL_REVENUE__ | 광고 수익화로부터 발생한 매출에 의해 이벤트가 발생한 경우 (SDK 이벤트를 전송하는 메서드를 사용해 광고 수익화 어트리뷰션를 설정한 경우). |
__REVENUE__ |
앱에 들어오는 모든 매출에 의해 발생한 이벤트 (__IAP__, 커스텀 명을 가진 구매 이벤트, 광고 매출 이벤트). 하단의 주의를 참고. |
인 앱 구매 매출만 표시되는 경우에는 어떻게 해야 할까요:
- __IAP__ 과 모든 커스텀 구매 이벤트에 대한 매핑을 설정합니다.
- 아니면, 모든 인 앱 구매 이벤트를 포함하는 __REVENUE__를 대신 사용하세요.
인 앱 구매 매출과 광고 매출이 둘 다 표시되는 경우는 어떻게 해야 할까요:
- __IAP__를 모든 커스텀 구매 이벤트와 매핑하고, __ADMON_USER_LEVEL_REVENUE__에 대한 매핑을 설정합니다.
- 이 경우, 일반 이벤트인 __REVENUE__ 사용을 권장하지 않습니다. 이 이벤트가 구매와 광고 매출 이벤트를 모두 포함하기 때문이며, 두 유형의 매출을 매체 측에 대한 동일한 매출 이벤트로 설정하면 문제들이 발생할 수 있습니다.
- 대신, 인 앱 구매 이벤트를 매체의 구매 이벤트로 그리고 __ADMON_USER_LEVEL_REVENUE__ 이벤트를 매체의 광고 수익화 또는 광고 매출 이벤트로 설정합니다.
- 매체 측에 대해 어떤 이벤트를 사용해야할 지 모르겠다면, 매체 측에 자세한 사항을 문의합니다.
주의: 파트너에 대해 이미 존재하는 설정이 __REVENUE__ 포스트 백을 보내고 있고, 인 앱 구매 이벤트에다 광고 매출 이벤트가 보이기 시작했다면, 파트너 매체가 광고 매출 이벤트들을 받도록 설정하지 않은 경우에 문제가 발생할 수 있고, 해당 광고 매출 이벤트들을 별개의 이벤트로 매핑해야합니다. 이 경우, 매체와 어떻게 광고 매출 포스트 백을 전송해야할 지 확인합니다.
Singular의 연동 팀은 파트너들과 지속적인 연락을 통해 가장 좋은 연동 방식을 제공합니다. 지속적인 연락의 예를 들면, 파트너가 Singular로부터 포스트 백 받는 방법을 변경하기 위해 연동 업데이트를 요청할 수 있습니다.
대부분의 경우, Singular로 로그인하여 연동을 업데이트할 수 있으며, 이는 Partner Configuration 페이지에서 연동(integration)을 오픈하여 다시 저장하는 방법으로 업데이트할 수 있습니다.
드문 경우로, 업데이트 시 이전에 존재하지 않던 새로운 필드나 설정 제공을 위해 추가적인 절차를 밟아야 할 수 있습니다. 이 경우, 가이드를 위해 파트너 또는 Singular에 문의합니다.
아니요, 할 수 없습니다. Partner configuration 설정이 비슷하게 표시되는 것처럼 보여도, 각 설정은 고유하게 Singular 내부에서 연동되어 있습니다. 그러므로 여러 설정을 동시에 업데이트하는 것은 불가합니다.