**サポート終了通知:** 2026 年 10 月 30 日に、 AWS は Amazon Pinpoint のサポートを終了します。2026 年 10 月 30 日を過ぎると、Amazon Pinpoint コンソールまたは Amazon Pinpoint のリソース (エンドポイント、セグメント、キャンペーン、ジャーニー、分析) にアクセスできなくなります。詳細については、「[Amazon Pinpoint のサポート終了](https://docs.aws.amazon.com/console/pinpoint/migration-guide)」を参照してください。**注:** SMS、音声、モバイルプッシュ、OTP、電話番号の検証に関連する APIs は、この変更の影響を受けず、 AWS エンドユーザーメッセージングでサポートされています。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon Pinpoint からの SMS イベントデータストリーム
<a name="event-streams-data-sms"></a>

SMS チャンネルがプロジェクトに対して有効になっている場合、Amazon Pinpoint はプロジェクトの SMS メッセージ配信に関するイベントデータをストリーミングできます。イベントストリーミングを設定すると、Amazon Pinpoint はセットアップ時に指定した送信先からイベントデータを取得して表示します。イベントストリーミングを設定する方法については、「[Amazon Kinesis または Amazon Data Firehose を介してアプリイベントデータをストリーミングするように Amazon Pinpoint を設定する](event-streams-setup.md)」を参照してください。

**注記**  
通信事業者が生成した SMS イベントは、受信されるまでに最大 72 時間かかることがあるため、送信メッセージの配信に遅延があるかどうかを判断するのには使用しないでください。72 時間が経過しても、Amazon Pinpoint が通信事業者から最終イベントを受信していない場合、そのメッセージに何が起こったのか Amazon Pinpoint ではわからないため、サービスは自動的に UNKNOWN の record\$1status を返します。

## SMS イベントの例
<a name="event-streams-data-sms-example"></a>

SMS イベントの JSON オブジェクトには以下の例に示されているデータが含まれています。

```
{
  "event_type": "_SMS.SUCCESS",
  "event_timestamp": 1553104954322,
  "arrival_timestamp": 1553104954064,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "123456789012"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "sender_request_id": "565d4425-4b3a-11e9-b0a5-example",
    "campaign_activity_id": "cbcfc3c5e3bd48a8ae2b9cb41example",
    "origination_phone_number": "+12065550142",
    "destination_phone_number": "+14255550199",
    "record_status": "DELIVERED",
    "iso_country_code": "US",
    "treatment_id": "0",
    "number_of_message_parts": "1",
    "message_id": "1111-2222-3333",
    "message_type": "Transactional",
    "campaign_id": "52dc44b35c4742c98c5935269example"
    "customer_context": "{\"userId\":\"user-id-4\"}"
  },
  "metrics": {
    "price_in_millicents_usd": 645.0
  },
  "awsAccountId": "123456789012"
}
```

## SMS イベントの属性
<a name="event-streams-data-sms-attributes"></a>

このセクションでは、SMS メッセージの送信時に Amazon Pinpoint が生成する前の例のイベントストリームデータに含まれる属性を定義します。


**イベント**  

| 属性 | 説明 | 
| --- | --- | 
| event\$1type |  イベントのタイプ。可能な値は以下のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/developerguide/event-streams-data-sms.html)  | 
| event\$1timestamp | イベントが報告された時刻。Unix 時間 (ミリ秒単位) として表示されます。 | 
| arrival\$1timestamp | イベントが Amazon Pinpoint によって受信された時刻が、Unix 時間 (ミリ秒単位) として表示されます。 | 
| event\$1version |  イベントの JSON スキーマのバージョン。  イベント処理アプリケーションでこのバージョンをチェックし、スキーマの更新に合わせてアプリケーションを更新する時期を把握します。   | 
| application | イベントに関連付けられた Amazon Pinpoint プロジェクトに関する情報。詳細については、表「[アプリケーション](#event-streams-data-sms-attributes-application)」を参照してください。 | 
| client | イベントをレポートしたデバイスにインストールされているアプリクライアントに関する情報。詳細については、表「[クライアント](#event-streams-data-sms-attributes-client)」を参照してください。 | 
| device | イベントを報告したデバイスに関する情報。詳細については、表「[デバイス](#event-streams-data-sms-attributes-device)」を参照してください。 SMS イベントの場合、このオブジェクトは空です。 | 
| session | SMS イベントの場合、このオブジェクトは空です。 | 
| attributes |  イベントに関連付けられている属性。アプリケーションの 1 つによって報告されるイベントの場合、このオブジェクトにはアプリケーションによって定義されたカスタム属性を含めることができます。キャンペーンを送信したときに作成されたイベントの場合、このオブジェクトにはキャンペーンに関連付けられた属性が含まれています。トランザクションメッセージを送信するときに生成されるイベントの場合、このオブジェクトにはメッセージ自体に関連する情報が含まれます。 詳細については、表「[属性](#event-streams-data-sms-attributes-attrs)」を参照してください。  | 
| metrics |  イベントに関連付けられている追加のメトリクス。詳細については、表「[メトリクス](#event-streams-data-sms-attributes-metrics)」を参照してください。  | 
| awsAccountId |  メッセージの送信に使用された AWS アカウントの ID。  | 

### アプリケーション
<a name="event-streams-data-sms-attributes-application"></a>

イベントが関連付けられている Amazon Pinpoint プロジェクトと、イベントを報告するために使用された SDK（該当する場合）に関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| app\$1id |  イベントを報告した Amazon Pinpoint プロジェクトの一意の ID。  | 
| sdk |  イベントを報告するために使用された SDK。Amazon Pinpoint API を直接呼び出すか、Amazon Pinpoint コンソールを使用してトランザクション SMS メッセージを送信する場合、このオブジェクトは空です。  | 

### 属性
<a name="event-streams-data-sms-attributes-attrs"></a>

イベントに関連付けられている属性に関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| sender\$1request\$1id | SMS メッセージを送信するリクエストに関連付けられている一意の ID。 | 
| campaign\$1activity\$1id | キャンペーン内のアクティビティの一意の ID。 | 
| origination\$1phone\$1number |  メッセージの送信元の電話番号。  | 
| destination\$1phone\$1number |  メッセージを送信しようとした電話番号。  | 
| record\$1status |  メッセージのステータスに関する追加情報。可能な値は以下のとおりです: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/developerguide/event-streams-data-sms.html)  | 
| iso\$1country\$1code |  受信者の電話番号に関連付けられている国 (ISO 3166-1 alpha-2 形式で表示)。  | 
| treatment\$1id |  メッセージが A/B キャンペーンで送信された場合のメッセージ処理の ID。  | 
| treatment\$1id |  メッセージが A/B テストキャンペーンを使用して送信された場合、この値はメッセージの処理番号を表します。トランザクション SMS メッセージの場合、この値は 0 です。  | 
| number\$1of\$1message\$1parts |  メッセージを送信するために Amazon Pinpoint が作成したメッセージパートの数。 通常、SMS メッセージには GSM-7 文字 160 文字または非 GSM 文字 67 文字のみを含めることができますが、これらの制限は国によって異なる場合があります。これらの制限を超えるメッセージを送信すると、Amazon Pinpoint は自動的にメッセージを小さなパートに分割します。送信したメッセージパートの数に基づいて請求されます。  | 
| message\$1id |  メッセージを受け入れるときに Amazon Pinpoint が生成する一意の ID。  | 
| message\$1type |  メッセージのタイプ。指定できる値は、**Promotional** および **Transactional**です。この値は、キャンペーンの作成時、または Amazon Pinpoint API の [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) オペレーションを使用してトランザクションメッセージを送信する際に指定します。  | 
| campaign\$1id |  メッセージを送信した Amazon Pinpoint キャンペーンの一意の ID。  | 
| customer\$1context | Amazon Pinpoint [SendMessages](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps-application-id-messages.html#SendMessages) オペレーションで送信された `Context` マップの内容の JSON 文字列。 | 

### クライアント
<a name="event-streams-data-sms-attributes-client"></a>

イベントをレポートしたデバイスにインストールされているアプリクライアントに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| client\$1id |  アプリによって生成されたイベントの場合、この値はデバイスにインストールされたアプリクライアントの一意の ID です。この ID は、AWS Mobile SDK for iOS および AWS Mobile SDK for Android で自動的に生成されます。 キャンペーンやトランザクションメッセージの送信時に生成されるイベントの場合、この値はメッセージの送信先のエンドポイントの ID と同じです。  | 
| cognito\$1id | アプリケーションが使用する Amazon Cognito ID プールのアプリクライアントに割り当てられた一意の ID。 | 

### デバイス
<a name="event-streams-data-sms-attributes-device"></a>

イベントを報告したデバイスに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| locale | デバイスロケール。 | 
| make | デバイスのメーカー (Apple、Samsung など)。 | 
| model | デバイスモデル (iPhone など)。 | 
| platform | デバイスのプラットフォーム (ios、android など)。 | 

### メトリクス
<a name="event-streams-data-sms-attributes-metrics"></a>

イベントに関連付けられているメトリクスに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| price\$1in\$1millicents\$1usd | メッセージの送信に課金された金額。この価格は、米ドルセントの 1000 分の 1 で示されます。例えば、この属性の値が `645` の場合、メッセージの送信に 0.645¢ が課金されます (645 / 1000 = 0.645¢ = \$10.00645)。  このプロパティは、`event_type` が **\$1SMS.BUFFERED** のメッセージには表示されません。   |