Skip to content

구매 기록

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

USD가 아닌 통화로 보고된 구매는 보고된 날짜의 환율을 기준으로 Braze에서 USD로 표시됩니다. 대시보드 전환, 캐싱 및 환율 갱신 타이밍에 대한 자세한 내용은 통화 전환을 참조하세요. 전환을 방지하려면 통화 코드를 USD로 설정하여 구매를 기록하세요.

구매 및 매출 기록

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

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

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

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

  1. Product IDPrice 필드는 필수입니다.
  2. Add Row 버튼을 사용하여 구매 속성정보를 추가합니다.

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 값으로 채워진 사전(Dictionary)을 전달하여 구매에 대한 메타데이터를 추가할 수 있습니다.

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

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

사이트에서 표준 이커머스 이벤트 데이터 레이어 항목을 사용하여 Google Tag Manager에 구매를 기록하는 경우, E-commerce Purchase 태그 유형을 사용할 수 있습니다. 이 액션 유형은 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_branditem_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);

수량 추가

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

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!