브랜치는 항상 고객에게 업계 최고의 API 옵션을 제공하고 있습니다. 브랜치를 사용하시면 다양한 API 옵션을 통해 데이터를 프로그래머틱 방식으로 내보낸 다음, 이를 활용해 사용자 획득 및 재참여에 대한 깊은 인사이트를 얻을 수 있습니다. Custom Export API, Scheduled Log Exports API, Query API, Aggregate API, 웹훅 및 데이터 연동 기능을 모두 사용할 수 있습니다.
하지만 어떨 때 어떤 API를 사용해야 할까요? 선택지가 너무나 다양하기 때문에 자연스레 궁금해질 것입니다.
Branch의 Data Export API를 사용해야 할 경우
어떤 Export API를 사용해야 할지 고민하기 전, 스스로에게 먼저 자문해 보세요. 왜 데이터 내보내기 기능을 쓰려고 하시나요? 브랜치는 데이터를 프로그래머틱 방식으로 내보낼 수 있는 다양한 방식을 제공합니다. 이를 통해 앱 사용자가 어떤 식으로 앱을 사용하는지에 대해 인사이트를 얻는 데 커다란 도움이 됩니다. 만약,
- 모바일 앱 사용자를 충분히 확보하려고 하고 있고,
- 사용자가 우리 앱에서 어떤 것을 좋아하는지에 대해 더 깊이있는 인사이트를 얻고 싶고,
- 브랜치 대시보드 밖에서도 브랜치 데이터를 확인하고 싶은 경우
…브랜치의 Data Export API 제품군을 활용하면 위의 모든 조건을, 오히려 그 이상을 달성해낼 수 있습니다.
Branch의 Data Export 제품군 소개
이렇듯 다양한 선택지 중에서 지금 해결하려는 과제에 어떤 API가 적합한 도구인지 이해하는 것이 중요합니다.
Custom Export API를 사용하면 디바이스 수준의 데이터를 내보낼 수 있으며, 내보내기 원하는 필드를 콕 집어 선택할 수 있습니다. 지금 보고자 하는 분석에 꼭 의미 있는 이벤트만 포함되도록 데이터를 필터링 할 수도 있습니다. 따라서 지난 7일 이내의 데이터를 내보내려는 경우라면, 이 Custom Export API가 적절합니다. Custom Export는 기술적으로 복잡한 영역을 굳이 다룰 필요가 없이 누구나 손쉽게 사용할 수 있는 UI로 구성되어 있습니다. 즉, 직접 쿼리를 짤 줄 몰라도 됩니다. 또한 템플릿 기능(Saved View)도 준비하고 있습니다. 가장 자주 사용되는 필드 구성으로 준비된 템플릿을 활용해, 어떻게 데이터를 받아야 할지 막막했던 분들도 손쉽게 필요한 데이터를 내보내실 수 있습니다. 이 데이터는 로그 수준 데이터이기 때문에 PII(개인 식별 정보) 필드는 7일 후에 자동으로 해싱됩니다.
Scheduled Log Exports API를 사용하면, 원하는 디바이스 레벨 데이터를 예약된 일정에 따라 주기적으로 내보낼 수 있습니다. 데이터 전송 주기를 매시간 또는 매일 간격으로 원하는 만큼 빈도를 지정할 수 있습니다. 또한 Branch의 서버에서 자동으로 AWS s3 버킷과 같은 클라우드 데이터 서비스로 데이터를 곧장 보낼 수 있습니다.
중요한 팁: Branch 데이터 쿼리를 처음 접할 때에는 Custom Export API를 사용하는 것이 좋습니다. 원하는 쿼리가 완성되어 있고 해당 쿼리를 반복적으로 실행하려는 경우에는 Scheduled Log Export API를 통해 손쉽게 데이터 요청을 설정할 수 있습니다.
Data Integrations을 통해 Adobe Analytics, Google Analytics, Segment, Amplitude, Braze 등과 같은 다양한 데이터 및 분석 파트너와 손쉽게 연동할 수 있습니다. 대시보드에서 연동을 활성화하거나 몇 가지 코드 스니펫을 앱에 추가하면 Branch에서 집계된 이벤트를 원하는 분석 플랫폼에 자동으로 전송되도록 설정할 수 있습니다. 또한 타사에서 집계된 이벤트를 Branch로 가져오려는 경우 Segment 및 mParticle과 같은 CDP(고객 데이터 플랫폼)와의 연동을 활용할 수 있습니다.
Webhook은 Branch에서 실시간으로 데이터가 필요한 경우에 유용합니다. 예를 들어 특정 이벤트가 발생했을 때 Branch에서 이벤트가 처리되는 즉시 자사 서버로 전송하고 싶을 수 있습니다. 참고: Branch 대시보드에서 Webhook을 설정할 때에는 freemarker 구문을 활용한 커스텀 설정이 필요합니다.
Query API 는 캠페인 수준 데이터를 내보낼 때 사용하며 최대 2년 전까지의 데이터를 내보낼 수 있습니다. SAN(Self Attributing Networks)에서 광고 지출 데이터와 관련된 인사이트를 얻고싶을 경우 이 API를 사용하면 됩니다. 또한 Query API는 데이터를 실시간으로 내보낼 수 있다는 점에 주목할 필요가 있습니다. 즉, 쿼리를 실행한 후 곧바로 결과를 얻을 수 있다는 뜻입니다. 그러나 이 API를 활용해서 대행사와 같은 제3자에게 데이터 내보내기 권한을 부여해주려는 경우, 각 권한에 따라 특정 데이터에 대해 선별적으로 공유 여부를 설정할 수는 없다는 점에 유의하시기 바랍니다.
Aggregate API는 Branch의 Data Export API 제품군 중 가장 최근에 출시되었습니다. Aggregate API를 사용하면 대행사와 같이 데이터 접근 권한이 제한된 사용자도 허용된 권한 내에서 집계값(aggregated) 데이터를 프로그래머틱 방식으로 내보낼 수 있습니다. Facebook AMM(Advanced Mobile Measurement) 프로그램의 지원 중단으로 인해 로그 수준 데이터 내보내기가 제한된 상황에서, Aggregate API는 Facebook 캠페인 성과와 그 인사이트를 제3자(예: 대행사 및 광고 파트너)에게 공유하려고 할 때 적합합니다.
참고: Cohort API는 Aggregate API의 구버전이며, 이 Cohort API에는 Branch 대시보드에서 바로 사용할 수 있는 간소화된 버전도 있습니다. 그러나 이 API의 진정한 기능을 한껏 활용하려면 프로그래머틱 방식으로 쿼리를 작성해야 합니다.
마지막으로, 몇몇 분들은 Branch의 Daily Export API가 익숙하실 수도 있습니다. Daily Export API는 위에서 설명한 다른 API보다 유연성이 떨어지는 오래된 API이지만(Custom Export API가 훨씬 더 정교한 대안입니다) 모든 API를 빠짐없이 설명하기 위해 언급합니다. 특정 날짜의 데이터를 내보내려면 다음 날 오후 7시(UTC)까지 기다려야 합니다. Branch 대시보드에서 코딩 없이 대시보드 UI 만으로 daily export를 실행할 수 있습니다. 그러나 한 가지 주의할 점은, 이벤트와 관련된 모든 필드가 모조리 내보내진다는 것입니다. 따라서 분석하고자 하는 내용과 관계없는 컬럼까지 모두 출력될 수 있습니다.
업무에 가장 적합한 API 선택
가장 적합한 Export API를 선택하려면, 아래 질문에 답해보시기 바랍니다.
- 집계값(aggregate) 데이터가 필요한가요, 아니면 로그 레벨 데이터가 필요한가요?
- 데이터를 애널리틱스 제공업체로 보낼 건가요, 내부 데이터 웨어하우스로 보낼 건가요?
- 데이터를 대행사 등 제3자에게 보낼 안전한 방식이 필요한가요?
- 일정한 주기에 따라 반복적으로 데이터 내보내기가 필요한가요?
- 데이터가 얼마나 자주 필요합니까?
- 얼마나 오래된 데이터까지 내보내려고 하고 있나요?
- 총 몇 행의 데이터를 내보내시겠습니까?
아래 순서도를 따라가시면, 조직의 요구 사항에 가장 적합한 Branch Data Export 솔루션을 찾으실 수 있습니다.
가장 먼저 결정해야 할 것은 로그 수준 데이터가 필요한지, 집계값(aggregate) 데이터가 필요한지 여부입니다.
- 로그 수준 데이터에는 각 이벤트에 대한 모든 메타데이터와 유저 레벨 데이터가 포함됩니다. 따라서 이 데이터는 이벤트 raw data가 그대로 담긴 스프레드시트 문서라고 생각하셔도 됩니다.
- 집계값(aggregate) 데이터는 이벤트와 각 이벤트가 발생한 횟수를 요약해서 보여줍니다. 이 데이터는 가용한 몇 가지 분석기준(dimension)에 따라 조금 더 세분화해서 볼 수 있습니다. 따라서 이 데이터는 raw data를 한 번 가공해서 피벗 테이블로 간추려놓은 엑셀 시트에 비유할 수 있습니다.
집계값(aggregate) 데이터
위에 있는 다이어그램에서오른쪽으로 내려가봅시다. 집계값 데이터가 필요한 경우입니다.
대행사를 비롯한 제3자에게 데이터를 보내줘야 하는지, 각 사용자의 권한에 맞는 데이터만 볼 수 있도록 통제해야 하는지 고려하세요. 만약 그렇다면 Aggregate API가 적합합니다. 실시간으로 데이터를 내보내야 하거나 Branch 대시보드에 표시된 데이터와 완전히 같은 값으로 가져와야 할 경우 Query API를 사용하는 것이 좋습니다.
로그 수준 데이터
로그 수준 데이터를 내보내려는 경우, 추가로 고려해야 할 몇 가지가 있습니다. 현재 전문 분석 제공 업체나 사내 데이터 웨어하우스가 있는지 자문해보십시오.
Branch와 제휴한 분석 공급 업체가 있는 경우 Branch 대시보드에서 데이터 연동(Data Integration)을 설정할 수 있습니다. 몇 가지 인증 정보를 입력하고 앱에 몇 줄의 코드를 추가하기만 하면 됩니다. 데이터 연동에 필요한 사항은 연동하려는 업체에 따라 차이가 있을 수 있습니다.
Branch가 분석 제공 업체와 연동되어 있지 않거나 데이터를 자체 내부 시스템으로 보내려는 경우라면, 이번에는 “데이터를 얼마만큼의 빈도로 내보낼 것인지” 결정할 때입니다.
- 데이터가 실시간으로 필요할 경우(예: 이벤트를 서버 측에서 발동시키려는 경우) Webhook이 적합합니다.
- 데이터를 일회성으로 내보내려면 Custom Export API 를 활용하십시오.
- 주기적으로 내보내기가 필요한 경우 Branch의 Scheduled Log Exports API가 해답입니다.
Branch의 Data Export 기능에 대해 더 자세히 알고 싶으십니까?
Branch University 의 무료 e-Learning 과정을 확인해보세요. 해당 과정에서는 Branch의 Data Export 기능을 자세히 알려드리기 위해 아래 코스를 다룹니다.
Data Export 설정과 관련하여 문제사항이나 질문이 있는 경우, 담당 고객 성공 매니저에게 문의하거나 지원 팀에 문의하시기 바랍니다.