Android API
Установка
Для чтобы взаимодействовать с Hybrid API, вам надо добавить Hybrid зависимости, обновить permissions и инициализировать библиотеку.
1. Скопировать HybridAPI.jar в папку lib проекта
2. Откройте файл app/build.gradle и в раздел dependencies:
compile 'com.google.android.gms:play-services:8.4.0
3. Добавление permissions в app/src/main/AndroidManifest.xml
Скорее всего необходимые настройки уже имеются
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
4.Добавление Hybrid в main activity app/src/main/java/com/example/myapplication/MainActivity.java Не забудьте заменить pixelId на ваш действующий идентификатор пикселя, который вы получили при регистрации в Hybrid
HybridAPI.init("pixelId", getApplicationContext());
Этот код создаёт объект HybridAPI, с помощью которого вы сможете отправлять данные в Hybrid API.
Идентификация посетителя
Для идентификации посетителя вызовите следующий код:
HybridAPI.init().identify("customerId", "user_identity_properties");
Название поля | Тип | Описание |
---|---|---|
customerId | string | Уникальный клиентский идентификатор, задаваемый самим приложением. |
user_identity_properties | HashMap | Данные о посетителе. |
Идентификация пользователя с его свойствами
HashMap<String, String> userData = new HashMap<String, String>();
userData.put("name", "Иванов Иван");
userData.put("email", "ivan@mail.ru");
HybridAPI.init().identify("df43rf56f34", userData);
Идентификация нового пользователя
HybridAPI.init().identify("df43rf56f34");
Добавление свойств пользователю
HashMap<String, String> userData = new HashMap<String, String>();
userData.put("gender", "male");
userData.put("age", "24");
HybridAPI.init().identify(userData);
В user_identity_properties передаётся объект "{'age':24,'gender':male}" названия атрибутов произвольны. Тип значения определяется по шаблону, от типа зависят возможные условия для сбора аудитории.
Num | Равно |
Не равно | |
Больше | |
Больше или равно | |
Меньше | |
Меньше или равно | |
String | Равно |
Не равно | |
Начинается с | |
Заканчивается на | |
Date | Равно |
Не равно | |
Позже | |
Позже или равно | |
Раньше | |
Раньше или равно | |
Bool | Равно |
Не равно |
Регистрация события
Для идентификации посетителя вызовите следующий код:
HybridAPI.init().event("event_name", "event_properties");
Название поля | Тип | Описание |
---|---|---|
event_name* | string | Имя события. |
event_properties | HashMap | Набор свойств события. |
- - Обязательное поле
Отправка события с его свойствами
HashMap<String, String> properties = new HashMap<String, String>();
userData.put("title", "Наушники");
userData.put("id", "134");
HybridAPI.init().event("Купил товар", properties);
Отправка события
HybridAPI.init().event("Просмотрел товар");
Имя события (event_name) задаётся произвольно, используется при создании рекламной кампании на людей совершивших определённое действие.
Набор свойств { title: 'Наушники', id: '134' } задаётся для создания рекламной кампании нацеленной на пользователей, совершивших целевое действие с определённым объектом. Например просмотр товаров содержащих в названии "наушники" или товара '134'
SDK спецификация.
Размер библиотеки - 18Кб.
Поддерживаемые версии OS: 2.3.3(Gingerbread) и выше; (sdk >= 10) - 99,7% устройств.