Skip to content

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.

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:

  1. Os campos ID do produto e Preço são obrigatórios.
  2. Use o botão Adicionar linha para adicionar propriedades de compra.

Uma caixa de diálogo mostrando as definições de configuração da tag de ação do Braze. As configurações incluídas são "tag type" (tipo de tag), "external ID" (ID externa), "price" (preço), "currency code" (código de moeda), "quantity" (quantidade) e "purchase properties" (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);

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
QUÃO ÚTIL FOI ESTA PÁGINA?
New Stuff!