Skip to content

구매 오브젝트

이 문서에서는 구매 오브젝트의 다양한 구성요소, 올바른 사용 방법, 모범 사례 및 참고할 수 있는 예시를 설명합니다.

구매 오브젝트란 무엇인가요?

구매 오브젝트는 구매가 이루어졌을 때 API를 통해 전달되는 오브젝트입니다. 각 구매 오브젝트는 구매 배열 내에 위치하며, 각 오브젝트는 특정 시간에 특정 사용자가 수행한 단일 구매입니다. 구매 오브젝트에는 Braze 백엔드에서 이 정보를 저장하고 커스터마이징, 데이터 수집 및 개인화에 활용할 수 있도록 하는 다양한 필드가 있습니다.

오브젝트 본문

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

{
  // One of "external_id" or "user_alias" or "braze_id" or "email" or "phone" is required.
  "external_id" : (optional, string) External user ID,
  "user_alias" : (optional, User Alias Object) User alias object,
  "braze_id" : (optional, string) Braze user identifier,
  "email": (optional, string) User email address,
  "phone": (optional, string) User phone number,
  "app_id" : (optional, string) see App Identifier,
  // See the following product_id naming conventions for clarification.
  "product_id" : (required, string) identifier for the purchase, for example, Product Name or Product Category,
  "currency" : (required, string) ISO 4217 Alphabetic Currency Code,
  //Revenue from a purchase object is calculated as the product of quantity and price.
  "price" : (required, float) value in the base currency unit (for example, Dollars for USD, Yen for JPY),
  "quantity" : (optional, integer) the quantity purchased (defaults to 1, must be <= 100 -- currently, Braze treats a quantity _X_ as _X_ separate purchases with quantity 1),
  "time" : (required, datetime as string in ISO 8601) Time of purchase,
  // See the following purchase object explanation for clarification.
  "properties" : (optional, Properties Object) properties of the event,
  // Setting this flag to true puts the API in "Update Only" mode.
  // When using a "user_alias", "Update Only" mode is always true.
  "_update_existing_only" : (optional, boolean)
}

구매 제품 ID

구매 오브젝트 내에서 product_id는 구매 식별자(예: Product Name 또는 Product Category)입니다.

  • Braze는 대시보드에 최대 5,000개의 product_id를 저장할 수 있습니다.
  • product_id는 최대 255자까지 입력할 수 있습니다.

명명 규칙

Braze에서는 구매 오브젝트 product_id에 대한 몇 가지 일반적인 명명 규칙을 제공합니다. product_id를 선택할 때, Braze는 모든 로깅된 항목을 이 product_id로 그룹화할 수 있도록 SKU 대신 제품 이름이나 제품 카테고리와 같은 간단한 이름을 사용할 것을 권장합니다.

이렇게 하면 세분화 및 트리거링을 위해 제품을 더 쉽게 식별할 수 있습니다.

주문 수준에서 구매 기록

제품 수준이 아닌 주문 수준에서 구매를 기록하려면 주문 이름 또는 주문 카테고리를 product_id로 사용할 수 있습니다(예: Online Order 또는 Completed Order).

예를 들어, 웹 SDK에서 주문 수준으로 구매를 기록하려면 다음과 같이 합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "purchases" : [
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "Completed Order",
      "currency" : "USD",
      "price" : 219.98,
      "time" : "2013-07-16T19:20:30+01:00",
      "properties" : {
        "products" : [ { "name": "Monitor", "category": "Gaming", "product_amount": 19.99, },
        { "name": "Gaming Keyboard", "category": "Gaming ", "product_amount": 199.99, }
        ]
      }
    }
  ]
}

구매 등록정보 오브젝트

The properties values must be an object up to 50 KB where the keys are the property names and the values are the property values. Property names must be strings, 255 characters or fewer, with no leading dollar signs ($).

Property values can be any of the following data types:

Data type Description
Number Integer or float
Boolean Value true or false
Datetime String in ISO 8601 or yyyy-MM-dd'T'HH:mm:ss:SSSZ format. Not supported within arrays.
String 255 characters or fewer
Array Supported; datetimes are not supported within arrays.
Object Ingested as strings (not nested objects). For nested data, use a string value (for example, JSON serialized).

The following keys are reserved and cannot be used as property names: time, product_id, quantity, event_name, price, and currency. Using a reserved key in the properties object returns the error “Invalid ‘properties’ field”.

데이터 유형에 대한 통합 참조는 커스텀 속성, 이벤트 등록정보 및 카탈로그 전반에 걸쳐 데이터 유형을 참조하세요.

구매 등록정보

구매 등록정보를 사용하여 메시지를 트리거하고 Liquid를 사용하여 개인화할 수 있으며, 이러한 등록정보를 기반으로 세분화할 수도 있습니다.

명명 규칙

이 기능은 구매 단위가 아닌 제품 단위로 설정된다는 점에 유의하세요. 예를 들어, 고유한 제품 수가 많지만 각각의 등록정보가 동일한 경우 세분화가 불필요할 수 있습니다.

이 경우 데이터 구조를 설정할 때 트랜잭션 수준 식별자 대신 “그룹 수준”에서 제품 이름을 사용하는 것이 좋습니다. 예를 들어, 기차표 회사는 “거래 123” 또는 “거래 046”과 같은 특정 거래가 아닌 “편도 여행”, “왕복 여행”, “다구간 여행”에 대한 제품을 보유해야 합니다. 또 다른 예로, “음식” 구매 이벤트의 경우 등록정보를 “케이크”와 “샌드위치”로 설정하는 것이 가장 좋습니다.

구매 오브젝트 예시

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
34
35
36
37
38
39
40
41
42
43
44
45

POST https://YOUR_REST_API_URL/users/track
Content-Type: application/json
Authorization: Bearer YOUR-REST-API-KEY
{
  "purchases" : [
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "backpack",
      "currency" : "USD",
      "price" : 40.00,
      "time" : "2013-07-16T19:20:30+01:00",
      "properties" : {
        "color" : "red",
        "monogram" : "ABC",
        "checkout_duration" : 180,
        "size" : "Large",
        "brand" : "Backpack Locker"
      }
    },
    {
      "external_id" : "user1",
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "pencil",
      "currency" : "USD",
      "price" : 2.00,
      "time" : "2013-07-17T19:20:20+01:00",
      "properties" : {
        "number" : 2,
        "sharpened" : true
      }
    },
    {
      "user_alias" : { "alias_name" : "device123", "alias_label" : "my_device_identifier"},
      "app_id" : "11ae5b4b-2445-4440-a04f-bf537764c9ad",
      "product_id" : "pen",
      "currency" : "USD",
      "price" : 2.50,
      "time" : "2013-07-17T19:20:20+01:00",
      "properties" : {
        "color" : "blue",
      }
    }
  ]
}

구매 오브젝트, 이벤트 오브젝트 및 웹훅

위의 예시를 통해 누군가 색상, 모노그램, 결제 소요 시간, 사이즈, 브랜드 등의 등록정보를 가진 배낭을 구매했음을 알 수 있습니다. 그런 다음 구매 이벤트 등록정보를 사용하여 이러한 등록정보로 세그먼트를 만들거나 Liquid를 사용하여 채널을 통해 커스텀 메시지를 보낼 수 있습니다. 예를 들어, “안녕하세요 Ann F. 님, 빨간색 중형 배낭을 $40.00에 구매해 주셔서 감사합니다! Backpack Locker에서 쇼핑해 주셔서 감사합니다!”

세분화에 사용할 등록정보를 저장하고 추적하려면 해당 등록정보를 커스텀 속성으로 설정해야 합니다. 이는 세그먼트 확장을 사용하여 수행할 수 있으며, 해당 고객 프로필의 수명 기간 동안 저장된 커스텀 이벤트 또는 구매 동작을 기반으로 사용자를 타겟팅할 수 있습니다.
New Stuff!