Getting Started with Attro

After signing up for Attro, your first step is creating an organization. Organizations are the top-level container for your affiliate program and can hold multiple projects (useful if you have multiple products).

Sign Up Process

1. Visit get-attro.com and click "Get Started Free"
2. Enter your email and create a password
3. Verify your email address
4. Complete the onboarding wizard

Organization Details

During setup, you'll provide:

• Organization Name - Your company name (e.g., "Acme Inc")
• Organization Slug - URL-friendly identifier (e.g., "acme-inc")
• Project Name - Your product name (e.g., "Acme Pro")
• Project Slug - Used in affiliate portal URLs

Tip: Choose slugs carefully - they'll appear in your affiliate portal URLs and tracking links. Keep them short and memorable.

Once created, you'll be taken to your admin dashboard at /[org-slug]/[project-slug]/admin.

Offers define what affiliates are promoting and how they're compensated. Each offer has a destination URL, commission structure, and tracking settings.

Creating an Offer

1. Navigate to Admin → Offers
2. Click "Create Offer"
3. Fill in the offer details

Offer Settings

Basic Information:

• Name - Internal name for the offer (e.g., "Pro Plan Signup")
• URL - Where affiliate links redirect to (your landing page)
• Description - Optional description for affiliates

Commission Structure:

• Commission Type - Choose "Percentage" or "Fixed Amount"
• Commission Value - The rate (e.g., 20 for 20% or 50 for $50)
• Attribution Window - Days a click remains valid (default: 30)

// Example commission scenarios:
// Percentage: 20% of a $99 sale = $19.80 commission
// Fixed: $50 per conversion regardless of sale amount

// For subscriptions, you can also configure:
// - First payment only
// - Lifetime (every renewal)
// - Fixed period (e.g., first 12 months)

Advanced Settings

• Daily Cap - Maximum conversions per day (fraud protection)
• Geo Targeting - Restrict by country if needed
• Status - Active or Paused

Connecting Stripe enables automatic conversion tracking. When a customer completes a purchase, Attro receives a webhook event and automatically attributes the conversion to the correct affiliate.

Stripe Dashboard Setup

1. Log into your Stripe Dashboard
2. Navigate to Developers → Webhooks
3. Click "Add endpoint"
4. Enter your webhook URL

Your webhook URL is:

https://get-attro.com/api/webhooks/stripe

Select Events

Subscribe to these events:

• checkout.session.completed
• invoice.paid
• charge.succeeded

Copy Signing Secret

1. After creating the endpoint, click on it
2. Under "Signing secret", click "Reveal"
3. Copy the secret (starts with whsec_)
4. In Attro, go to Settings → Integrations → Stripe
5. Paste the signing secret and save

Security Note: The signing secret ensures webhook events genuinely come from Stripe. Never share this secret publicly.

For detailed implementation including code examples, see our Stripe Webhook Integration Guide.

Now that your offer is configured, it's time to add affiliates. You can either create affiliates manually or let them sign up through your affiliate portal.

Option 1: Manual Creation

1. Go to Admin → Affiliates
2. Click "Add Affiliate"
3. Enter their details
4. They'll receive an email invitation

Required Information:

• Display Name
• Email Address
• Affiliate Type (External or Internal)

Option 2: Self-Service Signup

Share your affiliate signup link:

https://get-attro.com/[org-slug]/[project-slug]/join

Affiliates can register themselves. You can configure:

• Auto-Approve - Instantly activate new affiliates
• Manual Review - Require admin approval before activation

Affiliate Types

• External Affiliates - Influencers, bloggers, partners who receive monetary commissions via PayPal
• Internal Affiliates - Your own users who earn tokens/rewards for referrals

Each affiliate gets unique tracking links for every offer they're approved to promote. These links track clicks and attribute conversions.

How Tracking Links Work

1. Affiliate shares their unique link
2. Visitor clicks the link
3. Attro records the click and sets a first-party cookie
4. Visitor is redirected to your offer URL
5. If they purchase within the attribution window, conversion is tracked

Link Format

https://get-attro.com/r/[unique-code]

Each link has a unique 8-character code that identifies the affiliate and offer combination.

Creating Links (Admin)

1. Go to Admin → Tracking Links
2. Click "Create Link"
3. Select the affiliate and offer
4. Optionally set a custom destination URL
5. Copy and share the generated link

Affiliate Portal

Affiliates can also generate their own links from the affiliate portal at:

https://get-attro.com/[org-slug]/[project-slug]/affiliate

They'll see all their approved offers and can copy tracking links with one click.

Before going live, test the entire attribution flow to ensure everything is connected properly.

Testing Checklist

1. Click a tracking link - Use an incognito window
2. Verify redirect - Confirm you land on the correct offer URL
3. Check for cookie - Look for rd_click_id in browser cookies
4. Make a test purchase - Use Stripe test mode
5. Verify conversion - Check the Conversions page in admin

Using Stripe Test Mode

Stripe provides test card numbers for development:

Test Card (Success): 4242 4242 4242 4242
Expiry: Any future date
CVC: Any 3 digits

Troubleshooting

Click not recorded:

• Ensure the tracking link is correct
• Check that cookies aren't blocked
• Verify the offer is active

Conversion not attributed:

• Confirm Stripe webhook is configured
• Check webhook logs in Stripe Dashboard
• Verify the signing secret matches
• Ensure attribution window hasn't expired

Your admin dashboard provides a real-time view of your affiliate program's performance.

Key Metrics

• Total Clicks - Number of tracking link clicks
• Conversions - Successful purchases attributed to affiliates
• Conversion Rate - Conversions ÷ Clicks
• Revenue - Total sales from affiliate traffic
• Commissions - Amount owed to affiliates

Conversion Statuses

• Pending - Awaiting approval or refund window
• Approved - Confirmed and commission calculated
• Rejected - Declined (fraud, refund, duplicate)
• Paid - Commission sent to affiliate

Filtering & Export

Use filters to analyze performance by:

• Date range
• Specific affiliate
• Offer
• Conversion status

Export data as CSV for custom analysis or accounting.

What's Next?

Your basic affiliate program is now set up! Consider these next steps:

• Configure commission tiers for top performers
• Set up fraud detection to protect your program
• White-label your portal for a branded experience
• Connect automations via Zapier or webhooks