プレースメントの追加
Rokt SDK for Flutterを使用して、アプリのコンテンツの上にオーバーレイプレースメントを表示することができます。
開始する前に
Rokt Flutter SDKがすでにアプリに統合されていることを確認してください。
オーバーレイプレースメント
SDKのインポート
アプリのdartファイルにSDKをインポートします:
import 'package:rokt_sdk/rokt_sdk.dart';
SDKの実行
適切な顧客属性を追加することで、SDKを任意のポイントで実行します。Roktの配置は、Roktプラットフォームを介して設定可能な短い遅延の後に表示されます。
Roktの統合に含める顧客属性を指定することができます。利用可能なデータフィールドの詳細については、attributes ページを参照してください。さらに属性を統合したい場合は、以下のサンプルコードに新しい属性ごとに追加のコード行を追加することができます。
void executeRokt() {
// RoktExperienceを自分のviewNameに置き換えてください
RoktSdk.execute(
viewName: "RoktExperience",
attributes: {"email": "j.smith@example.com",
"firstname": "Jenny",
"lastname": "Smith",
"mobile": "(555)867-5309",
"postcode": "90210",
"country": "US"},
onLoad: () {
// Roktの配置が読み込まれたときのオプションのコールバック
},
onUnLoad: () {
// Roktの配置がアンロードされたときのオプションのコールバック
},
onShouldShowLoadingIndicator: () {
// ローディングインジケータを表示するためのオプションのコールバック
},
onShouldHideLoadingIndicator: () {
// ローディングインジケータを非表示にするためのオプションのコールバック
});
}
SDKを複数の場所で実行する際に、ViewName
("RoktExperience")を変更して、SDKが実行されるアプリ内のコンテキストに応じた異なるエクスペリエンスを表示することができます。ViewNameを変更する場合は、Roktチームと連携して、Roktシステム内での適切な調整が行われるようにしてください。
埋め込みプレースメント
SDKのインポート
JavaScriptファイルにRokt SDKをインポートします:
import 'package:rokt_sdk/rokt_sdk.dart';
ビューにRoktWidgetを追加する
ビューのbuild
関数にRoktWidget
を追加します。execute
メソッドが呼び出されると、Roktウィジェットがこのプレースホルダに注入されます:
const RoktWidget(placeholderName: "RoktEmbedded1")
ビューが画面上の表示領域に作成されていることを確認し、その後にshowWidgetを呼び出してください。
RoktWidget
には、ウィジェットが作成されたときに通知するためのコールバックがあります。
RoktWidget(placeholderName: "RoktEmbedded1", onWidgetCreated: () { showWidget() })
Rokt Flutter SDKの実行
適切なタイミングでSDKを実行し、適切な顧客属性を送信してください。Roktプレースメントは、Roktプラットフォームを介して設定可能な短い遅延の後に表示されます。
Roktの統合に含める顧客属性を指定することができます。使用可能なデータフィールドの詳細については、attributesページを参照してください。さらに属性を統合する場合は、以下のサンプルに新しい属性ごとに追加のコード行を追加できます。
void executeRokt() {
// RoktExperienceをviewNameに置き換えてください
RoktSdk.execute(
viewName: "RoktEmbeddedExperience",
attributes: {"email": "j.smith@example.com",
"firstname": "Jenny",
"lastname": "Smith",
"mobile": "(555)867-5309",
"postcode": "90210",
"country": "US"},
onLoad: () {
// Roktプレースメントがロードされたときのオプションのコールバック
},
onUnLoad: () {
// Roktプレースメントがアンロードされたときのオプションのコールバック
},
onShouldShowLoadingIndicator: () {
// ローディングインジケータを表示するためのオプションのコールバック
},
onShouldHideLoadingIndicator: () {
// ローディングインジケータを非表示にするためのオプションのコールバック
});
}
SDKを複数の場所で実行する際には、ViewName
(「RoktEmbeddedExperience」)を変更することができます。この設定により、SDKが実行されるアプリのコンテキストに応じて異なる体験を表示することができます。ViewName
またはplaceholderName
(「RoktEmbedded1」)を変更する場合は、Roktチームと連携して、Roktシステム内での適切な調整が行われるようにしてください。