Эта страница переведена с помощью Cloud Translation API.

Предлагайте ярлыки с помощью In-App Promo SDK.

Чтобы рекламировать функции вашего приложения и упростить его использование, вы можете предлагать пользователям ярлыки Ассистента. Ярлыки Ассистента — это краткие фразы, которые пользователь может произнести, чтобы активировать функции вашего приложения.

Хотя ваши пользователи могут создавать ярлыки Ассистента вручную, In-App Promo SDK позволяет вам заранее предлагать и реализовывать ярлыки Ассистента. Предлагая ярлыки, вы предоставляете пользователям понятные и простые пути назад к их любимым действиям в вашем приложении без дополнительных усилий по настройке ярлыков.

Например, если пользователь выполняет поиск по запросу «тренировка в стиле хэви-метал» в вашем музыкальном приложении, вы можете предложить в будущем ярлык Ассистента непосредственно к этим результатам поиска. Когда вы предлагаете ярлык, в вашем приложении появляется запрос, в котором отображается предложенная фраза для ярлыка и спрашивается, можно ли создать ярлык.

В этом примере вы предлагаете фразу «начни тренировку в стиле хэви-метал». Пользователь принимает предложение и затем может запустить ярлык, сказав: «Эй, Google, начни мою тренировку по хэви-металу».

Дополнительную информацию о способах расширения аудитории вашего приложения см. в разделе Расширение приложения с помощью действий в приложении .

SDK In-App Promo SDK предоставляет следующие методы:

lookupShortcut : проверяет, существует ли ярлык, который вы хотите предложить. Этот метод также проверяет наличие проблем, препятствующих созданию ярлыка. Если ярлык не может быть создан, lookupShortcut возвращает причину.
createShortcutSuggestionIntent : возвращает намерение, которое вы можете использовать, чтобы предложить пользователю создать предлагаемый ярлык.
createShortcutSettingsIntent : возвращает намерение, которое вы можете использовать для перемещения пользователя к настройкам ярлыка помощника для вашего приложения.

Предварительные условия и ограничения

В этом разделе описаны предварительные условия и требования для использования предложений, а также ограничения, с которыми вы можете столкнуться.

Предпосылки развития

Чтобы использовать предложения, ваша среда разработки должна соответствовать следующим предварительным требованиям.

Расширьте свое приложение Android, чтобы использовать действия приложения .

Включите com.google.android.googlequicksearchbox в тег <queries> вашего манифеста. Например:

<manifest ...>
  <queries>
    <package android:name="com.google.android.googlequicksearchbox" />
  </queries>
  ...
</manifest>

Используйте пакеты приложений Android для публикации своих приложений.

Требования к устройству

Чтобы проверить свои предложения на устройстве, на нем должно быть установлено следующее.

Последняя версия приложения Google
Android 6.0 (уровень API 23) или выше

Известные ограничения

Предложения поддерживаются только на английском языке. Чтобы пользователи могли видеть ваши предложения, им необходимо установить английский язык Ассистента на своем устройстве.

Реализуйте предложения

Чтобы реализовать предложения, вам необходимо обновить файл build.gradle , настроить клиент предложений, а затем определить предложения, которые вы хотите давать пользователям.

Добавьте зависимость библиотеки в файл build.gradle .

dependencies {
  ...
  implementation "com.google.assistant.appactions:suggestions:1.0.0"
}

Определите экземпляр AssistantShortcutSuggestionsClient .
Котлин
val shortcutsClient = AssistantShortcutSuggestionsClient.builder() .setContext(CONTEXT: Context) .setVerifyIntents(VERIFY_INTENTS: Boolean) .setCustomExecutor(CUSTOM_EXECUTOR: Object) .build()
Ява
AssistantShortcutSuggestionsClient shortcutsClient = AssistantShortcutSuggestionsClient.builder() .setContext(CONTEXT: Context) .setVerifyIntents(VERIFY_INTENTS: Boolean) .setCustomExecutor(CUSTOM_EXECUTOR: Object) .build();
В этом примере:
- CONTEXT (обязательно) — контекст приложения.
- VERIFY_INTENTS (обязательный) определяет, следует ли проверять каждое намерение, созданное при предложении пользователям ярлыков. Если true , проверяются намерения, созданные AssistantShortcutSuggestionsClient . Если намерение недействительно, возвращается исключение.
- CUSTOM_EXECUTOR (необязательно) — это пользовательский исполнитель для выполнения асинхронных задач. Если этот параметр не указан, SDK использует для этой задачи однопоточный исполнитель.

Используйте метод lookupShortcut , чтобы определить, действителен ли предлагаемый ярлык и, при необходимости, существует ли он уже.

Создайте намерение ярлыка приложения. Намерение ярлыка представляет собой ярлык, который вы хотите предложить пользователю. В следующем примере создается намерение использовать ярлык для заказа напитка.

Котлин

val menuItem = mapOf(
    "@type" to "MenuItem",
    "@context" to "http://schema.googleapis.com",
    "name" to "Fresh Lemon Honey Jasmine Green Tea",
)

val appShortcutIntent = AppShortcutIntent.builder()
    .setIntentName("actions.intent.ORDER_MENU_ITEM")
    .setPackageName("my.app.package")
    .setIntentParamName("menuItem")
    .setIntentParamValue(menuItem)
    .build()

Ява

  Map<String, Object> menuItem = new HashMap<>();
  menuItem.put("@type", "MenuItem");
  menuItem.put("@context", "http://schema.googleapis.com");
  menuItem.put("name", "Fresh Lemon Honey Jasmine Green Tea");

  AppShortcutIntent appShortcutIntent =
      AppShortcutIntent.builder()
          .setIntentName("actions.intent.ORDER_MENU_ITEM")
          .setPackageName("my.app.package")
          .setIntentParamName("menuItem")
          .setIntentParamValue(menuItem)
          .build();

Передайте намерение ярлыка методу lookupShortcut .

Котлин

val result = shortcutsClient.lookupShortcut(appShortcutIntent).await()
if (!result.isShortcutPresent) {
    // App can suggest creating a shortcut
} else {
    // App can remind the user that they have a shortcut for this app action
}

Ява

shortcutsClient.lookupShortcut(appShortcutIntent)
  .addOnSuccessListener(shortcutLookupResult -> {
    if (!shortcutLookupResult.isShortcutPresent()) {
      // App can suggest creating a shortcut
    } else {
      // App can remind the user that they have a shortcut for this app action
    }
  })
  .addOnFailureListener(e -> Log.e(TAG, "Shortcut lookup failed", e));

Создайте предложение, используя ярлык намерения. Для создания предложения можно использовать два метода:

createShortcutSuggestionIntent : возвращает намерение Android, которое вы используете для запуска действия по предложению ярлыков в контексте вашего приложения.

Котлин

val orderShortcut = AppShortcutSuggestion.builder()
    .setAppShortcutIntent(appShortcutIntent)
    .setCommand(PHRASE: String)
    .build()

val intent = shortcutsClient.createShortcutSuggestionIntent(orderShortcut).await()
application.startActivity(intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK))

Ява

  AppShortcutSuggestion orderShortcut =
      AppShortcutSuggestion.builder()
          .setAppShortcutIntent(appShortcutIntent)
          .setCommand(PHRASE: String)
          .build();

  shortcutsClient.createShortcutSuggestionIntent(orderShortcut)
      .addOnSuccessListener(intent ->
          getApplication().startActivity(
              intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK));
      )
      .addOnFailureListener(e ->
          Log.e(TAG, "Failed to get shortcut suggestion intent", e);
      );

В этом примере PHRASE — это высказывание, которое вы хотите предложить пользователю в качестве ярлыка. Например, если вы хотите, чтобы пользователь говорил «Эй, Google, закажи мой пузырьковый чай» в качестве ярлыка, замените PHRASE на "order my bubble tea" .

Котлин

val orderShortcut = AppShortcutSuggestion.builder()
    .setAppShortcutIntent(appShortcutIntent)
    .setCommand("order my bubble tea")
    .build()

Ява

AppShortcutSuggestion orderShortcut =
    AppShortcutSuggestion.builder()
        .setAppShortcutIntent(appShortcutIntent)
        .setCommand("order my bubble tea")
        .build();

createShortcutSettingsIntent : возвращает намерение Android, которое перемещает пользователя к интерфейсу настроек ярлыка в приложении Assistant.

Котлин

val intent = shortcutsClient.createShortcutSettingsIntent().await()
application.startActivity(intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK))

Ява

  shortcutsClient.createShortcutSettingsIntent()
    .addOnSuccessListener(intent ->
        getApplication().startActivity(
            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK));
    )
    .addOnFailureListener(e ->
        Log.e(TAG, "Failed to get shortcut settings intent", e);
    );

Вызовите startActivity используя намерение Android, полученное на предыдущем шаге.
Примечание. Если предлагаемый вами ярлык конфликтует с существующим ярлыком, пользователь останется в контексте вашего приложения, и ему будет предложено установить новый фрагмент для ярлыка.

Предлагайте ярлыки с помощью In-App Promo SDK.

Предварительные условия и ограничения

Предпосылки развития

Требования к устройству

Известные ограничения

Реализуйте предложения

Котлин

Ява

Котлин

Ява

Котлин

Ява

Котлин

Ява

Котлин

Ява

Котлин

Ява

Рекомендации по устранению неполадок

«GoogleInstallationUnsupportedException: невозможно привязаться к службе»

«Не удалось проверить подпись APK»

«Не удалось получить ярлыки пользователей»

Действие по созданию ярлыка немедленно закрывается без отображения какого-либо содержимого.