目次 x
    転送元 - Adobe Marketo Engage
    • 15 Nov 2023
    • 印刷
    • ダーク
      ライト
    • PDF
    目次

    転送元 - Adobe Marketo Engage

    • 更新日 15 Nov 2023
    • 印刷
    • ダーク
      ライト
    • PDF
    Article Summary

    概要

    Adobe Marketo Engageのデータを転送する設定のヘルプページです。

    制約

    • 更新日でフィルタを使うためには、Marketoサポート窓口へのAPI機能有効化申請が必要となります。
      お客様にて、Bulk Lead Extract APIでのupdatedAtを利用したフィルタ機能の有効化の申請をお願いいたします。

    設定項目

    STEP1 基本設定

    共通部分

    項目名必須デフォルト値内容
    Adobe Marketo Engage接続情報Yes--
    ターゲットYes-取得するデータの種類を選んでください。
    取得できるデータは以下です。
    ・リード
    ・アクティビティ
    ・キャンペーン
    ・プログラム
    ・プログラムメンバー
    ・スタティックリスト別リード
    ・カスタムオブジェクト
    ・リスト
    ・アクティビティタイプ
    ・フォルダー

    ターゲットがリードの時

    項目名必須デフォルト値内容
    日時カラムNocreatedAtを使用取得期間で指定した期間に作成したデータを取得する（createdAt）か、
    更新したデータを取得する（updatedAt）かを選ぶことができます。
    取得期間No-絞り込み範囲の開始日、終了日を入力してください。
    YYYYY-MM-DD形式で入力してください。（例: 2020-11-19）

    ターゲットがアクティビティの時

    項目名必須デフォルト値内容
    取得期間No-絞り込み範囲の開始日、終了日を入力してください。
    YYYY-MM-DD形式で入力してください。（例 : 2020-11-19）

    ターゲットがプログラムメンバーの時

    項目名必須デフォルト値内容
    プログラムIDフィルタNo-取得したいデータのプログラムIDをカンマ区切りで入力してください。未入力の場合、全てのプログラム配下のメンバーが対象になります。（例 : 111,222,333）

    ターゲットがスタティックリスト別リードの時

    項目名必須デフォルト値内容
    リストIDフィルタNo-取得したいデータのリストIDをカンマ区切りで入力してください。未入力の場合、全てのリスト配下のリードが対象になります。（例 : 111,222,333）

    ターゲットがカスタムオブジェクトの時

    項目名必須デフォルト値内容
    API名No-取得したいカスタムオブジェクトのAPI名を指定してください。
    通常、カスタムオブジェクト名に「_c」が付いた形式になっています。
    API名一覧を読み込むのボタンを押すことで指定できるAPI名の一覧を表示できます。
    フィールドNo-取得したいカスタムオブジェクトのフィールド名を指定してください。
    フィールド名の候補を読み込むのボタンを押すことで指定できるフィールド名の一覧を表示できます。
    フィルタータイプNo-取得するカスタムオブジェクトの条件を指定します。
    フィルターとして扱えるのは整数型かつ検索可能なフィールドのみです。
    これに該当するカラムがない場合はデータ転送ができません。
    使用できるフィルタータイプを読み込むで使用できるフィールド一覧を表示できます。
    フィルターの範囲No-フィルタータイプで指定した値に関して、取得するデータの値の範囲を指定します。
    開始値のデフォルト値は1であり、終了値を指定しなかった場合は開始値よりも大きな値を持つデータを取得できます。
    ただし、データの取得は1度に300個の値でフィルターしており、取得するデータがなかった場合はデータ取得を終了します。

    ターゲットがフォルダーの時

    項目名必須デフォルト値内容
    ルートフォルダーIDNo-データを取得する際の起点となるルートフォルダーのIDを指定してください。未入力の場合、ワークスペース名のフォルダがルートフォルダーとなります。
    ルートフォルダータイプYesフォルダーデータを取得する際の起点となるルートフォルダーの種類を選択してください。デフォルト値はフォルダーです。
    データ取得最大深度Yes2取得したいデータの最大のフォルダー階層を指定してください。デフォルト値は2です。
    ワークスペースNo-取得したいデータのワークスペースを指定してください。未入力の場合、全てのワークスペース配下のフォルダーが対象になります。

    取得できるデータについて

    リード

    ターゲットをリードにしたとき、取得するデータのカラムは GET /rest/v1/leads/describe.json で取得される全てのカラムになります。

    アクティビティ

    ターゲットをアクティビティにしたとき、取得するデータのカラムは以下の表のものとなります。

    カラム名内容
    marketoGUIDMarketoのGUID
    leadIdリードId
    activityDateアクティビティが行われた日
    activityTypeIdアクティビティタイプID
    campaignIdキャンペーンID
    primaryAttributeValueIdマルケトフォームIDなど
    primaryAttributeValueマルケトフォーム名など
    attributesアクティビティの詳細情報

    キャンペーン

    ターゲットをキャンペーンにしたとき、取得するデータのカラムは以下の表のものとなります。

    カラム名内容
    idキャンペーンID
    nameキャンペーン名
    description説明文
    typeキャンペーンのタイプ
    triggerかbatchを表示する
    workspaceNameワークスペース名
    createdAt作成日
    updatedAt更新日
    activeキャンペーンがアクティブか非アクティブかを表示する

    プログラム

    ターゲットをプログラムにしたとき、取得するデータのカラムは以下の表のものとなります。

    カラム名内容
    idプログラムID
    nameプログラム名
    sfdcIdSFDC ID
    sfdcNameSFDC名
    description説明文
    createdAt作成日
    updatedAt更新日
    startDate開始日
    endDate終了日
    urlURL
    typeタイプ名
    channelチャンネル名
    folderフォルダーについての情報
    statusステータス
    costsコスト
    tagsタグ
    workspaceワークスペース

    プログラムメンバー

    ターゲットをプログラムメンバーにしたとき、取得するデータのカラムは GET /rest/v1/programs/members/describe.json で取得される全てのカラムになります。

    スタティックリスト別リード

    ターゲットをリードにしたとき、取得するデータのカラムは GET /rest/v1/leads/describe.json で取得される全てのカラムに加えてスタティックリストIDが付加されます。

    カスタムオブジェクト

    ターゲットをカスタムオブジェクトにしたとき、取得するデータのカラムはフィールドで指定したものになります。

    リスト

    ターゲットをリストにしたとき、取得するデータのカラムは以下の表のものとなります。

    カラム名内容
    idリストID
    nameリスト名
    description説明文
    programNameリストが入っているプログラム名
    workspaceNameワークスペース名
    createdAt作成日
    updatedAt更新日

    アクティビティタイプ

    ターゲットをアクティビティタイプにしたとき、取得するデータのカラムは以下の表のものとなります。

    カラム名内容
    idアクティビティタイプID
    nameアクティビティタイプ名
    description説明文
    primaryAttributeアクティビティのprimaryAttributeの内容
    attributesアクティビティのattributesの内容
    apiName作成日

    フォルダー

    ターゲットをフォルダーにしたとき、取得するデータのカラムは以下の表のものとなります。

    カラム名内容
    idフォルダーID
    nameフォルダー名
    description説明文
    createdAt作成日
    updatedAt更新日
    urlURL
    folderIdフォルダーについての情報
    folderTypeフォルダータイプ
    parent親フォルダーについての情報
    pathパス
    isArchiveアーカイブフォルダーかどうか
    isSystemシステムフォルダーかどうか
    accessZoneIdアクセスゾーンID
    workspaceワークスペース
    この記事は役に立ちましたか?
    What's Next