Mengukur interaksi pengguna

Sebastian Benz

Panduan ini menjelaskan cara mengukur sinyal engagement untuk tab Kustom Chrome. Jika aplikasi Anda secara rutin menampilkan link ke konten web kepada penggunanya, misalnya di feed berita, sebaiknya ketahui link mana yang dianggap berharga oleh pengguna dan mana yang tidak. Di Tab Kustom, Anda dapat mengukur engagement pengguna khusus sesi melalui jumlah navigasi, perubahan arah scroll, dan kedalaman scroll. Untuk melihat cara kerja sinyal engagement, lihat aplikasi demo Tab Kustom di GitHub.

Demo sinyal engagement Tab Khusus.

Custom Tabs menyediakan dua callback berbeda untuk mengukur engagement pengguna:

  • CustomTabsCallback untuk melacak peristiwa navigasi dasar, seperti "NAVIGATION_STARTED" atau "NAVIGATION_FINISHED".
  • EngagementSignalsCallback untuk melacak engagement pengguna khusus halaman, seperti arah scroll atau persentase scroll.

Keduanya memerlukan CustomTabsServiceConnection yang aktif. Lihat panduan CustomTabsService sebelumnya untuk mengetahui detail tentang cara terhubung ke CustomTabsService.

Untuk mengukur engagement pengguna, buat instance CustomTabsCallback dan EngagementSignalsCallback terlebih dahulu. CustomTabsCallback menerima konstanta navigationEvent yang menjelaskan jenis navigasi yang terjadi:

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 mendukung tiga callback yang berbeda:

onVerticalScrollEvent()
Dipanggil setiap kali pengguna mengubah arah scroll, dengan isDirectionUp (argumen pertama) menunjukkan arahnya.
  1. onGreatestScrollPercentageIncreased: Tab Kustom menandakan kedalaman scroll dalam interval 5% hingga 100% saat pengguna telah mencapai bagian bawah halaman. Callback hanya dipanggil setelah pengguna berhenti men-scroll. Nilai direset ke 0% dengan setiap navigasi baru.
  2. onSessionEnded: Tab Kustom memicu peristiwa ini saat berhenti mengirim sinyal engagement (misalnya, setelah pengguna menutup Tab Kustom). didUserInteract akan bernilai benar jika pengguna berinteraksi dengan halaman dengan cara apa pun (men-scroll, mengklik tombol, dll.).
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 dan EngagementSignalsCallback memerlukan koneksi layanan Tab Kustom yang aktif. Setelah layanan terhubung, Anda dapat membuat CustomTabsSession baru dengan memanggil CustomTabsClient.newSession() dan meneruskan CustomTabsCallback.

Setelah itu, Anda harus memanggil isEngagementSignalsApiAvailable() untuk memeriksa apakah sinyal engagement didukung oleh browser saat ini. Jika didukung, Anda dapat mendaftarkan EngagementSignalsCallback melalui CustomTabsSession.setEngagementSignalsCallback().

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

Satu-satunya hal yang perlu dilakukan adalah mengikat 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);
}