Mailchimp 커넥터

Mailchimp 계정을 Tajo를 통해 Brevo에 연결하여 원활한 오디언스 마이그레이션, 캠페인 데이터 동기화, 두 플랫폼 간의 통합 마케팅 자동화를 실현하십시오.

개요

기능

• 오디언스 동기화 - Mailchimp 오디언스를 Brevo 연락처 목록과 마이그레이션 및 동기화
• 캠페인 데이터 - 통합 보고를 위한 캠페인 성능 데이터 동기화
• 자동화 마이그레이션 - Mailchimp 자동화를 Brevo 워크플로에 매핑
• 참여 지표 - 오픈, 클릭, 반송 데이터를 Brevo 속성에 동기화
• 세그먼트 매핑 - Mailchimp 세그먼트를 Brevo 목록 또는 세그먼트로 복제
• 이커머스 데이터 - Mailchimp 이커머스에서 스토어, 제품, 주문 데이터 동기화
• 태그 동기화 - Mailchimp 태그를 Brevo 연락처 속성 또는 목록에 매핑
• 템플릿 마이그레이션 - Brevo 캠페인에서 사용할 Mailchimp 템플릿 내보내기

사전 요구 사항

시작하기 전에 다음이 준비되어 있는지 확인하십시오.

1. Mailchimp 계정 (Free, Essentials, Standard 또는 Premium)
2. Mailchimp API 키 또는 OAuth 앱
3. API 접근이 가능한 Brevo 계정
4. Tajo 계정

인증

API 키 인증

Mailchimp Account > Extras > API Keys에서 API 키를 생성하십시오.

curl https://{dc}.api.mailchimp.com/3.0/ping \
  --user "anystring:{api_key}" \
  -H "Content-Type: application/json"

{dc} 데이터 센터 접두사는 API 키의 마지막 부분입니다 (예: us21).

OAuth 2.0

다중 계정 통합의 경우:

# 인증 URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

# 토큰 교환
curl -X POST https://login.mailchimp.com/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "redirect_uri={redirect_uri}" \
  -d "code={auth_code}"

구성

기본 설정

connectors:
  mailchimp:
    enabled: true
    api_key: "${MAILCHIMP_API_KEY}"
    data_center: "us21"

    # 데이터 동기화 옵션
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # 오디언스를 Brevo 목록에 매핑
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

필드 매핑

Mailchimp 병합 필드를 Brevo 연락처 속성에 매핑합니다.

맞춤 병합 필드 매핑

field_mapping:
  # 표준 필드
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # 참여 지표
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # 이커머스 필드
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # 맞춤 병합 필드
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

API 엔드포인트

오디언스 (목록)

캠페인

자동화

이커머스

이벤트

캠페인 이벤트

구독자 이벤트

이커머스 이벤트

코드 예제

커넥터 초기화

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Mailchimp 연결
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});

오디언스를 Brevo로 마이그레이션

// Mailchimp에서 Brevo로의 전체 오디언스 마이그레이션
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// 마이그레이션 상태 확인
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }

캠페인 참여 데이터 동기화

// 캠페인 성능을 Brevo 속성에 동기화
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});

속도 제한

Mailchimp Marketing API 속도 제한:

문제 해결

일반적인 문제

디버그 모드

자세한 로깅 활성화:

connectors:
  mailchimp:
    debug: true
    log_level: verbose
    log_api_calls: true

연결 테스트

tajo connectors test mailchimp
# ✓ API 연결 성공
# ✓ 오디언스 읽기 가능
# ✓ 캠페인 읽기 가능
# ✓ 이커머스 데이터 접근 가능
# ✓ 웹훅 구성됨

모범 사례

1. 배치 작업 사용 - 대량 업데이트에 배치 구독/구독 취소 사용
2. 구독자 상태 보존 - 마이그레이션 중 구독 동의 존중
3. 먼저 병합 필드 매핑 - 동기화 전에 해당하는 Brevo 속성 생성
4. 참여 데이터 동기화 - 과거 세그먼테이션을 위한 오픈/클릭률 가져오기
5. 규정 준수 상태 처리 - GDPR 및 영구 삭제 상태 준수
6. 증분 동기화 사용 - API 사용을 줄이기 위해 마지막 동기화 이후 변경 사항만 동기화

보안

• API 키 인증 - HTTP Basic Auth 비밀번호로 전달되는 시크릿 키
• OAuth 2.0 - 다중 계정 접근을 위한 토큰 기반 인증
• TLS 암호화 - HTTPS를 통해 암호화된 모든 API 통신
• 웹훅 확인 - 공유 시크릿으로 웹훅 소스 검증
• 데이터 센터 격리 - 지역별 데이터 센터에 저장된 데이터

관련 리소스

• Mailchimp Marketing API 레퍼런스
• Mailchimp API 가이드
• Brevo 커넥터
• ActiveCampaign 커넥터
• 고객 동기화 스킬