Marketo付加ツール

Marketo付加ツールは、指定した着信データストリームを使用して、Marketoインスタンスから対応するレコードを取得します。付加ツールを使用すると、Eメールアドレスやすでに作業している他のデータのリストがあり、Marketoの追加情報とそのデータを結合したい場合、またはMarketoインスタンスにすでに存在しているかどうかを確認する場合に、最も役立ちます。

ツール設定

Marketo資格情報

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

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

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

Marketo REST APIにアクセスするためのウェブサービスとユーザーの役割の設定に関する詳細な情報は、Marketo RESTドキュメントサイトにあります。

オプション

入力されたフィールド

このドロップダウンでは、ツールの入力として使用したフィールドのリストが表示されます。Marketoはこのフィールドを使用して、Marketoインスタンスのこのフィールド値を持つリードレコードを検索します。

入力されたフィールドタイプ

着信フィールドがどのタイプのレコードか（Eメール、SFDC IDなど）。

出力フィールド

Marketoデータベースから取得したいフィールド。これらのフィールドおよびツールに渡されたフィールドは、出力データストリームに返されます。

選択した出力フィールドが入力データストリームにも含まれている場合、Marketoから来る出力フィールドの末尾に「2」が付けられます。

データに関する検討事項

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

このツールは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に挿入された日付は、UTC時刻(Mountain Daylight Time)より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のタイムゾーンから書き込まれた場合：