Как настроить события

События (Events) используются для отслеживания различных действий, совершаемых пользователями в приложении. Данные о событиях сохраняются в хронологическом порядке, создавая временную шкалу поведения пользователя. Вся контекстная информация о событии может быть передана в виде набора атрибутов и их значений.

После правильного сбора эти данные можно использовать для:

запуска сообщений на основе поведения;
изменения потока общения с пользователем в рамках Customer Journey в зависимости от его поведения;
создания сегментов пользователей, которые выполняют определенное действие в приложении;
получения информации о пользовательских потоках, метриках использования и других статистических данных.

Типы событий

В Pushwoosh существует два типа событий:

События по умолчанию
Пользовательские события

События по умолчанию

События по умолчанию — это основные взаимодействия, которые пользователи совершают в приложениях или на веб-сайтах независимо от их отрасли или функциональности. Эти ключевые действия пользователей составляют основу коммуникации с клиентами и могут быть использованы для любого продукта и клиента на любом этапе жизненного цикла клиента. События по умолчанию доступны «из коробки» в последних версиях SDK и не требуют дополнительной настройки, за исключением PW_InAppPurchase.

Узнайте больше о Событиях по умолчанию

Пользовательские события

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

Пользовательские события требуют реализации на вашей стороне.

Реализация пользовательских событий

1. Создайте события и установите атрибуты

Pushwoosh автоматически создает событие и его атрибуты при первом вызове postEvent с именем, которое он не распознает, определяя тип каждого атрибута по полученному значению. Если вам нужен контроль над типами атрибутов, а не их автоматическое определение, сначала объявите событие и типы его атрибутов.

Вы можете попросить свою маркетинговую команду создать события непосредственно в Pushwoosh Control Panel или использовать метод API createEvent. Это включает в себя указание имени события и любых связанных данных, которые вы хотите отслеживать.

2. Вызовите /postEvent API

Когда в вашем приложении происходит событие, которое вы хотите отследить, вызовите API /postEvent, чтобы отправить это событие в Pushwoosh.

iOS

Вызовите postEvent, чтобы отправить событие в Pushwoosh:

Swift
Objective-C

PWInAppManager.shared().postEvent("eventName", withAttributes: nil)

[[PushNotificationManager pushManager] postEvent:@“eventName” withAttributes:@{}];

Чтобы добавить детали о событии (см. Атрибуты), используйте параметр attributes следующим образом:

Swift
Objective-C

let attributes: [String : Any] = ["AttributedString" : "someString",
                                  "AttributeInt" : 42,
                                  "AttributeList" : [123, 456, "someString"],
                                  "AttributeBool" : true,
                                  "AttributeDate" : NSDate()]

PWInAppManager.shared().postEvent("eventName", withAttributes: attributes)

NSDictionary *attributes = @{
  @"AttributeString" : @"someString",
  @"AttributeInt" : @(42),
  @"AttributeList" : @[ @(123), @(456), @"someString" ],
  @"AttributeBool" : @YES,
  @"AttributeDate" : [NSDate date]
};

[[PushNotificationManager pushManager] postEvent:@“eventName” withAttributes:attributes];

Android

Когда в вашем Android-приложении происходит событие, используйте следующие инструкции, чтобы отправить это событие в Pushwoosh.

Вызовите postEvent, чтобы отправить событие в Pushwoosh:

PushwooshInApp.getInstance().postEvent("eventName");

Чтобы добавить детали о событии (см. Атрибуты), используйте параметр attributes следующим образом:

TagsBundle attributes = new TagsBundle.Builder()
        .putInt("AttributeInt", 17)
        .putString("AttributeString", "str")
        .putDate("AttributeDate", new Date())
        .putBoolean("AttributeBool", true)
        .putList("AttributeList", Arrays.asList("item1", "item2", "item3"))
        .build();

PushwooshInApp.getInstance().postEvent("eventName", attributes);