ActiveCampaign コネクター

ActiveCampaign アカウントを Tajo 経由で Brevo に接続し、包括的なコンタクト移行、ディールパイプライン同期、オートメーションマッピング、および両プラットフォーム間の統合マーケティングデータを実現します。

概要

機能

• コンタクト移行 - カスタムフィールド、タグ、リストメンバーシップを含むコンタクトを移行
• ディールパイプライン同期 - 売上追跡のためディールステージ、金額、担当者を同期
• オートメーションマッピング - ActiveCampaign のオートメーションを Brevo ワークフロートリガーにマッピング
• イベントトラッキング - 行動セグメンテーションのためサイトトラッキングとカスタムイベントを同期
• リストとタグの同期 - リスト構造とタグベースセグメントを Brevo に複製
• e コマース統合 - Deep Data (注文、顧客、カート) を Brevo に同期
• カスタムオブジェクト同期 - ActiveCampaign カスタムオブジェクトを Brevo 属性にマッピング
• スコア同期 - リードスコアとコンタクトスコアを Brevo 属性に転送

前提条件

開始する前に、以下をご用意ください。

1. ActiveCampaign アカウント (Lite、Plus、Professional、Enterprise のいずれか)
2. Settings > Developer から取得した API URL と API キー
3. API アクセス付きの Brevo アカウント
4. Tajo アカウント

認証

API キー認証

ActiveCampaign はヘッダーまたはクエリパラメーターとして API キーを渡します。

curl "https://{account}.api-us1.com/api/3/contacts" \
  -H "Api-Token: YOUR_API_KEY" \
  -H "Content-Type: application/json"

API URL と API キーは ActiveCampaign Settings > Developer で確認できます。

設定

基本セットアップ

connectors:
  activecampaign:
    enabled: true
    api_url: "https://yourcompany.api-us1.com"
    api_key: "${AC_API_KEY}"

    # Data sync options
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # List mapping to Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

フィールドマッピング

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

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

field_mapping:
  # Standard fields
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Engagement fields
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Deal fields
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Custom fields
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

API エンドポイント

コンタクト

ディール

オートメーション

e コマース (Deep Data)

イベントトラッキング

イベント

コンタクトイベント

ディールイベント

オートメーションイベント

コード例

コネクターの初期化

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

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

// Connect ActiveCampaign
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});

コンタクトを Brevo に移行

// Full contact migration with custom fields and tags
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Check sync status
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }

カスタムイベントの追跡

// Forward ActiveCampaign events to Brevo
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

レート制限

ActiveCampaign API レート制限。

追加の制限。

• 一括インポート: 1 バッチあたり 250 コンタクト
• 一括インポート頻度: 同時実行は 1 件のみ
• イベントトラッキング: 2 リクエスト/秒
• 日次制限: 明示的な日次制限なし (レートベースのみ)

トラブルシューティング

よくある問題

デバッグモード

詳細ログを有効化します。

connectors:
  activecampaign:
    debug: true
    log_level: verbose
    log_webhooks: true

接続テスト

tajo connectors test activecampaign
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Deals readable
# ✓ Automations accessible
# ✓ Event tracking enabled

ベストプラクティス

1. コンタクト同期エンドポイントを使用 - 個別の作成/更新ではなくアップサート操作に /contact/sync を使用
2. フィールドは ID でマッピング - カスタムフィールド ID は安定しています (ラベルは変更される可能性あり)
3. リストメンバーシップを保持 - コンタクトデータと一緒にリスト所属を移行
4. ディールパイプラインを同期 - 一貫した CRM レポート用にパイプラインステージをマッピング
5. イベントトラッキングを実装 - Brevo での行動データ取得にサイトトラッキングを活用
6. 一括インポートを活用 - 1,000 件を超えるデータセットには一括インポートを使用

セキュリティ

• API キー認証 - Api-Token ヘッダー経由のトークンベースアクセス
• ウェブフック検証 - ウェブフック送信元 IP レンジを検証
• TLS 暗号化 - すべての API 通信を HTTPS で暗号化
• アカウントレベルのアクセス - API キーはアカウント全体へのアクセスを提供 (取り扱いに注意)
• IP 制限 - Enterprise プランで利用可能

関連リソース

• ActiveCampaign API ドキュメント
• ActiveCampaign ウェブフックガイド
• Mailchimp コネクター
• Brevo コネクター
• 顧客同期スキル