Мы рады объявить о выпуске нашего первого клиентского SDK для Courier, написанного для JavaScript. Это новое дополнение расширяет наши существующие предложения SDK, которые включают Java, Python, Node, Go, Ruby и PHP, и позволяет разработчикам еще проще интегрировать Courier в свои проекты. Включив прямые вызовы Courier в коде JavaScript, вы избавите себя от необходимости использовать серверную службу в качестве дополнительного слоя между интерфейсом и API Courier, сэкономив драгоценное время и ресурсы.

В первом выпуске мы представляем три новых вызова API: вызов identify для привязки пользователя к действиям, которые он выполняет, например вход в систему или обновление своего профиля, и вызовы subscribe и unsubscribe для подписки и отказа от подписки на списки. Упрощая эти ключевые взаимодействия, CourierJS улучшает общее впечатление от использования Courier.

Клиентские и серверные SDK

Возможно, вы все еще задаетесь вопросом: зачем внедрять клиентский JavaScript SDK для Courier, если у нас уже есть SDK для многих других языков? Давайте углубимся в различия между клиентскими и серверными SDK, которые помогут вам определить правильный тип SDK для ваших конкретных потребностей.

(Сравнение процессов интеграции: с клиентским SDK Courier и без него)

Клиентские SDK предназначены для того, чтобы предоставить вам возможность взаимодействовать с API в интерфейсном коде вашего приложения. SDK на стороне сервера, напротив, взаимодействуют с вашим внутренним кодом, что делает их более подходящими для обработки и обработки данных, которые не предполагают непосредственного взаимодействия с пользователем во внешнем интерфейсе. Предлагая клиентский JavaScript SDK, мы предоставляем разработчикам альтернативу серверным SDK, которая больше подходит, когда вам нужно интегрировать функциональность Courier непосредственно во внешний интерфейс вашего веб-приложения. При попытке вызвать API из внешнего интерфейса наличие дополнительного уровня внутреннего кода не всегда может быть наиболее подходящим вариантом для определенных случаев использования. С CourierJS мы предлагаем альтернативу, которая оптимизирует процесс и подходит для более широкого спектра сценариев, повышая эффективность и помогая вам быстрее доставлять ценные приложения.

Мы черпали вдохновение в популярных платформах данных о клиентах, таких как Segment и RudderStack, обе из которых обеспечивают identify вызов. В дополнение к вызову identify, который привязывает действие пользователя к конкретному пользователю, наш первоначальный выпуск также включает поддержку подписки и отказа от подписки на списки, что позволяет пользователям легко управлять своими предпочтениями в отношении связи.

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

Откройте для себя преимущества CourierJS

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

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

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

Готовы начать? Использование CourierJS очень просто

Теперь, когда вы узнали о преимуществах клиентского SDK Courier, пришло время погрузиться в то, как вы можете легко интегрировать его в свой проект. Для начала все, что вам нужно сделать, это установить пакет JavaScript и начать использовать предоставленные вызовы функций в своем коде. Полное пошаговое руководство по настройке клиентского SDK Courier можно найти в нашей документации здесь.

Изучение новых вызовов API в клиентском SDK Courier

Теперь, когда вы все настроили, давайте подробнее рассмотрим новые вызовы API, представленные в SDK.

Звонок identify

Вызов identify позволяет легко создавать и обновлять профили пользователей. Вот пример того, как вызов identify можно использовать в вашем коде:

await courierSDK.identify("user123", {
  email: "[email protected]",
  firstName: "John",
  lastName: "Doe",
});

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

Подписка и отписка от списков

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

Управлять подписками пользователей легко благодаря новым вызовам API subscribe и unsubscribe. Эти вызовы упрощают поддержание актуальных списков подписчиков, поскольку не нужно вызывать серверную службу. Вот примеры того, как использовать вызовы subscribe и unsubscribe в вашем коде:

// Subscribe a user to a list
await courierSDK.subscribe("user123", "my-newsletter-list");

// Unsubscribe a user from a list
await courierSDK.unsubscribe("user123", "my-newsletter-list");

Как видно из комментариев к этим примерам, вызов subscribe добавляет пользователя в указанный список, а вызов unsubscribe удаляет его из списка.

Включив эти новые вызовы API в свой проект, вы можете еще больше оптимизировать процесс разработки.

Заключение

В этой статье мы раскрыли возможности нового клиентского SDK CourierJS и изучили его функции, включая вызов identify, а также вызовы subscribe и unsubscribe. Используя клиентский SDK CourierJS, вы можете снизить рабочую нагрузку, связанную с процессом разработки, и повысить общую эффективность своих проектов.

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

Мы рекомендуем вам попробовать новый CourierJS SDK для клиентской части и лично убедиться в его преимуществах. Используя этот инновационный инструмент, вы можете улучшить управление коммуникациями, инициируемыми продуктом, и раскрыть весь потенциал экосистемы Courier.