O evento "Notificar evento de compra realizada" serve para descrever uma compra realizada pelo cliente. Para isso, notifica, via Mobile SDK, quando um usuário realiza uma compra utilizando o método sendPurchase.
Como usar
A notificação das informações da compra utiliza o método Connectif.sendPurchase(purchase: Purchase), no qual adicionamos a propriedade purchase com todas as informações da compra.
Notificar a compra realizada
Este objeto representa o modelo do Carrinho de Compras, que inclui as seguintes propriedades:
| Nome | Obrigatória | Tipo | Descrição |
|---|---|---|---|
| purchaseId | Sim | String | Identificador único da compra. |
| cartId | Sim | String | Identificador único do carrinho de onde se originou essa compra. |
| totalQuantity | Sim | Int | Quantidade total de produtos na compra (incluindo duplicados). |
| totalPrice | Sim | Decimal | Valor total da compra. |
| purchaseDate | Não | Date | Data da compra. |
| paymentMethod | Não | String | Método de pagamento. |
| products | Sim | Product Basket Item | Produtos incluídos na compra, com suas quantidades e valores. |
| source_name | Não | String | Nome da origem, para fornecer contexto sobre o tipo de canal de compra. |
| source_type | Não | String | Nome da origem da compra. Os valores possíveis são: "marketplace", "digital-store", "point-of-sale", "third-party" e "other". |
Organização dos valores da origem (source_type)
Abaixo estão descritos os significados de cada um dos valores do campo source_type:
| Valor | Descrição | Exemplo |
|---|---|---|
| marketplace | Plataformas de e-commerce de terceiros onde você publica seus produtos. | Amazon Marketplace, eBay, Zalando… |
| digital-store | Vendas realizadas no site ou aplicativo próprio do varejista. | Direto, busca orgânica, busca paga, email marketing… |
| pont-of-sale | Vendas em lojas físicas processadas por sistema de PDV. | Caixa da loja, quiosque, lojas pop-up… |
| third-party | Vendas por distribuidores, varejistas ou redes parceiras (não marketplaces). | Atacado, Distribuidores, Afiliados… |
| other | Casos especiais ou canais não previstos nas demais categorias. | Televendas, feiras, redes sociais… |
Este tipo de evento coleta automaticamente as seguintes informações:
- Sistema operacional: Android ou iOS.
- Versão do aplicativo.
- Versão do sistema operacional.
- Versão do SDK da Connectif.
Exemplo
A notificação terá o seguinte formato:
let productBasketItem = ProductBasketItem(
productDetailUrl: "https://example.com/product/12345",
productId: "59a31949a1a562d4979fbca2",
name: "Example Product",
unitPrice: Decimal(51.88),
description: "This is an example product",
imageUrl: "https://example.com/product/images/12345.jpg",
categories: ["Electronics", "Gadgets"],
tags: ["Trending", "New Arrival"],
brand: "ExampleBrand",
reviewCount: 150,
rating: Decimal(4.5),
ratingCount: 124,
thumbnailUrl: "https://example.com/product/thumbnails/12345.jpg",
unitPriceOriginal: Decimal(120.00),
unitPriceWithoutVAT: Decimal(80.00),
discountedAmount: Decimal(20.00),
discountedPercentage: Decimal(16.67),
publishedAt: Date(),
customField1: "Special Edition",
customField2: "Limited Stock",
customField3: "Online Only",
quantity: 1,
price: Decimal(51.88)
)
let purchase = Purchase(
purchaseId: "purchase-e3418b5a-8709-4593-a7c8-d8a7f12df737",
products: [productBasketItem],
totalQuantity: 1,
totalPrice: Decimal(51.88),
cartId: "cart-0098caf9-42f4-44e9-afdd-45eafe892293",
paymentMethod: "Credit Card",
purchaseDate: Date()
)
Connectif.sendPurchase(purchase)
Callbacks (Opcional)
Se quiser obter retorno sobre possíveis erros ao enviar eventos, você pode adicionar EventCallbacks ao utilizar o método.
EventCallbacks(
onSuccess: {
// Sucesso
},
onError: { error in
// Erro
})Parabéns!
Você chegou ao final da lição.
Ficou com alguma dúvida?
Lembre-se de que você pode contar com nossos especialistas Connectif. Para entrar em contato, basta abrir um ticket clicando no botão azul de "Ajuda" no seu dashboard.
Continue aprendendo!
Para aproveitar ao máximo sua conta Connectif, recomendamos os seguintes artigos:
- Introdução ao SDK Android, para adicionar o Connectif Mobile SDK ao seu projeto Android.
- Configuração do Firebase Cloud Messaging, para ativar o envio e recebimento de push no SDK Android.
- Introdução ao SDK iOS, para adicionar o Connectif Mobile SDK ao seu projeto iOS.
- Configuração do Apple Push Notification Service, para ativar push no SDK iOS.