В этом руководстве объясняется, как измерить сигналы взаимодействия для пользовательских вкладок Chrome. Если ваше приложение регулярно отображает ссылки на веб-контент своим пользователям, например, в ленте новостей, может быть важно знать, какие ссылки пользователи находят ценными, а какие нет. В пользовательских вкладках вы можете измерить вовлеченность пользователя в конкретном сеансе по количеству переходов, изменениям направления прокрутки и глубине прокрутки. Чтобы увидеть сигналы взаимодействия в действии, ознакомьтесь с демонстрационным приложением Custom Tabs на 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
(первый аргумент) указывает направление.
-
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");
}
};
И CustomTabsCallback
, и EngagementSignalsCallback
требуют активного подключения к службе пользовательских вкладок. После подключения службы вы можете создать новый CustomTabsSession
, вызвав CustomTabsClient.newSession()
и передав CustomTabsCallback
.
После этого вам следует вызвать isEngagementSignalsApiAvailable()
чтобы проверить, поддерживаются ли сигналы взаимодействия текущим браузером. Если они поддерживаются, вы можете зарегистрировать свой EngagementSignalsCallback
с помощью 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;
}
};
Единственное, что осталось сделать, — это привязать 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);
}