Ads OAID (OAID)

Introduction

HUAWEI Ads provides the open advertising identifier (OAID) for you to deliver personalized ads and monetize traffic on Huawei devices.

OAID
An OAID is a non-permanent device identifier. You can use the OAID to provide personalized ads for users while protecting their privacy.
Disable personalized ads
You can obtain a user's OAID and setting of Disable personalized ads through open APIs provided by Huawei.
If the user turns off Disable personalized ads, you can use the OAID to trace and recommend personalized ads, improving advertising precision.
If the user turns on Disable personalized ads, serving personalized ads based the OAID is not allowed, but you can still serve non-personalized ads to the user.
Privacy Protection
A user can choose to reset the OAID and turn on Disable personalized ads under Settings > Privacy > Ads and Privacy or Settings > Security & privacy > More settings > Device identifier of their devices, to protect the privacy of their personal data.
If a user resets the OAID, a new OAID is generated. Then, you can only obtain this new OAID.

OAID Capabilities

You can provide personalized marketing activities or commercial ads for users based on OAIDs to improve the conversion effect.

Your app can call APIs of HUAWEI Ads to obtain a user's OAID and setting of Disable personalized ads.
If the user turns off Disable personalized ads, your app can carry out personalized marketing activities and serve ads to this user based on the audiences to which the user's OAID belongs.
If the user clicks an ad displayed in your app, your app can download and install the promoted app.
Your app carries the OAID in impression, click, download, and other events to track and analyze the effect of marketing activities or commercial ads.

What You Will Create

In the codelab, you will create an app to access HUAWEI Ads.

Your app obtains an OAID and setting of Disable personalized ads.

What You Will Learn

Integrate the OAID capabilities of HUAWEI Ads.

Hardware Requirements

A Huawei mobile phone or tablet.

Software Requirements

HMS Core (APK) 2.6.2 or later.
To view the HMS Core (APK) version on a device, go to Settings > Apps > Apps and search for HMS Core.

Download and decompress the CodeLab_AdsOAID_Initial_Demo.zip file.

Download

Use Android Studio to open the CodeLab_AdsOAID_Initial_Demo project.

1.Integrate the SDK.

Step 1: Configure the Maven repository address for the HUAWEI Ads SDK.

Open the build.gradle file in the root directory of your Android Studio project. Go to allprojects > repositories and configure the Maven repository address for the SDK.

/CodeLab_AdsOAID_Initial_Demo/build.gradle


allprojects {
    repositories {
        google()
        jcenter()
        maven { url 'https://developer.huawei.com/repo/' }
    }
}

Step 2: Configure build dependencies.

Open the build.gradle file in the app directory. Configure build dependencies.

/CodeLab_AdsOAID_Initial_Demo/app/build.gradle


dependencies {
    implementation 'com.huawei.hms:ads-identifier:{version}'
}

Step 3: Synchronize the modified files.

Step 4: (Mandatory) Configure the obfuscation scripts.

/CodeLab_AdsOAID_Initial_Demo/app/proguard-rules.pro


-keep class com.huawei.hms.ads.** { *; }
-keep interface com.huawei.hms.ads.** { *; }

2.Call the static method getAdvertisingIdInfo to obtain the OAID.
Create a subthread and call the static method AdvertisingIdClient.getAdvertisingIdInfo(mContext) to obtain the OAID information. Do not call this method in a main thread. The sample code is as follows:
/CodeLab_AdsOAID_Initial_Demo/app/src/main/java/com/huawei/pps/hms/test/oaid/OaidSdkUtil.java


public static void getOaid(Context context, OaidCallback callback) {
    if (null == context || null == callback) {
        Log.e(TAG, "invalid input param");
        return;
    }
    try {
        AdvertisingIdClient.Info info = AdvertisingIdClient.getAdvertisingIdInfo(context);
        if (null != info) {
            callback.onSuccuss(info.getId(), info.isLimitAdTrackingEnabled());
        } else {
            callback.onFail("oaid is null");
        }
    } catch (IOException e) {
        Log.e(TAG, "getAdvertisingIdInfo IOException");
        callback.onFail("getAdvertisingIdInfo IOException");
    }
}

Compile the CodeLab_AdsOAID_Initial_Demo project to generate an APK file and install the APK file on a device. After the app is launched, the following information is displayed. You can click OAID Sample to view the result in the right figure.

Well done. You have successfully completed this codelab and learned how to:

Integrate the OAID capabilities of HUAWEI Ads.

For more information, please click the following link: