Publisher API documentation

Tracking Link Parameters and Postback Macros

Use these parameters to send click metadata into Enligne Survey and the matching macros to receive conversion data in your server postback.

At a glance: Enligne Survey receives click data from a publisher and sends the relevant values back when a conversion occurs. The names on the tracking link and the macros in the postback must be mapped correctly.

Parameters for a publisher tracking URL

Add the parameters you need when generating the publisher tracking link. The publisher should replace each placeholder with the matching macro from its own system.

ParameterDescription
p1The publisher's unique click ID. This is the key value used to match a later conversion.
sourceThe publisher's sub-publisher or traffic-source ID.
p2p10Open parameters for any additional publisher metadata required by your integration.
app_nameThe publisher application name.
creative_nameThe creative or placement name used by the publisher.
gaidGoogle Advertising ID supplied by the publisher, when available and permitted.
idfaApple Identifier for Advertisers supplied by the publisher, when available and permitted.

Publisher tracking URL example

https://tracking.example/click?campaign_id=5509&pub_id=2&p1={PUBLISHER_CLICK_ID}&source={SUB_PUB_ID}&gaid={GAID}&idfa={IDFA}&app_name={APP_NAME}

Verification: if a parameter is empty in reporting, confirm that the publisher is sending the value and has replaced the example placeholder with its real system macro.

Customizing the publisher tracking URL

Keep only the parameters used by your integration, give the publisher a short mapping for every parameter, and test one click before sending production traffic. Do not place secrets or personal data in a tracking URL.

Macros for a publisher postback URL

Place these macros against the corresponding publisher parameter in its postback URL.

MacroDescription
{p1}The original publisher click ID. This is mandatory for server-to-server attribution.
{p2}{p10}The matching open parameter values received on the click.
{payout_usd} or {payout}The conversion payout value.
{txn_id}The unique conversion transaction ID.
{sub1}{sub10}Open values received from the advertiser or survey provider.
{goal_value}The goal or event on which the conversion was received.

Publisher postback example

Ask the publisher for its click-ID parameter, the values it expects, and the events for which it needs a postback. If its click-ID parameter is aff_sub, a mapping can look like this:

https://publisher.example/postback?aff_sub={p1}&goal={goal_value}&sub_id={txn_id}

Integration tips

  • Map each publisher parameter to exactly one Enligne Survey macro.
  • Use p1 for the publisher click ID and return it as {p1}.
  • Use HTTPS endpoints and validate postback requests on the server.
  • Test click, conversion, duplicate, and reversal flows before going live.

Quick mapping: publisher parameter = Enligne Survey macro. For example, tracking link &p1={aff_sub} maps to postback &aff_sub={p1}.