로그 추출 페이지를 통해 (어트리뷰션 > 로그 추출) 미가공 유저 레벨 데이터를 이해하고 어떻게 데이터를 다운로드하는지 배워보세요.
각 로그 내 필드에 대한 설명을 원하시면, 로그 추출하기: 지원하는 필드 페이지를 참고하세요.
이 문서는 Singular 고객을 위한 글입니다. 만약 Singular의 파트너라면, 파트너 포털 이용하기 페이지를 먼저 참고해주세요.
로그 트러블 슈팅하기
만약 컨버전 또는 이벤트 로그를 (로그 추출 페이지에서) 다운로드했으나 Singular 리포팅 (Reports 페이지 또는 API 리포팅) 내 표기된 카운트와 맞지 않는다면, 다음을 확인하세요.
리포트가 코호트 분석을 사용하는 경우
귀사의 리포트가 이벤트를 코호트 단위로 표기하는 경우일 수 있으며, 이는 리포트가 그 날짜 범위 내 매일 당일에 앱을 인스톨한 유저에 의해서 생성된 이벤트를 카운트한다는 의미입니다. (코호트 메트릭과 코호트 기간이란 무엇인가요? 참조) 반대로, 추출된 로그 내 이벤트들은 항상 이벤트가 일어난 실제 날짜에 해당합니다.
리포트에서 실제 날짜에 해당하는 이벤트들이 보이도록 리포트 내 코호트 기간이 actual로 설정됐는지 반드시 확인하세요.
서버 시간(Server time)과 조정 시간(Adjusted time)의 차이
Singular 데이터베이스는 각 이벤트에 대해 다른 두 시간 값을 갖습니다:
- 서버 시간(Server Time)은 Singular 서버가 이벤트를 받은 시간을 나타냅니다. 만약 이벤트 데이터를 보내는 기술적인 이유로 지연이 있었다면 실제 이벤트가 일어난 시간과 서버 시간은 매우 다를 수 있습니다.
- 조정 시간(adjusted time)은 실제 이벤트가 일어난 시간을 나타냅니다.
로그 추출 페이지 내 날짜 범위는 서버 시간에 기반합니다.
리포트 페이지 내 날짜 범위와 다른 Singular 리포팅 툴(예시, Singular API)는 조정 시간(adjusted time)에 기반합니다.
이런 이유로 이벤트 카운트에 불일치가 생길 수 있습니다. 예를 들어, 6월 1일에 일어난 이벤트에 지연이 생겨 Singular 서버에 6월 2일에 도달하는 경우입니다.
이 값들이 다운로드된 로그에 나타나는 데에는 다음과 같은 몇 가지 이유가 있습니다.
1. 오가닉 컨버전인 경우
컨버전이 지불한 소스(paid source)에서 일어난 게 아니면, 오가닉(organic)으로 표기되며, 이것이 유저 레벨 로그에 나타날 때는 다음과 같이 표기됩니다.
- 네트워크: "Organic"
- 캠페인: "Unattributed"
2. Facebook 캠페인인 경우
프라이버시 상의 이유로, Facebook은 Facebook의 자가 어트리뷰션 API에 기반한 어트리뷰션을 표시하도록 허락하지 않습니다. 이 어트리뷰션들은 다음과 같이 표기됩니다.
- 네트워크: "Unattributed"
- 캠페인: "Unattributed"
자가 어트리뷰션 API에다가 Facebook은 안드로이드 인스톨 레퍼러에 기반한 별개의 어트리뷰션 메서드를 사용합니다. 이 메서드에 기반한 어트리뷰션은 유저 레벨 리포트 내 일반 세부사항이 표시됩니다. 자세한 정보는, Facebook Ads 연동 문서를 참조하세요.
3. Tiktok 뷰스루 캠페인인 경우
2021년 8월 31일 부로, 프라이버시 상의 이유로 TikTok은 모든 MMP에 유저 레벨 데이터의 뷰스루 캠페인의 표기를 금지했습니다. 그러므로, 컨버전이 Tiktok 뷰스루 (노출 기반) 캠페인에 어트리뷰션된 경우, 이는 귀사의 포스트 백과 로그 내 다음과 같이 표기됩니다.
- 네트워크: "Unattributed"
- 캠페인: "Unattributed"
4. 데이터 리 텐션 기간이 지난 경우
몇몇 파트너들은 프라이버시 상의 이유로 일정 시간이 지난 후 유저 레벨 데이터의 표기를 금지합니다.
만약 인스톨 또는 리인게이지먼트가 다음 파트너 중 하나에 어트리뷰션 되었거나 인앱 이벤트가 데이터 리 텐션 기간이 지난 후 발생했다면, 유저 레벨 이벤트 로그에서 다음과 같이 표기됩니다.
- 네트워크: "Organic"
- 캠페인: "Suppressed"
파트너 | 최장 데이터 리 텐션 기간 |
6 months | |
TikTok | 6 months |
6 months | |
Google Ads | 6 months |
Snapchat | 2 months |
팁: 만약 포스트 백을 귀사의 내부 BI 플랫폼에 받고 있고 이것이 컨버전과 이벤트를 포함한다면, 세부 사항을 통해 내부적으로 특정 디바이스 ID에 대한 본래 고객 유입 소스 (original acquisition source)에 대한 이해를 도울 수 있습니다.
2021년 10월 부로, Facebook는 Singular와 같은 MMP들이 Facebook의 자가 어트리뷰션 API를 통해 어트리뷰션되는 인스톨 또는 이벤트와 같은 유저 레벨 정보 표기를 금지했습니다. 그러므로, 이 인스톨과 이벤트들은 로그 추출 페이지 혹은 내부 BI로 전송된 포스트 백 내 Facebook의 것으로 표기되지 않습니다. 다만, 이 제한은 집계 데이터에 적용되지 않기에 Singular는 이 인스톨과 이벤트들을 집계 리포트 (예시, 리포트 페이지, Singular API 등)에서 보여 드리고 있습니다.
Facebook은 자가 어트리뷰션 API와 안드로이드 인스톨 레퍼러에 기반한 또 다른 솔루션을 사용합니다. 인스톨 레퍼러를 통해 어트리뷰션된 인스톨과 이벤트들은 로그 추출 내 표기됩니다. 저희는 인스톨 레퍼러를 기반으로 한 Facebook 캠페인 정보를 표기할 수 있도록 귀사가 Singular에게 앱의 인스톨 레퍼러 해독 키를 제공하는 것을 권장합니다. 자세한 사항은, Facebook Ads 어트리뷰션 연동 문서를 참조하세요.
FAQ
유저 레벨 데이터란 유저 활동과 어트리뷰션 관련 기록인 클릭, 컨버전, 리인게이지먼트, 인앱 유저 이벤트, 포스트 백, 프러드 결정 등을 포함하는 상세 목록입니다.
유저 레벨 데이터는 Singular의 어트리뷰션 메커니즘과 프러드 방지 엔진에 의해 기록된 미가공 데이터(raw data) 입니다. Singular는 이 데이터를 사용해 리포트 내 집계 데이터를 계산합니다.
Singular의 어트리뷰션 서비스의 고객으로서, 미가공 유저 레벨 데이터에 접속하고 여러 방법을 통해 이를 사용하실 수 있습니다. 예를 들어, 집계 리포트에 어떠한 문제가 예상되는 경우 이 데이터를 대조하여 검토할 수 있습니다.
예시: 유저 레벨 이벤트 데이터를 보이는 로그
유저 레벨 데이터에 접속하는 세 가지 방법이 있습니다.
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 플랫폼으로 포스트 백을 전송하기 위한 설정을 하시면, 인스톨, 리인게이지먼트, 인앱 이벤트, 프러드 결정에 대한 실시간 데이터를 받아 보실 수 있습니다. |
로그를 추출하려면 다음 절차를 따르세요.
- Attribution > Export Logs에 가세요.
- 관련 날짜 범위를 선택하세요. 90일의 데이터까지 볼 수 있습니다. 다운로드 당 기록 제한 초과를 방지하기 위해 날짜 범위를 가능한 한 좁게 설정하시기를 권고드립니다.
- 앱, 앱 사이트, 추출하기 원하는 로그 종류(클릭, 인스톨, 이벤트, 또는 포스트 백)를 선택하세요
-
선택하신 필드들을 'Selected Fields' 박스에 드래그하세요.
어떠한 로그든 추출할 때 디바이스 ID 필드를 반드시 선택하셔야 정확한 유저 레벨 데이터를 얻을 수 있습니다.
- 옵션으로, 어트리뷰트 된 파트너, 국가, 디바이스 ID, 디바이스 종류에 따라 필터할 수 있습니다. 특정 이벤트에 따라 이벤트 로그를 필터하실 수 있으며, 컨버전 타입에 따라 컨버전 로그를 필터할 수 있습니다. 기록 제한이 넘지 않도록 가능한 한 로그를 많이 필터하시기를 권장합니다.
- 로그 추출(Export Logs)을 선택하세요.
제한 사항
- Facebook은 Facebook의 자가 어트리뷰션 API에 기반한 유저 레벨 데이터에 대한 접근을 허용하지 않습니다. 자가 어트리뷰션된 Facebook 인스톨로 확인되는 어떠한 필드든 "Unattributed로 표기됩니다. Faceboo은 안드로이드 인스톨 레퍼러에 기반한 솔루션을 제공하며 이 솔루션에 기반하여 어트리뷰션된 인스톨들은 유저 추출 로그에는 표기됩니다. 더 많은 정보를 원하시면, Facebook Ads 어트리뷰션 연동 문서를 참조하세요.
- Singular 고객들에게 날짜 범위는 90일까지 제한됩니다. Singular 파트너에게 가능한 옵션을 확인하려면, 파트너 포털: 로그 추출 사용하기 문서를 참조하세요.
- 추출은 요청당 5M 으로 제한됩니다.
- 로그는 당일 60분 동안 데이터를 제공됩니다. 지난 60분 동안의 데이터를 위해서는 실시간 데이터 (real-time data)를 체크하세요.
- Singular 데이터베이스에는 로그 내 각 기록에 해당하는 두 종류의 시간인 Sever time (Singular 서버에 이벤트가 도달한 시간을 의미)과 Adjusted time (이벤트가 일어난 원래 시간)이 있습니다. 이로 인해 유저 레벨 데이터와 집계 리포트 사이 불일치가 초래될 수 있습니다. (더 보기)
다른 사항
- "timezone field" 필드는 귀사의 Singular 계정에 설정된 시간대입니다.
- 타임 스탬프 된 필드들은(예, touchpoint__timestamp) 설정하신 시간대에 추출됩니다. Unix로 표시되는 (예, touchpoint__unix_timestamp) 타임 스탬프는 UTC 시간대를 기준으로 합니다.
- 만약 디폴트로 추출되는 필드의 리스트를 변경하거나 추출하고 싶은 새 필드에 대한 요청을 더 하고 싶으시면, 귀사의 고객 성공 매니저에게 말씀하세요.
- 만약 매체가 유저 레벨 프러드 데이터 (user-level fraud data)를 요청하거나 파트너 컨피규레이션을 통한 프러드 포스트 백을 받는 게 불가능한 경우, 프러드 로그를 추출하여 매체와 공유할 수 있습니다. Singular는 광고주의 동의 없이 임시로 매체와 해당 정보를 공유하지 않습니다.
클릭
인스톨 또는 리인게이지먼트의 어트리뷰션을 결정하기 위해 검사되는 모든 클릭들을 포함합니다.
컨버전
인스톨, 리인게이지먼트 이벤트, 어디에 어트리뷰트 되었는지, 식별자 기반인지 확률론적 방법(probabilistic attribution) 기반인지 등 어트리뷰션에 대한 다른 세부 사항들을 포함한 정보입니다.
주의 사항: 컨버전 이벤트(Conversion event)가 제공된 장소 정보는 해당 이벤트가 발생된 곳에 기반하며, 이는 앱 내부적으로 감지된 장소 또는 유저가 제공한 정보에 기반하지 않습니다. 만약 이벤트의 장소 데이터에 대한 다른 소스가 있다면, 귀사의 앱으로부터 Singular로 전송된 패스 스루 파라미터(pass-through parameter)를 확인할 수 있습니다.
이벤트
세션, 등록, 구매, 또는 Singular SDK/S2S를 연동했을 때 타 이벤트와 같은 다른 이벤트들을 포함합니다.
이벤트 로그 데이트와 리포트 내 이벤트 데이터를 비교할 때, 1d, 7d, 14d와 같은 코호트 기간 대신에 반드시 리포트 내 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 프러드 방지 시스템의 로우 출력입니다.
"오가닉 인스톨"의 열을 포함하여 인스톨 이벤트와 관련한 모든 터치 포인트(클릭, 인상)의 열을 포함하는 것에 주의하세요. (프러드 감지 프로세스를 참조하세요) 그러므로, 하나의 인스톨의 프러드로 인해 대하여 거부된 다수의 터치 포인트들을 조회할 수 있습니다.
필드의 각 로그에 대한 설명을 더 보려면, 로그 추출: 지원되는 필드를 참고하세요.
- 리포트 페이지 (또는 리포팅 API) 내 인스톨들을 소스와 캠페인별로 보이도록 리포트를 작동합니다.
- 로그 추출 페이지에서, 컨버전 로그 타입을 선택하고 동일한 날짜 범위의 필드들을 끌어옵니다.
유저 프라이버시를 위한 세계적 기준과 함께 연동된 파트너들에 따라, Singular는 유저 레벨 데이터를 세 달 이상 보관하지 않습니다.
따라서, 귀사가 Singular 고객이라면, 90일 이전까지의 유저 레벨 데이터를 추출할 수 있습니다.
Singular 파트너들은 다른 제한들과 함께 유저 레벨 로그에 대해 더 제한적인 접근이 가능하며, 파트너들은 로그를 7일 전까지만 추출할 수 있습니다.