Skip to main content

Add Buzzvil Adapter

This article explains how to connect Swaarm with Buzzvil via API to import offers

Overview

The Buzzvil integration allows you to automatically import offers via API and keep them synced, reducing manual setup and maintenance.

Prerequisites

Before setting up the integration, make sure you have:

  • Unit ID (separate for AOS and IOS)

  • API key (separate for AOS and IOS)


Set up in Swaarm

Step 1: Create Network Integration

  1. Go to Integrations β†’ Networks β†’ +Create

  2. Select:

    • Advertiser

    • Adapter: Buzzvil

  3. Enter the required credentials:

    • Unit ID (separate for AOS and IOS)

    • API key (separate for AOS and IOS)

  4. Set your margin - used to calculate publisher payout. For example, if your payout is $10 and the margin is 40%, the publisher payout (TheyGet) will be $6.

Step 2: Configure Tracking Link Mapping

By default, Swaarm suggests the most common Advertiser Click Parameter on the left to be matched to the Swaarm Click Macros on the right. Use the default mapping unless you have a custom setup.

πŸ‘‰ Full list of Swaarm-supported tracking link macros here.

Step 3: Configure Fields

Select which fields you want to be constantly updated or pulled only once from the Advertiser API. To explore this step further, go to this article here.

Step 4: Preview and Import Offers

  1. Enable sync by selecting the checkbox

  2. Save the integration by clicking Save Network

  3. Go to Integration β†’ Offers Approval

  4. Review imported offers

  5. Click Approve to create them in your platform


Recommended Postback Setup

To track conversions via S2S postbacks, the following postback URL must be configured on the Buzzvil side:

https://track.{yourdomain}.swaarm-clients.com/postback?click_id=insert_custom2_macro&event_id=insert_multi_mission_id_macro

Note: Replace {yourdomain} with your Swaarm tracking domain.

πŸ‘‰ Full list of Swaarm-supported postback link parameters here.

Did this answer your question?