Skip to content

Compras de troncos

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 en todas las fuentes. Esto te permitirá segmentar a los usuarios en función del valor de duración del ciclo de vida utilizando eventos personalizados, atributos personalizados y eventos de compra.

Cualquier moneda distinta al dólar estadounidense (USD) que se informe se mostrará en Braze en USD según la tasa de cambio vigente en la fecha en que se informó. Para evitar la conversión de divisas, codifica la moneda en USD.

Registro de compras e ingresos

Para registrar las compras y los ingresos, llama alogPurchase() después de realizar una compra con éxito en tu aplicación. Si el identificador del producto está vacío, la compra no se registrará en Braze.

Para una implementación estándar del SDK Web, puedes utilizar el siguiente método:

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

Si prefieres utilizar Google Tag Manager, puedes usar el tipo de etiqueta «Compra» para llamar allogPurchasemétodo . Utiliza esta etiqueta para hacer un seguimiento de las compras a Braze, incluyendo opcionalmente las propiedades de la compra. Para hacerlo:

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

Añadir propiedades

Puedes añadir metadatos sobre las compras pasando un Diccionario rellenado con los valores Int, Double, String, Bool, o Date.

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 en Google Tag Manager, 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
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);

Añadir cantidad

De forma predeterminada,quantity está configurado en 1. Sin embargo, puedes añadir una cantidad a tus compras si los clientes realizan la misma compra varias veces en un solo proceso de pago. Para añadir una cantidad, pasa unIntvalor a quantity.

Uso de la API REST

También puedes utilizar nuestra API REST para registrar las compras. Para obtener 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

Monedas admitidas

El soporte de Braze admite los siguientes símbolos monetarios. Cualquier otro símbolo monetario que proporciones generará una advertencia y la compra no se registrará en 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
New Stuff!