Scheduling tool
Use Adjust's Scheduling tool in SpendWorks to monitor the accuracy and consistency of your ad spend data. This ensures that you can quickly resolve any disruptions in the collection of your ad spend data.
Before you begin
Here's what you need to know before getting started.
Requirements
- You need to be on the SpendWorks Core, Enterprise or Custom package to access the Scheduling tool.
- Users with Admin permissions.
- You are retrieving ad spend data through the API integration solution.
Overview
The Scheduling tool is available under DataWorks > Scheduling. The tool gives you an overview of the following:
Partners - A list of partners for whom we are collecting ad spend data via an API integration. This list is based on the partners that you've added in DataWorks.
Accounts - The number of accounts for a specific partner for which data collection has been scheduled. If no data retrieval job has been created during the day for a given account, it is not counted.
- Select
(Drill-down) to view granular information of ad spend data collection of each account.
- Select
Ad account collection status - The collection status (In Progress, Successful, or Failed) of all the accounts for which data collection has been scheduled or processed. The statistics are counted for the latest data collection execution of all ad accounts. If the data collection has not started yet, this will be empty.
Reporting day - The day for which data is being collected (Today or Yesterday) and the time during the current day at which data collection is scheduled. All ad spend data until the selected time is scheduled to be a part of the job that contains the data to process. The job might run at a later time.
- For Yesterday, data is collected once daily at the set time. If the cell shows
Yesterday 05:00 UTC
, it means that data for yesterday’s calendar day is scheduled to be collected today at 05:00 UTC . - For Today, data is collected every 4 hours. The time indicated defines the first occurrence of the day, at which the data is collected. If the cell shows
Today 02:00 UTC
, it means that data for today’s calendar day is scheduled to be collected for the first time today, at 02:00. The next occurrences of data collection will be every 4 hours and in that case, at 02:00 UTC, 06:00 UTC, 10:00 UTC, 14:00 UTC, 18:00 UTC, and then 22:00 UTC.
- For Yesterday, data is collected once daily at the set time. If the cell shows
Last collection completed - The date and time in UTC at which data was collected the last time for a given day.
(None) - This is displayed when the data collection has not started yet. In this case, the Ad account collection status is also empty.
(None with question mark icon) - This is displayed when data processing of all ad accounts was successful, but no data was found.
Next planned collection - The date and time based on the schedule’s defined time zone (UTC by default and if the schedule was never edited) at which data will be collected the next time for a given Reporting day.
Enable same day ad spend data collection
You need to be on the SpendWorks Core, Enterprise or Custom package to use the Same day ad spend solution on your account.
The following table describes how same day ad spend data collection works in the Scheduling tool.
Same day ad spend status | Description |
---|---|
Enabled | This enables schedules and same day ad spend data collection for partners that support same day ad spend. For data collection that will occur on the next calendar day, schedules have a Reporting day of Today for partners that support same day ad spend. |
Disabled | This disables schedules and same day ad spend data collection for partners that support same day ad spend. At the end of the calendar day, that is, at 00:00 UTC, schedules for partners that support same day ad spend for Reporting day set to Today are removed. Only schedules for Yesterday are enabled and processed. |
Edit ad spend data collection schedule
You can edit the ad spend data collection schedule in the Scheduling tool.
You cannot update a schedule where there is still at least one account that is In Progress in the Ad account collection status column.
- Under the Actions column, select
(Edit) to edit a schedule for a given reporting day.
- Select the time and time zone in which you want to schedule ad spend data collection.
Ad spend data availability is dependent on its readiness on the network's side. All ad spend data until the selected time is scheduled to be a part of the data collection job. The job might run at a later time.
Edit schedule for Today
You can only update the schedule once per each calendar day (within 24 hours in UTC). You can only define the first occurrence of a given day when data should be collected. Data is collected every 4 hours, after the first scheduled occurrence.
Example: If you update the schedule to be triggered at 02:00 UTC, then the next occurrences of data collection will be every 4 hours and in that case, at 06:00 UTC, 10:00 UTC, 14:00 UTC, 18:00 UTC, 22:00 UTC and then 02:00 UTC on the next day.
Edit schedule for Yesterday
You cannot update the schedule if the time that you specify is before the current time of the day.
Example: If it is 10:00 UTC now and the next data collection occurrence is at 13:00 UTC for Facebook, you cannot update the schedule to 05:00 UTC, as this time is prior to 10:00 UTC and the schedule at 13:00 UTC hasn’t triggered yet.
Some networks report their data in UTC, so you can only configure their ad spend data collection schedule after a particular time.
Reporting time zone | Networks |
---|---|
Advertising network reports data based on your default account time zone | Google, Apple, Facebook, Liftoff, Mintegral, Snapchat, TikTok, X (formerly Twitter) |
UTC+7 | AppLovin |
UTC+8 | Tencent |
UTC-5 | AdGate Media |
UTC | All other networks |
Resolve errors
You can view partner or account error notifications and resolve those errors under the Actions column in the Scheduling tool.
(Notification flag) - No errors with the partner or account.
(Notification flag with red dot) - Hover over the flag to view the number of accounts with errors. Select the flag to go to the specific account in Connections to view and resolve the error.