Android API

Материал из Wiki
Версия от 11:46, 20 апреля 2017; Admin (обсуждение | вклад) (Новая страница: « == Установка == Для чтобы взаимодействовать с Hybrid API, вам надо добавить Hybrid зависимости, о…»)
(разн.) ← Предыдущая | Текущая версия (разн.) | Следующая → (разн.)
Перейти к: навигация, поиск

Установка

Для чтобы взаимодействовать с 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");
<pre>

'''Добавление свойств пользователю'''

<pre>
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% устройств.