Ключевые идентификаторы API

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

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

Где найти

Панель управления Pushwoosh → Под названием приложения.

Уникальный токен, присваиваемый аккаунту Pushwoosh и используемый для аутентификации запросов к API. Он предоставляет доступ к управлению проектами, отправке сообщений, изменению настроек и получению данных. В каждом аккаунте по умолчанию создан как минимум один токен. Подробнее

Где найти

Панель управления Pushwoosh → API Access.

Уникальный идентификатор, присваиваемый устройству SDK Pushwoosh. Устанавливается SDK автоматически или передается при регистрации устройства. Подробнее

Где найти

• В логах устройства. Подробнее

• В User Explorer при поиске по User ID

• В CSV-файле, загруженном из списка сегментов

Токен, выдаваемый поставщиками платформ, который идентифицирует пару “приложение-устройство” для доставки push-уведомлений. Собирается SDK автоматически при предоставлении разрешений на отправку push-уведомлений. Подробнее

Где найти

• В логах устройства. Подробнее

• В User Explorer введите HWID в поле поиска, чтобы найти связанное устройство, затем откройте сведения об устройстве, чтобы просмотреть push-токен.

Указывает платформу целевого устройства с помощью числового кода. Устанавливается SDK автоматически.

Поддерживаемые значения:

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
14 – Email
17 – Huawei
18 – SMS
21 – WhatsApp
22 – Line

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

Где найти

Панель управления Pushwoosh → Audience → User Explorer

Уникальный идентификатор, присваиваемый каждому сообщению при его создании. Он имеет определенный формат: XXXX-XXXXXXXX-XXXXXXXX.

Этот код необходим для:

• Отслеживания статуса и доставки определенного сообщения.
• Отмены (или удаления) ранее отправленного сообщения.
• Получения статистики по сообщению.

Где найти

• Панель управления Pushwoosh: Перейдите в Message history, затем откройте свойства нужного сообщения. Код сообщения будет отображен там.
• Ответ API /createMessage: При создании нового сообщения через API код сообщения включается в ответ.

Идентификатор сохраненного пресета сообщения (например, push или SMS). Подробнее

Где найти

Панель управления Pushwoosh → Content → Presets.

Код пресета можно найти в двух местах:

• В виде списка, под названием пресета.

• В URL-адресе при редактировании или создании пресета (это последняя часть URL-адреса).

Пример:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB

Код пресета: AAAAA-BBBBB

Идентификатор шаблона rich media. Подробнее

Где найти

Панель управления Pushwoosh → Content → Rich media.

Пример: URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics Код rich media: AAAAA-BBBBB

Код контента email-сообщения — это уникальный идентификатор для сохраненного контента email-сообщения. Подробнее

Где найти

Панель управления Pushwoosh → Content → Email content.

Код является последней частью URL-адреса.

Пример:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB Код контента email-сообщения: AAAAA-BBBBB

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

Где найти

Код кампании появляется в URL-адресе при просмотре статистики по кампании в панели управления Pushwoosh. Чтобы найти его, перейдите в Statistics → Aggregated statistics, нажмите на нужную кампанию и скопируйте код, находящийся в конце URL-адреса.

Пример:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

Код кампании: YYYYY-YYYYY

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

Где найти

Journey ID отображается в URL-адресе холста кампании в панели управления Pushwoosh.

Пример: URL: https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Journey ID: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Название предопределенного сегмента пользователей, созданного в Pushwoosh для таргетинга на аудиторию. Подробнее

Где найти

Панель управления Pushwoosh → Segments.

Уникальный код в формате XXXXX-XXXXX, который идентифицирует сегмент (также называемый фильтром) в Pushwoosh. Этот код используется в вызовах API, логике автоматизации и правилах динамической сегментации.

Где найти

Код сегмента можно найти в предварительном просмотре определения сегмента в разделе Segments панели управления Pushwoosh. Код фильтра отображается в начале логики таргетинга.

Пример:

Tag("XXXXX-XXXXX", "In-app Purchase", noteq, "0.00")

В данном случае XXXXX-XXXXX — это код фильтра (сегмента).

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

Где найти

Панель управления Pushwoosh → Tags или через API /getTags.

Название отслеживаемого события (например, purchase, login, subscription). Используется для запуска автоматизированных рабочих процессов или для аналитики. Подробнее

Где найти

Панель управления Pushwoosh → Audience → Events.

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

Где найти

Панель управления Pushwoosh → Geozones.