**サポート終了通知:** 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-campaign"></a>

Amazon Pinpoint を使用してチャンネルを介してキャンペーンを送信する場合、Amazon Pinpoint はそれらのキャンペーンに関するイベントデータをストリーミングできます。イベントストリーミングを設定すると、Amazon Pinpoint は、セットアップ時に指定した送信先から、キャンペーンから送信した E メールまたは SMS メッセージのアプリケーションのイベントデータを取得して表示します。E メールメッセージと SMS メッセージに対して Amazon Pinpoint がストリーミングするデータの詳細については、「[Amazon Pinpoint からの E メールイベントデータストリーム](event-streams-data-email.md)」および「[Amazon Pinpoint からの SMS イベントデータストリーム](event-streams-data-sms.md)」を参照してください。イベントストリーミングを設定する方法については、「[Amazon Kinesis または Amazon Data Firehose を介してアプリイベントデータをストリーミングするように Amazon Pinpoint を設定する](event-streams-setup.md)」を参照してください。

## キャンペーンイベントの例
<a name="event-streams-data-campaign-example"></a>

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

```
{
  "event_type": "_campaign.send",
  "event_timestamp": 1562109497426,
  "arrival_timestamp": 1562109497494,
  "event_version": "3.1",
  "application": {
    "app_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "sdk": {}
  },
  "client": {
    "client_id": "d8dcf7c5-e81a-48ae-8313-f540cexample"
  },
  "device": {
    "platform": {}
  },
  "session": {},
  "attributes": {
    "treatment_id": "0",
    "campaign_activity_id": "5473285727f04865bc673e527example",
    "delivery_type": "GCM",
    "campaign_id": "4f8d6097c2e8400fa3081d875example",
    "campaign_send_status": "SUCCESS"
  },
  "client_context": {
    "custom": {
      "endpoint": "{\"ChannelType\":\"GCM\",\"EndpointStatus\":\"ACTIVE\",
          ↳\"OptOut\":\"NONE\",\"RequestId\":\"ec229696-9d1e-11e9-8bf1-85d0aexample\",
          ↳\"EffectiveDate\":\"2019-07-02T23:12:54.836Z\",\"User\":{}}"
    }
  },
  "awsAccountId": "123456789012"
}
```

## キャンペーンイベント属性
<a name="event-streams-data-campaign-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-campaign.html)  | 
| event\$1timestamp | イベントが報告された時刻。Unix 時間 (ミリ秒単位) として表示されます。 | 
| arrival\$1timestamp | イベントが Amazon Pinpoint によって受信された時刻が、Unix 時間 (ミリ秒単位) として表示されます。 | 
| event\$1version |  イベントの JSON スキーマのバージョン。  イベント処理アプリケーションでこのバージョンをチェックし、スキーマの更新に合わせてアプリケーションを更新する時期を把握します。   | 
| application | イベントに関連付けられた Amazon Pinpoint プロジェクトに関する情報。詳細については、表「[アプリケーション](#event-streams-data-campaign-attributes-application)」を参照してください。 | 
| client | イベントが関連付けられているエンドポイントに関する情報。詳細については、表「[クライアント](#event-streams-data-campaign-attributes-client)」を参照してください。 | 
| device | イベントを報告したデバイスに関する情報。キャンペーンメッセージとトランザクションメッセージの場合、このオブジェクトは空です。 | 
| session | イベントを生成したセッションに関する情報。キャンペーンの場合、このオブジェクトは空です。 | 
| attributes |  イベントに関連付けられている属性。アプリケーションの 1 つによって報告されるイベントの場合、このオブジェクトにはアプリケーションによって定義されたカスタム属性を含めることができます。キャンペーンを送信したときに作成されたイベントの場合、このオブジェクトにはキャンペーンに関連付けられた属性が含まれています。トランザクションメッセージを送信するときに生成されるイベントの場合、このオブジェクトにはメッセージ自体に関連する情報が含まれます。 詳細については、表「[属性](#event-streams-data-campaign-attributes-attrs)」を参照してください。  | 
| client\$1context | endpoint プロパティを格納した custom オブジェクトが含まれています。endpoint プロパティには、キャンペーンが送信されたエンドポイントのエンドポイントレコードの内容が含まれています。 | 
| awsAccountId |  メッセージの送信に使用された AWS アカウントの ID。  | 

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

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


| 属性 | 説明 | 
| --- | --- | 
| app\$1id |  イベントを報告した Amazon Pinpoint プロジェクトの一意の ID。  | 
| sdk |  イベントを報告するために使用された SDK。  | 

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

イベントを生成したキャンペーンに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| treatment\$1id |  メッセージが A/B テストキャンペーンを使用して送信された場合、この値はメッセージの処理番号を表します。標準キャンペーンの場合、この値は `0` です。  | 
| campaign\$1activity\$1id | イベントが発生したときに Amazon Pinpoint が生成する一意の ID。 | 
| delivery\$1type |  キャンペーンの配信方法。この属性を、`client_context` の `endpoint` プロパティで指定された `ChannelType` フィールドと混同しないでください。`ChannelType` フィールドは通常、メッセージの送信先のエンドポイントに基づいています。 1 つのエンドポイントタイプのみをサポートするチャネルの場合、`delivery_type` および `ChannelType` フィールドの値は同じになります。例えば、E メールチャネルの場合、`delivery_type` および `ChannelType` フィールドの値は同じ EMAIL になります。 ただし、カスタムチャネルなど、さまざまなエンドポイントタイプをサポートするチャネルでは、この条件は必ずしも当てはまりません。EMAIL、SMS、CUSTOM など、さまざまなエンドポイントに対してカスタムチャネルを使用できます。この場合、`delivery_type` はカスタム配信イベントの CUSTOM を特定し、`ChannelType` はキャンペーンの送信先のエンドポイントのタイプ (EMAIL、SMS、CUSTOM など) を指定します。カスタムチャンネルの作成の詳細については、「[ウェブフックまたは Lambda 関数を使用して Amazon Pinpoint でカスタムチャネルを作成する](channels-custom.md)」を参照してください。 可能な値は以下のとおりです。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 
| campaign\$1id |  メッセージの送信元のキャンペーンの一意の ID。  | 
| campaign\$1send\$1status | ターゲットエンドポイントのキャンペーンのステータスを示します。可能な値は以下のとおりです:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/pinpoint/latest/developerguide/event-streams-data-campaign.html)  | 

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

キャンペーンの対象となったエンドポイントに関する情報が含まれています。


| 属性 | 説明 | 
| --- | --- | 
| client\$1id | キャンペーンが送信されたエンドポイントのエンドポイント ID。 |