Server-to-Server Installation

Setting up S2S is straightforward. You’ll create a conversion event in your dashboard, generate a postback URL, and configure your tracking software to fire it on conversions. Blockchain-Ads uses a unique {clickid} parameter to match clicks to conversions seamlessly.

Step 1: Create a Conversion Event

1. Log in to your Blockchain-Ads HUB dashboard.
2. Navigate to Advertising > Tracking > Create Conversion.
3. Select Server to Server as the tracking method.
4. Fill in the event details:
   
   • Event Name: e.g., “Purchase”, “Lead”, or “Sign-Up”.
   • Revenue Field (optional): Enable if tracking payouts or order values.
5. Click Save. You’ll receive a unique postback URL in the format:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={clickid}&trackerid=YOUR_TRACKERID&transaction_value={revenue}

• {clickid}: The unique ID from the original click (passed back by your tracker).
• {revenue}: Placeholder for conversion value (e.g., 10.50 for $10.50; omit if not used).

6. Copy this URL—it’s your endpoint for sending conversion data.

Step 2: Configure Your Tracking Software

In your tracker or affiliate platform:

1. Add Blockchain-Ads as a traffic source.
   
   • Set the Click ID Parameter to clickid. This captures the {clickid} appended to your campaign URLs (e.g., https://your-landing-page.com/?clickid=xyz789).
2. Set up the postback URL.
   
   • Paste the URL from Step 1.
   • Map placeholders to your tracker’s macros:
     
     • {clickid} → Your tracker’s click ID macro (e.g., {external_id} or {clickid}).
     • {revenue} → Your revenue macro (e.g., {payout} or {revenue}).
   • Example for a generic tracker:

https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid={external_id}&trackerid=abc123&transaction_value={revenue}

3. Define conversion rules:
   
   • Trigger postbacks on events like form submissions or thank-you page loads.
   • Optionally, pass additional params like status (e.g., &status=approved) or currency (e.g., &currency=USD).

Step 3: Update Your Campaign Destination

1. In Blockchain-Ads, edit your campaign.
2. Set the Destination URL to your tracker’s campaign link, ensuring it includes the {clickid} macro:

https://your-tracker.com/campaign123?clickid={clickid}

3. Launch and test (see below).

Step 4: Test the Integration

1. Create a test campaign with a low budget.
2. Click your ad and simulate a conversion (e.g., complete a test offer).
3. Check:
   
   • Blockchain-Ads Reports: Go to Reports > Conversions—verify the click ID matches and revenue appears.
   • Tracker Logs: Ensure the postback fired successfully (no 4xx/5xx errors).
4. Use tools like Postman or curl for manual tests:

curl "https://server.blockchain-ads.com/www/delivery/tracker-mobile.php?clickid=TEST123&trackerid=abc123&transaction_value=5.00"

5. Expect a 200 OK response.

Best Practices for S2S Tracking

• Security: Use HTTPS for all postbacks. Add IP whitelisting if your tracker supports it (contact support@blockchain-ads.com for our IP ranges).
• Encoding: URL-encode values (e.g., spaces become %20) to avoid errors.
• Deduplication: Include timestamps or unique transaction IDs to prevent double-counting.
• Multiple Events: Create separate conversion events for different actions (e.g., one for leads, one for sales) and use conditional postbacks.
• Error Handling: Monitor for failed postbacks—implement retries (up to 3 attempts) in your tracker.
• Compliance: Always disclose tracking in your privacy policy.
• Optimization: Use our Real-Time Reporting to analyze S2S data and adjust bids dynamically.