몰로코 클라우드 DSP에서 운영된 캠페인 결과를 광고주 내부 데이터베이스나 BI (Business Intelligence) 툴로 전송하기 위해서 리포트 API를 활용할 수 있습니다. 아래 가이드에서 연동 과정을 알아보세요.
몰로코 클라우드 리포트 API란?
몰로코 클라우드 리포트 API는 고객들에게 몰로코에서 운영된 캠페인 리포트 생성을 포함한 포괄적인 API를 제공합니다. 리포트 API를 통해 제공되는 기능은 다음과 같습니다.
- Report Create / Read / List / Delete: 리포트 생성, 불러오기, 목록 확인하기, 삭제하기 기능이 제공됩니다.
- Read report status: 새로운 리포트가 생성되었는지 확인하고, 생성된 리포트 파일의 위치를 체크할 수 있습니다.
- 포맷: 리포트 API를 통한 리포트는 CSV 혹은 JSON 형태로 제공됩니다.
- 데이터 업데이트 빈도: 몰로코는 광고 계정의 시간대 기준으로 어제자의 전체 데이터를 하루에 한 번 제공하고 있습니다. 해당 전체 데이터는 하루가 지나고 난 뒤 3시간에서 5시간 이후에 준비됩니다.
몰로코 클라우드 리포트 API 연동하기
연동 전 준비사항
아래 세가지 정보가 있어야 리포트 API 연동을 시작할 수 있습니다.
- 워크플레이스 ID
- 광고 계정 ID
- 워크플레이스 유저 이메일 및 비밀번호
-
워크플레이스 ID 는 Workplace Settings > Information 에서 확인할 수 있습니다.
중요: Workplace Settings 메뉴는 Workplace Owner 권한이 있는 유저에게만 보입니다. 워크플레이스 ID는 워크플레이스 접속 시 뜨는 URL에서도 확인할수 있으나, 정확한 ID 확인이 어려운 경우 몰로코 담당자에게 문의해 주세요
-
Settings > Ad account Settings 메뉴, 혹은 각 광고 계정의 Overview 탭에서 광고 계정의 ID를 확인할수 있습니다. 영문 대소문자와 숫자의 조합입니다.
-
연동을 위해서는 워크플레이스에 등록되어있는 Workplace Owner 유저의 이메일과 패스워드가 필요합니다. 해당 정보와 권한을 통해서 API를 이용할 수 있으며, 새로운 유저를 등록하여 연동하고자 하는 경우, 유저 추가 방법은 아래 문서에서 확인하실 수 있습니다.
API 연동 진행
위의 정보들이 모두 준비되면, 내부의 연동 담당 개발자에게 위 정보와 함께 아래 개발자 센터의 문서를 전달해주세요.
API에 접근 가능한 키와 토큰 발급과정이 설명되어있습니다.
팁
내부 데이터베이스나 BI 툴이 아닌 외부 리포트 파트너에게 데이터를 전송하기 위한 방법은 아래 문서를 참고하세요
리포트 API는 합산된 캠페인 리포트를 제공합니다. 보다 상세한 레벨의 로그 데이터 이용을 위해서는 아래 문서를 참고해주세요
리포트 API를 통해 받은 데이터에 이상이 있을 경우 몰로코 담당자에게 연락하거나 티켓을 통해 문의하시기 바랍니다.