Add Placement / Application
Last updated
Was this helpful?
Last updated
Was this helpful?
First, log into your ayeT-Studios Publisher dashboard and navigate to the Placements/Apps tab on the sidebar on the left-hand side. There you will see an ‘Add Application/Placement’ button:
The ‘Add new Placement’-creation dialogue will open after clicking on the ‘Add Application/Placement’-button.
Click the ‘Android App’-button if your app is already live or to be released in the Google Play Store.
After specifying the type of placement you want to create, more configuration options will appear.
Specify whether or not your Android app is already published in the Google Play Store. If your app is live, click the ‘Yes’-button and enter its Google Play URL below.
If your app is not live yet, click the ‘No’-button and enter your app’s package name below.
If you prefer your user balances to be stored and updated on our servers, click the ‘Our-Servers’-button, which is not recommended unless we’re your only advertising partner.
If you want your user balances to be stored and updated on your own servers, click the ‘Your-Servers’-button. This is the most common and recommended option, as you are able to work with multiple advertising partners more easily this way. Enter your Callback URL below.
When specifying your Callback URL, please refer to the ayeT-Studios Publisher Android SDK Integration Guide. Make sure that you supply us with a user identifier in order to track your users’ account balances when initializing our SDK. If you do not supply a user identifier, we will track your users’ account balances by device.
Assuming that you set the user identifier to ‘username’ in the SDK initialization and your Callback URL is
https://your-server.com/callback?network=ayetstudios&amount={currency_amount}&uid={uid}&device={advertising_id}&payout_usd={payout_usd}
A typical conversion callback sent by our servers will look as follows:
https://your-server.com/callback?network=ayetstudios&amount=360&uid=username&device=[GAID]&payout_usd=0.36 (random payout: $0.36)
IMPORTANT: Your server must always reply to our callbacks with an HTTP 200 status code. If this is not the case, we will resend the callback 12 times over a period of one hour before marking your conversion as ‘Failed’.
Available Macros for Postback URLs:
The ‘Proceed’-button should turn to a darker shade of blue if you’ve followed the previous steps correctly. Click this button to proceed to the ‘Add new Placement - Create first Adslot’-creation dialogue.
Now you need to specify what type of Adslot you would like to create. If you want to add an Offerwall to your app, click the ‘Offerwall’-button on the left and if you want to add a Native Offer Feed to your app, click the ‘Native Offer Feed’-button on the right.
After specifying, further configuration options will appear, which are identical for Offerwalls and Native Offer Feeds. For the sake of straightforwardness, we will continue by creating an Offerwall Adslot.
Enter the name of your choosing for your Adslot.
For each of your Adslots, you need to enter the name of your app’s virtual currency (singular AND plural).
Check out some examples of names for virtual currencies in the table below.
Singular
Plural
Coin
Coins
Diamond
Diamonds
Gold
Gold
Gold Bar
Gold Bars
Cupcake
Cupcakes
When setting up your Currency Conversion Rate, you have to make sure that you do it correctly: Let’s say that you would like to pay out 60% to your users of what you earn on our platform. You need to identify a monetary value within your app to determine the correct currency conversion rate.
If your app is a game that features in-app purchases and pays out 100 Coins for $1, you would set your conversion rate to $1=60 virtual currency. With every $1 that you earn from us, you will pay out 60ct to your users and keep 40ct for yourself.
Enter the Currency Conversion Rate in the text field as shown below.
Specify whether or not you require currency decimal places, which depend on the previously determined currency conversion rate:
Looking back at Examples 1 and 2 from the conversion rate section above, we will determine the proper respective currency decimal place settings.
In this game, $1=60 Coins. Single digit ct values are always the lowest possible payout. Let’s assume that you have to pay out $0.07 or 7ct to your user for completing an offer. These 7ct translate to 4.2 Coins in your app. Hence, you would choose to display 1 currency decimal place.
Choose the correct Currency Decimal Place settings in the drop-down menu as shown below.
Once you’ve figured out your Currency Conversion Rate and the according Currency Decimal Places, you can click the ‘Create Placement’-button in the bottom right corner of the creation dialogue.
After you’ve created your first Placement and Adslot, the creation dialogue will disappear and you will be back where you started in the Publisher Placements Overview. You can now see your newly created Placement and the Offerwall Adslot as shown below.
You can always click the ‘Edit Placement’-button to make changes to your Placement such as editing and testing your Callback URL.
You are able to send test postbacks on our dashboard in order to check whether or not your callback URL is set up correctly. Click the ‘Send Test Postback’-button as shown below to open the postback configuration window.
In order to check the status of your test postback, click the ‘Check Postback Status’-button as shown below or navigate to the Reports/Conversions section in the sidebar on the left hand side.
