Registrar compras

Aprenda como registrar compras no app através do SDK da Braze, para que você possa determinar sua receita ao longo do tempo e entre diferentes fontes. Isso permitirá que você segmente usuários com base no lifetime value deles usando eventos personalizados, atributos personalizados e eventos de compra.

Nota

Para wrapper SDKs não listados, use o método nativo relevante do Android ou Swift.

Qualquer moeda diferente de USD reportada será exibida na Braze em USD com base na taxa de câmbio na data em que foi reportada. Para evitar a 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 na 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));

Aviso

productID pode ter no máximo 255 caracteres. Além disso, se o identificador do produto estiver vazio, a compra não será registrada na Braze.

Adição de propriedades

Você pode adicionar metadados sobre compras passando um dicionário preenchido com 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 REST API

Também é possível usar nossa REST API para registrar compras. Para saber mais, consulte Endpoints de dados de usuários.

Registro de pedidos

Se quiser registrar compras no nível do pedido em vez de no nível do produto, você pode 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