Create campaign optimization

Create a new campaign optimization. Required permission: write:analysis.

Top-level optional field (Google Ads only):

• promotion_type (optional): Optimisation intent. Values: Product, Service, Brand (case-insensitive). Stored as campaign.intent (lowercase). Ignored for TikTok.

Google Ads enrichment: On creation, Jarvis fetches live metadata from Google Ads for each asset group and stores it in campaign.asset_group_info (ad strength, status, search themes count, campaign name). The client only needs to send asset_group_info with name; the backend fills the rest.

Campaign Field Structure (campaign JSON)

The campaign field is a free-form JSON object whose structure depends on the platform.

Google Ads (PMax):

{
  "customer_id": "1447066043/8965287694",
  "asset_group_ids": ["6476435676", "6481074503"],
  "intent": "product",
  "asset_group_info": {
    "6476435676": {
      "name": "Animalerie",
      "ad_strength": "POOR",
      "ad_strength_score": 10,
      "ad_strength_max": 25,
      "search_themes_count": 0,
      "campaign_name": "PMax: IKOM - Smart Shopping CSS",
      "status": "ENABLED"
    }
  }
}

Fields:

• customer_id (string): Google Ads customer ID, format "manager_id/account_id" or "account_id".
• asset_group_ids (string[]): Asset group IDs selected for optimization.
• intent (string, optional): Optimization intent (product, service, brand). Set from promotion_type.
• asset_group_info (object): Mapping of asset group ID to metadata. Enriched with live Google Ads data at creation:
  • name (string): Asset group name.
  • ad_strength (string): Google Ads enum — EXCELLENT, GOOD, AVERAGE, POOR, PENDING, UNKNOWN, UNSPECIFIED, NO_ADS.
  • ad_strength_score (int): Numeric score — EXCELLENT=25, GOOD=20, AVERAGE=15, POOR=10, all others=0.
  • ad_strength_max (int): Always 25 (max possible score).
  • search_themes_count (int): Number of search theme signals currently on the asset group in Google Ads.
  • campaign_name (string): Parent PMax campaign name.
  • status (string): Asset group status — ENABLED, PAUSED, REMOVED, etc.

Use POST .../refresh to re-fetch asset_group_info from Google Ads without re-running the optimization pipeline.

TikTok:

{
  "advertiser_id": "7052316759499587586",
  "campaign_id": "1850667377518002",
  "ad_group_ids": ["1850939823278113", "1850667437045906"]
}

Fields:

• advertiser_id (string): TikTok advertiser account ID.
• campaign_id (string): TikTok campaign ID.
• ad_group_ids (string[]): Ad group IDs to optimize (non-empty).

TikTok campaign objects do not include asset_group_info or enrichment fields.