`sendPushSubscription` send-push-subscription

Last update: Thu Dec 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

トピック：
Appmeasurement，データ収集，無効化

作成対象：

開発者

AVAILABILITY

Web SDKのプッシュ通知は現在 ベータ版 です。機能とドキュメントは変更される場合があります。

sendPushSubscription コマンドは、プッシュ通知の購読をAdobe Experience Platformに登録します。このコマンドは、ブラウザーからのプッシュ購読の詳細の取得を処理し、設定済みのデータストリームに送信します。 Web SDK バージョン 2.29.0 以降で使用できます。

前提条件 prerequisites

sendPushSubscription を使用する前に、次のことを確認します。

設定済みのプッシュ通知:VAPID 公開鍵を使用して pushNotifications 設定プロパティを設定します
ユーザー権限：ユーザーは、通知権限を付与されている必要があります（Notification.permission === "granted"）
サービスワーカー：登録されたサービスワーカーがサイトで使用可能である必要があります
プッシュマネージャーのサポート：ブラウザーはプッシュ通知をサポートし、PushManager API を使用できる必要があります

設定済みの Web SDK インスタンスを呼び出す際に、sendPushSubscription コマンドを実行します。 configure コマンドを呼び出す前に、プッシュ通知を設定して sendPushSubscription コマンドを呼び出してください。

alloy("sendPushSubscription")
  .then(() => {
    console.log("Push subscription recorded successfully");
  })
  .catch((error) => {
    console.error("Failed to send push subscription:", error);
  });

推奨実行頻度 recommended-execution-frequency

Adobe最適なプッシュ通知機能を使用するには、sendPushSubscription コマンドを 1 日に 1 回 実行することをお勧めします。この頻度により、次のことが保証されます。

購読の詳細はAdobe Experience Platformで最新の状態を維持します
プッシュトークンまたは購読ステータスに対する変更が取り込まれます
ユーザーのプロファイルは、最新のプッシュ通知環境設定で更新されたままになります

次のようなアプローチを使用して、これを実装できます。

// Check if subscription data was sent today
const lastSent = localStorage.getItem("alloy_push_last_sent");
const today = new Date().toDateString();

if (lastSent !== today) {
  alloy("sendPushSubscription").then(() => {
    localStorage.setItem("alloy_push_last_sent", today);
  });
}

仕組み how-it-works

sendPushSubscription コマンドは、次のアクションを実行します。

前提条件を検証：プッシュ通知が設定され、ユーザー権限が付与されていることを確認します
ID を待機：ユーザーの ECID が使用可能になるまで待機します
サブスクリプションを取得：設定された VAPID キーを使用して、サービスワーカーからアクティブなプッシュサブスクリプションを取得します
変更のチェック：現在のサブスクリプションの詳細とキャッシュされた値（ECID + サブスクリプションの詳細）を比較します。購読の詳細が変更されていない場合、コマンドは情報メッセージをログに記録し、ネットワークリクエストを行わずに戻ります
データストリームに送信：変更が検出された場合、は購読データを設定済みのAdobe Experience Platform データストリームに送信します
キャッシュを更新：今後の比較のために新しいサブスクリプションの詳細を保存します

エラー処理 error-handling

一般的なエラー条件とそのメッセージ：

エラー

原因

"Push notifications module is not configured. No VAPID public key was provided."

pushNotifications 設定がないか無効

"Service workers are not supported in this browser."

ブラウザーはサービスワーカーをサポートしていません

"Push notifications are not supported in this browser."

ブラウザーはプッシュ通知または Notification API をサポートしていません

"The user has not given permission to send push notifications."

ユーザーが通知権限を付与していません（Notification.permission === "granted"）

"No service worker registration was found."

現在の接触チャネルにサービスワーカーが登録されていません

"No VAPID public key was provided."

設定に VAPID 公開鍵がありません

データペイロード data-payload

このコマンドは、プッシュ通知データを次の形式で送信します。

{
  pushNotificationDetails: [
    {
      appID: "example.com", // Current domain
      token: "...", // Serialized subscription details + ECID
      platform: "web", // Always "web" for Web SDK
      denylisted: false, // Always false
      identity: {
        namespace: {
          code: "ECID",
        },
        id: "12345678901234567890", // User's ECID
      },
    },
  ],
}

Web SDK タグ拡張機能を使用したプッシュ購読の登録 register-push-subscription-tag-extension

このフィールドと同等の Web SDK タグ拡張機能は、タグルール内で Send Push Subscription アクションを使用します。

recommendation-more-help

1ae86b30-e55e-49c1-ab11-9d0356a5f3e1

sendPushSubscription send-push-subscription