Esta página fue traducida automáticamente y puede contener errores. Para reportar un error de traducción,
abre un issue en GitHub.
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.
note:
Para los SDK de envoltura que no aparecen en la lista, utiliza el método nativo de Android o SWIFT correspondiente.
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:
- Los campos ID de producto y Precio son obligatorios.
- Utiliza el botón Añadir fila para añadir 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));
|
warning:
productID solo puede tener un máximo de 255 caracteres. Además, si el identificador del producto está vacío, la compra no se registrará en Braze.
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