HMS Core地理圍欄能力助你實現指定範圍人群的精準消息推送

精準推送是移動端產品留存階段的主要運營手段,精準推送常常會與用戶畫像緊密結合,針對用戶的喜好、畫像,採用不同策略,但基於用戶所屬區域推送消息卻很難實現。目前市面上大多數第三方消息推送服務商,在系統未深度訂製的情況下,通常不支援將推送人群範圍精確到某個商圈或較小的區域,而地理圍欄技術可以很好地彌補這一點。地理圍欄就是用一個虛擬的柵欄圍出一個虛擬地理邊界,當手機進入、離開或在這個圍起來的特定地理區域內活動時,手機可以自動接收通知和警告消息。將地理圍欄和消息推送相結合,即可實現對特定區域人群的精準消息推送。

舉個例子,一款旅遊出行類App想在江蘇推廣其門票業務,他可以針對南京、蘇州等城市的熱門旅遊景點劃定地理圍欄,當目標受眾在特定時間段到達某個旅遊景點附近時,將會收到一條特定消息推送「XX景點門票優惠券已放入賬戶中,立即領取>>」在用戶有購買XX景點門票需求時應景推送優惠資訊,讓用戶無法拒絕。

實現方法

用華為定位服務地理圍欄能力結合推送服務消息推送能力,就可實現對指定範圍人群的精準消息推送。通過設置特定的區域,可以檢測用戶的事件狀態,例如他們何時進入、離開或停留在該區域,一旦滿足觸發條件,用戶設備將實時收到消息推送。即使應用不在後台運行,也可以在用戶設備上傳遞和顯示消息,消息傳遞率可達99%。

效果展示:

  1. 在測試設備上安裝演示應用。

  2. 啟動演示應用程式,點擊地理圍欄螢幕上的添加地理圍欄,然後設置相關參數以創建地理圍欄。

  3. 等待地理圍欄被觸發。

  4. 在觸發地理圍欄時檢查收到的消息。

開發步驟

  1. 配置SDK的Maven倉地址。

(Android Studio的程式碼庫配置在Gradle插件7.0以下版本、7.0版本和7.1及以上版本有所不同。請根據您當前的Gradle插件版本,選擇對應的配置過程。這裡以7.1版本為例)

a) 在「buildscript > dependencies」中增加agcp插件配置。

buildscript {
i.	    dependencies {
ii.	        ...
iii.	        // 增加agcp插件配置,推薦您使用最新版本的agcp插件。
iv.	        classpath 'com.huawei.agconnect:agcp:1.6.0.300'
    }
v.	}

b) 項目級「settings.gradle」文件,配置HMS Core SDK的Maven倉地址。

pluginManagement {
    repositories {
        gradlePluginPortal()
        google()
        mavenCentral()
        // 配置HMS Core SDK的Maven倉地址。
        maven { url '//developer.huawei.com/repo/' }
    }
}
dependencyResolutionManagement {
    ...
    repositories {
        google()
        mavenCentral()
        // 配置HMS Core SDK的Maven倉地址。
        maven { url '//developer.huawei.com/repo/' }
    }
}

2.在「dependencies 」中添加如下編譯依賴。

//應用級的「build.gradle」文件
dependencies {
    implementation 'com.huawei.hms:location: 6.4.0.300'
    implementation 'com.huawei.hms:push: 6.3.0.304'
}
  1. 在 AndroidManifest.xml 文件中聲明系統許可權。

因華為定位服務採用GNSS、Wi-Fi、基地台等多種混合定位模式進行定位,賦予您的應用程式快速、精準地獲取用戶位置資訊的能力,需要用到網路,精確的位置許可權,粗略的位置許可權如果您需要應用程式在後台執行時也具備持續定位能力,需要在Manifest文件中申請ACCESS_BACKGROUND_LOCATION許可權:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_COARES_LOCATION" />

註:由於ACCESS_FINE_LOCATION,WRITE_EXTERNAL_STORAGE和READ_EXTERNAL_STORAGE是危險的系統許可權,因此,您需要動態的申請這些許可權。如果許可權不足,Location Service將會拒絕為您的應用開啟定位。

關鍵程式碼說明

程式碼文件路徑: com.huawei.hmssample2.geofence\GeoFenceActivity.java

如果您的應用需要集成圍欄Service實現服務推送,僅僅需要參考將GeoFenceActivity集成到您的應用中在接收圍欄回調的同時發出推送的廣播,即可實現。

  1. 觸發地理圍欄。

a) 根據需要創建地理圍欄和地理圍欄組,並設置相應的參數,比如圍欄半徑,觸發時間等。

if (checkStyle(geofences, data.uniqueId) == false) {
    LocationLog.d("GeoFenceActivity", "not unique ID!");
    LocationLog.i("GeoFenceActivity", "addGeofence failed!");
    return;
}
geoBuild.setRoundArea(data.latitude, data.longitude, data.radius);
geoBuild.setUniqueId(data.uniqueId);
geoBuild.setConversions(data.conversions);
geoBuild.setValidContinueTime(data.validContinueTime);
geoBuild.setDwellDelayTime(data.dwellDelayTime);
geoBuild.setNotificationInterval(data.notificationInterval);
geofences.add(geoBuild.build());
LocationLog.i("GeoFenceActivity", "addGeofence success!");

b) 設置好相關參數之後通過intent註冊廣播

GeofenceRequest.Builder geofenceRequest = new GeofenceRequest.Builder();
geofenceRequest.createGeofenceList(GeoFenceData.returnList());
if (trigger.getText() != null) {
    int trigGer = Integer.parseInt(trigger.getText().toString());
    geofenceRequest.setInitConversions(trigGer);
    LocationLog.d(TAG, "trigger is " + trigGer);
} else {
    geofenceRequest.setInitConversions(5);
    LocationLog.d(TAG, "default trigger is 5");
}

final PendingIntent pendingIntent = getPendingIntent();
try {
    geofenceService.createGeofenceList(geofenceRequest.build(), pendingIntent)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(Task<Void> task) {
                if (task.isSuccessful()) {
                    LocationLog.i(TAG, "add geofence success!");
                    setList(pendingIntent, GeoFenceData.getRequestCode(), GeoFenceData.returnList());
                    GeoFenceData.createNewList();
                } else {
                    // Get the status code for the error and log it using a user-friendly message.
                    LocationLog.w(TAG, "add geofence failed : " + task.getException().getMessage());
                }
            }
        });
} catch (Exception e) {
    LocationLog.i(TAG, "add geofence error:" + e.getMessage());
}
private PendingIntent getPendingIntent() {
    Intent intent = new Intent(this, GeoFenceBroadcastReceiver.class);
    intent.setAction(GeoFenceBroadcastReceiver.ACTION_PROCESS_LOCATION);
    Log.d(TAG, "new request");
    GeoFenceData.newRequest();
    return PendingIntent.getBroadcast(this, GeoFenceData.getRequestCode(), intent,
        PendingIntent.FLAG_UPDATE_CURRENT);
}
  1. 觸發消息推送。
在GeoFenceBroadcastReceiver的onReceive接收到圍欄觸發成功提示後發送推送通知,在通知欄接收通知並展示。
GeofenceData geofenceData = GeofenceData.getDataFromIntent(intent);
if (geofenceData != null) {
    int errorCode = geofenceData.getErrorCode();
    int conversion = geofenceData.getConversion();
    ArrayList<Geofence> list = (ArrayList<Geofence>) geofenceData.getConvertingGeofenceList();
    Location myLocation = geofenceData.getConvertingLocation();
    boolean status = geofenceData.isSuccess();
    sb.append("errorcode: " + errorCode + next);
    sb.append("conversion: " + conversion + next);
    if (list != null) {
        for (int i = 0; i < list.size(); i++) {
            sb.append("geoFence id :" + list.get(i).getUniqueId() + next);
        }
    }
    if (myLocation != null) {
        sb.append("location is :" + myLocation.getLongitude() + " " + myLocation.getLatitude() + next);
    }
    sb.append("is successful :" + status);
    LocationLog.i(TAG, sb.toString());
    Toast.makeText(context, "" + sb.toString(), Toast.LENGTH_LONG).show();
    //
    new PushSendUtils().netSendMsg(sb.toString());
}

注意:使用示例程式碼創建的地理圍欄將觸發轉化類型 1 和 4 的兩個回調。一個在用戶進入地理圍欄時觸發,另一個在用戶停留在地理圍欄內時觸發。如果在程式碼中將 Trigger 設置為 7,則會配置所有方案(包括進入、停留和離開地理圍欄)的回調。

完成以上開發步驟就可以完成地理圍欄推送功能,實現在指定區域內推送消息通知實現精準營銷。

了解更多詳情>>

訪問華為開發者聯盟官網
獲取開發指導文檔
華為移動服務開源倉庫地址:GitHub、Gitee

關注我們,第一時間了解 HMS Core 最新技術資訊~

Tags: