ドキュメントMarketo EngageMarketo Engage チュートリアル

REST API とトークンを使用してMarketo Engageでスマートキャンペーンをトリガーする方法

2025年8月7日
  • トピック：

作成対象：

  • 経験者
  • 管理者
  • 開発者

このチュートリアルでは、REST API を使用してMarketo Engageでスマートキャンペーンをトリガーし、マイトークンを使用してメールをパーソナライズする方法について説明します。 このユースケースは、ウェビナーのリマインダー、オンボーディング手順、購入後のフォローアップなど、お客様がトリガーする通知に最適です。

ユースケース

外部プラットフォーム（カスタムアプリ、Pendo、Eventbrite など）を通じてウェビナーに登録したユーザー。 自動的に実行する操作：

  • Marketo Engageからのリマインダーメールをトリガー

  • 次の機能を使用してパーソナライズします。

    • 人物の名
    • ウェビナーのタイトル
    • 一意の結合リンク

これは、REST API とマイトークンを使用して実行できます。

手順 1：スマートキャンペーンの作成

  1. マーケティングアクティビティ に移動し、 プログラムフォルダーの下に という新しいスマートキャンペーン Send Webinar Reminder を作成します。

  2. 「スマートリスト」タブで トリガーを追加し、API を使用してキャンペーンを呼び出せるようにします。

    • キャンペーンをリクエスト済み をトリガーとして選択します
    • 「Source」を Web Service API に設定します

スマートリストトリガーの設定

手順 2：メールコンテンツの定義

ユーザーと マイトークンの両方を参照する メールアセットを作成または編集します。

NOTE
以下に示すように、トークンをメールコンテンツに直接挿入します。
Hi {{lead.First Name:default=Customer}}

You're registered for **{{my.WebinarTitle}}**.

Join here: {{my.JoinLink}}

トークンを使用して画像 URL （{{my.WebinarImage}} など）を動的に挿入する場合は、トークンをHTML画像タグに含める必要があります。

<img src="{{my.WebinarImage}}" alt="Webinar banner" />
IMPORTANT
トークンが有効な image タグ内に配置されていない場合、Marketo Enagage は画像をレンダリング しません。

トークンの使用状況を表示するメールエディター

手順 3：プログラムへのトークンの追加

API を使用して値を動的に渡すには、トークンが既にMarketo Engageに存在している必要があります。 これらは、プログラムの マイトークン タブで作成する必要があります。

  1. 親プログラムの マイトークン タブに移動します。

  2. 各動的値の右側のパネルから テキストトークン をドラッグします。

  • {{my.WebinarTitle}} - テキストトークン
  • {{my.JoinLink}} - テキストトークン
  • {{my.WebinarImage}} - テキストトークン（src タグの <img> として使用）

Campaign の「マイトークン」タブ

手順 4：キャンペーンの選定ルールの設定とキャンペーンのアクティブ化

  1. 選定ルールを設定して、人物がスマートキャンペーンを実行できる頻度を制御します。

  2. 設定が完了したら、「アクティブ化」をクリックして、スマートキャンペーンが API トリガーのリクエストを受け取るようにします。

スマートキャンペーンの選定ルール

手順 5:REST API を使用したキャンペーンのトリガー

キャンペーン ID の検索

API を使用してスマートキャンペーンをトリガーするには、キャンペーン ID が必要です。

  1. トリガーにするスマートキャンペーンを見つけて選択します。

  2. ブラウザーで URL を確認します。 https://app-XXX.marketo.com/#/classic/SC1234A1ZN38 のようになります。

  3. SC の後の 4 桁はキャンペーン ID です。上記の例では、スマートキャンペーン ID は「1234」です

次のエンドポイントを使用します。

POST /rest/v1/campaigns/{campaignId}/trigger.json

例:

POST /rest/v1/campaigns/1234/trigger.json

リクエスト本文の例 

{
  "input": {
    "leads": [
      {
        "id": 1002200
      }
    ],
    "tokens": [
      {
        "name": "{{my.WebinarTitle}}",
        "value": "Scaling Customer Engagement in 2025"
      },
      {
        "name": "{{my.JoinLink}}",
        "value": "https://webinars.company.com/join/abc123"
      },
      {
        "name": "{{my.WebinarImage}}",
        "value": "https://experienceleague.adobe.com/ja/docs/marketo-learn/tutorials/events/media_1c6f338a518ada11550084c8ab3a6bbf554ff6eac.jpeg"
      }
    ]
  }
}
IMPORTANT
上記の本文例の 1002200 を、Marketo Engage インスタンスの正しいユーザー ID に置き換えます。

認証

すべてのMarketo REST API リクエストには OAuth 2.0 アクセストークンが必要です。

アクセストークンを取得するには、次のエンドポイントを使用します。

GET /identity/oauth/token?grant_type=client_credentials&client_id=XXX&client_secret=YYY

アクセストークンを受け取ったら、すべての API リクエストで クエリパラメーター として含めます。

Authorization: Bearer YOUR_ACCESS_TOKEN

ベストプラクティス

  • テストおよび QA 用のトークンへのフォールバック/デフォルト値の追加
  • 人物フィールドには {{lead.token}} を使用し、キャンペーンスコープの動的な値には {{my.token}} を使用します
  • Marketo Engageは、1 回のリクエストで最大 100 人をサポートします
  • 個人がスマート・リストの条件を満たす必要があります。満たさない場合は、警告なしにスキップされます

概要

このアプローチを使用すると、API を介して外部プラットフォームからトリガーされるスマートキャンペーンを使用して、通信をパーソナライズできます。 これは、ウェビナーの登録確認、オンボーディングメール、トランザクション通知などのシナリオで、すべてマイトークンを使用してリアルタイムデータを挿入する場合に役立ちます。

recommendation-more-help
65ee5e5e-b058-48c8-aa13-bacc3d5848ce