Skip to content

標準属性項目

標準属性項目は、Brazeがすべてのユーザープロファイルで認識する定義済みのフィールドです。このページでは、各標準属性項目のフィールド名、データタイプ、想定されるフォーマットをクイックリファレンスとして確認できます。

標準属性項目（デフォルト属性や予約キーとも呼ばれます）は、ビジネス固有のカスタム属性とは異なります。このページに記載されているフィールド名でBrazeにデータを送信すると、Brazeは新しいカスタム属性を作成する代わりに、定義済みのプロファイルフィールドにデータを保存します。

標準属性項目は、以下のいずれかの方法で設定できます。

識別子

識別子は、Brazeにどのユーザープロファイルを更新または作成するかを伝えます。すべてのAPIリクエストとCSV行には、少なくとも1つの識別子を含める必要があります。適切な識別子の選択方法については、識別子の解決を参照してください。

プロファイルフィールド

これらのフィールドは、ユーザーのデモグラフィック、連絡先、ロケールデータを取得します。

これらのフィールドは、ユーザーがチャネル間でメッセージを受信する方法を管理します。これらのフィールドを更新しても、データポイント使用量にはカウントされません。

サブスクリプショングループの設定の詳細については、サブスクリプショングループを参照してください。

セッションとエンゲージメント

これらのフィールドは、ユーザーが最初または最後にアプリを利用した日時を記録します。SDKが自動的に記録するため、通常は別のプラットフォームから移行する場合にのみAPIまたはCSVで設定します。

プッシュトークン

これらのフィールドは、別のプラットフォームからプッシュトークンを移行する際に使用します。Braze SDKを統合すると、プッシュトークンは自動的に取得されます。移行のガイダンスについては、プッシュトークンの移行を参照してください。

ソーシャルプロファイル

これらのフィールドは、ソーシャルネットワーク統合からのデータを保存します。

APIの例

以下のリクエストは、/users/trackエンドポイントを通じて2人のユーザーに標準属性項目を設定します。

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は、2人のユーザーの標準属性項目を更新します。列ヘッダーは、この記事のフィールド名と正確に一致する必要があります。一致しないヘッダー（例：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の午前0時として解釈され、ワークスペースのタイムゾーンで表示されます。タイムゾーンを指定するには、UTCオフセットを追加してください（例：2024-11-10T18:00:00-05:00）。
New Stuff!