Hướng dẫn tích hợp CleverNET Android SDK 3.0

Từ ngày 08/01/2014, CleverNET chính thức ra mắt bộ SDK 3.0 dành cho hệ điều hành Android. So với bộ SDK 2.0, phiên bản 3.0 có nhiều cải tiến về tính năng và hiệu quả quảng cáo.

• Hỗ trợ các định dạng quảng cáo mới : Cost Per Action, Banner Mix, SMS, Rich Media, Fullscreen, PopUp, Banner
• Hỗ trợ tích hợp với phiên bản Admob mới nhất (Phân bổ theo CPM)
• Tracking số liệu chính xác và hiệu suất cao hơn

Chú ý: Các publisher đã tích hợp quảng cáo CleverNET với bộ SDK 2.0 để update lên bộ SDK 3.0 chỉ cần thao tác add,  import lại bộ SDK 3.0 và build lại project.

Bước 1: Download thư viện CleverNET SDK 3.0

- Publisher đăng ký account trên hệ thống và tạo profile ứng dụng quảng cáo theo hướng dẫn tại đây
- Tải thư viện CleverNET SDK cho Android tại đây
- Project mẫu đã tích hợp quảng cáo của CleverNET tại đây
- Hệ thống CleverNET đã cấu hình sẵn 06 loại Banner Ads, 01 loại Text Ads, 01 loại Video Ads  phục vụ cho việc demo ứng dụng SDK với các thông số như sau :

STT	Tên	Kích thước	ZoneID Demo
1	mma	320×50	TEST_BANNER_MMA
2	medium_rectangle	300×250	TEST_BANNER_MEDIUM
3	leaderboard	728×90	TEST_BANNER_LEADERBOARD
4	fullscreen	768×768	TEST_BANNER_FULLSCREEN
5	portrait	766×66	TEST_BANNER_PORTRAIT
6	landscape	1024×66	TEST_BANNER_LANDSCAPE
7	Text Ads		TEST_TEXT
8	Video Ads		TEST_VIDEO

Bước 2: Thêm SDK vào project

Thêm thư viện CleverNET_Android_SDK_x.x_out.jar  vào project của bạn theo các bước sau:

1. Tạo thư mục con đặt tên là libs trong thư mục gốc (nếu chưa có sẵn).
2. Copy file  CleverNET_Android_SDK_x.x_out.jar vào thư mục libs
3. Bấm chuột phải chọn tab Package Explorer
4. Chọn Properties.
5. Chọn Java Build Path
6. Chọn Libraries trong cửa sổ chính
7. Chọn Add JARs…
8. Chọn  file CleverNET_Android_SDK_x.x_out.jar file mà bạn vừa copy vào thư mục libs
9. Chọn OK để thêm thư viện CleverNET SDK vào project.

Bước 3: Cấu hình file Manifest

-  Thêm vào file AndroidManifest.xml  các thuộc tính của CleverNET: + Trong thẻ application , thêm publisher_token:

<meta-data android:value=“TEST_BANNER_MMA“ android:name=“clevernet_site_token” />

(Chú ý:  TEST_BANNER_MMA  là zoneid được cấp từ trang home CleverNET sau khi tạo Zone từ phần 1. Bạn thay giá trị zoneid đúng của bạn) + Thiết lập các quyền bắt buộc cho chương trình kết nối vào mạng internet và hỗ trợ SDK 3.0 (Yêu cầu đầy đủ các quyền như bên dưới mới có thể hiện thị được các kiểu RichMedia, Fullscreen…)

<uses-permission android:name=”android.permission.INTERNET” />
<uses-permission android:name=”android.permission.ACCESS_NETWORK_STATE”/>
<uses-permission android:name=”android.permission.READ_PHONE_STATE” />
<uses-permission android:name=”android.permission.WRITE_EXTERNAL_STORAGE” />

<uses-permission android:name=”android.permission.ACCESS_WIFI_STATE”/>
<uses-permission android:name=”android.permission.ACCESS_LOCATION_EXTRA_COMMANDS” />
<uses-permission android:name=”android.permission.VIBRATE” />
<uses-permission android:name=”android.permission.ACCESS_COARSE_LOCATION” />
<uses-permission android:name=”android.permission.ACCESS_FINE_LOCATION” />
<uses-permission android:name=”android.permission.CALL_PHONE” />
<uses-permission android:name=”android.permission.SEND_SMS” />   
<uses-permission android:name=”android.permission.WRITE_SMS” />
<uses-permission android:name=”android.permission.READ_SMS” />

Bước 4: Tạo file attrs.xml

- Tạo file attrs.xml trong thư mục res/values của project như sau :
+ Mở thư mục res > chuột phải chọn values > chọn new > file
+ Đặt tên file cần tạo là attrs.xml
+ Khai báo các thuộc tính CleverNET SDK trong file này như sau:

<?xml version=“1.0″ encoding=“utf-8″?>
<resources>
<declare-styleable name = ”vn.clevernet.android.sdk.ClevernetView”>
<attr name=”secondsToRefresh” format=”integer” /> <attr name=”backgroundColor” format=”color” />
<attr name=”textSize” format=”integer” />
<attr name=”textColor” format=”color” />
<attr name=”bannerType” format=”string” />
<attr name=”deliverOnlyText” format=”boolean” />
<attr name=”animation” format=”string” />
</declare-styleable>
</resources>

Bước 5: Thiết lập phần hiển thị quảng cáo trong layout

- Thêm namespace cads vào file layout bạn muốn đặt quảng cáo hiển thị

xmlns:cad=“http://schemas.android.com/apk/res/your.package.name”

- Thêm ClevernetView vào layout

<vn.clevernet.android.sdk.ClevernetView
    android:id=“@+id/cadad” 
    android:layout_width=“fill_parent”
    android:layout_height=“wrap_content”
    cad:backgroundColor=“#555″
    cad:textColor=“#FF1F1F”
    cad:bannerType=“mma”
    cad:animation=“fade”
    cad:textSize=“20″
    cad:deliverOnlyText=“false”
/>

File layout mẫu có dạng :

<?xml version=“1.0″ encoding=“utf-8″?>
<LinearLayout xmlns:android=“http://schemas.android.com/apk/res/android”
    xmlns:cad=“http://schemas.android.com/apk/res/vn.clevernet.samples”
    android:layout_width=“fill_parent”
    android:layout_height=“fill_parent”
    android:orientation=“vertical”>
 <TextView
    android:layout_width=“fill_parent”
    android:layout_height=“wrap_content”
    android:text=“@string/hello”/>
 <vn.clevernet.android.sdk.ClevernetView
    android:id=“@+id/cadad”
    android:layout_width=“fill_parent”
    android:layout_height=“wrap_content”
    cad:backgroundColor=“#555″
    cad:textColor=“#FF1F1F”
    cad:bannerType=“mma”
    cad:animation=“fade”
    cad:textSize=“20″
    cad:deliverOnlyText=“false”/>
</LinearLayout>

Bước 6: Gọi api hiển thị quảng cáo

- Trong file Activity chính của chương trình, implements thêm  ClevernetViewCallbackListener

public class MainActivity extends Activity implements ClevernetViewCallbackListener

- Thiết lập các tùy chọn

import vn.clevernet.android.sdk.ClevernetView;
import vn.clevernet.android.sdk.ClevernetView.ClevernetViewCallbackListener;

- Trong hàm onCreate

 // set the callback listener, to receive a message when an ad was loaded
ClevernetView clevernetView = (ClevernetView)findViewById(R.id.cadad);
clevernetView.setCleverNetViewCallbackListener(this);

- @Override lại 1 số hàm sau:

@Override
public void onLoaded(final boolean succeed, final ClevernetView cadView ) {
    }
      public void onError(final Exception exception) {
    }
    public void onIllegalHttpStatusCode(final int statusCode, final String message) {
    }
@Override
public void onAdClicked() {                  
}
 
@Override
public void onApplicationPause() {
}
@Override
public void onApplicationResume() {     
}

Bước 7: Build và chạy ứng dụng