Поделиться через

Netvolution (предварительная версия)

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

Этот соединитель доступен в следующих продуктах и регионах:

Услуга Class Регионы
Copilot Studio Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Логические приложения Стандарт Все регионы Logic Apps , кроме следующих:
     — Регионы Azure для государственных организаций
     — Регионы Azure Для Китая
     - Министерство обороны США (DoD)
Power Apps Премия Все регионы Power Apps , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Power Automate Премия Все регионы Power Automate , кроме следующих:
     - Правительство США (GCC)
     - Правительство США (GCC High)
     — Облако Китая, управляемое 21Vianet
     - Министерство обороны США (DoD)
Контакт
Имя Atcom SA
URL https://www.atcom.gr
Метаданные соединителя
Publisher Atcom S.A
Веб-сайт https://www.atcom.gr/
Политика конфиденциальности https://www.atcom.gr/privacy-policy/
Категории Торговля; Маркетинг

Соединитель Netvolution

Введение

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

Предпосылки

Прежде чем использовать соединитель Netvolution, вам потребуется:

  • Реализация Netvolution.
  • Учетные данные API (ключ API).

Начало работы

Чтобы использовать соединитель Netvolution, выполните следующие действия.

  1. Добавьте соединитель в среду Power Platform:

    • Перейдите на портал Power Platform.
    • Перейдите в раздел "Соединители" и добавьте новый соединитель.
    • Найдите "Netvolution" и выберите его.

  2. Настройка соединителя:

    • Введите учетные данные API, полученные от платформы Netvolution.
    • Введите адрес Netvolution (без https префикса).
    • Сохраните конфигурацию.

  3. Используйте соединитель в приложениях и потоках:

    • Добавьте соединитель в потоки Power Apps или Power Automate.
    • Используйте доступные действия для взаимодействия с ресурсами Netvolution.

Поддерживаемые операции

Соединитель Netvolution поддерживает следующие операции:

  • Получение шаблонов электронной почты

    • Метод : GET
    • Путь: /cdp/mail/list-templates.
    • Описание. Список всех пользовательских шаблонов электронной почты.

  • При возникновении нового события

    • Метод : GET
    • Путь: /trigger/cdp/events/{eventName}.
    • Описание. Используйте это для выбора события в качестве триггера. Поддерживаемые события: add_to_cart, view_page, view_item.

  • Добавление контакта в сегмент

    • Метод : GET
    • Путь: /trigger/cdp/contacts/{Id}.
    • Описание: активируется при добавлении нового контакта в сегмент.

  • Получение заказа для контакта

    • Метод : GET
    • Путь: /cdp/orders/{contactId}.
    • Описание. Проверьте, сделал ли контакт заказ.

  • Проверьте, находится ли контакт в списке подавления

    • Метод : GET
    • Путь: /cdp/suppression/check.
    • Описание. Проверьте, временно ли контакт находится в списке подавления.

  • Поставить контакт в список подавления

    • Метод: PUT
    • Путь: /cdp/suppression/add.
    • Описание. Добавьте контакт в список подавления в течение указанной длительности.

  • Отправить сообщение

    • Метод : POST
    • Путь: /cdp/mail/send.
    • Описание. Это действие активирует кампанию электронной почты, созданную в Netvolution.

  • Проверьте, произошло ли событие

    • Метод : GET
    • Путь: /cdp/events/checkevent.
    • Описание. Проверьте, произошло ли событие для определенного идентификатора контакта в течение определенного периода.

  • Получение списка желаний

    • Метод : GET
    • Путь: /cdp/wishlist/{since}.
    • Описание. Получение списка желаний, обновленного в течение указанного интервала времени.

Определение API

Соединитель использует следующее определение API:

  • Swagger File: apiDefinition.swagger.json
    • Этот файл содержит подробную схему API и конечные точки, используемые соединителем.

Settings

Параметры соединителя определяются в следующем файле:

  • Файл параметров: settings.json
    • Этот файл содержит различные параметры конфигурации соединителя.

Icon

Значок соединителя включен в следующий файл:

  • Файл значка: icon.png
    • Этот файл используется в качестве визуального представления соединителя в интерфейсе Power Platform.

Известные проблемы и ограничения

  • В настоящее время соединитель поддерживает основные операции. Дополнительные функции будут добавлены в будущих выпусках.
  • Убедитесь, что учетные данные API настроены правильно, чтобы избежать ошибок проверки подлинности.

Support

Для любых проблем или поддержки обратитесь в службу поддержки Netvolution или обратитесь к официальной документации.

Лицензия

Этот соединитель лицензирован в соответствии с лицензией MIT. Дополнительные сведения см. в файле LICENSE.

Создание подключения

Соединитель поддерживает следующие типы проверки подлинности:
По умолчанию Параметры для создания подключения. Все регионы Недоступен для совместного использования

По умолчанию

Применимо: все регионы

Параметры для создания подключения.

Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.

Имя Тип Description Обязательно
КЛЮЧ API securestring КЛЮЧ для этого API
Имя узла Netvolution струна Имя узла Netvolution (пример: yourdomain.netvolution.net). True

Ограничения регулирования

Имя Вызовы Период обновления
Вызовы API для каждого подключения 100 60 секунд

Действия

Отправить сообщение электронной почты

Это действие активирует кампанию электронной почты, созданную в Netvolution.
Получение заказа для контакта

Проверьте, сделал ли контакт заказ.
Получение списка желаний

Получение списка желаний
Получение шаблонов электронной почты

Список всех пользовательских шаблонов электронной почты.
Поставить контакт в список подавления

Поставить контакт в список подавления
Проверка того, произошло ли событие

Проверьте, произошло ли событие для определенного идентификатора контакта и в течение определенного периода времени.
Проверьте, находится ли контакт в списке подавления

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

Отправить сообщение электронной почты

Идентификатор операции:
SendMail

Это действие активирует кампанию электронной почты, созданную в Netvolution.

Параметры

Имя Ключ Обязательно Тип Описание
Код контактного лица
 cdpContactId string

Идентификатор контакта CDP пользователя.
Идентификатор языка
 languageId string

Идентификатор языка, указанный в сайте netvolution.
Шаблон письма
 emailTemplate string

Выберите кампанию по электронной почте.

Получение заказа для контакта

Идентификатор операции:
GetOrder

Проверьте, сделал ли контакт заказ.

Параметры

Имя Ключ Обязательно Тип Описание
Код контактного лица
 contactId True string

Используйте выходные данные для идентификатора контакта на основе ранее используемого триггера.
С
 since True string

На момент времени, когда он проверяет, был ли пользователь указать заказ.

Получение списка желаний

Идентификатор операции:
GetWishList

Получение списка желаний

Параметры

Имя Ключ Обязательно Тип Описание
Интервал времени
 since True string

Укажите количество дней, которые необходимо проверить на наличие обновленных списков желаний.

Возвращаемое значение

Имя Путь Тип Описание
Results
 Results array of object

Results
CDPContactID
 Results.CDPContactID string

CDPContactID
Идентификатор пользователя
 Results.UserID integer

Идентификатор пользователя
WishListID
 Results.WishListID integer

WishListID
LastUpdated
 Results.LastUpdated string

LastUpdated
LanguageID
 Results.LanguageID integer

LanguageID

Получение шаблонов электронной почты

Идентификатор операции:
GetEmailTemplates

Список всех пользовательских шаблонов электронной почты.

Возвращаемое значение

Имя Путь Тип Описание
Message
 Message boolean

Message
Results
 Results integer

Results

Поставить контакт в список подавления

Идентификатор операции:
PutContactIDToSuppresionList

Поставить контакт в список подавления

Параметры

Имя Ключ Обязательно Тип Описание
Код контактного лица
 contactId True string

Используйте выходные данные для идентификатора контакта на основе ранее используемого триггера.
Имя списка подавления
 listName True string

Имя списка подавления.
Интервал времени
 timeSpan True string

Укажите количество дней, в течение которых идентификатор контакта останется в списке подавления для этой кампании.

Проверка того, произошло ли событие

Идентификатор операции:
CheckEvent

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

Параметры

Имя Ключ Обязательно Тип Описание
Имя события
 eventName string

Выберите доступное событие.
Код контактного лица
 contactId string

Идентификатор контакта CDP пользователя.
С
 since string

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

Возвращаемое значение

Имя Путь Тип Описание
Message
 Message boolean

Message
Results
 Results integer

Results

Проверьте, находится ли контакт в списке подавления

Идентификатор операции:
GetContactIDFromSuppressionList

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

Параметры

Имя Ключ Обязательно Тип Описание
Код контактного лица
 contactId True string

Идентификатор контакта CDP пользователя.
Имя списка
 listName True string

Имя списка подавления.

Триггеры

При возникновении нового события

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

Используйте этот триггер при добавлении нового контакта в сегмент

При возникновении нового события

Идентификатор операции:
OnNewEvent

Используйте это для выбора события в качестве триггера

Параметры

Имя Ключ Обязательно Тип Описание
Имя события
 eventName True string

Выберите доступное событие.

Возвращаемое значение

Имя Путь Тип Описание
NextSince
 NextSince string

NextSince
Results
 Results array of object

Results
LanguageID
 Results.LanguageID integer

LanguageID
LanguageName
 Results.LanguageName string

LanguageName
Название события
 Results.EventName string

Название события
Отметка времени
 Results.Timestamp string

Отметка времени
CDPContactID
 Results.CDPContactID string

CDPContactID
Семья
 Results.Browser.OS.Family string

Семья
Майор
 Results.Browser.OS.Major string

Майор
IsSpider
 Results.Browser.Device.IsSpider boolean

IsSpider
Семья
 Results.Browser.Device.Family string

Семья
Бренд
 Results.Browser.Device.Brand string

Бренд
Модель
 Results.Browser.Device.Model string

Модель
Семья
 Results.Browser.UserAgent.Family string

Семья
Майор
 Results.Browser.UserAgent.Major string

Майор
Несовершеннолетний
 Results.Browser.UserAgent.Minor string

Несовершеннолетний
Patch
 Results.Browser.UserAgent.Patch string

Patch
id
 Results.List.id string

id
имя
 Results.List.name string

имя
ItemParentId
 Results.Product.ItemParentId string

ItemParentId
ItemName
 Results.Product.ItemName string

ItemName
Категория
 Results.Product.Category string

Категория

При добавлении контакта в сегмент

Идентификатор операции:
OnNewUserInSegment

Используйте этот триггер при добавлении нового контакта в сегмент

Параметры

Имя Ключ Обязательно Тип Описание
Идентификатор сегмента
 Id True string

Используйте идентификатор сегмента Netvolution.

Возвращаемое значение

Имя Путь Тип Описание
NextSince
 NextSince string

NextSince
Results
 Results array of object

Results
Идентификатор
 Results.ID string

Идентификатор
CreatedDate
 Results.CreatedDate string

CreatedDate
Электронный адрес
 Results.EmailAddress string

Электронный адрес
eStoreSessionId
 Results.eStoreSessionId string

eStoreSessionId
Имя
 Results.FirstName string

Имя
Фамилия
 Results.LastName string

Фамилия
Дата рождения
 Results.DateOfBirth string

Дата рождения
Gender
 Results.Gender string

Gender
Анонимный
 Results.Anonymized boolean

Анонимный
Code
 Results.MobilePhone.Code string

Code
Number
 Results.MobilePhone.Number string

Number
Код страны
 Results.MobilePhone.CountryCode string

Код страны
Ценность
 Results.ModifiedDate.Value string

Ценность
IsAutocalculated
 Results.ModifiedDate.IsAutocalculated boolean

IsAutocalculated
Code
 Results.Landline.Code string

Code
Number
 Results.Landline.Number string

Number
Код страны
 Results.Landline.CountryCode string

Код страны
Улица
 Results.Address.Street string

Улица
Город
 Results.Address.City string

Город
ZipCode
 Results.Address.ZipCode string

ZipCode
Округ
 Results.Address.County string

Округ
Страна
 Results.Address.Country string

Страна
Местоположение
 Results.Location string

Местоположение
Сегменты
 Results.Segments array of object

Сегменты
SegmentID
 Results.Segments.SegmentID integer

SegmentID
MemberSince
 Results.Segments.MemberSince string

MemberSince