メインコンテンツまでスキップ

ユーザー管理

ユーザープロフィールとプリファレンスを管理して、パーソナライゼーションを向上させます。すべてのユーザーエンドポイントは無料（0 クレジット）です。

ユーザーの作成方法​

ユーザーを作成するには、以下のいずれかの方法を使用します：

方法説明
PUT /v1/users/{user_id}明示的にユーザーを作成・更新（推奨）
POST /v1/events（login）user_id（必須）に基づきバックグラウンドで自動作成。metadata.user_attributes のプロパティもマージ
POST /v1/events（session_start）user_id が含まれている場合にバックグラウンドで自動作成
注記

click、impression 等のその他のイベントタイプでは、ユーザーの新規作成は行われません。既に登録済みのユーザーの last_active_at 更新のみです。

ユーザーの作成・更新​

PUT /v1/users/{user_id}
{
  "properties": {
    "area_names": ["Tokyo"],
    "area_level": "prefecture",
    "language": "ja",
    "interests": ["technology", "design"],
    "registered_at": "2024-01-15T10:30:00Z"
  }
}

user_id はアプリケーション側のユーザー識別子です。ユーザーが存在しない場合は自動的に作成されます。

プロパティ説明
area_namesエリア名の配列（例: 駅名）。メインエリアとサブエリアの両方を登録可能
area_levelエリアの粒度（例: station, city, prefecture）
registered_atアプリケーション側でのユーザー会員登録日時（ISO 8601 形式、オプション）

ユーザープロパティの更新​

プロフィール全体を置き換えずに、特定のプロパティのみを更新する場合：

PATCH /v1/users/{user_id}
{
  "properties": {
    "interests": ["technology", "business", "ai"]
  }
}

ユーザー詳細の取得​

GET /v1/users/{user_id}

プロパティ、フォロー中のソース、ブロック中のソースを含むユーザープロフィールを返します。

ユーザー一覧​

GET /v1/users?limit=20&cursor=...

テナント内のすべてのユーザーをページネーション付きで一覧表示します。

ユーザーの削除​

DELETE /v1/users/{user_id}

ユーザーと関連データを完全に削除します。

ソースプリファレンス​

ユーザーは特定のコンテンツソースをフォローまたはブロックできます：

ソースのフォロー​

PUT /v1/users/{user_id}/sources/{source_id}/follow

フォローしたソースは、ユーザーのフィードでランキングが優遇されます。

ソースのフォロー解除​

DELETE /v1/users/{user_id}/sources/{source_id}/follow

ソースのブロック​

PUT /v1/users/{user_id}/sources/{source_id}/block

ブロックしたソースは、ユーザーのフィードから完全に除外されます。

ソースのブロック解除​

DELETE /v1/users/{user_id}/sources/{source_id}/block