サンドボックスとの統合 (レガシー)

サンドボックス統合を使用すると、サンドボックス環境に対してテストするための設定フラグを含めることができます。サンドボックス環境は、通常のオファー、入札、マッチングプロセスを本番環境の設定に対して行います。サンドボックス環境は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) {
        // フルスクリーンオーバーレイには必要ありません
    }];
}

#```markdown

埋め込み配置の例

サンドボックス環境で埋め込み配置を実行するには、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
            // 配置の高さが変わるたびにselectedPlacementと配置に必要な高さを取得するためのオプションのコールバック
        })
    }
}

#
``````objective-c
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 は @property (weak, nonatomic) IBOutlet RoktEmbeddedView *roktEmbeddedView;  .h 内で定義されており、ステップ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){
        // プレースメントの高さが変わるたびに、selectedPlacement とプレースメントに必要な高さを取得するためのオプションのコールバック
    }];
}

オーバーレイ配置の例​

埋め込み配置の例

オーバーレイ配置の例