このページは Cloud Translation API によって翻訳されました。

ユーザーエンゲージメントを測定する

Sebastian Benz

このガイドでは、Chrome カスタムタブのエンゲージメントシグナルを測定する方法について説明します。ニュースフィードなどで、ウェブコンテンツへのリンクがユーザーに定期的に表示される場合、ユーザーにとって価値があるリンクとそうでないリンクを把握することが重要になります。カスタムタブでは、ナビゲーションの数、スクロール方向の変化、スクロール距離など、セッションごとのユーザーエンゲージメントを測定できます。エンゲージメントシグナルの実際の動作を確認するには、GitHub にあるカスタムタブのデモアプリをご覧ください。

カスタムタブエンゲージメントシグナルのデモ。

注意: この機能には androidx.browser:browser:1.6.0-alpha01 以降が必要です。groovy dependencies { … implementation 'androidx.browser:browser:1.6.0-alpha02' }

カスタムタブには、ユーザーエンゲージメントを測定するための 2 種類のコールバックがあります。

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 は、次の 3 種類のコールバックをサポートしています。

onVerticalScrollEvent(): ユーザーがスクロール方向を変更するたびに呼び出されます。isDirectionUp（最初の引数）は方向を示します。

onGreatestScrollPercentageIncreased: カスタムタブは、ユーザーがページの一番下に達したときに、5% 間隔でスクロール距離を最大 100% で知らせます。コールバックは、ユーザーがスクロールを停止したときにのみ呼び出されます。この値は、新しいナビゲーションごとに 0% にリセットされます。
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");
    }
};

重要なポイント: onGreatestScrollPercentageIncreased イベントをリセットするには、メインフレームで新しいドキュメントへの新しいナビゲーションを発生させる必要があります。つまり、単一ページアプリケーション内のナビゲーションやアンカーへのナビゲーションでは、スクロール距離はリセットされません。

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);
}

ユーザー エンゲージメントを測定する

ユーザーエンゲージメントを測定する