Sending postbacks

Sending postbacks is used to notify advertising networks, banner networks or other analytic tools about the received conversions.

You can add a postback of a third party service in two ways:

  1. When creating a traffic source;
  2. When creating a campaign.

When creating a traffic source from a template, the Postback URL field is filled automatically.

How to set up the sending of postback for a new source?

If there is no your traffic source in the templates, you need to find out:

  1. Does your traffic source support postbacks
  2. Which token is used to send “click_id” (ID of a click)
  3. To what address send postbacks

After receiving all the information, you need to configure the following:

  1. Press on the edit parameters of the new traffic source;
  2. Next to “external_id” set the token for passing the click ID. Usually this is similar to {UID}.
  3. In the “Postback URL” field, paste the received postback of the source. Where you need to pass ID of a click, enter the macro {external_id}. For example,{external_id}.

You can add a postback in the campaign settings in a similar way, but with some features: it is necessary to set which statuses will be sent and for what sources (these are not traffic sources, but the contents of the parameter source) - you can leave the last part empty for not checking the source.

If you have any questions about the correctness of sending postbacks, see the log “Sent postbacks” on the page “Maintenance > Logs”.

What macros are available?

Available all macros from page macro_list. Also you can use these macros:

  • {external_id} — click id that was sent by traffic source
  • {status} — conversion status
  • {tid} — transaction id

What if the Traffic Source has another status names?

You can specify how to convert them:

{status: lead=install sale=bill rejected=trash}

How to send other statuses

You can determine how to convert statuses for a {status} macro, e.g. -1 - cancel, 0 - sign up, 1 - deposite:

{status: rejected=-1 lead=0 sale=1} 

How to see the results of sent postbacks?

Show log entries on page “Maintenace > Logs > Sent postbacks”.

When does Keitaro send a postback?

When Keitaro receives a postback with a conversion, it sends the postback to the traffic source.