メインコンテンツまでスキップ

プレースメントを追加する

開始する前に​

Rokt iOS SDKがすでにアプリケーションに統合されていることを確認してください。ここに記載されている手順に従って統合してください。

オーバーレイプレースメント​

Rokt iOS SDKを使用して、必要なViewControllerで実行し、すべての適切なカスタマーアトリビュートを追加してください。以下の例コードでは、ViewDidLoadを使用してRoktのオーバーレイプレースメントを表示しています。

SDKは、ビューの読み込みとアンロード時のオプションのコールバックイベントを提供します。

import Rokt_Widget

class OrderConfirmationViewController: UIViewController {
    
    // プレースメントを表示する必要がある場合にこの関数を呼び出します
    func showWidget() {
        let attributes = ["email": "j.smith@example.com",
                "firstname": "Jenny",
                "lastname": "Smith",
                "mobile": "(555)867-5309",
                "postcode": "90210",
                "country": "US"]

        Rokt.execute(viewName: "RoktExperience", attributes: attributes, onLoad: {
            // Roktプレースメントがロードされたときのオプションのコールバック
        }, onUnLoad: {
            // Roktプレースメントがアンロードされたときのオプションのコールバック
        }, onShouldShowLoadingIndicator: {
            // ローディングインジケータを表示するためのオプションのコールバック
        }, onShouldHideLoadingIndicator: {
            // ローディングインジケータを非表示にするためのオプションのコールバック
        })
    }
}

オプションの関数​

関数目的
Rokt.close()オーバーレイ配置を自動的に閉じるために使用されます。

埋め込み配置​

Storyboardの変更​

SwiftUIを使用している場合は、以下のSwiftUIテーブルの指示に従ってください。SwiftUIを使用していない場合は、以下の指示を使用してください。

Storyboardでビューを追加し、それをViewControllerに配置します。

ViewController

customクラスで、ビューのクラスをRoktEmbeddedViewに設定します。次に、埋め込み配置が表示される場所に対応する上部、左側、および右側の制約を定義します。高さについては、高さの制約をゼロに追加することを推奨します。

RoktEmbeddedViewは、配置のコンテンツに基づいて自身の高さのみを変更できます。executeメソッドには、高さが変更されたときに通知するためのコールバックがあります。

以下の画像は、オートレイアウトを使用してRoktEmbeddedViewを定義する最も簡単な方法を示しています。

  1. ビューのクラスにRoktEmbeddedViewを配置し、モジュールにRokt_Widgetを設定します。

  2. 上部の制約を定義します。

  3. 左側の制約を定義します。

  4. 右側の制約を定義します。

  5. 高さと幅の制約を選択します。

  6. 高さの制約を設定します。

  7. ビューに制約を追加します。

RoktEmbeddedView

注記

RoktEmbeddedViewは、コードで作成し、レイアウトに動的に含めることもできます。

Rokt SDKの実行​

Rokt SDKをiOSの希望するViewControllerで実行し、適切な顧客属性をすべて追加します。以下の例のコードでは、ViewDidLoadを使用して配置を起動しています。

SDKには、ビューがロードされたときとアンロードされたときのオプションのコールバックイベントが用意されています。

import Rokt_Widget
class OrderConfirmationViewController: UIViewController {

   // RoktEmbeddedViewとリンクしています。ステップ5で作成されたものか、プログラムで作成されたものです。
    @IBOutlet weak var roktEmbeddedView: RoktEmbeddedView!

    ...

    // placementを表示する必要がある場合にこの関数を呼び出します。
    func showWidget() {
        let attributes = ["email": "j.smith@example.com",
                "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 placementがロードされたときのオプションのコールバック
        }, onUnLoad: {
            // Rokt placementがアンロードされたときのオプションのコールバック
        }, onShouldShowLoadingIndicator: {
            // ローディングインジケータを表示するためのオプションのコールバック
        }, onShouldHideLoadingIndicator: {
            // ローディングインジケータを非表示にするためのオプションのコールバック
        }, onEmbeddedSizeChange: { selectedPlacement, widgetHeight in
            // placementの高さが変更されるたびに、選択されたplacementと必要な高さを取得するためのオプションのコールバック
        })
    }
}
注記

ビュー名 RoktExperience または配置名 RoktEmbedded1 を別の値で更新するには、Roktアカウントマネージャーに連絡して、Rokt配置が一貫して設定されていることを確認してください。

この記事は役に立ちましたか？