로딩중입니다
adPOPcorn Offerwall : Android
5/27/2015 11:22:09 AM

adPOPcorn OfferWall


adPOPcorn service is a monetization service that displays the OfferWall (charging station) inside the app providing profits for the developer depending on the number of completed advertisements.

Please refer below guide to see more information about adPOPcorn service.

[adPOPcorn Service Guide]


NOTE.
  1. Before integrate adPOPcorn Add-on, IGAW Common integration must be finished. [IGAW Common Integration: Android]
  2. IgawAdpopcorn~*.jar file should be included in Android project. [SDK Installation: Android]

  3. In case that reward is cashable asset, please follow below QA process.(Update 2016/1/1)
    [adPOpcorn Reward Media QA]



AndroidManifest.xml


Edit the Android Manifest file for the adPOPcorn integration.

Other than the app key, hash key, and permission setup in the mutual integration,  you can add reward server types and required activities.


Add Permission

Add permissions as below in-between <manifest></manifest> tag.

GET_ACCOUNT / WRITE_EXTERNAL_STORAGE Permission should be added to block abusing google accounts which attempts same campaign for multiple times. 

<uses-permission android:name="android.permission.GET_ACCOUNTS"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>

GET_ACCOUNT permission is required higher than adPOPcorn SDK 4.0.5 version.


Reward Server Type Setting

<application></application> See below to set the integration method of the (*)reward server. Set a custom server as the main server.

<meta-data android:name="igaworks_reward_server_type" android:value="server"/>

(*)Reward Server Integration Method

It sets the system to receive reward information transmitted from the IGAW reward server. It is recommended that a developer establishes the callback server to receive callbacks.

It is more convenient to use Internal servers to maintain and manage security or CS resolution.

If it's difficult to establish an internal callback server, use the IGAW reward server to receive callbacks from the client.

In this case, a igaworks_reward_server_type should be set as the "client" and additional API integration is also necessary.

[Client Reward Server Integration : Client Method]

 

Add Required Activity 

Add the required activity to the <application></application> tag. This is critical for proper OfferWall service.

<activity android:name="com.igaworks.adpopcorn.activity.ApOfferWallActivity_NT"
          android:theme="@android:style/Theme.Translucent.NoTitleBar"/>

<activity android:name="com.igaworks.adpopcorn.activity.ApCSActivity_NT"
          android:theme="@android:style/Theme.NoTitleBar"
          android:screenOrientation="landscape"/>

<activity android:name="com.igaworks.adpopcorn.activity.ApVideoAdActivity"
          android:theme="@android:style/Theme.NoTitleBar"
          android:hardwareAccelerated="true"/>

+ Are you looking to participate as an adPOPcorn advertiser?

If you wish to execute CPI or more effective advertisements through the adPOPcorn ad network, you should register the Google installation receiver.

[IGAW Google Installation Receiver : Android



adPOPcorn API

After the mutual integration is completed, the adPOPcorn API becomes available. Use the APIs below to proceed with the integration to display adPOPcorn OfferWall.

 

Enter User Identification Value

User identification value is a set of information to identify users who have completed the campaign and are eligible for a reward.

User Identification Value should be set before user open OfferWall.


NOTE
  1. Personal information should not included. (e.g., e-mail, name, telephone number, identifiable user ID, etc.)
  2. If a Korean character, spacing, or special character is used, it must be URL encoded.
  3. It should be set before the openOfferwall API is called up.
  4. It must be set before user open the OfferWall. 

 

User identification values should be entered while keeping the notices above in mind.

IgawCommon.setUserId("user10001");



Display OfferWall

openOfferWall  api should be called up to display OfferWall. To execute OfferWall, click events through a button, banner or image are necessary.

offerwallBtn.setOnClickListener(new View.OnClickListener() {
    @Override
    public void onClick(View v) {
        //Display offerwall
        IgawAdpopcorn.openOfferWall(MainActivity.this);
    }
});


Extra Option: Device Rotation


Device Rotation

To utilize landscape mode for a device, setup setSensorLandscapeEnable api.

//true:rotation mode, false:fixed mode
IgawAdpopcorn.setSensorLandscapeEnable(MainActivity.this, true);


Event Listener

Event Listener is provided after OfferWall is completed. Select an action for when OfferWall completes.

IgawAdpopcorn.setEventListener(MainActivity.this, new IAdPOPcornEventListener() {
    @Override
    public void OnClosedOfferWallPage() {
        //Define an action to take when the OfferWall completes.
    }
});

adPOPcorn OfferWall Theme API

Change adPOPcorn OfferWall theme by calling up ApStyleManager API.

// OfferWall Theme Color Code Setting
ApStyleManager.setThemeColor(ApStyleManager.BLUE_THEME);

// OfferWall Theme Text Color Code Setting
ApStyleManager.setTextThemeColor(ApStyleManager.BLUE_THEME);

// OfferWall Reward Box Color Code Setting
ApStyleManager.setRewardThemeColor(ApStyleManager.BLUE_THEME);

// OfferWall Reward Check Color Code Setting
ApStyleManager.setRewardCheckThemeColor (ApStyleManager.BLUE_THEME);

// OfferWall Title Color Code Setting
ApStyleManager.setOfferwallTitleColor(Color.parseColor(“#000000”);

// OfferWall Title Setting
ApStyleManager.setOfferwallTitle(“OfferWall”);

// OfferWall Title Logo Setting
// ** Cannot use with setOfferwallTitle **
ApStyleManager.setOfferwallTitleLogo(R.drawable.logo);


Below is default theme set in ApStyleManager API. Enter color code according to below example.

public static int RED_THEME = 0xff9d261c;
public static int BLUE_THEME = 0xff3d7caf;
public static int YELLOW_THEME = 0xffffba03;


Reward Server Integration and Quality Assurance (QA)


The integration process to display OfferWall in the app has been completed.

Proceed to the reward server integration to provide actual rewards to the users who completed a campaign.

[IGAW Reward Server Integration Guide]

 

After the reward server integration is completed, perform a test ad for proper verification of ad participation and mileage points. Request QA following this step.

QA is a required process to use the adPOPcorn OfferWall. Use the apply QA feature in the adPOPcorn Admin page and submit the APK.

You will receive the results in about a few business days.


QA inquiries: QA@igaworks.com