API Offer

An API offer is a unique solution provided by the Marksel platform. With this, you can consolidate different products from various advertisers into a single offer. The system will automatically distribute traffic in such a way that you can maximize your benefits.

Each lead will be presented to all advertisers connected to the offer until one of the advertisers accepts and pays for that lead. Additionally, the system allows you to monetize the leads further by sending them to advertisers willing to purchase such data.

To create an API offer, go to the Offers section, click on the ADD OFFER button, and choose API from the dropdown list. After that, you will be directed to the offer management page with a form for configuring the offer.

Main Information

On the left side of the page, you’ll find a form for entering the primary offer details. Until these are filled out, additional settings are unavailable.

Title - Offer name.
Status - Choose one of the following:

Active - The offer is available to affiliates.
Not Active - The offer is not available to affiliates. It's recommended to set this status when creating an offer and change it to Active only after all settings are complete and the test conversion is successful.
Stopped - The offer is inactive but still in the system. Use this status if the offer is set up but not currently active.
Deleted - The offer is removed and no longer available. Use this if you want to delete the offer from the system.

Integration Type – Select the niche in which the offer operates. This helps filter statistics for accurate analysis.
Privacy Status- Defines offer visibility for affiliates:

Public - The offer is available to all affiliates without moderation.
Premoderation - The offer is visible, but affiliates must be added as trusted to work with it.
Private - The offer is hidden from affiliates unless they are explicitly added as trusted for this offer.

Currency - Specify the currency in which the advertiser pays for the offer.
Description - Include all information affiliates need, such as product details, audience description, and any other features important for effective promotion.
Traffic Sources - Specify the allowable traffic sources for the offer. Affiliates will see this information.
Tags - Add tags to simplify finding the offer in the list.
Verticals - Select the verticals related to the offer.
Notes - A field for any additional notes.

To save the parameters, click Save, and the basic information will be saved.

Additional Settings

For affiliates to work with an offer, it needs to be fully configured.

This involves completing the tabs on the right side of the page.

Targets

In this tab, the primary configuration of offer parameters is carried out, which will be used in subsequent steps of offer setup.

Geos - Select the geographic locations where the offer applies. Traffic from locations not selected in any cap will be considered invalid.

Devices - Select the device types where the offer applies. Traffic from devices not selected in any cap will be considered invalid.

OS - Select the operating systems where the offer applies. Traffic from non-selected OS will be considered invalid.

Gender - Select the target gender for the offer. A dropdown menu will allow you to choose from the following options: Male, Female, Ladyboy, All. This parameter is optional.
If the gender is not specified, the system will operate as it currently does.If gender is added as a target, it will be considered when distributing traffic.

Age - Specify the age range for the offer. This parameter is optional. If the age range is not specified, the system will function as it currently does. If the age range is added as a target, it will be considered when distributing traffic.

Two fields will be available:

Age From (e.g., 18)
Age To (e.g., 35)

If multiple products are added to an offer, and the traffic does not match the specified parameters for the first product (e.g., a mismatch in gender or age), it will be redirected to another product where these parameters are not set.

Reject leads with duplicated IPs - This switch automatically rejects leads with duplicate IP addresses.

Target List - A list of parameters applied by the user and their editability.

Flow

This tab is used to configure the logic for distributing leads received from affiliates among advertiser products. Traffic will be allocated between added products according to the specific logic described below.

Each offer can include up to 6 products for each targeting group. A targeting group consists of a combination of Geo + Device + OS.
To add a product, fill in the following fields:

Workdays – configure specific days of the week and hours of operation for each product within an offer. These settings determine when products are active and can receive traffic. Traffic distribution will follow these configurations. If no workdays are set, the system assumes the product is available 24/7. If workdays are defined, traffic will be routed according to the set schedule.
Target – Choose the previously configured offer parameters you want to use for this flow.
Advertiser – Select the owner of the product to be advertised within the offer. You can only choose from advertisers who have at least one integration set up in their management form.
Product – Select the advertiser’s product to be promoted within the offer.
Priority – When several products are added to an offer, traffic is distributed based on priority. Traffic is first directed to the product with the highest priority. If the advertiser is not accepting traffic for that product, it is redirected to the next priority product, and so on. Priority is set as an integer (e.g., 1, 2, 3). The lower the number, the higher the priority. It’s recommended to assign higher priority to products that accept more traffic or offer higher payouts.
Period – Set the period for the specified limit: day, week, or month. For example, if you set a limit of 10 conversions from iOS per week, this limit will be set for 7 days from the offer launch. After 7 days, the limit will reset, allowing for 10 more conversions in the next week. If you select no period, the cap will not reset over time.
Cap – Set the conversion limit for a specific targeting group (Geo + OS + Device). The targeting options will be selected below.
Weight – If an offer includes products with the same priority, traffic will be distributed according to weight. For example, if an offer has three products with priority 1, but one product accepts more traffic, you can set their weights as 50, 25, and 25. In this case, 50% of the traffic will go to the first product, 25% to the second, and 25% to the third. The total weight for products with the same priority must equal 100.
Goal Title – Select the action that triggers payment.
Devices – Choose the devices for which the specified limits are relevant.
Payment Type – Select the payment type:

CPA – The advertiser pays a fixed rate for each conversion, and the affiliate receives a fixed payout per conversion. Payment is based on an action.
RevShare – The advertiser pays a variable rate per conversion (e.g., a percentage of the order), and the affiliate receives a percentage of the advertiser’s payout for each conversion.
Mixed – A combined model that blends CPA and RevShare elements. The advertiser may pay a fixed amount for certain types of conversions (CPA) while paying a percentage of revenue for others (RevShare).

11. Revenue – Enter the advertiser’s payout for each conversion.

If CPA is selected, enter the fixed payout.
If RevShare is selected, enter the percentage of the advertiser’s payout, which should always equal 100%.
If Mixed is selected, enter the fixed payout. The final payout will be calculated by multiplying the fixed payout by the postback revenue divided by 100.

12. Payouts – Enter the affiliate’s payout for each conversion.

If CPA is selected, enter the fixed payout to the affiliate.
If RevShare is selected, enter the percentage of the advertiser’s payout that the affiliate will receive (e.g., 30% if the affiliate’s share is 30% of what the advertiser pays).
If Mixed is selected, enter the fixed payout. The final payout will be calculated by multiplying the fixed payout by the postback payout divided by 100.

13. Status – Select the current status of the product:

Active – The product is active, and traffic will be directed to this product during distribution.
Not Active – The product is inactive, and traffic will not be directed to it.

After filling in all the fields, click the Publish button. The product will be added to the offer. For optimal performance, add 2 or more products.

Added products are displayed below in a table.
In the context menu, you can:

Edit the product. This will populate the form above with the product’s data, allowing you to make changes and save them.
Duplicate the product.
Delete the product from the offer.

Goals

Marksel system supports a wide range of different goals that can be paid by the advertiser.

REGISTRATION - registration
SOI LEAD - Single Opt-In Lead. Adding potential customers' personal data (e.g., email, phone number, etc.).
DOI LEAD - Double Opt-In Lead. Adding potential customers' data and subsequently confirming them (e.g., the user added their phone number, received an SMS from the advertiser, and entered the SMS code on the site as confirmation of the phone number).
QUALIFIED REGISTRATION - requested confirmed registration.
INSTALL - application installation
QUALIFIED INSTALL - requested confirmed installation.
CPT TRIAL - purchase of a trial version
CC SUBMIT - payment for entering credit card data.
SUBMIT ANY - filling out any form on the advertiser's landing page.
SALE - product purchase
QUALIFIED SALE - requested confirmed sale.
RECURRENT SALE - repeated product purchase
DEPOSIT - making a deposit
QUALIFIED DEPOSIT -
RECURRENT DEPOSIT - repeated deposit
REBILL - automatic payment deduction for the next period during subscription
CANCEL_SUBSCRIPTION - subscription cancellation
REFUND - refund to the customer
CHARGE_BACK - refund to the customer
FRAUD - fraud
REJECT - rejection
MONETIZATION - any type of monetization that the advertiser is willing to pay for. Discussed individually with the advertiser.

List of Supported Macros

{clickid} - Conversion identificator of advertiser
{device} - Used to send device type.
{os} - OS Family
{browser} - browser type
{ip} - User IP-address
{sub_source} - the value of the subsource parameter, which transmits data about a specific traffic source
{date} - Date and time of conversion committing
{click_date} - Date and time of click committing
{pid} - affiliate's id
{sub1} - Subaccount 1
{sub2} - Subaccount 2
{sub3} - Subaccount 3
{sub4} - Subaccount 4
{sub5} - Subaccount 5
{sub6} - Subaccount 6
{sub7} - Subaccount 7
{sub8} - Subaccount 8
{sub9} - Subaccount 9
{sub10} - Subaccount 10
{sub11} - Subaccount 11
{sub12} - Subaccount 12
{sub13} - Subaccount 13
{sub14} - Subaccount 14
{sub15} - Subaccount 15

Monetization

This tab configures products for additional monetization. Traffic will be directed to the products listed here, regardless of the main flow.
Here, you can specify products where the advertiser pays for obtaining potential client information. The system will send such data to all listed advertisers simultaneously, without the potential client being redirected to these product pages.

For example, if the advertiser pays for contact information, you can add the product in this tab. When a lead is acquired, the information will be sent to the advertiser.

To configure, fill in the following fields:

Target – Choose the previously configured offer parameters.
Advertiser – Select the advertiser to whom you will send the data. Only advertisers with integrations configured in the editing form will be available.
Product – Select the advertiser’s product.
Period – Set the period for the specified limit: day, week, or month. For example, if you set a limit of 10 conversions from iOS per week, this limit will be set for 7 days from the offer launch. After 7 days, the limit will reset. If you select no period, the cap will not reset over time.
Cap – Set the conversion limit for the selected geo.
Goal Title – Specify the action that triggers payment.
Revenue – The advertiser’s payout for confirmed conversions.
Payouts – The affiliate’s payout for confirmed conversions.
Payment Type – Select the payment type:
- CPA – The advertiser pays a fixed amount per conversion, and the affiliate receives a fixed payout per conversion.
- RevShare – The advertiser pays a variable amount per conversion, and the affiliate receives a percentage of the advertiser’s payout.
- Mixed - A combined model that blends CPA and RevShare elements. The advertiser may pay a fixed amount for certain types of conversions (CPA) while paying a percentage of revenue for others (RevShare).

10. Status – Set the current product status:

Active – The product is active, and traffic will be directed to it.
Not Active – The product is inactive, and traffic will not be directed to it.

11. Redirect Monetization – If this toggle is activated, the product page will open in the background for potential clients whose data is sent to the product.

After filling in all the fields, click Publish. The additional monetization product will be added to the offer.

All added products are displayed below in a table.

In the dropdown menu, you can:

Edit the product. This will populate the form above with the product’s data, allowing you to make changes.
Duplicate the product.
Delete the product from additional monetization.

Affiliates

In this tab, you can specify affiliates who will have access to the offer.
Even if the offer is set to Public, you must add an affiliate to the list to generate a tracking link for them. However, for Public offers, affiliates can generate their own tracking links, even if they are not listed here.

For non-public offers, add the affiliates who should be able to work with the offer.
To add an affiliate, click Add Affiliate and select the desired affiliate from the list. Affiliates displayed in the list are those who were previously added in the Roles section.
The information about all added affiliates is displayed in a table below, where you can see:

Affiliate ID
Email
Status

In the dropdown menu, you can:

Remove the affiliate from the offer, which will revoke their access to the offer.

Landing Pages

In this tab, you can specify the landing and pre-landing pages that affiliates can choose from when working with the offer.

To add a landing page, click Add Landing. In the pop-up window, select one of the landing or pre-landing pages previously added in the Landings section.
Information about already added landing pages is displayed in a table with the following fields:

Preview
ID
Type
Name
Landing Languages
CR – Conversion rate relative to clicks on the landing page.
EPC – Average earnings per click on the landing page.
EPL – Average earnings per lead.
Tags
Date and time of creation
Status

In the context menu, you can:

Delete the landing from the offer.

Documents

This Feature Is Under Development

Optimization Tool

The optimization page allows you to configure shaving parameters (hiding conversions) for partners (affiliates) when working with Direct Link or API offers. By using different optimization types, you can flexibly control the percentage of conversions displayed to affiliates, preventing full data disclosure.

Types of optimization

Dynamic Percent
The dynamic percentage allows you to specify a conversion range (e.g., from 10% to 20%) to be hidden from the affiliate (a process known as shaving). As a result, the affiliate will not see some conversions within the defined range.
- Value (min-max) - Allows you to set the range of conversions (e.g., from 10% to 20%).
- Count - You can also use this parameter to specify how many conversions will be visible before the hidden ones start.
- Optimization Cycle - Defines after how many conversions the shaving process resets and starts over.
- Goal Title - Optimization can be applied to a specific goal if the offer has multiple goals. Only conversions related to the selected goal will be shaved, while others remain visible to the affiliate.
Fixed Percent
A fixed percentage of conversions to be hidden.
- Value (min-max) - Allows you to set the exact percentage of conversions to be shaved, for example, 15%.
- Count - You can also use this parameter to specify how many conversions will be visible before the hidden ones start.
- Optimization Cycle - Defines after how many conversions the shaving process resets and starts over.
- Goal Title - Optimization can be applied to a specific goal if the offer has multiple goals. Only conversions related to the selected goal will be shaved, while others remain visible to the affiliate.
Selective
This type allows you to set specific rules, for example, every fifth conversion will be hidden.
- This value should be entered in the Each field.
- Goal Title - Optimization can be applied to a specific goal if the offer has multiple goals. Only conversions related to the selected goal will be shaved, while others remain visible to the affiliate.

Personal Optimization
Personal Optimization functions identically to general optimization. However, it allows you to select a specific affiliate from the offer to apply the optimization settings to.

Important Notes:

Conversions with Reject and Fraud statuses are not subject to shaving.
Traffic back conversions will not be shaved.
Conversions with goals other than the one specified in the offer's optimization section will not be shaved.
Shaved conversions will not appear in the affiliate's account, statistics, dashboard, or wallet.

Page updated

Report abuse