English 中文TürkçeРусскийEspañol日本語Tiếng Việt
POST /api/v1/profile/save/

Lưu hồ sơ người dùng

Copy as Markdown

Tạo hoặc cập nhật một hồ sơ người dùng trong Adapty Mail. Hồ sơ người dùng mang theo email và các thuộc tính mà Adapty Mail sử dụng để xác định người nhận và xây dựng phân khúc.

Xác định từng người dùng bằng một external_profile_id ổn định. Gửi cùng một external_profile_id lần nữa sẽ cập nhật hồ sơ hiện có thay vì tạo bản trùng lặp.

Request body

external_profile_idstringrequired

Mã định danh ổn định cho người dùng, do ứng dụng hoặc backend của bạn quản lý. Sử dụng lại cùng một giá trị trong các yêu cầu để Adapty Mail liên kết email, lượt nhấp và giao dịch mua với một hồ sơ duy nhất. Không bao giờ sử dụng mã định danh ẩn danh hoặc mã định danh theo từng lần cài đặt.

external_created_atstringrequired

Thời gian tạo người dùng, theo định dạng ISO 8601 (ví dụ: "2026-06-01T10:30:00Z"). Bạn có thể sử dụng ngày này trong các phân khúc.

emailstringrequired

Địa chỉ email của người dùng. Adapty Mail gửi các chiến dịch đến địa chỉ này.

first_namestring

Tên của người dùng.

last_namestring

Họ của người dùng.

genderstring

Giới tính của người dùng.

birthdaystring

Ngày sinh của người dùng, theo định dạng ISO 8601 (ví dụ: "1990-05-21").

countrystring

Quốc gia của người dùng dưới dạng mã ISO 3166-1 alpha-2 viết hoa gồm hai chữ cái (ví dụ: US).

store_countrystring

Khu vực cửa hàng của người dùng dưới dạng mã ISO 3166-1 alpha-2 viết hoa gồm hai chữ cái (ví dụ: US).

custom_attributesobject

Các cặp key-value tùy ý (giá trị chuỗi hoặc số) để đính kèm vào hồ sơ người dùng. Sử dụng chúng để xây dựng phân khúc — ví dụ: plan, signup_source hoặc trial_days.

device_infoobject
platformstringrequired

Nền tảng mà người dùng đang sử dụng, ví dụ: iOS hoặc Android.

devicestring

Kiểu thiết bị, ví dụ: iPhone15,2.

osstring

Phiên bản hệ điều hành, ví dụ: 17.5.

localestring

Ngôn ngữ và vùng của người dùng, ví dụ: en-US.

timezonestring

Múi giờ của người dùng, ví dụ: America/New_York.

app_versionstring

Phiên bản ứng dụng của bạn mà người dùng đang chạy, ví dụ: 3.1.0.

Responses

Hồ sơ người dùng đã được lưu thành công. Nội dung phản hồi là một đối tượng rỗng.

Schema
object
Example 
{}

Xác thực thất bại — một trường bắt buộc bị thiếu hoặc không hợp lệ. field_name cho biết trường nào.

Schema

Phản hồi lỗi chuẩn. Mọi lỗi đều trả về trạng thái 4XX với cấu trúc này.

errorsarray of object
messagestring

Mô tả lỗi dễ đọc cho người dùng.

error_codestring

Mã định danh lỗi dễ đọc cho máy.

status_codeinteger

Mã trạng thái HTTP cho lỗi này.

field_namestring

Trường trong yêu cầu gây ra lỗi, hoặc null nếu lỗi không liên quan đến trường cụ thể nào.

Example 
{
  "errors": [
    {
      "message": "Field required",
      "error_code": "base_error",
      "status_code": 400,
      "field_name": "email"
    }
  ]
}

Thiếu hoặc sai secret API key.

Schema

Phản hồi lỗi chuẩn. Mọi lỗi đều trả về trạng thái 4XX với cấu trúc này.

errorsarray of object
messagestring

Mô tả lỗi dễ đọc cho người dùng.

error_codestring

Mã định danh lỗi dễ đọc cho máy.

status_codeinteger

Mã trạng thái HTTP cho lỗi này.

field_namestring

Trường trong yêu cầu gây ra lỗi, hoặc null nếu lỗi không liên quan đến trường cụ thể nào.

Example 
{
  "errors": [
    {
      "message": "Secret key doesn't exist",
      "error_code": "secret_key_does_not_exist_error",
      "status_code": 403,
      "field_name": null
    }
  ]
}