User Guide - Alli Budget Consolidation

If you have issues or questions please reach tag the @support-alli-solutions group and reach out in #alli-marketplace

The marketplace app is set to run and check for any updates +/- 15 minutes from run time. Here is the guide to ensure you’re setting up the data correctly.

How to use the Google Sheet

There are info markers in the sheet to help, but here is an explanation of the fields.

The headers are locked to prevent changing header names or deleting by accident. Some of the columns auto-populate from the IDs imported. Just wait a second after editing for the dropdowns to update.

The auto-population feature pulls data from ADL and does not automatically reflect the most recent in-platform data. Users can still manually add the Corresponding Name and Corresponding Id for the tool to run.

Fields to Update:

Column	Info	Needed to Run?
Approved	Check this when the line item is set up and ready to be processed. Must be checked to run
Date / Time / Timezone	The time that the line should be processed by Alli Budget Consolidation. Timezone is your choice.
Platform	What platform the update is for
Account ID	The Account ID the campaign/adset/ad is in
Level to Change	The level the update is for. Either Campaign or Adset. See: Platform Restrictions
Corresponding Name	Select the name of the Campaign/Adset/Ad
Corresponding ID	This will update with the matching ID of the Name given
Notes	Anything your team finds useful. This doesn’t affect the tool from running
Budget	This may be Lifetime or Daily budget and cannot switch back and forth. Certain platforms may only let you update at campaign or adset level. See: Platform Restrictions
Status	Options: ACTIVE or PAUSED are the only valid options for now. See: Platform Restrictions
Processed	This will be marked by the application if it has processed the item	should not be checked
Errored	This is marked by the application if the line item failed	should not be checke

Nice to Know: Platform Restrictions

This chart will tell you if the platform supports certain levels of updates

Platform	API Limits	Budget Updates	Budget Notes	Status Updates	Status Notes
Meta	For each ad account in a one-hour time period: 100000 if your app is in the Marketing API Standard tier or *300 if your app is in the Dev tier + 40 Num of Active ads.** We are currently Dev tier	Campaign Adset Ad ❌ ( Future Release )	Advantage+ campaigns must always be set at the adset level.	Campaign Adset Ad
TikTok	Basic rate limit levels have 10 queries-per-second, 864,000 queries per day. This can be upgraded to "Ultimate" for 50 QPS. There are tiers between basic and ultimate. We have something to handle this though and it will wait and try again if this limit is hit. SMART campaigns cannot be updated via the API as TikTok does not support this.	Campaign Adset Ad ❌ ( API Limitations )	CBO will only update at the campaign level	Campaign Adset Ad	Update will succeed even if the status was already set
Snapchat	Rate limits are implemented both at App and Token level, the App is able to support an overall average volume of 20 requests/second, individual Access tokens issued by the App can make requests at an average of 10 requests/second.	Campaign Adset Ad	At campaign level if both budget mode are set lifetime and daily then it will prioritize lifetime over daily and will only update lifetime budget. No CBO The campaign budget must equal the total of all ad set budgets under that campaign Can not edit the budget of a given campaign to be 4x more than the campaign spend cap (i.e. $50 spend cap, max change is $200)	Campaign Adset Ad	Update will succeed even if the status was already set
Pinterest	The rate limits are per app and this in on a trial period so it is 100 per day	Campaign Adset Ad	CBO campaigns must always be updated at the campaign level	Campaign Adset Ad	Updates may fail if the provided status is already set

Use Cases

Making an Ad Ad Set go dark for a day

The recommended setup is to create an entry for the Ad Set to be set to PAUSED at midnight for the day for which you don’t want the Ad Set to spend. It is not recommended to set the budget to 0$ because platforms have minimum budget limitations so this wouldn’t be an effective way to limit the Ad Set from using spend.