この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

初期化

API を使用する Web サービスの呼び出しにエンゲージメント Mobile SDK 用の Salesforce CDP モジュールを使用できるようにするには、事前に SDK を設定する必要があります。CdpConfigBuilder (iOS) または CdpConfig.Builder (Android) ヘルパークラスを使用し、必須設定の appId と endpoint (モバイルコネクタから取得可能) を指定して、SDK 設定を構築します。必要に応じて、trackScreens、trackLifecycle、sessionTimeoutInSeconds 設定を指定することもできます。

設定	項目の型	説明
appId	string	必須。appId 設定は、モバイルアプリケーションを Salesforce CDP に対して一意に識別します。これを有効なユニバーサル一意識別子 (UUID) 形式で指定する必要があります。無効な appID を指定すると、エラーになります。
endpoint	string	必須。endpoint 設定では、作成および追跡されるイベントをどこに送信するかを SDK に指示します。
sessionTimeoutInSeconds	integer	sessionTimeoutInSeconds 設定は、モバイルアプリケーションがバックグラウンドの状態で何秒経過したら現在のセッションが期限切れになるかを表します。ユーザがモバイルアプリケーションを起動すると、SDK は新しいセッションを開始します。このセッションは、アプリケーションがフォアグラウンドの状態のときに維持されます。ユーザがモバイルアプリケーションをバックグラウンドに送ると、SDK はタイマーを起動して、現在のセッションが期限切れになるまでの時間を計測します。セッションが期限切れになる前にユーザがモバイルアプリケーションをフォアグラウンドに戻すと、タイマーがクリアされてセッションが継続します。そうでなければセッションが終了します。この項目は、デフォルトで 600 に設定されます。
trackLifecycle	boolean	trackLifecycle を有効化すると、`AppForegrounded`、`AppBackgrounded`、および `AppVersionChanged` 行動イベントが自動的に追跡されます。この項目は、デフォルトで false に設定されます。
trackScreens	boolean	trackScreens を有効化すると、モバイルアプリケーションの ScreenEntry 行動イベントが自動的に追跡されます。この項目は、デフォルトで false に設定されます。

Salesforce CDP モジュールを設定します。

Salesforce CDP モジュールを設定します。
Salesforce CDP モジュールを使用してエンゲージメント Mobile SDK を初期化します。

設定は、装備するモバイルアプリケーションの初期化ルーチン中に実行されます。

iOS

1import Cdp
2import SFMCSDK
3
4...
5
6let appId = "{appIdFromMobileConnector}"
7let endpoint = "https://{endpointFromMobileConnector}"
8
9// 1. configure the Salesforce CDP module
10let cdpModuleConfig = CdpConfigBuilder(appId: appId, endpoint: endpoint)
11        .trackScreens(false)
12        .trackLifecycle(false)
13        .sessionTimeout(600)
14        .build()
15  
16// 2. initialize the Engagement Mobile SDK      
17SFMCSdk.initializeSdk(ConfigBuilder().setCdp(config: cdpModuleConfig).build())

Android

1import com.salesforce.marketingcloud.cdp.CdpConfig
2import com.salesforce.marketingcloud.sfmcsdk.SFMCSdk
3import com.salesforce.marketingcloud.sfmcsdk.SFMCSdkModuleConfig
4
5...
6
7val appId = "{appIdFromMobileConnector}"
8val endpoint = "https://{endpointFromMobileConnector}"
9
10// 1. configure the Salesforce CDP module
11val cdpModuleConfig = CdpConfig.Builder(this, appId, endpoint)
12      .trackScreens(false)
13      .trackLifecycle(false)
14      .sessionTimeout(600)
15      .build()
16
17// 2. initialize the Engagement Mobile SDK 
18SFMCSdk.configure(this, SFMCSdkModuleConfig.build {
19    this.cdpModuleConfig = cdpModuleConfig
20})

カスタマーデータプラットフォーム開発者ガイド

初期化

iOS

Android