Providers

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

v0.6.0 ships three providers:

• Matomo
• Google Ads (googleads)
• Meta Ads (meta)

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 and Meta have no non-secret YAML fields in v0.6.0:

providers:
  googleads: {}
  meta: {}

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

Registration

The CLI registers built-in providers at startup. validate, plan, apply, import, and destroy 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 either one matomo.container resource or MATOMO_CONTAINER_ID. Mixing those modes is rejected.

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.

Meta operations require META_ACCESS_TOKEN and META_AD_ACCOUNT_ID.