Запуск отчетов синхронно

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

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

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

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

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

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

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

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

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

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

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

  • Отчет «Путь к конверсии» , который никогда не поддерживает синхронную отчетность.
  • Отчет Floodlight , который поддерживает синхронную отчетность только в том случае, если dfa:floodlightImpressions исключены.

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

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

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

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

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

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

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

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

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