Campaign Attribution

Campaign Attribution is the evolution of Smart Tracking. While the original tracking works with manually copied messages, attribution works automatically — without the customer needing to copy anything.

Access it from the sidebar under Campaigns.

What changes compared to Smart Tracking

How it works

1. Attribution Widget Installation

A small script is added to your website (WordPress, VTEX, Shopify, etc.) that automatically captures:

• Which ad the visitor came from (Facebook, Google, TikTok)
• Which campaign and ad set
• Meta Pixel cookies (_fbp, _fbc) for high-precision matching

<script>
window.taubotConfig = {
  company_domain: 'yourdomain.com',
  attribution: {
    enabled: true,
    heartbeatUrl: 'https://api.taubot.ai/api/v1/campaigns/click-heartbeat',
  },
};
</script>
<script src="https://app.taubot.ai/widget/attribution.js"></script>

2. Meta Ads Connection

In the admin integrations screen, connect your Meta Ads account with one click:

1. Go to Integrations → Meta Ads
2. Click Connect
3. Authorize with your Facebook Business account
4. Select the Ad Account and Pixel

TAU only requests the minimum necessary permissions (ads_read and business_management). The token is stored encrypted and renewed automatically.

3. Automatic Conversions

When the TAU assistant executes a conversion action (qualifies a lead, schedules an appointment, generates a payment), the event is automatically sent to Meta via Conversions API (CAPI):

Campaigns Dashboard

The campaigns dashboard shows data in real time:

Overview (Funnel)

• Clicks — how many visitors came from ads
• Conversations — how many started a WhatsApp conversation
• Leads — how many were qualified by the assistant
• Conversions — how many generated a booking or payment

By Campaign

Detailed table with breakdown by campaign and ad:

• Campaign name
• Ad name
• Number of leads
• Number of conversions
• Source channel

Event Configuration

Choose which events to send to Meta. All are sent by default — you can individually disable the ones you don't want:

• LeadSubmitted
• Schedule
• AddPaymentInfo
• Purchase
• Contact
• MessagingFirstResponse
• MessagingConversationStarted

Event Testing

Send a test event to verify that the integration is working. The event appears in the Test Events tab of Meta's Events Manager.

Cross-Domain

If you have more than one website (e.g. institutional site + online store), the widget maintains attribution when the visitor navigates between them:

<script>
window.taubotConfig = {
  attribution: {
    crossDomainLinker: ['mystore.com'],
  },
};
</script>

When the visitor clicks a link to mystore.com, attribution data is automatically passed via the _tbp parameter in the URL.

Frequently Asked Questions

Do I need to have the TAU chat on my site to use attribution?

No. The attribution widget works independently of the chat. You can use just the attribution to track where WhatsApp contacts come from.

Does it work with Google Ads?

gclid (Google Click ID) capture already works automatically. Integration with Google Ads Enhanced Conversions will be added in a future version.

How much does it cost?

Campaign attribution is included in the TAU plan. Meta conversion costs (CAPI) are paid directly to Meta through your ad account.

Does the widget affect site speed?

Not perceptibly. The script is less than 3KB compressed and loads asynchronously — it does not block page loading.

Can I disable sending a specific event?

Yes. On the campaign settings screen, you can individually disable any event you don't want to send to Meta.