Skip to content
Agoraform

Providers

Providers implement marketing-platform APIs. The Agoraform CLI remains provider-neutral: there is no Matomo-specific or Google Ads-specific command.

v0.3.0 ships two providers:

Meta Ads is not implemented.

Credentials vs desired state

Section titled “Credentials vs desired state”

Connection details and secrets come from the process environment or .agoraform.env. Non-secret desired state belongs in the manifest under providers.

Matomo publication is desired state:

providers:
  matomo:
    publish: true
    environment: live

Google Ads has no non-secret YAML fields in v0.3.0:

providers:
  googleads: {}

Unknown fields are rejected. Tokens never belong in the manifest, logs, plan output, or local state.

Registration

Section titled “Registration”

The CLI registers built-in providers at startup. validate, plan, apply, and import all require a reachable provider configuration for the resources you declare.

Live Matomo operations require MATOMO_URL, MATOMO_TOKEN_AUTH, and MATOMO_SITE_ID. Tag Manager resources and publication also require MATOMO_CONTAINER_ID.

Google Ads operations require GOOGLE_ADS_DEVELOPER_TOKEN, GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET, GOOGLE_ADS_REFRESH_TOKEN, and GOOGLE_ADS_CUSTOMER_ID. GOOGLE_ADS_LOGIN_CUSTOMER_ID is optional when you access the advertiser through a manager account.