Implement suggestions for a campaign optimization

Implements the latest optimization suggestions for a campaign optimization. Required permission: write:analysis.

Platform-Specific Behavior:

Google Ads:

• The details field is optional and can contain an asset_groups array to filter which asset groups to process.
• If details.asset_groups is provided, only suggestions for the specified asset groups will be implemented.
• If details is omitted or asset_groups is not specified, all suggestions will be implemented.
• Partial failures are handled gracefully: if one asset group fails, the others still proceed.

TikTok:

• The details field is not used and can be omitted.
• All ad groups specified in campaign_optimization.campaign.ad_group_ids will be updated.

Response Body (Google Ads):

{
  "updated_count": 2,
  "total_asset_groups": 3,
  "results": [
    { "asset_group_id": "6476435676", "status": "success" },
    { "asset_group_id": "6481074503", "status": "success" },
    { "asset_group_id": "6477355033", "status": "failed", "error": "Failed to add search theme 'xyz'" }
  ]
}

Response fields:

• updated_count (int): Number of asset groups where all suggestions were applied successfully.
• total_asset_groups (int): Total number of asset groups in the suggestion (not just those requested via details).
• results (array): Per-asset-group outcome.
  • asset_group_id (string): The asset group ID.
  • status (string): success or failed.
  • error (string, optional): Error message, only present when status is failed.

POST /v1/organizations/{organization_id}/workspaces/{workspace_id}/campaign_optimizations/{id}/implement_suggestions

cURL

GoogleAds-AllAssetGroups

curl --request POST \
  --url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/campaign_optimizations/{id}/implement_suggestions \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "updated_count": 123,
  "total_asset_groups": 123,
  "results": [
    {
      "asset_group_id": "<string>",
      "error": "<string>"
    }
  ]
}

Authorizations

Authorization · string · header · required

Path Parameters

campaign_optimization_id · string<uuid> · required

A UUID string identifying the campaign optimization.

id · string<uuid> · required

A UUID string identifying this campaign optimization.

organization_id · string · required

workspace_id · string<uuid> · required

Query Parameters

format · enum<string>

Available options: csv, json

Body

application/jsonapplication/x-www-form-urlencodedmultipart/form-data*/*

details · any

Platform-specific details for implementing suggestions.

Response

200

application/json

Suggestions implemented. Body: updated_count, total_asset_groups, results[].

updated_count · integer · required

total_asset_groups · integer · required

results · object[] · required

Show child attributes