Intégration de la page de remerciement mobile

La page de remerciement (Thank You Page, TYP) aide les partenaires E-commerce à augmenter la valeur moyenne des commandes en permettant aux acheteurs d'ajouter des produits pertinents à leur commande actuelle sans avoir à ressaisir les informations de paiement. Positionné entre les pages de paiement et de confirmation, ce moment sous-utilisé offre une opportunité idéale pour encourager des achats supplémentaires, car les acheteurs sont très susceptibles de considérer des extras juste après avoir terminé leur transaction principale.

La mise en page de remerciement est une superposition qui apparaît juste avant la page de confirmation, immédiatement après l'action d'achat. Elle sert de dernière opportunité efficace de vente incitative, encourageant les clients à effectuer des achats supplémentaires avant de finaliser leur transaction.

Intégration et initialisation du SDK

Pour intégrer les SDK Rokt dans votre application, veuillez suivre les instructions pour iOS et Android

Affichage du TYP

Pour afficher le TYP dans votre application, vous pouvez utiliser la fonction Rokt.execute qui est démontrée dans la documentation iOS et Android.

Étant donné que vous devez être conscient des interactions des utilisateurs avec un cartItem, vous devez intégrer en utilisant l'équivalent de Rokt.executeWithEvents pour votre plateforme choisie.

Swift

Rokt.executeWithEvents(viewName: viewName,
                       attributes: attributes, 
        		   	   placements: placements,
                       onEvent: { event in
                			if let instancePurchase = event as CartItemInstantPurchase {
							// Avec les détails de l'article du panier, vous devez maintenant traiter la commande et prendre le montant de paiement supplémentaire
            				}
            		   })

SwiftUI

RoktLayout(sdkTriggered: .constant(true),
           viewName: viewName,
           locationName: location,
           attributes: attributes) { roktEvent in
    if let instancePurchase = event as CartItemInstantPurchase {
        cartItemEvent = instancePurchase
        // Avec les détails de l'article du panier, vous devez maintenant traiter la commande et prendre le montant de paiement supplémentaire
    }
}

Kotlin

Rokt.executeWithEvents(
	viewName = viewName,
	attributes = attributes,
	placeholders = placeholders
).collect { event ->
	if (event is CartItemInstantPurchase) {
		// Avec les détails de l'article du panier, vous devez maintenant traiter la commande et prendre le montant de paiement supplémentaire
	}
}

JetpackCompose

RoktLayout(
	sdkTriggered = sdkTriggered,
	viewName = viewName,
	attributes = attributes,
	location = location,
) { event ->
	if (event is CartItemInstantPurchase) {
		// Avec les détails de l'article du panier, vous devez maintenant traiter la commande et prendre le montant de paiement supplémentaire
	}
}

Événement CartItemInstantPurchase

Lorsqu'un utilisateur appuie sur un catalogItem pour l'acheter instantanément sur la page de remerciement, un événement CartItemInstantPurchase sera déclenché avec les données suivantes.

Paramètre	Type	Description
placementId	String	L'identifiant unique du placement associé à l'événement.
cartItemId	String	Un identifiant unique pour l'article du panier.
catalogItemId	String	Un identifiant unique pour l'article du catalogue.
currency	String	Le code de la devise pour le prix de l'article.
description	String	Une brève description de l'article du catalogue sélectionné.
providerData	String	Données supplémentaires fournies par le fournisseur de l'article.
name	String?	Le nom de l'article du catalogue sélectionné par l'utilisateur.
linkedProductId	String?	Un ID reliant l'article à un produit associé, si applicable.
quantity	Decimal?	La quantité de l'article sélectionnée par l'utilisateur.
totalPrice	Decimal?	Le prix total de l'article, calculé comme le prix unitaire multiplié par la quantité.
unitPrice	Decimal?	Le prix unitaire de l'article sélectionné.

Clôturer la boucle

Lorsque vous terminez le flux d'achat et que vous avez mis à jour la commande existante ou créé une nouvelle commande pour l'achat instantané, vous devez appeler Rokt.purchaseFinalized pour clôturer la boucle.

Swift

// Pour placementId, passez le placementId retourné dans l'événement CartItemInstantPurchase
// Pour catalogItemId, passez le catalogItemId retourné dans l'événement CartItemInstantPurchase
// Pour success, passez le résultat de l'achat de l'utilisateur, qu'il ait réussi ou non
Rokt.purchaseFinalized(placementId: placementId, catalogItemId: catalogItemId, success: success)

Kotlin

// Pour placementId, passez le placementId retourné dans l'événement CartItemInstantPurchase
// Pour catalogItemId, passez le catalogItemId retourné dans l'événement CartItemInstantPurchase
// Pour success, passez le résultat de l'achat de l'utilisateur, qu'il ait réussi ou non
Rokt.purchaseFinalized(placementId = placementId, catalogItemId = catalogItemId, success = success)