Registrar compras

Aprenda como registrar compras dentro do app através do SDK Braze, para que você possa determinar sua receita ao longo do tempo e em diferentes fontes. Isso permitirá que você segmente usuários com base em seu valor do tempo de vida usando eventos personalizados, atributos personalizados e eventos de compra.

Qualquer moeda que não seja USD reportada será exibida no Braze em USD com base na taxa de câmbio na data em que foi reportada. Para evitar conversão de moeda, defina a moeda como USD.

Registrando compras e receita

Para registrar compras e receita, chame logPurchase() após uma compra bem-sucedida em seu app. Se o identificador do produto estiver vazio, a compra não será registrada no Braze.

• web
• android
• swift
• cordova
• flutter
• react native
• roku
• unity

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

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));

Adição de propriedades

Você pode adicionar metadados sobre compras passando um Dicionário preenchido com os valores Int, Double, String, Bool, ou Date.

• web
• android
• swift
• cordova
• flutter
• react native
• roku
• unity

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

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
}]

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);

Adição de quantidade

Por padrão, quantity é definido como 1. No entanto, você pode adicionar uma quantidade às suas compras se os clientes fizerem a mesma compra várias vezes em um único checkout. Para adicionar uma quantidade, passe um valor Int para quantity.

Usando a API REST

Também é possível usar nossa API REST para registrar compras. Para mais informações, consulte User Data Endpoints.

Registro de pedidos

Se quiser registrar as compras no nível do pedido em vez de no nível do produto, poderá usar o nome do pedido ou a categoria do pedido como product_id. Consulte nossa especificação de objeto de compra para saber mais.

Chaves reservadas

As seguintes chaves são reservadas e não podem ser usadas como propriedades de compra:

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

Moedas suportadas

A Braze suporta os seguintes símbolos de moeda. Qualquer outro símbolo de moeda que você fornecer registra um aviso e a compra não é registrada na 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