Skip to content

Registrar compras

Aprende a registrar las compras dentro de la aplicación a través del SDK de Braze, para que puedas determinar tus ingresos a lo largo del tiempo y a través de distintas fuentes. Esto te permitirá segmentar a los usuarios en función de su valor de duración utilizando eventos personalizados, atributos personalizados y eventos de compra.

Compras e ingresos por tala de árboles

Para registrar las compras y los ingresos, llama a logPurchase() después de una compra exitosa en tu aplicación. Si el identificador del producto está vacío, la compra no se registrará en 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 una implementación estándar del SDK Web, puedes utilizar el siguiente método:

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

Si quieres utilizar Google Tag Manager en su lugar, puedes utilizar el tipo de etiqueta Compra para llamar al métodologPurchase . Utiliza esta etiqueta para hacer un seguimiento de las compras a Braze, incluyendo opcionalmente las propiedades de la compra. Para ello:

  1. Los campos ID de producto y Precio son obligatorios.
  2. Utiliza el botón Añadir fila para añadir propiedades de la compra.

Un cuadro de diálogo que muestra los ajustes de configuración de la etiqueta de acción Braze. Las configuraciones incluidas son "tipo de etiqueta", "ID externo", "precio", "código de moneda", "cantidad" y "propiedades de la 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);

Añadir propiedades

Puedes añadir metadatos sobre las compras pasando un Diccionario rellenado con los valores Int, Double, String, Bool, o 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 una implementación estándar del SDK Web, puedes utilizar el siguiente método:

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

Si tu sitio registra las compras utilizando el elemento estándar de la capa de datos de eventos de comercio electrónico de Google Tag Manager, entonces puedes utilizar el tipo de etiqueta Compra de comercio electrónico. Este tipo de acción registrará una “compra” separada en Braze para cada artículo enviado en la lista de items.

También puedes especificar nombres de propiedades adicionales que quieras incluir como propiedades de la compra especificando sus claves en la lista Propiedades de la compra. Ten en cuenta que Braze buscará en el item individual que se está registrando cualquier propiedad de la compra que añadas a la lista.

Por ejemplo, dada la siguiente carga útil de comercio electró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
}]

Si sólo quieres que item_brand y item_name se pasen como propiedades de la compra, sólo tienes que añadir esos dos campos a la tabla de propiedades de la compra. Si no proporcionas ninguna propiedad, no se enviará ninguna propiedad de la compra en la logPurchase llamada a 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);

Añadir cantidad

Por predeterminado, quantity está configurado como 1. Sin embargo, puedes añadir una cantidad a tus compras si los clientes realizan la misma compra varias veces en un mismo proceso de pago. Para añadir una cantidad, pasa un valor Int a quantity que esté dentro del rango de [0, 100].

Utilizar la API REST

También puedes utilizar nuestra API REST para registrar las compras. Para más información, consulta Puntos finales de datos de usuario.

Registro de pedidos

Si quieres registrar las compras a nivel de pedido en lugar de a nivel de producto, puedes utilizar el nombre del pedido o la categoría del pedido como product_id. Consulta nuestra especificación del objeto de compra para obtener más información.

Claves reservadas

Las siguientes claves están reservadas y no pueden utilizarse como propiedades de la compra:

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

Divisas admitidas

Estos son los símbolos de moneda admitidos. Cualquier otro símbolo de moneda que proporciones registrará una advertencia y la compra no se registrará en 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É TAN ÚTIL FUE ESTA PÁGINA?
New Stuff!