Mindbox
In-App

Настройка операций в приложении для таргетинга in-app на операцию

Данный тип таргетинга доступен в версиях SDK 2.5.0 и выше для нативных приложений iOS и Android; в версии 2.6.0 и выше для приложений на Flutter и React Native.

Таргетинг по операции позволяет настроить in-app таким образом, что он будет показан в определенном месте приложения или при совершении пользователем действия. Для этого в приложении необходимо настроить операции, при вызове которых будет показываться in-app.

Если в приложении уже вызываются нужные операции, то настраивать дополнительно в приложении ничего не нужно. Вы можете использовать их в таргетинге in-app'ов.

  1. Выберите в приложении активности (например, клик по кнопке, переход на экран), в момент которых вы хотите показать пользователю in-app. Составьте список этих активностей. Желательно, чтобы активности в приложении iOS и Android совпадали. Иначе нужно будет создавать разные in-app'ы для разных приложений.
  2. Создайте операции по инструкции или обратитесь со списком активностей к менеджеру Mindbox.
  3. Настройте операции в приложении, используя системные имена операций в Mindbox.

Android

В приложении в момент, когда хотите показать in-app вызовите метод Mindbox.executeSyncOperation (исполнит синхронную операцию) или метод Mindbox.executeAsyncOperation (исполнит асинхронную операцию). В обоих методах в параметре operationName должна быть строка, соответствующая названию системной операции на которую таргетится in-app. Пример вызова:

KotlinCode
Mindbox.executeSyncOperation( context = applicationContext, operationSystemName = "some operation name", operationBodyJson = "some operation body in json format", onSuccess = { // Success Callback }, onError = { // Error callback } )
KotlinCode
Mindbox.executeAsyncOperation( context = applicationContext, operationSystemName = "some operation name", operationBodyJson = "some operation body in json format" )

После того, как внутри приложении произошел переход на экран, на котором вы хотите показать in-app, можно вызвать любую из операций с соответствующим именем в методах жизненного цикла activity onCreate, onStart или onResume. Если навигация работает на фрагментах, то операцию можно вызывать в методе жизненного цикла onViewCreated. Если для навигации используется jetpack compose, то операцию можно вызвать из любой composable функции.

Если вызывать операцию в методах жизненного цикла, отвечающих за уход с экрана, то in-app может либо успеть показаться на мгновение перед уходом, либо будет показан уже на след экране, в этом случае все решит гонка, делать так опасно.

Сейчас in-app по умолчанию покажется на старте приложения. Создавать отдельную операцию активности “старт приложения” не нужно.

iOS

В приложении в момент, когда хотите показать in-app вызовите метод Mindbox.shared.executeSyncOperation (исполнит синхронную операцию) или метод Mindbox.shared.executeAsyncOperation (исполнит асинхронную операцию). В обоих методах в параметре operationName должна быть строка, соответствующая названию системной операции на которую таргетится in-app. Пример вызова:

SwiftCode
Mindbox.shared.executeSyncOperation(operationSystemName: "some operation name", json: "some operation body in json format") { result in }
SwiftCode
Mindbox.shared.executeAsyncOperation(operationSystemName: "some operation name", json: "some operation body in json format")

Flutter

В приложении в момент, когда хотите показать in-app вызовите метод Mindbox.executeSyncOperation (исполнит синхронную операцию) или метод Mindbox.executeAsyncOperation (исполнит асинхронную операцию). В обоих методах в параметре operationName должна быть строка, соответствующая названию системной операции на которую таргетится in-app. Пример вызова:

DartDart
Mindbox.instance.executeAsyncOperation( operationSystemName: '<some operation name>', operationBody: { < объект с данными в формате Map <String, dynamic> > }, );
DartDart
Mindbox.instance.executeSyncOperation( operationSystemName: '<some operation name>', operationBody: { < объект с данными в формате Map <String, dynamic> > }, onSuccess: (data) { <метод обработки успешного ответа> }, onError: (error) { <метод обработки ответа с ошибкой> }, );

Сейчас in-app по умолчанию покажется на старте приложения. Создавать отдельную операцию активности “старт приложения” не нужно.

Можно вызывать в любой из этапов жизненного цикла ViewController, так как создается отдельное окно.

React Native

В приложении в момент, когда хотите показать in-app вызовите метод Mindbox.executeSyncOperation (исполнит синхронную операцию) или метод Mindbox.executeAsyncOperation (исполнит асинхронную операцию). В обоих методах в параметре operationName должна быть строка, соответствующая названию системной операции на которую таргетится in-app. Пример вызова:

TypeScriptTypeScript
MindboxSdk.executeAsyncOperation({ operationSystemName: '<системное имя операции>', operationBody: { <JS объект с данными> }, });
TypeScriptTypeScript
MindboxSdk.executeSyncOperation({ operationSystemName: '<системное имя операции>', operationBody: { <JS объект с данными> }, onSuccess: (data) => { ... }, onError: (error) => { ... }, });

Сейчас in-app по умолчанию покажется на старте приложения. Создавать отдельную операцию активности “старт приложения” не нужно.

Можно вызывать в любой из этапов жизненного цикла ViewController, так как создается отдельное окно.

Last modified on