Last updated 24 oct. 2023

Intégration avec le sandbox

Avec une intégration sandbox, vous pouvez inclure un indicateur de configuration pour tester dans un environnement sandbox. L'environnement sandbox suit un processus normal d'offres, d'enchères et de correspondance par rapport à votre configuration de production. Bien qu'un environnement sandbox fasse partie de l'environnement de production de Rokt, il ne facture pas les annonceurs et ne génère pas de revenus. Par conséquent, vous pouvez l'utiliser pour les tests d'acceptation avant le déploiement en production.

L'intégration suit exactement les mêmes étapes que dans les exemples précédents, avec un attribut supplémentaire sandbox requis dans la fonction execute.

Avertissement

Vous devez supprimer l'attribut sandbox avant de passer en direct avec votre placement.

Exemple de placement de superposition

Pour exécuter un placement de superposition dans l'environnement sandbox, la liste des attributs transmis à Rokt doit être mise à jour pour inclure "sandbox": "true". Cela peut être fait en mettant à jour le code d'exemple de la documentation ajout d'un placement de superposition pour inclure ce qui suit :

Swift

import Rokt_Widget

class OrderConfirmationViewController: UIViewController {
    ...
    // appeler cette fonction lorsque le placement doit être affiché
    func showWidget() {
        let attributes = ["email": "j.smith@example.com",
                "sandbox": "true",
                "firstname": "Jenny",
                "lastname": "Smith",
                "mobile": "(555)867-5309",
                "postcode": "90210",
                "country": "US"]

        Rokt.execute(viewName: "RoktExperience", attributes: attributes, onLoad: {
            // Callback facultatif lorsque le placement Rokt se charge
        }, onUnLoad: {
            // Callback facultatif lorsque le placement Rokt se décharge
        }, onShouldShowLoadingIndicator: {
            // Callback facultatif pour afficher un indicateur de chargement
        }, onShouldHideLoadingIndicator: {
            // Callback facultatif pour masquer un indicateur de chargement
        })
    }
}

Objective-C

#import <Rokt_Widget/Rokt_Widget-Swift.h>
...

// appeler cette fonction lorsque le placement doit être affiché
- (void)showWidget {
    NSDictionary *attributes = @{
        @"email" : @"j.smith@example.com",
        @"sandbox" : @"true",
        @"firstname": @"Jenny",
        @"lastname": @"Smith",
        @"mobile": @"(555)867-5309",
        @"postcode": @"90210",
        @"country": @"US"
    };
    [Rokt executeWithViewName:@"RoktExperience"
                   attributes:attributes
                   placements:nil
                       onLoad:^{
        // Callback facultatif lorsque le placement Rokt se charge
    } onUnLoad:^{
        // Callback facultatif lorsque le placement Rokt se décharge
    } onShouldShowLoadingIndicator:^{
        // Callback facultatif pour afficher un indicateur de chargement
    } onShouldHideLoadingIndicator:^{
        // Callback facultatif pour masquer un indicateur de chargement
    } onEmbeddedSizeChange:^(NSString *selectedPlacement, CGFloat widgetHeight) {
        // Non requis pour la superposition plein écran
    }];
}

Exemple de placement intégré

Pour exécuter un placement intégré dans l'environnement sandbox, vous devez mettre à jour la liste des attributs transmis à Rokt pour inclure "sandbox": "true". Cela peut être fait en mettant à jour le code d'exemple de la documentation ajout d'un placement intégré comme suit :

Swift

import Rokt_Widget
class OrderConfirmationViewController: UIViewController {

   // lié à RoktEmbeddedView créé à l'étape 5 ou il pourrait être créé de manière programmée
    @IBOutlet weak var roktEmbeddedView: RoktEmbeddedView!

    ...

    // appeler cette fonction lorsque le placement doit être affiché
    func showWidget() {
        let attributes = ["email": "j.smith@example.com",
                "sandbox": "true",
                "firstname": "Jenny",
                "lastname": "Smith",
                "mobile": "(555)867-5309",
                "postcode": "90210",
                "country": "US"]

       let placements: [String : RoktEmbeddedView] = ["RoktEmbedded1": roktEmbeddedView]

        Rokt.execute(viewName: "RoktEmbeddedExperience", attributes: attributes, placements: placements, onLoad: {
            // Callback facultatif lorsque le placement Rokt se charge
        }, onUnLoad: {
            // Callback facultatif lorsque le placement Rokt se décharge
        }, onShouldShowLoadingIndicator: {
            // Callback facultatif pour afficher un indicateur de chargement
        }, onShouldHideLoadingIndicator: {
            // Callback facultatif pour masquer un indicateur de chargement
        }, onEmbeddedSizeChange: { selectedPlacement, widgetHeight in
            // Callback facultatif pour obtenir selectedPlacement et la hauteur requise par le placement à chaque fois que la hauteur du placement change
        })
    }
}

Objective-C

#import <Rokt_Widget/Rokt_Widget-Swift.h>

...
// appelez cette fonction lorsque l'emplacement doit être affiché
- (void)showWidget {
    NSDictionary *attributes = @{
        @"email" : @"j.smith@example.com",
        @"sandbox" : @"true",
        @"firstname": @"Jenny",
        @"lastname": @"Smith",
        @"mobile": @"(555)867-5309",
        @"postcode": @"90210",
        @"country": @"US"
    };

    // roktEmbeddedView est @property (weak, nonatomic) IBOutlet RoktEmbeddedView *roktEmbeddedView;  dans .h qui pointe vers roktEmbeddedView défini à l'étape 5 ou il peut être créé de manière programmée
    NSDictionary<NSString *, RoktEmbeddedView *> *placements= [NSDictionary dictionaryWithObject:self.roktEmbeddedView forKey:@"RoktEmbedded1"];

    [Rokt executeWithViewName:@"RoktExperience"
                   attributes:attributes
                   placements:placements
                       onLoad:^{
        // Callback facultatif lorsque l'emplacement Rokt se charge
    } onUnLoad:^{
        // Callback facultatif lorsque l'emplacement Rokt se décharge
    } onShouldShowLoadingIndicator:^{
        // Callback facultatif pour afficher un indicateur de chargement
    } onShouldHideLoadingIndicator:^{
        // Callback facultatif pour masquer un indicateur de chargement
    } onEmbeddedSizeChange:^(NSString *selectedPlacement, CGFloat widgetHeight){
        // Callback facultatif pour obtenir selectedPlacement et la hauteur requise par l'emplacement à chaque fois que la hauteur de l'emplacement change
    }];
}