Marketo入力ツール

Marketo入力ツールは、特定のパラメータに基づいてMarketoレコードを読み込みます。 Marketoインスタンスで開始するデータがない場合、またはMarketoインスタンスからサンプリングするデータがない場合は、Marketo入力ツールを使用してください。 Marketoからの追加データに結合させたいデータがある場合は、Marketo付加ツールが適切なオプションです。

ギャラリーツール

このツールはDesignerでは自動的にインストールされません。 このツールを使用するには、Alteryx Analytics Galleryからダウンロードしてください。

ツールを設定する

Marketo資格情報

URL: レコードを取得する Marketo REST インスタンス。 この情報はMarketo(管理 > 統合 > ウェブサービス > REST API)にあります。

クライアント id: API ロールユーザーのクライアント id。 この情報はMarketo(管理 > 統合 > LaunchPoint)にあります。

クライアントシークレット: API ロールユーザーのクライアントシークレット。 この情報はMarketo(管理 > 統合 > LaunchPoint)にあります。

Marketo rest API にアクセスするための web サービスとユーザーロールの設定の詳細については、Marketo rest ドキュメントサイトを参照してください。

オプション

2種類 Marketo のレコードを取得することができます:

  • LeadRecords: これらは潜在顧客レコードであり、各潜在顧客に対して1つのレコードが存在します。
  • 潜在顧客活動レコード: これらのレコードは、各潜在顧客の活動を追跡します。 各リードレコードには潜在的に多くのリードアクティビティレコードがあります。

レコードのタイプの選択に基づいて、さまざまなオプションが利用可能で、その選択に基づいて、構成がオプションであるものと必要であるものに対してパラメータが利用可能になります。 下の表は、選択した構成に基づいて必要なパラメータを示しています。

レコードタイプ オプションタイプ リスト アクティビティタイプ(1-10) 出力フィールド 開始日時
リードレコード アクティビティタイプによる 任意 必須 任意 必須
リードレコード リストIDによる 必須 N/A 任意 N/A
リードレコード リードの変更による 任意 N/A N/A 必須
リードアクティビティ アクティビティタイプによる N/A 必須 N/A 必須
リードアクティビティ リードの変更による N/A N/A N/A 必須

パラメーター

リスト: 構成で指定された Marketo インスタンスのすべての静的リストがここに一覧表示されます (スマートリストは API 経由では現在使用できません)-1 つの要求に対してのみリストの選択が許可されます。

活動タイプ: Marketo で利用可能なすべての活動タイプは、1つのリクエストにつき最大10種類のアクティビティタイプを選択できます。

出力フィールド: Marketo インスタンスで使用可能なすべてのフィールドが一覧表示されます。 選択されていない場合は、フィールドの既定のリストが返されます: 電子メール、潜在顧客 ID、名、姓、更新時に、で作成されます。

[開始日/時刻]: データベースの開始点を指定して、レコードの取得を開始します。

データに関する検討事項

認証の失敗などのエラーメッセージ が設定ウィンドウに表示されます。 欠落した構成選択などのエラーメッセージは、ワークフローのツール上に表示されます。

このツールは300レコード以下のバッチでレコードを送信します。各バッチは、Marketoによって設定された1日の制限に対して個別のAPI呼び出しとしてカウントされます。

Marketo REST APIはアカウントを1日当たり10,000リクエストに制限し、REST APIへのリクエストはSOAP APIの日々の制限に対してカウントされません。

AlterxでMarketoのフィールド構造を維持してから、エラーを回避するためにMarketoに返信してください。 Marketoコネクタは、フィールド名が有効である限り、Marketoに出力する前にデータを適切なデータ型に変換します。 Marketoでフィールド名が見つからない場合、出力は失敗します。

DateTimeFields

Marketoのすべての日付は、UTCオフセットで保存されます。 この形式は 正または負のオフセットが付加されたローカル時刻の。 たとえば、Marketo の datetime 値は次のようになり、Marketo に挿入された日付が6時間前のタイムゾーンからのものであるとします。 UTC 時間 (山夏時間) より:

2012-02-28T14:00:00-06:00