Netvolution (預覽版)
Netvolution 連接器使企業能夠簡化和自動化其電子郵件行銷活動。 它能夠實現有針對性的電子郵件細分、個性化消息傳遞和基於用戶行為的自動化工作流程。 透過利用 Netvolution,行銷人員可以增強參與度、提高客戶保留率,並以最小的努力推動更高的轉換率。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域, 但下列區域除外: - Azure Government 區域 - Azure 中國區域 - 美國國防部 (DoD) |
| Power Apps | 進階 | 除下列區域外的所有 Power Apps 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| Power Automate(自動化服務) | 進階 | 除下列區域外的所有 Power Automate 區域 : - 美國政府 (GCC) - 美國政府(海灣合作委員會高中) - 由 21Vianet 營運的中國雲 - 美國國防部 (DoD) |
| 連絡人 | |
|---|---|
| 名稱 | 電通公司 |
| URL | https://www.atcom.gr |
| 連接器中繼資料 | |
|---|---|
| Publisher | ATCOM SA |
| 網站 | https://www.atcom.gr/ |
| 隱私策略 | https://www.atcom.gr/privacy-policy/ |
| 類別 | 商;行銷 |
Netvolution 連接器
簡介
Netvolution 連接器可讓您設計和自動化電子郵件行銷活動,包括向特定區段發送行銷電子郵件和基於行為操作的自動化行銷活動。 此連接器提供了一組操作來管理 Netvolution 平台內的各種資源並與之互動。
先決條件
在使用 Netvolution 連接器之前,您需要:
- Netvolution 實作。
- API 認證 (API 金鑰)。
使用者入門
若要使用 Netvolution 連接器,請遵循下列步驟:
將連接器新增至您的 Power Platform 環境:
- 瀏覽至 Power Platform 入口網站。
- 轉到“連接器”部分並添加一個新連接器。
- 搜尋“Netvolution”並選擇它。
設定連接器:
- 輸入您從 Netvolution 平台獲得的 API 憑據。
- 輸入您的 Netvolution 地址(不帶
https前綴)。 - 儲存設定。
在您的應用程式和流程中使用連接器:
- 將連接器新增至 Power Apps 或 Power Automate 流程。
- 使用可用的動作與 Netvolution 資源互動。
支援的作業
Netvolution Connector 支援下列作業:
取得電子郵件範本
- 方法: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 - 描述:檢查特定聯絡人 ID 在特定時段內是否發生事件。
獲取願望清單
- 方法:GET
-
路徑:
/cdp/wishlist/{since} - 描述:檢索在指定時間範圍內更新的願望清單。
API 定義
連接器會使用下列 API 定義:
-
Swagger 檔案:apiDefinition.swagger.json
- 此檔案包含連接器使用的詳細API結構描述和端點。
設定
連接器設定定義在下列檔案中:
-
設定檔案:settings.json
- 此檔案包含連接器的各種組態設定。
Icon
連接器圖示包含在下列檔案中:
-
圖示檔案:icon.png
- 此檔案用作 Power Platform 介面中連接器的視覺表示法。
已知問題和限制
- 目前,連接器支援基本作業。 進階功能將在未來的版本中新增。
- 請確定您的 API 認證已正確設定,以避免驗證錯誤。
Support
如有任何問題或支持,請聯繫 Netvolution 支持團隊或參閱官方文檔。
許可證
此連接器根據 MIT 許可證獲得許可。 如需詳細資訊,請參閱 LICENSE 檔案。
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
| 名稱 | 類型 | Description | 為必填項目 |
|---|---|---|---|
| API 金鑰 | securestring | 此 API 的金鑰 | |
| Netvolution 主機名稱 | 字串 | Netvolution 主機名稱 (範例:yourdomain.netvolution.net)。 | 對 |
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 傳送電子郵件 |
此操作會觸發在 Netvolution 中創建的電子郵件活動。 |
| 取得聯絡人訂單 |
檢查聯絡人是否已下訂單。 |
| 取得電子郵件範本 |
列出所有自訂電子郵件範本。 |
| 將聯絡人放入隱藏清單 |
將聯絡人放入隱藏清單 |
| 檢查事件是否發生 |
檢查特定聯絡人ID和特定時間段是否發生事件。 |
| 檢查聯絡人是否在禁止清單中 |
使用此動作可檢查聯絡人是否暫時處於隱藏清單中。 |
| 獲取願望清單 |
獲取願望清單 |
傳送電子郵件
此操作會觸發在 Netvolution 中創建的電子郵件活動。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
連絡人識別碼
|
cdpContactId | string |
使用者的 CDP 聯絡人 ID。 |
|
|
語言 ID
|
languageId | string |
netvolution 網站中指定的語言識別碼。 |
|
|
電子郵件範本
|
emailTemplate | string |
選取電子郵件行銷活動。 |
取得聯絡人訂單
檢查聯絡人是否已下訂單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
連絡人識別碼
|
contactId | True | string |
根據您先前使用的觸發程序,使用連絡人 ID 的輸出。 |
|
既
|
since | True | string |
它將檢查用戶是否已下訂單的時間點。 |
取得電子郵件範本
列出所有自訂電子郵件範本。
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Message
|
Message | boolean |
Message |
|
Results
|
Results | integer |
Results |
將聯絡人放入隱藏清單
將聯絡人放入隱藏清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
連絡人識別碼
|
contactId | True | string |
根據您先前使用的觸發程序,使用連絡人 ID 的輸出。 |
|
隱藏清單名稱
|
listName | True | string |
隱藏清單的名稱。 |
|
時間跨度
|
timeSpan | True | string |
指定聯絡人 ID 將保留在此行銷活動的「禁止清單」中的天數。 |
檢查事件是否發生
檢查特定聯絡人ID和特定時間段是否發生事件。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
事件名稱
|
eventName | string |
選取可用的事件。 |
|
|
連絡人識別碼
|
contactId | string |
使用者的 CDP 聯絡人 ID。 |
|
|
既
|
since | string |
之後檢查事件是否發生的時間點。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Message
|
Message | boolean |
Message |
|
Results
|
Results | integer |
Results |
檢查聯絡人是否在禁止清單中
使用此動作可檢查聯絡人是否暫時處於隱藏清單中。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
連絡人識別碼
|
contactId | True | string |
使用者的 CDP 聯絡人 ID。 |
|
清單名稱
|
listName | True | string |
隱藏清單的名稱。 |
獲取願望清單
獲取願望清單
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
時間跨度
|
since | True | string |
指定您要檢查更新的願望清單的天數。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Results
|
Results | array of object |
Results |
|
CDPContactID
|
Results.CDPContactID | string |
CDPContactID |
|
UserID
|
Results.UserID | integer |
UserID |
|
願望清單ID
|
Results.WishListID | integer |
願望清單ID |
|
最後更新
|
Results.LastUpdated | string |
最後更新 |
|
語言標識碼
|
Results.LanguageID | integer |
語言標識碼 |
觸發程序
| 將連絡人新增至區段時 |
當新聯絡人新增至區段時,請使用此觸發器 |
| 當新事件發生時 |
使用此選項來選取事件作為觸發器 |
將連絡人新增至區段時
當新聯絡人新增至區段時,請使用此觸發器
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
區段識別碼
|
Id | True | string |
使用 Netvolution 區段 ID。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
NextSince
|
NextSince | string |
NextSince |
|
Results
|
Results | array of object |
Results |
|
ID
|
Results.ID | string |
ID |
|
CreatedDate
|
Results.CreatedDate | string |
CreatedDate |
|
電子郵件地址
|
Results.EmailAddress | string |
電子郵件地址 |
|
eStoreSessionId
|
Results.eStoreSessionId | string |
eStoreSessionId |
|
FirstName
|
Results.FirstName | string |
FirstName |
|
姓氏
|
Results.LastName | string |
姓氏 |
|
出生日期
|
Results.DateOfBirth | string |
出生日期 |
|
性別
|
Results.Gender | string |
性別 |
|
匿名
|
Results.Anonymized | boolean |
匿名 |
|
Code
|
Results.MobilePhone.Code | string |
Code |
|
Number
|
Results.MobilePhone.Number | string |
Number |
|
國家代碼
|
Results.MobilePhone.CountryCode | string |
國家代碼 |
|
價值觀
|
Results.ModifiedDate.Value | string |
價值觀 |
|
是自動計算
|
Results.ModifiedDate.IsAutocalculated | boolean |
是自動計算 |
|
Code
|
Results.Landline.Code | string |
Code |
|
Number
|
Results.Landline.Number | string |
Number |
|
國家代碼
|
Results.Landline.CountryCode | string |
國家代碼 |
|
街道
|
Results.Address.Street | string |
街道 |
|
城市
|
Results.Address.City | string |
城市 |
|
郵遞區號
|
Results.Address.ZipCode | string |
郵遞區號 |
|
縣
|
Results.Address.County | string |
縣 |
|
國家
|
Results.Address.Country | string |
國家 |
|
地點
|
Results.Location | string |
地點 |
|
段落
|
Results.Segments | array of object |
段落 |
|
區段ID
|
Results.Segments.SegmentID | integer |
區段ID |
|
會員自
|
Results.Segments.MemberSince | string |
會員自 |
當新事件發生時
使用此選項來選取事件作為觸發器
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
事件名稱
|
eventName | True | string |
選取可用的事件。 |
傳回
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
NextSince
|
NextSince | string |
NextSince |
|
Results
|
Results | array of object |
Results |
|
語言標識碼
|
Results.LanguageID | integer |
語言標識碼 |
|
語言名稱
|
Results.LanguageName | string |
語言名稱 |
|
事件名稱
|
Results.EventName | string |
事件名稱 |
|
時間戳
|
Results.Timestamp | string |
時間戳 |
|
CDPContactID
|
Results.CDPContactID | string |
CDPContactID |
|
家庭
|
Results.Browser.OS.Family | string |
家庭 |
|
主要
|
Results.Browser.OS.Major | string |
主要 |
|
伊斯蜘蛛
|
Results.Browser.Device.IsSpider | boolean |
伊斯蜘蛛 |
|
家庭
|
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 |
|
識別碼
|
Results.List.id | string |
識別碼 |
|
名稱
|
Results.List.name | string |
名稱 |
|
ItemParentId
|
Results.Product.ItemParentId | string |
ItemParentId |
|
項目名稱
|
Results.Product.ItemName | string |
項目名稱 |
|
類別
|
Results.Product.Category | string |
類別 |