> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tess.im/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Step | Meta Ads

The Meta Ads step allows your agents to analyze performance, identify wasted budget, and automatically redistribute investment across Facebook and Instagram campaigns. With this, Tess acts as a data-driven paid media optimizer.

### **What is the Step?**

The integration with Meta Ads provides 6 actions, divided into:

### Actions (execution)

* Change Campaign Daily Budget → changes the daily budget
* Change Campaign Status → enables or pauses campaigns
* Budget Shift Campaigns → automatically redistributes budget

### Analysis (insights)

* Creative Image Analysis → analyzes creatives (images)
* Identify Overactive Ads → identifies ad fatigue
* Metrics Trend Report → analyzes performance trends

## **How to use (Fields per action)**

### 1. Change Campaign Daily Budget

| Field                   | Description                                          |
| :---------------------- | :--------------------------------------------------- |
| Step Name               | Internal step name                                   |
| Ad Account ID \*        | Meta ads account ID                                  |
| Campaign ID \*          | Campaign ID to be changed                            |
| Budget Change Method \* | Method: `Set Exact Amount` or `Adjust by Percentage` |
| Budget Change Value \*  | Change value (e.g.: `100.00`, `30`, `-20`)           |

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/4hvEV5IAIaKBKh5o/images/image-191.png?fit=max&auto=format&n=4hvEV5IAIaKBKh5o&q=85&s=e4d46433a06693739d09af95575f9b98" alt="Image" title="Image" style={{ width:"45%" }} width="952" height="1216" data-path="images/image-191.png" />
</Frame>

***

### 2. Change Campaign Status

| Field                  | Description                     |
| :--------------------- | :------------------------------ |
| Step Name              | Internal step name              |
| Ad Account ID \*       | Ads account ID                  |
| Campaign ID \*         | Campaign ID                     |
| New Campaign Status \* | New status (`ACTIVE`, `PAUSED`) |

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/4hvEV5IAIaKBKh5o/images/image-192.png?fit=max&auto=format&n=4hvEV5IAIaKBKh5o&q=85&s=eb6c9584ce3d8f0c2e00a2ea4b8953f0" alt="Image" style={{ width:"68%" }} width="930" height="1056" data-path="images/image-192.png" />
</Frame>

***

### 3. Budget Shift Campaigns

| Field                        | Description                                           |
| :--------------------------- | :---------------------------------------------------- |
| Step Name                    | Internal step name                                    |
| Meta Ads Account ID \*       | Ads account ID                                        |
| Analysis Period (Days) \*    | Analysis period (e.g.: `30`)                          |
| Has New Budget Allocation \* | Defines if there will be a new budget (`Yes` or `No`) |
| New Budget                   | New total value (e.g.: `2500.00`)                     |
| Percent Adjust               | Percentage adjustment (e.g.: `20` or `20%`)           |
| Excluded Campaigns ID        | Excluded campaign IDs                                 |
| Excluded Adsets ID           | Excluded ad set IDs                                   |

***

### 4. Creative Image Analysis

| Field                     | Description        |
| :------------------------ | :----------------- |
| Step Name                 | Internal step name |
| Meta Ads Account ID \*    | Ads account ID     |
| Analysis Period (Days) \* | Period analyzed    |

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/4hvEV5IAIaKBKh5o/images/image-194.png?fit=max&auto=format&n=4hvEV5IAIaKBKh5o&q=85&s=fe5dc0200481e20ad6bf3c15790056b0" alt="Image" style={{ width:"70%" }} width="922" height="886" data-path="images/image-194.png" />
</Frame>

***

### **5. Identify Overactive Ads**

| Field           | Description                            |
| :-------------- | :------------------------------------- |
| Step Name       | Internal step name                     |
| Account ID \*   | Account ID                             |
| Limit (Days) \* | Days limit to consider it "overactive" |

<Frame>
  <img src="https://mintcdn.com/tess-dfe1edf0/4hvEV5IAIaKBKh5o/images/image-195.png?fit=max&auto=format&n=4hvEV5IAIaKBKh5o&q=85&s=1f0f17fc7b839ce1e981950469957b10" alt="Image" style={{ width:"63%" }} width="942" height="884" data-path="images/image-195.png" />
</Frame>

***

### 6. Metrics Trend Report

| Field                              | Description                              |
| :--------------------------------- | :--------------------------------------- |
| Step Name                          | Internal step name                       |
| Meta Ads Account ID \*             | Account ID                               |
| Analysis Period (Days) \*          | Period analyzed                          |
| Report Segment \*                  | Segment (e.g.: `campaigns`, `adsets`)    |
| Key Performance Indicator (KPI) \* | Main metric (e.g.: `cpa`, `cpr`, `roas`) |

***

## Practical examples

* Automatically reduce budget on low-performing campaigns
* Identify saturated creatives
* Redistribute budget across campaigns
* Generate automatic performance reports

<Tip>
  Best practices

  * Always validate IDs
  * Use consistent periods (e.g., 30 days)
  * Define clear KPIs
  * Be careful with budget automations
</Tip>

## Important notes

* Meta Ads integration is required
* Actions impact real campaigns
* There is no confirmation prior to execution

Meta Ads transforms Tess into a complete paid media operator, capable of analyzing, detecting issues, and executing optimizations automatically.