Mailchimp コネクター

Mailchimp アカウントを Tajo 経由で Brevo に接続して、オーディエンス移行、キャンペーンデータ同期、両プラットフォームにまたがる統一されたマーケティングオートメーションをシームレスに実現します。

概要

機能

• オーディエンス同期 - Mailchimp オーディエンスを Brevo コンタクトリストに移行・同期
• キャンペーンデータ - キャンペーンパフォーマンスデータを統一レポート向けに同期
• 自動化移行 - Mailchimp 自動化を Brevo ワークフローにマッピング
• エンゲージメントメトリクス - 開封、クリック、バウンスデータを Brevo 属性に同期
• セグメントマッピング - Mailchimp セグメントを Brevo リストまたはセグメントとして複製
• eコマースデータ - Mailchimp eコマースのストア、商品、注文データを同期
• タグ同期 - 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

マルチアカウント統合向け:

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

# Token exchange
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"

    # Data sync options
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Audience to Brevo list mapping
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42

フィールドマッピング

Mailchimp のマージフィールドを Brevo コンタクト属性にマッピングします。

カスタムマージフィールドマッピング

field_mapping:
  # Standard fields
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Engagement metrics
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-commerce fields
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Custom merge fields
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE

API エンドポイント

オーディエンス (リスト)

キャンペーン

自動化

eコマース

イベント

キャンペーンイベント

購読者イベント

eコマースイベント

コード例

コネクターの初期化

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

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

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

オーディエンスの Brevo への移行

// Full audience migration from Mailchimp to Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Check migration status
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }

キャンペーンエンゲージメントデータの同期

// Sync campaign performance to Brevo attributes
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 connection successful
# ✓ Audiences readable
# ✓ Campaigns readable
# ✓ E-commerce data accessible
# ✓ Webhook configured

ベストプラクティス

1. バッチ操作を使用 - 一括更新には batch subscribe/unsubscribe を活用
2. 購読ステータスを維持 - 移行時に購読同意を尊重
3. マージフィールドを先にマッピング - 同期前に対応する Brevo 属性を作成
4. エンゲージメントデータを同期 - 履歴セグメンテーション向けに開封/クリック率をインポート
5. コンプライアンス状態を扱う - GDPR や永久削除状態を尊重
6. 増分同期を使用 - 前回同期以降の変更のみを同期して API 使用量を削減

セキュリティ

• API キー認証 - HTTP Basic 認証のパスワードとしてシークレットキーを渡す
• OAuth 2.0 - マルチアカウントアクセス向けのトークンベース認可
• TLS 暗号化 - すべての API 通信を HTTPS で暗号化
• ウェブフック検証 - 共有シークレットでウェブフック送信元を検証
• データセンター分離 - リージョン固有のデータセンターにデータを保存

関連リソース

• Mailchimp Marketing API リファレンス
• Mailchimp API ガイド
• Brevo コネクター
• ActiveCampaign コネクター
• 顧客同期スキル