評估使用者參與度

Sebastian Benz

本指南將說明如何評估 Chrome 自訂分頁的參與度信號。如果您的應用程式會定期向使用者顯示網頁內容連結 (例如在新聞動態消息中)，瞭解使用者認為哪些連結有價值，哪些連結則不會。在「自訂分頁中」，你可以利用導覽次數、捲動方向變更和捲動深度，評估工作階段特定使用者的參與度。如要瞭解參與信號的應用實例，請參考 GitHub 上的自訂分頁試用版應用程式。

自訂分頁提供兩種不同的回呼，用於評估使用者參與度：

• CustomTabsCallback 用於追蹤基本導覽事件，例如 "NAVIGATION_STARTED" 或 "NAVIGATION_FINISHED"。
• EngagementSignalsCallback 用於追蹤特定網頁的使用者參與度，例如捲動方向或捲動百分比。

兩者都必須啟用 CustomTabsServiceConnection。請參閱先前的 CustomTabsService 指南，進一步瞭解如何連線至 CustomTabsService。

如要評估使用者參與度，請先建立 CustomTabsCallback 和 EngagementSignalsCallback 例項。CustomTabsCallback 會收到 navigationEvent 常數，說明發生的瀏覽類型：

private CustomTabsCallback mCustomTabsCallback = new CustomTabsCallback() {
    @Override
    public void onNavigationEvent(int navigationEvent, @Nullable Bundle extras) {
        String event;
        switch (navigationEvent) {
            case CustomTabsCallback.NAVIGATION_ABORTED:
                event = "NAVIGATION_ABORTED";
                break;
            case CustomTabsCallback.NAVIGATION_FAILED:
                event = "NAVIGATION_FAILED";
                break;
            case CustomTabsCallback.NAVIGATION_FINISHED:
                event = "NAVIGATION_FINISHED";
                break;
            case CustomTabsCallback.NAVIGATION_STARTED:
                event = "NAVIGATION_STARTED";
                break;
            case CustomTabsCallback.TAB_SHOWN:
                event = "TAB_SHOWN";
                break;
            case CustomTabsCallback.TAB_HIDDEN:
                event = "TAB_HIDDEN";
                break;
            default:
                event = String.valueOf(navigationEvent);
        }
        Log.d(TAG, "onNavigationEvent (navigationEvent=" + event + ')');
        mTextNavigation.setText("onNavigationEvent " + event);
    }
};

EngagementSignalsCallback 支援三種不同的回呼：

onVerticalScrollEvent()

在使用者變更捲動方向時呼叫，其中 isDirectionUp (第一個引數) 表示方向。

1. onGreatestScrollPercentageIncreased：使用者抵達網頁底部時，自訂分頁信號會在 5% 的間隔期間捲動深度 (最多 100%)。只有在使用者停止捲動時，才會叫用回呼。每次新增導覽元素時，值都會重設為 0%。
2. onSessionEnded：自訂分頁會在停止傳送參與度信號 (例如使用者關閉「自訂」分頁後) 時觸發這個事件。如果使用者透過任何方式與頁面互動 (捲動、點選按鈕等)，則 didUserInteract 為 true。

private EngagementSignalsCallback mEngagementSignalsCallback = new EngagementSignalsCallback() {
    @Override
    public void onVerticalScrollEvent(boolean isDirectionUp, @NonNull Bundle extras) {
        Log.d(TAG, "onVerticalScrollEvent (isDirectionUp=" + isDirectionUp + ')');
        mTextVerticalScroll.setText("vertical scroll " + (isDirectionUp ? "UP️" : "DOWN"));
    }

    @Override
    public void onGreatestScrollPercentageIncreased(int scrollPercentage, @NonNull Bundle extras) {
        Log.d(TAG, "scroll percentage: " + scrollPercentage + "%");
        mTextGreatestPercentage.setText("scroll percentage: " + scrollPercentage + "%");
    }

    @Override
    public void onSessionEnded(boolean didUserInteract, @NonNull Bundle extras) {
        Log.d(TAG, "onSessionEnded (didUserInteract=" + didUserInteract + ')');
        mTextSessionEnd.setText(didUserInteract ? "session ended with user interaction" : "session ended without user interaction");
    }
};

CustomTabsCallback 和 EngagementSignalsCallback 都必須具備有效的自訂分頁服務連線。連結服務後，您可以呼叫 CustomTabsClient.newSession() 並傳遞 CustomTabsCallback 來建立新的 CustomTabsSession。

之後，請呼叫 isEngagementSignalsApiAvailable()，確認目前的瀏覽器是否支援參與式信號。如果系統支援，您可以透過 CustomTabsSession.setEngagementSignalsCallback() 註冊 EngagementSignalsCallback。

private CustomTabsClient mCustomTabsClient;
private CustomTabsSession mCustomTabsSession;

private final CustomTabsServiceConnection mServiceConnectionCallback = new CustomTabsServiceConnection() {

    @Override
    public void onCustomTabsServiceConnected(@NonNull ComponentName name, @NonNull CustomTabsClient client) {
        mCustomTabsClient = client;
        mCustomTabsSession = mCustomTabsClient.newSession(mCustomTabsCallback);
        try {
            boolean engagementSignalsApiAvailable = mCustomTabsSession.isEngagementSignalsApiAvailable(Bundle.EMPTY);
            if (!engagementSignalsApiAvailable) {
                Log.d(TAG, "CustomTab Engagement signals not available, make sure to use the " +
                        "latest Chrome version and enable via chrome://flags/#cct-real-time-engagement-signals");
                return;
            }
            mCustomTabsSession.setEngagementSignalsCallback(mEngagementSignalsCallback, Bundle.EMPTY);
        } catch (RemoteException e) {
            Log.w(TAG, "The Service died while responding to the request.", e);
        } catch (UnsupportedOperationException e) {
            Log.w(TAG, "Engagement Signals API isn't supported by the browser.", e);
        }
    }

    @Override
    public void onServiceDisconnected(ComponentName name) {
        mCustomTabsClient = null;
        mConnection = null;
        mCustomTabsSession = null;
    }
};

只須繫結 CustomTabsService 即可：

@Override
protected void onStart() {
    super.onStart();
    bindCustomTabsService();
}

private void bindCustomTabsService() {
    String packageName = CustomTabsHelper.getPackageNameToUse(this);
    if (packageName == null) return;
    CustomTabsClient.bindCustomTabsService(this, packageName, mConnection);
}