Advertising Configurations All file - Explained

Advertising Configurations All File - Knowledge Base

Overview

The Advertising Configurations All file enables:

• The creation of a full campaign hierarchy, including campaigns, ad groups, product ads, keywords, and targets.
• The update of a full campaign hierarchy.

Functionality

• The column Operation supports CREATE and UPDATE actions.
• If the Operation column is missing, the file functions as usual without affecting current processes.

Operation Column Behavior

• Empty value: No action is taken.
• CREATE: Creates a new entity (based on the Hierarchy Creation criteria below).
• UPDATE: Updates an entity if a valid Record ID is provided.

---

Hierarchy Creation

To establish relationships between entities, use temporary IDs in the following format:

• T (any letter will work) followed by a number (e.g., T1, T2, T3).

Hierarchy Structure:

1. Campaign → 2. Ad Group → 3. Keyword/Product Ad → 4. Target

Example:

• Campaign T1 connects to Ad Group T2, which connects to Keyword T3.

---

Mandatory Fields

Creating a Campaign

Record ID	Record Type	Campaign Name	Operation	Campaign Type	Start Date	Budget	Status
T1	Campaign	Profit Maximization	CREATE	sponsoredProducts	2024-08-14	4.16	Enabled

 

Creating an Ad Group

Record ID	Record Type	Campaign ID	Operation	Ad Group Name	Status
T2	Ad Group	T1	CREATE	New Ad Group	Enabled

 

Creating a Keyword

Record ID	Record Type	Campaign ID	Operation	Ad Group ID	Keyword	Match Type	Status
T3	Keyword	T1	CREATE	T2	Best shoes	Phrase	Enabled

 

Creating a Product Ad

Record ID	Record Type	Campaign ID	Operation	Ad Group ID	SKU	ASIN	Status
T4	Product Ad	T1	CREATE	T2	V19742-10	B07RDMCLZ2	Enabled

Creating a Target

Record ID	Record Type	Campaign ID	Operation	Ad Group ID	Product Targeting	Status
T5	Product Targeting	T1	CREATE	T2	asin="B00AETVUA6"	Enabled

Additional Notes

Temporary IDs

• Temporary IDs (e.g., T1, T2) establish parent-child relationships.

Mixed Operations

• Rows with CREATE create entities.
• Rows with UPDATE modify existing entities (must include a Record ID).

Error Handling

• A missing parent temporary ID will log an error.
• Ad groups cannot contain both keywords and targets; the first type added determines behavior.
• An UPDATE operation with an empty Record ID will result in an error.

Tooltip Guidance

• Tooltips in the export file explain mandatory fields for each entity.

---

API Parameters 

Summary of the unique parameters required for the export and import of the Advertising Configurations All file.

Export Parameters

Parameter	Type	Required	Acceptable Values
reportType	string	Yes	AMAZON_ADVERTISING_ALL
reportSubType	string	Yes	{ONLY_CAMPAIGNS_ALL, ALL}
type	string	Yes	{XLSX, CSV}

Import Parameters

Parameter	Type	Required	Acceptable Values
fileName	string	Yes	File name for import
importType	string	Yes	AMAZON_ADVERTISING
importSubType	string	Yes	IMPORT_ALL

Usage Guidelines

1. Export a file to understand the required format.
2. Alternatively, export a template file for reference.
3. Include the Operation column with one of the following values:
   • CREATE: To create new entities.
   • UPDATE: To update existing entities.
4. Use Temporary IDs (e.g., T1, T2, T3) to link hierarchy levels:
   • Campaign → Ad Group → Keyword/Product Ad → Target.

---

For any additional questions or clarifications, please reach out to our Technical Support team.