As an EPN (eBay Partner Network) publisher you will want to advertise all eBay listings on your website with proper tracking links. Most EPN tools and the REST APIs are capable of dynamically exposing individual tracking links for your EPN account. However, the Feed API does not provide tracking links.
The tracking link has two parts; the affiliate URL and the target URL. The following sections detail how to construct this link.
Affiliate URL
All tracking links use this primary URL structure:
{target}&mkevt={tracking event type}&mkcid={channel ID}&mkrid={rotation ID}&campid={EPN campaign ID}&toolid={tool ID}&customid={sub ID}
The following table describes the parameters outlined in the affiliate URL part of the tracking link above.
| Parameter | Description | Value Type | Requirements |
|---|---|---|---|
| target | The target URL part of the tracking link. | See the Target URL section. | Required |
| mkevt | The tracking event type. |
Number Valid values:
|
Required |
| mkcid | The channel ID. |
Number Valid values:
|
Required |
| mkrid |
The rotation ID for the target marketplace. See the rotation ID table below. |
String |
Required for performance marketing channels Optional for CRM |
| campid | The unique EPN campaign ID assigned to the eBay partner. | Number | Required |
| toolid | The unique ID assigned to the data source (such as API, link generator, or data feed,) that provided the link. |
Number Default value: |
Required |
| customid | The unique Sub ID created by the eBay partner. Also referred to as a Custom ID. | Number | Optional |
The following table lists the relevant marketplaces and respective rotation IDs.
| eBay ID | Country | Rotation ID |
|---|---|---|
| eBay AT | Austria (ebay.at) | 5221-53469-19255-0 |
| eBay AU | Australia (ebay.com.au) | 705-53470-19255-0 |
| eBay BE | Belgium (ebay.be) | 1553-53471-19255-0 |
| eBay CA | Canada (ebay.ca) | 706-53473-19255-0 |
| eBay CH | Switzerland (ebay.ch) | 5222-53480-19255-0 |
| eBay DE | Germany (ebay.de) | 707-53477-19255-0 |
| eBay ES | Spain (ebay.es) | 1185-53479-19255-0 |
| eBay FR | France (ebay.fr) | 709-53476-19255-0 |
| eBay IE | Ireland (ebay.ie) | 5282-53468-19255-0 |
| eBay GB | Great Britain (ebay.co.uk) | 710-53481-19255-0 |
| eBay IT | Italy (ebay.it) | 724-53478-19255-0 |
| eBay NL | Netherlands (ebay.nl) | 1346-53482-19255-0 |
| eBay PL | Poland (ebay.pl) | 4908-226936-19255-0 |
| eBay US | USA (ebay.com) | 711-53200-19255-0 |
Note: The Feed API only provides items only from marketplaces listed in Buy API Support by Marketplace. Many items listed on those marketplaces are eligible for cross-border trade and can be shipped to customers from other countries. If your customers are located in a country listed in the table above, make use of the corresponding top-level domain and rotation ID to redirect them to their local eBay marketplace.
Target URL
The target URL is the part of the EPN tracking link that is input into the target placeholder shown in the primary URL structure (see the Affiliate URL section).
Here is an example of a target URL:
https://www.ebay.{top-level domain}/itm/{listing ID}?var={variation ID}
The following table describes the parameters outlined in the target URL above.
Tracking link examples
The following table provides examples of properly constructed EPN tracking links, given the provided details.
| Affiliate URL Variables | Target URL | EPN Tracking Link |
|---|---|---|
|
https://www.ebay.de/itm/3**********7?var=6**********7 | https://www.ebay.de/itm/3**********7?var=6**********7&mkevt=1&mkcid=1&mkrid=707-53477-19255-0&campid=1234567890&toolid=10050&customid=abc123! |
|
https://www.ebay.co.uk/itm/1**********3?var=0 | https://www.ebay.co.uk/itm/1**********3?var=0&mkevt=1&mkcid=1&mkrid=710-53481-19255-0&campid=1234567890&toolid=10050&customid=abc123! |
Tracking priority listings with your Affiliate URL
The bootstrap and daily feeds include a Priority Listing attribute which you can use to track your priority listings with your Affiliate URL.
To create a priority listing tracking URL:
-
Begin with your Affiliate URL.
For example:
https://www.ebay.co.uk/itm/1**********3?var=0&mkevt=1&mkcid=1&mkrid=710-53481-19255-0&campid=1234567890&toolid=10050&customid=abc123! -
Make a call with the getItemFeed method of the Feed API, and retrieve the priorityListingPayload value.
For example:
amdata=enc%3AAQAFAAAAkB1DmsmXf%2BqZ%2BCEMGdebW6oR75GCMdBmc4MCQ%2FCEPqgKHbT0jdWhPwfY5LdUs6HTaP0eBlwKE7Smy2eDslewF7l3xjwWxjqwzNAnsYgxn2PiGkTKbiQSQytFUiymdtANpk1qOnBOoMGMK%2BWsji7jYlvySSs9o9s24TxD6RqWZpNrltzOU7mfnv3H40SZ3YESzg%3D%3 -
Append the priorityListingPayload value to your Affiliate URL to create your priority listing tracking link.
For example:
https://www.ebay.co.uk/itm/1**********3?var=0&mkevt=1&mkcid=1&mkrid=710-53481-19255-0&campid=1234567890&toolid=10050&customid=abc123!&amdata=enc%3AAQAFAAAAkB1DmsmXf%2BqZ%2BCEMGdebW6oR75GCMdBmc4MCQ%2FCEPqgKHbT0jdWhPwfY5LdUs6HTaP0eBlwKE7Smy2eDslewF7l3xjwWxjqwzNAnsYgxn2PiGkTKbiQSQytFUiymdtANpk1qOnBOoMGMK%2BWsji7jYlvySSs9o9s24TxD6RqWZpNrltzOU7mfnv3H40SZ3YESzg%3D%3D
Integrating with the Item Priority Feed
You should have already integrated with Bootstrap and Daily feeds and have a pipeline established for inventory curation. See Feed API integration for more information.
These are the additional steps you will need to follow to consume the Item Priority Feed:
- Integrate with the new feed endpoint to get your priority listing updates.
- Make a call with the getItemFeed/getItemPriorityFeed method of the Feed API, and retrieve the priorityListingPayload value.
Note: You must consume the Daily feeds before consuming the Item Priority Feeds. This ensures that your inventory is up to date.
- Update your inventory with the information obtained in the Priority Tracking Payload for the applicable priority listings.
Note: Once you have established your own curation criteria, not all priority listings will apply to your inventory.