로그 추출과 유저 레벨 데이터 FAQ

로그 추출 페이지를 통해 (Attribution > Export Logs) 로우 유저 레벨 데이터를 이해하고 어떻게 데이터를 다운로드하는지 배워보세요.

각 로그 내 필드에 대한 설명을 원하시면, 로그 추출하기: 지원하는 필드 페이지를 참고하세요.

이 문서는 Singular 고객을 위한 글입니다. 만약 Singular의 파트너라면, 파트너 포털 이용하기 페이지를 먼저 참고해주세요.

 

유저 레벨 데이터란?

유저 레벨 데이터란 유저 활동과 클릭, 컨버전, 리인게이지먼트, 인앱 유저 이벤트, 포스트 백, 프러드 결정 등을 포함한 어트리뷰션 관련 기록 등의 어트리뷰션 관련 기록들에 관한 상세한 목록입니다. 

유저 레벨 데이터는 Singular의 어트리뷰션 메커니즘과 프러드 방지 엔진에 의해 기록된 로우데이터 입니다. 유저 레벨 데이터는 Singular의 어트리뷰션 메커니즘과 프러드 방지 엔진에 의해 기록된 로우 데이터입니다. Singular는 리포트의 집계 데이터를 계산하기 위하여 사용합니다.  

Singular의 어트리뷰션 서비스의 고객으로서, 로우 유저 레벨 데이터에 접속하고 여러 가지 방법을 통해 이를 사용하실 수 있습니다. 예를 들어, 집계 리포트에 어떠한 문제가 예상되는 경우 데이터를 대조하여 검토하는 방법이 있습니다. 

예시: 유저 레벨 이벤트 데이터를 보이는 로그

Screen_Shot_2020-12-30_at_19.46.06.png

어떻게 유저 레벨 데이터에 접속할까요?

유저 레벨 데이터에 접속하는 세 가지 방법이 있습니다.

The Export Logs Page (Attribution > Export Logs)

Singular 웹 앱 내 로그 추출하기 페이지에서 클릭, 인스톨, 리인게이지먼트, 인앱 이벤트, 포스트 백, 그리고 프러드 관련 데이터에 관하여 수동으로 다운로드할 수 있습니다. 해당 페이지는 CSV 파일을 생성합니다.  

주의 사항:
Data Destinations Singular의 데이터 종착점(ETL)은 해당 데이터를 Singular에서 귀사의 내부 BI 플랫폼, 데이터 웨어하우스 또는 스토리지 서비스에 전송합니다. 이 방법으로 추출할 수 있는 데이터 종류는 유저 레벨 컨버전(user-level conversions)과 이벤트입니다. 더 많은 정보를 원하시면, Singular 데이터 데스니네이션 FAQ를 참고하세요.
Configuring Internal BI Postbacks 만약 Singular에서 귀사의 내부 BI 플랫폼으로 포스트 백을 전송하기 위한 설정을 하시면, 인스톨, 리인게이지먼트, 인앱 이벤트, 프러드 결정에 대한 실시간 데이터를 받아 보실 수 있습니다. 

로그 추출 페이지에서 어떻게 유저 레벨 데이터를 다운로드할까요?

로그를 추출하려면 다음 절차를 따르세요. 

  1. Attribution > Export Logs에 가세요.
  2. 관련 날짜 범위를 선택하세요. 90일의 데이터까지 볼 수 있습니다. 저희는 다운로드 당 기록 제한 초과를 방지하기 위해 날짜 범위를 가능한 한 좁게 설정하시기를 권고드립니다.
  3. 앱, 앱 사이트, 추출하기 원하는 로그 종류(클릭, 인스톨, 이벤트, 또는 포스트 백)를 선택하세요
  4. 선택하신 필드들을 'Selected Fields' 박스에 드래그하세요.

    Screen_Shot_2020-12-30_at_19.52.07.png

    어떠한 로그든 추출하실 때 디바이스 ID 필드를 반드시 선택하셔야 정확한 유저 레벨 데이터를 얻을 수 있습니다. 

  5. 옵션으로, 어트리뷰트 된 파트너, 국가, 디바이스 ID, 디바이스 종류에 따라 필터할 수 있습니다. 특정 이벤트에 따라 이벤트 로그를 필터하실 수 있으며, 컨버전 타입에 따라 컨버전 로그를 필터할 수 있습니다. 기록 제한이 넘지 않도록 가능한 한 로그를 많이 필터하시기를 권고드립니다. Screen_Shot_2020-12-30_at_19.19.49.png
  6. 로그 추출(Export Logs)을 선택하세요.

제한 사항

  • Singular 고객들은 날짜 범위를 90일 이전까지 설정할 수 있습니다. Singular 파트너들에게 가능한 옵션들을 보려면, 파트너 포털 사용하기: 로그 추출을 참고하세요.
  • 추출은 요청 당 500만 기록(열)으로 제한됩니다.
  • 해당 로그들은 해당하는 날짜들의 지난 60분까지의 데이터를 제공합니다. 지난 60분의 데이터를 조회하시려면 실시간 데이터 체크 박스(real-time data checkbox)를 선택하세요.
  • Singular 데이터베이스에는 로그의 각 기록과 관련된 두 가지 타임 벨류(time value)를 갖습니다. 서버 타임 스템프(이벤트가 Singular 서버에 전달된 시간 기준)와 이벤트가 일어난 당시의 시간을 의미하는 조정 타임 스템프(Adjusted Timestamp)가 있습니다. 이로 인해 유저 레벨 데이터와 Singular 리포트 내 데이터 불일치를 일으킬 수 있습니다. (더 보기)
  • Facebook은 2020년 4월 22일 부로 Advanced Mobile Measurement agreement (AMM) 을 업데이트했습니다. 새 AMM에 따르면, Singular(와 다른 MMP들은)는 계속하여 Facebook 어트리뷰션을 어트리뷰트 할 수 있고 집계 레벨(aggregatre level)로 리포트할 수 있습니다. 하지만, 뷰스루(view-through) 어트리뷰션은 더 이상 디바이스 수준에서 리포트할 수 없습니다. 이것은 디바이스 수준에서 Facebook 노출(impression)로 어트리뷰트 되더라도 Facebook에 어트리뷰트 된 인스톨/이벤트로 볼 수 없음을 의미합니다. (오가닉(Organic)인 것 처럼 리포트 될 것입니다). Facebook의 클릭 스루 어트리뷰션 (Click-through attribution)은 영향받지 않을 것입니다. 만약 Facebook 로그가 보이지 않는다면, support@singular.net로 문의하세요.

다른 사항

  • "timezone field" 필드는 귀사의 Singular 계정에 설정된 시간대입니다. 
  • 타임 스탬프 된 필드들은(예, touchpoint__timestamp) 설정하신 시간대에 추출됩니다. Unix로 표시되는 (예, touchpoint__unix_timestamp) 타임스탬프는 UTC 시간대를 기준으로 합니다. 
  • 만약 디폴트로 추출되는 필드의 리스트를 변경하거나 추출하고 싶은 새 필드에 대한 요청을 더 하고 싶으시면, 귀사의 고객 성공 매니저에게 말씀하세요. 
  • 만약 매체가 유저 레벨 프러드 데이터 (user-level fraud data)를 요청하거나 파트너 컨피규레이션을 통한 프러드 포스트 백을 받는 게 불가능한 경우, 프러드 로그를 추출하여 매체와 공유할 수 있습니다. Singular는 광고주의 동의 없이 임시로 매체와 해당 정보를 공유하지 않습니다. 

어떤 종류의 로그를 다운로드할 수 있을까요?

클릭 

인스톨 또는 리인게이지먼트의 어트리뷰션을 결정하기 위해 검사되는 모든 클릭들을 포함합니다.

컨버전 

인스톨, 리인게이지먼트 이벤트, 어디에 어트리뷰트 되었는지, 식별자 기반인지 확률론적 방법 기반인지 등 어트리뷰션에 대한 다른 세부 사항들을 포함한 정보입니다. 

주의 사항: 컨버전 이벤트(Conversion event)에 제공된 장소는 발동된 IP에 기반하며, 이는 앱 내부적으로 감지된 장소 또는 유저가 제공한 정보에 기반하지 않습니다. 만약 이벤트의 장소 데이터에 대한 다른 소스가 있다면, 귀사의 앱으로부터 Singular로 전송된 패스 스루 파라미터(passthrough parameter)를 확인할 수 있습니다. 

이벤트  

세션, 등록, 구매, Singular SDK/S2S인 앱 이벤트와 연동할 때 정의된 다른 이벤트들을 포함합니다. 
이벤트 로그 데이트와 리포트 내 이벤트 로그 데이터를 비교할 때, 1d, 7d, 14d와 같은 코호트 기간 대신에 반드시 리포트 내 ACTUAL을 사용하세요. 리포트 데이터가 ACTUAL 기간의 특정 이벤트들에 대조하여 보이지 않음에 주의하세요. 

포스트 백  

Singular에 의해 전송된 모든 포스트 백에 대한 데이터를 포함합니다. (어트리뷰션 결정에 대한 포스트 백뿐 아니라).  로그는 귀사의 내부 BI의 포스트 백(만약 설정하셨다면)과 써드 파티 분석 도구(third-party analytics tools)를 포함합니다.

팁: 포스트 백 로그를 다운로드할 때, 반드시 Response HTTP 코드와 Response HTTP Body 필드를 선택하세요. Response HTTP 코드는 포스트 백이 성공적으로 전송되었는지를 말해줍니다. 200 code는 성공적이었음을 의미하고, 다른 값들은 에러임을 의미합니다. 전송할 때 에러가 있는 경우, Singular는 다시 다섯 번 이상 1, 5, 15, 30, 60과 같이 다섯 차례에 걸쳐 포스트 백을 재시도합니다. Response HTTP Body는 에러에 관한 추가적인 세부사항들을 포함할 수 있습니다.

SKAN (SKAdNetwork) 포스트 백

귀사의 Ad Network 파트너들로부터 Singular가 받은 SKAdNetwork 로그입니다. 이 포스트 백은 SKAdNetwork 트래킹과 Singular를 통해 포스트 백을 포워드하는 SKAdNetwork 연동한 파트너들의 iOS 앱에서만 사용 가능합니다. 더 보기를 원하시면 Singular의 SKAdNetwork 솔루션을 참고하세요.

프러드

Singular 프러드 방지 시스템의 로우 출력입니다.

"오가닉 인스톨"의 열을 포함하여 인스톨 이벤트와 관련한 모든 터치 포인트(클릭, 인상)의 열을 포함하는 것에 주의하세요. (프러드 감지 프로세스를 참조하세요) 그러므로, 하나의 인스톨의 프러드로 인해 대하여 거부된 다수의 터치 포인트들을 조회할 수 있습니다.

Singular는 유저 레벨 데이터를 얼마나 보관할까요?

유저 프라이버시를 위한 세계적 기준과 함께 연동된 파트너들에 따라, Singular는 유저 레벨 데이터를 세 달 이상 보관하지 않습니다.

따라서, 귀사가 Singular 고객이라면, 90일 이전까지의 유저 레벨 데이터를 추출할 수 있습니다.

Singular 파트너들은 다른 제한들과 함께 유저 레벨 로그에 대해 더 제한적인 접근이 가능하며, 파트너들은 로그를 7일 전까지만 추출할 수 있습니다. 

다른 필드는 무엇을 의미할까요?

필드의 각 로그에 대한 설명을 더 보시려면, 로그 추출: 지원되는 필드를 참고하세요.

네트워크와 캠페인 명 대신 무엇때문에 로그에서 "Organic", "Suppressed", "Unattributed"이 보일까요?

다운로드 된 로그에 보여지는 이 값에 대해서는 여러 가지 이유가 있을 수 있습니다.

1. 실제 오가닉 컨버전 

만약 컨버전이 지불된 소스를 갖고 있지 않은 것으로 판단되면, 이것은 오가닉으로 표시되며 유저 레벨 로그에는 다음과 같이 표시됩니다.

  • 매체: "Organic"
  • 캠페인: "Unattributed"

2. Facebook 뷰스루 캠페인 

2020년 4월 22일부로, Facebook은 유저 프라이버시를 위해 MMP들에 뷰스루(view-through) 캠페인에 유저 레벨 데이터를 숨기도록 요구했습니다. 그러므로, 만약 컨버전이 노출을 기반으로 한 Facebook 뷰스루(광고 노출을 기반으로)로 어트리뷰트 된다면, 이는 다음과 같이 귀사의 포스트 백과 로그에 표시됩니다. 

  • 매체: "Unattributed"
  • 캠페인: "Unattributed"

3. 데이터 리 텐션 기간이 지난 경우

몇몇 파트너들은 유저 프라이버시로 인해 일정 시간을 초과한 유저 레벨 데이터를 숨기도록 Singular에게 요구했습니다. 

만약 인스톨 또는 리인게이지먼트가 다음 중 하나에 어트리뷰트 되고, 데이터 리 텐션 기간이 지난 후 트리거된다면, 유저 레벨 이벤트 로그 세부사항에 다음과 같이 확인할 수 있습니다.

  • 네트워크: "Organic"
  • 캠페인: "Suppressed"
파트너 데이터의 최대 리 텐션 기간
Facebook 6달
TikTok 6달
Twitter 6달
Google Ads 6달
Snapchat 2달

팁: 만약 포스트 백을 컨버전과 이벤트를 포함하는 내부 BI 플랫폼으로 받는다면, 내부적으로 세부사항을 조회하시어 특정 디바이스 ID의 기존 유입 소스를 이해할 수 있습니다. 

도움이 되었습니까?