Slack Integration

Connect BannerTrackr to Slack to receive campaign notifications directly in your workspace. Get daily summaries, performance alerts, and renewal reminders without checking the dashboard.

What You'll Get

• Daily summaries — Performance overview sent at your preferred time
• Performance alerts — CTR drops and milestone celebrations
• Renewal reminders — Campaigns expiring soon
• Usage warnings — When approaching plan limits

Setup

Step 1: Create a Slack Webhook

1. Go to your Slack workspace
2. Navigate to Apps → Incoming Webhooks
   • Or visit api.slack.com/messaging/webhooks
3. Click Add New Webhook to Workspace
4. Choose the channel where you want notifications
5. Click Allow
6. Copy the webhook URL (starts with https://hooks.slack.com/services/...)

Step 2: Connect in BannerTrackr

1. Go to Settings → Integrations in your dashboard
2. Find the Slack card
3. Paste your webhook URL
4. Optionally add a channel name (for your reference)
5. Click Connect Slack

Step 3: Test the Connection

After connecting:

1. Click the Test button
2. Check your Slack channel for a test message
3. If successful, you're ready to go!

Notification Settings

After connecting, configure which notifications you receive:

Daily Summary

A daily overview of all your campaign performance.

• Toggle: Enable/disable daily summaries
• Time: Choose what hour (UTC) to receive it

Example message:

📊 Daily Summary - Dec 30, 2024

Your campaigns had a great day!
• Total impressions: 12,543
• Total clicks: 312
• Average CTR: 2.49%

Top performer: "Newsletter Header" with 3.1% CTR

Performance Alerts

Get notified when campaigns hit milestones or need attention:

• Milestones — 10K, 50K, 100K, 500K, 1M impressions
• CTR drops — When CTR drops below your threshold

Example message:

🎉 Milestone Reached!
"Header Banner" hit 10,000 impressions
Campaign: Tech Weekly Newsletter

Renewal Reminders

Notifications when campaigns are expiring soon:

• Sent for placements with end dates set
• Triggers 7 days before expiration

Example message:

📅 Renewal Reminder
"Sidebar Sponsor" expires in 5 days
Advertiser: Acme Corp
Consider reaching out about renewal.

Usage Warnings

Alerts when approaching your plan's limits:

• 80% usage warning
• 95% usage warning

Example message:

⚠️ Usage Warning
You've used 80% of your monthly impressions.
Consider upgrading to avoid tracking interruption.

Managing Your Integration

Update Webhook URL

If you need to change the channel or refresh the webhook:

1. Go to Settings → Integrations
2. Scroll to Update webhook
3. Paste the new URL
4. Click Update

Connection Issues

If messages aren't being delivered, BannerTrackr will:

1. Show a "Needs Reconnect" badge
2. Display a warning in the integration settings
3. After 3 consecutive failures, notifications pause

To fix:

1. Generate a new webhook URL in Slack
2. Update the URL in BannerTrackr
3. Click Test to verify

Remove Integration

1. Go to Settings → Integrations
2. Click the trash icon on the Slack card
3. Confirm removal

You can reconnect anytime.

Best Practices

Choose the Right Channel

• Dedicated channel — Create a #sponsorships or #bannertrackr channel for focused notifications
• Existing channel — Add to your team's main channel if everyone needs visibility
• Private channel — Use if sponsor data is sensitive

Team Collaboration

If you have a team:

• Everyone sees notifications in the shared channel
• Great for distributed teams managing sponsorships
• No need for everyone to check the dashboard

Tune Your Notifications

Start with all notifications enabled, then adjust:

• Disable daily summaries if you prefer checking the dashboard
• Keep alerts on for critical notifications
• Disable renewal reminders if you track end dates elsewhere

Troubleshooting

"Needs Reconnect" message?

1. Check if your Slack webhook is still valid
2. Webhooks can be revoked if the Slack app is removed
3. Generate a new webhook and update in BannerTrackr

Not receiving messages?

1. Verify the webhook URL is correct
2. Check the Slack channel still exists
3. Click Test to check connectivity
4. Look in Slack's spam/archived channels

Messages going to wrong channel?

The channel is determined by the webhook, not the channel name field. To change channels:

1. Create a new webhook for the desired channel in Slack
2. Update the webhook URL in BannerTrackr

Timezone issues with daily summary?

Daily summary time is in UTC. To convert:

• PST = UTC - 8 hours
• EST = UTC - 5 hours
• CET = UTC + 1 hour

If you want summaries at 9 AM PST, set the time to 17:00 UTC.

Next Steps

• Alerts — Configure alert thresholds
• Reports — Set up scheduled reports
• Settings — Other notification options