プレースメントの追加 (レガシー)

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

始める前に

Rokt Cordova SDKがアプリケーションに統合されていることを確認してください。

Rokt Cordova SDKの実行

プレースメントを表示するためにRokt Cordova SDKをexecuteします。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 can be any of these
        // 1. onLoad - your placement loads
        // 2. onUnload - your placement unloads
        // 3. onShouldHideLoadingIndicator - hook to show a loading indicator
        // 4. onShouldShowLoadingIndicator - hook to hide a loading indicator
    },
    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 バックエンドへの呼び出しをトリガーする直前に、execute 呼び出しが成功した際に呼び出されます。これは、プレースメントのロードを待っている間に、ローディングインジケーターの進行ビューを表示するために使用できます。

onShouldHideLoadingIndicator

onShouldHideLoadingIndicator コールバックは、SDK が Rokt バックエンドから成功または失敗のレスポンスを受け取ったときに呼び出されます。これは、進行ビューやローディングインジケーターをキャンセルするために使用できます。

onUnload

onUnload コールバックは、SDK がプレースメントを閉じるときに呼び出されます。また、execute 呼び出しが失敗した場合にもトリガーされます。

アプリケーション設定の使用

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

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

ColorMode オブジェクト

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