Analytics Setup

Create a Google Ads destination

Changed on

Requires the google_ads:create scope and an existing business-owned Google connection. Creates an account asset without selecting a Purchase conversion. Select the receiving Purchase action independently for each store through its purchase_tracking.google_ads settings, using the revision from the latest store detail response. An account-only asset sends no Purchase conversions until selected in that store and assigned to the relevant page or storefront. Clearing the store selection stops Google Purchase tracking for new orders; existing order snapshots remain unchanged. The optional conversion_action_id remains supported for legacy clients and is verified with Google when supplied. OAuth connection and account discovery are dashboard-only.

post/v3/google-ads/destinations

Request

  • Base URL
    https://api.scalev.com
  • URL
    https://api.scalev.com/v3/google-ads/destinations
  • Auth
    • HTTP bearer
    • or API key in header authorization
    • or OAuth 2
      Authorization code: https://api.scalev.com/v3/oauth/authorize
      Token URL: https://api.scalev.com/v3/oauth/token scopes: google_ads:create

Request body

namestring required
connection_idstring uuid required
customer_idstring required
login_customer_idstring nullable
conversion_action_idstring nullable

Legacy Purchase default. Omit for account-only connections; use the store Purchase settings.

Response

Success

idstring uuid required
connection_idstring uuid required
namestring required
customer_idstring required
login_customer_idstring nullable
conversion_action_idstring nullable required
tag_idstring nullable required
conversion_labelstring nullable required
currency'IDR' required
enabledboolean required
connection_status'connected' | 'disconnected' | 'reconnect_required' | 'removed'

Google integration authorization status. Reconnect through dashboard Integrations when required.

access_status'unknown' | 'accessible' | 'access_lost'

Last known account access status; transient refresh failures preserve it.

access_checked_atstring date-time nullable

Time of the latest attempted account access check, including unsuccessful attempts.

access_errorstring nullable

Safe provider error code from the latest check. No provider payload or credentials.

account_statusstring nullable

Last known Google customer lifecycle status, such as ENABLED, CANCELED, or SUSPENDED.

Changes