ayeT-Studios Publisher In-App Webview Offerwall Integration Guide (v1.1)

Before integrating the offerwall in your app or website, you should sign up for a publisher account. Activate your account and login as publisher.

This type of web offerwall is intended to be called directly within your apps in a webview. These offerwalls are not intended to be loaded in an external browser or on PCs.
For browser based offerwalls check out our Mobile & Desktop Browser Offerwall Integration Guide.

Common use cases are:

• Integration in a native Android or iOS app
• Impossible to use our dedicated Android, iOS & Unity SDKs
• Access to the devices' advertising id (GAID or IDFA)

Technically, the offerwall has to be implemented directly in the app by using a Webview.

To create an in-app web placement, go to Add Application / Placement in your publisher account under Placements / Apps.
Select Web Offerwall as placement type and In-App Webview under Integration.

The URL template for our web offerwall looks like this:

https://www.ayetstudios.com/offers/web_offerwall/{PLACEMENT_ID}?advertising_id={ADVERTISING_ID}[&external_identifier={EXTERNAL_USER_IDENTIFIER}]

To retrieve the URL for one of your web offerwall placements, open its details tab in our dashboard and copy the "Webview Offerwall URL".

URL Parameters:

Parameter	Mandatory	Description
advertising_id	yes	Google Advertising ID (GAID) or Apple IDFA
external_identifier	no	Your identifier for the calling user - helps you identifying and matching S2S conversion callbacks
android_id	no	Optional: Can be used instead of GAID if it's impossible to fill the advertising_id, NOT recommended

If you're developing an app built upon native Android componenents, you can load the offerwall like this:

layout.xml:

<WebView
	android:id="@+id/myWebViewId"
	android:layout_width="match_parent"
	android:layout_height="match_parent"/>	                    

MyOfferwall.java:

...
String offerwallUrl = "https://www.ayetstudios.com/offers/web_offerwall/1?advertising_id="+adInfo.getId()+"&gaid_limited_string="+adInfo.isLimitAdTrackingEnabled()+"&external_identifier=myuser12";
// NOTE: check this for information on how to obtain the GAID -> http://www.androiddocs.com/google/play-services/id.html

WebView myWebView = (WebView) findViewById(R.id.myWebViewId);
myWebView.getSettings().setJavaScriptEnabled(true);
myWebView.setWebViewClient(new WebViewClient() {
    @Override
    public boolean shouldOverrideUrlLoading(WebView view, String url) {
        if( URLUtil.isNetworkUrl(url) ) {
            return false;
        }
        try {
            Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(url));
            startActivity( intent );
        } catch (Exception e) {
            return false;
        }
        return true;
    }
});
myWebView.loadUrl(offerwallUrl);	                

Attention: Make sure you don't forget to enable Javascript for your WebView!

For web offerwalls, you have to manually manage your users currencies on your own servers. You can configure a conversion callback url in our publisher dashboard.
To do so, navigate to Placements / Apps, edit your app placement and set the Callback Url to your server's postback url:


If this is the callback url your set for your app placement:

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 server will look like this:

https://your-server.com/callback?network=ayetstudios&amount=360&uid=username&device=[ADVERTISING_ID]&payout_usd=0.36

* Note: This assumes you passed &external_identifier=username to the webview URL, the currency conversion rate in your placement was 1000 per $1 and the user completed an offer with a $0.36 payout.

Important: Your server must always reply with an HTTP 200 status code to our postbacks. Otherwise we will resend the postback 12 times over a span of one hour before giving up.

Available Macros for Postback URLs:

{transaction_id}	string	Unique transaction id - use for duplicate checks
{payout_usd}	float	The actual conversion payout in USD
{currency_amount}	int	The amount of currency the user earned (taken from your offerwall currency configuration)
{uid}	string	The user identifier (EXTERNAL IDENTIFIER) originally passed in the web offerwall link
{user_id}	integer	Our internal id for this offerwall user
{placement_identifier}	string	The placement_identifier for which the conversion occured
{ip}	string	Converting device's IP address if known, 0.0.0.0 otherwise
{offer_id}	int	Offer ID of the converting offer
{offer_name}	string	Name / title of the converting offer
{device_uuid}	string	ayeT-Studios internal device identificator
{device_make}	string	Device manufacturer
{device_model}	string	Device model
{advertising_id}	string	Device advertising id (GAID/IDFA) if known, otherwise empty
{sha1_android_id}	string	Device sha1 hashed android id if known, otherwise empty
{sha1_imei}	string	Device sha1 hashed imei if known, otherwise empty

If your want to restrict postbacks to our callback server IPs, please whitelist the following IPs and check back regularly for possible changes:

35.165.166.40
35.166.159.131
52.40.3.140	    

Last IP List Update: 2017-04-07