콘텐츠로 건너뛰기
주의:: 이 문서는 사용자의 편의를 위해 제공됩니다. 이 문서는 번역 소프트웨어를 사용하여 자동으로 번역되었으며 교정을 거치지 않았을 수 있습니다. 이 문서의 영어 버전이 가장 최신의 정보를 확인할 수 있는 공식 버전으로 간주해야 합니다. 여기에서 액세스할 수 있습니다..

프로그래밍 가능한 이메일 만들기

마지막 업데이트 날짜: 2025년 12월 4일

명시된 경우를 제외하고 다음 구독 중 어느 것에서나 사용할 수 있습니다.

프로그래밍 가능한 이메일을 사용하면 고급 HubL 구문을 사용하여 이메일 콘텐츠를 개인화할 수 있습니다. HubSpot의 개발자 문서에서 모듈에서 CRM 데이터로 작업하는 방법에 대해 자세히 알아보세요.

제한 사항 및 고려 사항 이해

  • 프로그래밍 가능한 이메일에 사용할 수 있는 데이터는 HubSpot 가입에 따라 다릅니다:
    • Marketing Hub Professional 계정이 있는 경우 연락처, 회사, 제품 등의 표준 CRM 개체에서 데이터를 렌더링할 수 있습니다.
    • Marketing Hub Enterprise를 구독하는 경우 프로그래밍 가능한 이메일에 HubDB 테이블사용자 지정 개체와 같은 구조화된 데이터 소스를 포함할 수 있습니다.
  • 프로그래밍 가능한 이메일에 추가할 수 있는 CRM 기능의 수는 수신자 수에 따라 다릅니다:
    • 5개의 CRM 기능이 포함된 이메일은 최대 100,000명의 수신자에게 보낼 수 있습니다. 프로그래밍 가능한 이메일에는 5개 이상의 CRM 기능을 추가할 수 없습니다.
    • 4개의 CRM 기능이 포함된 이메일은 최대 125,000명의 수신자에게 보낼 수 있습니다.
    • CRM 기능이 3개 포함된 이메일은 최대 165,000명의 수신자에게 보낼 수 있습니다.
    • CRM 기능이 2개 포함된 이메일은 최대 250,000명의 수신자에게 보낼 수 있습니다.
    • CRM 기능이 1개 포함된 이메일은 최대 500,000명의 수신자에게 보낼 수 있습니다.
  • 프로그래밍 가능한 이메일은 이전에 프로그래밍 가능한 이메일이 전송된 후 최소 1시간 후에 전송해야 합니다.

모듈 또는 템플릿에 프로그래밍 가능한 이메일 추가하기

디자인 관리자에서 프로그래밍 가능한 이메일에 사용할 수 있는 사용자 지정 모듈 및 사용자 지정 코딩 템플릿을 만들 수 있습니다.

프로그래밍 가능한 이메일을 지원하는 사용자 지정 모듈을 만든 후에는 드래그 앤 드롭 편집기에서 만든 이메일에 해당 모듈을 추가할 수 있습니다.

프로그래밍 가능한 이메일 모듈 만들기

  1. HubSpot 계정에서 콘텐츠 > 디자인 관리자로 이동합니다.
  2. 왼쪽 열에서 파일 메뉴를 클릭하고 새 파일을 선택합니다.
  3. 대화 상자에서 드롭다운 메뉴를 클릭하고 모듈을 선택한 후 다음을 클릭합니다.
  4. 이 모듈을 사용하려는 위치 섹션에서 이메일 확인란을 선택합니다.
  5. 파일 이름 필드에 모듈 이름을 입력합니다.
  6. 만들기를 클릭합니다.
  7. 오른쪽 열에서 프로그래밍 가능한 이메일에 모듈 사용 스위치를 켭니다.

Screenshot of the right column of the design manager. The "Use module for programmable email" switch is highlighted.

  1. 대화 상자에서 전송 제한을 검토한 다음 동의하고 켜기를 클릭합니다.

프로그래밍 가능한 이메일 코드 템플릿 만들기

  1. HubSpot 계정에서 콘텐츠 > 디자인 관리자로 이동합니다.
  2. 왼쪽 열에서 파일 메뉴를 클릭하고 새 파일을 선택합니다.
  3. 대화 상자에서 드롭다운 메뉴를 클릭하고 HTML + HubL을 선택한 후 다음을 클릭합니다.
  4. 템플릿 유형 드롭다운 메뉴를 클릭하고 이메일을 선택합니다.
  5. 파일 이름 필드에 템플릿 이름을 입력합니다.
  6. 만들기를 클릭합니다.
  7. 코딩된 템플릿의 상단에서 <!----> 사이의 섹션에 다음 코드를 추가합니다: isEnabledForEmailV3Rendering: true.

A screenshot of the top section of a custom coded email template. The code for using the template for programmable emails is indicated.

  1. 템플릿 편집을 완료한 다음 오른쪽 상단의 변경사항 게시를 클릭합니다.

프로그래밍 가능한 이메일 최적화하기

프로그래밍 가능한 이메일을 보낼 때 전송 지연을 방지하려면 다음 모범 사례를 따르는 것이 좋습니다:

  • 가능하면 일반 이메일 사용: 수신자가 정의된 정해진 시간에 이메일을 보낼 때는 더 나은 성능을 위해 자동 이메일이 아닌 일반 이메일을 보내는 것이 좋습니다.
  • 너무 많은 행을 가져오지 않도록 쿼리 추가: hubdb_table_rows 을 설정할 때 가져오려는 행의 범위를 좁히기 위해 추가 쿼리를 추가합니다.
    • : years_at_company 이 3보다 큰 모든 연락처에 대해 행을 필터링하고 반환되는 결과를 15개로 제한할 수 있습니다.
    • hubdb_table_rows(1546258, "years_at_company__gt=3&limit=15")
  • 개인화 토큰으로 필터링하지 않기: 쿼리 매개변수 내에서 필터링하거나 가져온 후 필터링하는 등 개인화 토큰을 사용하여 데이터 행을 필터링하는 것은 피하는 것이 좋습니다.
    • 개인화 토큰에 의한 필터링을 피할 수 없는 경우에는 최소 행 수를 우선적으로 가져오고 데이터를 검색한 후 if 구문을 사용하여 조건부 필터링을 적용하는 것이 좋습니다.
    • : 가져오는 행을 20개로 제한하고 row.location = contact.location 에 대해 가져온 후 필터링할 수 있습니다.

    • {% if row.location == contact.location %}
      Your row data is {{ row }}
      {% endif %}
      {% endfor %} {% end raw }
  • CRM 함수의 호출 횟수 제한: 이메일에 포함된 CRM 함수(예: crm_objectcrm_associations)의 수는 수신자 수에 따라 달라집니다. 이러한 함수의 호출을 제한하여 지연이나 취소를 방지하세요.
    • 예: CRM 함수의 호출 횟수에 명확한 제한을 설정하세요.
    • {% set ids = [1,2,3] %}
      {% set people = crm_objects("contact", "hs_object_id__in="~ids|join(','), "firstname,lastname", false) %}
이 문서가 도움이 되었나요?
이 양식은 문서 피드백에만 사용됩니다. HubSpot으로 도움을 받는 방법 알아보기.