翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
セグメントのインポート
Amazon Pinpoint では、セグメントに属するユーザーに関する情報を含むファイルをインポートしてユーザーセグメントを定義できます。Amazon Pinpoint の外でユーザーセグメントを定義するが、Amazon Pinpoint キャンペーンにユーザーを関与させたいという場合は、セグメントのインポートが役立ちます。
インポートされたセグメントは、コンソールのセグメントビルダーで作成する動的セグメントとは異なり、変化することがないエンドポイントまたはユーザー ID のセットです。
- エンドポイント
-
メッセージを送信できる宛先 (E メールアドレス、モバイルデバイス ID、携帯電話番号など)。エンドポイントの定義には、メッセージを送信するユーザーまたはデバイスを表す属性を含めることができます。また、ユーザー ID を含めることもできます。
セグメントを定義するには、エンドポイント定義のリストをインポートします。Amazon Pinpoint はセグメントを作成し、以前に Amazon Pinpoint に追加したすべてのエンドポイントを新しい情報で更新します。
- ユーザー ID
-
対象者の個々のユーザーを表す ID。この ID は、1 つ以上のエンドポイントに割り当てる必要があります。例えば、ユーザーが複数のデバイスでアプリを使用する場合、アプリはそのユーザーのユーザー ID を各デバイスのエンドポイントに割り当てることができます。
ユーザー ID に関連付けられたエンドポイントを Amazon Pinpoint に追加した場合にのみ、ユーザー ID をインポートしてセグメントを定義できます。
インポートされたセグメントは、エンドポイント、ユーザー ID、またはその両方の組み合わせで構成されます。Amazon Pinpoint を使用してセグメントにメッセージを送信する際、想定される宛先は次のとおりです。
-
インポートされたファイルに一覧表示する各エンドポイント。
-
インポートされたファイルに一覧表示する各ユーザー ID に関連付けられている各エンドポイント。
新しいセグメントを作成する場合に、インポートされたセグメントを基本セグメントとして使用できます。それから、基本セグメントにフィルターを追加し、ニーズに合わせて絞り込むことができます。
インポートされたセグメントの考慮事項
インポートされたセグメントを作成するときは、次の要素を考慮してください。
-
キャンペーンを作成する際にはセグメントを選択する必要があります。動的セグメントを選択すると、Amazon Pinpoint はそのセグメントのサイズの予測を提供します。ただし、インポートしたセグメントを選択した場合、Amazon Pinpoint は予測を提供できません。
-
特定のイベントが発生したときにメッセージを送信するキャンペーンを作成した場合、インポートしたセグメントは使用できません。イベントベースのキャンペーンは、動的なセグメントのみを使用できます。動的セグメントの作成の詳細については、「セグメントの構築」を参照してください。
セグメントファイル
セグメントに属するエンドポイントまたはユーザー ID は、カンマ区切り値 (CSV) または JSON ファイルで定義します。次に、Amazon Pinpoint にそのファイルをインポートしてセグメントを作成します。
セグメントをインポートするときは、次の点に注意してください。
-
Amazon Pinpoint は圧縮ファイルをインポートできません。
-
インポートするファイルでは UTF-8 文字エンコーディングを使用する必要があります。
-
新しいエンドポイントをインポートする場合、
Address
およびChannelType
属性は必須です。 -
既存のエンドポイントを更新する場合、更新する各エンドポイントに対して
Id
属性は必須です。 -
エンドポイントの定義には、特定の属性のみを含めることができます。リストについては、「サポートされている属性」を参照してください。また、属性名は 50 文字以下にする必要があります。属性値は 100 文字以下にする必要があります。
セグメントファイルの例
このセクションのファイル例は、次のデータに基づいています。
エンドポイント属性値の例 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
ChannelType | Address | Location.Country | Demographic.Platform | Demographic.Make | ユーザー。UserId | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SMS | +16045550182 | CA | Android | LG | example-user-id-1 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
APNS | 1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f | 米国 | iOS | Apple | example-user-id-2 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
john.stiles@example.com | 米国 | iOS | Apple | example-user-id-2 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
GCM | 4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c | CN | Android | example-user-id-3 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
wang.xiulan@example.com | CN | Android | OnePlus | example-user-id-3 |
このテーブルの各行は、個々のエンドポイントを表します。このユーザー ID (example-user-id-2
および example-user-id-3
) は、2 つのエンドポイントにそれぞれ割り当てられています。
例 エンドポイント定義のファイル
セグメントのインポート
セグメントを Amazon Pinpoint にインポートするには、次の 2 つの方法があります。コンピュータから直接ファイルをアップロードするか、Amazon S3 バケットに保存されているファイルをインポートします。
特にコンピュータに顧客データがすでにある場合、一般的にセグメントをインポートする簡単な方法は、コンピュータからファイルをアップロードすることです。ただし、一度にインポートできるファイルは 10 個で、1 ギガバイト (GB) 未満のファイルのみをアップロードできます。
一度に 10 個を超えるファイルをインポートする必要がある場合や、1 GB を超えるファイルをアップロードする必要がある場合は、Amazon S3 からファイルをインポートする必要があります。また、保存のために顧客データを Amazon S3 に送信するプロセスがすでに存在する場合、Amazon S3 インポートオプションも役立ちます。
このセクションでは、これらの両方の方法を使用してセグメントをインポートする手順について説明します。
コンピュータから最大 10 個のファイルを直接アップロードしてセグメントを作成できます。アップロードするファイルは、CSV または JSON 形式にすることができます。形式の任意の組み合わせでファイルをアップロードできます。例えば、1 つの JSON ファイルと 3 つの CSV ファイルをアップロードできます。
セグメントをインポートするには
Amazon Pinpoint コンソール (https://console.aws.amazon.com/pinpoint/
) を開きます。 -
[All projects] ページで、セグメントを追加するプロジェクトを選択します。
-
ナビゲーションペインの [Segments] を選択します。
-
[Create a segment] を選択します。
-
[Create a segment] で、[Import a segment] を選択します。
-
[Import method] で、[Upload files from your computer] を選択します。
-
[Files to import] で、[Choose files] を選択します。インポートするファイル (複数可) を選択します。
注記
また、コンピュータのファイルエクスプローラーからファイルをドラッグして [Drop files here] 領域に直接ドロップすることもできます。
-
ファイルを Amazon Pinpoint にアップロードする際、インポートするファイルごとにセグメント名を指定する必要があります。セグメント名 に、インポートする各ファイルのセグメント名を入力します。
デフォルトでは、Amazon Pinpoint でインポートされたファイルの名前 (ただし拡張子なし) と同じセグメント名が表示されます。これらのデフォルト値を任意の名前に変更することができます。
注記
複数のセグメントに同じ名前を使用できます。その場合は、Amazon Pinpoint により、ファイルごとに別個のセグメントが作成され、一意の ID が各ファイルに割り当てられます。また、作成日もインポートするファイルごとにわずかに異なります。これらの要素を使用して、名前が同じセグメントを区別することができます。
-
完了したら、[Create segment] を選択します。
この手順を使用してセグメントをインポートする前に、まず Amazon S3 バケットを作成してファイルをそのバケットにアップロードする必要があります。さまざまなセグメントのファイルを別々のフォルダにまとめることができます。Amazon Pinpoint がセグメントのためのエンドポイントまたはユーザー ID をインポートする場合、指定した Amazon S3 の場所に属するすべてのフォルダとサブフォルダのファイルが含まれます。
バケットの作成とオブジェクトのアップロードの概要については、Amazon Simple Storage Service ユーザーガイドの「Amazon S3 とは」を参照してください。
Amazon Pinpoint では、1 つのファイル形式 (CSV または JSON) しかインポートできないため、指定する Amazon S3 パスには、1 つのタイプのファイルのみを含める必要があります。
セグメントをインポートするには
Amazon Pinpoint コンソール (https://console.aws.amazon.com/pinpoint/
) を開きます。 -
[All projects] ページで、セグメントを追加するプロジェクトを選択します。
-
ナビゲーションペインの [Segments] を選択します。
-
[Create a segment] を選択します。
-
[Create a segment] で、[Import a segment] を選択します。
-
[Segment name] に、後で判別しやすいようなセグメント名を入力します。
-
[Amazon S3 URL] に、セグメントのファイルが含まれている Amazon S3 バケットの場所を入力します。バケットのアドレスは次の形式である必要があります。
s3://
bucket-name
/folder-name
Amazon Pinpoint は指定したパス、およびそのパスの任意のサブフォルダからファイルをインポートします。
-
[IAM ロール] に、以下のいずれかのステップを実行します。
-
Amazon Pinpoint を使用して、Amazon S3 バケットからの読み取りを許可するロールを作成するには、[Automatically create a role] を選択します。次に、[IAM ロール] に、作成するロールの名前を入力します。
-
Amazon Pinpoint に対して Amazon S3 バケットからの読み取りを許可する IAM ロールをすでに作成してある場合は、[Choose an existing role] を選択します。次に、[IAM role] で、適切なアクセス権限を含むロールを選択します。
IAM ロールを自分で作成する場合は、『Amazon Pinpoint デベロッパーガイド』の「IAM role for importing endpoints or segments」を参照してください。ロールの作成が完了したら、Amazon Pinpoint コンソールで指定します。
-
-
をインポートするファイルのタイプで、Amazon JavaScript S3 にアップロードしたファイルの形式に応じて、オブジェクト表記 (JSON) またはカンマ区切り値 (CSV) のいずれかを選択します。 Amazon S3
-
[Create segment] を選択します。
サポートされている属性
このセクションの表には、Amazon Pinpoint にインポートするエンドポイント定義で指定できる属性を一覧表示し、説明しています。CSV ファイルを使用してセグメントをインポートする場合、ファイルのヘッダーは、[属性] 列に示されている名前と一致している必要があります。
JSON ファイルの場合、属性名のピリオドは、ピリオドに続く名前が、ピリオドの前の値と等しい名前の親オブジェクトにネストされているオブジェクトであることを示します。例えば、Demographic.Make
属性と Demographic.Model
属性を含む JSON ファイルの構造は次のとおりです。
{
...
"Demographic": {
...
"Make":"Apple",
"Model":"iPhone"
...
}
...
}
完全な JSON 構造は、「Amazon Pinpoint API Reference」の「example endpoint request」によく似ています。ただし、セグメントをインポートする際、EndpointStatus
や EffectiveDate
など、Endpoint リクエストスキーマの属性がすべてサポートされているとは限りません。
CSV 形式のカスタムフィールドに複数の値を設定するには、ヘッダーを複製し、ヘッダーごとに 1 つの値を保持する必要があります。例:
...,User.UserId, User.UserAttributes.new_multi_field,User.UserAttributes.new_multi_field
...,example-user-id-2,test10,test20
として表示される属性名を任意の値に置き換えることができます。例えば、ユーザーの姓と名を custom_attribute
FirstName
と LastName
という名前の属性に保存する場合は、User.UserAttributes.FirstName
と User.UserAttributes.LastName
という名前のカスタム属性をそれぞれ作成できます。属性名には、最大 50 文字を含めることができます。属性値には、最大 100 文字を含めることができます。属性名では大文字と小文字が区別されます。
JSON では、カスタム属性を "Attributes":{"Ride":["Bus"]}
にフォーマットする必要があります。
属性 | 説明 | ||||||
---|---|---|---|---|---|---|---|
Address |
エンドポイントに送信するメッセージやプッシュ通知の一意の宛先アドレス (E メールアドレス、電話番号、デバイストークンなど)。 注記エンドポイントアドレスが電話番号の場合は、E.164 形式で指定する必要があります。E.164形式の詳細については、「Wikipedia」の「E.164 |
||||||
Attributes. |
エンドポイントを定義するカスタム属性。このタイプの属性は、セグメントを作成するときの選択条件として使用できます。 は任意の値に置き換えることができます。 |
||||||
ChannelType |
メッセージまたはプッシュ通知をエンドポイントに送信するときに使用するチャンネル。例:
|
||||||
Demographic.AppVersion |
エンドポイントに関連付けられているアプリケーションのバージョン番号。 | ||||||
Demographic.Locale |
次の形式のエンドポイントのロケール。ISO 639-1 alpha-2en_US は米国の英語ロケールです。 |
||||||
Demographic.Make |
エンドポイントデバイスの製造元 (apple 、samsung など)。 |
||||||
Demographic.Model |
iPhone や SM-G900F など、エンドポイントのデバイスのモデル名または番号。 |
||||||
Demographic.ModelVersion |
エンドポイントデバイスのモデルバージョン。 | ||||||
Demographic.Platform |
エンドポイントのデバイス上のオペレーティングシステム (ios 、android など)。 |
||||||
Demographic.PlatformVersion |
エンドポイントのデバイス上のオペレーティングシステムのバージョン。 | ||||||
Demographic.Timezone |
tz データベース値America/Los_Angeles 。注記以下のタイムゾーンはサポートされなくなっており、サポートされているタイムゾーンに自動的に再マッピングされます。
|
||||||
EffectiveDate |
エンドポイントが最後に更新された日付と時刻 (ISO 8601 形式2019-08-23T10:54:35.220Z と指定します。 |
||||||
Id |
エンドポイントの一意の識別子。 | ||||||
Location.City |
エンドポイントが配置されている市。 | ||||||
Location.Country |
エンドポイントが配置されている国またはリージョンの 2 文字のコード (ISO 3166-1 alpha-2 形式US です。 |
||||||
Location.Latitude |
小数点以下 1 桁に丸められた、エンドポイントの場所の緯度座標。 | ||||||
Location.Longitude |
小数点以下 1 桁に丸められた、エンドポイントの場所の経度座標。 | ||||||
Location.PostalCode |
エンドポイントが配置されているエリアの郵便番号。 | ||||||
Location.Region |
エンドポイントが配置されている都道府県などのリージョンの名前。 | ||||||
Metrics. |
アプリケーションがエンドポイントに対して Amazon Pinpoint に報告するカスタム数値メトリクス (例えば、セッション数やカート内のアイテム残数など)。 は任意の値に置き換えることができます。これらのカスタム値は数値のみです。これらは数値であるため、Amazon Pinpoint は平均や合計などの算術演算をそれらに対して実行できます。 |
||||||
OptOut |
ユーザーがお客様からのメッセージとプッシュ通知の受信をオプトアウトしたかどうかを示します。使用できる値は次のとおりです。ALL : ユーザーはオプトアウトしており、メッセージやプッシュ通知の受信を希望していません。NONE : ユーザーはオプトアウトしておらず、すべてのメッセージとプッシュ通知の受信を希望しています。 |
||||||
RequestId |
エンドポイントを更新するための最新のリクエストの一意の識別子。 | ||||||
User.UserAttributes. |
ユーザーを定義するカスタム属性。 は、FirstName や Age など任意の値に置き換えることができます。 |
||||||
User.UserId |
ユーザー用の一意の識別子 |
各プロジェクトのエンドポイントとユーザーに対して、250 個までカスタム属性を作成できます。詳細については、「Amazon Pinpoint デベロッパーガイド」の Amazon Pinpoint のクォータをご参照ください。