- 인쇄
- PDF
전송원 - Adobe Marketo Engage
- 인쇄
- PDF
개요
Adobe Marketo Engage의 데이터 전송 설정 도움말 페이지입니다.
제약조건
- 업데이트 날짜에 필터를 사용하려면 Marketo 지원팀에 API 기능 활성화 신청을 해야 합니다.
고객사에서 Bulk Lead Extract API의 updatedAt를 이용한 필터 기능 활성화를 신청해 주시기 바랍니다.
설정 항목
STEP1 기본 설정
공통 부분
품목명 | 필수 | 기본값 | 내용 |
---|---|---|---|
Adobe Marketo Engage 연결 정보 | 예 | ----------------------------------------------------------------------------------------------. | ----------------------------------------------------------------------------------------------. |
타겟 | 예 | ----------------------------------------------------------------------------------------------. | 수집할 데이터의 종류를 선택하세요. 얻을 수 있는 데이터는 다음과 같습니다. 리드 활동 캠페인 프로그램 프로그램 멤버 정적 리스트별 리드 커스텀 오브젝트 리스트 활동 유형 폴더 |
타깃이 리드일 때
품목명 | 필수 | 기본값 | 내용 |
---|---|---|---|
날짜 및 시간 컬럼 | No | createdAt 사용 | 취득 기간에서 지정한 기간에 생성한 데이터를 취득(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이며, 종료값을 지정하지 않으면 시작값보다 큰 값을 가진 데이터를 얻을 수 있습니다. 단, 데이터 수집은 한 번에 300개의 값으로 필터링하여 수집할 데이터가 없으면 데이터 수집을 종료합니다. |
타겟이 폴더일 때
품목명 | 필수 | 기본값 | 내용 |
---|---|---|---|
루트 폴더 ID | No | ----------------------------------------------------------------------------------------------. | 데이터를 가져올 때 기점이 되는 루트 폴더의 ID를 지정해 주세요. 입력하지 않은 경우, 워크스페이스 이름의 폴더가 루트 폴더가 됩니다. |
루트 폴더 유형 | 예 | 폴더 | 데이터를 가져올 때 출발점이 되는 루트 폴더의 종류를 선택해 주세요. 기본값은 폴더입니다. |
데이터 수집 최대 깊이 | 예 | 2 | 검색하고자 하는 데이터의 최대 폴더 계층을 지정해 주세요. 기본값은 2입니다. |
워크스페이스 | No | ----------------------------------------------------------------------------------------------. | 가져오고자 하는 데이터의 워크스페이스를 지정해 주세요. 미입력 시 모든 워크스페이스 하위 폴더가 대상입니다. |
얻을 수 있는 데이터에 대해
리드
대상을 리드로 설정했을 때, 조회할 데이터 컬럼은 GET /rest/v1/leads/describe.json에서 조회되는 모든 컬럼이 됩니다.
액티비티
타겟을 활동으로 설정했을 때, 수집하는 데이터 컬럼은 아래 표의 데이터 컬럼이 됩니다.
칼럼명 | 내용 |
---|---|
marketoGUID | Marketo의 GUID |
leadId | 리드 ID |
activityDate | 활동이 진행된 날 |
activityTypeId | 활동 유형 ID |
campaignId | 캠페인 ID |
primaryAttributeValueId | 마케토폼 ID 등 |
primaryAttributeValue | 마케토폼 이름 등 |
attributes | 액티비티 상세 정보 |
캠페인
타겟을 캠페인으로 설정했을 때, 수집하는 데이터 컬럼은 아래 표의 데이터 컬럼과 같습니다.
칼럼명 | 내용 |
---|---|
id | 캠페인 ID |
이름 | 캠페인명 |
설명 | 설명문 |
유형 | 캠페인 유형 trigger 또는 batch 표시하기 |
workspaceName | 워크스페이스 이름 |
createdAt | 작성일 |
updatedAt | 업데이트 날짜 |
active | 캠페인이 활성 또는 비활성 상태인지 표시하기 |
프로그램
타겟을 프로그램으로 설정했을 때, 수집하는 데이터 컬럼은 아래 표의 데이터 컬럼이 됩니다.
칼럼명 | 내용 |
---|---|
id | 프로그램 ID |
이름 | 프로그램명 |
sfdcId | SFDC ID |
sfdcName | SFDC명 |
설명 | 설명문 |
createdAt | 작성일 |
updatedAt | 업데이트 날짜 |
startDate | 시작일 |
endDate | 종료일 |
url | URL |
유형 | 유형명 |
채널 | 채널명 |
폴더 | 폴더에 대한 정보 |
상태 | 상태 |
비용 | 비용 |
tags | 태그 |
작업공간 | 워크스페이스 |
프로그램 회원
대상을 프로그램 멤버로 설정했을 때, 가져오는 데이터 컬럼은 GET /rest/v1/programs/members/describe.json에서 가져오는 모든 컬럼이 됩니다.
정적 목록별 리드
대상을 리드로 설정하면, GET /rest/v1/leads/describe.json에서 가져오는 데이터 컬럼은 GET /rest/v1/leads/describe.json에서 가져오는 모든 컬럼에 더해 정적 리스트 ID가 추가된다.
커스텀 오브젝트
타겟을 커스텀 오브젝트로 설정하면, 가져오는 데이터 컬럼은 필드에서 지정한 데이터 컬럼이 됩니다.
목록
타겟을 목록으로 설정했을 때, 수집하는 데이터 컬럼은 아래 표의 데이터 컬럼이 됩니다.
| 칼럼명 | 내용 | 칼럼
| --- | --- --- |
| id | 목록 ID
| name | 목록명
| description | 설명문
| programName | 목록이 들어있는 프로그램 이름 | 프로그램 이름
| workspaceName | 작업공간 이름 | 작업공간 이름
| createdAt | 생성일 | 생성일
| updatedAt | 업데이트 날짜
활동 유형
타겟을 활동 유형으로 설정했을 때 수집하는 데이터 컬럼은 아래 표의 데이터 컬럼이 됩니다.
| 칼럼명 | 내용 | 칼럼
| --- | --- --- |
| id | 활동 유형 ID | 활동 유형 ID
| name | 활동 유형명
| description | 설명문
| primaryAttribute | 활동의 primaryAttribute의 내용 | 활동의 primaryAttribute의 내용
| attributes | 활동의 attributes 내용 | 활동의 attributes 내용
| apiName | 생성일
폴더
대상을 폴더로 설정했을 때, 가져오는 데이터 컬럼은 아래 표의 데이터 컬럼이 됩니다.
| 칼럼명 | 내용 | 칼럼
| --- | --- --- |
| id | 폴더 ID
| name | 폴더 이름
| description | 설명문
| createdAt | 생성일 | 생성일
| updatedAt | 업데이트 날짜
| url | URL
| folderId | 폴더에 대한 정보
| folderType | 폴더 유형
| parent | 부모 폴더에 대한 정보 | 부모 폴더에 대한 정보
| path | 경로
| isArchive | 아카이브 폴더 여부 | isArchive
| isSystem | 시스템 폴더 여부 | 시스템 폴더 여부
| accessZoneId | 액세스 영역 ID | 액세스 영역 ID
| workspace | 작업공간