List Google Ads asset performance

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance"

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "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",
    "campaign": "Spring sale - Performance Max",
    "asset_group_id": "9988776655",
    "asset_group_name": "Spring sale - Asset Group",
    "ad_strength": "GOOD",
    "primary_status": "ELIGIBLE",
    "performance_label": "LEARNING",
    "video_id": "dQw4w9WgXcQ",
    "primary_status_reasons": [
      "TRADEMARKS_IN_AD_TEXT"
    ],
    "policy_topics": [
      "TRADEMARKS_IN_AD_TEXT"
    ],
    "impressions": 18400,
    "clicks": 612,
    "cost_micros": 412500000
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Reporting

List Google Ads asset performance

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

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 attach to the campaign instead, so they have no asset group, no policy topics and no metrics at all. 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.

Performance Max campaigns only. An account without one returns an empty list.

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

The response includes fields beyond the ones documented here. Don’t rely on undocumented response fields, as they can change at any time.

GET

api

apps

{app_id}

google-ads

analytics

asset-performance

List Google Ads asset performance

curl --request GET \
  --url https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance \
  --header 'api_key: <api-key>'

import requests

url = "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance"

headers = {"api_key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {api_key: '<api-key>'}};

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "api_key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api_key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.base44.com/api/apps/{app_id}/google-ads/analytics/asset-performance")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api_key"] = '<api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "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",
    "campaign": "Spring sale - Performance Max",
    "asset_group_id": "9988776655",
    "asset_group_name": "Spring sale - Asset Group",
    "ad_strength": "GOOD",
    "primary_status": "ELIGIBLE",
    "performance_label": "LEARNING",
    "video_id": "dQw4w9WgXcQ",
    "primary_status_reasons": [
      "TRADEMARKS_IN_AD_TEXT"
    ],
    "policy_topics": [
      "TRADEMARKS_IN_AD_TEXT"
    ],
    "impressions": 18400,
    "clicks": 612,
    "cost_micros": 412500000
  }
]

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

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

Response

One entry per serving asset, grouped by its role.

resource_name

string

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.

Example:

"customers/1234567890/assetGroupAssets/2145881234~9988776655~HEADLINE"

field_type

string

required

The role the asset plays, for example HEADLINE, LONG_HEADLINE, DESCRIPTION, MARKETING_IMAGE, LOGO, or YOUTUBE_VIDEO.

Example:

"HEADLINE"

text

string

required

The asset's text. Empty for images, logos and videos.

Example:

"Handmade oak furniture"

asset_name

string

required

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

Example:

"spring-hero-1200x628"

type

string

required

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

Example:

"TEXT"

image_url

string

required

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

Example:

"https://tpc.googlesyndication.com/simgad/1234567890"

campaign

string

required

Name of the campaign the asset serves in.

Example:

"Spring sale - Performance Max"

asset_group_id

string

required

ID of the asset group the asset belongs to. Empty for logos, which attach to the campaign instead.

Example:

"9988776655"

asset_group_name

string

required

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

Example:

"Spring sale - Asset Group"

ad_strength

string

required

Google Ads' strength rating for the asset group: POOR, AVERAGE, GOOD, EXCELLENT, or PENDING. Empty for logos.

Example:

"GOOD"

primary_status

string

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.

Example:

"ELIGIBLE"

performance_label

string

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 logos and for rows Base44 synthesized from launch creative.

Example:

"LEARNING"

video_id

string | null

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

Example:

"dQw4w9WgXcQ"

primary_status_reasons

string[]

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

Example:

["TRADEMARKS_IN_AD_TEXT"]

policy_topics

string[]

The Google Ads policy topics limiting the asset, without the generic status reasons primary_status_reasons also carries. Always empty for logos, which expose no policy detail, and absent on rows Base44 synthesized from launch creative.

Example:

["TRADEMARKS_IN_AD_TEXT"]

impressions

integer | null

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

Example:

18400

clicks

integer | null

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

Example:

612

cost_micros

integer | null

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

Example:

412500000

⌘I

App Management API (Beta)

Entities API (Beta)

Virality API (Beta)

Workflows API (Beta)

Analytics API (Beta)

Google Ads API (Beta)

Monitoring API

Audit Logs API

List Google Ads asset performance

Authorizations

Path Parameters

Response