List Google Ads asset performance

Changed on

<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns every serving creative asset in the account's Performance Max campaigns, with its status, any policy limits, and its traffic over the trailing 30 days.

The 30-day window is fixed and does not follow a date parameter.

Google attributes Performance Max metrics per served asset, so these numbers do not add up to the asset group's or campaign's totals. Use them to rank creatives against each other, not to reconcile spend.

Three kinds of row arrive in one list. Assets inside an asset group carry the full shape. Logos, business names, sitelinks and call assets attach to the campaign instead, so they have no asset group and no metrics; their policy_topics come from the asset itself and are often empty. Business names, sitelinks and call assets come last in the list. A campaign Google has not echoed back yet contributes rows built from the creative Base44 sent at launch, with a primary_status of GATHERING_DATA, an empty performance_label and no metrics.

<Note>Performance Max campaigns only. An account without one returns an empty list.</Note>

<Note>This endpoint accepts a personal API key. Workspace API keys are not authorized for it and are rejected with a 403.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

get/api/apps/{app_id}/google-ads/analytics/asset-performance

Request

  • Base URL: https://app.base44.com
  • URL: https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance
  • Auth: HTTP bearer

Path parameters

app_idstring required

ID of the app whose Google Ads reporting you want to read.

Response

One entry per serving asset, grouped by its role.

resource_namestring required

Google Ads resource name for the asset's link to its asset group or campaign. Empty on rows Base44 synthesized from the campaign's saved creative.

field_typestring required

The role the asset plays, for example HEADLINE, LONG_HEADLINE, DESCRIPTION, MARKETING_IMAGE, LOGO, or YOUTUBE_VIDEO, or, for an asset attached to the campaign, BUSINESS_NAME, SITELINK or CALL.

textstring required

The asset's text: the headline or description, the business name, the sitelink's link text, or the call asset's phone number. Empty for images, logos and videos.

asset_namestring required

Google Ads' own name for the asset. Usually the only label an image, logo or video has.

typestring required

Google Ads asset type, for example TEXT, IMAGE, or YOUTUBE_VIDEO.

image_urlstring required

Hosted URL for an image or logo asset. Empty for text and video assets.

video_idstring nullable

YouTube video ID for a YOUTUBE_VIDEO asset. Empty on other assets in an asset group, and absent entirely on assets attached to the campaign and on rows Base44 synthesized from launch creative.

campaignstring required

Name of the campaign the asset serves in.

asset_group_idstring required

ID of the asset group the asset belongs to. Empty for logos, business names, sitelinks and call assets, which attach to the campaign instead.

asset_group_namestring required

Name of that asset group. Empty for the same reason.

ad_strengthstring required

Google Ads' strength rating for the asset group: POOR, AVERAGE, GOOD, EXCELLENT, or PENDING. Empty for assets attached to the campaign.

primary_statusstring required

Whether the asset can serve, for example ELIGIBLE, LIMITED, DISAPPROVED, or PENDING_REVIEW. GATHERING_DATA is Base44's own value, used on a row synthesized from launch creative that Google has not echoed back yet.

primary_status_reasonsstring[]

Why the asset is limited or disapproved. Empty when it serves normally.

policy_topicsstring[]

The Google Ads policy topics limiting the asset, without the generic status reasons primary_status_reasons also carries. Taken from the asset itself for assets attached to the campaign, where Google often names none (a limited logo usually carries no topic), and absent on rows Base44 synthesized from launch creative.

performance_labelstring required

Base44's own band for the asset, since Google publishes no per-asset rating for Performance Max: LEARNING while the campaign is still in its launch window, then LOW, GOOD or EXCELLENT from the asset's click-through rate against a threshold for its field type. PENDING and DISAPPROVED pass the serving status through instead. Empty when the asset cannot be rated, which is permanent for assets attached to the campaign and for rows Base44 synthesized from launch creative.

impressionsinteger nullable

Impressions over the trailing 30 days. null when Google reported no row for the asset in that window, and absent entirely on assets attached to the campaign and on rows Base44 synthesized from saved creative.

clicksinteger nullable

Clicks over the same 30 days, with the same null and absent cases.

cost_microsinteger nullable

Spend over the same 30 days in micros, with the same null and absent cases.

Example response

[
  {
    "resource_name": "customers/1234567890/assetGroupAssets/2145881234~9988776655~HEADLINE",
    "field_type": "HEADLINE",
    "text": "Handmade oak furniture",
    "asset_name": "spring-hero-1200x628",
    "type": "TEXT",
    "image_url": "https://tpc.googlesyndication.com/simgad/1234567890",
    "video_id": "dQw4w9WgXcQ",
    "campaign": "Spring sale - Performance Max",
    "asset_group_id": "9988776655",
    "asset_group_name": "Spring sale - Asset Group",
    "ad_strength": "GOOD",
    "primary_status": "ELIGIBLE",
    "primary_status_reasons": [
      "TRADEMARKS_IN_AD_TEXT"
    ],
    "policy_topics": [
      "TRADEMARKS_IN_AD_TEXT"
    ],
    "performance_label": "LEARNING",
    "impressions": 18400,
    "clicks": 612,
    "cost_micros": 412500000
  }
]

Changes

  • b92cc2f13639Revision changes
    • info

      the security scope read_only was added to the endpoint's security scheme PersonalAccessTokenAuth

    • info

      the security scope full_access was removed from the endpoint's security scheme PersonalAccessTokenAuth

  • 5e139db2e643Revision changes
    • info

      the endpoint scheme security PersonalAccessTokenAuth was added to the API