보고서를 요청할 때마다 모든 데이터의 덤프를 수신하는 대신 마지막 보고서 이후 변경된 데이터만 주기적으로 요청할 수 있습니다. 이러한 증분 보고서는 전체 보고서보다 훨씬 작을 수 있습니다.
증분 보고서를 요청하는 경우 다음 사항에 유의하세요.
- 점진적인 변경사항이 손실될 경우를 대비해 가끔씩 전체 보고서를 요청하는 것이 좋습니다. 예를 들어 1월에 주간 증분 보고서를 요청하는 경우 1월 데이터를 모두 얻으려면 2월 말에 1월 전체 보고서를 요청해야 합니다.
- 일부 항목이 변경되었는지 항상 확인할 수 있는 것은 아니므로 증분 보고서에 항목이 변경되었다고 확신하는 경우 Search Ads 360에 항목이 포함됩니다. 즉, 증분 보고서에 변경되지 않은 데이터가 포함될 수 있습니다.
증분 보고서를 요청하려면 다음 Reports.request.timeRange
속성 중 하나를 지정합니다.
changedMetricsSinceTimestamp=timestamp지정된 타임스탬프 이후 변경된 측정항목을 요청합니다. 측정항목은 일별 단위로 저장되고 하루 동안 변경될 수 있고 다른 날에는 변경되지 않을 수 있으므로 이러한 요청은 날짜별로 분류해야 합니다 (
date열이 있어야 함). 예를 들어clicks,actions,date열이 포함된keyword보고서는 특정 타임스탬프 이후 기록된 클릭수 또는 액션 수가 변경된 각 키워드와 날짜에 대한 행을 반환합니다.타임스탬프는 요청 시간 8일 전이어야 합니다. 변경되는 모든 측정항목을 캡처하려면 최소 7일마다 한 번씩
changedMetricsSinceTimestamp요청을 수행하고, 측정항목이 정해지면 각 날짜에 대한 전체 보고서를 생성해야 합니다. 7일 이상 기다리는 것이 더 안전합니다. 패턴 예시로는 매일 2개의 보고서를 작성하는 것입니다. 하나는 지난 36시간 동안 변경된 측정항목에 대한 증분 보고서와 8일 전에 발생한 측정항목에 대한 전체 보고서를 만드는 것입니다.changedAttributesSinceTimestamp=timestamp지정된 타임스탬프 이후 변경된 속성을 요청합니다.
changedAttributesSinceTimestamp요청은 속성 열 (측정항목 열 또는 세그먼트 열 없음)만 포함할 수 있으며conversion보고서와 같은 원시 이벤트 보고서에서는 작동하지 않습니다. 예를 들어dailyBudget및campaignStartDate열이 포함된campaign보고서는 지정된 타임스탬프 이후 일일 예산 또는 시작일이 변경된 각 캠페인의 행을 반환합니다.상위 속성의 변경사항은changedAttributesSinceTimestamp보고서에 캡처되지 않습니다. 예를 들어 키워드는 상위 광고그룹에서 입찰 전략을 상속할 수 있습니다. 광고그룹에 새 입찰 전략이 할당되어도 이 키워드가 보고서에 표시되지 않을 수 있습니다. 값이 상위 항목에 종속되므로changedAttributesSinceTimestamp보고서에 선택되지 않고 변경될 수 있는 속성 열에는 일반적으로effectiveLabelIds또는effectiveBidStartegy와 같이 'effective'라는 프리픽스가 있습니다.