Skip to content

구매 기록

Braze SDK를 통해 인앱 구매를 기록하는 방법을 알아보세요. 이를 통해 시간 경과에 따른 매출과 소스별 매출을 확인할 수 있습니다. 커스텀 이벤트, 커스텀 속성 및 구매 이벤트를 사용하여 생애주기 가치에 따라 사용자를 세분화할 수 있습니다.

USD가 아닌 통화로 보고된 구매는 보고된 날짜의 환율을 기준으로 Braze에서 USD로 표시됩니다. 통화 변환을 방지하려면 통화를 USD로 하드코딩하세요.

구매 및 매출 기록하기

구매 및 매출을 기록하려면 앱에서 구매에 성공한 후 logPurchase()를 호출하세요. 제품 식별자가 비어 있으면 구매가 Braze에 기록되지 않습니다.

표준 웹 SDK 구현의 경우 다음 메서드를 사용할 수 있습니다:

1

braze.logPurchase(product_id, price, "USD", quantity);

대신 Google Tag Manager를 사용하려면 구매 태그 유형을 사용하여 logPurchase 메서드를 호출할 수 있습니다. 이 태그를 사용하여 구매 속성정보를 선택적으로 포함하여 Braze에 구매를 추적합니다. 이를 위해:

  1. 제품 ID 및 가격 필드는 필수입니다.
  2. 행 추가 버튼을 사용하여 구매 속성정보를 추가합니다.

Braze 동작 태그 구성 설정을 보여주는 대화상자. 포함된 설정은 "태그 유형", "외부 ID", "가격", "통화 코드", "수량" 및 "구매 속성정보"입니다.

1
2
3
4
5
6

Braze.getInstance(context).logPurchase(
   String productId,
   String currencyCode,
   BigDecimal price,
   int quantity
);

1
2
3
4
5
6

Braze.getInstance(context).logPurchase(
  productId: String,
  currencyCode: String,
  price: BigDecimal,
  quantity: Int
)

1

AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price)

1
2
3

[AppDelegate.braze logPurchase:"product_id"
                      currency:@"USD"
                         price:price];

1
2
3

var properties = {};
properties["KEY"] = "VALUE";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);

1

braze.logPurchase(productId, currencyCode, price, quantity, properties: properties);

1

Braze.logPurchase(productId, price, currencyCode, quantity, properties);

1

m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity)

1

AppboyBinding.LogPurchase("product_id", "currencyCode", price(decimal));

속성정보 추가

Int, Double, String, Bool 또는 Date 값으로 채워진 사전을 전달하여 구매에 대한 메타데이터를 추가할 수 있습니다.

표준 웹 SDK 구현의 경우 다음 메서드를 사용할 수 있습니다:

1

braze.logPurchase(product_id, price, "USD", quantity, {key: "value"});

사이트가 표준 이커머스 이벤트 데이터 레이어 항목을 사용하여 Google Tag Manager에 구매를 기록하는 경우, 이커머스 구매 태그 유형을 사용할 수 있습니다. 이 동작 유형은 items 목록에 전송된 각 항목에 대해 별도의 “구매”를 Braze에 기록합니다.

구매 속성정보 목록에서 키를 지정하여 구매 속성정보로 포함할 추가 속성정보 이름을 지정할 수도 있습니다. Braze는 목록에 추가한 구매 속성정보에 대해 기록 중인 개별 item 내에서 확인합니다.

예를 들어, 다음 이커머스 페이로드가 주어졌을 때:

1
2
3
4
5
6
7

items: [{
  item_name: "5 L WIV ECO SAE 5W/30",
  item_id: "10801463",
  price: 24.65,
  item_brand: "EUROLUB",
  quantity: 1
}]

item_brand와 item_name만 구매 속성정보로 전달하려면 구매 속성정보 테이블에 이 두 필드만 추가하면 됩니다. 속성정보를 제공하지 않으면 Braze에 대한 logPurchase 호출에서 구매 속성정보가 전송되지 않습니다.

1
2
3

BrazeProperties purchaseProperties = new BrazeProperties();
purchaseProperties.addProperty("key", "value");
Braze.getInstance(context).logPurchase(..., purchaseProperties);

1
2
3

val purchaseProperties = BrazeProperties()
purchaseProperties.addProperty("key", "value")
Braze.getInstance(context).logPurchase(..., purchaseProperties)

1
2

let purchaseProperties = ["key": "value"]
AppDelegate.braze?.logPurchase(productID: "product_id", currency: "USD", price: price, properties: purchaseProperties)

1
2
3
4
5

NSDictionary *purchaseProperties = @{@"key": @"value"};
[AppDelegate.braze logPurchase:@"product_id"
                      currency:@"USD"
                         price:price
                   properties:purchaseProperties];

1
2
3

var properties = {};
properties["key"] = "value";
BrazePlugin.logPurchase("PRODUCT_ID", 10, "USD", 5, properties);

1

braze.logPurchase(productId, currencyCode, price, quantity, properties: {"key": "value"});

1

Braze.logPurchase(productId, price, currencyCode, quantity, { key: "value" });

1

m.Braze.logPurchase("product_id", "currency_code", Double price, Integer quantity, {"stringPropKey" : "stringPropValue", "intPropKey" : Integer intPropValue})

1
2
3
4
5

Dictionary<string, object> purchaseProperties = new Dictionary<string, object>
{
    { "key", "value" }
};
AppboyBinding.LogPurchase("product_id", "currencyCode", price(decimal), purchaseProperties);

수량 추가

기본적으로 quantity는 1로 설정됩니다. 그러나 고객이 단일 결제에서 동일한 구매를 여러 번 하는 경우 구매에 수량을 추가할 수 있습니다. 수량을 추가하려면 quantity에 Int 값을 전달하세요.

REST API 사용

REST API를 사용하여 구매를 기록할 수도 있습니다. 자세한 내용은 사용자 데이터 엔드포인트를 참조하세요.

주문 기록

제품 수준 대신 주문 수준에서 구매를 기록하려면 주문 이름 또는 주문 카테고리를 product_id로 사용하면 됩니다. 자세한 내용은 구매 오브젝트 사양을 참조하세요.

예약 키

다음 키는 예약되어 있으며 구매 속성정보로 사용할 수 없습니다:

  • time
  • product_id
  • quantity
  • event_name
  • price
  • currency

지원되는 통화

Braze는 다음 통화 기호를 지원합니다. 이 외의 통화 기호를 제공하면 경고가 기록되고 구매가 Braze에 기록되지 않습니다.

  • AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN
  • BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BRL
  • BSD, BTC, BTN, BWP, BYR, BZD
  • CAD, CDF, CHF, CLF, CLP, CNY, COP, CRC, CUC, CUP, CVE, CZK
  • DJF, DKK, DOP, DZD
  • EEK, EGP, ERN, ETB, EUR
  • FJD, FKP
  • GBP, GEL, GGP, GHS, GIP, GMD, GNF, GTQ, GYD
  • HKD, HNL, HRK, HTG, HUF
  • IDR, ILS, IMP, INR, IQD, IRR, ISK
  • JEP, JMD, JOD, JPY
  • KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT
  • LAK, LBP, LKR, LRD, LSL, LTL, LVL, LYD
  • MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MTL, MUR, MVR, MWK, MXN, MYR, MZN
  • NAD, NGN, NIO, NOK, NPR, NZD
  • OMR
  • PAB, PEN, PGK, PHP, PKR, PLN, PYG
  • QAR
  • RON, RSD, RUB, RWF
  • SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, STD, SVC, SYP, SZL
  • THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS
  • UAH, UGX, USD, UYU, UZS
  • VEF, VND, VUV
  • WST
  • XAF, XAG, XAU, XCD, XDR, XOF, XPD, XPF, XPT
  • YER
  • ZAR, ZMK, ZMW, ZWL
New Stuff!