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

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

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

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

エンゲージメント Mobile SDK の Salesforce CDP モジュールでは、SDK の ID API を介してプロファイルデータを収集できます。
プロファイルデータが Salesforce CDP に送信されるための要件:
  1. エンゲージメント Mobile SDK の Salesforce CDP モジュールが設定および初期化されている必要があります。
  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}

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

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

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

各 ID イベントには、対応付けることができる項目が含まれます。
  • 個人
    • firstName
    • lastName
  • ソフトウェアアプリケーション
    • softwareApplicationId
    • softwareApplicationName
  • デバイス
    • advertiserId
    • deviceType
    • osName
  • 連絡先アプリケーション
    • softwareApplicationId
連絡先
サポートされる各連絡先には、SDK の ID API に提供する必要のある一連の必須属性があります。すべての属性が提供されたら、Salesforce CDP モジュールは ID イベントと共にプロファイルイベント連絡先をトリガします。連絡先とそれらをトリガする必須属性は次のとおりです。
  • 連絡先メールスキーマ
    • email
  • 連絡先電話スキーマ
    • phoneNumber
  • 連絡先住所スキーマ
    • addressLine1
    • city
    • postalCode
    • stateProvince
    • country

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

Salesforce CDP モジュールでは、プロファイル属性 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 システムをサポートするモジュール間の識別子の共有もサポートされます。たとえば、特定の匿名モバイルユーザにプッシュ通知を送信するために、Salesforce CDP と Marketing Cloud MobilePush モジュールの両方を備えたモバイルアプリケーションを使用して個人を照合します。

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