공식문서_Singular_Reporting API 개괄(번역 요약)

Singular란

Singular는 2014년에 설립된 마케팅 인텔리전스 플랫폼 기업으로, 마케팅 데이터를 제공한다. 샌프란시스코와 텔아비브를 거점으로 두고있다.

Singular에서는 Reporting API, Tracking Links API, SKAdNetwork API, AD Monetization API 등 다양한 API들을 제공한다. 이 글은 ReportingAPI의 소개 공식문서를 간략하게 요약하는 글이다. 상세 정보는 아래 링크를 참조하길.

https://support.singular.net/hc/en-us/articles/207553433

Reporting API에서 제공하는 데이터

Reporting API에서 얻을 수 있는 것:

• 애드네트워크 사들과 에이전시들로부터의 종합 데이터. ex) campaign const
• attribution tracker/MMP로부터의 종합 데이터
• 둘 다 합친 것

Use Case에 따른 필요 데이터 유형

• Network 데이터
  • 모든 애드네트워크와 에이전시로부터 campaign 데이터 가져오고 싶을 때
  • costs, run rates 알고싶을 때
• Trackerand Network 개별 데이터
  • Singular attribution service 사용하거나 서드파티 attribution tracker에 데이터 연결지을 때
  • conversions, revenue 등 트래커 데이터를 가져오고 싶을 때
  • 이 데이터들을 우리의 BI 플랫폼 또는 분석에 사용하고 싶을 때
• 합친 데이터
  • Singular attribution service 사용하거나 서드파티 attribution tracker에 데이터 연결지을 때
  • Singular에서 네트워크와 트래커 데이터를 합쳐주는 로직을 사용하고 싶을 때

Singular 서비스에 대한 어필이 많지만 대충 이런 경우 이런 데이터를 사용하면 된다고 한다. 데이터 유형별로 상세하게 알아보자.

Reporting API 데이터 유형

Querying Network Data

• Network 데이터는 여러분이 Singular에서 등록한 애드네트워크들로부터 가져온 캠페인 통계들을 말한다. 여기에 attribution tracker 데이터는 없다
• campaign에 대한 cost, impressions, clicks 등

Querying Tracker Data and Network Data Separately

• Singular나 서드파티에서 attribution 데이터를 원한다면 tracker data를 가져오면 된다(ex, Singular, Appsflyer, Google Analytics)
• clicks, installs 등

Querying Combined Data

• 네트워크와 트랙커 쿼리 합쳐서 가져오고 싶을 때 쓴다. 예를 들어 campaign cost와 revenue, 다른 캠페인의 performance KPI 등

Reporting API 쿼리 보내는 방법

1. Generating asynchronous report : Query Create Async Report endpoint, specifying the metrics and dimensions. It returns a report ID
2. Getting Report Status : Query Get Report Status API enpoint to see when the report has finished running
3. Download : report from the report URL

한 마디로 먼저 report를 생성한 다음, 리포트에 대한 ID를 받는 것이 첫 번째다. 그 다음 리포트가 생성되는 진행상황을 확인하다가 만들어지면 최종적으로 다운로드 하면 된다.

그런데 쿼리 요청 시 일자는 하루 단위로 하는 것을 권장한다. 용량이 많기 때문이다.

매일 업데이트 받고 싶은 경우, 어제까지의 데이터까지 얻을 수 있다고 한다. 싱귤러 측에서 추천하는 시간대는 Network Data의 경우 7일 전(1주일) 기준, 그리고 Tracker and Combined Data의 경우 요청 기간 길이의 이전 날짜로 요청하라 한다. 만약, 최근 30일치 요청 한다면 30일 전으로 요청하라 한다.

데이터 존재 여부에 의사결정 트리는 아래와 같다.