Customer.io Hello World

概要

ユーザーを識別してイベントをトリガーする最小限のCustomer.ioの例を作成します。

前提条件

• customerio-install-auth スキルが完了していること
• Customer.io SDKがインストールされていること
• Site IDとAPI Keyが適切に設定されていること

手順

ステップ1: 基本的な統合を作成する

// hello-customerio.ts
import { TrackClient, RegionUS } from '@customerio/track';

const client = new TrackClient(
  process.env.CUSTOMERIO_SITE_ID!,
  process.env.CUSTOMERIO_API_KEY!,
  { region: RegionUS }
);

async function main() {
  // ステップ1: ユーザーを識別する
  await client.identify('user-123', {
    email: 'hello@example.com',
    first_name: 'Hello',
    created_at: Math.floor(Date.now() / 1000)
  });
  console.log('User identified');

  // ステップ2: イベントを追跡する
  await client.track('user-123', {
    name: 'hello_world',
    data: {
      source: 'sdk-test',
      timestamp: new Date().toISOString()
    }
  });
  console.log('Event tracked');
}

main().catch(console.error);

ステップ2: 例を実行する

npx ts-node hello-customerio.ts

ステップ3: ダッシュボードで確認する

1. Customer.ioダッシュボードを開く
2. Peopleセクションに移動する
3. 「user-123」または「hello@example.com」を検索する
4. ユーザープロフィールに属性が表示されていることを確認する
5. Activityタブで「hello_world」イベントを確認する

出力

• Customer.ioにユーザーが作成/更新される
• ユーザーのアクティビティログにイベントが記録される
• 成功を確認するコンソール出力

エラーハンドリング

エラー	原因	解決策
401 Unauthorized	認証情報が無効	Site IDとAPI Keyを確認する
400 Bad Request	データフォーマットが無効	属性名と型をチェックする
User not found	Identifyが呼び出されていない	イベント追跡の前に常にIdentifyを実行する
Event not showing	ダッシュボード遅延	1〜2分待ってからリフレッシュする

例

Python Hello World

import os
from customerio import CustomerIO

cio = CustomerIO(
    site_id=os.environ.get('CUSTOMERIO_SITE_ID'),
    api_key=os.environ.get('CUSTOMERIO_API_KEY')
)

# ユーザーを識別する
cio.identify(id='user-123', email='hello@example.com', first_name='Hello')
print('User identified')

# イベントを追跡する
cio.track(customer_id='user-123', name='hello_world', source='sdk-test')
print('Event tracked')

匿名ユーザーの場合

// デバイスIDで匿名ユーザーを追跡する
await client.identify('device-abc123', {
  anonymous_id: 'device-abc123',
  platform: 'web'
});

リソース

• Identify API
• Track API

次のステップ

Hello Worldが動作することを確認した後、customerio-local-dev-loop に進んで開発ワークフローをセットアップします。