Skip to documentation content
Advertising and analytics

Connect Google Ads (legacy key configuration)

Forward conversions through the older Google Ads configuration.

All connectors · Checked against AXO’s implementation in October 2026.

Prepare access

Use an owner or admin account in AXO and confirm the selected site. Have permission to authorize the external account or create its server credentials. Keep secrets in the connector’s protected configuration.

SettingValue to prepare
customer_idCustomer ID.
conversion_action_idNumeric conversion-action ID.
api_keyOAuth access token, despite the form’s API key label.
developer_tokenLegacy deployment/config value required by AXO’s check.

Connect

The current catalog form does not expose the full configuration for this connector. Use Advanced setup below before completing these steps.

  1. Prefer the Google Ads Enhanced Conversions connector for a refreshable Google authorization.
  2. For an existing legacy connection, verify customer and conversion-action IDs before enabling conversion forwarding.

Verify the result

The check uses a validation-only upload with a synthetic click ID. It requires a developer token and access token.

Record the AXO integration or trigger result and the receiving system’s result. A saved configuration, credential check, and completed delivery establish different things. Use a controlled destination for a test that writes data or sends a message.

Fix a failed connection

The drawer does not expose every legacy setting. Use the advanced configuration procedure below to repair an existing connection, or migrate to the OAuth connector.

For a saved catalog connector, open Health to read the latest error, then repair the settings through the setup method on this page. Pause delivery while correcting an unintended destination. Reconnect OAuth when its grant is revoked; for key-based connections, save the replacement key, verify it, then revoke the old key at the provider.

Advanced setup with an AXO MCP client

  1. Connect the AXO MCP server with write access to the intended site. The authenticated account must have owner/admin permission.
  2. Call create_integration with the type below and a config object using the exact field names above. Start with active: false and no event subscriptions. Supply credential values through your protected tool configuration.
  3. Keep the returned integration ID. Use update_integration for corrections rather than creating duplicates.
  4. Complete any authorization steps above, configure the trigger or source, and perform the verification described here. Source imports need the integration enabled before scheduled synchronization can run. Use test_integration only if this guide describes a supported test.
  5. Use update_integration with the returned integration_id and active: true to enable the integration after checking its external account and payload. Enable the intended trigger separately. Copy expected_revision from the latest get_integration read when one is returned.
Create integration arguments
{
  "type": "google_capi",
  "config": {
    "customer_id": "REPLACE_WITH_YOUR_VALUE",
    "conversion_action_id": "REPLACE_WITH_YOUR_VALUE",
    "api_key": "REPLACE_WITH_YOUR_VALUE",
    "developer_token": "REPLACE_WITH_YOUR_VALUE"
  },
  "events": [],
  "active": false
}

The example is a configuration checklist. Replace placeholders and omit optional or inapplicable fields before calling the tool. A dry run previews the request but does not validate provider access.

Next: create an event-triggered action, or implement a webhook receiver.