Skip to main content

Offers (Marketplace) (V3)

Marketplace in the new version of Trackbox.

Updated over 2 weeks ago

Our offers feature allows you to upload landing pages that your affiliates can promote. They can then track and advertise these pages through tracking links.

How to create a new offer

Find offers via the menu on the bottom left and then click Create a new offer on the top right:

Here you can select the type of offer you want to create. You have two options:

Direct or Lead distribution.

1. Direct

In a direct offer landing pages are hosted by the broker,

and you will advertise it.

Use this type of offer when you want to integrate with your broker via a third party (Postbacks).

Only one broker can receive the Leads.

Let's go over the setup of the direct offer:

Step 1 - Settings

  1. Offer Details:
    Here you can name the offer, write a description and add a note.

  2. Marketing Details:
    Here you can select the countries for the offer, languages and set the vertical for this offer.

  3. Lead Delivery:
    Here we will choose Direct since we are setting up a direct offer now and we will go over the second option later in this guide.
    Since we set this as a Direct offer, we need to select the advertiser that will receive the leads.

  4. Activation Dates:

    Here you can set the offer to always be active or set a date range for the offer to be active during that time.

  5. Privacy Settings:

    This setting determines if your affiliates will see this offer or you will need to assign / approve them in order for them to see the offer.

  6. Default offer URL:

    Since we are setting up a direct offer you fill the advertiser's landing page here.

Step 2 - Targeting (Optional)

Here you can set working hours for the offer as well as whitelisting or blacklisting certain countries.
​

In this example I activated certain days and hours and whitelisted France.

Step 3 - Creatives (Optional)

Here you can add creatives such as landing pages or banners, for your affiliates.

Step 4 - Payment Plans (Optional)

Here you can add payment plans.

You can add a Payout plan or a Revenue plan.

(Revenue plans are relevant for networks)

In this example we set a CPA plan for a thousand euro for the month of February

Only for Albania and Algeria.

For more information about payment plans you can refer to our Payment Plans guide.

Step 5 - Summary

Here you will see everything you created for this offer so far and you can click "Done" at the top right to finalize the process and create the offer.

Please note that you can go back to any of the previous steps by clicking on them at the top of the screen!

2. Lead Distribution

Here the landing pages are hosted by your organization,
Leads are distributed to different advertisers through the Box.

Which means in this case the registration form is connected to Trackbox (via API / JS).

The setup process of this offer is similar and only has a few differences:

  1. You DO NOT have to create a lead distribution offer as guided above for "Direct" it will be mainly for easier configuration and also tracking statistics to appear in your Trackbox.
    ​

  2. Leads are distributed to your different advertisers through the Box and you do not host your brands' page.
    ​

  3. Here you can choose a default box that will be the box all the leads will reach unless you assign specific affiliate to a specific box on the right side of the screen.

The process of lead sending to Trackbox from your page can be done in 2 ways:

  • API:
    ​

    Similar to how regular affiliate integrations work (creating a user for your affiliate or just a test user for the landing page and starting to leads regularly via API) this can also be implemented into your page.
    ​
    Start by taking a look at our Affiliates & Employees guide in order to create a user for this process.

    After you have a user and a box you have the necessary credentials needed to send leads:

    AI (Affiliate ID) - You can get it from partners next to affiliate's name

    CI = 1 (It's always 1)

    GI (It's the box id, go to Boxes and copy the GI from the box)

    x-trackbox-username (The username you created for the user)

    x-trackbox-password (The password you chose for the user)

    API URL (Your TrackBox URL)


    ​Now all that is left is to contact the developer who built your landing page and ask them to use these credentials in the form so that the requests from the page will reach your Trackbox.


    ​

Trackbox JS form + HTML
​
This option can be easier if you prefer implementing our ready JS form and HTML code that can be found directly in your system.
​


1. First, click on the cog wheel icon on the bottom left, and then click on "System Settings".
​
2. Click on "LP Registration Form" tab.


3. There you will find the HTML code to copy and the JS file to download.
​
4. Make sure to edit the HTML code parameters (ai,gi) or you can add them to your landing page URL like this:

https://www.yourlandingpage.com/?ai=2190296&ci=1&gi=10
​
5. Implement both the JS and HTML where the page is hosted.
​
6. Go to "Access Control".


7. Click on "Create New Domain".
​
8. Choose Trackbox JS category and whitelist the landing page domain.
​


​

Troubleshooting

Here you can find the meaning for a different error you may get from an offer:

  • Error Code 999: "No matching campaign"
    Please make sure the campaign in the box is added.
    ​

  • Error Code 1000: “ No assign affiliate’:
    If the campaign is private: Please make sure affiliate is assigned to the campaign
    if the campaign in public: make sure you send the affiliate the gi, and the affiliate made integration.
    ​

  • Error Code 1001: "Offer not valid or no campaigns"
    Please make sure the campaign in the box is added
    ​

  • Error Code 1002: "No Active Campaigns"
    Please make sure the campaign is active in the campaigns section
    ​

  • Error Code 1003: "Exceeded their caps"
    Please edit the limit no. of Leads/ clicks etc. that the campaign can receive in the box.
    ​

  • Error Code 1004: "Selected time range"
    Please edit the time (days + hours) the campaign can receive traffic in the box.
    ​

  • Error Code 1005: "Selected hours"
    Please edit the hours the campaign can receive traffic in the box.
    ​

  • Error Code 1006: "Selected days"
    Please edit the days the campaign can receive traffic in the box.
    ​

  • Error Code 1007: "No ID found for URL"
    Please make sure the first parameter in the URL should start with ‘?’
    ​

  • Error Code 1010: ”Direct Offer, But Campaign has no valid URL"
    The campaign that edits in the box is API instead of S2S.
    Please make sure the campaign is S2S (direct)
    ​

  • Error Code 1011: "No such id"
    Please make sure the offer URL is correct.

  • Error Code 1020: "affiliate is not assigned"
    Please make sure that the relevant affiliate is assigned to the relevant campaign in the box.

    Also make sure that the GEO from which the affiliate is trying to register is assigned to the box and the working hours for the relevant campaign are matching the time of the attempted registration.

    In order to assign the affiliate to a campaign follow these steps:

    Go to the 'Affiliates' tab -> Click on the relevant affiliate -> 'Campaigns' tab -> Add the relevant campaign(s).

Did this answer your question?