로그 내보내기 및 유저 레벨 데이터 FAQ

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

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

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

로그 트러블슈팅

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

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

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

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

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

서버 시간 대 조정된 시간

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

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

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

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

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

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

로그에 네트워크 및 캠페인 이름 대신 '오가닉', '억제됨(Suppressed)' 또는 '어트리뷰트되지 않음(Unattributed)'가 표시되는 이유는 무엇인가요?

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

1. 실제 오가닉 전환

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

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

2. 페이스북 캠페인

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

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

자체 어트리뷰션 API 외에도, 페이스북에는 안드로이드 인스톨 리퍼러를 기반으로 하는 별도의 어트리뷰션 방법이 있습니다. 해당 방법을 기반으로 하는 어트리뷰션은 사용자 수준 보고서에서 모든 일반 세부 정보와 함께 표시됩니다.

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

3. 틱톡 뷰-스루 캠페인

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

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

" 자세한 내용은 비즈니스 어트리뷰션 통합을 위한 TikTok을 참조하세요 .

4. 데이터 보존 기간이 지난 경우

일부 파트너는 사용자 개인정보 보호 문제로 인해 일정 기간이 지난 후 사용자 레벨 데이터를 마스킹하기 위해 싱귤러를 요구합니다.

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

  • 네트워크: "Organic"
  • 캠페인: "Suppressed"
파트너 최대 데이터 보존 기간
Facebook 6개월
틱톡 6개월
트위터 6개월
구글 광고 6개월
Snapchat 2개월

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

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

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

자체 어트리뷰션 API 외에도, Facebook은 안드로이드 인스톨 리퍼러를 기반으로 하는 또 다른 어트리뷰션 솔루션을 제공합니다. 인스톨 리퍼러를 통해 어트리뷰션된 인스톨과 이벤트는 내보내기 로그에 표시됩니다.

Facebook 캠페인에 대한 인스톨 리퍼러 기반 정보를 제공할 수 있도록 앱의 인스톨 리퍼러 복호화 키를 싱귤러에 제공하는 것이 좋습니다.

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

FAQ

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

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

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

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

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

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

Screen_Shot_2020-12-30_at_19.46.06.png

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

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

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

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

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

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

2. 데이터 데스티네이션

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

" Singular 데이터 데스티네이션 FAQ에서 자세히 알아보세요.

3. 내부 BI 포스트백 구성

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

" 내부 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 광고 어트리뷰션 연동 문서를 참조하세요.
  • 날짜 범위는 싱귤러 고객의 경우 최대 지난달 초까지로 제한됩니다. 싱귤러 파트너가 사용할 수 있는 옵션은 파트너 포털 사용을 참조하세요: 로그 내보내기를 참조하세요.
  • 내보내기는 요청당 5백만 개의 레코드로 제한됩니다.
  • 로그는 현재 날짜의 최근 60분까지의 데이터를 제공합니다. 지난 60분간의 데이터를 보려면 '실시간 데이터 확인(Use Real-time data)'를 체크합니다.
  • 싱귤러 데이터베이스에는 로그의 각 레코드와 관련된 두 가지 시간 값, 즉 서버 타임스탬프(싱귤러 서버에서 이벤트를 수신한 시간 반영)와 조정된 타임스탬프 (이벤트가 발생한 원래 시간 반영)가 있습니다. 이로 인해 사용자 수준 데이터와 집계된 보고서 간에 불일치가 발생할 수 있습니다(자세히 알아보기).

기타 참고 사항

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

클릭 수

설치 또는 재참여의 어트리뷰션을 결정하기 위해 조사된 모든 클릭을 포함합니다.

전환

설치 및 재참여 이벤트에 대한 정보, 해당 이벤트의 어트리뷰션 대상, 어트리뷰션에 대한 기타 세부 정보(예: 결정론적 또는 확률론적 어트리뷰션)가 포함됩니다.

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

이벤트

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

포스트백

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

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

SKAN(SKAdNetwork) 포스트백

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

Fraud

싱귤러 사기 방지 시스템의 원시 출력입니다.

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

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

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

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

crosscheck.png

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

통합 파트너 및 사용자 개인정보 보호에 대한 글로벌 표준을 준수하기 위해, 싱귤러는 사용자 수준 데이터를 30일 이상 보유하지 않습니다.