Marketo出力ツール
Marketo 出力ツールは、Marketo REST API エンドポイントへの呼び出しを行います: リードの作成/更新。 構成で選択したアクションに基づいて、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 ドキュメントサイトを参照してください。
オプション
キーフィールド: このドロップダウンリストには、ツールの入力として使用したフィールドの一覧が表示されます。 Marketoはこのフィールドを使用して重複レコードを探索します。 フィールドを指定しない場合、デフォルトでEメールが使用されます。
項目 'id' がレコードに含まれている場合は、'id' をキーフィールドとして選択する必要があります。
出力アクションを選択します。
- 作成または更新 (既定): キーフィールドに基づいて、潜在顧客が存在しない場合は潜在顧客を作成し、潜在顧客が存在する場合は更新します。
- 重複作成: 既に存在する場合でも、別の潜在顧客を作成します。
- 更新のみ: 潜在顧客が既に存在する場合は、更新しない場合は、何もしません。
- 作成のみ: 新しい潜在顧客が存在しない場合は、それをスキップして作成します。
パーティション名: アクセスする Marketo インスタンスにパーティションが設定されている場合は、ドロップダウンリストに表示されます。 このフィールドの選択は、書き出されるインスタンスにリードのパーティションが設定されている場合に必要です。 利用可能なパーティションがない場合、‘Default’ が使用されます。
データに関する検討事項
提出されたレコードのサマリーステータスが結果ウィンドウにメッセージとしてリスト化されます。
認証の失敗などのエラーメッセージ が設定ウィンドウに表示されます。 欠落した構成選択などのエラーメッセージは、ワークフローのツール上に表示されます。
このツールは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 時間 (山夏時間) より:
Alteryx の職人が楽になるように これらの datetime 値を使用して、Alteryx は datetime 値を変換します。 Marketo からマシンローカルの datetime 値に読み取ります。 これにより、職人 を使用して、ローカル時刻の datetime 値を操作します。 たとえば、 上記の datetime 値は、Alteryx ワークフローまたはアプリではこのようになります。 また、6時間前の UTC 時間と仮定します。
または、もしあなたがわずか4時間前よりも UTC では、次のように返されます。
datetime 値が書き戻されるとき Marketo または update 操作のいずれかを使用すると、Alteryx は Marketo が期待する形式に戻る値。 これは ローカルコンピュータの UTC オフセットを計算し、それを末尾に追加する の値を指定します。 Alteryx は、日付と時刻の間に ' t ' を入れます 上記の例に示すように、datetime 値の一部です。
上記の例を使用して、datetime 値 このように、-6:00 のオフセットを持つタイムゾーンから書き込まれました:
その後、Marketo (未修正) に書き戻され、 -4:00 時間の UTC オフセットを持つコンピュータから、それが書き込まれる このような Marketo に戻る:
両方の時間が同じであり、 時間の同じ瞬間。