Registro de compras para iOS

Registre as compras no app para poder rastrear sua receita ao longo do tempo e entre as fontes de receita e segmentar seus usuários pelo valor do tempo de vida deles.

O Braze oferece suporte a compras em várias moedas. As compras informadas em uma moeda diferente do dólar americano serão mostradas no dashboard em dólares americanos com base na taxa de câmbio na data em que foram informadas.

Antes da implementação, não deixe de analisar exemplos das opções de segmentação oferecidas por eventos personalizados, atributos personalizados e eventos de compra em nossas práticas recomendadas, bem como nossas notas sobre convenções de nomenclatura de eventos.

Rastreamento de compras e receitas

Para usar esse recurso, adicione essa chamada de método após uma compra bem-sucedida em seu app:

• objective c
• swift

1
2
3
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"))

• Os símbolos de moeda compatíveis incluem: USD, CAD, EUR, GBP, JPY, AUD, CHF, NOK, MXN, NZD, CNY, RUB, TRY, INR, IDR, ILS, SAR, ZAR, AED, SEK, HKD, SPD, DKK e muito mais.
  • Qualquer outro símbolo de moeda fornecido resultará em um aviso registrado e nenhuma outra ação será realizada pelo SDK.
• A ID do produto pode ter no máximo 255 caracteres
• Note que se o identificador do produto estiver vazio, a compra não será registrada na Braze.

Adição de propriedades

Você pode adicionar metadados sobre as compras transmitindo uma matriz de propriedades de eventos ou transmitindo um NSDictionary preenchido com os valores NSNumber, NSString ou NSDate.

Para obter mais detalhes, consulte a documentação da classe iOSlogpurchase.

Adição de quantidade

Você pode adicionar uma quantidade às suas compras se os clientes fizerem a mesma compra várias vezes em um único checkout. Você pode fazer isso passando um NSUInteger para a quantidade.

• Uma entrada de quantidade precisa estar no intervalo de [0, 100] para que o SDK registre uma compra.
• Os métodos sem uma entrada de quantidade terão um valor de quantidade padrão de 1.
• Os métodos com uma entrada de quantidade não têm valor padrão e devem receber uma entrada de quantidade para que o SDK registre uma compra.

Consulte a documentação da classe iOSlogpurchase para obter mais detalhes.

• objective c
• swift

1
2
3
4
[[Appboy sharedInstance] logPurchase:@"your product ID"
inCurrency:@"USD"
atPrice:[[[NSDecimalNumber alloc] initWithString:@"0.99"] autorelease]
withProperties:@{@"key1":"value1"}];

1
Appboy.sharedInstance()?.logPurchase("your product ID", inCurrency: "USD", atPrice: NSDecimalNumber(string: "0.99"), withProperties: ["key1":"value1"])

Registre as compras no nível do pedido

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

API REST

Também é possível usar nossa API REST para registrar compras. Consulte a documentação da API do usuário para obter detalhes.