Singular 리포팅 API: 활용 사례와 데이터 타입

Singular 리포팅 API가 작동하는 원리와 가져올 수 있는 데이터 종류들에 대하여 알아보세요.

저희는 이 가이드와 더불어 Singular 리포팅 API 쿼리 방법 리포팅 API 레퍼런스를 읽어보시기를 권고드립니다.

 

리포팅 API에 오신 걸 환영합니다!

리포팅 API는 귀사의 마케팅 캠페인에 대한 집계된 통계를 제공하며, 이를 통해 내부 BI 시스템 또는 마케팅 퍼포먼스 대시보드를 이해하실 수 있습니다. 

다른 기능을 찾으신다면? 

  • Singular는 Singular 데이터 데스티네이션 (ETL) 또한 제공합니다: 프리미엄 서비스로서 Singular로부터 귀사의 데이터베이스 또는 BI 플랫폼으로 데이터를 추출하는 더 쉬운 방법을 제공합니다.  
  • 리포팅 API는 집계된 데이터만 제공합니다. 유저 레벨 데이터Singular의 어트리뷰션 서비스로부터 추출하시려면, 어트리뷰션 로그 추출을 참고하세요.

첫 번째: 이용 사례를 이해하세요

Singular는 다른 곳으로부터 데이터들을 모으고 표준화하므로, 보고 싶으신 데이터나 종류에 따라 다른 쿼리 방법을 사용하셔야 합니다.

모든 쿼리는 같은 엔드포인트로 진행됩니다 (비동기 리포트를 생성하세요) - 쿼리는 어떤 필드를 포함하는지에 따라 달라집니다.

이용 사례 참고 문헌:
  • Singular를 통해 캠페인 데이터를 광고매체와 에이전시로부터 수집하세요. 
  • 비용과 가용성 비율에 관한 데이터를 얻을 수 있습니다.

네트워크 데이터 쿼리

  • Singular의 어트리뷰션 서비스 또는 제3의 어트리뷰션 트래커를 통해 데이터 커넥터를 설정하세요. 
  • 컨버전과 매출 같은 트래커 데이터로부터 추출하여 귀사의 BI 플랫폼 또는 분석에 사용할 수 있습니다. 
  • 만약 ROAS 계산을 위해 광고 매체 데이터(예를 들어 캠페인 비용)와 트래커 데이터를 함께 사용한다면, 귀사의 툴을 직접 사용하세요. 

트래커 데이터와 네트워크 데이터를 따로 쿼리

  • Singular 어트리뷰션 서비스 또는 제3의 어트리뷰션 트래커를 데이터 커넥터로 사용합니다.
  • Singular가 미리 만든 로직을 이용하여 매체와 협업하고 가장 강력한 세분성을(granularity) 이용한 트래커 데이터를 사용하실 수 있습니다. 

통합 데이터 쿼리

매체 데이터 쿼리

매체 데이터는 Singular에 등록한 모든 매체로부터 수집된 캠페인 통계를 포함합니다. 그 데이터는 (Singular에서 설정 하더라도) 어트리뷰션 트래커로부터의 데이터를 포함하지 않습니다.

예를 들어, 주어진 날짜 범위안에서 각 캠페인(adn_campaign_id)의 코스트(adn_cost)를 보기 위한 쿼리를 실행할 수 있습니다. 

Screen_Shot_2020-07-01_at_0.14.09.png

매체 데이터에서 가능한 필드

각 필드를 설명한 메트릭과 디멘션 페이지를 참고하세요.

COLLAPSE ALL
매체 디멘션

기본 디멘션 (모든 매체에 사용 가능한 디멘션입니다)

  • app
  • source
  • adn_campaign_id
  • adn_campaign_name
  • adn_campaign_url
  • data_connector_id
  • data_connector_source_name
  • data_connector_username
  • data_connector_timestamp_utc

추가적인 옵션 디멘션 (매체에 따라 지원 여부가 달라집니다)

  • os
  • platform
  • country_field
  • region_field
  • city_field
  • dma_id_field
  • dma_name_field
  • adn_sub_adnetwork_name
  • adn_account_id
  • adn_account_name
  • adn_sub_campaign_id
  • adn_sub_campaign_name

키워드 또는 퍼블리셔에 따른 세부 내역 (매체에 따라 지원 여부가 달라지며, 크리에이티브 세부 내역과 같은 쿼리로 가져올 수 없습니다)

  • keyword_id
  • keyword
  • publisher_id
  • publisher_site_id
  • publisher_site_name

크리에이티브 세부 내역 (매체에 따라 지원 여부가 달라지며, 보통의 경우 키워드/퍼블리셔와 같은 쿼리로 가져올 수 없습니다)

  • creative_type
  • adn_creative_id
  • adn_creative_name
  • creative_url
  • creative_image
  • creative_text
  • creative_width
  • creative_height
  • creative_is_video
  • asset_id
  • asset_name

캠페인 속성 (더 보기):

  • bid_type
  • bid_strategy
  • bid_amount
  • campaign_objective
  • standardized_bid_type
  • standardized_bid_strategy
  • original_bid_amount
  • campaign_status
  • min_roas
  • original_metadata_currency

커스텀 디멘션:

만약 기본 매체 디멘션에 기반하여 커스텀 디멘션을 정의했다면, 해당 ID를 사용하여 가져올 수 있습니다. 커스텀 디멘션 엔드포인트를 사용해서 귀사의 어카운트 또는 해당 ID에 정의된 모든 커스텀 디멘션들을 얻으세요.

매체 메트릭 
  • adn_cost
  • adn_original_cost
  • adn_original_currency
  • adn_impressions
  • adn_clicks
  • adn_installs

주의:

  • Singular는 가능한 최고의 세분성(granularity)을 제공할 것입니다만, 모든 매체가 모든 디멘션을 제공하지는 않습니다. 데이터 커넥터 세부사항을 참고해서 Singular가 각 소스로부터 어떤 데이터들을 가져오는지 알아보세요. 
  • 광고 매체로부터 보고되는 노출, 클릭, 인스톨과 같은 통계는 어트리뷰션 트래커로부터 보고된 통계와 일치하지 않을 수 있습니다.

트래커 데이터와 매체 데이터를 따로 쿼리

API를 사용하여 트래커 데이터를 가져올 수 있습니다 - Singular의 어트리뷰션 서비스의 통계 또는 설치하신 제3의 어트리뷰션 트래커를 사용합니다. (예를 들어 Appsflyer 또는 Google Analytics)

예를 들어, 주어진 날짜 범위 내 각 캠페인(tracker_campaign_id)에 따른 클릭(tracker_clicks)과 인스톨(tracker_installs)을 보기 위해 쿼리를 할 수 있습니다. 트래커 통계는 또한 포스트 인스톨과 매출을 포함합니다.

Screen_Shot_2020-07-01_at_0.15.21.png

트래커 데이터에 쿼리를 진행하려면, 쿼리를 매체 데이터에 연결하여 캠페인 CPI 또는 ROI를 계산할 수 있습니다.

하지만, 통합된 리포트를 실행하는 것이 같은 결과를 조금 더 쉽게 얻는 방법입니다.

트래커 데이터에서 가능한 필드 

각 필드에 관하여 더 많은 설명을 보시려면 메트릭과 디멘션 페이지를 참고하세요.

COLLAPSE ALL
트래커 디멘션들

기본 디멘션 (모든 네트워크에서 가능합니다):

  • app
  • source
  • tracker_campaign_id

추가적인 옵션 디멘션 (트래커에 따라 지원 여부가 달라집니다):

  • tracker_campaign_name
  • os
  • platform
  • country_field

커스텀 디멘션:

만약 기본 트래커 디멘션에 기반하여 커스텀 디멘션을 정의하셨다면, 해당 ID를 사용하여 풀링할 수 있습니다. 해당 ID와 귀사의 어카운트에 정의된 커스텀 디멘션들을 모두 얻으려면  커스텀 디멘션 엔드포인트를 사용하세요.

트래커 메트릭

기본 메트릭:

  • tracker_impressions
  • tracker_clicks
  • tracker_installs
  • tracker_conversions
  • tracker_reengagements
  • daily_active_users

코호트 메트릭:

  • revenue
  • original_revenue

사용 가능한 코호트 메트릭의 전체 리스트를 보시려면, 코호트 메트릭 엔드포인트를 참고하세요. 더 많은 정보를 원하시면, 코호트 메트릭이란 무엇인가요? 를 참고하세요.

주의하실 점은 코호트 메트릭이 CPE와 CPI와 같이 비율에 기반한 계산법을 포함한다는 것입니다. 저희는 API 리포트에서 이런 계산법들을 사용하는 것을 권장하지 않습니다. (더 보기)

이벤트:

정의하신 어떠한 이벤트의 통계라도 가져올 수 있습니다. Singular 앱에서 정의된 이벤트 이름을 사용하는 대신, 이벤트의 자동생성 ID를 사용해야 하며, 이는 코호트 메트릭 엔드포인트에서 얻을 수 있습니다.

통합 데이터 쿼리

API를 사용하여 매체와 트래커 데이터를 통합한 쿼리를 실행할 수 있고, 이는 캠페인 코스트와 캠페인 매출 또는 다른 캠페인 퍼포먼스 KPI를 보여줍니다. 

이런 종류의 쿼리는 트래커와 매체 데이터에 기반한 특별한 디멘션과 메트릭을 활용하고, 이는 트래커와 네트워크 데이터에 기반하지만, 내부에서는 하기와 같은 추가적인 로직을 활용합니다.

Screen_Shot_2020-07-01_at_0.16.14.png

통합 쿼리가 하는 일이란?

  1. 통합 쿼리는 같은 쿼리 안에 매체 통계(코스트와 같은) 또는 트래커 통계(인스톨과 매출과 같은)를 모두 포함합니다.
  2. 스마트 디멘션은 언제든 매체와 트래커 데이터를 하나의 열에 통합하는 데 도움을 줍니다. 

    Singular의 "통합(combined)" 또는 "unified" 디멘션들은 모두 매체와 트래커 데이터에 기반하며 이는 공통된 데이터 중 잘못 매칭된 데이터를 바로잡고 가능한 높은 세분성(granularity)에 기반한 통합 데이터를 볼 수 있게 합니다. 

    예를 들어, 트래커의 특정 캠페인의 이름이 매체에서 가져온 캠페인 이름과 약간의 차이가 있을 수 있습니다. 그래서 만약 트래커 리포트와 매체 리포트를 실행하고 결과들을 합쳐 조회하면, 캠페인에 대한 별개의 열을 갖게 되며 한 열이 매체 통계와 다른 트래커 통계를 갖게 됩니다. 하지만, 만약 통합 리포트를 실행하면 (unified_campaign_name 디멘션을 사용), Singular는 캠페인에 대한 매체 통계와 트래커 통계를 같은 열에 볼 수 있게 합니다.  

  3. 커스텀 가능한 스마트 메트릭이 각각 케이스별로 올바른 소스로부터 데이터들을 가져옵니다.

    예를 들어 같은 날짜 범위에 대한 각 캠페인에 대한 인스톨 수와 같이 매체와 트래커로부터 제공된 동일한 통계자료를 제공하는 경우, 통합된 메트릭이 일반적인 산업의 사용량에 기반하여 트래커 통계 또는 매체 통계 중 지능적으로 선택한 후 한 소스에 대한 정확한 정보를 제공합니다.  

    예를 들어, custom_installs 메트릭은 Facebook 또는 Twitter와 같이 매체의 통계가 더 중요하다 판단되는 자가 기여 네트워크(SANs)가 아닌 이상 트래커의 인스톨 수를 포함하며, 매체 메트릭을 포함합니다.  

    만약 Singular의 기본 선택지가 특정한 케이스에 부합하지 않는 경우, Singular는 특정 메트릭을 재설정할 수 있습니다.  

    주의: 커스텀 메트릭은 크리에이티브 세부 내역에는 사용할 수 없습니다. 매체 메트릭 또는 트래커 메트릭 중에서 선택하세요. 

메트릭의 소스를 알아야 하는 경우라면?

각 캠페인에 대하여 각 메트릭의 정확한 소스를 알고 싶을 수 있습니다 - 예를 들어, 매체와 트래커 사이의 중요한 불일치를 찾거나 트러블슈팅하는 경우가 해당합니다. 

이 경우, 매체 메트릭과(네트워크 데이터에서 사용 가능한 필드들을 참고) 트래커 메트릭(트래커 데이터에서 사용 가능한 필드들을 참고)을 추가하여 통합 리포트를 만들 수 있습니다. 예를 들어, custom_installs, adn_installs, tracker_installs 이 세 개의 인스톨 메트릭을 풀링하세요. 

이 방법으로, custom_installs를 KPI처럼 사용할 수 있지만 adn_installs와 tracker_installs 사이에 상당한 불일치가 있는지 확인하는 것이 좋습니다.  

통합 데이터에 사용 가능한 필드

메트릭과 디멘션 페이지에서 각 필드에 대한 설명을 참고하세요.

COLLAPSE ALL
디멘션

기본 디멘션 (모든 매체와 트래커에서 사용 가능한 디멘션):

  • app
  • source
  • unified_campaign_id
  • unified_campaign_name

추가적인 옵션 디멘션 (매체/트래커에 따라 지원 상이):

  • os
  • platform
  • country_field
  • adn_sub_adnetwork_ name
  • adn_account_id
  • adn_account_name
  • sub_campaign_id
  • sub_campaign_name

키워드 또는 퍼블리셔에 따른 세부 내역 (매체/트래커에 따라 지원 상이하나 크리에이티브 세부 내역과 같은 쿼리 내에서 풀링 불가능):

  • keyword_id
  • keyword
  • publisher_id
  • publisher_site_id
  • publisher_site_name

크리에이티브 세부 내역 (매체에 따라 지원 상이, Singular의 어트리뷰션 서비스 유저들에게만 사용 가능): 

  • creative_type
  • adn_creative_id
  • adn_creative_name
  • creative_url
  • creative_image
  • creative_text
  • creative_width
  • creative_height
  • creative_is_video
  • asset_id
  • asset_name

커스텀 디멘션:

만약 커스텀 디멘션을 이 디폴트 디멘션들에 준하여 정의했다면, 그 ID들을 사용하여 풀링할 수 있습니다. 커스텀 디멘션 엔드포인트를 사용하여 귀사의 어카운트와 그들의 ID에 따라 정의된 모든 커스텀 디멘션들을 얻어보세요.

메트릭

기본 메트릭:

  • adn_cos
  • adn_original_cost
  • adn_original_currency
  • custom_impressions
  • custom_clicks
  • custom_installs
  • tracker_conversions
  • tracker_reengagements
  • daily_active_users

비디오 크리에이티브와 비디오에 기반한 캠페인들을 위한 메트릭:

  • video_views
  • video_views_25pct
  • video_views_50pct
  • video_views_75pct
  • completed_video_views
  • completed_video_view_rate

코호트 메트릭:

  • revenue
  • original_revenue

전체 코호트 메트릭 리스트를 보려면, 코호트 메트릭 엔드포인트를 참고하세요. 더 많은 정보를 원하시면, 코호트 메트릭이란? 를 참고하세요.

비율 기반 계산법을 포함하는 CPE와 CPI와 같은 코호트 메트릭에 주의하세요. 저희는 이 API 리포트 사용을 권장하지 않습니다. (더 보기).

이벤트:

정의하신 어떠한 이벤트 통계도 가져올 수 있습니다. Singular 앱에서 정의된 이벤트 이름을 사용하는 대신, 이벤트의 자동생성 ID를 사용하셔야 하며, 이는 코호트 메트릭 엔드포인트에서 얻으실 수 있습니다.

주의 사항:

    • Singular는 가장 높은 세분화를 제공하려 하지만 모든 매체와 트래커가 모든 세부 내역을 제공하지는 않습니다. Singular가 각 소스에서 어떤 데이터들을 풀링하는지에 대해 더 보시려면 데이터 커넥터의 세부정보 페이지를 참고하세요.
  • 크리에이티브-레벨 통합 리포트는 Singular의 어트리뷰션 서비스를 이용하시는 유저들만 사용 가능합니다.
  • 커스텀 메트릭은 크리에이티브 세부 내역에 사용할 수 없습니다. 매체 메트릭("adn_…") 또는 트래커 메트릭 ("tracker_…")중에서 선택하세요.

요약: 어떤 종류의 데이터를 사용할 수 있을까요?

  Singular에서 사용 목적은...
  애널리틱스 + Singular 어트리뷰션 애널리틱스만 사용하나, 제3의 트래커로부터 Singular로 데이터를 풀링 애드 네트워크로부터 데이터 풀링
매체 데이터  사용 가능 사용 가능 사용 가능
트래커 데이터 사용 가능 사용 가능 -
통합 필드 사용 가능 자기 기여 네트워크에서만 사용 가능 (크리에이티브 세부 내역 외) -

 

도움이 되었습니까?