dependencies {+添加 SensorsFocus SDK 依賴implementation 'com.sensorsdata.analytics.android：SensorsFocusSDK：0.4.0'}

彈窗 SDK 整合 Demo，可參考[ GitHub

https://github.com/sensorsdata/sf-sdk-android]。

初始化神策分析 SDK... -初始化神策彈窗SDKSensorsFocusAPI.startWithConfigOptions（this， new SFConfigOptions（" 彈窗服務端位址"））;

SensorsFocusAPI.startWithConfigOptions（this， new SFConfigOptions（"彈窗服務端位址"）.setPopupListener (new PopupListener() { @Override public void onPopupLoadSuccess(String planId) {} @Override public void onPopupLoadFailed(String planId, int errorCode, String errorMessage) {} @Override public void onPopupClick(String planId, SensorsFocusActionModel actionModel) {} @Override public void onPopupClose( String planId) {}})); }

錯誤碼

描述資訊

1000

圖片載入失敗

1001

預覽資訊解析失敗，請檢查計劃配置

欄位

彈窗點擊後行為

SensorsFocusActionModel.CLOSE

點擊彈窗時就關閉彈窗

SensorsFocusActionModel. OPEN_LINK

點擊後開啟連結，可透過actionModel.getValue（） 取得連結

SensorsFocusActionModel.COPY

點擊後複製文字內容，可透過actionModel.getValue（） 取得複製文字

SensorsFocusActionModel.CUSTOMIZE

自訂行為，可透過actionModel.getExtra（） 獲取自訂欄位

public void onPopupClick(String planId, SensorsFocusActionModel actionModel) { switch (actionModel) { case OPEN_LINK: // 自定義處理打開連結操作String url = actionModel.getValue（）; Log.d("PopupClick", "url = " + url); break; case COPY： - 自定義處理複製操作String copyText = actionModel.getValue（）; Log.d("PopupClick", "copyText = " + copyText); break; case CLOSE： - 處理 close break; case CUSTOMIZE： - 處理自定義操作JSONObject customizeJson = actionModel.getExtra（）; break; }}

名詞

解釋 / 定義

備註

自定義觸達

使用神策智慧運營，滿足運營條件后，客戶可以自定義的觸達方式，例如可以發券、彈窗、跳轉、紅包雨等等

版本要求

• Android SDK v5.1.3 及以上版本
• 神策彈窗SDK v0.4.0 及以上版本

SensorsFocusAPI.startWithConfigOptions(this, new SFConfigOptions(apiBaseUrl).setCampaignListener(new SensorsFocusCampaignListener（） { /** * 返回 bool 值決定觸達是否開始 */ @Override public boolean campaignShouldStart（SFCampaign sfCampaign） { =如果是自定義觸達 if（SFCampaign.Type.CUSTOMIZED == sfCampaign.getType()){ try {JSONObject jsonObject = new JSONObject(sfCampaign.getContent()); } catch (JSONException e) {e.printStackTrace(); }}else if(SFCampaign.Type.PRESET == sfCampaign.getType()){ } return true ; } /** * 觸達開始時調用 */ @Override public void onCampaignStart（SFCampaign sfCampaign） {} /** * 觸達結束時調用 */ @Override public void onCampaignEnd（SFCampaign sfCampaign） {} /** * 觸達失敗時調用 */ @Override public void onCampaignFailed（SF Campaign sfCampaign, int errorCode, String errorMessage) {}}).setPopupListener(new PopupListener （） { /** * 彈窗載入成功 */ @Override public void onPopupLoadSuccess（String planId） {} /** * 彈窗載入失敗 */ @Override public void onPopupLoadFailed（String planId， int errorCode， String errorMessage） {} /** * 彈窗點擊 */ @Override public void onPopupClick（ String planId， SensorsFocusActionModel actionModel） {} /** * 彈窗關閉 */ @Override public void onPopupClose(String planId) {}}));

名稱

類型

說明

planId

String

計劃 ID，為下發欄位的 plan_id 取得

name

String

計劃名稱，為下發欄位的 cname 取得

content

String

計劃內容，為下發計劃欄位的 popup_window_content 中的 content 字段

type

SDK 內定義枚舉 Type

觸達類型，為 SDK 內枚舉，PRESET 為預置彈窗，CUSTOMIZED 為自定義觸達

觸達介面呼叫情況

發生情況

失敗原因（errorMessage）

失敗狀態碼 （errorCode）

備註

1

失敗

SensorsFocusCampaignListener 介面為空

自定義觸達計劃未實現彈窗生命周期回調

1006

2

is_trigger 為false

計劃下發 is_trigger 為 false

1005

3

campaignShouldStart 返回 false

campaignShouldStart 介面返回 false

1004

4

對照組，舊版邏輯

對照組

1003

舊版本相容處理

5

Activity 在後台，僅限彈窗，舊版邏輯

內部記錄失敗原因為空字串，不會傳遞給開發者

1002

舊版本仍然會觸發$PlanPopupDisplay 為成功的事件（$sf_succeed 為 true，且沒有 $sf_fail_reason 屬性）iOS 不會有這種情況， 所以考慮的是 Android 保持現狀，和之前一樣的邏輯

6

預覽 JSON 資訊解析失敗，舊版邏輯

預覽資訊解析失敗，請檢查計劃配置

1001

8

成功

展示彈窗

-

-

9

自定義觸達

-

-