로그 및 사용자 수준 데이터 내보내기 FAQ

문서

사용자 레벨 데이터는 Singular의 어트리뷰션 트래커, 프로드 방지 엔진, SKAdNetwork 연동을 통해 기록되는 로데이터입니다. 로그 내보내기 페이지 (어트리뷰션 > 로그 내보내기)를 통해 사용자 레벨 로그를 다운로드할 수 있습니다.

각 로그의 필드에 대한 설명은 로그 내보내기를 참조하세요 : 지원되는 필드를 참조하세요.

이 문서에서는 Singular 고객이 사용할 수 있는 로그 내보내기 기능에 대해 설명합니다. Singular 파트너인 경우 파트너 포털 사용을 참조하세요.

로그 문제 해결

전환/이벤트 로그가 Singular의 집계 보고와 일치하지 않는 이유는 무엇인가요?

전환 또는 이벤트 로그( 로그 내보내기 페이지에서)를 다운로드했는데 카운트가 Singular의 보고( 보고서 페이지 또는 API 보고)에 표시되는 것과 일치하지 않는 경우 다음을 확인하세요:

보고서가 코호트 분석을 사용하고 있을 수 있습니다.

보고서가 코호트별로 이벤트를 표시하고 있을 수 있습니다. 즉, 날짜 범위의 모든 날에 대해 해당 날짜에 앱을 설치한 사용자가 만든 이벤트를 카운트합니다( 코호트 지표 및 코호트 기간이란 무엇인가요? 참조). 반면 내보낸 로그의 이벤트는 항상 이벤트가 발생한 실제 날짜와 시간에 연결됩니다.

보고서 설정에서 코호트 기간이 실제 날짜에 발생한 이벤트를 표시할 수 있도록 실제 날짜로 설정되어 있는지 확인하세요.

서버 시간 대 조정된 시간

Singular 데이터베이스에는 각 이벤트와 관련된 두 가지 시간 값이 있습니다:

  • 서버 타임스탬프는 이벤트가 Singular 서버에 수신된 시간을 반영합니다. 이벤트 데이터를 전송하는 데 기술적인 지연이 있는 경우 이벤트가 발생한 원래 시간과 크게 다를 수 있습니다.
  • 조정된 타임스탬프는 이벤트가 발생한 원래 시간을 반영합니다.

로그 내보내기 페이지의 날짜 범위는 서버 타임스탬프를 기준으로 합니다.

보고서 페이지 및 기타 Singular 보고 도구(예: Singular API)의 날짜 범위는 조정된 타임스탬프를 기준으로 합니다.

예를 들어 6월 1일에 발생한 이벤트가 지연되어 6월 2일에 Singular 서버에 도착한 경우 이벤트 수에 불일치가 발생할 수 있습니다.

" 자세한 문제 해결 팁은 보고서 문제 해결 섹션을 참조하세요.

로그에 네트워크 및 캠페인 이름 대신 '오가닉', '억제됨' 또는 '미귀속' 이 표시되는 이유는 무엇인가요?

다운로드한 로그에 이러한 값이 표시되는 데에는 몇 가지 이유가 있을 수 있습니다.

1. 실제 유기적 전환

유료 소스가 없는 것으로 판단되는 전환은 오가닉으로 표시되며, 사용자 수준 로그에 이렇게 표시됩니다:

  • 네트워크: "유기적"
  • 캠페인: "어트리뷰션 없음"

2. 페이스북 캠페인

최종 사용자의 개인정보 보호 문제로 인해 Facebook은 Facebook의 자체 어트리뷰션 API를 기반으로 한 어트리뷰션에 대한 사용자 수준 데이터를 표시하는 것을 허용하지 않습니다. 이러한 어트리뷰션은 다음과 같이 표시됩니다:

  • 네트워크: "어트리뷰션 없음"
  • 캠페인: "어트리뷰션 없음"

자체 어트리뷰션 API 외에도, Facebook은 안드로이드 설치 리퍼러를 기반으로 하는 별도의 어트리뷰션 방법도 제공합니다. 해당 방법을 기반으로 한 어트리뷰션은 사용자 수준 보고서에서 모든 일반 세부 정보와 함께 표시됩니다.

" 자세한 내용은 Facebook 광고 어트리뷰션 연동을 참조하세요.

3. 틱톡 뷰스루 캠페인

2022년 3월 22일부터, T ikTok은 사용자 개인정보 보호 문제로 인해 MMP가뷰스루 캠페인의 사용자 수준 데이터를 마스킹하도록 요구합니다. 따라서 전환이 TikTok 뷰스루(노출 기반) 캠페인에 기인하는 경우, 포스트백과 로그에 다음과 같이 표시됩니다:

  • 네트워크: "TikTok 제한됨"
  • 캠페인: "TikTok 제한됨"

" 자세한 내용은 비즈니스 어트리뷰션 연동을 위한 틱톡을참조하세요 .

4. 데이터 보존 기간이 지났습니다.

일부 파트너는 사용자 개인정보 보호 문제로 인해 일정 기간이 경과한 후 사용자 레벨 데이터를 마스킹할 것을 Singular에 요구합니다.

설치 또는 리인게이지먼트가 다음 중 하나에 어트리뷰션되고 데이터 보존 기간이 지난 후 인앱 이벤트가 트리거되는 경우, 사용자 수준 이벤트 로그에 다음 세부 정보를 확인할 수 있습니다:

  • 네트워크: "유기적"
  • 캠페인: "억제됨"
파트너 최대 데이터 보존 기간
Facebook 6개월
TikTok 6개월
Twitter 6개월
구글 광고 6개월
Snapchat 2개월

팁: 전환 및 이벤트가 포함된 포스트백을 내부 BI 플랫폼으로 수신하는 경우, 내부적으로 세부 정보를 살펴보고 특정 디바이스 ID의 원래 획득 소스를 파악할 수 있습니다.

Singular의 집계 보고서보다 로그의 Facebook 이벤트/인스톨 수가 적은 이유는 무엇인가요?

2021년 10월부터 Facebook은 Singular와 같은 MMP가 Facebook의 자체 어트리뷰션 API를 통해 어트리뷰션된 설치 또는 이벤트에 대한 사용자 수준 정보를 표시하는 것을 허용하지 않습니다. 따라서 이러한 인스톨과 이벤트는 내부 BI로 전송되는 내보내기 로그 또는 포스트백에서 Facebook의 것으로 표시되지 않습니다. 이 제한은 집계된 데이터에는 적용되지 않으므로, Singular는 이러한 인스톨 및 이벤트에 대한 정보를 집계된 보고서(예: 보고서 페이지, Singular API 등)에 표시합니다.

자체 어트리뷰션 API 외에도 Facebook에는 Android 설치 리퍼러를 기반으로 하는 또 다른 어트리뷰션 솔루션이 있다는 점에 유의하세요. 인스톨 리퍼러를 통해 어트리뷰션된 인스톨과 이벤트는 내보내기 로그에 표시됩니다.

Facebook 캠페인에 대한 설치 리퍼러 기반 정보를 제공할 수 있도록 앱에 대한 설치 리퍼러 해독 키를 Singular에 제공하는 것이 좋습니다.

" 자세한 내용은 Facebook 광고 어트리뷰션 연동을 참조하세요.

FAQ

사용자 수준 데이터란 무엇인가요?

사용자 레벨 데이터는 Singular의 어트리뷰션 메커니즘과 부정행위 방지 엔진에 의해 기록되는 로데이터입니다.

여기에는 클릭, 전환, 리인게이지먼트, 인앱 사용자 이벤트, 포스트백, 사기 결정 등을 포함한 사용자 활동 및 어트리뷰션 관련 기록에 대한 세부 정보가 포함됩니다.

Singular는 이 데이터를 사용하여 보고서(예: 보고서 페이지)에 표시되는 집계된 데이터를 계산합니다.

Singular 어트리뷰션 서비스의 고객은 원시 사용자 수준 데이터에 액세스하여 문제가 의심되는 경우 집계된 보고서의 데이터를 교차 확인하는 등 다양한 방식으로 사용할 수 있습니다.

예시: 사용자 수준 이벤트 데이터를 보여주는 로그

Screen_Shot_2020-12-30_at_19.46.06.png

사용자 수준 데이터에 액세스하려면 어떻게 해야 하나요?

사용자 수준 데이터에 액세스하는 방법에는 세 가지가 있습니다:

1. 로그 내보내기 페이지(어트리뷰션 > 로그 내보내기)

Singular 플랫폼의 로그 내보내기 페이지에서는 클릭, 설치, 리인게이지먼트, 인앱 이벤트, 포스트백 및 사기 관련 데이터에 대한 사용자 레벨 데이터를 수동으로 다운로드할 수 있습니다. 이 페이지에서 CSV 파일을 생성합니다.

고객은 전월 초의 데이터를 다운로드할 수 있습니다. 예를 들어 2월 중순인 경우 1월 1일 이후의 데이터를 다운로드할 수 있습니다.

Singular 파트너가 사용할 수 있는 옵션은 파트너 포털 사용을 참조하세요 : 로그 내보내기를 참조하세요.

2. 데이터 대상

Singular의 데이터 대상(ETL)은 데이터를 Singular에서 내부 BI 플랫폼, 데이터 웨어하우스 또는 스토리지 서비스로 직접 푸시합니다. 이 방법으로 내보낼 수 있는 데이터 유형 중 하나는 사용자 수준 전환 및 이벤트입니다.

" Singular 데이터 대상 FAQ에서 자세히 알아보세요.

3. 내부 BI 포스트백구성

내부 BI 플랫폼으로 포스트백을 전송하도록 Singular를 구성하면 설치, 리인게이지먼트, 인앱 이벤트 및 사기 결정에 대한 실시간 데이터를 수신할 수 있습니다.

" 내부 BI 포스트백 FAQ에서 자세히 알아보세요.

로그 내보내기 페이지에서 사용자 수준 데이터를 다운로드하려면 어떻게 해야 하나요?

로그를 내보내려면:

  1. 어트리뷰션 > 로그 내보내기로 이동합니다.
  2. 관련 날짜 범위를 선택합니다. 지난달 초까지 로그를 내보낼 수 있습니다. 다운로드당 기록 한도를 초과하지 않도록 날짜 범위를 최대한 좁게 설정하는 것이 좋습니다.
  3. 내보낼 , 앱 사이트, 로그 유형 (클릭, 설치, 이벤트, 포스트백)을 선택합니다.
  4. 포함하려는 필드를 선택된 필드 상자로 드래그하여 선택합니다.

    Screen_Shot_2020-12-30_at_19.52.07.png

    정확한 사용자 수준 데이터를 얻으려면 로그를 내보내는 동안 디바이스 ID 필드를 선택해야 합니다.

  5. 선택적으로 어트리뷰션 파트너, 국가, 디바이스 ID 및 디바이스 유형별로 로그를 필터링할 수 있습니다. 이벤트 로그의 경우 특정 이벤트별로, 전환 로그의 경우 전환 유형별로 필터링할 수도 있습니다. 레코드 한도를 초과하지 않도록 가능한 한 로그를 필터링하는 것이 좋습니다.Screen_Shot_2020-12-30_at_19.19.49.png
  6. 로그 내보내기를 선택합니다.

제한 사항

  • Facebook은 Facebook의 자체 어트리뷰션 API에 기반한 사용자 수준 데이터에 대한 접근을 허용하지 않습니다. 일반적으로 자체 어트리뷰션된 Facebook 인스톨을 식별하는 모든 필드는 "어트리뷰션되지 않음"으로 표시됩니다. 또한 Facebook은 안드로이드 설치 리퍼러를 기반으로 하는 별도의 어트리뷰션 솔루션을 보유하고 있으며, 이 솔루션을 기반으로 어트리뷰션된 인스톨은 사용자 수준 내보내기에 표시된다는 점에 유의하세요. 자세한 내용은 Facebook 광고 어트리뷰션 연동 문서를 참조하세요.
  • 날짜 범위는 Singular 고객의 경우 지난달 초까지로 제한됩니다. Singular 파트너가 사용할 수 있는 옵션은 파트너 포털 사용을 참조하세요 : 로그 내보내기를 참조하세요.
  • 내보내기는 요청당 5백만 개의 레코드로 제한됩니다.
  • 로그는 현재 날짜의 최근 60분까지의 데이터를 제공합니다. 지난 60분간의 데이터를 보려면 실시간 데이터 확인란을 선택합니다.
  • Singular 데이터베이스에는 로그의 각 레코드와 관련된 두 가지 시간 값, 즉 서버 타임스탬프 (Singular 서버에서 이벤트를 수신한 시간 반영)와 조정된 타임스탬프 (이벤트가 발생한 원래 시간 반영)가 있습니다. 이로 인해 사용자 수준 데이터와 집계된 보고서 간에 불일치가 발생할 수 있습니다(자세히 알아보기).

기타 참고 사항

  • 시간대 필드는 Singular 계정에 설정된 시간대를 알려줍니다.
  • 타임스탬프가 있는 필드(예: 터치포인트__타임스탬프)는 구성된 표준 시간대로 내보내집니다. 유닉스 시간을 기준으로 한 타임스탬프(예: touchpoint__unix_timestamp)는 UTC 표준 시간대에 있습니다.
  • 기본적으로 내보내는 필드 목록을 변경하거나 내보낼 새 필드에 대한 요청을 추가하려면 고객 성공 매니저에게 문의하세요.
  • 네트워크에서 사용자 수준 사기 데이터를 요청하고 파트너 구성을 통해 사기 포스트백을 수신하도록 설정되어 있지 않은 경우, 사기 로그를 다운로드하여 네트워크와 공유할 수 있습니다. Singular는 동의 없이 지원 티켓을 통해 이 데이터를 어떤 네트워크와도 공유하지 않습니다.
어떤 유형의 로그를 다운로드할 수 있나요?

클릭 수

설치 또는 리인게이지먼트의 어트리뷰션을 결정하기 위해 조사된 모든 클릭을 포함합니다.

전환

설치 및 리인게이지먼트 이벤트에 대한 정보, 기여자, 기타 기여에 대한 세부 정보(예: 결정론적 기여인지 확률론적 기여인지)가 포함됩니다.

참고: 전환 이벤트에 제공된 위치는 앱 내부에서 감지된 위치나 사용자가 제공한 정보가 아닌 이벤트가 트리거된 IP를 기반으로 합니다. 이벤트에 대한 다른 위치 데이터 소스가 있는 경우 앱에서 Singular로 전송한 패스스루 파라미터를 읽어서 확인할 수 있습니다.

이벤트

세션, 등록, 구매 등 인앱 이벤트에 대한 데이터와 Singular SDK/S2S 연동 시 앱에 정의된 기타 이벤트가 포함됩니다.
이벤트 로그 데이터를 보고서의 이벤트 수와 비교할 때는 코호트 기간(1일, 7일, 14일 등) 대신 보고서에서 실제 기간을 사용해야 합니다. 보고서에는 실제 기간의 고유 이벤트에 대한 데이터가 표시되지 않는다는 점에 유의하세요.

포스트백

어트리뷰션 결정에 대한 포스트백뿐만 아니라 Singular에서 보낸 모든 포스트백에 대한 데이터를 포함합니다. 이 로그에는 내부 BI(구성한 경우) 및 타사 분석 도구에 대한 포스트백이 포함됩니다.

팁: 포스트백 로그를 다운로드할 때 응답 HTTP 코드응답 HTTP 본문 필드를 선택해야 합니다. 응답 HTTP 코드는 포스트백이 성공적으로 전달되었는지 여부를 알려줍니다. 200 코드는 성공, 그 외의 값은 오류를 의미합니다. 전송에 오류가 발생하면 Singular는 1분, 5분, 15분, 30분, 60분 간격으로 5번 더 포스트백을 재시도합니다. 응답 HTTP 본문에는 오류에 대한 추가 세부 정보가 포함될 수 있습니다.

SKAN(SKAdNetwork) 포스트백

Singular가 광고 네트워크 파트너로부터 받은 SKAdNetwork 포스트백 로그입니다. 이러한 포스트백은 SKAdNetwork 트래킹을 사용하는 iOS 앱과 포스트백을 전달할 수 있는 SKAdNetwork와 Singular의 연동을 보유한 파트너에게만 제공됩니다. Singular의 SKAdNetwork 솔루션에 대해 자세히 알아보세요.

Fraud

Singular 사기 방지 시스템의 원시 출력입니다.

이 로그에는 설치 이벤트와 관련된 모든 터치포인트(클릭, 노출 등)에 대한 행이 포함되며, 모든 설치에 대한 어트리뷰션 옵션으로 검사되는 '오가닉 설치' 옵션에 대한 행도 포함됩니다(자세한 내용은 사기 탐지 프로세스를 참조하세요). 따라서 하나의 인스톨에 대해 여러 터치포인트가 부정 행위로 거부될 수 있습니다.

다른 필드는 무엇을 의미하나요?

" 각 로그의 필드에 대한 설명은 로그 내보내기를참조하세요 :지원되는 필드를 참조하세요.

로그를 사용하여 집계된 보고서에서 설치를 교차 확인하려면 어떻게 해야 하나요?
  1. 보고서 페이지(또는 리포팅 API)에서 소스 및 캠페인별 인스톨을 보여주는 보고서를 실행합니다.
  2. 로그 내보내기 페이지에서 전환 로그 유형을 선택하고 동일한 날짜 범위에 대해 다음 필드를 가져옵니다:

crosscheck.png

Singular는 사용자 수준 데이터를 얼마나 오래 보관하나요?

연동 파트너 및 글로벌 사용자 개인정보 보호 표준을 준수하기 위해, Singular는 특정 경우에 사용자 수준 데이터 보존을 최대 30일로 제한할 수 있습니다. 달리 명시되지 않는 한, 사용자 수준 데이터의 기본 보존 기간은 다음과 같습니다:

  • 노출 데이터: 수집일로부터 14일 동안 보관됩니다.
  • 데이터를 클릭합니다: 수집일로부터 30일 동안 보관됩니다.
  • 포스트백 데이터: 수집일로부터 30일간 보유합니다.
  • 이벤트 데이터: 전월 초부터최대 60일까지 보유합니다(최대 60일).
  • 어트리뷰션 데이터: 전월 1일부터 보유(최대 60일).
  • 사기 데이터: 전월 초부터 보유(최대 60일).

이러한 보존 기간은 개인정보 보호 규정을 준수하는 동시에 분석 및 보고를 위한 필수 데이터에 대한 액세스를 제공합니다. 이 기간 이후에도 모든 로그 수준 데이터를 보존하려면 자동 내보내기를 설정하여 이 정보를 캡처하고 내부 시스템에 저장할 것을 적극 권장합니다.