Zapierインテグレーションの概要

PendoプラットフォームとZapierのインテグレーションは現在ベータ版です。早期アクセスは招待リンクで管理されています(PendoとZapierの招待)。インテグレーション設定に関する詳しい説明はこちらの記事で紹介しています。Zapierで間違ったPendoバージョンを選択したり、正しくないインテグレーションキーを入力したりすると、インテグレーションが失敗します。注意して指示に従ってください。

Pendo FeedbackはZapierの公開アプリであり、招待リンクを使用しません。FeedbackとZapierのインテグレーションについては、Zapierのインテグレーション設定の記事をお読みください。

概要

PendoとZapierのインテグレーションにより、ユーザーがプロダクトで行うあらゆることに対して非常に簡単にアクションを実行できます。2000以上のZapier対応アプリを活用することで、多くのプロダクトに接続し、Pendoデータを使用して他のアプリでアクションをトリガーすることができます。

要件

このインテグレーションを使用するには、以下のアクセス許可が必要です。

  • Pendoサブスクリプションの管理者ユーザー権限
  • インテグレーションキーを生成するための有効化済みAPIアクセス
注:Zapierのセットアップに必要なインテグレーションキーは、Pendoインストールスニペットに表示されるキーとは異なります。
  • 管理者アクセス権がない場合は、Pendo管理者に連絡してください。管理者は、アクセス許可を調整できます。
  • インテグレーションキーへのアクセス権がない場合は、Pendoの担当者にお問い合わせください。

 

仕組み

Pendoのセグメントとレポート

Zapierで自動化するすべてのアクションについて、自動化を適用するアカウントまたは訪問者を指定する必要があります。これはセグメントを使用して行われます。セグメントルールは、レポートに表示される訪問者を定義し、レポートはZapierに表示される訪問者と関連データを定義します。

Zap(ワークフローを指すZapier用語)を作成すると、PendoレポートがZapierにリンクされます。レポートがリンクされると、ZapierはPendoに入り、レポートとそれに表示される訪問者のスナップショットを撮ります。このスナップショットを、今後のアクションを自動化するための基礎として使用します。

注:Zapierは、1回限りの一括アクションに使用することを目的としたものではありません。一括でメールユーザーを処理する場合は、訪問者レポートを.csv形式でダウンロードし、選択したメールクライアントにアップロードします。Zapierは、将来のアクティビティを自動化することを目的としているため、毎回手動で行う必要はありません。

プランレベルに応じて、Zapierは5〜15分ごとにレポートにアクセスし、リストに新たに追加された訪問者を探します。前回チェックしたときにいなかった訪問者を見つけた場合、Zapの次のステップを開始します。新しい訪問者が見つからない場合は、何も実行せず、5〜15分後にレポートを再度確認します。このプロセスは、Zapierプランの制限に従って無期限に繰り返されます。

 

PendoとZapierのインテグレーションの設定

Pendoインテグレーションキーを作成する

Zapierに移動する前に、Pendoでインテグレーションキーを設定します。

1.[設定(Setting)]で[インテグレーション(Integrations)]をクリックします。

IntSettings.png

 

2.[インテグレーションキー(Integrations Keys)]タブをクリックして、新しいインテグレーションキーを作成します。

AddIntKey.png

 

3.[+インテグレーションキーの追加(Add Integration Key)]をクリックし、インテグレーションキーに「Zapier」などの名前を付けてから、[作成(Create)]をクリックします。

AddNewIntKey.png
 

インテグレーションキーを生成したので、Zapierに移動して無料のアカウントを作成するか、既存のアカウントにログインします。

 

Zapierを構成する

PendoとZapierをリンクする

PendoとZapierのインテグレーションは招待制です。招待リンクをクリックするまで、ZapierのダッシュボードでPendoを見つけることはできません。

1. この招待状のリンク をクリックし、[招待を承諾してZapを設定する(Accept the Invite & Build a Zap)]をクリックします。

PendoInvite.png

 

アクセスが設定されたので、インテグレーションキーで作成したインテグレーションキーを使用して、PendoサブスクリプションをZapierにリンクする必要があります。最初のZapを作成する際にこれを行います。

2. Zapierダッシュボードの[Zapの作成(Make a Zap)]かZapの作成(Create Zap)]をクリックします。トリガーアプリを選択するように求められます。

 PendoInvite.png    CreateZap.png

 

3. Pendoを検索し、Pendo(3.0.3)を選択します。2.Xおよび1.Xのバージョン番号は、インテグレーション以前のバージョンであり、機能しません。

Pendo2.0.png
警告:対応バージョンはPendo(3.0.3)のみです。より高いバージョン番号や他の開発ビルドなどを含む、他のバージョンは対応していません。
 

4. トリガーを選択します。使用可能なオプションは、訪問者レポートから取得するレポート内の訪問者またはアカウントレポートから取得するレポート内のアカウントのみです。

ZapChooseTrigger.png
 

5.[続行(Continue)]をクリックして、PendoアカウントとZapierアカウントをリンクします。

Continue.png

 

6.[Pendoにサインイン(Sign in to Pendo (3.0.3))]をクリックしてZapier権限ページにアクセスし、Pendoインテグレーションキー設定で生成されたインテグレーションキーを入力する必要があります。

ZapSign2.0.png

 

7. インテグレーションキーを入力し、[続行する(Yes, Continue)]をクリックしてZapierをPendoサブスクリプションに接続します。

ZapIntKey.png
 
Pendoサブスクリプションのリージョンは、サブスクリプションのデータサーバーが配置されている場所です。
  • 米国:app.pendo.io
  • EU:app.eu.pendo.io
 

できました。ZapierアカウントとPendoが接続されました。Zapsを作成する際のトリガーアプリとして、Pendo(3.0.3)を利用できるようになります。

 

PnedoデータをZapierに取り込む

ZapierとPendoを接続すると、Pendo(3.0.3)アカウントを選択するように求められます。

1. [Pendo (3.0.3) host=app.pendo.io]を選択し、[続行(Continue)]をクリックします。

ZapChooseAccount.png

 

2. 訪問者のカスタマイズ(またはトリガーとしてレポートでアカウントを選択した場合はアカウントのカスタマイズ)により、Zapの起動に使用されるレポートIDを選択するように求められます。

3. レポートIDを選択し、[続行]をクリックします。ドロップダウンメニューには、Pendoからの訪問者またはアカウントレポートが表示されます。

ZapCustomizeVisitor.png

 

4. トリガーをテストしてPendoデータのZapierクエリを実行し、正しいアカウントとレポートが使用されていることを確認します。

TestTrigger.png

 

5. 訪問者またはアカウントレポートをクエリして、Zapierが見つけた訪問者またはアカウントデータを確認します。

ZapFoundVisitor.png

 

6. ステップ2に進み、Zapを作成しますPendoインテグレーションが機能しており、Pendoデータを取り込んでZapをトリガーしています。Pendoレポートデータを使用して、Zapierにインテグレーションされた他のアプリやイベントをアクティブ化します。アイデアが必要な場合は、Zapierレシピをご覧ください。

ZapStep2.png

 

レシピ

 

エラーと推奨事項

Zapierインテグレーションでエラーが発生した場合は、トラブルシューティングの推奨事項について以下を確認してください。

無効なインテグレーションキー(403)

ZapierでPendoアカウントを認証しようとしたときに次のエラーが発生した場合は、インテグレーションキーが無効だったことを意味します。キーを再確認して、Pendoで生成したものと一致することを確認します。完全一致でない場合は、認証されません。

zap-integrationkeyerror.png

読み取りのタイムアウト

「「ZapName」というタイトルのZapは、実行を試みるたびに繰り返しエラーが発生するため、オフになっています。(Your Zap titled ‘Zap Name’ has been turned off because we’re getting repeated errors nearly every time we try to run it.)」

これは、Zapierでタイムアウトが30秒に設定されたために発生します。この問題を軽減するには、Pendoでレポートの日付範囲を短くしてみてください。それでも問題が解決しない場合は、チケットを送信してテクニカルサポートに連絡してください。

 

招待のみのアプリスロットリング

Zapierから

「招待制のアプリを使用している場合、Dev app App12345API(AppNameHere)throttled(30秒あたり100回の実行)のようなエラーが発生することがありますので、サポートまでご連絡ください。これは、非公開アプリのスパムを防止するための制限を組み込んでいるために発生します。」

PendoとZapierは公開インテグレーションではなく、スロットリングの対象となります。そのため、Zapの実行速度は遅くなりますが、Zapの起動は停止しません。PendoレポートまたはZap詳細を変更し、Zapトリガーの量を減らして、このエラーメッセージの受信を停止し、必要に応じてスロットリングを防止します。

 

Zapierのスパム防止と保持される項目

Zapierから

「Zapで一度にトリガーする項目が大量(100個以上)にある場合、Zapierがそれらを保持して、確認を求めるメールを送信します。これにより、多くのタスクが誤って実行されるのを防ぎ、タスクの使用量を抑えることができ、アクションサービスにおいて意図しない結果を修正する面倒な作業を回避することができます。
リリースされると、これらのタスクは1秒あたり1つ処理されます。したがって、1,000のタスクは、リリース後にクリアするのに15分強かかることになります。」

このエラーは、Zapierから送信される自動メールでタスクを確認することで解決できます。スパム防止に問題がある場合は、Zapierサポートに連絡してトラブルシューティングを行ってください。