Publisher (also called an affiliate) is the company specialized in bringing the buyer’s products and services to a wider audience. API Publishers have their own sources of lead generation and send their leads directly to PX API.
To change settings of the existing publisher, go to Admin -> Publishers, find the desired publisher and click Action -> Edit.
A new page appears, divided into the following sections, that become available depending on the publisher's account type:
- Publisher Settings
- Payout Rules - link to payout management of the publisher.
- Manage Sub IDs - link to Sub ID management page.
To change settings in the desired block, click Edit.
The set of fields is divided into General and Advanced settings.
2. Publisher ID is a unique ID of the publisher in the PX platform.
3. Traffic type - the type of the publisher depending on how leads are captured (Mobile, Call Center, Search, Email, Premium Display, Path, Contextual, Mobile Premium Display, Offer Wall, Mobile Path, All/Mixed or Undefined).
Traffic type allows filtering leads by Traffic Type in campaign’s Filter Management.
4. Publisher tier – assign the publisher to one of the tiers (Excellent, Very good, Good, Fair, Below average, Poor), source quality categories.
5. Publisher name - the internal name of the publisher that can be edited. This name is not displayed to the publisher.
6. Escore check percentage (20% by default) - set the percentage of leads from this publisher that should be checked by verification services configured in PX (eBureau, Neustar, etc.). Read more about Escore.
7. Fixed Pricing - click Yes to pay a fixed amount for each lead to this publisher.
8. Ping Post Type - set one of ping post types or select None to disable it for this publisher.
9. Margin (85% by default) - set margin percentage for this publisher. This option depends on the Access mode selected. Margin field is changed to Publisher's share if Fixed pricing is set to No.
10. Fixed Price is the amount of money that you pay to the publisher for each lead when Fixed Pricing option is enabled. This field allows firing pixel for leads only when the amount of the fixed price is reached.
For example, if Fixed Pricing is set to Yes, and Fixed Price is set to $20 for a publisher. When the lead is sold, the system checks the current publisher balance. If $20 have been reached, the pixel is sent to the tracking system of the publisher. If no (e.g. if balance was negative)- pixel will be sent as soon as Fixed Price amount is reached.
11. Min price (if Fixed Pricing is set to Yes) - the minimum amount of money that the publisher wants to receive for each of their leads. In other words, if сampaign's bid is less then Min Price specified, the lead will not be sold to this сampaign.
The next several fields are available if Ping post type isn't set to None:
12. Bid floor field is used to calculate the minimum price, for which the lead should be sold (Minimum Price = Bid Price * Bid Floor).
- It is recommended setting Bid floor higher than publisher’s Margin unless you have specific goals.
- If you leave Bid floor as 0, Min price for leads inserted by this publisher will be 0 as well.
- Bid floor is not limited and can be higher than 100%.
13. Bid type – select one of the bid types (None, Calculation, Correction, Correction to 0).
14. Ping timeout – set the maximum period of time, during which PX must send a ping response to the publisher with a bid.
If Ping post type is set to Ping Forwarding, bids sent from buyers later than is selected in Ping timeout field aren't taken into account.
15. Outbid percentage (available if bid type is set to Correction) - set the percentage of the bid, by which the lead price will be increased in the ping stage (Increased Price = Bid Price+Bid Price*Outbid Percentage).
16. Outbid percentage % (available if bid type is set to Correction) - enter the percentage of leads of this publisher, to which Outbid Percentage should be applied.
17. Leg naming - select whether Legname or Hashed Legname should be used for this publisher. The field is available only when one of shared ping post types is set for the publisher.
The next fields are the following:
18. Status - assign one of the statuses to the publisher (New, Prepublished, Published, Blocked, Expired, Deleted, Initial, Follow Up, Overruled, Purged).
19. Modify Date – the date when publisher settings were edited.
Advanced block includes the following fields:
1. Description – basic description of the publisher.
2. Leading balance - select at which level you wish to balance this publisher:
- Publisher Total - balancing on the publisher level as a whole.
- Publisher Sub - balancing on the source level (e.g. useful for call centers for each employee)
- Publisher Sub and Campaign (for large publishers that are active in multiple verticals, for each Lead Campaign (survey).
3. Start balance – enter the start balance amount for this publisher in order to give him a head start in the beginning (according to agreements with the publisher).
4. Max negative balance allows specifying the maximum negative balance acceptable for this publisher in order to avoid losing more money than indicated.
5. Access Mode - select the mode indicating when this publisher should be paid:
- Standard mode - margin is the percentage of the payout for each lead received from buyers, for which you wish to send a tracking pixel to the publisher (e.g. 75% means that 75% of the payout is pixeled to the publisher).
- Lead Submit mode - margin is the percentage of leads submitted by PX, which you wish to pixel to the publisher (e.g. 75% means that pixels are sent in 75% cases when the publisher’s leads are submitted by PX).
- Sold Lead mode - margin is the percentage of leads sold to buyers, which you wish to pixel to the publisher (e.g. 75% means that pixels are sent in 75% cases when the publisher’s leads are sold to buyers).
6. Quality score - enter the quality score floor for this publisher.
7. Passback settings - select parameters that should be sent to the publisher if pass back is configured for this publisher (Sold, Real Payout, Redirect URL, Buyer Raw Response, Buyer GUID, DID):
Tracking Data section contains Publisher Manager field, where you can assign select one of the managers to this publisher:
Address Information allows you to specify the physical address of the publisher. Click the pencil icon to enter the information:
Fill in the necessary information about the contact person related to this publisher:
The last Add Additional Contact Info field allows you to select additional fields that you want to be displayed in this section:
As soon as fields are selected, they appear in the field and in Contact Info section. Fill in the necessary information and click Save:
Configure this publisher to start the private source flow in order to sell their leads privately to one buyer.
Add the buyer that already has the private key generated in order to start selling publisher's leads privately to this buyer.
- You can connect only one buyer to this publisher.
- Once connected, the buyer cannot be removed from this block.
Click Add buyer, select the desired buyer in Buyer name drop-down menu and click Create connection:
A new record appears in the table below with the connected buyer and the private key:
As soon as the publisher is connected to the buyer, all their sources become private, available only to campaigns of the connected buyer, and their leads don't take part in the general lead flow.
User Management section allows to view, edit or delete user accounts for this publisher. Follow How to Create a Publisher User Account article for more details.
Partner Token section allows generating a token for API publisher in order to provide them with access to PX API so that they can post leads in HTTP format.
If there's no token yet, click Generate to create a partner token for this publisher:
As soon as the token has been generated, click copy icon to copy the token to your clipboard:
To deactivate a token and disable publisher's access to API, click Revoke.
To generate a new token, click Regenerate.
Margin per Leg
This section shows the list of legs, for which bidding settings are already configured:
Click Assign Margin to configure the margin or fixed price for a new leg.
To set margin per leg, select the desired leg in Leg Name drop-down, click Margin per Leg and enter the Margin percentage that will be applied to this leg (for example, 80%A new row will appear in the table below. To edit or remove publisher margin for this leg, click Details:) and click Create:
To set a fixed price per leg, select the desired leg in Leg Name drop-down, click Fixed Price per Leg and enter Fixed Price that will be applied to this leg (for example, $20) and click Create:
A new row will appear in the table below. To edit or remove publisher settings for this leg, click Action -> Details:
To remove publisher settings for this leg, click Action -> Delete and Yes in the confirmation pop-up.
Calls section allows assigning DID numbers to the publisher.
This section shows the list of DID numbers already assigned to this publisher:
Click Assign Phone Number to add a new number for this publisher.
Select the desired Vertical and choose the Phone Number from the list available on Twilio for this vertical:
Only one number can be set per each vertical. If you assign a new phone number to the vertical that already exists in the list below, the previous number will be automatically replaced by the new one for that vertical.
A new row will appear in the table below. To edit or remove publisher settings for this leg, click Details:
Assigning a new number to the publisher can take up to 15 minutes to update.
Calls are a relatively new feature in PX. If you click Assign Phone Number and see No free phone numbers available, contact our support department so that we reserve more numbers for you.