Android API — различия между версиями

Материал из Wiki
Перейти к: навигация, поиск
м
м
Строка 35: Строка 35:
 
Для идентификации посетителя вызовите следующий код:
 
Для идентификации посетителя вызовите следующий код:
  
<pre>
+
<syntaxhighlight lang="java">
 
HybridAPI.init().identify("customerId", "user_identity_properties");
 
HybridAPI.init().identify("customerId", "user_identity_properties");
</pre>  
+
</syntaxhighlight>
  
 
{| class="wikitable"
 
{| class="wikitable"
Строка 56: Строка 56:
 
'''Идентификация пользователя с его свойствами'''
 
'''Идентификация пользователя с его свойствами'''
  
<pre>
+
<syntaxhighlight lang="java">
 
HashMap<String, String> userData = new HashMap<String, String>();
 
HashMap<String, String> userData = new HashMap<String, String>();
 
userData.put("name", "Иванов Иван");
 
userData.put("name", "Иванов Иван");
 
userData.put("email", "ivan@mail.ru");
 
userData.put("email", "ivan@mail.ru");
 
HybridAPI.init().identify("df43rf56f34", userData);
 
HybridAPI.init().identify("df43rf56f34", userData);
</pre>
+
</syntaxhighlight>
  
 
'''Идентификация нового пользователя'''
 
'''Идентификация нового пользователя'''
  
<pre>
+
<syntaxhighlight lang="java">
 
HybridAPI.init().identify("df43rf56f34");
 
HybridAPI.init().identify("df43rf56f34");
</pre>
+
</syntaxhighlight>
  
 
'''Добавление свойств пользователю'''
 
'''Добавление свойств пользователю'''
  
<pre>
+
<syntaxhighlight lang="java">
 
HashMap<String, String> userData = new HashMap<String, String>();
 
HashMap<String, String> userData = new HashMap<String, String>();
 
userData.put("gender", "male");
 
userData.put("gender", "male");
 
userData.put("age", "24");
 
userData.put("age", "24");
 
HybridAPI.init().identify(userData);
 
HybridAPI.init().identify(userData);
</pre>
+
</syntaxhighlight>
  
 
В ''user_identity_properties'' передаётся объект ''"{'age':24,'gender':male}"'' названия атрибутов произвольны. Тип значения определяется по шаблону, от типа зависят возможные условия для сбора аудитории.
 
В ''user_identity_properties'' передаётся объект ''"{'age':24,'gender':male}"'' названия атрибутов произвольны. Тип значения определяется по шаблону, от типа зависят возможные условия для сбора аудитории.

Версия 10:49, 21 апреля 2017

Установка

Для чтобы взаимодействовать с Hybrid API, вам надо добавить Hybrid зависимости, обновить permissions и инициализировать библиотеку.

1. Скопировать HybridAPI.jar в папку lib проекта

Файл:HybridAPI.jar

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