vNative <> Apsalar Integration

This article is intended for ad networks who are using the vNative platform and would like to integrate with Apsalar App Tracking solution.

Apsalar is able to send attribution data to vNative for both install and in-app events.

To initiate the integration you need to sendApsalar:

  1. Your tracking link
  2. Your postback (for installs and in-app events)

Creating your Apsalar Tracking Link

The tracking link consists of the below Apsalar base tracking link and additional macros added by the ad-network.

See below Apsalars base tracking link with a detailed explanation per macro:

Apsalar Base URL Description
http://ad.apsalar.com/api/v1/ad Apsalar end point
st SmartTag ID
h Apsalar’s assigned security hash
cr Creative ID
andi Android ID – Android only
aifa Android Advertising ID
s source
idfa Advertising Identifier in RAW format – iOS only
cl Click ID assigned by vNative (Ad Network)

See below what the complete tracking link should look like after you have added additional vNative macros. For Apsalar complete list of parameters click here.

Sample URL:

https://ad.apsalar.com/api/v1/ad?re=0&st=495043612154&andi={andi}&and1={andi_sha1}&aifa={gaid}&aif5={gaid_md5}&aif1={gaid_sha1}&s={aff_id}&ifa5={ios_ifa_md5}&idfa={ios_ifa}&ifa1={ios_ifa_sha1}&and5={andi_md5}&cl={click_id}&cr={creative_id}&h=ed2c35c9161f00b852e9d686cf1f4410ce11e02f

vNative Macros:

For the vNative complete list of macros click here.

vNative Identifiers Description
{andi} Android ID
{andi_sha1} sha1 of android id
{andi_md5} md5 of android id
{gaid} Unhashed Android Advertising Identifier
{gaid_md5} md5 of Android Advertising Identifier
{ios_ifa} SHA-1 of iOS Advertising Identifier
{ios_ifa_md5} md5 of iOS Advertising Identifier
{ios_ifa_sha1} SHA-1 of iOS Advertising Identifier
{creative_id} Creative ID assigned of the Creative you have used
{click_id} Click ID generated by vNative

Creating your Install and In-App Event Postbacks

See below a step by step explanation on how to create your install and in-app event postbacks at the vNative platform:

  1. Create or select a campaign that uses the Postback w/Click ID protocol
  2. In the details section of the campaign page, select postback URL in Conversion tracking
  3. Copy the postback URL that appears in the box labeled conversion tracking URL
  4. Remove the {click_id} parameter and value from the postback URL to change the postback from a specific postback into a global postback

For more information please click here.

Global Install Postback:

For Android:

https://track.vnative.com/acquisition?click_id={click_id}&security_token=SECURITY_TOKEN&sub1={SITE}&sub2={AIFA}&sub3=install&sub4=android

For iOS:

https://track.vnative.com/acquisition?click_id={click_id}&security_token=SECURITY_TOKEN&sub1={SITE}&sub2={IDFA}&sub3=install&sub4=ios

SECURITY_TOKEN is the unique security token name provided by vNative.

Global In-App Event Postback:

For Android:

https://track.vnative.com/acquisition?click_id={click_id}&security_token=SECURITY_TOKEN&goal_id=GOAL_ID&sub1={SITE}&sub2={AIFA}&sub3={EVTNAME}&sub4=android

For iOS:

https://track.vnative.com/acquisition?click_id={click_id}&security_token=SECURITY_TOKEN&goal_id=GOAL_ID&sub1={SITE}&sub2={IDFA}&sub3={EVTNAME}&sub4=ios

SECURITY_TOKEN is the unique security token name provided by vNative.

GOAL_ID = Set as Event Tag in the Apsalar dashboard for each app by the advertiser – this is the actual in-app event name from the application.

For details of Dynamic Event Mapping for In-App Events, click here.

Create Your Account Now!

Get Started with 30 Days FREE Trial Account. No credit card required.

Get Started FREE