コンタクトの作成
パーソナライズしたコミュニケーションのために、ロイヤルティプログラムの情報とカスタム属性を添えて、新しい顧客を Brevo のコンタクトデータベースに追加します。
クイックスタート
基本的なコンタクト作成
POST https://api.brevo.com/v3/contactsContent-Type: application/jsonapi-key: YOUR_API_KEY
{ "attributes": { "FIRSTNAME": "John", "LASTNAME": "Doe", "LOYALTY_POINTS": 1500, "LOYALTY_TIER": "Gold", "SIGNUP_DATE": "2024-01-15", "LAST_PURCHASE": "2024-01-20", "TOTAL_SPENT": 299.99 }, "listIds": [1, 2], "updateEnabled": true}レスポンス
{ "id": 123456}ロイヤルティプログラムとの連携
ロイヤルティ属性を持つ新規顧客
{ "attributes": { "FIRSTNAME": "Sarah", "LASTNAME": "Johnson", "PHONE": "+1234567890", "LOYALTY_ID": "LYL-2024-001", "LOYALTY_POINTS": 0, "LOYALTY_TIER": "Bronze", "PREFERRED_REWARDS": "Discounts", "BIRTHDAY": "1990-05-15", "SIGNUP_SOURCE": "Website", "REFERRAL_CODE": "REF-12345", "COMMUNICATION_PREFERENCES": "Email,SMS", "PURCHASE_CATEGORIES": ["Electronics", "Fashion"], "AVERAGE_ORDER_VALUE": 0 }, "listIds": [1], // New customers list "emailBlacklisted": false, "smsBlacklisted": false, "updateEnabled": true}既存顧客の更新
{ "attributes": { "LOYALTY_POINTS": 2500, "LOYALTY_TIER": "Platinum", "LAST_PURCHASE": "2024-01-25", "TOTAL_SPENT": 1299.99, "RECENT_PURCHASES": ["Product A", "Product B"], "ENGAGEMENT_SCORE": 8.5, "LAST_EMAIL_OPENED": "2024-01-24", "PREFERRED_CONTACT_TIME": "Evening" }, "listIds": [1, 3], // Add to platinum customers list "updateEnabled": true}Tajo 固有の属性
顧客ロイヤルティデータ
| 属性名 | 型 | 説明 |
|---|---|---|
LOYALTY_ID | String | ロイヤルティプログラムの一意の ID |
LOYALTY_POINTS | Number | 現在のポイント残高 |
LOYALTY_TIER | String | 現在のティア（Bronze、Silver、Gold、Platinum） |
POINTS_EARNED_YTD | Number | 今年獲得したポイント |
POINTS_REDEEMED_YTD | Number | 今年利用したポイント |
TIER_PROGRESS | Number | 次のティアまでの進捗（%） |
NEXT_TIER_POINTS | Number | 次のティアに必要なポイント |
購買行動
| 属性名 | 型 | 説明 |
|---|---|---|
TOTAL_SPENT | Number | 顧客生涯価値 |
AVERAGE_ORDER_VALUE | Number | 平均購入金額 |
PURCHASE_FREQUENCY | String | 購入の頻度 |
LAST_PURCHASE | Date | 最終購入日 |
FAVORITE_CATEGORIES | Array | よく購入する商品カテゴリー |
SEASONAL_BUYER | Boolean | 季節ごとに購入するかどうか |
エンゲージメント指標
| 属性名 | 型 | 説明 |
|---|---|---|
ENGAGEMENT_SCORE | Number | 1〜10 のエンゲージメント評価 |
EMAIL_OPEN_RATE | Number | 個人ごとの開封率（%） |
CLICK_THROUGH_RATE | Number | 個人ごとの CTR（%） |
LAST_EMAIL_OPENED | Date | 最後にメールを操作した日 |
PREFERRED_CHANNEL | String | Email、SMS、WhatsApp |
コンタクトの一括作成
複数のコンタクトをまとめて作成します。
{ "contacts": [ { "attributes": { "FIRSTNAME": "Alice", "LOYALTY_POINTS": 500, "LOYALTY_TIER": "Bronze" } }, { "attributes": { "FIRSTNAME": "Bob", "LOYALTY_POINTS": 1200, "LOYALTY_TIER": "Silver" } } ], "listIds": [1], "updateEnabled": true}エラー処理
よくあるエラーと対処方法は次のとおりです。
{ "code": "duplicate_parameter", "message": "Contact already exists", "details": { "existingId": 123456 }}{ "code": "invalid_parameter", "message": "Invalid list ID", "details": { "listIds": [999] }}Tajo でのベストプラクティス
- 中心となるロイヤルティ項目を必ず含める: LOYALTY_POINTS、LOYALTY_TIER、LOYALTY_ID
- 更新を有効にする: 既存のコンタクトを更新できるようにします
- セグメント用リストを活用する: ティア、行動、嗜好で整理します
- エンゲージメントを追跡する: メールと SMS の反応率を継続的に確認します
- データを定期的に同期する: ロイヤルティデータを自社システムと同じ最新状態に保ちます
次のステップ
- コンタクト属性の更新
- コンタクトリストの管理
- カスタム属性の設定
- コンタクトの一括インポート