Android
Offer Wall Integration
Plug in Your Offer Wall Profile
Launching an AdWall requires at least three parameters or data points: your publisher ID, the AdWall ID associated with an AdWall profile that you have created, and the unique ID of the user who is using the AdWall. The AdWall ID you use, along with your publisher ID, you should have retrieved on the last step of the previous page after having setup your AdWall profile.
Showing the Offer Wall
Before proceeding make sure you have integrated the SDK in your project. To display the offer wall, initialize a new Intent with the values you gathered above for Publisher ID and Offer Wall ID, along with the end user's unique ID for subId1.
String publisherId = "32740"; String adwallId = "2074"; String subId1 = "demo_subid1"; Intent intent = OffersActivity.getIntentForOfferWall(this, publisherId, adwallId, subId1); startActivity(intent);
You can also download a sample Android Studio project showing how to integrate our offer wall.
Intent with Optional Parameters
There are a few optional properties you can use as well (usage outline below):
Hashtable<String, String> options = new Hashtable<String, String>(); options.put(OffersActivity.SUB_ID2, "demo_subid2"); options.put(OffersActivity.SUB_ID3, "demo_subid3"); options.put(OffersActivity.SUB_ID4, "demo_subid4"); options.put(OffersActivity.GENDER, OffersActivity.GENDER_MALE); options.put(OffersActivity.AGE_RANGE, OffersActivity.AGE_18_TO_35); Intent intent = OffersActivity.getIntentForOfferWall(this, publisherId, adwallId, subId1, options); startActivity(intent);
The above Intent examples are the only ways the offer wall should be initialized.
Optional Properties
You can use the OffersActivity.GENDER
and OffersActivity.AGE_RANGE
properties to get access to
more offers for your users.
OffersActivity.GENDER
Options | Property Value |
---|---|
male | OffersActivity.GENDER_MALE |
female | OffersActivity.GENDER_FEMALE |
OffersActivity.AGE_RANGE
Options | Property Value |
---|---|
18-35 | OffersActivity.AGE_18_TO_35 |
35-45 | OffersActivity.AGE_35_TO_45 |
45-55 | OffersActivity.AGE_45_TO_55 |
55-65 | OffersActivity.AGE_55_TO_65 |
65+ | OffersActivity.AGE_65 |
The remaing optional parameters are OffersActivity.SUB_ID2
, OffersActivity.SUB_ID3
,
and OffersActivity.SUB_ID4
. Like the subid1
parameter in the Intent, you can set the
value of these to whatever you like, as they are used only for your own tracking purposes. If you have a certain group of users you want track collectively, such as users using a premium version of your app, you could set one of these optional subids to the same value for each of these users. You will then be able
to retrieve statistics for this group in the publisher dashboard.
Eclipse-ADT Integrate Google Play Services
Our SDK utilizes Google Play Services to access the Google Advertising ID and it will not compile without Google Play Services integrated into your Eclipse project. If you have not integrated Google Play Services in your project yet, please follow the Google Play Services integration guide.
The AndroidManifest.xml file should contain the following activity declaration and permissions:
<uses-permission android:name="android.permission.INTERNET"/> <uses-permission android:name="android.permission.READ_PHONE_STATE"/> <activity android:name="com.adscendmedia.sdk.ui.OffersActivity" android:configChanges="orientation|screenSize"> </activity>
If you have any questions about integrating our Offer Wall into your project, shoot us an email at
SDKsupport@adscendmedia.com