Follow

Advertisers integration guide: 5 quick steps to set up your ad campaign with a publisher using Affise

Welcome to Affise!

This article will be useful for Advertisers, who are starting to integrate with publishers using Affise. It is a detailed guide through all the steps each Advertiser should complete in order to set up the activity with the publishers on Affise.

And in case you still have questions about anything in it or in addition to the topic, we will leave more resources for you to check up on and contact details for you to use.

So here we will cover the following questions, which you might be curious about at the beginning of your activity:

  1. Step 1: Registration and details needed fo start;
  2. Step 2: Offer - how to set it up, which details to give, how to track it;
  3. Step 3: Postback parameters and types;
  4. Step 4: Test the chosen integration;
  5. Step 5: Track different events;
  6. Bonus: Completed integration checklist;
  7. Useful links and resources;

 

Let’s move forward with each of the questions in a more detailed overview: 

Step 1. Registration and details needed for start. 
In order to register your data in Affise, you would need to provide your details to a manager who is working with you at your Publisher’s end. We require these details:

  • Company Name
  • Contact person name
  • IM/Skype ID
  • Website URL
  • Email address (this will be your login to your statistics page later on).

After the information is added to your profile in Affise, you can proceed with Offers list preparation.


Step 2. Offer - how to set it up, which details to give, how to track it.
There are two ways of your offers to be added into Affise: manually and via API with our CPAPI tool, which will check the status of the offer frequently and update it for the publishers working with them. Let’s look into each case separately:

✏️Manual upload of offers: we usually require an advertiser name, offer name and tracking link as the main info for the offer to be created. Though it is always best to provide as many details about the offer as possible such as description, KPI, logo, targeting details, payout details, caps and other information that you think should be relevant to your publishers to find the best traffic for you. This should be communicated with your manager on your publisher’s side.

🚀CPAPI: this is a tool for mass import of offers, which can also upload all the offers of yours in one time API call and make sure that all the statuses of the offers are up to date. For this integration to happen you would need to provide your API documentation so that we could build a connection between our API and yours. Such integration might open your offers to one publisher only, or to all the Affise users, depending on the privacy level you choose for your source.

1__2_.png

Do you want to become a CPAPI demand source among for our 1000+ clients?
Contact us via cpapi@affise.com

❗️In terms of tracking part, this is probably one of the most crucial ones to be set properly. The tracking link is the instrument that connects a user with an ad and lets us all keep track of it. The main parameter for Affise to track the conversion properly by is clickid. The other ones are optional and are up to you to define, considering which information about the user or about the offer/affiliate would you like to track. 

An example of a tracking link, which Affise use:

http://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}

The full list of parameters we process is here.


The other way to set up the tracking part is a pixel integration, which works with the help of HTML code snippet analyzing users’ behavior or tracks conversions at the web-page or from opened email.


Step 3. Postback: parameters and types.
🔗Postback is the instrument which you should use to let us know that the conversion occurred on your end. The main parameter is used to locate the conversion is the clickid, which has been generated once the user has performed the action needed after an add. However, there might be other parameters passed in a postback call along with the click. These are the parameters you can pass:

clickid

a required parameter: should be replaced with advertiser’s macro for click id

action_id

unique request ID in the advertiser's system

goal

goal number or goal value

sum

payout for conversion 

ip

IP address of visitor who made a request (partially hidden in accordance with GDPR policy)

status

Approved - 1

Pending - 2

Declined - 3

Not found - 4

Hold - 5

referrer

referrer (additional information on traffic and deeplinks)

comment

comment

secure 

hash password generated on offer, advertiser level

custom_field1-8

custom field 1-8

 In addition to Server to Server Postback, described above you can use Pixel. The appropriate Pixel code should be provided to you along with the information on parameters and macros, which are different from a regular S2S postback and can be found here.


Step 4. Test the chosen integration.
Once both the Tracking link and Postback URL are set this is the time to test if everything is working properly and you are receiving all the information needed, as well as if Affise gets your Postback calls properly. There is a couple of ways to do it:
➡️1. There is an option to generate a test tracking link on a side of Affise for each of your offers, which has the parameter helping to distinguish the test conversion and do not affect the publisher’s balance. Such a link can be fired in the advertiser’s test environment to emulate the conversion. An example of a standard Affise test tracking link:

https://domain.afse.com/click?pid=2&offer_id=9999&sub1=testofferlink

➡️2. Another way to test is to make a real conversion and check the flow of all calls.

There should be successful records on conversions on your end, as well on the side of Affise to ensure all is set properly.


Step 5. Track different events.
In case there are CPA offers on your end, you might want to track different events or actions the same user performs. In order to do that we offer the option to set up several payouts, considering the event or action, which we call goal. Those goals are determined by the advertiser and should be set properly on both Affise and the advertiser’s side.

The goal should be set in the payout section on Affise side and then should be copied with appropriate parameter in a postback URL or pixel on the advertiser’s end. In case no &goal= parameter is added into the postback URL then the first goal payout set in Affise will be applied to the conversion. Here the full path on how we set goals in Affise.

Checklist for you to understand if you are all set for the activity:

Here is a short overview of what is must to be set in order to consider the integration successful. 

  1. ✅ Postback integration:  
 http://admin.affise.postback/?clickid={clickid}  

- where click ID is the main parameter for Affise platform to receive to track the conversion. Most frequent additional macros for use in a postback are: &goal={goal value}, &sum={conversion cost}, &status={status value}, etc.

  1. ✅ Tracking link integration: 
http://app.appsflyer.com/com.appsflyer?pid=mediaName_int&clickid={clickid}&af_siteid={pid}&af_c_id={offer_id}

  - where click ID is a required macro and the list of all possible macros for us to pass are here. 

  1. ✅ Test conversion: 

To confirm that both steps above are done properly it is recommended to make a test conversion. There is an option to create a test tracking link in Affise which can be fired on the Advertiser’s side. Once both sides: Affise and Advertiser are seeing the test conversion on their end you are good to go. An example of a standard test tracking link:

https://csdemo.g2afse.com/click?pid=2&offer_id=9999&sub1=testofferlink


In the end, such flow will be working for each new offer created in Affise:

RkEpRYEnlbwTFHJzuq3EnHFHjtbECKh1d7uOJzof.png

Useful links and resources. 
❓In case you have questions about anything in this article or on top of it, please feel free to let our team know: support@affise.com. We also will be happy to know your feedback on how informative you think this article is and if there is any topic you would like to know more about.


Meanwhile, please feel free to check out Affise Academy. 👨🏼‍🎓 This is a short courses resource which is created for Affise users mainly but also has a lot of information which might be useful for you too:

1579253042608.png

Also here are all the links used in the article in the text, in case you’ve missed any:



Stay Affised ;)

Author: Eugenia Salimanovych
Senior Customer Success Manager
mail: ys@affise.com

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.