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 時間 (山夏時間) より:
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 に戻る:
両方の時間が同じであり、 時間の同じ瞬間。