설명서Marketo 개발자 안내서

Marketo 통합 우수 사례

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 관리자

API 제한

  • 일일 할당량: 대부분의 구독에는 하루에 50,000개의 API 호출이 할당됩니다(매일 오전 12시(CST) 재설정됨). 계정 관리자를 통해 일일 할당량을 늘릴 수 있습니다.
  • 속도 제한: 인스턴스당 API 액세스가 20초당 100개의 호출로 제한되었습니다.
  • 동시 실행 제한:  최대 10개의 동시 API 호출.
  • 일괄 처리 크기: 리드 DB - 300개 레코드, 자산 쿼리 - 200개 레코드
  • REST API 페이로드 크기: 1MB
  • 일괄 가져오기 파일 크기: 10MB
  • SOAP 최대 일괄 처리 크기: 레코드 300개
  • 일괄 추출 작업: 2개 실행 중, 10개 대기 중(포함)

빠른 팁

  • 애플리케이션이 할당량, 요율 및 동시성 리소스를 다른 애플리케이션과 경쟁한다고 가정하고 사용 제한을 적절히 설정합니다.
  • 사용 가능하고 적절한 경우 Marketo의 대량 및 일괄 처리 방법을 사용하십시오. 필요한 경우 단일 레코드 또는 단일 결과 호출만 사용합니다.
  • 환율 또는 동시성 제한으로 인해 실패한 API 호출을 다시 시도하려면 지수 백오프를 사용하십시오.
  • 사용 사례가 이점을 얻지 못하는 경우 동시 API 호출을 수행하지 마십시오.

일괄 처리

통합 시 최상의 성능을 보장하기 위해 삽입 또는 업데이트를 수행할 때 레코드를 가능한 한 적은 수의 트랜잭션으로 그룹화해야 합니다. 제출을 위해 데이터 저장소에서 레코드를 검색할 때 레코드는 개별 변경 요청을 제출하기 전에 항상 집계되어야 합니다.

허용 가능한 지연

지연 허용 한도 또는 API 호출을 제출하기 전에 경과할 수 있는 최대 시간을 확인하면 Marketo에 대한 통합을 디자인할 때 내리는 대부분의 의사 결정이 알려집니다. Marketo은 다양한 사용 사례와 다양한 지연 클래스에 적합한 다양한 방법 및 구성 옵션을 제공합니다. 예를 들어, 평가판에 등록하는 사용자의 영업 사원에게 통지하기 위한 실시간 통합은 즉각적인 후속 조치가 필요한 경우 하나의 배치만 제출할 수 있습니다. 그러나 대부분의 경우 이를 필요로 하지 않으며 추가적인 지연을 견딜 수 있으며, 대기 및 일괄 처리 호출을 통해 보다 효율적으로 관리할 수 있습니다.

허용 가능한 지연
기본 메서드
참고 사항
낮음(<10s)
동기 API(일괄 처리 또는 일괄 처리 해제)
사용 사례에서 이를 요구하는지 확인합니다. 대용량 사용 사례에 대해 즉시 및 동기 호출을 전송하면 일일 API 할당량이 빠르게 소모되고, 잠재적으로 요율 및 동시 실행 제한을 모두 초과할 수 있습니다.
Medium(10s - 60m)
동기 API(일괄 처리)
Marketo에 대한 인바운드 데이터 통합의 경우 연령 및 크기 제한이 모두 있는 큐를 사용하는 것이 좋습니다. 두 제한에 도달하면 큐를 플러시하고 누적된 레코드로 API 요청을 제출합니다. 이는 큐의 사용 기간이 허용하는 만큼 많은 레코드를 일괄 처리하는 동시에, 필요한 케이던스로 요청이 발생하도록 하며 속도와 효율성 간의 강력한 타협입니다.
높음(>60m)
대량 가져오기/내보내기(지원되는 경우)
인바운드 데이터 통합을 위해 가능하면 Marketo Bulk API를 통해 레코드를 큐에 추가하고 제출해야 합니다.

일별 제한

Marketo의 각 API 지원 인스턴스에는 하루에 최소 10,000개의 REST API 호출이 할당되지만 일반적으로 50,000개 이상, 500MB 이상의 대량 추출 용량이 할당됩니다. Marketo 구독의 일부로 일일 추가 용량을 구매할 수 있지만, 애플리케이션 디자인은 Marketo 구독의 일반적인 제한을 고려해야 합니다.

용량을 인스턴스의 모든 API 서비스와 사용자 간에 공유하므로 우수 사례는 중복 호출을 제거하고 레코드를 가능한 한 적은 호출로 일괄 처리하는 것입니다. 레코드를 가져오는 가장 효율적인 방법은 잠재 고객/사용자 및 사용자 지정 개체에 사용할 수 있는 Marketo의 대량 가져오기 API를 사용하는 것입니다. Marketo은 리드 및 활동에 대한 대량 추출도 제공합니다.

캐싱

다음 작업의 결과는 일반적으로 드물게 변경되므로 하루 이상 클라이언트측에 캐시될 수 있습니다.

프로그램, 이메일 및 폴더와 같은 특정 에셋 유형을 캐시하는 것은 리드 또는 활동 레코드에 대한 데이터 보강과 같은 특정 사용 사례에도 적합합니다.

비율 제한

각 Marketo 인스턴스에는 20초당 100개의 호출 비율 제한이 있으며, 이는 모든 타사 API 서비스 간에 공유됩니다. 이 제한이 초과되면 API는 속도 제한이 초과되었음을 나타내는 606 오류 코드로 응답합니다. 일반적으로 서드파티 통합은 여러 API 통합 및 사용자가 비율 제한을 공평하게 사용할 수 있도록 활용도를 20초당 50개 이하로 제한해야 합니다. 특정 경우에는 이 제한을 채우는 것이 적절할 수 있지만, 일반적으로 일괄 처리를 사용하고 처리량을 이 제한보다 적게 목표로 하는 애플리케이션은 지연 시간을 늘린 적은 비용으로 운영 시 보다 응답성이 높고 일관성이 있습니다.

동시 실행 제한

각 Marketo 인스턴스에는 동시에 실행되는 REST API 호출의 공유 제한이 10개입니다. 일일 할당량 및 요금 한도와 마찬가지로 이 한도가 공유되므로 애플리케이션이 이 한도의 전용 소비자가 된다고 가정해서는 안 됩니다. Marketo은 동시 호출 수를 처리 중이며 아직 반환되지 않은 수로 계산하므로 호출이 반환되면 더 이상 동시 호출 제한에 대해 계산되지 않습니다.

대부분의 통합 사용 사례에서는 동시 호출을 수행할 필요가 없으므로 Marketo에 동시 요청을 제출하기 전에 애플리케이션이 어떤 이점을 제공하는지 고려하십시오. 동시 실행 기능을 구현하려면 초기 디자인에서 동시 실행 요청 수를 5개 이하로 제한하고 응용 프로그램에 더 많은 것이 필요하다고 결정한 후에만 이를 늘려야 합니다.

오류수

드물게 발생하는 몇 가지 경우를 제외하고 API 요청은 HTTP 상태 코드 200을 반환합니다. 비즈니스 논리 오류도 200을 반환하지만, 응답 본문에 자세한 정보가 포함되어 있습니다. 자세한 내용은 오류 코드를 참조하세요. HTTP 이유 구는 선택 사항이며 변경될 수 있으므로 평가해서는 안 됩니다.

recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59