List Google Ads conversion actions

Changed on

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

Returns the conversion goals Base44 knows about on the app's Google Ads account.

These are Google's own goals, created when the app's conversion tracking was set up. They are read only, and match on category to tell which goal covers which kind of conversion. Get conversion stats reports what they have recorded.

conversion_id and conversion_label are empty until Google publishes the goal's tag, which takes a few minutes after the goal is created.

<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/conversion-actions

Request

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

Path parameters

app_idstring required

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

Response

The account's conversion goals.

idstring required

Base44's ID for the conversion action.

google_action_idstring required

Google Ads' own ID for the goal, as Google Ads reports it. Not the same as id.

action_namestring required

Name of the goal in Google Ads.

categorystring required

Google Ads conversion category, for example PURCHASE, ADD_TO_CART, SUBMIT_LEAD_FORM, or SIGN_UP.

action_typestring required

Google Ads conversion type. WEBPAGE for the goals Base44 creates. Empty on goals created before Base44 recorded the type.

conversion_idstring required

The gtag conversion ID for the goal. Empty until Google publishes the tag.

conversion_labelstring required

The gtag conversion label for the goal. Empty until Google publishes the tag.

Example response

[
  {
    "id": "68b1c0d4e7b91d003c45a1f6",
    "google_action_id": "7654321",
    "action_name": "Purchase",
    "category": "PURCHASE",
    "action_type": "WEBPAGE",
    "conversion_id": "AW-123456789",
    "conversion_label": "AbCdEfGhIj"
  }
]

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