Обзор идентификаторов устройств в Wavesend

Существует два способа идентификации конкретного устройства, зарегистрированного в Wavesend: аппаратный идентификатор (HWID) и push-токен.

HWID

HWID (или Hardware ID) — это ключевой идентификатор, присваиваемый устройству Wavesend SDK.

HWID для Android

Для устройств Android HWID представляет собой случайный набор букв и цифр, генерируемый первым приложением с установленным Wavesend SDK. Позже он передается другим приложениям, содержащим Wavesend SDK, в результате чего все такие приложения будут иметь одинаковый HWID.

Однако если пользователь удалит все приложения с Wavesend SDK, а затем переустановит некоторые из них, новый HWID будет сгенерирован заново.

Пример HWID для Android: 5dcaed99-e1e0-44dc-bde2-b96188b99e9e

HWID для iOS

Для устройств iOS в качестве HWID используется IDFV (Identifier for Vendor, идентификатор поставщика). Он не изменится, пока на устройстве установлено хотя бы одно приложение от того же поставщика.

Пример HWID для iOS (только в верхнем регистре!):CBAF8ED1-17FB-49A3-73BD-DC79B63AEF93

Push token

Push-токен (токен устройства) — это уникальный ключ для комбинации «приложение-устройство», выдаваемый шлюзами push-уведомлений Apple или Google. Он позволяет шлюзам и поставщикам push-уведомлений маршрутизировать сообщения и обеспечивать их доставку на уникальную комбинацию «приложение-устройство», для которой они предназначены.

Push-токен iOS

Push-токены устройств iOS представляют собой строки из 64 шестнадцатеричных символов. Пример push-токена iOS: 03df25c845d460bcdad7802d2vf6fc1dfde97283bf75cc993eb6dca835ea2e2f

Push-токен Android

Push-токены устройств Android могут различаться по длине (обычно менее 255 символов) и, как правило, начинаются с APA91b…; однако они также могут иметь префикс, отделенный двоеточием. Пример push-токена Android: APA91bFoi3lMMre9G3XzR1LrF4ZT82_15MsMdEICogXSLB8-MrdkRuRQFwNI5u8Dh0cI90ABD3BOKnxkEla8cGdisbDHl5cVIkZah5QUhSAxzx4Roa7b4xy9tvx9iNSYw-eXBYYd8k1XKf8Q_Qq1X9-x-U-Y79vdPq

Сбор логов, HWID и push-токена с устройства

iOS

Если у вас есть доступ к исходному коду вашего приложения, убедитесь, что для Wavesend_LOG_LEVEL в приложении установлено значение VERBOSE. Для этого проверьте строковый ключ Wavesend_LOG_LEVEL в файле Info.plist. Если это не так, перейдите к следующему шагу. Возможные значения для этого ключа:

NONE — нет логов от SDK
ERROR — отображать только ошибки в консоли
WARNING — также отображать предупреждения
INFO — добавлять информационные сообщения
DEBUG — добавлять отладочную информацию
VERBOSE — все логи от SDK

Значение ключа VERBOSE позволяет Wavesend SDK отображать важную информацию о действиях по регистрации.

Затем подключите устройство к вашему Mac и запустите Xcode. Перейдите в Window->Device and Simulators.

В открывшемся окне выберите подключенное устройство и нажмите на треугольник в левом нижнем углу, чтобы увидеть консоль устройства:

Начиная с Xcode 9.3, процесс получения лога консоли устройства немного изменился. Все, что вам нужно сделать, — это зайти в Launchpad и запустить приложение «Консоль». Выберите ваше устройство в левой боковой панели. Готово!

Далее запустите ваше приложение на устройстве и дождитесь диалогового окна. Разрешите push-уведомления для вашего приложения.
После этих шагов выделите весь лог устройства из окна консоли и скопируйте его в любой текстовый редактор.

Запрос к API Wavesend /registerDevice — это то, что вам нужно:

Если устройство зарегистрировано корректно, этот запрос должен содержать следующие параметры, включая значения “hwid” и “push token”:

x
| Wavesend request:
| Url: https://D868A-C13C1.api.wavesend.ru/json/1.3/registerDevice
| Payload: {"request":{"gateway":"production","jailbroken":0,"app_version":"1.9","application":"D868A-C13C1","sounds":["bubble.wav"],"device_type":1,"userId":"1457691684303547","language":"en","hwid":"FBCA07FE-05EE-4770-B4BA-AB6737BC1A98","package":"com.wavesend.pushon","timezone":"25200","push_token":"ae784019d1b8c8e38a1ea06f0800c17a4fa986d6e2d346fc79373e92439ff8f7","os_version":"11.2.2","v":"5.5.1","device_model":"iPhone7,1"}}
| Status: "200 no error"
| Response: {"status_code":200,"status_message":"OK","response":{"iosCategories":[{"categoryId":0,"buttons":[{"id":"33389","label":"test","type":"0","startApplication":0},{"id":"1233","label":"ajhdkj","type":"1","startApplication":0}]}]}}
x

Также должно присутствовать уведомление с push-токеном вашего устройства:

<Notice>: [PW] [I] -[PWPushNotificationsManagerCommon] Registered for push notifications: ae784019d1b8c8e38a1ea06f0800c17a4fa986d6e2d346fc79373e92439ff8f7

Android

Если у вас есть доступ к исходному коду приложения, убедитесь, что уровень логирования Wavesend установлен на NOISE. Для этого добавьте метаданные com.wavesend.log_level со значением NOISE в AndroidManifest.xml.
Затем запустите Android Studio на вашем Mac/ПК и перейдите в Tools -> Android -> Android Device Monitor.

Подключите ваше устройство к Mac/ПК и запустите приложение. Подождите около 30 секунд, выделите весь лог устройства из окна консоли и скопируйте его в любой текстовый редактор.

Обратите внимание, что в последних версиях Android Studio вы также можете использовать инструмент Logcat для получения лога консоли устройства. Запустите Android Studio и перейдите в View -> Tool Windows -> Logcat:

После этого вы сможете найти лог устройства в окне Logcat:

Ниже приведен пример того, как выглядит запрос к API Wavesend /registerDevice в логе консоли устройства:

Найдите в запросе значения параметров “hwid” и “push token”:

[RequestManager]
x
| Wavesend request:
| Url: https://D868A-C13C1.api.wavesend.ru/json/1.3/registerDevice
| Payload: {"request":{"application":"D868A-C13C1","hwid":"fc79efabee7649ec","v":"5.5.2","device_type":3,"userId":"fc79efabee7649ec","device_name":"Phone","language":"en","timezone":25200,"android_package":"com.wavesend.pushon","jailbroken":0,"device_model":"Sony F8332","os_version":"8.0.0","idfa":"d43ad490-4e6a-48a8-b8b9-f20b76fbf07b","app_version":"1.5","push_token":"dwMAeCRabUE:APA91bGSk8SqCSycxfltrWCV9KtXGo48-8qvNKfzHn758PW7lLXSi_Wd7y3gqw-lbexsjLwsaXStpELTJUAQVZ3ybNqAUmfw-we-62rTjpNbvBa4oPYTwaPCr3s4M05xNv8jGau-MeA_","sounds":"[]"}}
| Response: {"status_code":200,"status_message":"OK","response":null}
x
[RequestManager] registerDevice response success

Push-токен включен в уведомление о регистрации устройства:

I/Wavesend(12733): [DeviceRegistrar] Registered for pushes: dwMAeCRabUE:APA91bGSk8SqCSycxfltrWCV9KtXGo48-8qvNKfzHn758PW7lLXSi_Wd7y3gqw-lbexsjLwsaXStpELTJUAQVZ3ybNqAUmfw-we-62rTjpNbvBa4oPYTwaPCr3s4M05xNv8jGau-MeA_
03-30 14:45:10.539: D/PushOn(12733): Registered for push notifications

Chrome (десктоп)

Перейдите на ваш сайт.
Нажмите правой кнопкой мыши в любом месте страницы и выберите «Inspect» (Проверить).

В открывшемся окне перейдите на вкладку «Application».
Затем в левой боковой панели выберите IndexedDB -> Wavesend_SDK_Store -> keyValue. Здесь найдите параметры HWID и push token.

Chrome (мобильная версия)

Подключите ваше мобильное устройство к компьютеру.
Перейдите по адресу chrome://inspect/#devices в браузере Chrome на вашем компьютере.
Откройте ваш сайт в браузере Chrome на мобильном устройстве.
Как только сайт откроется в мобильном Chrome, вы увидите соответствующую страницу в браузере Chrome на компьютере. Пожалуйста, посмотрите на скриншот ниже:

Нажмите кнопку «Inspect», выделенную на скриншоте выше.
В браузере Chrome на вашем компьютере появится следующее окно. В нем на вкладке «Application» откройте IndexedDB -> WAVESEND_SDK_STORE. После этого нажмите keyValue и откройте раздел API_PARAMS:

В разделе API_PARAMS вы найдете параметры “hwid” и “push token” с их значениями.

Safari

Перейдите на ваш сайт.
Нажмите правой кнопкой мыши в любом месте страницы и выберите «Inspect Element» (Проверить объект).
Перейдите на вкладку Storage -> Indexed Databases -> WAVESEND_SDK_STORE -> keyValue.
Разверните API_PARAMS и найдите здесь значения “hwid” и “push token”.