Синхронные отчеты

Что такое синхронный отчет?

Синхронный отчет — это небольшой отчет, который должен выполняться очень быстро. Получив запрос на создание синхронного отчета, платформа отчетов DCM немедленно начнет его выполнять. Подобные отчеты лучше всего использовать в ситуациях, когда вам нужно быстро получить небольшой фрагмент данных, например, когда вы отображаете метрики в графическом пользовательском интерфейсе.

В чем разница между синхронной и асинхронной генерацией отчетов?

Асинхронный запуск отчета всегда будет занимать не менее нескольких минут, даже если вы запрашиваете небольшой объем данных. Синхронные отчеты возвращают эти данные гораздо быстрее за счет уменьшения тайм-аута, определяющего, сколько времени может потребоваться для запуска отчета. Генерацию асинхронного отчета следует использовать, если отчет не может быть запущен в течение синхронного тайм-аута или когда вы не находитесь в среде, чувствительной ко времени, например в пользовательском интерфейсе.

Каков период ожидания синхронного отчета?

Если отчет достаточно мал для запуска за 10 секунд или меньше, система вернет полный файл отчета на ваш первоначальный запрос на запуск. В противном случае система отчетов DCM будет выполнять ваш отчет в течение 50 секунд до истечения времени ожидания.

Что произойдет, если синхронный отчет займет слишком много времени?

Если генерация синхронного отчета не завершается в течение периода ожидания, генерация останавливается, и отчет переходит в нашу очередь асинхронных отчетов. Ваш отчет не завершится ошибкой и не вернет ошибку, но переход в очередь асинхронных отчетов означает, что теперь для создания вашего отчета потребуется как минимум несколько минут.

Вы не получите никаких указаний на то, что ваш отчет превысил период ожидания синхронного отчета, кроме времени создания отчета. Он либо завершится синхронно за 50 секунд или меньше, либо станет асинхронным и потребует несколько минут.

Какие типы отчетов поддерживают синхронное выполнение?

Все типы отчетов поддерживают синхронное выполнение, за исключением:

Все остальные типы отчетов поддерживают синхронное выполнение, но время ожидания все равно истечет, если используется слишком много данных или ресурсоемкое сочетание метрик и измерений.

Как запустить синхронный отчет?

По умолчанию все отчеты выполняются асинхронно. При запросе создания нового файла отчета можно установить для необязательного synchronous параметра значение true , чтобы запросить синхронный запуск отчета. Обратитесь к примеру кода в нашей документации.

Должен ли я запрашивать все свои отчеты с синхронным выполнением?

Нет, вы должны запрашивать синхронное выполнение только в том случае, если вы ожидаете, что отчет будет завершен в течение периода ожидания. Если ваш отчет начинается с синхронного выполнения и достигает предела времени ожидания, отчет будет перемещен в асинхронную очередь — общее время выполнения отчета будет равно времени, необходимому для асинхронного создания отчета, плюс период синхронного времени ожидания. Таким образом, если бы вы запросили отчет асинхронно, вы бы избежали дополнительной задержки синхронного периода тайм-аута.

Повлияют ли запрошенные мной показатели и параметры на время создания моих отчетов?

Да, они будут. Для компиляции одних метрик и параметров требуется больше времени, чем для других, а некоторые из них могут даже привести к тому, что ваши синхронные отчеты всегда будут прерываться по тайм-ауту. Географические измерения — это одно из таких измерений, которое редко (если вообще когда-либо) будет достаточно быстрым для включения в синхронные отчеты.

Как я могу сократить время, необходимое для создания моих отчетов, чтобы разрешить синхронную отчетность?

На скорость влияют многие факторы, такие как размер включенных кампаний и период времени, охватываемый отчетом. Небольшая ручная настройка часто является лучшим способом сократить ваши отчеты до достаточно маленьких фрагментов — начните со всего, что вы хотите быстро отобразить, а затем попробуйте сократить отчет до тех пор, пока он не завершится успешно синхронно.