# Add New Ad Account on Admanage
Source: https://docs.admanage.ai/add-new-ad-account
Step-by-step guide for connecting a new ad account to Admanage, so that you can launch ads on it
## On the Launch page
The best way to connect new Ad Accounts on the [Launch page](https://admanage.ai/launch).
Click **Add or edit ad accounts**
Choose the Ad Account you want to connect from the list
Click the Plus icon to connect a new Ad Account
## On the Settings page
You can also connect new Ad Accounts on the [Settings page](https://admanage.ai/settings).
Click `Add New Ad Account`
Select the Ad Account you want to connect
Click `Continue`
Choose the Facebook and Instagram Profiles you want to connect
You can use multiple Facebook and Instagram Profiles in the same Ad Account. [Learn more](/change-profile-pages)
And that's it! You've connected a new Ad Account to Admanage. You can now launch ads on it.
# Introduction
Source: https://docs.admanage.ai/api-references/introduction
Fundamental concepts of AdManage's API.
## Base URL
AdManage's API is built on REST principles and is served over HTTPS. To ensure data privacy, unencrypted HTTP is not supported.
The Base URL for all API endpoints is:
```bash Terminal theme={null}
https://admanage.ai/api/
```
## Authentication
Authentication to AdManage's API is performed via the Authorization header with a Bearer token. To authenticate, you need to include the Authorization header with the word `Bearer` followed by your API key in your requests like so:
```bash Terminal theme={null}
Authorization: Bearer ak_xxxxxx
```
Here are examples of how to authenticate with AdManage's API in different programming languages:
```bash cURL theme={null}
curl --request GET \
--url https://admanage.ai/api/ad-copy-templates \
--header 'Authorization: Bearer ak_xxxxxx'
```
Learn more about [how to get your API key](/api-references/tokens).
## Error Handling
AdManage API returns machine readable error codes, human readable error messages and a link to the docs for more information.
Here is how an error response looks like:
```json theme={null}
{
"error": {
"code": "not_found",
"message": "The requested resource was not found.",
"doc_url": "https://docs.admanage.ai/api-references/errors#not-found"
}
}
```
Here is a list of all error codes AdManage API returns:
* **Status:** 400
* **Problem:** The request is malformed, either missing required fields, using wrong datatypes, or being syntactically incorrect.
* **Solution:** Check the request and make sure it is properly formatted.
* **Status:** 401
* **Problem:** The request has not been applied because it lacks valid authentication credentials for the target resource.
* **Solution:** Make sure you are using the correct API key or access token.
* **Status:** 403
* **Problem:** The server understood the request, but is refusing to fulfill it because the client lacks proper permission.
* **Solution:** Make sure you have the necessary permissions to access the resource.
* **Status:** 404
* **Problem:** The server has not found anything matching the request URI.
* **Solution:** Check the request and make sure the resource exists.
* **Status:** 409
* **Problem:** Another resource already uses the same identifier. For example, workspace slug must be unique.
* **Solution:** Change the identifier to a unique value.
* **Status:** 410
* **Problem:** The invite has expired.
* **Solution:** Generate a new invite.
* **Status:** 422
* **Problem:** The server was unable to process the request because it contains invalid data.
* **Solution:** Check the request and make sure input data is valid.
* **Status:** 429
* **Problem:** The request has been rate limited.
* **Solution:** Wait for a while and try again.
* **Status:** 500
* **Problem:** The server encountered an unexpected condition that prevented it from fulfilling the request.
* **Solution:** Try again later. If the problem persists, contact support.
## Pagination
AdManage's API supports pagination. This is useful when you have a large number of resources and you want to retrieve them in smaller chunks.
These list API methods share a common set of parameters that allow you to control the number of items returned and the page number. For example, you can:
* [retrieve a list of ad copy templates](/api-references/endpoint/retrieve-a-list-of-ad-copy-templates)
### Parameters
The page number to retrieve. By default, the first page is returned.
The number of items to retrieve per page. The default value varies by
endpoint. Maximum value is 100.
The field to sort the results by.
The order to sort the results by. Can be `asc` or `desc`.
### Example
The following example demonstrates how to retrieve the first page of 10 ad copy templates:
```bash cURL theme={null}
curl --request GET \
--url https://admanage.ai/api/ad-copy-templates?page=1&pageSize=10 \
--header 'Authorization: Bearer '
```
# Rate limits
Source: https://docs.admanage.ai/api-references/rate-limits
Learn about AdManage's API rate limits.
AdManage's API rate limiting is in conformance with the [IETF standard](https://datatracker.ietf.org/doc/html/draft-ietf-httpapi-ratelimit-headers):
| Header Name | Description |
| ----------------------- | ------------------------------------------------------------------------------- |
| `X-RateLimit-Limit` | The maximum number of requests that the consumer is permitted to make per hour. |
| `X-RateLimit-Remaining` | The number of requests remaining in the current rate limit window. |
| `X-RateLimit-Reset` | The time at which the current rate limit window resets in UTC epoch seconds. |
| `Retry-After` | The number of seconds to wait before retrying the request again. |
AdManage's API is capped at **60 requests per minute** per key on the Inhouse plan, with elevated limits for [Agency plan](https://admanage.ai/pricing) and above.
This is implemented to ensure a fair usage policy so that excessive use by a single user does not adversely affect the performance and usage of the API by others.
You'll receive a `429 Too Many Requests` response code if the rate limit is exceeded.
## Rate limits by plan
Depending on your AdManage pricing plan, you can expect the following rate limits:
| Plan | Rate limit |
| -------------------------------------------- | -------------------------------------------------------------------------- |
| [Inhouse](https://admanage.ai/pricing) | 60 requests per minute |
| [Agency](https://admanage.ai/pricing) | 600 requests per minute |
| [Enterprise](https://admanage.ai/enterprise) | Custom β [reach out to sales](https://admanage.ai/book-a-call) for details |
# API keys
Source: https://docs.admanage.ai/api-references/tokens
Learn how API keys work on AdManage.
API keys on AdManage allow you to access your organization programmatically. This is useful for integrating AdManage into your application or with other tools and services.
Each API key is tied to a specific organization β meaning you can use it to access that organization's resources without having to worry about "leaking" access to other organizations.
API keys on AdManage follow the format:
```bash .env theme={null}
ADMANAGE_API_KEY=ak_xxxxxxxx
```
By default, you can use this key to perform any API request without restriction, so it must be stored securely in your app's server-side code (such as in an environment variable or credential management system). Donβt expose this key on a website.
## Create an API key
You can create an API key by following these steps:
Go to the [**API Keys Page**](https://admanage.ai/connect)
![organization API keys on AdManage]()
Click on the **Create API Key** button to create the key. Make sure to copy your API key
![Add new API key on AdManage]()
Now that you have your API key, you can use it to access your organization's resources programmatically via any API request as a bearer token.
```
Authorization: Bearer ak_xxxx
```
# Upload Ads
Source: https://docs.admanage.ai/api-references/upload
Upload video files or URLs to AdManage for ad creation
Upload a video file directly to AdManage for ad creation. Images and Videos are supported.
```bash cURL theme={null}
curl -X POST "https://api.admanage.ai/upload" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/your/file.mp4"
```
```javascript JavaScript theme={null}
const formData = new FormData();
formData.append('file', /* your file object */);
fetch('https://api.admanage.ai/upload', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
},
body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
```
```python Python theme={null}
import requests
files = {
'file': open('path/to/your/file.mp4', 'rb')
}
headers = {
'Authorization': 'Bearer YOUR_API_KEY'
}
response = requests.post(
'https://api.admanage.ai/upload',
headers=headers,
files=files
)
print(response.json())
```
```json Success Response theme={null}
{
"success": true,
"url": "https://media.admanage.ai/company-name/filename.png",
"filename": "filename_suffix.png",
"originalName": "filename.png",
"wasRenamed": true,
"dimensions": {
"format": "png",
"size": 145523,
"width": 960,
"height": 694,
"space": "srgb",
"channels": 3,
"depth": "uchar",
"density": 72,
"isProgressive": false,
"hasProfile": false,
"hasAlpha": false,
"exif": {
"type": "Buffer",
"data": [77, 77, 0, 42, 0, 0, 0, 8, 0, 1, 135, 105, 0, 4, 0, 0, 0, 1, 0, 0, 0, 26, 0, 0, 0, 0, 0, 3, 160, 1, 0, 3, 0, 0, 0, 1, 0, 1, 0, 0, 160, 2, 0, 4, 0, 0, 0, 1, 0, 0, 3, 192, 160, 3, 0, 4, 0, 0, 0, 1, 0, 0, 2, 182, 0, 0, 0, 0]
}
},
"size": 145523,
"sizeFormatted": "142.11 KB"
}
```
### Parameters
The video file to upload. Supported formats: MP4, MOV, AVI. Maximum size: 100MB.
***
## Upload from URL
Upload a video from a URL to AdManage for ad creation.
```bash cURL theme={null}
curl -X POST "https://api.admanage.ai/upload/url" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/video.mp4"}'
```
```javascript JavaScript theme={null}
fetch('https://api.admanage.ai/upload/url', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
url: 'https://example.com/video.mp4'
})
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
```
```python Python theme={null}
import requests
headers = {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
}
response = requests.post(
'https://api.admanage.ai/upload/url',
headers=headers,
json={'url': 'https://example.com/video.mp4'}
)
print(response.json())
```
```json Success Response theme={null}
{
"success": true,
"url": "https://media.admanage.ai/admanage.ai/video_sample_xyz123.mp4",
"filename": "video_sample_xyz123.mp4",
"originalName": "video.mp4",
"wasRenamed": true,
"id": 11110,
"dimensions": {
"format": "mp4",
"size": 12582912,
"width": 1280,
"height": 720,
"duration": 25.2,
"bitrate": 4000000,
"framerate": 30
},
"size": 12582912,
"sizeFormatted": "12.00 MB"
}
```
### Parameters
The URL of the video file to upload. Must be publicly accessible and point to a supported video format.
***
## Response Fields
Indicates whether the upload was successful.
The CDN URL where the uploaded file can be accessed.
The final filename of the uploaded file (may include suffix if renamed).
The original filename of the uploaded file.
Indicates whether the file was renamed during upload to avoid conflicts.
Unique identifier for the uploaded file. Use this ID to reference the file in other API calls.
Detailed information about the file's dimensions and metadata.
The format of the uploaded file (e.g., "png", "mp4", "jpg").
The size of the file in bytes.
The width of the image/video in pixels.
The height of the image/video in pixels.
(Video files only) The duration of the video in seconds.
(Video files only) The bitrate of the video.
(Video files only) The framerate of the video.
(Image files only) The color space of the image.
(Image files only) The number of color channels.
(Image files only) The bit depth of the image.
(Image files only) The pixel density (DPI).
(Image files only) Whether the image is progressive.
(Image files only) Whether the image has a color profile.
(Image files only) Whether the image has an alpha channel.
(Image files only) EXIF metadata from the image file.
The size of the uploaded file in bytes.
Human-readable formatted file size (e.g., "142.11 KB", "12.00 MB").
***
## Error Responses
```json File Too Large theme={null}
{
"success": false,
"error": "FILE_TOO_LARGE",
"message": "File size exceeds the maximum limit of 100MB",
"details": {
"fileSize": 157286400,
"maxSize": 104857600
}
}
```
```json Invalid Format theme={null}
{
"success": false,
"error": "INVALID_FORMAT",
"message": "Unsupported file format. Supported formats: MP4, MOV, AVI, PNG, JPG, JPEG",
"details": {
"detectedFormat": "webp"
}
}
```
```json URL Not Accessible theme={null}
{
"success": false,
"error": "URL_NOT_ACCESSIBLE",
"message": "The provided URL is not accessible or does not contain a valid file",
"details": {
"url": "https://example.com/invalid.mp4"
}
}
```
# How to launch via manual upload
Source: https://docs.admanage.ai/bulk
### Bulk Ad Launching
Launching multiple ads through Facebook's native interface can be time-consuming and tedious. With Admanage.ai's bulk upload feature, you can launch dozens of ads in minutes instead of hours. This streamlined process not only saves you valuable time but also reduces the risk of errors that often occur when manually configuring each ad individually.
# Custom Placement Carousels
Source: https://docs.admanage.ai/carousel_custom_placement
Learn how to launch custom placement carousel ads with AdManage, including important notes about Facebook's publishing process.
This guide will walk you through the process of launching custom placement carousel ads using AdManage. Note that there is a known Facebook bug that requires an additional step in the publishing process.
## Step 1: Load Your Assets
1. Click "Load Media" to begin
2. Select your landscape (16:9) images:
* Choose your first landscape image
* Select additional landscape images as needed
3. Select your portrait (9:16) images:
* Click "Add Portrait"
* Choose your portrait images
4. Click "Add Creatives" to confirm your selection
## Step 2: Configure Carousel Settings
1. Click "Set Multi-Placement"
2. Click "Set Carousel Ads"
3. Select your landscape images in the desired order
4. Add your portrait images using the "Add Portrait" button
5. Click "Confirm Selection"
## Step 3: Launch and Publish
1. Click "Launch Ads"
2. **Important**: Click "See In Meta Ads Manager" (this step is required due to a Facebook bug)
3. Wait for the ad to process in Meta Ads Manager
4. You may see an error message - this is normal and expected
5. Click "Republish" to resolve the error
6. Your custom placement carousel ad will now be live
## Important Notes
* There is a known Facebook bug that prevents direct publishing of custom placement assets
* You must use the "See In Meta Ads Manager" option
* The error message you see is normal and will be automatically fixed by Facebook
* You must click "Republish" for the ad to work properly
* This extra step is only required for custom placement assets
## Troubleshooting
If you encounter any issues:
1. Make sure you've followed all steps in order
2. Verify that you've clicked "See In Meta Ads Manager"
3. Ensure you've clicked "Republish" after the error message
4. If problems persist, try refreshing the Meta Ads Manager page
1\. Click "Load Media"
2\. Click "AdManage\_RY\_Statics\_9\_16x9.png.png"
3\. Click "AdManage\_RY\_Statics\_8\_16x9.png.png"
4\. Click "Quest Portal 9x16 Dragon 6.png"
5\. Click "Quest Portal 9x16 Dragon 4.png"
6\. Click "Add 6 Creatives"
7\. Click "Set Multi-Placement"
8\. Type "\`"
9\. Click here
10\. Click "Set Carousel Ads"
11\. Click the AdManage\_RY\_Statics\_10\_16x9.png image
12\. Click the AdManage\_RY\_Statics\_9\_16x9.png.png image
13\. Click the AdManage\_RY\_Statics\_8\_16x9.png.png image
14\. Click "Add Portrait"
15\. Click the Quest~~Portal~~9x16~~Dragon~~6.png image
16\. Click "Add Portrait"
17\. Click the Quest~~Portal~~9x16~~Dragon~~5.png image
18\. Click "Add Portrait"
19\. Click the Quest~~Portal~~9x16~~Dragon~~4.png image
20\. Click this text field
21\. Type " 1"
22\. Click this text field
23\. Type " 2"
24\. Click this text field
25\. Type " 3"
26\. Click this text field
27\. Type "3"
28\. Click this text field
29\. Type "2"
30\. Click this text field
31\. Type "1"
32\. Click "Confirm Selection"
33\. Click "Launch Ads"
34\. Click "See In Meta Ads Manager"
35\. Click the Ads Manager tab
36\. Click the Close button
37\. Click here
38\. Click this system dialog
39\. Click "Publish"
#### [Made with Scribe](https://scribehow.com/shared/Google_Chrome_Zight_and_WhatsApp_Workflow__5SjsPl8jSuSp6j9ewOH2yA)
# Change Facebook, Instagram & Tiktok Profile Pages
Source: https://docs.admanage.ai/change-profile-pages
Learn how to change launch ads as different Facebook, Instagram or Tiktok Profiles in Admanage.
### Change Facebook & Instagram Profile Pages
Click on the profile page you want to change.
Select the Facebook profile page you want to use.
Select the Instagram profile page you want to use.
Click `Confirm Selection` to save the changes.
### Change Tiktok Profile Pages
The Tiktok profile page only shows if a TikTok ad set is selected.
First, select a TikTok ad aset.
You can filter the ad sets by platform to only show TikTok ad sets.
Click on the TikTok profile page you want to change.
Select the TikTok profile page you want to use.
That's it! You've changed the profile pages for your ad sets. You can now select your media files, ad sets and launch.
# Creative Enhancements
Source: https://docs.admanage.ai/creative-enhancements
## Overview
Creative Enhancements, also known as Crave Enhancements, are powerful tools in AdManage that help you optimize your Facebook ad creatives for better performance and engagement. These enhancements can be applied to all Facebook Images, Videos, and Carousels, giving you full control over how your ads appear and perform.
## What Are Creative Enhancements?
Creative Enhancements are a set of automated and manual options that can be applied to your ad creatives. They include features like:
* **Relevant Comments**: Automatically add comments that are relevant to your ad content.
* **Visual Touch-ups**: Improve the visual quality of your images and videos.
* **Text Improvements**: Enhance the clarity and impact of your ad copy.
* **Overlays, Music, Animation, and More**: Add overlays, music, animations, and other effects to make your ads stand out.
* **Catalog Items & Site Links**: Automatically include product catalog items or site links in your creatives.
* **Standard & Advantage+ Enhancements**: Leverage Meta's advanced creative optimization features.
Each enhancement can be toggled on or off for Images, Videos, and Carousels independently.
## How to Use Creative Enhancements
### 1. Accessing the Settings
* Go to the **Creative Enhancements** section in your AdManage settings.
* You'll see separate panels for **Images**, **Videos**, and **Carousels**.
### 2. Global Toggle
* At the top, there is a **Meta Creative Enhancements** switch.
* **Turn All On/Off**: Use this switch to enable or disable all enhancements at once for the selected ad account.
* When turned off, all individual enhancements will be disabled.
### 3. Customizing Enhancements
* Under each creative type (Images, Videos, Carousels), you can toggle individual enhancements on or off.
* This allows you to create a custom setup that fits your brand and campaign needs.
### 4. Per Ad Account Settings
* Creative Enhancement settings are saved **per ad account**.
* When you add a new ad account, you'll set your defaults once.
* These preferences are remembered for every launch with that ad account, so you don't have to reconfigure each time.
## Best Practices
* **Start with All Off**: If you want full manual control, turn all enhancements off.
* **Customize for Your Brand**: Enable only the enhancements that align with your creative strategy.
* **Test and Monitor**: Try different combinations and monitor ad performance to find what works best.
* **Set and Forget**: Once you've set your preferences for an ad account, they'll be applied automatically for future campaigns.
## Example Use Cases
* **Brand Consistency**: Turn off all enhancements except for overlays and branding elements.
* **Performance Optimization**: Enable all enhancements to let Meta optimize your creatives automatically.
* **Custom Approach**: Mix and match enhancements for each creative type based on your campaign goals.
## FAQ
**Q: Will my settings apply to all ad accounts?**\
A: No, settings are saved per ad account. You'll set them once for each account.
**Q: Can I change settings later?**\
A: Yes, you can update your Creative Enhancements at any time in the settings.
**Q: What happens when I add a new ad account?**\
A: You'll be prompted to set your Creative Enhancement defaults for that account.
# Naming Convention - Date Format
Source: https://docs.admanage.ai/custom-naming-date-format
Learn how to customize date format in the naming convention for your ad sets.
Here's an In depth tutorial on how to customize date format in the naming convention for your ad sets.
You can customize your default naming convention in the [Settings page](https://admanage.ai/settings).
Go to the `Naming Convention` section.
Click on the `Date Format` field.
Enter the date format you want to use.
Click `Add`
### Valid Date Variables
Day of month (1, 2, ..., 31)
Day of month with ordinal (1st, 2nd, ..., 31st)
Day of month, zero-padded (01, 02, ..., 31)
Week of year (1, 2, ..., 53)
Week of year with ordinal (1st, 2nd, ..., 53rd)
Week of year, zero-padded (01, 02, ..., 53)
Month (1, 2, ..., 12)
Month with ordinal (1st, 2nd, ..., 12th)
Month, zero-padded (01, 02, ..., 12)
Month, short name (Jan, Feb, ..., Dec)
Year, any number of digits (44, 1, 1900, 2017)
Year with ordinal (44th, 1st, 0th, 17th)
Year, last two digits (44, 01, 00, 17)
Year, minimum three digits (044, 001, 1900, 2017)
Year, minimum four digits (0044, 0001, 1900, 2017)
Example: To format the date as "Week 01 Year 23", use `{{dateFormat:ww-yy}}`
That's it! You've customized the date format in the naming convention for your default naming convention.
# Set Custom Thumbnail for Video Ads
Source: https://docs.admanage.ai/custom-thumbnail
Learn how to set a custom thumbnail for your video ads in AdManage.
## Getting Started
Load your media by clicking the `Load Media` button
Select the videos files you want to launch
Click the `Add Custom Thumbnail` button at the top right corner of the ad preview
Upload your thumbnail image
9\. Click "Save Changes"
That's it! Your thumbnail will now be used for your video ads.
# Customize Individual Ad Names
Source: https://docs.admanage.ai/customize-individual-ad-names
A step-by-step guide showing how to customize individual ad names in the table view, including selecting ads, using bulk edit functionality, and assigning custom names to different ads.
1\. Click here
2\. Click "Load Media"
3\. Click "9800"
4\. Click "9803"
5\. Click "Add 4 Creatives"
6\. Click the grid table radio button
7\. Click this column header
8\. Click here
9\. Double-click this text entry area
10\. Type "AD\_1"
11\. Double-click this text entry area
12\. Type "AD\_2"
13\. Click here
14\. Click the Select row 1 checkbox
15\. Click the Select row 2 checkbox
16\. Click "Bulk Edit"
17\. Click "Ad Sets"
18\. Click "Select ad sets..."
19\. Click this combo box
20\. Click this menu item
21\. Click here
22\. Click "Apply"
# Ad Naming Conventions
Source: https://docs.admanage.ai/customizing_ad_naming_convention
Learn how to customize and configure naming conventions for your ads using date formats, and custom text. This guide explains all available options for creating consistent and organized ad naming patterns.
### Getting Started with naming Conventions
1. Go to `Settings` Page
2. Scroll to `Naming Convention` section
### Allowed Tokens
You can use any of the following tokens in your custom naming convention
| Token | Description | Example Value |
| ---------------- | ------------------------------------------------------ | ------------------------- |
| `{{customText}}` | Custom text that you can specify | Any text you enter |
| `{{dateFormat}}` | Date in specified format (see available formats below) | Various formats available |
| `{{id}}` | Unique identifier assigned by Admanage | 3 |
| `{{creator}}` | Name of the creator | john |
| `{{filename}}` | Name of the file | newHookAd\_1x1 |
| `{{filetype}}` | Type of the file | Video |
Day of month (1, 2, ..., 31)
Day of month with ordinal (1st, 2nd, ..., 31st)
Day of month, zero-padded (01, 02, ..., 31)
Week of year (1, 2, ..., 53)
Week of year with ordinal (1st, 2nd, ..., 53rd)
Week of year, zero-padded (01, 02, ..., 53)
Month (1, 2, ..., 12)
Month with ordinal (1st, 2nd, ..., 12th)
Month, zero-padded (01, 02, ..., 12)
Month, short name (Jan, Feb, ..., Dec)
Year, any number of digits (44, 1, 1900, 2017)
Year with ordinal (44th, 1st, 0th, 17th)
Year, last two digits (44, 01, 00, 17)
Year, minimum three digits (044, 001, 1900, 2017)
Year, minimum four digits (0044, 0001, 1900, 2017)
Example: To format the date as "Week 01 Year 23", use `{{dateFormat:ww-yy}}`
### Remove a Token
You can Click `x` to remove any tokens that you don't want
### Add Custom Text
Click this on the custom text field
17\. Type `Your Custom Text` and Click `Add`
### Customise the seprator
You can select a selector from the dropdown
### Remove dimensions from name in meta
# Duplicate Adset in admanage
Source: https://docs.admanage.ai/duplicate-adset-in-admanage
Learn how to duplicate existing ad sets in AdManage, including customizing the new ad set name, budget, and schedule. You can also choose to launch the duplicated ad set in a paused state for further modifications in Meta.
You can duplicate adsets on the [launch](https://admanage.ai/launch) page
### Open the `Duplicate Ad Set` dialog
### Search for the existing adset you like to duplicate
### Customize the new Ad set Name
### Duplicate the Ad Set
Click `Duplicate an existing ad set` when you're done.
You can launch the adset as paused, so you can make changes to it in Meta.
### Additional Options
Click "Show Additional Options"
You can set:
* Adset Budget
* Adset Schedule (Start Date, End Date)
# Duplicate a Campaign in AdManage
Source: https://docs.admanage.ai/duplicate-campaign-in-admanage
Learn how to duplicate a campaign in AdManage, including selecting the campaign to duplicate, customizing the new campaign name, and duplicating the campaign.
## Duplicate a Campaign
You can duplicate a campaign on the [launch page](https://admanage.ai/launch).
### Open the duplicate campaign modal
### Select the Campaign you want to duplicate
### Customize the new campaign name
### Launch campaign as paused
You can launch the campaign as paused, so you can make changes to it in Meta.
Duplicate the Campaign
## Duplicate the Ad Sets from the campaign
After Duplicating a campaign, you can also choose to duplicate the ad sets that are in the campaign you just duplicated.
Customise the details for the new ad sets that will be duplicated.
Duplicate the Ad Sets
# Facebook Permissions
Source: https://docs.admanage.ai/facebook-permissions
## Learn how to properly set up and manage Facebook permissions in AdManage.
## Understanding Facebook Permissions
When you authenticate with Facebook in AdManage, you'll be presented with several permission requests. These permissions are essential for the platform to function properly and allow you to manage your advertising effectively.
### Required Permissions
#### 1. Page Access
* **Purpose**: Enables AdManage to launch ads using different Facebook pages
* **Why it's needed**: Required for launching ads under specific pages (e.g., "Home Security Today")
* **How to set**: You can either:
* Click "Opt in all" to grant access to all pages
* Select specific pages individually
* **Common issues**: Ads may fail to launch if AdManage doesn't have access to the target page
#### 2. Business Manager Access
* **Purpose**: Provides access to ad accounts within your Business Manager
* **How to set**: Similar to pages, you can:
* Click "Opt in all" for all business accounts
* Select specific business accounts
* **Required for**: Managing ad accounts and campaigns
#### 3. API Permissions
AdManage requires the following API permissions:
* Read page content
* Create and manage ads
* Read user content (comments)
* View managed pages list
* Manage business (ad creation and management)
* Access ad statistics
## Setting Up Connection
1. **Initial Authentication**
* Go to Settings > Integrations
* Select "Facebook"
* Click "Authenticate with Facebook"
* Review and accept required permissions
2. **Verify Access Levels**
* Check Business Manager role
* Verify Ad Account access
* Confirm Page permissions
3. **Test Connection**
* Create test campaign
* Verify ad creation
* Check reporting access
## Managing Permissions
### Viewing Current Permissions
* Navigate to the Permissions tab
* View all connected ad accounts
* See associated pages with access
### Revoking Access
You can revoke AdManage's access in two ways:
1. **Through Facebook**:
* Visit Facebook.com/settings/business\_tools
* Find AdManage in the list
* Click "Remove" to revoke access
2. **Through AdManage**:
* Go to Settings > Integrations
* Click "Disconnect" next to Facebook
## Security and Privacy
AdManage takes security seriously:
* Double encryption of all data
* CASA security audit compliance
* Immediate data deletion upon request
* Regular security reviews
## Common Permission Issues
### 1. Access Denied
* Check Business Manager role
* Verify email permissions
* Review account status
### 2. Limited Functionality
* Review permission scope
* Check account restrictions
## Permissions setup in facebook
1\. Click "Re-Authenticate Facebook"
2\. Click "Edit previous settings."
3\. Double-click "Select all"
4\. Click "Opt in to all current and future Pages"
5\. Click "Opt in to current "
6\. Click "Continue"
7\. Click "Opt in to all current and future Businesses"
8\. Click "Opt in to current Businesses only This will only give AdManage AI API access to the Businesses you select."
9\. Click "Continue"
10\. Click "Show a list of the Pages you manage"
11\. Click "Save"
12\. Click "Got it"
13\. Click "Authenticated by: "
# Launching from Google Drive
Source: https://docs.admanage.ai/google-drive
### Connecting Google Drive to AdManage for Ad Creation
1\. Navigate to [https://admanage.ai/launch](https://admanage.ai/launch)
2\. Hi, guys. I'm going to show you how to launch from Google Drive today. So all you need to do. Is go into your integrations. And you'll see a Google Drive here.
3\. And basically, I've already connected. But I will reconnect. And here you just click. Connect to Google.
4\. Click "Connect"
5\. And then you will log in.
6\. Click "Connect Google Drive"
7\. You can skip this part. Yeah, we've already logged in here. We've already given it the access.
8\. Click "Continue"
9\. Click here.
10\. You can now load directly from Google Drive.
11\. And here, let me load four ads.
12\. Click "Google DriveNew"
13\. So you can see I've loaded four ads. I'm going to select this ad. Set.
14\. Click here.
15\. Click "01\_FancyVividYellowdiamond\_1x1.jpg"
16\. Click "Select"
17\. And here we're launching our two multiformat ads from Google Drive directly. You can see the link here of the Google Drive.
18\. Click "New Sales ad set ced"
19\. Click here.
20\. Click here.
21\. It's just having a tab here where you can load from the Google File picker.
22\. And you get a progress update while this happens.
23\. Click "Load Media"
24\. Click "Google DriveNew"
25\. So that as soon as it's done,.
26\. We'll be able to see it in Facebook directly to have all of our ads here.
27\. And you can see we have our two ads up here already there. So, yeah, that's. How you launch from Google Drive.
# AdManage Google Sheets Addon
Source: https://docs.admanage.ai/gsheets-app
Complete campaign management directly from Google Sheets with launch drafts, ad set exports, matching, and data synchronization
The AdManage Google Sheets Addon is a comprehensive campaign management tool that brings the full power of AdManage directly into your Google Sheets environment. Upload launch drafts, export ad sets, match campaigns, and manage your advertising data all without leaving your spreadsheet.
**Need help?** For technical support, email us at [support@admanage.ai](mailto:support@admanage.ai)
## Key Features
The addon provides four core features accessible through an intuitive interface:
* **π Launch Ads** - Upload campaign data to AdManage Launch Drafts
* **π Export Data** - Export ad sets and campaign data from AdManage to sheets
* **π― Match Ad Sets** - Intelligently match ads to appropriate ad sets based on campaign patterns
### Typical Launching Workflow
1. **Setup**: Use "Load Defaults" to create properly structured sheet
2. **Data Entry**: Fill in columns and rows with your information
3. **Upload**: Send launch batch to AdManage
4. **Launch**: Complete launching in AdManage platform
## Installation
### Install from Google Workspace Marketplace
The AdManage addon is available directly from the Google Workspace Marketplace for easy installation:
[Install AdManage from Google Workspace Marketplace](https://workspace.google.com/u/0/marketplace/app/admanage/550827967992)
1. **Open Google Sheets** - Create a new sheet or open an existing one
2. **Access Extensions** - Go to **Extensions** β **Add-ons** β **Get add-ons**
3. **Search for AdManage** - In the Google Workspace Marketplace, search for "AdManage"
4. **Install the Add-on** - Click on the AdManage addon and select **Install**
5. **Grant Permissions** - Review and accept the required permissions when prompted
### Initial Setup
1. **Refresh your Google Sheet** after installation
2. Go to **Extensions** β **AdManage** β **Launch Sidebar** to open the integration panel
3. The addon will automatically attempt to authenticate with your Google account
## Authentication
### Connect Your AdManage Account
The addon requires authentication with both Google and AdManage:
1. When you first open the sidebar, you may be prompted to authorize the script
2. Click **"Review Permissions"** and grant the necessary access
3. The addon needs permissions to:
* Read and modify your spreadsheet data
* Connect to external services (AdManage API)
* Access your Google account information
The addon uses **automatic authentication** through your Google account. The email address on the google account must be invited to your admanage organization.
## Feature 1: Launch Ads (Upload to AdManage)
Transform your spreadsheet data into AdManage Launch Drafts for campaign creation.
### Required Column Structure
Your Google Sheet must include the **Row Type** column:
* **Row Type** - Specifies the ad format (single, multi, carousel, etc.)
### Supported Columns
The addon supports extensive column mapping for comprehensive ad configuration:
* **Custom Name** / **Ad Name** - Campaign or ad identifier
* **Ad Description** / **Description** - Detailed ad description
* **Headline** / **Ad Title** - Primary headline text
* **Primary Text** / **Main Text** / **Body Text** - Ad body content
* **Created At** / **Updated At** - Timestamps
* **Link** / **Landing Page** / **URL** / **Website** - Destination URL
* **Display Link** - URL shown in ad
* **UTM** / **UTM Parameters** - Tracking parameters
* **CTA** / **Call to Action** / **Button Text** - Call-to-action text
* **Partnership Code** - Partnership tracking
* **Video URLs** / **Video Link** / **File Links** - Media content
* **Ad Set IDs** - Target ad set identifiers
* **Launch Paused** - Launch in paused state (true/false)
* **Headline Variation (1-5)** - Multiple headline options
* **Primary Text Variation (1-5)** - Multiple body text options
For carousel ads, the addon supports up to 10 carousel items:
* **Carousel X Media URL** - Media file for each carousel card
* **Carousel X Portrait Media URL** - Portrait orientation media
* **Carousel X Title** - Title for each carousel card
* **Carousel X Description** - Description for each carousel card
* **Carousel X Link** - Destination URL for each carousel card
*Note: Special carousel processing is available for specific customer configurations*
### Column Mapping System
The addon uses a two-tier column mapping system to automatically convert your sheet column names to AdManage format:
1. **Automatic Mappings** - Built-in mappings that work immediately (no configuration needed)
2. **Custom Mappings** - User-defined mappings for specific column names (configured in the sidebar)
#### Automatic Mappings (Always Active)
These mappings are automatically applied to your sheet columns. If your sheet uses any of these column names, they will be automatically converted to the AdManage format shown below:
**Ad Name:**
* `Campaign Name` β `Ad Name`
* `Custom Name` β `Ad Name`
* `ad_name` β `Ad Name`
**Headline:**
* `Ad Title` β `Headline`
* `Captions` β `Headline`
* `headline_1` β `Headline`
* `Headline Variation 1` β `Headline`
* `Headline Variation 2` β `Headline Variation 1`
* `Headline Variation 3` β `Headline Variation 2`
* `Headline Variation 4` β `Headline Variation 3`
* `Headline Variation 5` β `Headline Variation 4`
**Primary Text:**
* `Main Text` β `Primary Text`
* `Body Text` β `Primary Text`
* `primary_text_1` β `Primary Text`
* `Primary Text Variation 1` β `Primary Text`
* `Primary Text Variation 2` β `Primary Text Variation 1`
* `Primary Text Variation 3` β `Primary Text Variation 2`
* `Primary Text Variation 4` β `Primary Text Variation 3`
* `Primary Text Variation 5` β `Primary Text Variation 4`
**Ad Description:**
* `Description` β `Ad Description`
* `description` β `Ad Description`
**Link:**
* `Landing Page` β `Link`
* `Page Link` β `Link`
* `URL` β `Link`
* `Website` β `Link`
* `website_url` β `Link`
**CTA:**
* `Call to Action` β `CTA`
* `Call-to-Action` β `CTA`
* `Button Text` β `CTA`
* `call_to_action` β `CTA`
**UTM Parameters:**
* `UTM` β `UTM Parameters`
* `url_parameters` β `UTM Parameters`
**Partnership Code:**
* `Booster Code` β `Partnership Code`
* `Spark Code` β `Partnership Code`
* `Auth Code` β `Partnership Code`
* `Tiktok Code` β `Partnership Code`
**Media URLs:**
* `Video URLs` β `Media URLs`
* `Video URL` β `Media URLs`
* `Video Link` β `Media URLs`
* `File Links` β `Media URLs`
* `File URLs` β `Media URLs`
**Row Type:**
* `Media Type` β `Row Type`
* `AD Format` β `Row Type`
* `Format` β `Row Type`
* `format` β `Row Type`
**Ad Set IDs:**
* `adset_name` β `Ad Set IDs`
**Ad Status:**
* `ad_status` β `Ad Status`
**Instagram Page ID:**
* `Instagram Page Id` β `Instagram Page ID`
* `Instagram Page` β `Instagram Page ID`
* `Instagram Profile` β `Instagram Page ID`
* `IG Page ID` β `Instagram Page ID`
**Facebook Page ID:**
* `Facebook Page Id` β `Facebook Page ID`
* `Facebook Page` β `Facebook Page ID`
* `Facebook Profile` β `Facebook Page ID`
* `FB Page ID` β `Facebook Page ID`
**TikTok Page ID:**
* `Tiktok Page Id` β `Tiktok Page ID`
* `Tiktok Page` β `Tiktok Page ID`
* `Tiktok Profile` β `Tiktok Page ID`
**Threads Page ID:**
* `Threads Page Id` β `Threads Page ID`
* `Threads Page` β `Threads Page ID`
* `Threads Profile` β `Threads Page ID`
**iOS Custom Product Page:**
* `Custom Product Page Code` β `Custom Product Page`
* `csl` β `Custom Product Page`
* `Custom Store Listing` β `Custom Product Page`
* `CSL` β `Custom Product Page`
* `iOS Custom Product Page` β `Custom Product Page`
* `iOS CSL` β `Custom Product Page`
* `iOS CPP` β `Custom Product Page`
* And many more iOS variants (see code for complete list)
**Android Custom Product Page:**
* `Android Custom Product Page` β `Android Custom Product Page`
* `Android CSL` β `Android Custom Product Page`
* `Android CPP` β `Android Custom Product Page`
* `Google Play Custom Product Page` β `Android Custom Product Page`
* And many more Android variants (see code for complete list)
**IAS Brand Safety URL:**
* `Brand Safety URL` β `IAS Brand Safety URL`
* `Brand Safety` β `IAS Brand Safety URL`
* `IAS URL` β `IAS Brand Safety URL`
* `IAS Brand Safety` β `IAS Brand Safety URL`
* `IAS VAST URL` β `IAS Brand Safety URL`
* `Brand Safety VAST` β `IAS Brand Safety URL`
The addon automatically combines multiple columns into single AdManage fields:
**Media URLs (from multiple asset columns):**
* `1x1 Asset Link`, `4x5 Asset Link`, `9x16 Asset Link` β `Media URLs`
* `1x1 Asset`, `4x5 Asset`, `9x16 Asset` β `Media URLs`
* `1x1 File Link`, `4x5 File Link`, `9x16 File Link` β `Media URLs`
* `1x1 file`, `4x5 file`, `9x16 file` β `Media URLs`
* `default_image_url_1`, `default_image_url_2`, `default_image_url_3` β `Media URLs`
*Note: Values are automatically concatenated with commas when multiple columns are mapped to the same target.*
#### Custom Mappings (User-Configured)
In addition to automatic mappings, you can create custom mappings for column names specific to your workflow. These are managed in the **Column Mappings** section of the sidebar:
1. **View Current Mappings** - The sidebar shows:
* **Automatic Mappings** - All built-in mappings that are currently active (shown below custom mappings)
* **Custom Mappings** - Your user-defined mappings (shown at the top)
2. **Add Custom Mapping** - Click **"+ Add Column Mapping"** to map a sheet column to an AdManage field
3. **Edit or Remove** - Custom mappings can be modified or deleted at any time
**Important:** Custom mappings take precedence over automatic mappings. If you create a custom mapping for a column name that also has an automatic mapping, your custom mapping will be used instead.
#### How Mappings Work Together
When you upload data to AdManage:
1. **Automatic mappings are applied first** - All built-in mappings are checked against your sheet columns
2. **Custom mappings are applied next** - Your custom mappings override any automatic mappings for the same column names
3. **Final result** - Your sheet data is transformed to AdManage format using the combined mapping rules
**Example:** If your sheet has a column named `Campaign Name`:
* It will automatically map to `Ad Name` (automatic mapping)
* If you create a custom mapping `Campaign Name` β `Custom Name`, your custom mapping will be used instead
* The final data sent to AdManage will use `Custom Name` as the field name
### Upload Process
1. The addon automatically detects new rows that haven't been uploaded
2. It adds an **"ADMANAGE"** column to track upload status
3. Only processes rows without timestamps in the ADMANAGE column
4. Shows upload statistics before processing
1. Click **"Upload to AdManage"** from the Launch Ads card
2. The addon processes up to 50 rows per batch for optimal performance
3. If you have more than 50 rows, run multiple uploads
4. Each successful upload adds timestamps to processed rows
* **Business ID**: Optional business/ad account identifier
* **Status**: Choose "draft" or "active" for launch drafts
* **Automatic Title Generation**: Uses row count and timestamp
* **CSV Format**: Data is automatically formatted as CSV for AdManage
## Feature 2: Export Data (Ad Sets from AdManage)
Export ad set data from your AdManage account directly into Google Sheets for analysis and management.
### Export Capabilities
1. Click **"Export from AdManage"** from the Export Data card
2. Enter your Facebook/Meta Ad Account ID (numeric format)
3. The addon fetches all ad sets with pagination support
4. Creates a new sheet named "AdSets\_\[AccountName]"
The export includes essential ad set information:
* **Ad Set ID** - Unique identifier
* **Name** - Ad set name
* **Campaign Name** - Parent campaign
* **Spend** - Total ad spend
* **Status** - Current ad set status
* **Ad Count** - Number of ads in set
* **Platform** - Advertising platform
* **Account Memory**: Your Ad Account ID is saved for future exports
* **Last Sync Tracking**: Timestamps are recorded for each export
* **Multiple Accounts**: Support for managing multiple ad accounts
* **Automatic Formatting**: Headers, frozen rows, and auto-resized columns
### Background Sync & Scheduling
The addon includes advanced sync management:
* **Configured Syncs**: Set up automatic synchronization schedules
* **Batch Processing**: Run multiple account syncs simultaneously
* **Sync Status Tracking**: Monitor sync history and status
* **Error Handling**: Automatic API key refresh and retry logic
## Troubleshooting
**Problem**: "No AdManage API key found" or connection failures
**Solution**:
1. Use the refresh button in the account header
2. Sign out and sign back into your Google account
3. Check that your Google account is linked to AdManage
4. Try opening the addon in an incognito window
5. Ensure you have AdManage account access
**Problem**: "Wrong email address showing"
The wrong email address is showing in the addon.
This issue occurs when you have multiple google accounts in your chrome browser and the default one is the wrong one.
We can't fix this issue because it's caused by google incorrectly telling us who is logged in.
[https://developers.google.com/apps-script/guides/projects#fix\_issues\_with\_multiple\_google\_accounts](https://developers.google.com/apps-script/guides/projects#fix_issues_with_multiple_google_accounts)
Try one of the following solutions:
* Log out of all your Google Accounts and only log in to the one that has the add-on or web app you want to access.
* Open an incognito window in Google Chrome, or an equivalent private browsing window, and log in to the Google Account that has the add-on or web app you want to access.
**Problem**: Column mapping or data format errors
**Solution**:
1. Use the "Load Defaults" feature to see proper structure
2. Ensure "Row Type" column exists and contains valid values
3. Check for extra spaces in column headers
4. Verify data is in expected formats (URLs, numbers, text)
5. Use column mapping preview to verify recognition
**Problem**: Upload process fails or times out
**Solution**:
1. Try uploading smaller batches (under 50 rows)
2. Check internet connection stability
3. Verify Ad Account ID format and permissions
4. Look for error messages in the addon interface
5. Clear and re-enter problematic data
**Problem**: Ad set export fails or returns no data
**Solution**:
1. Verify Ad Account ID is correct and accessible
2. Check that you have permission to view ad sets
3. Ensure the account has active ad sets to export
4. Try a different Ad Account ID format (with/without "act\_")
5. Check AdManage platform for account status
**Problem**: Ad set matching returns poor results
**Solution**:
1. Check that campaign names follow consistent patterns
2. Verify ad set data has been recently exported
3. Review column detection for country, language, product fields
4. Consider setting up custom mapping rules
5. Ensure ad sets exist for the targeting criteria
## Support
Having issues with the Google Sheets addon? We're here to help:
* π§ **Email Support**: Contact our support team at [support@admanage.ai](mailto:support@admanage.ai)
* π§ **Technical Issues**: Include browser type, error messages, and screenshots
* π **Feature Requests**: Let us know what additional functionality you need
* π **Integration Help**: Assistance with complex workflow setups
The AdManage Google Sheets addon transforms your spreadsheet into a powerful campaign management hub, providing seamless integration between your data and AdManage's comprehensive advertising platform.
# Instagram Permissions
Source: https://docs.admanage.ai/instagram-permissions
## Understanding Instagram Permissions
When you authenticate with Facebook in AdManage to connect your Instagram account, you'll be presented with several permission requests. These permissions are essential for the platform to function properly and allow you to manage your Instagram advertising effectively.
### Required Permissions
#### 1. Instagram Account Access
* **Purpose**: Enables AdManage to launch ads using different Instagram accounts.
* **Why it's needed**: Required for launching ads under specific Instagram accounts (e.g., "@yourbrand").
* **How to set**: You can either:
* Click "Opt in all" to grant access to all accounts.
* Select specific Instagram accounts individually.
**Common issues**: Ads may fail to launch if AdManage doesn't have access to the target Instagram account OR You have an old version of your instagram page connected.
## Setting Up Connection
Go to the [Settings Page](https://admanage.ai/settings)
1\. Click "Re-Authenticate Facebook". This is the first step to connecting your Instagram account.
2\. Click "Edit previous settings."
3\. Ensure all your Instagram accounts are selected. You can click "Select all" to include current and future accounts.
4\. Do the same for Facebook Pages. Opt-in to all pages to ensure proper connection with their linked Instagram accounts.
5\. Click "Continue".
6\. Click "Continue"
7\. Opt in to all current and future Business Manager accounts. This is crucial for accessing your ad accounts.
8\. Or select only the specific Business accounts that manage your Instagram advertising.
9\. Click "Continue"
### Revoking Access
You can revoke AdManage's access in two ways:
1. **Through Facebook**:
* Visit Facebook.com/settings/business\_tools
* Find AdManage in the list of connected apps.
* Click "Remove" to revoke access. This will disconnect both Facebook and Instagram access.
## Security and Privacy
AdManage takes security seriously:
* Double encryption of all data
* CASA security audit compliance
* Immediate data deletion upon request
* Regular security reviews
# Launch Carousel Ads
Source: https://docs.admanage.ai/launch-carousel-ads
Learn how to create and configure carousel ads in AdManage. This guide covers loading media files, selecting multiple assets, grouping ads together, and managing placement variations for your carousel ads.
### Getting Started
Load your media by clicking the `Load Media` button
Select the files you want to use for your carousel ads
You can hold `shift` to select multiple files
Open the `Set Carousel Ads` dialog
Click to select the ads you want to group together in a carousel
You can select which files to use for the placement variations
Save you changes
# Launch Flexible Ads
Source: https://docs.admanage.ai/launch-flexible-ads
Learn how to create and configure flexible ads in AdManage. This guide covers loading media files, selecting multiple assets, grouping ads together, and managing placement variations for your flexible ads.
### Getting Started
Load your media by clicking the `Load Media` button
Select the files you want to use for your flexible ads
You can hold `shift` to select multiple files
Open the `Set Flexible Ads` dialog
Click to select the ads you want to group together in a flexible ad
Click `Group` to confirm the group of ads
Click `Done` when you're ready to launch the flexible ads
# Launch whitelisted ad/ Spark Ad on Meta or Tiktok
Source: https://docs.admanage.ai/launch-whitelist-spark-ads
Learn how to create and configure whitelisted ad/ Spark Ad on Meta or Tiktok in AdManage.
### Getting Started
You can only launch whitelisted ad/ Spark Ad on the [launch page](https://admanage.ai/launch) table view.
Click the grid table button to switch to the table view
Click the `Partnership/Spark Ads` toggle button to switch to the Partnership/Spark Ads mode
Enter the partnership code in the text field
Press `Cmd` + `v` to paste the partnership code
Select your ad sets by clicking the `Select ad sets` button
And that's it! You're ready to launch your whitelisted ad/ Spark Ad on Meta or Tiktok.
# Make.com Integration
Source: https://docs.admanage.ai/make
Connect AdManage to Make.com to automate your ad workflows
## Prerequisites
You need an active Admanage.ai account
1. Sign in to your AdManage account and navigate to the [API Keys page](https://admanage.ai/connect)
2. Create a new API key by clicking "Create API Key"
3. Copy your API key
4. Go to your Make scenario and search for the Admanage app
5. Paste your API Key in the connection.
β
Congratulations You can now use any of the Admanage modules in your scenarios.
For more information about the upload endpoint and how to use it, check out our [API documentation](/api-references/upload).
# Multi-Placement: 4x5 (Feed) & 9x16 (Story)
Source: https://docs.admanage.ai/multi-placement
Learn how to create and configure multi-placement ads in AdManage. This guide covers loading media files, selecting multiple assets, grouping ads together, and managing placement variations for your multi-placement ads.
## Getting Started
Load your media by clicking the `Load Media` button
Select the files you want to use for your multi-placement ads
You can hold `shift` to select multiple files
## Auto Grouping β¨
The media files you select will be automatically grouped into the correct placements based on the file names.
The filenames must match exactly, only the placement identifier should be different. eg `AdManage_Image_10_4x5.png` and `AdManage_Image_10_9x16.png` will be grouped together.
#### Supported Patterns
Here are the placement identifier patterns that we support for automatic grouping:
| Square(Feed) | Portrait(Feed) | Vertical(Story) | Landscape(Wide) |
| ---------------------- | ------------------------ | ------------------------ | ------------------------- |
| filename\_`1x1`.png | filename\_`4x5`.png | filename\_`9x16`.png | filename\_`16x9`.png |
| filename\_`1_1`.jpg | filename\_`4_5`.jpg | filename\_`9_16`.jpg | filename\_`16x9`.jpg |
| filename\_`square`.png | filename\_`portrait`.png | filename\_`vertical`.png | filename\_`landscape`.png |
| filename\_`11`.png | filename\_`45`.png | filename\_`916`.png | filename\_`169`.png |
| filename\_`SQ`.png | filename\_`4:5`.png | filename\_`VT`.png | filename\_`16-9`.png |
| filename\_`Feed`.png | filename\_`4-5`.png | filename\_`Story`.png | filename\_`16:9`.png |
The following pixel dimensions are also supported:
| Square(Feed) | Portrait(Feed) | Vertical(Story) | Landscape(Wide) |
| --------------- | --------------- | --------------- | --------------- |
| `1080x1080`.png | `1080x1350`.png | `1080x1920`.png | `1920x1080`.png |
| `1080x1080`.jpg | `1080x1350`.jpg | `628x1200`.jpg | `1200x628`.png |
| | | | `1350x1080`.png |
* The format can appear at the start, middle, or end of the filename.
* The separators `-`, `_`, `~`, `:` are interchangeable in most patterns.
* Case is not sensitive (e.g., `SQ` or `sq`, `Story` or `STORY` work the same).
* For Instagram-style filenames, patterns like `instagram~post~-~1.jpg` and `instagram~story~-~1.jpg` are also supported.
* For pixel dimensions, the aspect ratio determines the placement category:
Square: ratio \~1:1 - Portrait: ratio between 0.7 and 0.9 - Vertical:ratio β€ 0.7 - Landscape: ratio β₯ 1.1
## Manual Grouping
In some situations, the media files you select may not be named correctly for automatic grouping. In this case, you can manually group the ads by clicking the `Set Multi-Placement` button.
Click the images you want to group together
Confirm the placement grouping by clicking `Group Selected Media` button
Click `Done` to save the changes
# Connect your notion account to Admanage.ai
Source: https://docs.admanage.ai/notion-integration
You'll learn how to use notion automations to upload ads to Admanage.ai automatically
You can generate a webhook link for notion on the [integrations page](https://admanage.ai/integrations/notion)
# Use Post ID & Creative ID for Existing Ads
Source: https://docs.admanage.ai/post-id-creative-id-existing-ads
How to launch ads with Post ID / Creative ID to keep social proof and engagement
### Select Existing Ads from Admanage Library
Load your existing ads by clicking the `Load Media` button
Select the existing ads you want to launch
You can hold `shift` to select multiple files
Click `Use Post Id/Creative Id`
### Select Existing Ads from Meta Ads Manager
Load your existing ads by clicking the `Load Media` button
Click `Existing Ads` tab
Select the existing Meta ads you want to launch
That's it! You can now launch your ads with existing Post ID / Creative ID and keep social proof and engagement.
# Re-Authenticate your Meta Ads and Pages on Admanage
Source: https://docs.admanage.ai/re_authenticate_your_meta_ads_and_pages_on_adamage
Learn how to re-authenticate your Meta Ads and Pages on AdManage to maintain access to your accounts and ensure uninterrupted ad management.
Click the `Settings` link in the sidebar
Click `Re-Authenticate Facebook`
Click `Edit previous settings.`
# Troubleshoot: Launch button disabled or greyed out
Source: https://docs.admanage.ai/troubleshoot-launch-button-disabled-or-greyed-out
You can hover over the launch button to see a tooltip with the reason why it's disabled or greyed out.
The most common reason for the launch button to be disabled / greyed out is that you haven't selected an Ad set.
Check that you have selected some media files to launch.
Also check that your ad copy is not empty.
> If you have selected an Ad set and media files but the launch button is still disabled / greyed out, please reach out to us on Slack and we'll help you out.
# How To Set Up Workspaces
Source: https://docs.admanage.ai/workspaces
# Understanding Workspaces in AdManage.ai
Workspaces in AdManage.ai provide a powerful way to organize and manage multiple Meta (Facebook) ad accounts. This feature is especially useful for agencies, marketing teams, and businesses that manage advertising across different brands or clients.
Workspaces in AdManage.ai allow you to manage multiple Meta (Facebook) ad accounts efficiently in one place. Each workspace can have its own Meta authentication token, enabling you to:
* Access different ad accounts across various Meta Business Managers
* Organize team members and their access levels
* Maintain separate settings and configurations for different clients or projects
* Switch between different ad accounts seamlessly
You can access and manage workspaces by visiting [admanage.ai/teams](https://admanage.ai/teams) or clicking on the workspace selector in the top navigation bar.
## Conclusion
Workspaces in AdManage.ai provide a powerful way to organize and manage your ad campaigns across multiple platforms. With the ability to create dedicated workspaces for different clients, campaigns, or teams, you can keep your ad management workflow organized and efficient.
Key benefits of using workspaces include:
* **Better Organization**: Separate your work by client, campaign type, or team
* **Improved Collaboration**: Share workspaces with team members for seamless collaboration
* **Streamlined Workflow**: Access all relevant campaigns, assets, and settings in one place
* **Enhanced Productivity**: Switch between different projects quickly without losing context
By following the steps outlined in this guide, you can effectively create, manage, and navigate between workspaces to optimize your ad management process. Whether you're an agency managing multiple clients or an in-house team handling various campaigns, workspaces will help you stay organized and efficient.
For additional support or questions about workspaces, reach out to our support team through the Slack channel linked in the navigation bar.
# Zapier Integration
Source: https://docs.admanage.ai/zapier
Connect AdManage to Zapier to automate your ad workflows
## Connect AdManage to Zapier
1. Sign in to your AdManage account and navigate to the [API Keys page](https://admanage.ai/connect)
2. Create a new API key by clicking "Create API Key"
3. Copy your API key
4. Go to [Zapier](https://zapier.com) and click "Create Zap"
5. Search for "AdManage" in the Zapier app store
6. Click on the AdManage app to add it to your Zap
7. Connect your AdManage account by pasting your API key
8. Select the action you want to perform with AdManage
For more information about the upload endpoint and how to use it, check out our [API documentation](/api-references/upload).