Язык сегментации

Wavesend предлагает мощный механизм сегментации для создания детализированных сегментов на основе значений Tag. Язык сегментации — это особый способ написания и комбинирования критериев сегментации для описания определенной группы пользователей, которые соответствуют этим критериям, и рассмотрения их как единого сегмента аудитории.

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

Основы

Каждое устройство в вашей пользовательской базе имеет определенные атрибуты, связанные с ним через значения Tag.

Например, предположим, что пользовательница по имени Джейн живет в Токио, и ее возраст — 28 лет. Для ее устройства будут установлены следующие Tag:

• Name: Jane
• City: Tokyo
• Age: 28

Чтобы нацелиться на Джейн, вам нужно будет описать Segment следующим образом:

T("Name", eq, "Jane") * T("Age", eq, 28) * T("City", eq, "Tokyo")

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

Фильтрующие выражения

Фильтрующее выражение — это строка, содержащая условие или комбинацию условий, описывающих нужный вам Segment.

Условия

Каждое условие описывает Segment устройств, которые соответствуют указанным в этом условии критериям.

Например, следующее условие создает Segment пользователей, которые живут в Токио:

T("City", e, "Tokyo")

где

• T — это Tag (тип условия);
• eq — это применяемый оператор;
• “Tokyo” — это значение Tag, связанное с устройствами пользователей.

Типы условий

Существует четыре типа условий, которые вы можете использовать для сегментации:

• A (Application) – описывает Segment устройств с установленным определенным приложением;
• T (Tag) – описывает Segment устройств с указанными значениями Tag;
• AT (App-specific tag) – применяется в сочетании с кодами приложений для Tag, специфичных для приложения;
• Event – описывает Segment устройств, вызвавших определенное событие Wavesend;

Операции с условиями

Для создания сложных сегментов к условиям в фильтрующем выражении можно применять следующие операции:

Объединение (+)

Объединяет сегменты, то есть создает новый Segment пользователей, которые соответствуют хотя бы одному из указанных условий.

Например, чтобы нацелиться на пользователей, которые живут в Токио или Осаке, вам нужно описать Segment следующими условиями:

T("City", eq, "Tokyo") + T("City", eq, "Osaka")

Note

Аналог логической дизъюнкции (ИЛИ).

Пересечение (*)

Создает Segment пользователей, принадлежащих обоим сегментам, описанным условиями. Таким образом, будут включены только те пользователи, которые соответствуют каждому указанному вами условию.

Следующее выражение описывает Segment пользователей, которые одновременно живут в Токио и указали свои имена:

T("City", eq, "Tokyo") * T("Name", any)

Note

Аналог логической конъюнкции (И).

Разность (\)

Создает Segment пользователей, которые принадлежат к одному из описанных сегментов и не принадлежат к другому.

Пользователи, которые живут в Токио, но не указали свои имена, будут описаны следующим образом:

T("City", eq, "Tokyo") \ T("Name", any)

Скобки

Определяют порядок выполнения операций с условиями в вашем фильтрующем выражении.

Например, следующее фильтрующее выражение сначала получит Segment подписчиков приложения 12345-67890, чей возраст равен 18, а затем вычтет из этого сегмента всех мужчин:

( A("12345-67890") * T("Age", eq, 18) ) \ T("Gender", eq, "Male")

Операторы условий для Tag

Для каждого типа Tag применяются свои операторы.

Операторы для Integer Tag

• eq - равно указанному значению
• noteq - не равно указанному значению
• lte - меньше или равно указанному значению
• gte - больше или равно указанному значению
• in - любое из указанных значений
• notin - не равно ни одному из указанных значений
• between - в указанном диапазоне
• any - устройства с любыми значениями, установленными для Tag
• notset - устройства без установленного значения для Tag

Пример синтаксиса для Integer Tag

T("int", eq, 42)

Операторы для String Tag

• eq - равно указанному значению
• noteq - не равно указанному значению
• in - равно любому из указанных значений
• notin - не равно ни одному из указанных значений
• any - устройства с любыми значениями, установленными для Tag
• notset - устройства без установленного значения для Tag

Пример синтаксиса для String Tag

T("str", eq, "kangaroo")

Операторы для List Tag

• in - устройства с любым из указанных значений Tag
• notin - ни одно из указанных значений Tag не связано с устройством
• any - устройства с любыми значениями, установленными для Tag
• notset - устройства без установленного значения для Tag

Пример синтаксиса для List Tag

T("list", notin, ["kangaroo", "raccoon"])

Операторы для Date Tag

• eq - равно указанной дате
• noteq - не равно указанной дате
• lte - до или в указанную дату
• gte - после или в указанную дату
• in - равно любой из указанных дат
• notin - не равно ни одной из указанных дат
• between - в указанном диапазоне
• any - устройства с любыми значениями, установленными для Tag
• notset - устройства без установленного значения для Tag
• match - соответствует указанному месяцу года и дню месяца.

Примеры оператора match

• AT("XXXXX-XXXXX", "Date tag", match month 4 day 1) - устройства, у которых для Tag “Date tag” установлено 1 апреля любого года.
• AT("XXXXX-XXXXX", "Date tag", match month "now" day 13) - устройства, у которых для Tag “Date tag” установлено 13-е число текущего месяца.
• AT("XXXXX-XXXXX", "Date tag", match month "now" day "now+2") - устройства, у которых для Tag “Date tag” установлена дата “послезавтра”. Частый сценарий использования: поздравления с днем рождения.

Примеры оператора match для сегментов по годовщинам и дням рождения

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

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now") Нацелен на пользователей, у которых сегодня день рождения (тот же день и месяц, что и сегодня). Используйте это для отправки поздравлений с днем рождения или специальных предложений в сам день рождения пользователя.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now+N") Нацелен на пользователей, у которых день рождения через N дней (тот же месяц и день, через N дней от сегодняшнего дня). Используйте это для предварительной подготовки пользователей, например, для отправки сообщений с обратным отсчетом или напоминаний о предстоящих событиях.

• AT("XXXXX-XXXXX", "birthday", match month "now" day "now-N") Нацелен на пользователей, у которых день рождения был N дней назад. Используйте это для запоздалых поздравлений с днем рождения или последующих сообщений, например, запросов на обратную связь.

• AT("XXXXX-XXXXX", "birthday", match month "now" day N) Нацелен на пользователей, у которых день рождения N-го числа текущего месяца, независимо от года. Используйте это при планировании фиксированных ежемесячных кампаний, привязанных к определенным датам (например, ежемесячные бонусы лояльности 10-го числа).

• daysago eq - равно указанному количеству дней до текущего дня
• daysago noteq - не равно указанному количеству дней до текущего дня
• daysago lte - меньше или равно указанному количеству дней до текущего дня
• daysago gte - больше или равно указанному количеству дней до текущего дня
• daysago between - между указанным количеством дней

Примеры оператора daysago

• T("Date tag", daysago, eq, 0) - текущий день с 00:00 до текущего момента;
• T("Date tag", daysago, eq, 1) - с 00:00 предыдущего дня до 00:00 текущего дня;
• T("Date tag", daysago, gte, 1) - все время до 00:00 текущего дня;
• T("Date tag", daysago, lte, 7) - с 00:00 дня 6 дней назад до текущего момента;
• T("Date tag", daysago, between, [2,7]) - от 7 до 2 дней назад.

Пример оператора date

• T("Date tag", eq "2022-12-05 00:00:00")

Операторы для Boolean Tag

• eq - равно указанному значению
• noteq - не равно указанному значению
• any - устройства с любыми значениями, установленными для Tag
• notset - устройства без установленного значения для Tag

Пример синтаксиса для Boolean Tag

T("bool", eq, true)

Операторы для Price Tag

• eq - равно указанному значению
• noteq - не равно указанному значению
• lte - меньше или равно указанному значению
• gte - больше или равно указанному значению
• in - равно любому из указанных значений
• notin - не равно ни одному из указанных значений
• between - в указанном диапазоне
• any - устройства с любыми значениями, установленными для Tag
• notset - устройства без установленного значения для Tag

Пример синтаксиса для Price Tag

T("price", between, ["4.2", "6.9"])

Операторы для Version Tag

• eq - равно указанному значению
• noteq - не равно указанному значению
• lte - меньше или равно указанному значению
• gte - больше или равно указанному значению
• in - равно любому из указанных значений
• notin - не равно ни одному из указанных значений
• between - в указанном диапазоне
• any - устройства с любыми значениями, установленными для Tag
• notset - устройства без установленного значения для Tag

Пример синтаксиса для Version Tag

T("version", lte, "4.2")

Операторы условий для “Event”

Note

Помните, что условия для Event специфичны для приложения, поэтому в ваших фильтрующих выражениях должен быть указан Application code вместе с названием Event.

Количество Event

• count gte - устройства, вызвавшие Event больше или ровно n раз
• count lte - устройства, вызвавшие Event меньше или ровно n раз
• count eq - устройства, вызвавшие Event ровно n раз
• count noteq - устройства, вызвавшие Event любое количество раз, кроме n

Пример синтаксиса для количества Event

Event("11111-11111", "Level reached", count gte 10) // 11111-11111 - это Application code

Дата Event

• date gte - устройства, вызвавшие Event позже или ровно в указанную дату
• date lte - устройства, вызвавшие Event раньше или ровно в указанную дату
• date eq - устройства, вызвавшие Event ровно в указанную дату
• date noteq - устройства, вызвавшие Event в любое время, но не в указанную дату
• date in - устройства, вызвавшие Event в любую из указанных дат
• date notin - устройства, вызвавшие Event в любое время, но не в одну из указанных дат
• date between - устройства, вызвавшие Event в указанный период
• date daysago eq - дата вызова Event равна указанному количеству дней до текущего дня
• date daysago noteq - дата вызова Event не равна указанному количеству дней до текущего дня
• date daysago lte - дата вызова Event меньше или равна указанному количеству дней до текущего дня
• date daysago gte - дата вызова Event больше или равна указанному количеству дней до текущего дня
• date daysago between - дата вызова Event находится между указанным количеством дней

Примеры синтаксиса для даты Event

• Event("11111-11111", "Level reached", date gte "2022-01-01 01:02:03")
• Event("11111-11111", "Level reached", date in ["2022-01-01 01:02:03", "2022-01-01 02:03:04"])
• Event("11111-11111", "Level reached", date between "2022-01-01 01:02:03" "2022-01-01 02:03:04")

Пример фильтрующего выражения

Note

При написании JSON-запросов обязательно экранируйте кавычки (") и обратные слэши (\) с помощью обратного слэша (\). Для примера запроса см. /exportSegment.

1. Устройства на iOS и Android с установленным приложением и с Push Token:

A("11111-11111", ["ios","android"], [with_tokens])

2. Устройства на iOS и Android с установленным приложением, но без Push Token:

A("11111-11111", ["ios","android"], [without_tokens])

3. Устройства на iOS и Android с установленным приложением, независимо от наличия Push Token:

A("11111-11111", ["ios","android"], [with_tokens, without_tokens])

4. Все подписчики приложения, которые что-либо купили в приложении:

AT( "11111-11111", "In-App Purchase", gte, 1)

Note

Учтите, что Tag, специфичные для приложения, обозначаются как AT вместо T, и должен быть указан Application code.