Skip to main content

API Testing


​Lead Creation Test

Here you can run tests for specific campaigns and test your integration with the brand.

  • You can see the full brand response.

  • You can test a lead for a specific campaign.

  • You can test a lead for a specific box.

    Open the bottom-left menu and search for API Testing:

- Choose campaign, affiliate, and country.
- Click on 'autofill user data', on both user data and free parameters if needed.
- Click on 'Test Lead'.


1. If you want to check a specific lead, or the full brand response - copy the email for the lead and after you fill in all the auto data change the email for the lead that you want to check.

2. Select the campaign and the country you want to test. If you want to send the test to a box, fill the box's gi in the 'box' field.



​Request & Response

On the right side of the screen after sending a test you will see the API request and API response of the specific test lead to the brand.

Request:

Although the request contains mostly irrelevant info to the brand it can help you / the support agents understand what happened with the API requests in case of failures.

In most cases the relevant request info to the brand can be found at the top under "main" as seen in the picture right up to "requestFormat" parameter which can also be important to the brand.

Response:

The response divides into 2 main sections

  1. Brand API Response

  2. Trackbox API Response

The Brand API Response shows you the response we got from the brand inside the "body" parameter.

The Trackbox API Response shows if we failed the lead or passed it on our side (so in cases you see the brand response looks okay but the "status" is not "true" in the Trackbox API Response contact our support to check the specific integration).

In cases where you see a failed lead you share the relevant info from request and response as we discussed and the brand will advise how to proceed.


Autologin

In The Trackbox API Response section you can see the second parameter "data"

Which will have the "masked" (we hide the real brand url from your affiliates) auto-login URL that we generate according to the brand API documentation.

Some brands return an auto-login URL, some ask us to generate from a separate API method and some do not even have auto-login.

In order for auto-login to be used properly the link inside "data" parameter must be entered (it is a one-time link) and then the auto-login will be shown as used in your leads screen and on brand side if everything is okay with the auto-login parsing on our side.

Note:

You can see the real brand auto-login inside the "autoLoginUrl" parameter but using the auto-login from there will only trigger the usage on brand side and not Trackbox.

To learn more about auto-login, check out our Autologin manual.



Pull Testing


If you don't see status / deposit from the brand, Go to:

  • Select the tab 'Pull test'

  • Choose the brand and the method (Lead/ FTD), and time back

  • Compare the customer id the lead received from the brand (you can get it via CRM by clicking on the lead) and the outcome from the brand's API.


UniqueId's Data

In this section you can check information about a specific lead by entering its Unique ID which can be found by clicking on the lead in your leads screen or by adding that column to your view.

As you can see we have the entire process of the lead as it arrives and lands in your Trackbox.

Did this answer your question?