Add the #DF24 Developer Keynote to your agenda. Join us in-person on 9/18 at 2:30 p.m. PT or on Salesforce+ at 5 p.m. PT for the must-see session built just for developers.

SMS によるパスワードなしのログイン

Marketing Cloud の SMS 機能を使用して、Shopper Login and API Access Service (SLAS) のパスワードなしのログイン機能で買い物客を認証するための確認コードを送信する方法を学びます。

このガイドの手順を完了するには、以下が必要です。

  • アクティブな Commerce Cloud ライセンス。
  • SMS サブスクリプションを備えたアクティブな Marketing Cloud ライセンス。
  • アプリをインストールする権限をもつ Marketing Cloud インスタンスの管理者アクセス権。
  • Marketing Cloud インスタンスの SMS 国コードとショートコード。
  • B2C Commerce-Marketing Cloud SMS Integration パッケージのインストールリンク。

👉 SMS ショートコードを準備するには、Marketing Cloud アカウント担当者にお問い合わせください。

👉 インテグレーションパッケージのインストールリンクを取得するには、Salesforce の担当者にお問い合わせください。

  • 買い物客は、パスワードなしのログインをリクエストする前に、少なくとも 1 回 SLAS 経由でログインする必要があります。
  • 買い物客の電話番号は B2C Commerce に登録されている必要があります。
  • パスワードなしでログインするための SMS メッセージの送信は、全体量としてカウントされます。

B2C Commerce-Marketing Cloud SMS Integration パッケージを使用すると、SLAS を Marketing Cloud の SMS メッセージング機能と統合できます。

パッケージをインストールするには:

  1. 管理者の資格情報を使用して、 Marketing Cloud インスタンスにログインします。
  2. Salesforce 担当者から提供されたインストールリンクをクリックします。
  3. インストールをクリックし、利用規約に同意します。

インストールが成功すると、パッケージの詳細ページが表示され、確認メッセージが表示されます。

パッケージの詳細ページに戻るには:

  1. 「設定」から、「クイック検索ボックス」にインストール済みパッケージと入力し、インストール済みパッケージを選択します。
  2. B2C Commerce-Marketing Cloud SMS Integration をクリックします。

Marketing Cloud インスタンスにパッケージをインストールした後、SLAS Admin UI を使用して SLAS テナントを Marketing Cloud アカウントにリンクできます。

SLAS Asmin UI にアクセスしてテナントを作成する方法にまだ慣れていない場合は、Shopper API の認可を参照してください。

SLAS テナントを Marketing Cloud にリンクするには:

  1. SLAS Admin UI にログインします。
  2. Integrations (インテグレーション) > Marketing Cloud Integrations (Marketing Cloud インテグレーション) に進みます。
  3. Add MC Integration (MC インテグレーションの追加) をクリックします。
  4. パスワードなしのログイン用に設定されている SLAS テナントを選択します。
  5. Link to MC (MC へリンク) をクリックします。
  6. Marketing Cloud の認証情報を入力します。

これで、SLAS テナントが Marketing Cloud アカウントにリンクされました!

SLAS Admin UI で、Integrations (統合) > Marketing Cloud Integrations (Marketing Cloud インテグレーション) から SMS 定義を追加できます。(前のセクションの手順を続けている場合は、すでにそこまで進んでいます。)

SMS 定義をインテグレーションに追加するには:

  1. Add SMS Definition (SMS 定義の追加) をクリックします。

  2. Marketing Cloud インスタンスに準備されているショートコードと国コードを入力します。

    • ショートコードの例: 123456
    • 国コードの例: US

  3. Submit (送信) をクリックします。

これで、SMS 経由で確認コードの送信を開始する準備が整いました!

Marketing Cloud インスタンスでパスワードなしの SMS 通知に使用される SMS キーワードは削除しないでください。SMS キーワードは、cc_<shortcode>_<countrycode>_<memberId> という形式を使用します。SMS キーワードの例は、cc_12345_us_8976845 です。

SLAS Admin および SLAS API へのリクエストを正しく形成するには、最初にいくつかの環境変数を設定します。

変数値の例説明
$SFCC_SCAPI_SHORTCODEkv7kzm78Marketing Cloud SMS 用に準備されたショートコードではなく、B2C Commerce インスタンス用のショートコード
$SFCC_SCAPI_TENANTIDzzte_053B2C Commerce インスタンス用のテナント ID
$ORGANIZATION_IDabcd_s01B2C Commerce インスタンス用の組織 ID
$CHANNEL_IDSiteGenesisBusiness Manager のサイト名 (チャネル名とも呼ばれます)
$CALLBACK_URIhttps://webhook.site/9f44093b-d129-42be-84d3-2f17254df04b承認後のリダイレクト用 URI
$CLIENT_ID872daaa2-412e-40c8-a48a-5a56daaef868SLAS クライアント ID
$USER_IDpia.larson買い物客ログイン用のユーザー ID。
$SFCC_ACCESS_TOKEN(セキュリティ上の理由から提供されません)SLAS Admin UI からのアクセストークン
$ACCESS_TOKEN(セキュリティ上の理由から提供されません)SLAS からのアクセストークン

Unix ベースのオペレーティングシステムを使用していない場合は、提供される curl コマンドで変数を後から手動で置き換えることができます。

次のサンプルリクエストでは、上記で設定した環境変数と SLAS Admin API (SLAS API とは異なる) の passwordless-templates エンドポイントを使用して、検証コードを送信するための SMS テンプレートを作成します。

買い物客認証のための API リクエストの作成の詳細については、パスワードなしのログインのガイドおよび SLAS Admin API 参照資料を参照してください。

次のサンプルリクエストでは、上記で設定した環境変数と SLAS API (SLAS Admin API とは異なる) の authorizePasswordlessCustomer エンドポイントを使用して、SMS 経由で顧客を承認します。

買い物客認証のための API リクエストの作成の詳細については、パスワードなしのログインno ガイドおよびSLAS API 参照資料を参照してください。

ここでは、SMS 経由のパスワードなしのログインに関する一般的な問題とその解決方法をいくつか紹介します。

B2C Commerce-Marketing Cloud SMS Integration パッケージをインストールすると、「Package Manager にアクセスするために必要な権限がありません。」というエラーメッセージが表示されます。

ご使用のアカウントに、アプリをインストールする権限をもつ Marketing Cloud インスタンスの管理者アクセス権があることを確認してください。

SLAS Admin UI で Marketing Cloud インテグレーションを追加しようとすると、「未承認 - このアカウントにアプリがインストールされていないか、ユーザーにこのパッケージのライセンスがないため、リクエストを完了できません。」というエラーメッセージが表示されます。

管理者ユーザーは、SLAS Admin UI にインテグレーションを追加する 前 に、Marketing Cloud インスタンスにインテグレーションパッケージをインストールする必要があります。

authorizePasswordlessCustomer エンドポイントを使用すると、次のようなエラーレスポンスが返されます。

SMS 定義が、SLAS Admin UI で正しいショートコードと国コードを使用して適切なテナントに設定されていることを確認してください。

SMS メッセージが配信されません。

無効な番号、到達不能な番号、ブロックされた番号、間違ったショートコード、間違った国コードなど、さまざまな理由で配信は失敗します。

理由を特定できない場合は、Salesforce カスタマーサポートにお問い合わせください。