**サポート終了通知:** 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 からのアプリケーションイベントデータストリーム
<a name="event-streams-data-app"></a>

アプリケーション (アプリ) を Amazon Pinpoint と統合してイベントストリーミングを設定すると、Amazon Pinpoint はセットアップ時に指定した送信先からアプリケーションのユーザーアクティビティ、カスタムイベント、およびメッセージ配信データを取得して表示します。イベントデータを表示できるようにイベントストリーミングを設定する方法については、「[Amazon Kinesis または Amazon Data Firehose を介してアプリイベントデータをストリーミングするように Amazon Pinpoint を設定する](event-streams-setup.md)」を参照してください。

## アプリケーションイベントの例
<a name="event-streams-data-app-example"></a>

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

```
{
  "event_type": "_session.stop",
  "event_timestamp": 1487973802507,
  "arrival_timestamp": 1487973803515,
  "event_version": "3.0",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "cognito_identity_pool_id": "us-east-1:a1b2c3d4-e5f6-g7h8-i9j0-k1l2m3n4o5p6",
    "package_name": "main.page",
    "sdk": {
      "name": "aws-sdk-mobile-analytics-js",
      "version": "0.9.1:2.4.8"
    },
    "title": "title",
    "version_name": "1.0",
    "version_code": "1"
  },
  "client": {
    "client_id": "m3n4o5p6-a1b2-c3d4-e5f6-g7h8i9j0k1l2",
    "cognito_id": "us-east-1:i9j0k1l2-m3n4-o5p6-a1b2-c3d4e5f6g7h8"
  },
  "device": {
    "locale": {
      "code": "en_US",
      "country": "US",
      "language": "en"
    },
    "make": "generic web browser",
    "model": "Unknown",
    "platform": {
      "name": "android",
      "version": "10.10"
    }
  },
  "session": {
    "session_id": "f549dea9-1090-945d-c3d1-e4967example",
    "start_timestamp": 1487973202531,
    "stop_timestamp": 1487973802507
  },
  "attributes": {},
  "metrics": {}
}
```

## アプリイベントの属性
<a name="event-streams-data-app-attributes"></a>

このセクションでは、前の例のアプリケーションイベントストリームに含まれる属性を定義します。


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

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

イベントが関連付けられている Amazon Pinpoint プロジェクトに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| app\$1id |  イベントを報告した Amazon Pinpoint プロジェクトの一意の ID。  | 
| cognito\$1identity\$1pool\$1id |  エンドポイントが関連付けられている Amazon Cognito ID プールの ID。  | 
| package\$1name |  アプリパッケージの名前 (`com.example.my_app` など)。  | 
| sdk |  イベントを報告するために使用された SDK に関する情報。詳細については、表「[SDK](#event-streams-data-app-attributes-application-sdk)」を参照してください。  | 
| title |  アプリケーションの名前。  | 
| version\$1name |  アプリケーションのバージョンの名前 (`V2.5` など)。  | 
| version\$1code |  アプリケーションのバージョン番号 (`3` など)。  | 

#### SDK
<a name="event-streams-data-app-attributes-application-sdk"></a>

イベントを報告するために使用された SDK に関する情報を含めます。


| 属性 | 説明 | 
| --- | --- | 
| name | イベントを報告するために使用された SDK の名前。 | 
| version | SDK のバージョン。 | 

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

イベントを生成したエンドポイントに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| client\$1id | エンドポイントの ID。 | 
| cognito\$1id | エンドポイントに関連付けられている Amazon Cognito ID トークン。 | 

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

イベントを生成したエンドポイントのデバイスに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| locale |  エンドポイントのデバイスの言語とリージョンの設定に関する情報。詳細については、表「[ロケール](#event-streams-data-app-attributes-device-locale)」を参照してください。  | 
| make | エンドポイントのデバイスの製造元。 | 
| model | エンドポイントのデバイスのモデル識別子。 | 
| platform |  エンドポイントのデバイス上のオペレーティングシステムに関する情報。詳細については、表「[プラットフォーム](#event-streams-data-app-attributes-device-platform)」を参照してください。  | 

#### 国
<a name="event-streams-data-app-attributes-device-locale"></a>

エンドポイントのデバイスの言語とリージョンの設定に関する情報を含めます。


| 属性 | 説明 | 
| --- | --- | 
| code | デバイスに関連付けられているロケール識別子。 | 
| country | デバイスのロケールに関連付けられている国またはリージョン。 | 
| language | デバイスのロケールに関連付けられている言語。 | 

#### プラットフォーム
<a name="event-streams-data-app-attributes-device-platform"></a>

エンドポイントのデバイス上のオペレーティングシステムに関する情報を含めます。


| 属性 | 説明 | 
| --- | --- | 
| name | デバイス上のオペレーティングシステムの名前。 | 
| version | デバイス上のオペレーティングシステムのバージョン。 | 

### セッション
<a name="event-streams-data-app-attributes-session"></a>

イベントを生成したセッションに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| session\$1id | セッションを識別する一意の ID。 | 
| start\$1timestamp | セッションが開始された日時。Unix 時間 (ミリ秒単位) として表示されます。 | 
| stop\$1timestamp | セッションが終了した日時。Unix 時間 (ミリ秒単位) として表示されます。 |