Working with agencies (resell)

Agency is any serious company that sends you its traffic. The agency can be an affiliate network that took your resell offers, or an arbitration team that works with its own accounting system. The main difference between an agency and a simple user is the statistics by the source - the internal webmaster on the side of the agency.

How to create an agency?

A user cannot register as an agent on his own, you need to create an account for him. The algorithm is simple:

  1. Go to the "Control - Agencies" section, specify the name of the counterparty in the form and click "Create".
  2. On the page that opens, find the "Message" block, copy it and send it to the counterparty. The message will contain a link to the documentation, an API key, and a link to enter your personal account.
  3. If you accidentally skipped this page, click on the "Message" button in the "Agencies" section and the same text will appear again.
  4. Inform the counterparty that you have AlterCPA. Firstly, this way you show that you didn't spend lots of money on the development of your engine and immediately started using the best one. Second, but not least, they may have pre-made templates and this will make integration easier.

How to convert a user to an agency?

Sometimes users register on their own and get acquainted with your offers. You can convert such a user to an agency with almost all data and financial statistics preserved. To do this, do the following:

  1. Go to the "Control - Settings - Utilities - Users" section and find the "Convert to Agency" form there.
  2. Enter the user ID or email in this form and click Run. You can find them in the "Control - People" section.
  3. Go to "Control - Agencies" and copy the message with the new input data for the created agency.
  4. If necessary, rename the agency and the user associated with it in the "Agencies" and "People" sections, respectively.

Agency working methods

The agent can send traffic using three methods: via a tracking link, via API, or manually.

Sending leads via API

The standard way agencies work is to submit leads via the API. It is not supported within external offers, for them use the tracking links described below.

A link to the documentation is sent in the welcome message. Agencies can work with two API methods:

  • Lead submission: creates a new lead based on the data sent by the agent. Does not require creating threads, works with offer ID.
  • Check lead status: allows you to get submitted lead data by list of internal or external IDs, date range, and current status.

Important! Agents often confuse the API and try to send leads through the webmaster API. This results in a access error. Just send them the correct links again.

You can also get lead statuses by postbacks. Setting up postbacks is almost the same as the settings for the user. An agency can use two special options:

  • {uid} or {extu} - unique lead or click identifier sent in the extu parameter.
  • {src} or {exts} - source or webmaster ID sent in the exts parameter.

Tracking links

Agency links are a bit like user links. They support the same methods for setting pixels and tracking codes, but differ in three main parameters:

  • exti - agency identifier, constant parameter.
  • extu - unique identifier of the visit on the agency's side, based on which statistics are generated and postbacks are sent.
  • exts - identifier of the source or webmaster on the agency side, it can be used to issue access and special fees in the future.

Agency can generate links manually or use the "Link generator" tool in the "Traffic" section.

Manual lead submission

Agencies can always manually send leads to the same offers where API is allowed. It is available by clicking the "Add" button in the lead statistics section or on the separate "Manual lead submission" page of the "Traffic" section.

There are two options for sending, depending on your network settings:

  • Sending one lead: a classic form with customer contact details, tags, and order content. Completely duplicates the work of the API.
  • Mass sending of leads: allows you to send a lead to several offers at the same time, is responsible for working with brokerage traffic.