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

セグメントのインポート

Amazon Pinpoint では、セグメントに属するユーザーに関する情報を含むファイルをインポートしてユーザーセグメントを定義できます。Amazon Pinpoint の外でユーザーセグメントを定義するが、Amazon Pinpoint キャンペーンにユーザーを関与させたいという場合は、セグメントのインポートが役立ちます。

コンソールでセグメントビルダーで作成する動的セグメントとは異なり、インポートされたセグメントは、変更されないエンドポイントまたはユーザーのセットですIDs。

インポートされたセグメントは、エンドポイント、ユーザー IDs、またはその両方の組み合わせで構成されます。Amazon Pinpoint を使用してセグメントにメッセージを送信する際、想定される宛先は次のとおりです。

新しいセグメントを作成する場合に、インポートされたセグメントを基本セグメントとして使用できます。それから、基本セグメントにフィルターを追加し、ニーズに合わせて絞り込むことができます。

インポートされたセグメントの考慮事項

インポートされたセグメントを作成するときは、次の要素を考慮してください。

セグメントファイル

セグメントIDsに属するエンドポイントまたはユーザーをカンマ区切りの値 (CSV) またはJSONファイルで定義します。次に、Amazon Pinpoint にそのファイルをインポートしてセグメントを作成します。

セグメントをインポートするときは、次の点に注意してください。

セグメントファイルの例

このセクションのファイル例は、次のデータに基づいています。

このテーブルの各行は、個々のエンドポイントを表します。ユーザーIDsexample-user-id-2と example-user-id-3は、それぞれ 2 つのエンドポイントに割り当てられることに注意してください。

セグメントのインポート

Amazon Pinpoint にセグメントをインポートする方法は 2 つあります。コンピュータから直接ファイルをアップロードする方法と、Amazon Simple Storage Service (Amazon S3) バケットに保存されているファイルをインポートする方法です。

特に、コンピュータにカスタマーデータがすでにある場合は、コンピュータからファイルをアップロードすることをお勧めします。ただし、一度にインポートできるファイルは 10 個で、1 ギガバイト (GB) 未満のファイルのみをアップロードできます。

一度に 10 個を超えるファイルをインポートする必要がある場合、または 1 GB を超えるファイルをアップロードする必要がある場合は、Amazon S3 からファイルをインポートする必要があります。また、保存のために顧客データを Amazon S3 に送信するプロセスがすでに存在する場合、Amazon S3 インポートオプションも役立ちます。

このセクションでは、これらの両方の方法を使用してセグメントをインポートする手順について説明します。

サポートされている属性

このセクションの表は、Amazon Pinpoint にインポートする、エンドポイント定義で指定できる属性を一覧表示し、説明しています。CSV ファイルを使用してセグメントをインポートする場合、ファイルのヘッダーは属性列に表示される名前と一致する必要があります。

JSON ファイルの場合、属性名のピリオドは、その期間の後の名前が、その期間の前の値と等しい名前を持つ親オブジェクトにネストされたオブジェクトであることを示します。例えば、 Demographic.Makeと Demographic.Model 属性を含むJSONファイルには、次の構造があります。

{
...
"Demographic": {
  ...
  "Make":"Apple",
  "Model":"iPhone"
  ...
  }
...
}

完全なJSON構造は、Amazon Pinpoint APIリファレンス のエンドポイントリクエストの例とよく似ています。ただし、セグメントをインポートする際、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"]}。

各プロジェクトのエンドポイントとユーザーに対して、250 個までカスタム属性を作成できます。詳細については、「Amazon Pinpoint デベロッパーガイド」の Amazon Pinpoint のクォータをご参照ください。