動的コンテンツ

リードセグメンテーションを利用して、次のようなアセットタイプのコンテンツを動的に提供できます。

  • メール
  • ランディングページ
  • スニペット

概要

動的コンテンツはセクションレベルで動作します。 各セクションには、選択したセグメント内のセグメントのバリエーションを表示できます。

リードがアセットを閲覧すると、Marketoにはリードのセグメントのバリエーションが表示されます。 リードがセグメントに適格でない場合、Marketoにはデフォルトのコンテンツが表示されます。

例

この例では、地域(米国)セグメントを使用して、南西セグメントのリードにイベントプロモーションを表示します。 このセグメントには、カリフォルニア州、ネバダ州、ユタ州、コロラド州、アリゾナ州、ニューメキシコ州のリードが含まれます。

電子メールコンテンツセクションを更新 エンドポイントを使用して、ID Q1-promotion-bannerの編集可能セクションをDynamicContent セクションに変更します。 value パラメーターは、セグメント IDを指定します。

電子メールやランディングページは、このパターンに従っています。 スニペットでは、スニペット API ドキュメントに記載されている様々なパターンを使用します。

次の例では、セクションを動的コンテンツセクションに設定し、セグメント 1001 でセグメント化しています。

POST /rest/asset/v1/email/{id}/content/Q1-promotion-banner.json
type=DynamicContent&value=1001
{
  "success": true,
  "errors": [],
  "requestId": "891b#1729b34b9a5",
  "warnings": [],
  "result": [
    {
      "id": 1909
    }
  ]
}

​ メール動的コンテンツの更新 エンドポイントを呼び出して、特定のセクションのセグメントにコンテンツを追加します。

次のリクエストでは、南西セグメントのリードのデフォルトコンテンツではなく、特別なバナーが表示されます。 さらにバリエーションを作成するには、各セグメントとセクションのエンドポイントを呼び出します。

POST /rest/asset/v1/email/{id}/dynamicContent/{dynamicContentId}.json
segment=Southwest&type=HTML&value=<img src='//www.example.com/SuperSpecialBannerForAmericanSouthwestLeads.jpg'/>
{
  "success": true,
  "errors": [],
  "requestId": "891b#1729b34b9a5",
  "warnings": [],
  "result": [
    {
      "id": 1637
    }
  ]
}

セグメント化

セグメンテーションとは、Marketoがリードデータベースに対して上下を評価する、ユーザー定義のルールセットのリストです。 リードは、各セグメント内の1つのセグメントにのみ属することができます。 リードは、最初に選定されたセグメントに属します。

リードが別のセグメントに適格でない場合は、デフォルトセグメントに結合され、セグメントのデフォルトコンテンツを受け取ります。

リスト

リストエンドポイントを使用して、使用可能なセグメントを取得します。

GET /rest/asset/v1/segmentation.json
{
  "success": true,
  "warnings": [ ],
  "errors": [ ],
  "requestId": "78eb#14e9de95868",
  "result": [
    {
      "id": 1001,
      "name": "My Industry Segmentation",
      "description": "",
      "createdAt": "2015-04-06T18:23:32Z+0000",
      "updatedAt": "2015-04-06T18:37:10Z+0000",
      "url": "https://app-abm.marketo.com/#SG1001A1",
      "folder": {
        "type": "Program",
        "value": 396,
        "folderName": null
      },
      "status": "approved",
      "workspace": "Default"
    },
    {
      "id": 1002,
      "name": "My Country Segmentation",
      "description": "",
      "createdAt": "2015-04-06T18:28:23Z+0000",
      "updatedAt": "2015-04-06T18:37:18Z+0000",
      "url": "https://app-abm.marketo.com/#SG1002A1",
      "folder": {
        "type": "Program",
        "value": 396,
        "folderName": null
      },
      "status": "approved",
      "workspace": "Default"
    }
  ]
}

セグメント エンドポイントを使用して、親セグメント内のセグメントを取得します。

GET /rest/asset/v1/segmentation/1001/segments.json
{
  "success": true,
  "warnings": [ ],
  "errors": [ ],
  "requestId": "2031#14e9df08796",
  "result": [
    {
      "id": 1001,
      "name": "Manufacturing",
      "description": null,
      "createdAt": "2015-04-06T18:23:32Z+0000",
      "updatedAt": "2015-04-06T18:37:09Z+0000",
      "status": "approved",
      "segmentationId": 1001
    },
    {
      "id": 1002,
      "name": "Healthcare",
      "description": null,
      "createdAt": "2015-04-06T18:23:32Z+0000",
      "updatedAt": "2015-04-06T18:37:09Z+0000",
      "url": "https://app-abm.marketo.com/#SL769688A1",
      "status": "approved",
      "segmentationId": 1001
    },
    {
      "id": 1003,
      "name": "Financial",
      "description": null,
      "createdAt": "2015-04-06T18:23:32Z+0000",
      "updatedAt": "2015-04-06T18:37:09Z+0000",
      "url": "https://app-abm.marketo.com/#SL769690A1",
      "status": "approved",
      "segmentationId": 1001
    },
    {
      "id": 1004,
      "name": "Technology",
      "description": null,
      "createdAt": "2015-04-06T18:23:32Z+0000",
      "updatedAt": "2015-04-06T18:37:09Z+0000",
      "url": "https://app-abm.marketo.com/#SL769692A1",
      "status": "approved",
      "segmentationId": 1001
    },
    {
      "id": 1005,
      "name": "Default",
      "description": null,
      "createdAt": "2015-04-06T18:23:32Z+0000",
      "updatedAt": "2015-04-06T18:37:09Z+0000",
      "url": "https://app-abm.marketo.com/#SL769694A1",
      "status": "approved",
      "segmentationId": 1001
    }
  ]
}
recommendation-more-help
marketo-developer-help