Udostępnij przez

Netvolution (wersja zapoznawcza)

Łącznik Netvolution Umożliwia firmom usprawnianie i automatyzowanie kampanii marketingowych poczty e-mail. Umożliwia ona segmentację docelowej poczty e-mail, spersonalizowaną obsługę wiadomości i zautomatyzowane przepływy pracy na podstawie zachowania użytkownika. Dzięki wykorzystaniu technologii Netvolution marketerzy mogą zwiększyć zaangażowanie, poprawić utrzymanie klientów i zwiększyć liczbę konwersji przy minimalnym nakładzie pracy.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Atcom SA
adres URL https://www.atcom.gr
Metadane łącznika
Publisher Atcom S.A
Witryna internetowa https://www.atcom.gr/
Zasady ochrony prywatności https://www.atcom.gr/privacy-policy/
Kategorie Handel; Marketing

Łącznik netvolution

Wprowadzenie

Łącznik Netvolution Umożliwia projektowanie i automatyzowanie działań marketingowych poczty e-mail, w tym wysyłanie wiadomości e-mail marketingowych do określonych segmentów i zautomatyzowanych kampanii na podstawie akcji behawioralnych. Ten łącznik udostępnia zestaw akcji do zarządzania różnymi zasobami i interakcji z nimi na platformie Netvolution.

Wymagania wstępne

Aby można było użyć łącznika Netvolution, potrzebne będą następujące elementy:

  • Implementacja netvolution.
  • Poświadczenia interfejsu API (klucz interfejsu API).

Wprowadzenie

Aby użyć łącznika Netvolution, wykonaj następujące kroki:

  1. Dodaj łącznik do środowiska platformy Power Platform:

    • Przejdź do portalu usługi Power Platform.
    • Przejdź do sekcji "Łączniki" i dodaj nowy łącznik.
    • Wyszukaj ciąg "Netvolution" i wybierz go.

  2. Konfigurowanie łącznika:

    • Wprowadź poświadczenia interfejsu API uzyskane z platformy Netvolution.
    • Wprowadź adres Netvolution (bez prefiksu https ).
    • Zapisz konfigurację.

  3. Użyj łącznika w obszarze Aplikacje i przepływy:

    • Dodaj łącznik do przepływów usługi Power Apps lub Power Automate.
    • Użyj dostępnych akcji, aby wchodzić w interakcje z zasobami Netvolution.

Obsługiwane operacje

Łącznik Netvolution obsługuje następujące operacje:

  • Pobieranie szablonów wiadomości e-mail

    • , metoda: GET
    • Ścieżka: /cdp/mail/list-templates
    • Opis: Wyświetl listę wszystkich niestandardowych szablonów wiadomości e-mail.

  • Gdy wystąpi nowe zdarzenie

    • , metoda: GET
    • Ścieżka: /trigger/cdp/events/{eventName}
    • Opis: Użyj tego polecenia, aby wybrać zdarzenie jako wyzwalacz. Obsługiwane zdarzenia: add_to_cart, , view_itemview_page.

  • Po dodaniu kontaktu do segmentu

    • , metoda: GET
    • Ścieżka: /trigger/cdp/contacts/{Id}
    • Opis: wyzwalany po dodaniu nowego kontaktu do segmentu.

  • Pobieranie zamówienia dla kontaktu

    • , metoda: GET
    • Ścieżka: /cdp/orders/{contactId}
    • Opis: Sprawdź, czy kontakt złożył zamówienie.

  • Sprawdź, czy kontakt znajduje się na liście pomijania

    • , metoda: GET
    • Ścieżka: /cdp/suppression/check
    • Opis: Sprawdź, czy kontakt jest tymczasowo na liście pomijania.

  • Umieszczanie kontaktu na liście pomijania

    • , metoda: PUT
    • Ścieżka: /cdp/suppression/add
    • Opis: Dodaj kontakt do listy pomijania przez określony czas trwania.

  • Wyślij wiadomość e-mail

    • , metoda: POST
    • Ścieżka: /cdp/mail/send
    • Opis: Ta akcja wyzwala kampanię e-mail utworzoną w usłudze Netvolution.

  • Sprawdzanie, czy wystąpiło zdarzenie

    • , metoda: GET
    • Ścieżka: /cdp/events/checkevent
    • Opis: Sprawdź, czy zdarzenie miało miejsce dla określonego identyfikatora kontaktu w określonym przedziale czasu.

  • Pobieranie listy życzeń

    • , metoda: GET
    • Ścieżka: /cdp/wishlist/{since}
    • Opis: Pobierz listę życzeń zaktualizowaną w określonym przedziale czasu.

Definicja interfejsu API

Łącznik używa następującej definicji interfejsu API:

  • Plik struktury Swagger: apiDefinition.swagger.json
    • Ten plik zawiera szczegółowy schemat interfejsu API i punkty końcowe używane przez łącznik.

Ustawienia

Ustawienia łącznika są zdefiniowane w następującym pliku:

  • Plik ustawień: settings.json
    • Ten plik zawiera różne ustawienia konfiguracji łącznika.

Icon

Ikona łącznika znajduje się w następującym pliku:

  • Plik ikony: icon.png
    • Ten plik jest używany jako wizualna reprezentacja łącznika w interfejsie platformy Power Platform.

Znane problemy i ograniczenia

  • Obecnie łącznik obsługuje podstawowe operacje. Funkcje zaawansowane zostaną dodane w przyszłych wersjach.
  • Upewnij się, że poświadczenia interfejsu API są poprawnie skonfigurowane, aby uniknąć błędów uwierzytelniania.

Support

W przypadku wszelkich problemów lub pomocy technicznej skontaktuj się z zespołem pomocy technicznej netvolution lub zapoznaj się z oficjalną dokumentacją.

Licencja

Ten łącznik jest licencjonowany w ramach licencji MIT. Aby uzyskać więcej informacji, zobacz plik LICENSE.

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:
Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
KLUCZ INTERFEJSU API securestring Klucz dla tego interfejsu API
Nazwa hosta netvolution ciąg Nazwa hosta netvolution (przykład: yourdomain.netvolution.net). Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Pobieranie listy życzeń

Pobieranie listy życzeń
Pobieranie szablonów wiadomości e-mail

Wyświetl listę wszystkich niestandardowych szablonów wiadomości e-mail.
Pobieranie zamówienia dla kontaktu

Sprawdź, czy kontakt złożył zamówienie.
Sprawdzanie, czy wystąpiło zdarzenie

Sprawdź, czy zdarzenie miało miejsce dla określonego identyfikatora kontaktu i przez określony czas.
Sprawdź, czy kontakt znajduje się na liście pomijania

Użyj tej akcji, aby sprawdzić, czy kontakt jest tymczasowo na liście pomijania.
Umieszczanie kontaktu w celu pomijania listy

Umieszczanie kontaktu w celu pomijania listy
Wyślij wiadomość e-mail

Ta akcja wyzwala kampanię poczty e-mail utworzoną w usłudze Netvolution.

Pobieranie listy życzeń

Identyfikator operacji:
GetWishList

Pobieranie listy życzeń

Parametry

Nazwa Klucz Wymagane Typ Opis
Przedział czasu
 since True string

Określ liczbę dni, w których chcesz sprawdzić zaktualizowane listy życzeń.

Zwraca

Nazwa Ścieżka Typ Opis
Results
 Results array of object

Results
CDPContactID
 Results.CDPContactID string

CDPContactID
Identyfikator użytkownika
 Results.UserID integer

Identyfikator użytkownika
Identyfikator listy życzeń
 Results.WishListID integer

Identyfikator listy życzeń
LastUpdated
 Results.LastUpdated string

LastUpdated
Identyfikator języka
 Results.LanguageID integer

Identyfikator języka

Pobieranie szablonów wiadomości e-mail

Identyfikator operacji:
GetEmailTemplates

Wyświetl listę wszystkich niestandardowych szablonów wiadomości e-mail.

Zwraca

Nazwa Ścieżka Typ Opis
Message
 Message boolean

Message
Results
 Results integer

Results

Pobieranie zamówienia dla kontaktu

Identyfikator operacji:
GetOrder

Sprawdź, czy kontakt złożył zamówienie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontaktu
 contactId True string

Użyj danych wyjściowych dla identyfikatora kontaktu na podstawie wcześniej używanego wyzwalacza.
Od
 since True string

Punkt w czasie, w którym sprawdzi, czy użytkownik złożył zamówienie.

Sprawdzanie, czy wystąpiło zdarzenie

Identyfikator operacji:
CheckEvent

Sprawdź, czy zdarzenie miało miejsce dla określonego identyfikatora kontaktu i przez określony czas.

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa zdarzenia
 eventName string

Wybierz dostępne zdarzenie.
Identyfikator kontaktu
 contactId string

Identyfikator kontaktu usługi CDP użytkownika.
Od
 since string

Punkt w czasie, w którym sprawdzi się później, czy wystąpiło zdarzenie.

Zwraca

Nazwa Ścieżka Typ Opis
Message
 Message boolean

Message
Results
 Results integer

Results

Sprawdź, czy kontakt znajduje się na liście pomijania

Identyfikator operacji:
GetContactIDFromSuppressionList

Użyj tej akcji, aby sprawdzić, czy kontakt jest tymczasowo na liście pomijania.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontaktu
 contactId True string

Identyfikator kontaktu usługi CDP użytkownika.
Nazwa listy
 listName True string

Nazwa listy pomijania.

Umieszczanie kontaktu w celu pomijania listy

Identyfikator operacji:
PutContactIDToSuppresionList

Umieszczanie kontaktu w celu pomijania listy

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontaktu
 contactId True string

Użyj danych wyjściowych dla identyfikatora kontaktu na podstawie wcześniej używanego wyzwalacza.
Nazwa listy pomijania
 listName True string

Nazwa listy pomijania.
Przedział czasu
 timeSpan True string

Określ liczbę dni, przez które identyfikator kontaktu pozostanie na liście pomijania dla tej kampanii.

Wyślij wiadomość e-mail

Identyfikator operacji:
SendMail

Ta akcja wyzwala kampanię poczty e-mail utworzoną w usłudze Netvolution.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator kontaktu
 cdpContactId string

Identyfikator kontaktu usługi CDP użytkownika.
Identyfikator języka
 languageId string

Identyfikator języka określony w witrynie netvolution.
Szablon wiadomości e-mail
 emailTemplate string

Wybierz kampanię e-mail.

Wyzwalacze

Kiedy nastąpi nowe zdarzenie

Użyj tego polecenia, aby wybrać zdarzenie jako wyzwalacz
Po dodaniu kontaktu do segmentu

Użyj tego wyzwalacza, gdy nowy kontakt zostanie dodany do segmentu

Kiedy nastąpi nowe zdarzenie

Identyfikator operacji:
OnNewEvent

Użyj tego polecenia, aby wybrać zdarzenie jako wyzwalacz

Parametry

Nazwa Klucz Wymagane Typ Opis
Nazwa zdarzenia
 eventName True string

Wybierz dostępne zdarzenie.

Zwraca

Nazwa Ścieżka Typ Opis
NastępnaSince
 NextSince string

NastępnaSince
Results
 Results array of object

Results
Identyfikator języka
 Results.LanguageID integer

Identyfikator języka
LanguageName
 Results.LanguageName string

LanguageName
Nazwa wydarzenia
 Results.EventName string

Nazwa wydarzenia
Sygnatura czasowa
 Results.Timestamp string

Sygnatura czasowa
CDPContactID
 Results.CDPContactID string

CDPContactID
Rodzina
 Results.Browser.OS.Family string

Rodzina
Maj
 Results.Browser.OS.Major string

Maj
IsSpider
 Results.Browser.Device.IsSpider boolean

IsSpider
Rodzina
 Results.Browser.Device.Family string

Rodzina
Marka
 Results.Browser.Device.Brand string

Marka
Model
 Results.Browser.Device.Model string

Model
Rodzina
 Results.Browser.UserAgent.Family string

Rodzina
Maj
 Results.Browser.UserAgent.Major string

Maj
Małoletni
 Results.Browser.UserAgent.Minor string

Małoletni
Patch
 Results.Browser.UserAgent.Patch string

Patch
id
 Results.List.id string

id
nazwa
 Results.List.name string

nazwa
ItemParentId
 Results.Product.ItemParentId string

ItemParentId
ItemName
 Results.Product.ItemName string

ItemName
Kategoria
 Results.Product.Category string

Kategoria

Po dodaniu kontaktu do segmentu

Identyfikator operacji:
OnNewUserInSegment

Użyj tego wyzwalacza, gdy nowy kontakt zostanie dodany do segmentu

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator segmentu
 Id True string

Użyj identyfikatora segmentu netvolution.

Zwraca

Nazwa Ścieżka Typ Opis
NastępnaSince
 NextSince string

NastępnaSince
Results
 Results array of object

Results
identyfikator
 Results.ID string

identyfikator
Data utworzenia
 Results.CreatedDate string

Data utworzenia
Adres e-mail
 Results.EmailAddress string

Adres e-mail
eStoreSessionId
 Results.eStoreSessionId string

eStoreSessionId
Imię (pierwsze)
 Results.FirstName string

Imię (pierwsze)
Nazwisko
 Results.LastName string

Nazwisko
Data urodzenia
 Results.DateOfBirth string

Data urodzenia
Gender
 Results.Gender string

Gender
Anonimowe
 Results.Anonymized boolean

Anonimowe
Code
 Results.MobilePhone.Code string

Code
Number
 Results.MobilePhone.Number string

Number
Kod kraju
 Results.MobilePhone.CountryCode string

Kod kraju
Wartość
 Results.ModifiedDate.Value string

Wartość
IsAutocalculated
 Results.ModifiedDate.IsAutocalculated boolean

IsAutocalculated
Code
 Results.Landline.Code string

Code
Number
 Results.Landline.Number string

Number
Kod kraju
 Results.Landline.CountryCode string

Kod kraju
Ulica
 Results.Address.Street string

Ulica
Miejscowość
 Results.Address.City string

Miejscowość
Kod pocztowy
 Results.Address.ZipCode string

Kod pocztowy
Powiat
 Results.Address.County string

Powiat
Country
 Results.Address.Country string

Country
Lokalizacja
 Results.Location string

Lokalizacja
Segments
 Results.Segments array of object

Segments
Identyfikator segmentu
 Results.Segments.SegmentID integer

Identyfikator segmentu
Element członkowski
 Results.Segments.MemberSince string

Element członkowski