Netvolution (プレビュー)
Netvolution Connector を使用すると、企業はメール マーケティング キャンペーンを合理化および自動化できます。 これにより、ユーザーの行動に基づいて、対象を絞った電子メールのセグメント化、パーソナライズされたメッセージング、自動化されたワークフローが可能になります。 マーケティング担当者は、Netvolution を活用することで、最小限の労力でエンゲージメントを強化し、顧客のリテンション期間を改善し、より高いコンバージョンを推進できます。
このコネクタは、次の製品とリージョンで使用できます。
| サービス | クラス | リージョン |
|---|---|---|
| コピロット スタジオ | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| ロジック アプリ | Standard | 次を除くすべての Logic Apps リージョン : - Azure Government リージョン - Azure China リージョン - 米国国防総省 (DoD) |
| Power Apps | Premium | 次を除くすべての Power Apps リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| Power Automate | Premium | 次を除くすべての Power Automate リージョン : - 米国政府 (GCC) - 米国政府 (GCC High) - 21Vianet が運営する China Cloud - 米国国防総省 (DoD) |
| お問い合わせ | |
|---|---|
| 名前 | Atcom SA |
| URL | https://www.atcom.gr |
| コネクタ メタデータ | |
|---|---|
| Publisher | Atcom S.A |
| Web サイト | https://www.atcom.gr/ |
| プライバシー ポリシー | https://www.atcom.gr/privacy-policy/ |
| カテゴリ | 商業;マーケティング |
Netvolution コネクタ
イントロダクション
Netvolution Connector を使用すると、特定のセグメントにマーケティング 電子メールを送信したり、行動アクションに基づいて自動化されたキャンペーンを行うなど、電子メールマーケティング活動を設計および自動化できます。 このコネクタには、Netvolution プラットフォーム内のさまざまなリソースを管理および操作するための一連のアクションが用意されています。
[前提条件]
Netvolution コネクタを使用する前に、次のものが必要です。
- Netvolution の実装。
- API 資格情報 (API キー)。
はじめに
Netvolution コネクタを使用するには、次の手順に従います。
Power Platform 環境にコネクタを追加します。
- Power Platform ポータルに移動します。
- [コネクタ] セクションに移動し、新しいコネクタを追加します。
- "Netvolution" を検索して選択します。
コネクタを構成します。
- Netvolution プラットフォームから取得した API 資格情報を入力します。
- Netvolution アドレスを入力します (
httpsプレフィックスは付けず)。 - 構成を保存します。
アプリとフローでコネクタを使用する:
- 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 - 説明: 特定の期間内に特定の連絡先 ID に対してイベントが発生したかどうかを確認します。
ウィッシュ リストを取得する
- メソッド: GET
-
パス:
/cdp/wishlist/{since} - 説明: 指定された期間内に更新されたウィッシュ リストを取得します。
API 定義
コネクタでは、次の API 定義を使用します。
-
Swagger ファイル: apiDefinition.swagger.json
- このファイルには、コネクタで使用される詳細な API スキーマとエンドポイントが含まれています。
設定
コネクタの設定は、次のファイルで定義されています。
-
設定ファイル: settings.json
- このファイルには、コネクタのさまざまな構成設定が含まれています。
Icon
コネクタ アイコンは、次のファイルに含まれています。
-
アイコン ファイル: icon.png
- このファイルは、Power Platform インターフェイスのコネクタの視覚的表現として使用されます。
既知の問題と制限事項
- 現時点では、コネクタは基本的な操作をサポートしています。 高度な機能は、今後のリリースで追加される予定です。
- 認証エラーを回避するために、API 資格情報が正しく構成されていることを確認します。
Support
問題やサポートについては、Netvolution サポート チームに問い合わせるか、公式ドキュメントを参照してください。
ライセンス
このコネクタは MIT ライセンスに基づきライセンスされます。 詳細については、LICENSE ファイルを参照してください。
接続を作成する
コネクタでは、次の認証の種類がサポートされています。
| デフォルト | 接続を作成するためのパラメーター。 | すべてのリージョン | 共有不可 |
デフォルト
適用対象: すべてのリージョン
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
| 名前 | タイプ | Description | 必須 |
|---|---|---|---|
| API KEY | securestring | この API のキー | |
| Netvolution ホスト名 | 文字列 | Netvolution ホスト名 (例: yourdomain.netvolution.net)。 | 正しい |
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| イベントが発生したかどうかを確認する |
特定の連絡先 ID と一定期間にイベントが発生したかどうかを確認します。 |
| ウィッシュ リストを取得する |
ウィッシュ リストを取得する |
| 連絡先が抑制リストに含まれるかどうかを確認する |
このアクションを使用して、連絡先が抑制リストに一時的に存在するかどうかを確認します。 |
| 連絡先の注文を取得する |
連絡先が注文を行ったかどうかを確認します。 |
| 連絡先を抑制リストに配置する |
連絡先を抑制リストに配置する |
| 電子メール テンプレートを取得する |
すべてのカスタム電子メール テンプレートを一覧表示します。 |
| 電子メールの送信 |
このアクションにより、Netvolution で作成されたメール キャンペーンがトリガーされます。 |
イベントが発生したかどうかを確認する
特定の連絡先 ID と一定期間にイベントが発生したかどうかを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イベント名
|
eventName | string |
使用可能なイベントを選択します。 |
|
|
接触 ID
|
contactId | string |
ユーザーの CDP 連絡先 ID。 |
|
|
から
|
since | string |
イベントが発生したかどうかを後で確認する時点。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ
|
Message | boolean |
メッセージ |
|
結果
|
Results | integer |
結果 |
ウィッシュ リストを取得する
ウィッシュ リストを取得する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
期間
|
since | True | string |
更新されたウィッシュ リストを確認する日数を指定します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
結果
|
Results | array of object |
結果 |
|
CDPContactID
|
Results.CDPContactID | string |
CDPContactID |
|
UserID
|
Results.UserID | integer |
UserID |
|
WishListID
|
Results.WishListID | integer |
WishListID |
|
LastUpdated
|
Results.LastUpdated | string |
LastUpdated |
|
LanguageID
|
Results.LanguageID | integer |
LanguageID |
連絡先が抑制リストに含まれるかどうかを確認する
このアクションを使用して、連絡先が抑制リストに一時的に存在するかどうかを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
接触 ID
|
contactId | True | string |
ユーザーの CDP 連絡先 ID。 |
|
リスト名
|
listName | True | string |
抑制リストの名前。 |
連絡先の注文を取得する
連絡先が注文を行ったかどうかを確認します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
接触 ID
|
contactId | True | string |
以前に使用したトリガーに基づいて、連絡先 ID の出力を使用します。 |
|
から
|
since | True | string |
ユーザーが注文を行ったかどうかを確認する時点。 |
連絡先を抑制リストに配置する
連絡先を抑制リストに配置する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
接触 ID
|
contactId | True | string |
以前に使用したトリガーに基づいて、連絡先 ID の出力を使用します。 |
|
抑制リスト名
|
listName | True | string |
抑制リストの名前。 |
|
期間
|
timeSpan | True | string |
このキャンペーンの抑制リストに連絡先 ID が残る日数を指定します。 |
電子メール テンプレートを取得する
すべてのカスタム電子メール テンプレートを一覧表示します。
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
メッセージ
|
Message | boolean |
メッセージ |
|
結果
|
Results | integer |
結果 |
電子メールの送信
このアクションにより、Netvolution で作成されたメール キャンペーンがトリガーされます。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
接触 ID
|
cdpContactId | string |
ユーザーの CDP 連絡先 ID。 |
|
|
言語 ID
|
languageId | string |
netvolution サイトで指定されている言語 ID。 |
|
|
電子メール テンプレート
|
emailTemplate | string |
メール キャンペーンを選択します。 |
トリガー
| 新しいイベントが発生した場合 |
これを使用して、トリガーとしてイベントを選択します |
| 連絡先がセグメントに追加されたとき |
新しい連絡先がセグメントに追加されたときにトリガーを使用する |
新しいイベントが発生した場合
これを使用して、トリガーとしてイベントを選択します
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
イベント名
|
eventName | True | string |
使用可能なイベントを選択します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
NextSince
|
NextSince | string |
NextSince |
|
結果
|
Results | array of object |
結果 |
|
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 |
少佐 |
|
Minor
|
Results.Browser.UserAgent.Minor | string |
Minor |
|
Patch
|
Results.Browser.UserAgent.Patch | string |
Patch |
|
id
|
Results.List.id | string |
id |
|
名前
|
Results.List.name | string |
名前 |
|
ItemParentId
|
Results.Product.ItemParentId | string |
ItemParentId |
|
アイテム名
|
Results.Product.ItemName | string |
アイテム名 |
|
カテゴリ
|
Results.Product.Category | string |
カテゴリ |
連絡先がセグメントに追加されたとき
新しい連絡先がセグメントに追加されたときにトリガーを使用する
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
セグメント ID
|
Id | True | string |
Netvolution セグメント ID を使用します。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
NextSince
|
NextSince | string |
NextSince |
|
結果
|
Results | array of object |
結果 |
|
ID
|
Results.ID | string |
ID |
|
CreatedDate
|
Results.CreatedDate | string |
CreatedDate |
|
メールアドレス
|
Results.EmailAddress | string |
メールアドレス |
|
eStoreSessionId
|
Results.eStoreSessionId | string |
eStoreSessionId |
|
ファーストネーム
|
Results.FirstName | string |
ファーストネーム |
|
LastName
|
Results.LastName | string |
LastName |
|
生年月日
|
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 |
価値 |
|
IsAutocalculated
|
Results.ModifiedDate.IsAutocalculated | boolean |
IsAutocalculated |
|
Code
|
Results.Landline.Code | string |
Code |
|
Number
|
Results.Landline.Number | string |
Number |
|
国コード
|
Results.Landline.CountryCode | string |
国コード |
|
Street
|
Results.Address.Street | string |
Street |
|
市区町村
|
Results.Address.City | string |
市区町村 |
|
ZipCode
|
Results.Address.ZipCode | string |
ZipCode |
|
郡
|
Results.Address.County | string |
郡 |
|
Country
|
Results.Address.Country | string |
Country |
|
ロケーション
|
Results.Location | string |
ロケーション |
|
セグメント
|
Results.Segments | array of object |
セグメント |
|
SegmentID
|
Results.Segments.SegmentID | integer |
SegmentID |
|
MemberSince
|
Results.Segments.MemberSince | string |
MemberSince |