내 첫 번째 앱에 설명된 대로 클라이언트 앱을 설정한 후에는 Search Ads 360 API를 사용하여 보고서를 요청하고 다운로드할 수 있습니다. 다음 유형의 요청 중 하나를 실행할 수 있습니다.
- 동기
단일 요청만 필요하며 JSON 형식의 응답으로 보고서를 반환합니다. 동기식 요청:
대규모 광고주 또는 엔진 계정 보고서를 요청하는 경우 비동기식 방식을 사용하는 것이 좋습니다.
- 비동기
보고서에 포함하려는 데이터를 지정하는 초기 요청을 전송해야 합니다. 그런 다음 Search Ads 360 폴링을 위한 추가 요청을 보냅니다. Search Ads 360에서 보고서 생성이 완료되면 보고서를 하나 이상의 파일로 다운로드하라는 요청을 보냅니다. 비동기식 요청:
- 모든 보고서 유형을 반환할 수 있습니다.
- 매우 큰 보고서를 여러 파일로 샤딩합니다.
- CSV 또는 TSV로 보고서 형식 지정
데이터 모델: 행과 열
Search Ads 360은 보고서의 데이터를 행과 열로 구성합니다. 요청하는 보고서의 유형에 따라 반환되는 행이 결정됩니다. 예를 들어 키워드 보고서를 요청하는 경우 각 행에는 단일 키워드에 대한 데이터가 포함됩니다. 모든 보고서 유형의 목록은 보고서 유형 참조를 참고하세요. 보고서 요청에서 각 열의 이름을 지정하여 보고서에 포함할 열을 지정합니다. 각 보고서 유형에서 반환할 수 있는 열의 목록은 보고서 유형 참조를 참고하세요.
열 동작
열의 동작은 열에 포함된 데이터 유형에 따라 다릅니다 (보고서 유형 참조에 각 열의 동작이 표시됩니다).
속성 열. 속성 열에는 캠페인 이름 또는 키워드 입찰가와 같이 캠페인의 항목을 구성하거나 식별하는 데이터가 포함됩니다. Search Ads 360 API는 요청에 지정된 날짜 또는 기간에 관계없이 항상 속성 열의 현재 값을 반환합니다. 예를 들어 어제 키워드 입찰가를 2.00에서 1.50으로 변경한 후 지난 달의 데이터에 대한 보고서를 요청하면 보고서에서 키워드 입찰가에 1.50 값을 반환합니다.
측정항목 열. 측정항목 열에는 광고 클릭수, 플러드라이트 태그에 기록된 방문수, 수익과 같은 캠페인 실적 데이터가 포함됩니다. 하루 기간을 지정하지 않는 한 API는 측정항목 열의 집계 값을 반환합니다. 예를 들어 지난달 데이터에 대한 보고서를 요청하면 API에서 지난달의 총 클릭수를 반환합니다.
분류 기준 열. 분류 기준 열은 데이터를 별도의 행으로 분할합니다. 예를 들어
date는 여러 유형의 보고서에 지정할 수 있는 분류 기준 열입니다. 기간이 2013-01-01에서 2013-01-07인 키워드 보고서에서date열을 지정하면 API는 각 키워드에 대해 각각 하루에 해당하는 7개의 행을 반환하고 해당 날짜의 측정항목을 표시합니다. 분류된 보고서를 참조하세요.
통화
보고서 요청에 금전적 데이터의 통화를 지정해야 합니다 (dailyBudget과 같은 속성과 cost과 같은 측정항목 모두). 다음 중 하나를 지정할 수 있습니다.
- 대행사, 광고주 또는 엔진 계정으로 보고서 범위가 지정된 경우 대행사의 통화
- 보고서의 범위가 광고주 또는 엔진 계정으로 지정된 경우 광고주의 통화입니다.
- 보고서의 범위가 엔진 계정으로 지정된 경우 엔진 계정의 통화입니다.
- USD
Reports.request.statisticsCurrency 요청 속성을 사용하여 통화를 지정합니다.
보고서 자체는 Reports.statisticsCurrencyCode 속성에 통화를 표시합니다.
시간대
Search Ads 360 측정항목은 시간대가 없는 날짜에 저장됩니다. 이 날짜는 엔진 측정항목 (예: 클릭수, 노출수, 방문수)의
엔진 계정 시간대 및 전환 측정항목 (예: 액션,
거래, 수익)의 Campaign Manager 네트워크 시간대와
일치합니다. 보고서의 모든 측정항목이 동일한 시간대에서 비롯되는 경우 요청에 해당 시간대가 반환됩니다. 그렇지 않으면 시간대가 반환되지 않습니다.
요청은 두 개 이상의 시간대에서 측정항목을 표시하는 보고서를 실패하도록 Reports.request.verifySingleTimeZone: true를 설정할 수 있습니다.
보고서에 있는 모든 측정항목이 한 시간대에서 비롯된 경우 해당 시간대는 Reports.statisticsTimeZoneReports로 반환됩니다.