이제 새 Search Ads 360 Reporting API를 사용할 수 있습니다. 새로운 API를 사용하면 더욱 유연하게 맞춤 보고서를 작성하고, 데이터를 보고 애플리케이션 및 프로세스에 통합할 수 있습니다. 새 Search Ads 360 Reporting API로 이전하고 이를 사용하는 방법에 대해 자세히 알아보세요.
보고서를 요청할 때마다 모든 데이터의 덤프를 수신하는 대신 마지막 보고서 이후 변경된 데이터만 주기적으로 요청할 수 있습니다. 이러한 증분 보고서는 전체 보고서보다 훨씬 작을 수 있습니다.
증분 보고서를 요청하는 경우 다음 사항에 유의하세요.
점진적인 변경사항이 손실될 경우를 대비해 가끔씩 전체 보고서를 요청하는 것이 좋습니다. 예를 들어 1월에 주간 증분 보고서를 요청하는 경우 1월 데이터를 모두 얻으려면 2월 말에 1월 전체 보고서를 요청해야 합니다.
일부 항목이 변경되었는지 항상 확인할 수 있는 것은 아니므로 증분 보고서에 항목이 변경되었다고 확신하는 경우 Search Ads 360에 항목이 포함됩니다. 즉, 증분 보고서에 변경되지 않은 데이터가 포함될 수 있습니다.
지정된 타임스탬프 이후 변경된 측정항목을 요청합니다. 측정항목은 일별 단위로 저장되고 하루 동안 변경될 수 있고 다른 날에는 변경되지 않을 수 있으므로 이러한 요청은 날짜별로 분류해야 합니다 (date 열이 있어야 함). 예를 들어 clicks, actions, date 열이 포함된 keyword 보고서는 특정 타임스탬프 이후 기록된 클릭수 또는 액션 수가 변경된 각 키워드와 날짜에 대한 행을 반환합니다.
타임스탬프는 요청 시간 8일 전이어야 합니다. 변경되는 모든 측정항목을 캡처하려면 최소 7일마다 한 번씩 changedMetricsSinceTimestamp 요청을 수행하고, 측정항목이 정해지면 각 날짜에 대한 전체 보고서를 생성해야 합니다. 7일 이상 기다리는 것이 더 안전합니다. 패턴 예시로는 매일 2개의 보고서를 작성하는 것입니다. 하나는 지난 36시간 동안 변경된 측정항목에 대한 증분 보고서와 8일 전에 발생한 측정항목에 대한 전체 보고서를 만드는 것입니다.
changedAttributesSinceTimestamp=timestamp
지정된 타임스탬프 이후 변경된 속성을 요청합니다. changedAttributesSinceTimestamp 요청은 속성 열 (측정항목 열 또는 세그먼트 열 없음)만 포함할 수 있으며 conversion 보고서와 같은 원시 이벤트 보고서에서는 작동하지 않습니다. 예를 들어 dailyBudget 및 campaignStartDate 열이 포함된 campaign 보고서는 지정된 타임스탬프 이후 일일 예산 또는 시작일이 변경된 각 캠페인의 행을 반환합니다.
상위 속성의 변경사항은 changedAttributesSinceTimestamp 보고서에
캡처되지 않습니다. 예를 들어 키워드는 상위 광고그룹에서 입찰 전략을 상속할 수 있습니다.
광고그룹에 새 입찰 전략이 할당되어도 이 키워드가 보고서에
표시되지 않을 수 있습니다. 값이 상위 항목에 종속되므로 changedAttributesSinceTimestamp 보고서에 선택되지 않고 변경될 수 있는 속성 열에는 일반적으로 effectiveLabelIds 또는 effectiveBidStartegy와 같이 'effective'라는 프리픽스가 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2023-12-14(UTC)"],[[["The new Search Ads 360 Reporting API offers increased flexibility for creating custom reports and integrating data into your workflows."],["Incremental reports allow you to retrieve only the data that has changed since your last request, making reports smaller and more efficient."],["It is recommended to periodically request full reports in addition to incremental reports to ensure all data is captured."],["Incremental reports can be requested based on either changed metrics or changed attributes using specific time range properties."],["While `changedAttributesSinceTimestamp` requests provide efficient updates for attributes, changes to parent attributes might not be reflected, necessitating awareness of potential data discrepancies."]]],[]]
