Last updated 2023年9月12日

サンドボックスとの統合

サンドボックスの統合では、サンドボックス環境でテストするための設定フラグを含めることができます。サンドボックス環境は、本番の設定に対して通常のオファー、入札、マッチングプロセスを実行します。サンドボックス環境はRoktの本番環境の一部ですが、広告主に料金を請求したり収益を生成したりしません。そのため、本番環境に展開する前の受け入れテストに使用することができます。

この統合は、以前の例とまったく同じ手順に従いますが、execute関数にsandbox属性が追加される必要があります。

注意

配置を本番環境で公開する前に、sandbox属性を削除する必要があります。

オーバーレイ配置の例

サンドボックス環境でオーバーレイ配置を実行するには、Roktに渡される属性のリストを更新して"sandbox": "true"を含める必要があります。これは、オーバーレイ配置の追加のドキュメントからのサンプルコードを以下のように更新することで行うことができます:

Swift
Objective-C

import Rokt_Widget

class OrderConfirmationViewController: UIViewController {
    ...
    // プレースメントを表示する必要がある場合にこの関数を呼び出します
    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: {
            // Roktプレースメントが読み込まれたときのオプションのコールバック
        }, onUnLoad: {
            // Roktプレースメントがアンロードされたときのオプションのコールバック
        }, onShouldShowLoadingIndicator: {
            // ローディングインジケータを表示するためのオプションのコールバック
        }, onShouldHideLoadingIndicator: {
            // ローディングインジケータを非表示にするためのオプションのコールバック
        })
    }
}

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

// プレースメントを表示する必要がある場合にこの関数を呼び出します
- (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:^{
        // Roktプレースメントが読み込まれたときのオプションのコールバック
    } onUnLoad:^{
        // Roktプレースメントがアンロードされたときのオプションのコールバック
    } onShouldShowLoadingIndicator:^{
        // ローディングインジケータを表示するためのオプションのコールバック
    } onShouldHideLoadingIndicator:^{
        // ローディングインジケータを非表示にするためのオプションのコールバック
    } onEmbeddedSizeChange:^(NSString *selectedPlacement, CGFloat widgetHeight) {
        // フルスクリーンオーバーレイでは必要ありません
    }];
}

埋め込み配置の例

サンドボックス環境で埋め込み配置を実行するには、Roktに渡される属性のリストに"sandbox": "true"を含める必要があります。これは、埋め込み配置の追加のドキュメントからサンプルコードを以下のように更新することで行うことができます。

Swift
Objective-C

import Rokt_Widget
class OrderConfirmationViewController: UIViewController {

   // ステップ5で作成されたRoktEmbeddedViewにリンクされているか、プログラムで作成される可能性があります
    @IBOutlet weak var roktEmbeddedView: RoktEmbeddedView!

    ...

    // 配置を表示する必要がある場合にこの関数を呼び出します
    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: {
            // Rokt配置が読み込まれたときのオプションのコールバック
        }, onUnLoad: {
            // Rokt配置がアンロードされたときのオプションのコールバック
        }, onShouldShowLoadingIndicator: {
            // ローディングインジケータを表示するためのオプションのコールバック
        }, onShouldHideLoadingIndicator: {
            // ローディングインジケータを非表示にするためのオプションのコールバック
        }, onEmbeddedSizeChange: { selectedPlacement, widgetHeight in
            // 配置の高さが変更されるたびに、選択された配置と配置に必要な高さを取得するためのオプションのコールバック
        })
    }
}

#import <Rokt_Widget/Rokt_Widget-Swift.h>

...
// 配置を表示する必要がある場合にこの関数を呼び出します
- (void)showWidget {
    NSDictionary *attributes = @{
        @"email" : @"j.smith@example.com",
        @"sandbox" : @"true",
        @"firstname": @"Jenny",
        @"lastname": @"Smith",
        @"mobile": @"(555)867-5309",
        @"postcode": @"90210",
        @"country": @"US"
    };

    // roktEmbeddedViewは.hで定義された@property (weak, nonatomic) IBOutlet RoktEmbeddedView *roktEmbeddedView;で、ステップ5で定義されたroktEmbeddedViewを指します。またはプログラムで作成される可能性があります
    NSDictionary<NSString *, RoktEmbeddedView *> *placements= [NSDictionary dictionaryWithObject:self.roktEmbeddedView forKey:@"RoktEmbedded1"];

    [Rokt executeWithViewName:@"RoktExperience"
                   attributes:attributes
                   placements:placements
                       onLoad:^{
        // Rokt配置が読み込まれたときのオプションのコールバック
    } onUnLoad:^{
        // Rokt配置がアンロードされたときのオプションのコールバック
    } onShouldShowLoadingIndicator:^{
        // ローディングインジケータを表示するためのオプションのコールバック
    } onShouldHideLoadingIndicator:^{
        // ローディングインジケータを非表示にするためのオプションのコールバック
    } onEmbeddedSizeChange:^(NSString *selectedPlacement, CGFloat widgetHeight){
        // 配置の高さが変更されるたびに、選択された配置と配置に必要な高さを取得するためのオプションのコールバック
    }];
}

オーバーレイ配置の例​

埋め込み配置の例​

オーバーレイ配置の例

埋め込み配置の例