---
title: Amazon Pinpoint コネクタ構成ガイド
description: この記事では、Amazon Pinpoint コネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/amazon-pinpoint-connector/
---
## API 情報

このコネクタは以下のベンダー API を使用します：

* API 名: Amazon Pinpoint API
* API バージョン: v1
* API エンドポイント: `https://pinpoint.us-east-1.amazonaws.com`
* ドキュメント: [Amazon Pinpoint ドキュメント](https://docs.aws.amazon.com/pinpoint/latest/apireference/welcome.html)

## コネクタアクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
|メッセージ送信| ✓| ✓|
|プッシュ通知送信| ✓| ✓|
|テンプレート送信| ✓| ✓|
|イベント登録| ✓| ✓|
|エンドポイント更新| ✓| ✓|

## 構成の構成

コネクタマーケットプレイスにアクセスして新しいコネクタを追加します。コネクタの追加方法については、[コネクタ概要](https://docs.tealium.com/about-connectors/) の記事を参照してください。

コネクタを追加した後、以下の構成を構成します：

* **アクセスキー**
  * 必須：IAM ユーザーのアクセスキーを提供してください
  * 関連する IAM ポリシー（IAM ユーザーまたは仮定されたロール用）は `mobiletargeting:*`, `ses:*`, `sms-voice:*` の権限を付与する必要があります。
  * 詳細については、[Amazon Pinpoint](https://docs.aws.amazon.com/pinpoint/latest/developerguide/security_iam_service-with-iam.html) を参照してください。

* **シークレットキー**
  * 必須
  * IAM ユーザーのシークレットキーを提供してください

* **リージョン**
  * 必須
  * リージョンを選択してください。

* **ロールの仮定: ARN**
  * オプション
  * 仮定するロールの Amazon リソース名 (ARN) を提供してください。
  * 例: `arn:aws:iam::222222222222:role/myrole`
  * 詳細については、[IAM ロールへの切り替え](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-api.html) を参照してください。

* **ロールの仮定: セッション名**
  * オプション
  * 仮定されたロールセッションの識別子を提供してください。

* **ロールの仮定: 外部 ID**
  * オプション
  * 外部識別子を提供してください。
  * 詳細については、[外部 ID の使用方法](http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-user_externalid.html) を参照してください。

## アクション構成 - パラメータとオプション

**次へ** をクリックするか、**アクション** タブに進みます。ここでコネクタアクションを構成します。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

### アクション - メッセージ送信

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|アプリケーション ID|  <ul><li>必須</li><li>アプリケーションの一意の識別子。</li><li>この識別子は Amazon Pinpoint コンソールでプロジェクト ID として表示されます。</li></ul> |
|メッセージタイプ|  <ul><li>メッセージタイプ</li><li>オプションは **Email**, **SMS**, または **Voice** です。  <ul><li>アドレス (テンプレート)、エンドポイント (テンプレート)、または宛先が必要で、それぞれ1つのみ許可されます。</li><li>宛先、本文、およびタイトルのフィールドは、アドレス (テンプレート) を構築するために使用されます。</li></ul> </li><li>SMS  <ul><li>SMS メッセージタイプの本文は必須です。</li><li>メッセージタイプの有効な値は `TRANSACTIONAL` または `PROMOTIONAL` です。</li></ul> </li></ul> |
|テンプレート変数|  <ul><li>オプション</li><li>テンプレートにデータ入力としてテンプレート変数を提供してください。</li><li>詳細については [connector-template-variables](https://docs.tealium.com/connector-template-variables/) を参照してください。</li><li>ドット表記でネストされたテンプレート変数を名前付けしてください。</li><li>例: `items.name`</li><li>ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。</li></ul> |
|テンプレート|  <ul><li>オプション</li><li>URL、URLパラメータ、ヘッダー、またはボディデータで参照されるテンプレートを提供してください。</li><li>詳細については [about-connector-templates](https://docs.tealium.com/about-connector-templates/) を参照してください。</li><li>テンプレートは、サポートされるフィールドに名前で二重中括弧で注入されます。</li><li>例: `{{SomeTemplateName}}`。</li></ul> |
|文字セット|  <ul><li>メッセージ内容の文字セットマッピング。</li></ul> |
|HTML パート|  <ul><li>テキストパートまたはHTMLパートのいずれか一方のみが許可されます。</li></ul> |
|件名|  <ul><li>必須</li><li>メールの件名。</li></ul> |
|テキストパート|  <ul><li>テキストまたはHTML。</li><li>すべてのテキストまたはすべてのHTMLを使用します。</li></ul> |
|生のメール|  <ul><li>タイプ=Emailが選択された場合のみ使用されます。</li><li>生のMIMEメッセージとして表されるメールメッセージ。</li><li>メッセージ全体をbase64でエンコードする必要があります。</li></ul> |

### アクション - プッシュ通知送信

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|アプリケーション ID|  <ul><li>アプリケーションの一意の識別子。</li><li>この識別子は Amazon Pinpoint コンソールでプロジェクト ID として表示されます。</li></ul> |
|プッシュ通知タイプ|  <ul><li>プッシュ通知タイプ。</li><li>カスタムを入力するか、**ADM**, **AMPS**, **BAIDU**, または **GCM** を選択します。</li></ul> |
|テンプレート変数|  <ul><li>オプション</li><li>テンプレートにデータ入力としてテンプレート変数を提供してください。</li><li>詳細については [connector-template-variables](https://docs.tealium.com/connector-template-variables/) を参照してください。</li><li>ドット表記でネストされたテンプレート変数を名前付けしてください。</li><li>例: `items.name`</li><li>ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。</li></ul> |
|テンプレート|  <ul><li>オプション</li><li>URL、URLパラメータ、ヘッダー、またはボディデータで参照されるテンプレートを提供してください。</li><li>詳細については [about-connector-templates](https://docs.tealium.com/about-connector-templates/) を参照してください。</li><li>テンプレートは、サポートされるフィールドに名前で二重中括弧で注入されます。</li><li>例: `{{SomeTemplateName}}`。</li></ul> |

### アクション - テンプレート送信


#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|アプリケーションID|  <ul><li>アプリケーションの一意の識別子。</li><li>この識別子はAmazon PinpointコンソールでプロジェクトIDとして表示されます。</li></ul> |
|テンプレートタイプ|  <ul><li>テンプレートタイプ</li><li>オプションは **Email**、**Push**、**SMS**、**Voice**、または **Custom**。</li></ul> |
|アドレス（テンプレート）|  <ul><li>アドレス（テンプレート）、エンドポイント（テンプレート）またはデスティネーションが必要です。</li><li>アドレス（テンプレート）、エンドポイント（テンプレート）またはデスティネーションのいずれか一つのみが許可されます。</li><li>デスティネーション、ボディ、タイトルのフィールドを使用してアドレス（テンプレート）を構築します。</li></ul> |
|コンテキスト（テンプレート）|  <ul><li>オブジェクト</li><li>カスタム属性をアドレスの属性にマッピングするオブジェクトで、メッセージに添付されます。</li><li>属性は大文字と小文字を区別します。</li><li>プッシュ通知の場合、このペイロードは `data.pinpoint` オブジェクトに追加されます。</li><li>メールまたはテキストメッセージの場合、このペイロードはメール/SMS配信受領イベント属性に追加されます。</li></ul> |
|デスティネーション|  <ul><li>アドレス（テンプレート）、エンドポイント（テンプレート）またはデスティネーションが必要です。</li><li>アドレス（テンプレート）、エンドポイント（テンプレート）またはデスティネーションのいずれか一つのみが許可されます。</li><li>デスティネーション、ボディ、タイトルのフィールドを使用してアドレス（テンプレート）を構築します。</li></ul> |
|エンドポイント（テンプレート）|  <ul><li>アドレス（テンプレート）、エンドポイント（テンプレート）またはデスティネーションが必要です。</li><li>アドレス（テンプレート）、エンドポイント（テンプレート）またはデスティネーションのいずれか一つのみが許可されます。</li><li>デスティネーション、ボディ、タイトルのフィールドを使用してアドレス（テンプレート）を構築します。</li></ul> |
|名前|  <ul><li>文字列</li><li>メッセージに使用するメッセージテンプレートの名前。</li><li>指定された場合、この値は既存のメッセージテンプレートの名前と一致する必要があります。</li></ul> |
|トレースID|  <ul><li>文字列</li><li>メッセージのトレース用の一意の識別子。</li><li>この識別子はメッセージイベントで表示されます。</li></ul> |
|バージョン|  <ul><li>文字列</li><li>メッセージに使用するメッセージテンプレートのバージョンの一意の識別子。</li><li>指定された場合、この値は既存のテンプレートバージョンの識別子と一致する必要があります。</li><li>テンプレートのバージョンとバージョン識別子のリストを取得するには、[Template Versions](https://docs.aws.amazon.com/pinpoint/latest/apireference/templates-template-name-template-type-versions.html)リソースを使用します。</li><li>このプロパティの値を指定しない場合、Amazon Pinpointはテンプレートのアクティブバージョンを使用します。</li><li>アクティブバージョンは通常、最も最近レビューされ承認された使用バージョンであり、必ずしも最新バージョンではありません。</li></ul> |
|テンプレート変数|  <ul><li>オプショナル</li><li>テンプレートにデータ入力としてテンプレート変数を提供します。</li><li>詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。</li><li>ドット表記でネストされたテンプレート変数を名前付けします。</li><li>例：`items.name`</li><li>ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます</li></ul> |
|テンプレート|  <ul><li>オプショナル</li><li>URL、URLパラメータ、ヘッダー、またはボディデータで参照されるテンプレートを提供します。</li><li>詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。</li><li>テンプレートは名前で二重中括弧によってサポートされるフィールドに注入されます。</li><li>例：`{{SomeTemplateName}}`</li></ul> |

### アクション - イベントを追加する

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|アプリケーションID|  <ul><li>アプリケーションの一意の識別子。</li><li>この識別子はAmazon PinpointコンソールでプロジェクトIDとして表示されます。</li></ul> |
|アプリパッケージ名|  <ul><li>文字列</li><li>イベントを記録するアプリのパッケージ名。</li></ul> |
|アプリタイトル|  <ul><li>文字列</li><li>イベントを記録するアプリのタイトル。</li></ul> |
|アプリバージョンコード|  <ul><li>文字列</li><li>イベントを記録するアプリのバージョン番号。</li></ul> |
|クライアントSDKバージョン|  <ul><li>文字列</li><li>クライアントデバイスで実行されているSDKのバージョン。</li></ul> |
|イベントタイプ|  <ul><li>必須</li><li>文字列</li><li>イベントの名前。</li></ul> |
|SDK名|  <ul><li>文字列</li><li>イベントを記録するために使用されるSDKの名前。</li></ul> |
|タイムスタンプ|  <ul><li>文字列</li><li>イベントが発生した日時。ISO 8601形式。</li></ul> |
|イベント属性|  <ul><li>オブジェクト</li><li>イベントに関連付けられた1つ以上のカスタム属性。</li></ul> |
|イベントメトリクス|  <ul><li>オブジェクト</li><li>イベントに関連付けられた1つ以上のカスタムメトリクス。</li></ul> |
|期間|  <ul><li>整数</li><li>セッションの期間（ミリ秒単位）。</li></ul> |
|ID|  <ul><li>必須</li><li>文字列</li><li>セッションの一意の識別子。</li></ul> |
|開始タイムスタンプ|  <ul><li>文字列</li><li>セッションが開始された日時。</li></ul> |
|停止タイムスタンプ|  <ul><li>文字列</li><li>セッションが終了した日時。</li></ul> |
|アドレス|  <ul><li>文字列</li><li>受信者の一意の識別子。デバイストークン、メールアドレス、または携帯電話番号など。</li></ul> |
|デモグラフィックアプリバージョン|  <ul><li>文字列</li><li>エンドポイントに関連付けられたアプリのバージョン。</li></ul> |
|デモグラフィックロケール|  <ul><li>文字列</li><li>エンドポイントのロケール。</li><li>ISO 639-1 alpha-2コードに続いてアンダースコア(\_)、ISO 3166-1 alpha-2値の形式。</li></ul> |
|デモグラフィックメーカー|  <ul><li>文字列</li><li>エンドポイントデバイスの製造元。</li><li>例: **Apple**、**Samsung**</li></ul> |
|デモグラフィックモデル|  <ul><li>文字列</li><li>エンドポイントデバイスのモデル名または番号。</li><li>例: **iPhone**、**SM-G900F**</li></ul> |
|デモグラフィックモデルバージョン|  <ul><li>文字列</li><li>エンドポイントデバイスのモデルバージョン。</li></ul> |
|デモグラフィックプラットフォーム|  <ul><li>文字列</li><li>エンドポイントデバイスのプラットフォーム。</li><li>例: **ios**</li></ul> |
|デモグラフィックプラットフォームバージョン|  <ul><li>文字列</li><li>エンドポイントデバイスのプラットフォームバージョン。</li></ul> |
|デモグラフィックタイムゾーン|  <ul><li>文字列</li><li>エンドポイントのタイムゾーン。</li><li>`tz`データベース名値として指定される。例: **America/Los_Angeles**。</li></ul> |
|有効日|  <ul><li>文字列</li><li>エンドポイントが最後に更新された日時。ISO 8601 UTC形式。</li></ul> |
|エンドポイントID|  <ul><li>必須</li></ul> |
|エンドポイントステータス|  <ul><li>文字列</li><li>エンドポイントへのメッセージ送信またはプッシュ通知の送信を指定します。</li><li>有効な値は:  <ul><li>**ACTIVE**: エンドポイントにメッセージが送信されます。</li><li>**INACTIVE**: エンドポイントにメッセージが送信されません。</li></ul> </li><li>エンドポイントを作成または更新するとき、Amazon Pinpointは自動的にこの値を**ACTIVE**に構成します。</li><li>`address`プロパティで指定されたアドレスと同じアドレスを持つ別のエンドポイントを更新する場合、Amazon Pinpointは自動的にこの値を**INACTIVE**に構成します。</li></ul> |
|ロケーションシティ|  <ul><li>文字列</li><li>エンドポイントが位置している都市の名前。</li></ul> |
|ロケーションカントリー|  <ul><li>文字列</li><li>エンドポイントが位置している国または地域の2文字コード。ISO 3166-1 alpha-2形式。</li><li>例: **en_US** はアメリカ合衆国</li></ul> |
|ロケーション緯度|  <ul><li>数値</li><li>エンドポイントの位置の緯度座標。小数点以下1桁に丸められます。</li></ul> |
|ロケーション経度|  <ul><li>数値</li><li>エンドポイントの位置の経度座標。小数点以下1桁に丸められます。</li></ul> |
|ロケーション郵便番号|  <ul><li>文字列</li><li>エンドポイントが位置している地域の郵便番号または郵便番号。</li></ul> |
|ロケーションリージョン|  <ul><li>文字列</li><li>エンドポイントが位置している地域の名前。</li><li>アメリカ合衆国内の場合、値は州の名前です。</li></ul> |
|リクエストID|  <ul><li>文字列</li><li>エンドポイントを作成または更新するリクエストの一意の識別子。</li></ul> |
|ユーザーID|  <ul><li>文字列</li><li>ユーザーの一意の識別子。</li></ul> |
|エンドポイント属性|  <ul><li>エンドポイントを説明する1つ以上のカスタム属性。</li></ul> |
|エンドポイントメトリクス|  <ul><li>アプリがAmazon Pinpointに報告するエンドポイントの1つ以上のカスタムメトリクス。</li></ul> |
|エンドポイントユーザー属性|  <ul><li>名前と値の配列を関連付けることでユーザーを説明する1つ以上のカスタム属性。</li></ul> |
|エンドポイントチャネルタイプ|  <ul><li>エンドポイントにメッセージやプッシュ通知を送信する際に使用されるチャネル。</li></ul> |
|エンドポイントオプトアウト|  <ul><li>エンドポイントに関連付けられたユーザーがあなたからのメッセージやプッシュ通知の受信を拒否しているかどうかを指定します。</li></ul> |

### アクション - エンドポイントの更新

#### パラメータ

|**パラメータ**| **説明**|
|---| ---|
|アプリケーションID|  <ul><li>アプリケーションの一意の識別子。</li><li>この識別子はAmazon PinpointコンソールでプロジェクトIDとして表示されます。</li></ul> |
|アドレス|  <ul><li>文字列</li><li>デバイストークン、メールアドレス、または携帯電話番号など、受信者の一意の識別子。</li></ul> |
|デモグラフィック アプリバージョン|  <ul><li>文字列</li><li>エンドポイントに関連付けられたアプリのバージョン。</li></ul> |
|デモグラフィック ロケール|  <ul><li>文字列</li><li>エンドポイントのロケール。</li><li>形式はISO 639-1アルファ2コード、アンダースコア(\_)、ISO 3166-1アルファ2値の順です。</li></ul> |
|デモグラフィック メーカー|  <ul><li>文字列</li><li>エンドポイントデバイスの製造者。</li><li>例: **Apple**、**Samsung**</li></ul> |
|デモグラフィック モデル|  <ul><li>文字列</li><li>エンドポイントデバイスのモデル名または番号。</li><li>例: **iPhone**、**SM-G900F**</li></ul> |
|デモグラフィック モデルバージョン|  <ul><li>文字列</li><li>エンドポイントデバイスのモデルバージョン。</li></ul> |
|デモグラフィック プラットフォーム|  <ul><li>文字列</li><li>エンドポイントデバイスのプラットフォーム。</li><li>例: **ios**</li></ul> |
|デモグラフィック プラットフォームバージョン|  <ul><li>文字列</li><li>エンドポイントデバイスのプラットフォームバージョン。</li></ul> |
|デモグラフィック タイムゾーン|  <ul><li>文字列</li><li>エンドポイントのタイムゾーン。</li><li>`tz`データベース名値として指定されます。例: **America/Los_Angeles**。</li></ul> |
|有効日|  <ul><li>ISO 8601 UTC形式の有効日。</li></ul> |
|エンドポイントステータス|  <ul><li>文字列</li><li>エンドポイントへのメッセージ送信またはプッシュ通知の送信を指定します。</li><li>有効な値:  <ul><li>**ACTIVE**: エンドポイントへメッセージが送信されます。</li><li>**INACTIVE**: エンドポイントへメッセージが送信されません。</li></ul> </li><li>エンドポイントを作成または更新するとき、Amazon Pinpointは自動的にこの値を**ACTIVE**に構成します。</li><li>`address`プロパティで指定されたアドレスと同じ別のエンドポイントを更新する場合、Amazon Pinpointは自動的にこの値を**INACTIVE**に構成します。</li></ul> |
|ID|  <ul><li>必須</li><li>文字列</li><li>セッションの一意の識別子。</li></ul> |
|ロケーション シティ|  <ul><li>文字列</li><li>エンドポイントが位置する都市の名前。</li></ul> |
|ロケーション カントリー|  <ul><li>ロケーション国</li><li>国はISO 369-1アルファ2コード、アンダースコア(\_)、ISO 3166-1アルファ2値の順で表されます。</li><li>例: **en_US** はアメリカ合衆国</li></ul> |
|ロケーション 緯度|  <ul><li>数値</li><li>エンドポイントの位置の緯度座標。小数点以下1桁に丸められます。</li></ul> |
|ロケーション 経度|  <ul><li>数値</li><li>エンドポイントの位置の経度座標。小数点以下1桁に丸められます。</li></ul> |
|ロケーション 郵便番号|  <ul><li>文字列</li><li>エンドポイントが位置する地域の郵便番号または郵便番号。</li></ul> |
|ロケーション リージョン|  <ul><li>文字列</li><li>エンドポイントが位置する地域の名前。</li><li>アメリカ合衆国内の場所の場合、値は州の名前です。</li></ul> |
|リクエストID|  <ul><li>文字列</li><li>リクエストまたはレスポンスの一意の識別子。</li></ul> |
|ユーザーID|  <ul><li>文字列</li><li>ユーザーの一意の識別子。</li></ul> |
|エンドポイント属性|  <ul><li>エンドポイントを説明する1つ以上のカスタム属性。名前と値の配列を関連付けます。</li></ul> |
|エンドポイントメトリクス|  <ul><li>アプリがAmazon Pinpointに報告するエンドポイントの1つ以上のカスタムメトリック。</li></ul> |
|エンドポイントユーザー属性|  <ul><li>ユーザーを説明する1つ以上のカスタム属性。名前と値の配列を関連付けます。</li></ul> |
|エンドポイントチャネルタイプ|  <ul><li>エンドポイントへのメッセージ送信またはプッシュ通知の送信に使用されるチャネル。</li></ul> |
|エンドポイントオプトアウト|  <ul><li>エンドポイントに関連付けられたユーザーがメッセージやプッシュ通知の受信を拒否しているかどうかを指定します。</li><li>有効な値は **ALL** または **NONE** です。</li></ul> |