보고 권장사항
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 보고서를 가져올 때의 몇 가지 권장사항을 보여줍니다.
보고서 저장 및 재사용
동일한 보고서를 여러 번 삽입하고 삭제하면 리소스가 낭비되므로 정기적으로 실행하는 쿼리에 대한 보고서를 만들어 저장하는 것이 좋습니다.
상대 기간(예: YESTERDAY 또는
LAST_7_DAYS를 사용하면 보고서의 재사용 가능성이 높아집니다.
보고서 예약
임시 또는 일회성 보고서는 실행되므로 많은 리소스가 낭비될 수 있습니다.
불완전한 데이터 세트에 대해 실행될 수 있습니다 예약된 보고서는 일괄 실행되며 전날 데이터의 처리가 완료될 때까지 실행되지 않으므로 보고 리소스를 최대한 활용합니다. 자세한 내용은 사용 가능한 예약 필드를 참조하세요.
보고서 상태를 폴링할 때 지수 백오프 사용
보고서를 실행하는 데 걸리는 시간을 예측할 수는 없습니다. 길이
시간은 날짜, 시간 등 다양한 요인에 따라 몇 초에서 몇 시간까지 달라질 수 있습니다.
처리할 데이터의 양을 예로 들 수 있습니다 또한 보고서 런타임과 보고서에 반환된 행 수 간에 상관관계가 없습니다. 따라서 실행 중인 보고서의 상태를 정기적으로 확인하여 보고서가 완료된 시점을 확인해야 합니다. 이를 '폴링'이라고 합니다.
폴링은 필요하지만 비효율적인 구현은 장기 실행 보고서가 발생할 때 할당량을 빠르게 소진할 수 있습니다. 따라서 지수 백오프를 사용하여 재시도를 제한하고 할당량을 보존하는 것이 좋습니다.
멀티파트 다운로드 실행
보고서 파일은 최대 몇 GB일 수도 있습니다. 이러한 보고서를 단일 요청으로 다운로드하면 연결 문제가 발생할 수 있습니다. 또한 단일 요청이
다운로드가 중단되었으며 다시 시작할 수 없으며 단일 요청이 실패함
다운로드가 중단되면 다운로드를 재개할 수 없습니다. 따라서 다중 파일 다운로드를 사용하여 대용량 다운로드를 더 작은 청크로 분할하는 것이 좋습니다. 만약
단일 청크가 실패하면 그 지점부터 다운로드가 재개될 수 있습니다.
청크 처리에는 많은 이점이 있지만 각 청크는 별도의 요청을 생성합니다.
따라서 10MB의 최소 단위 크기를 사용하여
지정할 수 있습니다 하지만 평균 보고서 크기가 매우 큰 경우 연결 속도가 허용하는 범위 내에서 청크 크기를 늘리는 것이 좋습니다.
보고 할당량 고려
다음 세 가지 제품 전반의 사용량 할당량을 통해 Campaign Manager 360 보고 기능을 책임감 있게 사용해야 합니다.
임시 보고서 실행(일일)
CM 계정 / CM 사용자 프로필에서 실행할 수 있는 임시 보고서 수를 제한합니다.
24시간 동안 볼 수 있습니다 할당량을 초과하지 않도록 하려면 다음 안내를 따르세요.
- 중복 보고서를 줄입니다.
- 정기적으로 실행되는 보고서를 예약합니다.
- 불필요한 API 스크립트를 비활성화합니다.
활성 정기 보고서
CM 계정/CM 사용자 프로필에서 특정 시점에 활성 상태로 예약할 수 있는 보고서 수를 제한합니다. 할당량을 초과하지 않도록 하려면 다음 안내를 따르세요.
- 중복 신고를 줄입니다.
- 불필요한 예약된 보고서를 비활성화합니다.
- 불필요한 API 스크립트를 비활성화합니다.
동시 보고서
CM 계정 / CM 사용자 프로필에서 실행할 수 있는 보고서 수가 제한됩니다.
동시에 사용할 수 있습니다. 할당량을 초과하지 않도록 하려면 다음 안내를 따르세요.
- 정기적으로 실행되는 보고서를 예약합니다.
- 불필요한 API 스크립트를 비활성화합니다.
- 백오프 로직을 구현합니다.
보고 구현을 최적화했는데도
할당량을 초과하는 경우 다음을 사용하여 Campaign Manager 360 지원팀에 문의하세요.
문의 양식을 작성하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eSave and re-use reports, especially those with relative date ranges, to conserve resources.\u003c/p\u003e\n"],["\u003cp\u003eSchedule reports instead of running them ad-hoc to ensure data completeness and efficient resource usage.\u003c/p\u003e\n"],["\u003cp\u003eUtilize exponential backoff when polling for report status to avoid exhausting your quota.\u003c/p\u003e\n"],["\u003cp\u003eEmploy multipart downloads for large reports to prevent connection issues and enable resumability.\u003c/p\u003e\n"],["\u003cp\u003eBe mindful of reporting quotas (ad-hoc executions, active scheduled reports, simultaneous reports) and optimize usage accordingly.\u003c/p\u003e\n"]]],[],null,["# Reporting Best Practices\n\nThis page lists some recommended practices when pulling reports.\n\nSave and re-use reports\n-----------------------\n\nIt's recommended that you create and save reports for queries you run regularly\nbecause inserting and deleting the same report multiple times wastes resources.\nUsing [relative date ranges](/doubleclick-advertisers/current/reports#criteria.dateRange.relativeDateRange) such as `YESTERDAY` or\n`LAST_7_DAYS` makes reports more reusable.\n\nSchedule reports\n----------------\n\nAd-hoc, or one off, reports can be wasteful of resources because they are run\nindividually and may execute against an incomplete dataset. Scheduled reports\nmake the best use of reporting resources because they are run in bulk and are\nguaranteed not to execute until the previous day's data has completed\nprocessing. See the [available scheduling fields](/doubleclick-advertisers/current/reports#schedule) for details.\n\nUse exponential backoff when polling for report status\n------------------------------------------------------\n\nIt's not possible to predict how long a report will take to run. The length of\ntime can range from seconds to hours depending on many factors including date\nrange and the amount of data to be processed, for instance. There's also no\ncorrelation between report runtime and the number of rows returned in the\nreport. You therefore need to regularly check the status of a running report to\ndetermine when it has finished. This is a process known as \"polling\".\n\nWhile polling is necessary, an inefficient implementation may quickly exhaust\nyour quota when encountering a long running report. It's therefore recommended\nthat you use exponential backoff to limit retries and conserve quota.\n| **Key Point:** See [exponential backoff](/doubleclick-advertisers/upload#exp-backoff) for more information.\n\nPerform multipart downloads\n---------------------------\n\nReport files may be as large as multiple gigabytes. Downloading such reports in\na single request can lead to connection issues. Also if a single request\ndownload is interrupted, there's no way to resume it and a failed single request\ndownload cannot be resumed if interrupted. It's therefore recommended that you\nuse multipart downloads to break large downloads into smaller chunks. If a\nsingle chunk fails, the download may be resumed from that point.\n\nAlthough chunking has many benefits, each chunk generates a separate request.\nTherefore, we recommend using a minimum chunk size of 10 MB to avoid wasting\nquota. However, if your average report size is very large, consider increasing\nchunk size as much as connection speed allows.\n\nConsider reporting quotas\n-------------------------\n\nResponsible use of the Campaign Manager 360 reporting feature is enforced\nthrough the three following product-wide usage quotas:\n\n1. **Ad hoc report executions (per day)**\n\n Limits the number of ad-hoc reports a CM account / a CM user profile can run\n in a 24-hour period. To stay under quota:\n - Reduce duplicate reports.\n - Schedule reports that are run regularly.\n - Deactivate unnecessary API scripts.\n2. **Active scheduled reports**\n\n Limits the number of reports a CM account / a CM user profile can have\n actively scheduled at a given time. To stay under quota:\n - Reduce duplicate reports.\n - Deactivate unnecessary scheduled reports.\n - Deactivate unnecessary API scripts.\n3. **Simultaneous reports**\n\n Limits the number of reports a CM account / a CM user profile can run\n simultaneously. To stay under quota:\n - Schedule reports that are run regularly.\n - Deactivate unnecessary API scripts.\n - Implement [backoff logic](/doubleclick-advertisers/upload#exp-backoff).\n\nIf you've optimized your reporting implementation and you still find yourself\nexceeding your given quota, contact Campaign Manager 360 support using the\n[contact form](//support.google.com/campaignmanager/gethelp)."]]
