Campaign Manager 360 API는 Campaign Manager 360을 통해 트래피킹된 광고의 데이터를 검색하는 여러 가지 방법을 제공합니다.
보고 서비스
Reports 서비스를 사용하여 보고서를 생성하려면 보고서 파일
(예: CSV 또는 Excel 형식)을 구성, 생성, 검색하는 다단계 워크플로가 필요합니다. 이는 Campaign Manager 360 API의 표준 보고 경로이며 대규모 데이터 세트, 자동화된 예약 스크립트 또는 파일을 사용하는 다운스트림 애플리케이션에 적합합니다.
워크플로는 일반적으로 다음 단계로 구성됩니다.
- 고유한 보고서 ID로 저장되는
Report리소스 (측정기준, 측정항목, 기간, 필터 지정)를 정의하거나 찾습니다. 보고서 만들기 및 업데이트를 참고하세요. reports.run메서드를 호출하여 보고서 생성을 실행합니다. 이렇게 하면 보고서 실행이 대기열에 추가되고 자리표시자File리소스가 반환됩니다. 보고서 찾기 및 실행을 참고하세요.File리소스의 상태를 주기적으로 확인합니다. 이 프로세스는 비동기식으로 실행되므로 파일의 상태는PROCESSING으로 시작되고 완료되면REPORT_AVAILABLE로 전환됩니다. 보고서 찾기 및 실행을 참고하세요.- 보고서 생성이 완료되면 파일 콘텐츠 (CSV 또는 Excel)를 가져옵니다. 보고서 다운로드를 참고하세요.
보고서 동기식으로 실행
소량의 데이터에 대한 보고서 파일 (CSV 또는 Excel)을 생성해야 하는 경우,
보고서를 동기식으로 실행할 수 있습니다.
reports.run 메서드를 호출하고 synchronous 매개변수를
true로 설정합니다. API는 짧은 제한 시간 내에 보고서를 생성하려고 시도합니다. 실행 시간이 길어지면 보고서 실행이 자동으로 비동기 대기열로 대체됩니다.
자세한 내용은 동기식 보고서를 참고하세요.
보고서 데이터 쿼리
보고서 파일을 생성하는 대신 reportData.query 메서드를 사용하여
보고 데이터를 직접 쿼리합니다.
Report리소스를 만들고 저장하는 대신 요청에 측정기준, 측정항목, 기타 필터링 또는 정렬 기준을 직접 지정합니다.- 응답에는 구조화된 보고서 데이터가 포함되어 생성된 파일을 폴링하고 다운로드할 필요가 없습니다.
- 요청은 60초 제한 시간으로 동기식으로 실행됩니다.
자세한 내용은 JSON 보고서 데이터 쿼리를 참고하세요.