설명서Marketo EngageMarketo Engage 튜토리얼

REST API 및 토큰을 사용하여 Marketo Engage에서 스마트 캠페인을 트리거하는 방법

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 경험
  • 관리자
  • 개발자

이 튜토리얼에서는 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
토큰이 올바른 이미지 태그 내에 없으면 Marketo Enagage 은(는) 이미지를 렌더링하지 않습니다.

토큰 사용량을 표시하는 전자 메일 편집기

3단계: 프로그램에 토큰 추가

API를 통해 값을 동적으로 전달하려면 토큰이 Marketo Engage에 이미 존재해야 합니다. 프로그램의 내 토큰 탭에서 만들어야 합니다.

  1. 상위 프로그램의 내 토큰 탭으로 이동합니다.

  2. 오른쪽 패널에서 각 동적 값에 대해 텍스트 토큰 ​을(를) 드래그합니다.

  • {{my.WebinarTitle}} - 텍스트 토큰
  • {{my.JoinLink}} - 텍스트 토큰
  • {{my.WebinarImage}} - 텍스트 토큰(<img> 태그에서 src(으)로 사용됨)

Campaign의 내 토큰 탭

4단계: 캠페인 자격 규칙 설정 및 캠페인 활성화

  1. 자격 규칙을 구성하여 Smart Campaign을 통해 실행할 수 있는 빈도를 제어합니다.

  2. 구성이 완료되면 활성화 ​를 클릭하여 Smart Campaign이 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/ko/docs/marketo-learn/tutorials/events/media_1c6f338a518ada11550084c8ab3a6bbf554ff6eac.jpeg"
      }
    ]
  }
}
IMPORTANT
위의 본문 예제의 1002200을(를) Marketo Engage 인스턴스의 올바른 개인 ID로 바꾸십시오.

Authorization

모든 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은 요청당 최대 100명의 사용자를 지원합니다
  • 사람은 스마트 목록 기준을 충족해야 합니다. 그렇지 않으면 자동으로 건너뜁니다.

요약

이 접근 방식을 사용하면 API를 통해 외부 플랫폼에서 트리거되는 스마트 캠페인을 사용하여 커뮤니케이션을 개인화할 수 있습니다. 이 기능은 내 토큰을 사용하여 실시간 데이터를 주입하는 동안 웨비나 등록 확인, 온보딩 이메일 및 트랜잭션 알림과 같은 시나리오에 유용합니다.

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