Scan Google Ads conversion tracking

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

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/tracking-scan', 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/tracking-scan",
  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/tracking-scan"

	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/tracking-scan")

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

{
  "gaps": [],
  "mappings_count": 3,
  "calls_count": 0,
  "is_clean": false,
  "enabled_mappings_count": 2,
  "skipped_reason": "no_google_ads_account"
}

Conversions

Scan Google Ads conversion tracking

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

Cross-references the app’s conversion mappings against the conversion calls in its code, and reports what does not line up.

Each entry in gaps names one problem. An error is a mapped conversion that cannot fire, and a warning is a setup that works but probably is not what you meant, such as a disabled mapping or code firing a goal no mapping points at. A missing-call- gap also carries a composer_prompt you can hand to Send chat message to have the AI write the fix.

Treat error gaps and calls_count as unverified. The scan reads the app’s code from a copy that is empty for apps built in the current editor, so it reports calls_count as 0 and raises a missing-call- gap for every enabled mapping even when the call is present and working. Base44’s own alerting re-checks these against the deployed app before acting on them, and this endpoint does not. Confirm a missing-call- gap against the app’s real code before changing anything, and do not read calls_count as evidence that no conversions fire.

is_clean is true when nothing was scanned, so read skipped_reason first. An app with no Google Ads account comes back with is_clean set to true, no gaps, and skipped_reason set to no_google_ads_account, which is not a clean bill of health. That response also omits enabled_mappings_count.

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

tracking-scan

Scan Google Ads conversion tracking

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

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

fetch('https://app.base44.com/api/apps/{app_id}/google-ads/tracking-scan', 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/tracking-scan",
  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/tracking-scan"

	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/tracking-scan")

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

{
  "gaps": [],
  "mappings_count": 3,
  "calls_count": 0,
  "is_clean": false,
  "enabled_mappings_count": 2,
  "skipped_reason": "no_google_ads_account"
}

Authorizations

api_key

string

header

required

Personal API key.

Path Parameters

app_id

string

required

ID of the app whose Google Ads conversion tracking you want to manage.

Response

What the scan found.

What the conversion-tracking scan found.

gaps

TrackingGap · object[]

required

Everything the scan flagged. Empty when it found nothing and when it did not run, which skipped_reason tells apart.

Show child attributes

Example:

[]

mappings_count

integer

required

How many conversion mappings the account has, enabled or not.

Example:

3

calls_count

integer

required

How many gtag conversion calls the scan found in the app's code. See the warning on this operation before reading it as zero.

Example:

0

is_clean

boolean

required

Whether the scan flagged no error-severity gap (true) or at least one (false). It also reads true when the scan did not run at all, so check skipped_reason first.

Example:

false

enabled_mappings_count

integer | null

How many of the mappings are enabled. Absent when skipped_reason is set.

Example:

2

skipped_reason

string | null

Why nothing was scanned. The value is no_google_ads_account when the app has no active Google Ads account, or app_not_found. The field is absent whenever a scan ran.

Example:

"no_google_ads_account"

Overview

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

Scan Google Ads conversion tracking

Authorizations

Path Parameters

Response