Skip to content

표준 속성

표준 속성은 Braze가 모든 고객 프로필에서 인식하는 사전 정의된 필드입니다. 이 페이지에서 각 표준 속성의 필드 이름, 데이터 유형, 예상 형식을 빠르게 확인할 수 있습니다.

표준 속성(기본 속성 또는 예약 키라고도 함)은 비즈니스에 고유한 커스텀 속성과 다릅니다. 이 페이지에 나열된 필드 이름으로 Braze에 데이터를 전송하면, Braze는 새 커스텀 속성을 생성하는 대신 사전 정의된 프로필 필드에 데이터를 저장합니다.

다음 방법 중 하나를 통해 표준 속성을 설정할 수 있습니다.

식별자

식별자는 Braze에 업데이트하거나 생성할 고객 프로필을 알려줍니다. 모든 API 요청과 CSV 행에는 하나 이상의 식별자가 포함되어야 합니다. 올바른 식별자를 선택하는 방법에 대한 자세한 내용은 식별자 확인을 참조하세요.

프로필 필드

이 필드는 사용자의 인구 통계, 연락처, 로케일 데이터를 캡처합니다.

이 필드는 사용자가 채널별로 메시지를 수신하는 방식을 관리합니다. 이 필드를 업데이트해도 데이터 포인트 사용량에 포함되지 않습니다.

구독 그룹 설정에 대한 자세한 내용은 구독 그룹을 참조하세요.

세션 및 참여

이 필드는 사용자가 앱을 처음 또는 마지막으로 사용한 시점을 캡처합니다. SDK가 자동으로 기록하며, 일반적으로 다른 플랫폼에서 마이그레이션할 때만 API 또는 CSV를 통해 설정합니다.

푸시 토큰

다른 플랫폼에서 푸시 토큰을 마이그레이션할 때 이 필드를 사용합니다. Braze SDK를 통합한 후에는 푸시 토큰이 자동으로 캡처됩니다. 마이그레이션 안내는 푸시 토큰 마이그레이션을 참조하세요.

소셜 프로필

이 필드는 소셜 네트워크 통합의 데이터를 저장합니다.

API 예시

다음 요청은 /users/track 엔드포인트를 통해 두 명의 사용자에게 표준 속성을 설정합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "attributes": [
    {
      "external_id": "user1",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "[email protected]",
      "country": "US",
      "language": "en",
      "time_zone": "America/New_York",
      "dob": "1988-02-14",
      "email_subscribe": "opted_in"
    },
    {
      "external_id": "user2",
      "first_name": "Alex",
      "phone": "+14155552671",
      "current_location": {
        "longitude": -73.991443,
        "latitude": 40.753824
      },
      "subscription_groups": [
        {
          "subscription_group_id": "abc-123",
          "subscription_state": "subscribed"
        }
      ]
    }
  ]
}

전체 API 계약에 대한 자세한 내용은 사용자 속성 오브젝트를 참조하세요.

CSV 예시

다음 CSV는 두 명의 사용자에 대한 표준 속성을 업데이트합니다. 열 헤더는 이 문서의 필드 이름과 정확히 일치해야 합니다. 일치하지 않는 헤더(예: first_name 대신 First_name)는 커스텀 속성으로 가져옵니다.

1
2
3

external_id,first_name,last_name,email,country,language,dob,email_subscribe
user1,Jane,Doe,[email protected],US,en,1988-02-14,opted_in
user2,Alex,Smith,[email protected],GB,en,1992-09-30,subscribed

일부 표준 속성은 CSV 가져오기를 통해 설정할 수 없습니다. 배열, 푸시 토큰, 중첩 오브젝트는 API 또는 클라우드 데이터 수집을 통해 전송해야 합니다. CSV 지원 필드의 전체 목록과 가져오기 단계는 기본 속성을 참조하세요.

고려 사항

표준 속성을 사용할 때 다음 사항을 고려하세요.

  • 필드 이름은 대소문자를 구분합니다. 항상 소문자를 사용하세요. 표준 속성 이름과 정확히 일치하지 않는 헤더나 키는 커스텀 속성으로 처리됩니다.
  • API 또는 CSV를 통해 값을 설정하면 SDK 자동 캡처가 중지됩니다. API 또는 CSV를 통해 country 또는 language를 설정하면, Braze는 해당 사용자에 대해 SDK에서 해당 필드를 자동으로 캡처하지 않습니다.
  • null은 값을 제거합니다. 표준 속성을 null로 설정하면 프로필에서 해당 값이 제거됩니다. external_id 및 user_alias를 포함한 일부 필드는 설정된 후 제거할 수 없습니다.
  • 빈 CSV 값은 덮어쓰지 않습니다. CSV 가져오기에서 빈 셀은 프로필의 기존 값을 유지합니다. 값을 지우려면 API를 사용하세요.
  • 시간대 기본값은 UTC입니다. 오프셋이 없는 날짜 문자열은 UTC 자정으로 해석되며 워크스페이스의 시간대로 표시됩니다. 시간대를 지정하려면 UTC 오프셋을 추가하세요(예: 2024-11-10T18:00:00-05:00).
New Stuff!