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

プレースメントを追加

始める前に​

アプリケーションに 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()オーバーレイプレースメントを自動的に閉じるために使用されます。

埋め込みプレースメント​

ストーリーボードを修正する​

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

ストーリーボードにビューを追加し、それをViewControllerに配置します：

ViewController

customクラスで、ビューのクラスとしてRoktEmbeddedViewを設定します。次に、埋め込みプレースメントが表示される場所に一致するように、上、先頭、および末尾の制約を定義します。高さに関しては、高さの制約をゼロにすることをお勧めします。

RoktEmbeddedViewは、プレースメントの内容に応じて自分の高さのみを変更できます。高さが変更されたときに通知し、新しい高さを返すexecuteメソッドにコールバックがあります。

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

  1. ビューのClassとしてRoktEmbeddedViewを、ModuleとしてRokt_Widgetを配置します。

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

  3. 先頭の制約を定義します。

  4. 末尾の制約を定義します。

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

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

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

RoktEmbeddedView

注記

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

Rokt SDKを実行する​

お好みのViewControllerでiOS向けのRokt SDKを実行し、すべての適切なカスタマー属性を追加します。以下のコード例では、ViewDidLoadを使用してプレースメントを起動しています。

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

import Rokt_Widget
class OrderConfirmationViewController: UIViewController {

   // ステップ5で作成されたRoktEmbeddedViewにリンクするか、プログラムで作成
    @IBOutlet weak var roktEmbeddedView: RoktEmbeddedView!

    ...

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

ビュー名 RoktExperience またはプレースメント名 RoktEmbedded1 を異なる値に更新するには、Rokt アカウント マネージャーに連絡して、Roktプレースメントが一貫して構成されるようにしてください。

SwiftUI コンポーネント​

Rokt iOS SDK のメジャーバージョン 4 から、RoktLayout コンポーネントを利用して Rokt レイアウトを追加できます。これにより Rokt.execute を呼び出す必要がなくなり、SwiftUI を使用したよりモダンな宣言的統合がサポートされます。

コンポーネントの追加​

import SwiftUI
import Rokt_Widget

struct OrderConfirmationSwiftUI: View {
    let attributes: [String: String]
    let pageIdentifier: String
    let location: String
    @State var sdkTriggered = true

    var body: some View {
        VStack(alignment: .leading) {

            RoktLayout(sdkTriggered: $sdkTriggered,
                       viewName: pageIdentifier,
                       locationName: location, // 埋め込みレイアウトを使用している場合
                       attributes: attributes,
                       onLoad: {
                // Rokt プレースメントがロードされるときのオプションのコールバック
            }, onUnLoad: {
                // Rokt プレースメントがアンロードされるときのオプションのコールバック
            },onShouldShowLoadingIndicator: {
                // ローディングインジケーターを表示するオプションのコールバック
            }, onShouldHideLoadingIndicator: {
                // ローディングインジケーターを隠すオプションのコールバック
            })

        }.frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .topLeading)
    }
}

注記

RoktLayout コンポーネントは、埋め込みレイアウトとオーバーレイレイアウトの両方に使用できます。

イベント​

SDKは、各ページ上でのイベントをRokt.events APIを通じて提供します。

Rokt.events(viewName: "viewName") { roktEvent in
    print("Roktイベントを受信しました \(roktEvent)")
}

イベントオブジェクト​

イベント説明パラメータ
ShowLoadingIndicatorSDKがRoktのバックエンドを呼び出す前にトリガーされます
HideLoadingIndicatorSDKがRoktのバックエンドから成功または失敗を受信したときにトリガーされます
OfferEngagementユーザーがオファーに関与したときにトリガーされますplacementId: String
PositiveEngagementユーザーがオファーに肯定的に関与したときにトリガーされますplacementId: String
FirstPositiveEngagementユーザーが初めてオファーに肯定的に関与したときにトリガーされますplacementId: String, setFulfillmentAttributes: func (attributes: [String: String])
PlacementInteractiveプレースメントがレンダリングされ、ユーザーが操作可能になったときにトリガーされますplacementId: String
PlacementReadyプレースメントがディスプレイの準備ができているがコンテンツがまだレンダリングされていないときにトリガーされますplacementId: String
PlacementClosedユーザーによってプレースメントがクローズされたときにトリガーされますplacementId: String
PlacementCompletedオファーの進行が終了し、表示するオファーがなくなったときにトリガーされます。
また、キャッシュがヒットしたが、以前に閉じられたため取得されたプレースメントが表示されない場合にもトリガーされます		placementId: String
PlacementFailure何らかの障害によりプレースメントが表示されなかったときにトリガーされますplacementId: String (optional)

コールバック​

Rokt iOS SDK は、execute に渡される以下のコールバックをサポートしています：

onLoad​

onLoad コールバックは、プレースメントがロードされインタラクティブになったときに呼び出されます。このコールバックには引数がなく、返り値もありません。

onShouldShowLoadingIndicator​

onShouldShowLoadingIndicator コールバックは、execute 呼び出しが成功した直後、SDK が Rokt のバックエンドへの呼び出しをトリガーする前に呼び出されます。これにより、プレースメントがロードされるのを待つ間に、ロードインジケーターの進行ビューを表示することができます。このコールバックには引数が不要で、返り値もありません。

注記

このコールバックの動作は、Rokt iOS SDK のメジャーバージョン 3 からメジャーバージョン 4 の間で変更されています。コールバックが実行される前に 1 秒の遅延がなくなりました。メジャーバージョン 3 でこれらのコールバックを使用している場合は、メジャーバージョン 4 にアップグレードした際、ユーザーエクスペリエンスに影響がないか確認するために動作をテストしてください。必要であれば、アプリケーションのニーズに合った遅延動作を作成することができます。

onShouldHideLoadingIndicator​

onShouldHideLoadingIndicator コールバックは、SDK が Rokt バックエンドからの成功または失敗の応答を取得したときに呼び出されます。進捗ビューや読み込みインジケーターをキャンセルするために使用できます。引数は必要なく、値を返しません。

onUnload​

onUnload コールバックは、SDK がプレースメントを閉じたときに呼び出されます。また、execute 呼び出しが失敗した場合にもトリガーされます。引数は必要なく、値を返しません。

onEmbeddedSizeChange​

onEmbeddedSizeChange は、選択された埋め込みプレースメントまたはレイアウトの高さが変更されたときに呼び出されます。選択されたプレースメント/レイアウトと新しい高さに対する引数が含まれていますが、値を返しません。

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