要約：◀▼
サーバーサイドAPIキーを使用してアクションフローをIterableに接続し、ユーザープロフィールの管理、イベントの追跡、コメント、メールキャンペーンを自動化できます。Iterableには、ユーザーの作成、更新、参照、トリガメールの送信、キャンペーンの管理などのアクションがあります。インテグレーション専用のサービスアカウントを使用し、正しいデータセンターを指定して、プラットフォーム全体で適切な認証とスムーズなワークフローの自動化を実現します。
アクションビルダーをIterableに接続する
外部アクションをアクションフローで使用するには、アクションビルダーを外部システムへ接続する必要があります。
- アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
- すべてのインテグレーションでは、必要なスコープへのアクセスが要求されます。ただし、外部システムへの接続を承認する前に、スコープを確認し、妥当性を検証することが重要です。
- OpenAIなどのAPIキーベースのツールの認証情報を管理する場合は、キーを安全な保管庫または認証情報マネージャーに保存することをお勧めします。
APIキーを作成するには
- Iterableアカウントにログインします。
- 「Integrations」>「API Keys」に移動します。
- サーバーサイドのAPIキーを新規作成します。
- 作成したAPIキーを保存するか、ウィンドウを開いたままにして、Zendeskにコピー＆ペーストできるようにしておきます。
このキーは、アクションビルダーをIterableに接続する際に必要になります。
- 管理センターで、サイドバーにある「
アプリおよびインテグレーション」をクリックし、「アクション」>「アクションフロー」を選択します。 - アクションフローを新規作成するか、既存のアクションフローを編集します。
- ステップサイドバーを開きます。
- 「外部アクション」セクションで、「Iterable」をクリックします。
- 「接続」をクリックします。
- Iterableの指示に従って認証を行い、コネクションを完了します。
- IterableのサーバーサイドAPIキーを入力します。
- データセンターの地域（米国またはEU）を指定します。Iterableアカウントが欧州連合域内のデータセンターでホストされている場合、データセンターとして「EU」を指定する必要があります。空白のままにすると、デフォルトで米国のデータセンター（api.iterable.com）へ接続します。間違ったデータセンターを使用すると、認証に失敗します。
メモ：アクションフローによって実行される外部アクションは、すべて外部システムを接続したユーザーに帰属します。したがって、各外部システムに接続する場合、個人の資格情報ではなく専用のサービスアカウントを使用することが推奨されます。
接続が完了すると、接続していることを示すインジケーター、接続したインスタンスの詳細、およびIterableで利用可能なアクションが表示されます。
アクションフローでIterableアクションを使用する
ユーザーを作成する
「ユーザーを作成」アクションを使用して、Iterableにユーザープロフィールを新規作成します。ユーザーがすでに存在する場合、プロフィールは提供された情報で更新されます（アップサート動作）。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Emailオプション： |
| 出力 | 成功ステータス、メッセージ、メール、ユーザーID。 |
ユーザーを更新する
「ユーザーを更新」アクションを使用して、Iterableの既存のユーザープロフィールを更新します。ユーザーが存在しない場合、提供された情報で新しいプロフィールが作成されます（アップサート動作）。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Emailオプション： |
| 出力 | 成功ステータス、メッセージ、メール、ユーザーID。 |
ユーザーを参照する
「ユーザーを参照」アクションを使用して、メールアドレスまたはユーザーIDでユーザープロフィールを取得します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Identifier type、Identifier value
|
| 出力 | ユーザープロフィールの詳細情報：メール、ユーザーID、登録日、プロフィールの更新日、カスタムデータフィールドなど。 |
イベントを作成する
「イベントを作成」アクションを使用して、Iterableでユーザーのカスタムイベントを追跡します。イベントは、セグメント化、キャンペーントリガ、分析に使用できます。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Email、Event
nameオプション： |
| 出力 | 成功ステータス、メッセージ、イベント名、メール、ユーザーID、イベントID。 |
コメントを追加する
「コメントを追加」アクションを使用して、ユーザープロフィールにコメントまたはメモを追加します。コメントは、ユーザーのデータフィールドにカスタムフィールドとして保存されます。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Email、Commentオプション： |
| 出力 | 成功ステータス、メッセージ、メール、ユーザーID、コメントが保存されたフィールド名。 |
ユーザーにメールを送信する
「ユーザーにメールを送信」アクションを使用して、Iterableキャンペーンを使用してユーザーにトリガメールを送信します。キャンペーンはトリガ可能な状態でなければなりません。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Campaign、Recipient
emailオプション： |
| 出力 | 成功ステータス、メッセージ、キャンペーンID、受信者のメールアドレス、送信予定時刻。 |
キャンペーンを参照する
「キャンペーンを参照」アクションを使用して、名前、ステータス、タイプ、テンプレート情報など、キャンペーンの詳細を取得します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | 必須：Campaign
|
| 出力 | キャンペーンの詳細情報：ID、名前、ステータス、タイプ、テンプレートID、リストID、送信時間、作成日、更新日など。 |
キャンペーンをリストする
「キャンペーンをリスト」アクションを使用して、Iterable プロジェクト内のすべてのキャンペーンを取得します。
このアクションには以下の入力と出力が含まれます。
| 変数 | |
|---|---|
| 入力 | なし |
| 出力 | キャンペーンオブジェクト（ID、名前、ステータス、タイプを含む）の配列、および総件数。 |