Sign in
Ad Campaigns

List Google Ads recommendations

Changed on

Google's optimization recommendations for one ad account: type, estimated impact (base vs potential metrics, cost in account currency units), the campaign, ad group or budget they target, and the type-specific payload Google returns (details, in Google's own shape with micros). Filter by campaignId and types. Cached for 10 minutes and cleared by apply or dismiss; served stale when Google quota is exhausted.

get/v1/ads/recommendations

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/ads/recommendations
  • Auth: HTTP bearer

Query parameters

accountIdstring required

Google ads SocialAccount id.

adAccountIdstring

Google customer id, digits only. Defaults to the connection's only customer.

customerIdstring

Alias of adAccountId, kept for consistency with other Google endpoints.

campaignIdstring

Only recommendations targeting this campaign.

typesstring

Comma-separated Google RecommendationType values, for example CAMPAIGN_BUDGET,KEYWORD,SET_TARGET_CPA.

Response

Recommendations.

adAccountIdstring required
cachedAtstring date-time nullable required
staleboolean required

Example response

{
  "recommendations": [
    {
      "resourceName": "customers/9122445560/recommendations/NjgzMzAxODc4NS0yNDItMTc5MDQzODQxMDc1NC0rMjQxOTE1ODU2NzEtMA",
      "id": "NjgzMzAxODc4NS0yNDItMTc5MDQzODQxMDc1NC0rMjQxOTE1ODU2NzEtMA",
      "type": "FORECASTING_SET_TARGET_CPA",
      "dismissed": false,
      "campaignId": "24191585671",
      "campaignIds": [
        "24191585671"
      ],
      "adGroupId": null,
      "campaignBudgetId": null,
      "impact": {
        "base": {
          "impressions": 2790,
          "clicks": 87,
          "cost": 420,
          "conversions": 3.96,
          "conversionsValue": 0,
          "videoViews": 0
        },
        "potential": {
          "impressions": 5909,
          "clicks": 185,
          "cost": 889.58,
          "conversions": 8.39,
          "conversionsValue": 0,
          "videoViews": 0
        }
      },
      "details": {
        "recommendedTargetCpaMicros": "105420000",
        "campaignBudget": {
          "currentAmountMicros": "60000000",
          "recommendedNewAmountMicros": "140000000",
          "newStartDate": "2026-10-01"
        }
      }
    }
  ]
}

Changes

  • f8c8f34fb41aRevision changes
    • ●

      added the new account enum value to the / response property for the response status

    • ●

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status

    • ○

      added the optional property to the response with the status