Z tego przewodnika dowiesz się, jak mierzyć sygnały zaangażowania w przypadku kart niestandardowych w Chrome. Jeśli Twoja aplikacja regularnie wyświetla użytkownikom linki do treści internetowych, np. w kanale wiadomości, warto wiedzieć, które linki są dla nich wartościowe, a które nie. Na kartach niestandardowych możesz mierzyć zaangażowanie użytkowników w konkretnej sesji na podstawie liczby nawigacji, zmian kierunku przewijania i głębokości przewijania. Aby zobaczyć, jak działają sygnały zaangażowania, zarejestruj się w aplikacji demonstracyjnej Karty niestandardowe na GitHubie.
Karty niestandardowe udostępniają 2 różne wywołania zwrotne do pomiaru zaangażowania użytkowników:
CustomTabsCallback
– do śledzenia podstawowych zdarzeń nawigacji, np."NAVIGATION_STARTED"
lub"NAVIGATION_FINISHED"
.EngagementSignalsCallback
– pozwala śledzić zaangażowanie użytkowników związane ze stroną, np. kierunek przewijania lub procent przewijania.
Oba te elementy wymagają aktywnego CustomTabsServiceConnection
. Szczegółowe informacje o łączeniu z aplikacją CustomTabsService
znajdziesz w poprzednim przewodniku CustomTabsService
.
Aby mierzyć zaangażowanie użytkowników, najpierw utwórz wystąpienia CustomTabsCallback
i EngagementSignalsCallback
. CustomTabsCallback
otrzymuje stałą navigationEvent
opisującą rodzaj nawigacji:
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
obsługuje 3 różne wywołania zwrotne:
onVerticalScrollEvent()
- Wywoływane za każdym razem, gdy użytkownik zmieni kierunek przewijania. Kierunek jest określony za pomocą
isDirectionUp
(pierwszy argument).
onGreatestScrollPercentageIncreased
: karta niestandardowa sygnalizuje głębokość przewijania w odstępach co 5% do 100%, gdy użytkownik dotrze do dołu strony. Wywołanie zwrotne jest wywoływane dopiero wtedy, gdy użytkownik zakończy przewijanie. Wartość jest resetowana do 0% przy każdej nowej nawigacji.onSessionEnded
: karta niestandardowa uruchamia to zdarzenie, gdy przestanie wysyłać sygnały zaangażowania (np. gdy użytkownik zamknie kartę niestandardową).didUserInteract
ma wartość prawda, jeśli użytkownik w jakikolwiek sposób wszedł w interakcję ze stroną (przewinął stronę, kliknął przycisk itp.).
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");
}
};
Zarówno CustomTabsCallback
, jak i EngagementSignalsCallback
wymagają aktywnego połączenia z usługą karty niestandardowej. Po połączeniu z usługą możesz utworzyć nowy CustomTabsSession
, wywołując CustomTabsClient.newSession()
i przekazując CustomTabsCallback
.
Następnie skontaktuj się z operatorem isEngagementSignalsApiAvailable()
, aby sprawdzić, czy obecna przeglądarka obsługuje sygnały o zaangażowaniu. Jeśli są obsługiwane, możesz zarejestrować urządzenie EngagementSignalsCallback
przez 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;
}
};
Pozostało już tylko powiązać 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);
}