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

Data Cloud リファレンスガイド

Data Cloud リファレンスガイド
データの接続
Web インタラクションの取り込み
モバイルアプリケーションの統合
API リファレンス
初期化
エンゲージメントデータの取得
プロファイルデータの取得
行動データの取得
同意管理
ロケーションの追跡
ログとデバッグ
イベント仕様
スキーマの対応付け
MuleSoft と Data Cloud の接続
データの取得
Data Cloud でデータをモデル化する
データの抽出
PDF

プロファイルデータの取得

エンゲージメント Mobile SDK の Data Cloud モジュールでは、SDK の ID API を介してプロファイルデータを収集できます。
プロファイルデータが Data Cloud に送信されるための要件:
  1. エンゲージメント Mobile SDK の Data Cloud モジュールが設定および初期化されている必要があります。
  2. 追跡するための同意が付与されている必要があります。

プロファイル属性の設定

iOS
1import Cdp
2import SFMCSDK
3
4...
5
6let profileAttributes = [
7  "email": "user@domain.com",
8  "username": "user01"
9]
10SFMCSdk.identity.setProfileAttributes([.cdp: profileAttributes])
Android
1import com.salesforce.marketingcloud.sfmcsdk.SFMCSdk
2import com.salesforce.marketingcloud.sfmcsdk.modules.ModuleIdentifier.CDP
3
4...
5
6val profileAttributes = mapOf(
7  "email" to "user@domain.com",
8  "username": "user01"
9)
10SFMCSdk.requestSdk { sdk ->
11  sdk.identity.setProfileAttributes(profileAttributes, CDP)
12}

プロファイル属性が変更されると、Data Cloud モジュールは設定されているすべての属性を含む ID プロファイルイベントをトリガーします。これらの属性は、任意の名前と値のペアに設定できます。

サポートされている Customer 360 データモデル

Data Cloud で推奨されるモバイルコネクタスキーマによって提供される ID スキーマには、適切な Customer 360 データモデルに対応付けられている場合に Data Cloud の ID 解決機能をサポートするプロファイル属性が含まれます。

各 ID イベントには、対応付けることができる項目が含まれます。
  • 個人
    • firstName
    • lastName
  • ソフトウェアアプリケーション
    • registrationId
    • softwareApplicationName
  • デバイス
    • advertiserId
    • deviceType
    • osName
  • 連絡先アプリケーション
    • registrationId
デバイスの advertiserId

Android 13 (API レベル 33) 以降、デバイスの advertiserId の要求に権限が必要です。Data Cloud 2.0.2 には、デフォルトでこの権限が付属します。この権限がアプリケーションにマージされないようにするには、次の要素を AndroidManifest.xml に追加します。

1<uses-permission android:name="com.google.android.gms.permission.AD_ID" tools:node="remove"/>
連絡先
サポートされる各連絡先には、SDK の ID API に提供する必要のある一連の必須属性があります。すべての属性が提供されたら Data Cloud モジュールは ID イベントと共にプロファイルイベント連絡先をトリガーします。連絡先とそれらをトリガーする必須属性は次のとおりです。
  • 連絡先メールスキーマ
    • email
  • 連絡先電話スキーマ
    • phoneNumber
  • 連絡先住所スキーマ
    • addressLine1
    • city
    • postalCode
    • stateProvince
    • country

匿名ユーザーと既知のユーザー

Data Cloud モジュールでは、プロファイル属性 isAnonymous = 1 を設定することで匿名として明示的に指定されていない限り、すべての顧客が既知のユーザーとみなされます。つまり、isAnonymous=0 の設定により、顧客は確実に既知のユーザーとみなされます。

iOS
1import Cdp
2import SFMCSDK
3
4...
5
6// treat a profile as anonymous
7SFMCSdk.identity.setProfileAttributes([.cdp: ["isAnonymous": 1]])
8// or use this convenience function
9CdpModule.shared.setProfileToAnonymous()
10
11// treat a profile as known
12SFMCSdk.identity.setProfileAttributes([.cdp: ["isAnonymous": 0]])
13 // or use this convenience function
14 CdpModule.shared.setProfileToKnown()
Android
1// treat a profile as anonymous
2SFMCSdk.requestSdk { sdk ->
3  sdk.identity.setProfileAttribute("isAnonymous", 1, CDP) 
4}
5
6// treat a profile as known
7SFMCSdk.requestSdk { sdk ->
8  sdk.identity.setProfileAttribute("isAnonymous", 0, CDP) 
9}

共有関係者識別子

エンゲージメント Mobile SDK では、インテグレーションの使用事例で他の Salesforce システムをサポートするモジュール間の識別子の共有もサポートされます。たとえば、特定の匿名モバイルユーザーにプッシュ通知を送信するために、Data Cloud と Marketing Cloud MobilePush モジュールの両方を備えたモバイルアプリケーションを使用して個人を照合します。

匿名の MobilePush ユーザー
ID イベントには、関係者 ID モデルに対応付けることができる項目が含まれます。
  • registrationId — ID 番号
既知の MobilePush ユーザー
Mobile Cloud MobilePush モジュールは、モバイルユーザーの解決済み ID を取得したときに、SDK の ID API を使用して profileId を設定します。Data Cloud モジュールはこの変更の通知を受け、次の項目を含む partyIdentification イベントを送信します。
  • userId — ID 番号
  • IDName — 関係者 ID 名
  • IDType — 関係者 ID 種別