Registro de compras
Saiba como registrar as compras no aplicativo por meio do Braze SDK, para que possa determinar sua receita ao longo do tempo e entre as fontes. Isso permitirá segmentar os usuários com base no valor do tempo de vida deles usando eventos personalizados, atributos personalizados e eventos de compra.
note:
Para SDKs de wrapper não listados, use o método nativo relevante do Android ou Swift.
Registro de compras e receitas
Para registrar compras e receitas, ligue para logPurchase()
após uma compra bem-sucedida no seu app. Se o identificador do produto estiver vazio, a compra não será registrada no Braze.
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];
|
Para uma implementação padrão do Web SDK, você pode usar o seguinte método:
1
| braze.logPurchase(product_id, price, "USD", quantity);
|
Se, em vez disso, você quiser usar o Google Tag Manager, poderá usar o tipo de tag Purchase para chamar o métodologPurchase
. Use essa tag para rastrear as compras no Braze, incluindo opcionalmente as propriedades de compra. Para isso:
- Os campos ID do produto e Preço são obrigatórios.
- Use o botão Adicionar linha para adicionar propriedades de compra.

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));
|
1
| UBraze->LogPurchase(TEXT("product_id"), TEXT("USD"), price, quantity);
|
warning:
productID
só pode ter um máximo de 255 caracteres. Além disso, se o identificador do produto estiver vazio, a compra não será registrada no Braze.
Adição de propriedades
Você pode adicionar metadados sobre compras passando um Dicionário preenchido com os valores Int
, Double
, String
, Bool
, ou Date
.
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];
|
Para uma implementação padrão do Web SDK, você pode usar o seguinte método:
1
| braze.logPurchase(product_id, price, "USD", quantity, {key: "value"});
|
Se o seu site registra compras usando o item padrão da camada de dados de eventos de comércio eletrônico para o Google Tag Manager, é possível usar o tipo de tag E-commerce Purchase. Esse tipo de ação registrará uma “compra” separada no Braze para cada item enviado na lista de items
.
Você também pode especificar nomes de propriedades adicionais que deseja incluir como propriedades de compra, especificando suas chaves na lista Propriedades de compra. Note que o Braze procurará no site item
individual que está sendo registrado todas as propriedades de compra que você adicionar à lista.
Por exemplo, dada a seguinte carga útil de comércio eletrônico:
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
}]
|
Se você quiser que apenas item_brand
e item_name
sejam passados como propriedades de compra, basta adicionar esses dois campos à tabela de propriedades de compra. Se você não fornecer nenhuma propriedade, nenhuma propriedade de compra será enviada na logPurchase
chamada para o Braze.
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);
|
1
2
3
4
| TMap<FString, FString> PurchaseProperties;
PurchaseProperties.Add(TEXT("key"), TEXT("value"));
UBraze->LogPurchaseWithProperties(TEXT("product_id"), TEXT("USD"), price, quantity, 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 de Int
para quantity
que esteja dentro do intervalo de [0, 100]
.
Usando a API REST
Também é possível usar nossa API REST para registrar compras. Para saber mais, consulte Pontos de extremidade de dados de usuários.
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
Esses são os símbolos de moeda compatíveis. Qualquer outro símbolo de moeda que você fornecer registrará um aviso e a compra não será registrada no Braze.
USD
CAD
EUR
GBP
JPY
AUD
CHF
NOK
MXN
NZD
CNY
RUB
TRY
INR
IDR
ILS
SAR
ZAR
AED
SEK
HKD
SPD
DKK