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": "Alex",
      "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!