Last updated 2024年12月5日

プレースメントの追加

Rokt Cordova SDKは、Roktパートナーによってオーバーレイプレースメントを表示するために、またRokt広告主によってキャンペーンのコンバージョンを記録するために使用されます。

開始する前に

Rokt Cordova SDKが統合されていることを確認してください。

Rokt Cordova SDKを実行する

execute Rokt Cordova SDKを実行して、プレースメントを表示します。 successCallbackは、SDKイベントを追跡するためにメッセージパラメータを返します。

RoktSDK.execute(
    "RoktExperience",
    {
        "email" : "j.smith@example.com",
        "firstname": "Ginger",
        "lastname": "Smith",
        "mobile": "(555)867-5309",
        "postcode": "90210",
        "country": "US"
    },
    function(msg) {
        console.log(msg);
        
        // msgはこれらのいずれかである可能性があります
        // 1. onLoad - プレースメントがロードされました
        // 2. onUnload - プレースメントがアンロードされました
        // 3. onShouldHideLoadingIndicator - ローディングインジケーターを表示するためのフック
        // 4. onShouldShowLoadingIndicator - ローディングインジケーターを隠すためのフック
    },
    function(err) {
        console.log(err);
    }
);

コールバック

Rokt Cordova SDKは、Cordova Plugin Resultsを介してコールバックをサポートしています。execute関数に渡された関数内でコールバック値をリッスンできます:

RoktSDK.execute(
    "RoktExperience",
    {
        "email" : "j.smith@example.com",
        "firstname": "Ginger",
        "lastname": "Smith",
        "mobile": "(555)867-5309",
        "postcode": "90210",
        "country": "US"
    },
    function(callbackValue) {
        switch (callbackValue) {
            case "onLoad":
            // onLoad
            case "onUnload":
            // onUnload
            case "onShouldShowLoadingIndicator":
            // onShouldShowLoadingIndicator
            case "onShouldHideLoadingIndicator":
            // onShouldHideLoadingIndicator
            default:
            // default
        }
    },
    function(err) {
        console.log(err);
    }
);

コールバックタイプ

onLoad

onLoad コールバックは、配置がロードされてインタラクティブになると呼び出されます。

onShouldShowLoadingIndicator

onShouldShowLoadingIndicator は、成功した実行呼び出しが行われたときに、SDKがRoktバックエンドへの呼び出しをトリガーする直前に呼び出されます。これは、配置がロードされるのを待っている間、ロードインジケーターの進行状況を表示するために使用できます。

onShouldHideLoadingIndicator

onShouldHideLoadingIndicator コールバックは、SDKがRoktバックエンドから成功または失敗の応答を取得したときに呼び出されます。これは、進行状況ビューやロードインジケーターをキャンセルするために使用できます。

onUnload

onUnload コールバックは、SDKが配置を閉じるときに呼び出されます。実行呼び出しが失敗した場合にもトリガーされます。

アプリ設定の使用

アプリケーションは、独自のアプリケーション環境から設定を送信できるようになりました。これにより、Rokt SDKはシステムのデフォルトに頼るのではなく、アプリケーションのカスタム設定を使用することができます。

// アプリケーションがライトモードのみをサポートしている場合。
const roktConfig = new RoktSDK.RoktConfigBuilder()
    .withColorMode(RoktSDK.COLOR_MODE.LIGHT)
    .build();
RoktSdk.executeWithConfig(
    // 他のパラメータ,
    roktConfig,

ColorModeオブジェクト

値	説明
LIGHT	アプリケーションはライトモードです
DARK	アプリケーションはダークモードです
SYSTEM	アプリケーションはシステムカラー モードにデフォルト設定されています