Usage Instructions
The Ads Tracking block fires conversion events to configured ad platforms (Meta CAPI, Google Ads) during chat automations. Use it to attribute conversions back to ad campaigns.
Actions
Ads Tracking - Fire Event
Fire a conversion tracking event to configured ad platforms (Meta CAPI, Google Ads)
Input
| Parameter | Type | Required | Description |
|---|---|---|---|
eventName | string | Yes | Name of the tracking event to fire |
contactPhone | string | No | Contact phone number for attribution |
contactEmail | string | No | Contact email address for attribution |
chatContactId | string | No | Chatwoot contact ID for attribution |
value | number | No | Monetary value associated with the conversion event |
currency | string | No | ISO 4217 currency code (e.g., BRL, USD) |
gclid | string | No | Google Click ID for Google Ads attribution |
fbclid | string | No | Facebook Click ID for Meta attribution |
Output
| Parameter | Type | Description |
|---|---|---|
success | boolean | Whether at least one platform event was sent successfully |
results | array | Array of per-platform delivery results |
↳ platform | string | Ad platform (meta or google) |
↳ platformEventName | string | Platform-specific event name |
↳ status | string | Delivery status (sent, failed, skipped) |