Marketo Input Tool Icon

Marketo入力ツール

Version:
Current
Last modified: May 02, 2020

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レコードを取得できます:

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

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

レコードタイプ オプションタイプ リスト アクティビティタイプ(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 の日時値は次のようになりますが、Marketo に挿入された日付は UTC 時刻 (山の夏時間) より 6 時間早いタイムゾーンからのものです。

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

Marketo からのデータの読み取り

Alteryx Artisansがこれらの日付時刻値で動作するのを容易にするために、AlteryxはMarketoから読み込んだ日付時刻値をマシンのローカル日時値に変換します。これにより、Artisansは現地時間で日付時刻の値を扱うことができます。たとえば、上の日付時刻値は、UTC時間よりも6時間早いと仮定して、Alteryxのワークフローまたはアプリケーションでは次のようになります。

2012/02/28 14:00:00

または、あなたがUTCより4時間だけ早い場合は、次のように返されます。

2012-02-28 16:00:00

Marketo への書き込み日

日付時刻値が挿入操作または更新操作のいずれかを使用してMarketoに書き戻されると、Alteryxは値をMarketoが予期する形式に戻します。これは、ローカルマシンのUTCオフセットを計算し、それを日付時刻値の末尾に追加することによって行われます。Alteryxは、上記の例に示すように、日付時刻値の日付と時刻の間に 'T' を入れます。

上記の例を使用して、次のように、日付時刻値が-6:00のタイムゾーンから書き込まれた場合:

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

その後、UTCオフセットが-4:00時間のコンピュータからMarketo(未修正)に書き戻されると、Marketoに次のように書き戻されます。

2012-02-28T16:00:00-04:00

両方の時間は同一であり、時刻の同じ瞬間を表します。

Was This Helpful?

Running into problems or issues with your Alteryx product? Visit the Alteryx Community or contact support.