Skip to main content

Batch Create and Edit Managed Groups with Templates

Use Excel templates to batch create or edit AI Managed Groups and view batch task results.

Batch Create and Edit Managed Groups with Templates

Batch create and edit managed groups with templates lets you use Excel to create or update multiple AI Managed Groups at once. This is useful when you need to migrate Campaigns in bulk, update AI Objectives, adjust AI Action Space switches, or manage Managed Group Budget across multiple managed groups.

With this feature, you can:

  • Batch create new AI Managed Groups and specify the final Campaign set for each managed group.

  • Batch edit Campaign list, AI Objective, AI Personality, AI Action Space switches, Managed Group Budget, and other settings for existing AI Managed Groups.

  • Let the system migrate Campaigns automatically when a Campaign already belongs to another managed group and validation passes.

  • View processing progress from the in-progress task entry, then check final results in notifications.

  • Get Profile ID, Managed Group ID, and Campaign ID from Custom Report before filling in the template.

Note: This feature is permission-based. If you do not see the batch create or batch edit entry on the AI Managed page, contact your customer success manager to confirm whether the feature is enabled for your account.

Use Cases

Create multiple managed groups in bulk: When you need to split managed groups by brand, product line, Campaign type, or operational objective, you can fill in multiple managed groups in one creation template.

Migrate Campaigns in bulk: If a Campaign already belongs to an existing managed group but needs to move to another one, fill in the final Campaign ID list for the target managed group. The system will migrate it after validation passes.

Update existing managed group settings in bulk: When you need to update targets, AI Personality, AI Action Space switches, or budgets for multiple managed groups, use the batch edit template and fill in only the fields you want to change.

Maintain managed group budgets in bulk: If you enter Managed Group Budget, the system reallocates budgets based on the current daily budget ratio of enabled Campaigns. If you leave it blank, no manual budget reallocation is triggered.

Before You Start

Understand the difference between the two templates

Batch create and batch edit use separate entries and separate templates.

Template

Use case

Input meaning

Batch managed group creation template

Create new AI Managed Groups

Each row represents a new managed group. Required fields define the full configuration of the new managed group.

Batch managed group editing template

Edit existing AI Managed Groups

Each row represents an existing managed group. Except for Profile ID and Managed Group ID, blank fields do not overwrite existing values.

In the creation template, Campaign ID list is the final complete Campaign set for the new managed group. In the editing template, Campaign ID list is also the final complete Campaign set after editing. If it is blank, the Campaign set is not changed.

Prepare a Custom Report

Before filling in the template, download a campaign-level report from Custom Report to get the IDs required by the template.

For batch creation, you need at least:

  • Profile ID

  • Campaign ID

For batch editing, you need at least:

  • Profile ID

  • Managed Group ID

  • Campaign ID, only when you need to update the Campaign set

Batch Create Managed Groups

Step 1: Download the creation template

1. Go to the AI Managed page under AI advertising optimization.

2. Click the Smart creation dropdown.

3. Select Batch create managed groups.

4. In the upload modal, click Download template.

The template contains two sheets:

  • Instructions: Explains how to fill in the template and reserves screenshot placeholders for Custom Report guidance.

  • Application Form: The sheet read by the system during upload. You only need to keep this sheet when uploading.

Note: Download the template that matches your current system language. The system identifies the Application Form sheet and column headers based on the current language.

Step 2: Fill in the Application Form

In the batch creation template, each row represents one new managed group. The following fields are required:

  • Managed Group AI Status: Select On or Off.

  • Managed Group Name: Enter the new managed group name. The maximum length is 200 characters.

  • Profile ID: Get it from the campaign-level report.

  • Campaign Type: Enter SP, SB, or SD. Campaigns in the same managed group must have the same Campaign type.

  • Campaign ID list: Enter the final Campaign IDs for the new managed group. Separate multiple IDs with commas.

  • Target ACoS/RoAS and Target Value: Do not enter the percent sign. For example, enter 15 for a 15% target ACoS.

  • AI Objective: Supported values are Drive Growth, Campaign Boost, and Maintain Stable Orders.

  • AI Personality: Supported values are 1 to 5.

  • Campaign name tag status: Enter Y or N.

The following fields are optional:

  • Managed Group Budget: If blank, the system fills it with the sum of current daily budgets of enabled Campaigns. If a value is entered, the system reallocates budgets based on the current daily budget ratio of enabled Campaigns.

  • AI Action Space switches: Enter Y to enable, N to disable, and leave blank to treat it as disabled. In creation, enabled action spaces use AI as the default optimization method.

  • ROAS Priority Mode: This field is placed immediately after Performance-based Bid Adjustment. If Y is entered but the effective conditions are not met, creation still succeeds, but the mode is not currently effective.

Step 3: Upload the template

1. Return to the Batch create managed groups modal.

2. Drag the file into the upload area, or click to select a file.

3. Make sure the file format is .xlsx or .xls and the file size is 10 MB or less.

4. Click Upload.

After upload, the system validates the file and each managed group. A single upload supports up to 500 managed groups.

Step 4: Wait for processing

After the upload succeeds, the system creates a batch asynchronous task and processes managed groups one by one.

Each managed group follows an all-or-nothing rule. If any field or Campaign in that managed group fails validation, the whole managed group fails and no changes are written. The task can still be partially successful.

If a Campaign already belongs to another managed group, the system removes it from the original managed group and adds it to the new managed group after validation passes.

Batch Edit Managed Groups

Step 1: Download the editing template

1. Go to the AI Managed page under AI advertising optimization.

2. Click the Smart creation dropdown.

3. Select Batch edit managed groups.

4. In the upload modal, click Download template.

The batch editing template is a blank template. It does not prefill all managed group data. You need to get IDs from Custom Report and fill in only the fields you want to edit.

Step 2: Fill in the identifying fields

Batch editing uses the following two fields to identify an existing managed group:

  • Profile ID: Get it from the campaign-level report.

  • Managed Group ID: Get it from the campaign-level report.

If Profile ID + Managed Group ID cannot identify one unique managed group, the managed group in that row fails.

Step 3: Fill in the fields you want to change

Batch editing uses partial overwrite:

  • Fields with values in Excel are included in this edit.

  • Blank fields in Excel do not overwrite existing values.

Common editable fields include:

  • Managed Group AI Status: Enter On or Off. Leave blank for no overwrite.

  • Campaign ID list: If filled, it becomes the final complete Campaign set after editing. If blank, the Campaign set is not changed.

  • Target ACoS/RoAS and Target Value: To update the target, both fields must be filled in. Filling in only one of them causes the managed group to fail.

  • AI Objective: Supported values are Drive Growth, Campaign Boost, and Maintain Stable Orders.

  • AI Personality: Supported values are 1 to 5.

  • Campaign name tag status: Enter Y or N. Leave blank for no overwrite.

  • Managed Group Budget: If filled, it triggers budget reallocation. If blank, no manual budget reallocation is triggered.

  • AI Action Space switches: Enter Y or N to overwrite. Leave blank for no overwrite. Editing an action space changes only the switch, not the optimization method or rule content.

  • ROAS Priority Mode: Enter Y or N to overwrite. Leave blank for no overwrite.

Step 4: Upload the template

1. Return to the Batch edit managed groups modal.

2. Upload the completed .xlsx or .xls file.

3. Click Upload.

The system validates the managed group object, field values, and Campaign set row by row. If any field or Campaign in a managed group fails validation, the whole managed group fails and no changes are made.

View Task Progress and Results

View tasks in progress

After the task is submitted, you can open the in-progress task from the upload success modal. You can also find the in-progress task entry next to the Smart creation button.

The in-progress task entry only shows unfinished tasks submitted by the current user. If multiple Excel tasks are in progress, they share one entry, and you can switch between them after opening it.

The in-progress task details show:

  • Task type

  • Uploaded file name

  • Task status

  • Total managed groups

  • Processed managed groups

  • Refresh entry

View final results

After a task is complete, it is removed from the in-progress entry. The system sends a notification where you can view the final result.

The notification shows:

  • Task type

  • Task status

  • Total count, success count, and failure count

  • Success or failure status for each managed group

  • Failure reason summary

Task statuses include All succeeded, Partially succeeded, and All failed. Downloading failure details as Excel is not supported in the first version.

Common Failure Reasons

Type

Common reason

What to do

File error

The file is not .xlsx or .xls, exceeds 10 MB, or cannot be parsed

Download the latest template and upload again

Template error

Application Form is missing, column headers were changed, required columns are missing, or the upload contains more than 500 managed groups

Download the latest template, keep the Application Form sheet, and check column headers

Object error

Profile ID + Managed Group ID cannot identify one unique managed group during batch editing

Confirm IDs in the campaign-level report

Campaign error

Campaign does not exist, does not belong to the current Profile, has inconsistent Campaign type, or is ended or archived

Check Campaign ID list and remove unsupported Campaigns

Cross-group conflict

The same Campaign appears in multiple target managed groups in one uploaded file

Adjust Campaign ID list so that one Campaign appears in only one target managed group

Field error

Invalid enum value, AI Personality is not between 1 and 5, or managed group name exceeds 200 characters

Correct fields based on the template instructions

Target error

Target ACoS/RoAS and Target Value are not filled in together, or Target Value format is invalid

Fill in both target type and target value, and do not enter the percent sign

Budget error

Managed Group Budget is outside the allowed range, or there is no enabled Campaign to allocate budget

Adjust the budget value, or confirm that the managed group has enabled Campaigns

Permission error

The current account does not have permission for batch creation, batch editing, or the related Profile

Contact your admin or customer success manager to confirm permissions

FAQ

Q: Can batch creation and batch editing use the same template?

A: No. Batch creation creates new managed groups, while batch editing updates existing managed groups. The required fields and blank-cell meanings are different. Download the corresponding template for each entry.

Q: Why is the batch editing template not prefilled?

A: Batch editing uses a blank template and partial overwrite. You only fill in the fields you want to change, and blank fields do not overwrite existing values. This avoids exporting all managed group configurations and reduces the risk of unintended changes.

Q: If Campaign ID list is blank in the editing template, will it clear Campaigns in the managed group?

A: No. In batch editing, a blank Campaign ID list means the Campaign set is not changed. Only when Campaign ID list is filled does the system treat it as the final complete Campaign set after editing.

Q: Will upload fail if a Campaign already belongs to another managed group?

A: Not necessarily. If the Campaign is valid and the managed group passes validation, the system automatically removes it from the original managed group and adds it to the target managed group. If the same uploaded file assigns the same Campaign to multiple target managed groups, the related managed groups fail.

Q: Can batch editing change the optimization method of an AI Action Space?

A: No. Batch editing only changes AI Action Space switches. It does not switch optimization methods or edit rule content. If the original optimization method is rule-based, disabling and enabling it again keeps the original rule content.

Q: What happens if Managed Group Budget is blank?

A: In batch creation, the system fills it with the sum of current daily budgets of enabled Campaigns. In batch editing, leaving it blank does not trigger manual budget reallocation. If this edit changes the enabled Campaign set, the displayed managed group budget changes naturally with the Campaign set.

Q: Why can I not see the final result immediately after upload succeeds?

A: Upload success only means the task has been submitted. It does not mean all managed groups have finished processing. Check the in-progress task first, then view final results and failure reason summaries in notifications after the task is complete.

Q: Can I edit managed groups whose AI Status is disabled through the template?

A: Yes. As long as the managed group exists, you can edit its settings through the batch editing template even when AI Status is disabled.

Did this answer your question?