Aviso

AppboyKit (também conhecido como o SDK Objective-C) não é mais suportado e foi substituído pelo Swift SDK. Não receberá mais novos recursos, correções de bugs, atualizações de segurança ou suporte técnico—no entanto, o envio de mensagens e a análise de dados continuarão a funcionar normalmente. Para saber mais, veja Apresentando o Novo SDK Braze Swift.

Registrar compras para iOS

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

A 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, entre outros.
  • Qualquer outro símbolo de moeda fornecido resultará em um aviso registrado, sem nenhuma outra ação realizada pelo SDK.
• O identificador do produto pode ter no máximo 255 caracteres.
• Observe que, se o identificador do produto estiver vazio, a compra não será registrada na Braze.

Adicionando propriedades

Você pode adicionar metadados sobre compras passando um vetor de propriedades de evento ou passando um NSDictionary preenchido com valores NSNumber, NSString ou NSDate.

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

Adicionando quantidade

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

• O valor de quantidade deve estar no intervalo de [0, 100] para que o SDK registre a compra.
• Os métodos sem entrada de quantidade terão um valor padrão de 1.
• Os métodos com entrada de quantidade não possuem valor padrão e devem receber um valor de quantidade para que o SDK registre a compra.

Consulte a documentação da classe iOS para 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"])

Dica

Se você passar um valor de 10 USD e uma quantidade de 3, isso será registrado no perfil do usuário como três compras de 10 dólares, totalizando 30 dólares.

Registrar compras no nível do pedido

Se você deseja registrar compras no nível do pedido em vez do nível do produto, pode usar o nome do pedido ou a categoria do pedido como product_id. Consulte nossa especificação do 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

REST API

Você também pode usar nossa REST API para registrar compras. Consulte a documentação da API de usuário para mais detalhes.