파트너 컨피규레이션과 포스트 백 FAQ

파트너 컨피규레이션(Partner Configuration)페이지 사용 방법과 파트너 포스트 백 설정 방법에 대한 여러 옵션, 공통 이슈 해결 방법에 대하여 배워보세요. 

시작 단계에 있으시다면, How to Configure Partner Settings and Postbacks 문서를 참고하세요.

주의: 이 가이드는 Singular 광고주를 위한 가이드입니다. 만약 Singular의 파트너이거나 파트너가 되기를 희망한다면, Information for Partners를 참고하세요.

 

트러블 슈팅

왜 네트워크 파트너가 포스트 백을 수신하지 못할까요? 

만약 파트너 네트워크가 인스톨/컨버젼 또는 인앱 이벤트를 수신하지 못한다면 다음 절차를 따르세요. 

  1. Attribution > Export Logs에서 파트너에게 제공하기 위한 포스트 백 로그를 다운로드하세요. 해당 로그를 다운로드 후, Export Logs and User-Level Data FAQ를 참고하세요.
    • 포스트 백이 HTTP Code = 200 응답을 반환했는지 필터하여 확인하세요. HTTP 코드가 "200"을 반환했다면, 이는 파트너가 해당 포스트 백을 수신했다는 의미입니다. 
    • 또한, 필드에 Response HTTP Body를 선택하여 제공하면 파트너 측에서 기술 관련 이슈를 정확히 확인하는 데 도움이 될 것입니다.  
  2. 내부적으로 데이터를 확인하도록 파트너에게 해당 로그를 공유하세요. 만약 다수의 포스트 백이 다른 응답 코드들을 갖고 있다면, 파트너가 Singular로부터 포스트 백을 전송받는 데에 기술적인 문제가 있을 수 있는 부분에 대하여 알리세요.  
왜 포스트 백으로써 파트너가 받은 이벤트 건수Singular가 리포팅하는 이벤트 건수불일치할까요?  

원인이 될 수 있는 경우는 다음과 같습니다.

  • 룩백윈도우(Lookback windows): 하나 이상의 이벤트가 포스트 백 내 각각 다르게 설정된 룩백윈도우를 갖고 있기 때문일 수 있습니다. 파트너 컨피규레이션 (Partner Configuration) 페이지 내 설정을 확인하세요. 
  • 기술적인 문제: 파트너 측의 기술적인 문제로 인하여 하나 이상의 포스트 백을 수신하지 못할 수 있습니다. 확인을 위해서는, 왜 네트워크 파트너가 포스트 백을 수신하지 못할까요?를 참고하세요.
  • 중복된 이벤트: 앱 내 Singular SDK는 __REVENUE__ 이벤트를 자동으로 생성하는데, 이것이 인앱 구매에서 발생된 경우입니다. 이 경우, 각각 다른 종류의 인앱 구매를 위해 SDK 매출 이벤트를 생성할 수 있습니다. 이벤트 포스트 백 설정 시, __REVENUE__ 또는 귀사가 커스텀 한 매출 이벤트 명으로 포스트 백을 전송하도록 설정하세요. 이때, 둘 다 설정하게 되면 Singular가 각 인앱 구매 당 중복 포스트 백을 전송하게 되니 주의하세요. 
왜 파트너에게 이벤트 속성 없이 포스트 백이 전송될까요? 

만약 파트너가 이벤트 속성에 대한 정보 없이 포스트 백을 수신한다면 다음 절차를 따르세요.

  1. Attribution > Export Logs로 가시어 파트너를 위한 포스트 백 로그를 다운로드하세요. 포스트 백의 HTTP Body 또는 Target URL 필드를 확인하여 어트리뷰션된 이벤트 포함하는지 확인하세요. 로그 다운로드에 대한 도움이 필요하다면, Export Logs and User-Level Data FAQ를 참고하세요.
  2. 로그의 포스트 백이 이벤트 속성 없이 전송된 것이 확실하다면, Partner Configuration 페이지 내 포스트 백 설정을 다시 한번 확인하세요. 만약 이벤트와 함께 어트리뷰션을 보내도록 설정하지 않았다면, 보내도록 설정을 변경하세요.  
  3. 만약 설정이 올바름에도 포스트 백이 어트리뷰션된 이벤트 없이 전송된다면, Singular support에 문의하세요. 
어떤 포스트 백이 네트워크 파트너에게 전송되었는지 어떻게 확인할까요? 예시, 청구서 또는 인보이스 목적 

만약 네트워크에 지불하는 금액이 인스톨 또는 해당 기간 동안 Singular가 전송한 이벤트 포스트 백의 수에 기반한다면, Attribution > Export Logs의 가공되지 않은 포스트 백 로그를 확인하여 해당 기간 동안 어떤 포스트 백이 파트너로 전송되었는지 확인할 수 있습니다.   

만약 네트워크에 지불하는 금액이 Singular가 해당 기간 동안 전송한 인스톨/이벤트 포스트 백 수에 기반한다면, 어트리뷰션 > 로그 추출 (Attribution > Export Logs) 페이지미가공 포스트 백 로그를 다운로드하여 어떤 포소트백이 파트너에게 전송됐는지를 재확인할 수 있습니다.  

Export Logs 페이지에 대한 일반적인 질문에 대해서는, Export Logs and User-Level Data FAQ를 참고하세요.

포스트 백을 확인하기 위해서, 저희는 다음 설정에 가서 로그를 다운로드하세요.

postback_log1.png

postback_log2.png

Response HTTP Code 내 반드시 "200"으로 필터하셔야 포스트 백 수신인으로부터 수신된 성공적인 포스트 백을 확인할 수 있습니다.  

여기서 PartnerPostback 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 포스트 백을 전송하는 걸까요? 

포스트 백 서버 IP 주소를 참고하세요.

언제 얼마나 자주 Singular는 포스트 백을 재전송할까요? Singular 시스템은 다음 재시도까지 얼마나 기다릴까요?  
  • 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가 해당 파트너에 연결할 수 있도록 합니다. 이 부분은 파트너마다 상이합니다.   

세부 사항에 관하여는, 하기의 Configuring Settings and Postbacks를 참고하세요.

파트너 유형에는 어떤 것이 있을까요? 
  • 파트너에는 광고 네트워크, 광고 에이전시, 등이 있습니다. 이 파트너들에 대한 어트리뷰션 설정을 한 후 파트너의 커스텀 매크로와 협업하는 트래킹 링크를 생성할 수 있습니다. 또, Singular가 어트리뷰션된 인스톨, 프러드 결정, 등의 정보를 자동화 포스트 백의 형식으로 전송하도록 설정할 수 있습니다.   

  • 다른 파트너의 종류에는 제3의 BI 시스템, 프러드 분석 서비스, 등이 있습니다. 만약 이러한 서비스들과 협업한다면, 이 서비스들이 포스트 백을 받을 수 있도록 Partner Configuration 페이지에서 설정할 수 있습니다.  
"내부 BI (Internal BI)" 파트너들이란 무엇일까요?

"내부 BI(Internal BI)"란 특별한 파트너 타입으로 귀사의 내부 플랫폼이 어트리뷰션 결정, 프러드 결정, 등에 대한 포스트 백을 받을 수 있도록 설정할 수 있는 파트너입니다. 더 많은 정보를 원하시면 Configuring Internal BI Postbacks를 참고하세요.

사이트란 무엇일까요? 

사이트란 (또는 앱 사이트란) 특정 플랫폼을 위해 개발된 앱 버전입니다. 앱 사이트 각각 파트너 설정을 할 수 있습니다.  

예를 들어, 만약 Android와 iOS에서 앱을 구동하고 있다면, 두 앱 사이트가 있는 것이며, 각각 파트너 설정을 진행할 수 있습니다.  

참고: App Configuration FAQ.

Singular가 각 파트너에게 어떤 데이터를 보내야 하는지 어떻게 알 수 있을까요?  

어트리뷰션 파트너와 연동 개발의 프로세스의 한 부분으로, Singular는 파트너로부터 지원받는 모든 필드를 포함한 포스트 백 템플릿을 생성합니다. 새 파트너 컨피규레이션을 저장하면, Singular는 그 템플릿에 기반하여 포스트 백을 생성하기 시작합니다.   

어떻게 파트너 설정을 추출할까요? 어떻게 파트너에 대해 설정된 전체 포스트 백 리스트를 얻을 수 있을까요?  

모든 파트너에 대한 포스트 백 설정을 추출하기 위해서는, Partner Configuration 페이지의 우측 상단의 Export All을 클릭하세요.  

선택된 파트너들을 위한 포스트 백 설정을 추출하기 위해서는, 파트너 왼쪽에 체크 박스를 클릭하여 하나 이상의 파트너를 선택하시고 Export Selected를 클릭하세요.  

이를 통해 설정된 각 포스트 백에 대한 정보를 담은 CSV 파일을 다운로드할 수 있습니다.  

칼럼 설명
파트너(Partner) 파트너 이름
앱(App) 표기되는 앱 이름  
번들 ID(Long Name) Long name 또는 앱의 번들 ID
OS 앱의 OS (iOS 또는 Android)
Created  

클릭 스루 어트리뷰션

룩백윈도우 (Click-through attribution lookback window)

해당 파트너와 앱 사이트에 설정된 룩 백 윈도우  
포스트 백 종류 (Postback Type) 인스톨 또는 이벤트
이벤트 (Events) 해당 포스트 백을 트리거 하는 이벤트 이름
Attributed Only

해당 포스트 백이 해당 타입의 모든 이벤트에 전송될 것인지 아니면 인스톨이 특정 파트너로 어트리뷰션 되었을 때만 전송될 것인지

포스트 백 URL(Postback URL) Singular 매크로를 포함한 총 포스트 백 URL  

설정과 포스트 백

어떤 포스트 백이 네트워크에 전송되었는지 어떻게 확인할까요? 예를 들어, 청구서나 인보이싱 발부 목적 

상단을 참고하세요.

파트너를 설정할 때 왜 앱과 앱 사이트를 골라야 할까요? 

파트너 설정은 각 앱 사이트마다 설정되기 때문입니다.  

어떤 보안키/토큰/비밀번호를 기재해야 할까요? 

Singular는 해당 파트너에게 포스트 백을 전송하기 위해서 특정 자격증명(credentials)이 필요합니다. 해당 파트너에게 올바른 자격증명(credentials)에 대해 문의하세요.   

리인게이지먼트 (re-engagement) 포스트 백이란 무엇일까요?  

이 포스트 백은 성공적인 리인게이지먼트가 있었을 때 해당 파트너에게 알림을 보냅니다. 이 포스트 백 활성화 옵션은 파트너가 리인게이지먼트 캠페인 (리타깃팅 캠페인)을 지원할 때에만 사용 가능합니다.  

뷰 스루(view-through) 어트리뷰션이란 무엇일까요?

뷰 스루(view-through) 어트리뷰션은 광고 클릭 대신 광고 시청에 기반하여 측정되는 어트리뷰션을 가리킵니다. 만약 뷰 스루 캠페인을 운영 중이라면, 뷰 스루 어트리뷰션 포함하기(Include View-Through attributions)를 선택하여 Singular가 해당 파트너에게 뷰 스루 어트리뷰션에 대하여 포스트 백을 전송하도록 하세요. (그렇지 않으면, Singular는 클릭 스루 어트리뷰션에 대한 포스트 백만 전송할 것입니다)   

프러드 포스트 백이란 무엇일까요? 

프러드 포스트 백이란 Singular의 프러드 시스템에 의해 프러드라 결정된 정보를 포함합니다. 이에 관한 더 많은 정보를 원하시면, Fraud Postbacks를 참고하세요. 또, Singular Fraud Prevention을 통해 Singular의 고급 프러드 감지 매서드에 대한 소개를 참고하세요. 

어트리뷰션 룩백윈도우란 무엇인가요? 

어트리뷰션 룩백윈도우를 참고하세요.

인앱 이벤트란 무엇인가요? 

인앱 이벤트란 컨버전 이후 앱 내에서 일어나는 모든 유저 이벤트들을 가리킵니다. 예를 들어, 귀사의 앱이 게임 앱이라면 유저가 귀사의 앱을 인스톨하고 로그인 또는 플랫폼에 가입하여, 튜토리얼을 보고, 레벨 업을 했을 수 있습니다. 몇몇 파트너들은 Singular의 어트리뷰션 서비스로부터 이 이벤트들에 대한 포스트 백을 수신하기를 희망합니다.  

인앱 이벤트 포스트 백은 어떻게 설정할까요?  

image4.png

우선, 전송하고 싶은 포스트 백들을 선택하세요. 

옵션 의미
All 파트너에게 모든 인앱 이벤트에 대한 포스트 백을 전송
Only if the install was attributed to... 앱 인스톨이 해당 파트너에게 어트리뷰션 되었을 때만 해당 파트너에게 인 앱 이벤트에 관한 포스트 백 전송 
Off 파트너에게 인 앱 이벤트에 대한 포스트 백을 절대 전송하지 않음

그다음, 다음 인앱 이벤트들을 추가하세요.  

필드 의미
인앱 (SDK) 이벤트 명 Singular SDK 연동을 통해 앱으로부터 전송되는 이벤트 명 
이벤트 명 파트너에게 보이는 이벤트 명 또는 ID (보통의 경우 파트너는 파트너가 인식할 수 있는 이벤트 리스트가 있습니다.)  
매출(revenue) 전송 매출(revenue) 이벤트의 경우, 포스트 백 내 매출(revenue) 정보를 포함 (만약 이 체크 박스를 체크하지 않는다면, Singular는 이벤트 카운트만 전송하게 됩니다)   
__iap__ 이벤트와 __REVENUE__ 이벤트의 차이점은 무엇인가요? 포스트 백을 위해 어떤 것을 설정해야 할까요? 

__REVENUE__ 이벤트 포스트 백은 인앱 구매가 보고되면 발생됩니다. 이는 다음을 포함합니다.  

  • 시스템 디폴트 __iap__ 이벤트
  • 매출(revenue)을 SDK/S2S 연동을 통해 "ProductPurchase"와 같은 커스텀 명으로 전송할 경우 

이 의미는 만약 귀사가 포스트 백을 __REVENUE__와 __iap__ 둘 다로 설정할 경우, 해당 파트너가 같은 매출(revenue)에 대한 중복 포스트 백을 받을 수 있음을 의미합니다. 

특별히 필요한 경우가 아니라면, 저희는 __REVENUE__ 포스트 백을 설정하고 __iap__ 포스트 백을 삭제하는 것을 권장합니다.

파트너 연동과 포스트 백 설정을 어떻게 업데이트할까요?  

Singular의 연동 팀은 파트너들과 지속적인 연락을 통해 가장 좋은 연동 방법을 제공할 수 있도록 합니다. 예를 들면, 파트너가 Singular로부터 포스트 백 받는 방법을 변경하기 위해서 때때로 파트너가 연동 업데이트를 요청할 수 있습니다.  

대부분의 경우, Singular로 로그인하여 연동을 업데이트 할 수 있으며, 이는 Partner Configuration 페이지에서 연동(integration)을 오픈하여 다시 저장하는 방법으로 업데이트할 수 있습니다.   

드문 경우로서, 업데이트 시 이전에 존재하지 않던 새로운 필드나 설정 제공을 위해 추가적인 절차를 밟아야 할 수 있습니다. 이 경우, 가이드를 위해 파트너 또는 Singular에 문의하세요.