Marketoタスク

Marketoのタスクについて

Marketoタスクを使用すると、クアルトリクスからMarketoにデータを渡すことができます。このデータを使用して、Marketoリードを作成または更新したり、1つ以上のMarketoアクティビティを作成したりできます。Marketo内でカスタムアクティビティを使用してデータをフィルタリングしたり、トリガを作成したりできます。このタスクの設定時に、以下の 3 つのオプションのいずれかを選択することができます。

• Marketoアクティビティを作成: 1 つの活動をタスクにリンクして、リードが行う回答ごとに 1 つの活動を登録します。これは、アクティビティの属性として Marketo に渡す応答フィールドを選択できることを意味します。
• 複数のMarketoアクティビティを作成: 複数の活動をタスクにリンクして、リードが行う回答ごとに複数の活動を登録します。このタスクでは、応答に接続されたすべてのデータポイントが新規アクティビティとしてカウントされます。
• Marketoリードを作成または更新：アンケートの回答を新規または既存のMarketoリードにリンクします。リードが作成されると、リード ID が作成されます。この ID は、後続の［Marketo の作成］アクティビティまたは［複数の Marketo アクティビティの作成］タスクで使用できます。

Marketo構成

この拡張機能を使用する前に、Marketoアカウントでいくつかのアクションを実行する必要があります。

1. Qualtrics フィールドをマッピングするカスタムアクティビティを作成します。
2. Marketo拡張に使用するAPIユーザーとロールを作成します。アクティビティを作成および更新する権限をユーザおよびロールに付与してください。
3. インスタンスのクライアント ID、クライアントシークレット、および Munchkin ID を取得します。

Marketoアカウントの設定の詳細については、「Marketo拡張の概要」を参照してください。

Marketoタスクの初期セットアップ

Marketoアカウントの準備が完了したら、QualtricsでMarketoタスクの設定を開始します。このセクションでは、Marketoアカウントに接続し、Marketoで必要なタスクを選択するための初期設定について説明します。

1. アンケートで［ワークフロー］タブに移動します。
   
2. [ワークフローを作成] をクリックします。
3. [イベントの受信時に開始] を選択します。
4. 以下を定義します。 イベント Marketoでワークフローをトリガーしますほとんどの場合、これはクアルトリクスからのアンケート回答です。
   
5. 必要に応じて、プラス記号 (+) をクリックしてから [条件] をクリックし、ワークフローがトリガされる条件を設定します。
   ヒント：アンケートに回答が送信されるたびに、Marketoで作成されたカスタムアクティビティが不要な場合に最適です。
6. プラス記号（+）の次に［タスク］をクリックします。
7. ［Marketo］を選択します。
   
8. Marketoで実行するタスクを選択します。
   
   オプションは次のとおりです。
   • 複数のMarketoアクティビティを作成：アンケートの回答ごとに複数の新しいMarketoアクティビティを作成します。
   • Marketoアクティビティを作成：アンケートの回答ごとに新しいMarketoアクティビティを作成します。
   • Marketoリードを作成または更新: リードの電話番号、電子メールアドレスなどを登録または更新します。
9. ［次へ］をクリックします。
10. 接続先のMarketoアカウントを選択します。以前に接続したアカウントと、ブランド管理者が接続したアカウントをブランド使用のために選択できます。
    
11. 新しいアカウントを接続するには、[ユーザアカウントの追加] をクリックします。
    ヒント：［ユーザーアカウントを追加］をクリックした後、アカウントに名前を付けて識別します。次に、クライアント ID とクライアントシークレットを追加します。
    
    ヒント：クライアントIDとクライアントシークレットは、［管理］、［Marketo］の起動ポイントで確認できます。表示されたら、サービスの横にある [詳細の表示] をクリックします。
    
12. [次へ] をクリックします。
13. Munchkin ID を入力します。
    
    ヒント：MunchkinIDは、MarketoのIDURLの最初の11文字です。
14. [照合] をクリックします。
15. タスク設定の残りの部分は、ステップ 8 で選択したオプションによって異なります。詳細については、リンクされたセクションを参照してください。
    • Marketoアクティビティを作成
    • 複数のMarketoアクティビティを作成
    • Marketoリードを作成または更新

Marketoアクティビティを作成

1つの活動をリンクすると、リードが行うアンケート回答ごとに 1 つの Marketo 活動が作成されます。このオプションを使用すると、Marketoにアクティビティの属性として渡す回答フィールドを選択して選択できます。

1. Marketo Task Initial Setup セクションの手順に従い、タスクとして Create a MarketoActivity を選択します。
2. アクティビティ選択ドロップダウンを使用して、カスタムアクティビティを選択します。
   
   ヒント：このドロップダウンで利用できるアクティビティは、Marketoで設定したカスタムアクティビティによって異なります。アクティビティについては、Marketoのマニュアルを参照してください。
   注意: アクティビティのドロップダウンにアクティビティが表示されない場合は、誤った認証情報を入力している可能性があります。正しい認証情報を使用している場合は、Marketoでユーザーまたは役割に付与されている権限を調整する必要がある場合があります。詳細については「Marketo設定」を参照してください。
3. テキストの差し込みアイコン {a} をクリックし、リード ID に対応する埋め込みデータフィールドを選択して、リード ID フィールドを入力します。これは、メーリングリストに保存された外部の埋め込みデータか、以前のタスクから渡されたデータである可能性があります。
   ヒント：Marketoに回答を送信するには、カスタムアクティビティがMarketoのリードに接続されているため、すべての回答にリードIDが必要です。
   例：［Marketoリードを作成または更新する］タスクを使用すると、最初にMarketoでリードを作成または更新できます。これにより、リードIDがクアルトリクスで利用可能になります。次に、［Marketoを作成］アクティビティタスクを使用してアクティビティを挿入します。テキストの差し込みメニューには、差し込むリードIDが表示されます。
4. アクティビティの主要属性をマッピングします。これは必須です。この場合、これは回答の一意のIDであるため、［回答ID］にはテキストの差し込みが選択されています。
5. フィールドを追加するには、［フィールドを追加］をクリックし、［Marketo］フィールドと［ Qualtricsソース］フィールドを選択します。ソースフィールドで、テキストの差し込みアイコン {a} をクリックし、使用するクアルトリクスフィールドを選択します。このメニューで使用できるフィールドは、選択したイベントによって異なります。調査回答イベントを選択した場合、オプションは次のとおりです。
   • アンケートの質問：アンケートの質問に対する回答者。
   • 埋め込みデータフィールド：埋め込みデータフィールド。
   • GeoIP位置情報：GeoIPデータに基づく回答の郵便番号、市区町村、都道府県/州、市外局番、または国名。
   • DateTime: 現在の日時、または現在の日時を基準にした日時
   • パネルフィールド：回答者の名、姓、メールアドレス、外部データ参照、言語（メーリングリストに保存されている場合）。
   • 割り当て：アンケートの割り当てが増加した回答を示します。
   • 応答: 回答の ID および回答リンク。
   • ステータス: 応答のステータス。
6. フィールドを削除するには、フィールドの横にあるマイナス記号 ( – ) をクリックします。
7. 保存をクリックして終了します。

複数のMarketoアクティビティを作成

クアルトリクスのイベントに複数の Marketoアクティビティをリンクすると、回答に関連付けられたすべてのデータポイントが新しいアクティビティとしてカウントされます。これには、回答に接続されたすべての質問フィールドと埋め込みデータが含まれます。

1. Marketo Task Initial Setup セクションの手順に従い、タスクとして Create a MarketoActivity を選択します。
2. アクティビティ選択ドロップダウンを使用して、カスタムアクティビティを選択します。
   
   ヒント：このドロップダウンで利用できるアクティビティは、Marketoで設定したカスタムアクティビティによって異なります。アクティビティについては、Marketoのマニュアルを参照してください。
   注意: アクティビティのドロップダウンにアクティビティが表示されない場合は、誤った認証情報を入力している可能性があります。正しい認証情報を使用している場合は、Marketoでユーザーまたは役割に付与されている権限を調整する必要がある場合があります。
3. テキストの差し込みアイコン {a} をクリックし、リード ID に対応する埋め込みデータフィールドを選択して、リード ID フィールドを入力します。これは、メーリングリストに保存された外部の埋め込みデータか、以前のタスクから渡されたデータである可能性があります。
   ヒント：Marketoに回答を送信するには、カスタムアクティビティがMarketoのリードに接続されているため、すべての回答にリードIDが必要です。
   例：［Marketoリードを作成または更新する］タスクを使用すると、最初にMarketoでリードを作成または更新できます。これにより、リードIDがクアルトリクスで利用可能になります。次に、［Marketoを作成］アクティビティタスクを使用してアクティビティを挿入します。テキストの差し込みメニューには、差し込むリードIDが表示されます。
4. アクティビティの主要属性をマッピングします。これは必須です。この場合、これは回答の一意のIDであるため、［回答ID］フィールドを選択しました。
5. フィールドを追加するには、［フィールドを追加］をクリックし、［Marketo］フィールドと［ Qualtricsソース］フィールドを選択します。ソースフィールドでは、事前定義されたクアルトリクス属性のリストから選択できます。
   • SurveyID: タスクを設定する Qualtrics 調査の一意の ID。
   • ResponseID：クアルトリクスが定義した回答のIDです。
   • QuestionID：クアルトリクスがアンケートの質問に定義したID。
   • ExportTag：アンケートの質問を識別するために使用されるタグです。ユーザはこれらを編集できます。エクスポートタグを参照してください。
   • ChoiceText：回答者が選択した選択肢のテキスト。変数名とも呼ばれます。
   • ChoiceRecode：回答者が選択した選択肢の識別値を割り当てます。
   • EmbeddedDataField: ユーザー定義の埋め込みデータフィールド名。
   • EmbeddedDataValue: 埋め込みデータフィールドの値。
     例：使用可能なすべてのフィールドを追加した場合、マッピングは以下のようになります：
     
6. フィールドを削除するには、フィールドの横にあるマイナス記号 ( – ) をクリックします。
7. 終了したら、［保存］をクリックします。

Marketoリードの作成または更新

Marketoでリードを作成または更新すると、アンケートの回答などのクアルトリクスのイベントデータを取り込み、この情報を使用してMarketoで新しいリードを作成したり、新しい情報でリードを更新したりできます。作成または更新が正常に完了すると、リード ID が返されます。このリード ID は、Marketo の作成アクティビティまたは複数の Marketo アクティビティの作成タスクで使用できます。

1. Marketo Task Initial Setup セクションの手順に従い、タスクとして Create a MarketoActivity を選択します。
2. リードを登録または更新するイベントタイプを選択します。各オプションにより、タスク設定が若干変更されます。
   
   • リードの作成または更新：最初にMarketoでリードを検索し、マッピングされたフィールドをそのユーザーに更新します。リードが見つからない場合は、マッピングされた項目を使用して新規リードが登録されます。
   • 作成のみ：Marketoで新しいリードを作成しようとします。リードがすでに存在する場合、Marketoはエラーを返します。
   • 更新のみ：Marketoの既存のリードを更新しようとします。リードが存在しない場合は、markoto からエラーが返されます。
3. “登録のみ” を選択した場合は、新規リードを登録するため、このステップをスキップします。［リードの作成または更新］または［更新のみ］を選択した場合は、検索フィールドを選択して Marketo でリードを検索する必要があります。[検索対象] ドロップダウンを使用して、フィールドを選択します。
   
   ヒント：検索できるフィールドは、通常、すべてのリードフィールドのサブセットになります。これらは検索可能項目とみなされます。このMarketoサポートページの検索可能なフィールドの詳細を参照してください。
4. “登録のみ” を選択した場合は、新規リードを登録するため、このステップをスキップします。’リードの登録または更新’ または ‘更新のみ’ を選択した場合は、必須項目として選択した項目をマッピングする必要があります。このフィールドは、Marketoにリードがすでに存在するかどうかを識別するために使用されます。テキストの差し込みアイコン {a} を使用して、クアルトリクスからフィールドを選択します。
   
5. フィールドを追加するには、［フィールドを追加］をクリックし、［Marketo］フィールドと［ Qualtricsソース］フィールドを選択します。ソースフィールドで、テキストの差し込みアイコン {a} をクリックし、使用するクアルトリクスフィールドを選択します。このメニューで使用できるフィールドは、選択したイベントによって異なります。調査回答イベントを選択した場合、オプションは次のとおりです。
   
   • アンケートの質問：アンケートの質問に対する回答者。
   • 埋め込みデータフィールド：埋め込みデータフィールド。
   • GeoIP位置情報：GeoIPデータに基づく回答の郵便番号、市区町村、都道府県/州、市外局番、または国名。
   • DateTime: 現在の日時、または現在の日時を基準にした日時
   • パネルフィールド：回答者の名、姓、メールアドレス、外部データ参照、言語（メーリングリストに保存されている場合）。
   • 割り当て：アンケートの割り当てが増加した回答を示します。
   • 応答: 回答の ID および回答リンク。
   • ステータス: 応答のステータス。
6. フィールドを削除するには、フィールドの横にあるマイナス記号 ( – ) をクリックします。
7. [保存] をクリックして終了します。

FAQ