동기식 보고서
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
동기식 보고서란 무엇인가요?
동기식 보고서는 매우 빠르게 실행되어야 하는 소규모 보고서입니다.
동기 보고서 실행 요청을 받으면 DCM 보고 플랫폼에서 즉시 실행을 시작합니다. 이러한 보고서는 그래픽 사용자 인터페이스에 측정항목을 표시할 때와 같이 소량의 데이터가 빠르게 필요한 경우에 가장 적합합니다.
동기식 보고서 생성과 비동기식 보고서 생성의 차이점은 무엇인가요?
소량의 데이터를 요청하는 경우에도 보고서를 비동기식으로 실행하는 데 항상 몇 분 이상 걸립니다. 동기식
이러한 데이터를 반환하는 대신
제한 시간을 설정할 수 있습니다. 이때
보고서를 실행할 수 없는 경우
동기식 시간 제한 기간 또는 시간에 민감하지 않은 경우
사용자 인터페이스와 같은
환경을 예로 들 수 있습니다
동기식 보고서 시간 초과 기간은 얼마인가요?
보고서가 10초 이내에 실행될 만큼 작으면 시스템은 초기 실행 요청에 전체 보고서 파일을 반환합니다.
그렇지 않으면 DCM 보고에서 50초 동안 보고서를 실행합니다.
초 후에 만료됩니다.
동기식 보고서가 너무 오래 걸리면 어떻게 되나요?
동기식 보고서 생성이
생성이 중단되고 보고서가
비동기 보고 대기열을 추가합니다. 보고서는 아닙니다.
비동기 보고로 이동하게 되어
보고서가 다시 제출되기까지 몇 분 정도가 걸린다는 것을
생성합니다.
신고가
보고서 생성 외의 동기식 보고 시간 제한 기간
있습니다. 50초 이내에 동기식으로 완료됩니다. 또는
비동기식이 되며 몇 분이 걸릴 수 있습니다.
동기식 실행을 지원하는 보고서 유형은 무엇인가요?
다음을 제외한 모든 보고서 유형에서 동기식 실행을 지원합니다.
-
전환 경로 보고서 - 동기식 보고서를 지원하지 않음
있습니다.
-
플러드라이트 보고서 - 동기식 보고만 지원합니다.
dfa:floodlightImpressions
를 제외한 경우
다른 보고서 유형은 모두 동기 실행을 지원하지만 데이터가 너무 많거나 리소스 집약적인 측정항목과 측정기준 조합이 사용되면 시간 초과가 발생합니다.
동기식 보고서를 실행하려면 어떻게 해야 하나요?
기본적으로 모든 보고서는 비동기식으로 실행됩니다. 새 보고서 파일 생성을 요청할 때 선택적 synchronous
매개변수를 true
로 설정하여 보고서를 동기식으로 실행하도록 요청할 수 있습니다. 자세한 내용은
예시 코드를 참조하세요.
동기 실행으로 모든 보고서를 요청해야 하나요?
아니요. 보고서가 제한 시간 내에 완료될 것으로 예상되는 경우에만 동기 실행을 요청해야 합니다. 보고서가 동기 실행으로 시작하여 제한 시간에 도달하면 보고서가 비동기 큐로 이동합니다. 보고서의 총 실행 시간은 보고서를 비동기식으로 생성하는 데 필요한 시간과 동기 제한 시간의 합계입니다. 따라서 보고서를 비동기식으로 요청했다면 동기식 시간 제한 기간의 추가 지연을 방지할 수 있었습니다.
요청한 측정항목과 측정기준이
생성하는 데 사용되는지 궁금할 수 있습니다.
예. 일부 측정항목 및 측정기준은
일부는 동기
보고서가 항상 시간 초과로 설정되었습니다. 지역 측정기준은
데이터에 포함할 수 있을 만큼 빠른 경우는 거의 없습니다.
동기식 보고서.
동기식 보고를 허용하도록 보고서를 생성하는 데 걸리는 시간을 줄이려면 어떻게 해야 하나요?
포함된 캠페인 규모나
속도에 영향을 줍니다. 보고서를 충분히 작은 청크로 줄이는 가장 좋은 방법은 수동으로 약간 조정하는 것입니다. 빠르게 표시할 수 있는 모든 항목으로 시작하고 보고서가 동기식으로 완료될 때까지 보고서를 줄여 보세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-31(UTC)
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eSynchronous reports are best for retrieving small amounts of data quickly, such as for graphical user interfaces, and have a timeout period.\u003c/p\u003e\n"],["\u003cp\u003eIf a synchronous report takes longer than the timeout period (10 seconds for small reports or 50 seconds otherwise), it automatically switches to asynchronous processing, which takes longer.\u003c/p\u003e\n"],["\u003cp\u003eAll report types support synchronous execution except for the Path to Conversion report and the Floodlight report (with \u003ccode\u003edfa:floodlightImpressions\u003c/code\u003e included).\u003c/p\u003e\n"],["\u003cp\u003eTo run a report synchronously, set the optional \u003ccode\u003esynchronous\u003c/code\u003e parameter to \u003ccode\u003etrue\u003c/code\u003e when requesting report generation.\u003c/p\u003e\n"],["\u003cp\u003eOnly use synchronous execution when you anticipate the report to finish within the timeout period; otherwise, requesting asynchronous execution initially is more efficient.\u003c/p\u003e\n"]]],[],null,["# Synchronous Reports\n\nWhat is a synchronous report?\n-----------------------------\n\nA synchronous report is a small report that must run very quickly.\nUpon receiving a request to run a synchronous report, the DCM reporting\nplatform will begin executing it for you immediately. Reports like these\nare best used in situations where you need a small chunk of data\nquickly, such as when you are displaying metrics in a graphical user\ninterface.\n\nWhat is the difference between synchronous and\nasynchronous report generation?\n------------------------------------------------------------------------------\n\nRunning a report asynchronously will always take at least a few\nminutes, even if you are requesting a small amount of data. Synchronous\nreports return this data much faster at the cost of putting a low\ntimeout on how long the report can take to run. You should use\nasynchronous report generation when the report cannot be run within the\nsynchronous timeout period or when you're not in a time-sensitive\nenvironment such as a user interface.\n\nWhat is the synchronous report timeout period?\n----------------------------------------------\n\nIf the report is small enough to run in 10 seconds or less, the\nsystem will return a complete report file to your initial run request.\nOtherwise, DCM reporting will execute your report for a period of 50\nseconds before timing out.\n\nWhat happens if a synchronous report takes too\nlong?\n----------------------------------------------------\n\nIf the generation of a synchronous report does not complete within the\ntimeout period, the generation is halted and the report fails over into\nour asynchronous reporting queue. Your report will **not**\nfail or return an error, but moving into the asynchronous reporting\nqueue means that your report will now take at least a few minutes to\ngenerate.\n\nYou will receive no indication that your report exceeded the\nsynchronous reporting timeout period other than the report's generation\ntime. It will either complete synchronously in 50 seconds or less or\nbecome asynchronous and require several minutes.\n\nWhich report types support synchronous execution?\n-------------------------------------------------\n\nAll report types support synchronous execution with the exception of:\n\n- The [Path to Conversion report](//support.google.com/dcm/answer/2823644), which never supports synchronous reporting.\n- The [Floodlight report](//support.google.com/dcm/answer/2823790), which only supports synchronous reporting if `dfa:floodlightImpressions` are excluded.\n\n\u003cbr /\u003e\n\nThe other report types all support synchronous execution but will still\ntimeout if too much data or a resource-intensive mix of metrics and\ndimensions are used.\n\nHow do I run a synchronous report?\n----------------------------------\n\nBy default, all reports run asynchronously. When requesting the\ngeneration of a new report file, you can set the optional\n`synchronous`\nparameter to\n`true`\nto request the report be run synchronously. Refer to the [example code](/doubleclick-advertisers/current/reports/run#examples) in our documentation.\n\nShould I request all my reports with synchronous\nexecution?\n-----------------------------------------------------------\n\nNo, you should only request synchronous execution when you expect\nthe report to finish within the timeout period. If your report starts\nwith synchronous execution and hits the timeout limit, the report will\nbe moved to the asynchronous queue---the report's total execution\ntime will be the time required to generate the report asynchronously plus\nthe synchronous timeout period. Thus, if you had requested the report\nasynchronously, you would have avoided the additional delay of\nthe synchronous timeout period.\n\nWill the metrics and dimensions I request affect the\ngeneration time of my reports?\n-----------------------------------------------------------------------------------\n\nYes, they will. Certain metrics and dimensions take longer to\ncompile than others and some of them may even cause your synchronous\nreports to always timeout. Geographical dimensions are one such\ndimension that will rarely, if ever, be fast enough to include in\nsynchronous reports.\n\nHow can I shorten the time needed to generate my\nreports to allow synchronous reporting?\n----------------------------------------------------------------------------------------\n\nMany factors, such as the size of the campaigns included and the\ntimespan that the report covers, affect speed. A bit of manual\ntweaking is often the best way to get your reports down to small enough\nchunks---start with everything you want to be able to display quickly,\nand then try whittling the report down until it successfully completes\nsynchronously."]]