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の日々の制限に対してカウントされません。
AlteryxでMarketoのフィールド構造を維持してから、エラーを回避するためにMarketoに返信してください。 Marketoコネクタは、フィールド名が有効である限り、Marketoに出力する前にデータを適切なデータ型に変換します。 Marketoでフィールド名が見つからない場合、出力は失敗します。
DateTimeFields
Marketoのすべての日付は、UTCオフセットで保存されます。 この形式は 正または負のオフセットが付加されたローカル時刻の。 たとえば、Marketo の datetime 値は次のようになり、Marketo に挿入された日付が6時間前のタイムゾーンからのものであるとします。 UTC 時間 (山夏時間) より: