はじめに
Domo DataSetアラートからキャンペーンを開始できます。Domo DataSetアラートのドキュメントは ここ にあります。キャンペーンでDomo DataSetアラートを設定する
DataSetアラートに進む
Domo DataSetアラートを設定するには、 ［データ］ に進み、 ［アラート］ タブでDataSetを選択し、 ［新規アラート］ をクリックします。
アラートを設定
アラートのルールを設定します。アラートを設定するためのドキュメントは、 こちら を参照してください。注記： ［ データが更新され次第 、このアラートが発生状態であるときに通知されます］セクションに進み、［発生している状態の間は通知を送信し続ける］チェックボックスの チェックを外します 。そうしないと、キャンペーンが何度も発生し、受信者にスパムを送ることになる可能性があります。
Domo Webhookを作成
次のステップは、キャンペーンを発生させるDomo Webhookを作成することです。メッセージ画面で ［別の操作を追加］ をクリックして、 ［Domo Webhook］ を選択します。
Domo Webhookを設定
次に：- ［URL］ というタイトルのボックスに、次のURLを貼り付けます。 https://campaigns-prod.domolabs.io/api/v1/campaigns/bae/start
- ［方法］ に ［POST］ を設定します。
- ［シークレット（オプション）］ ボックスは空白のままにしておきます。
- ［Webhook本文］ をクリックして、このセクションを展開します。
Domo Webhook本文を設定
Domo Webhook本文を設定するには、 メッセージ の横にある鉛筆アイコンをクリックする必要があります。
キャンペーンID
開始したいキャンペーンのID。キャンペーンIDは、キャンペーンを編集し ［設定］ タブに移動することで確認できます。
Domoアクセストークン
Domoで生成されたDomoアクセストークン。Domoアクセストークンは、ログインして ［管理者］ 設定セクションに移動し、 ［セキュリティ］ に進み、 ［アクセストークン］ を選択することで生成できます。ここで、APIの呼び出しに使用する新しいアクセストークンを簡単に生成できます。
Domoアクセストークン所有者のメールアドレス
上記で指定した Domoアクセストークン を所有しているユーザーのメールアドレス。メールアドレス（オプション）
キャンペーンを配信するメールアドレスのリスト。メールアドレスが選択されていない場合、キャンペーン全体が開始され、配布リストのすべての受信者に配信されます。注記： これらのメールアドレスは配布リストに存在する 必要があります 。配布リストに存在しないメールアドレスを指定すると、そのメールアドレスにはメールは配信されません。
ヒント： ［+メトリクス］ ボタンを使って、このアラートを発生させたDataSet内に行の値を含めることができます。例えば、このキャンペーンを、このアラートを発生させたDataSet内の行のメールアドレスにのみ配信する場合は、 ［+メトリクス］ をクリックして、メールアドレスを含むDataSet内のフィールドを選択します。
インスタンス
お客様のDomoインスタンス（例： domo.domo.com ）。Is Test（オプション）
このフラグを使ってテストキャンペーンを送信できます。受信者にメールを実際に送信せずにキャンペーン、接続、アクセストークンなどをテストできます。これは、Campaigns Appの ［Distribution List］ 内から ［Test Email］ ボタンをクリックした場合と同じ機能です。テストキャンペーンを送信すると、配信されたコンテンツをテストおよび検証できるように、受信者ではなくキャンペーンの 送信者アドレス にメールが配信されます。注記： このフラグを true に設定した場合、 メールアドレス のフィールドに少なくとも1つのメールアドレスを指定する 必要があります 。少なくとも1つのメールアドレスを指定しないとテストキャンペーンを送信できません。
フィールド（オプション）
フィールドを使うと、アラートからキャンペーンにほかの情報と値を渡し、キャンペーンメッセージ内でその情報を使用できます。 例えば、このアラートを追加しようとしているDataSetに、 名 と 姓 のフィールドがあり、これらのフィールドをキャンペーンに含めたい場合は、DataSetから取得したこれらのフィールドを フィールド リストに含めることになります。次に、この キー を使ってこれらの値をキャンペーンに挿入できます。
注記： 障害や問題を避けるには、DataSetアラートでキーの名前がキャンペーンタグの名前と正確に一致していることを確認してください 。
Webhookの本文メッセージの例
完成したWebhookの本文メッセージの例は以下のようになります。
テストとエラー
テスト
Webhookの本文メッセージを設定したら、 ［テストを送信］ ボタンをクリックしてテストを実行できます。
注記： このキャンペーンを誤ってすべての受信者に送信しないように、必ず isTest フラグを true に設定し、 emailAddresses フィールドに少なくとも1つのメールアドレスを含めてください。
エラー
テストが成功しなかった場合、確認すべきことが多数あります。その一部は次の通りです。- キャンペーンIDが正しいかどうかを確認します。
- domoAccessToken フィールドで指定した有効なDomoアクセストークンがあることを確認します。
- Domoアクセストークンを所有しているDomoユーザーがキャンペーンおよびキャンペーンの配布リストDataSetにアクセスできることを確認します。
- domoAccessTokenOwnerEmailAddress フィールドで指定されたメールアドレスが、Domoアクセストークンを所有しているDomo内のユーザーのメールアドレスと一致していることを確認します。
- isTest フラグが true に設定されている場合、 emailAddresses フィールドに少なくとも1つのメールアドレスが含まれることを確認します。
- Webhookの本文メッセージが正しい形式のJSONオブジェクトであることを確認します。オンラインで利用可能な様々なJSON検証ツールを、確認に使用できます。