オーディエンスのインポート

以下の仕様に従って、CSVファイルを用意してください：

形式

• アップロードするユーザー識別子ごとに1列に配置してください
• 各列に識別子の名前を記載したヘッダー行（すべて小文字）を用意してください
• 空白行は含めないでください
• 最大行数：1000万行
• Excelで作成した場合は、以下の画像のようにCSV (カンマ区切り) (*.csv) ファイルで保存してください

  

識別子ハッシュ

列と識別子

• データは、各列のデータを識別するためにヘッダー行を使用して取り込まれます。そのため、
  • 列の並び順には、特に指定がありません。
  • アップロードされていない識別子の欄を設ける必要はありません。
  • 以下で詳しく説明するとおり、各行に必要な識別子が含まれていれば、1つのCSVファイルに必要な数の識別子をインポートすることができます。
• 使用できる識別子：
  • app_id
  • idfv
  • idfa
  • gaid
  • oaid
  • imei
  • cuid
  • emails
  • phone
  • phone_e164
  • braze_id
  • amplitude_id
• 必須の識別子：
  
  • Androidオーディエンス：app_id + 次のいずれか一つ：gaid、oiad、imei、cuid、braze_id または amplitude_id
  • iOSオーディエンス：app_id + 次のうち1つ：idfv または cuid または braze_id または amplitude_id
  注：app_id は「現状のまま (as-is) 」のオーディエンスには必要ありません。

CSVファイルの例：

new-import-android-example.csv
new-import-ios-example.csv

CSVファイルを使って新しいオーディエンスを作成しインポートする方法：

1. インテグレーション > オーディエンスへ進みます。

2. オーディエンスをインポートボタンをクリックしてください。
   新しいオーディエンス画面が開き、Define (定義) タブが表示されます。

3. 一意のオーディエンス名を入力してください。

4. オーディエンスのプラットフォームを選択してください：Android / iOS。

5. オーディエンスが標準オーディエンスか現状のままのオーディエンスかを指定してください。
   • 標準オーディエンスの場合は、ボックスにチェックを入れないでください。
   • 現状のままのオーディエンスの場合は、ボックスにチェックを入れてください。（注：このオプションはアドミンのみが利用できます。）
6. オーディエンスを保存して続行をクリックしてください。
   インポートタブが表示されます。
7. CSVを使用してインポートセクションで、新しい端末／ユーザーを追加というデフォルトのままにしてください（新規オーディエンスのため）。
8. アップロードするCSVファイルを選択してください。
   Uploaded successfully / 正常にアップロードされましたという確認メッセージが表示されるのを待ってください。
9. 次へをクリックします。
   Connect / 連携タブが表示されます。
10. （オプション）オーディエンスをパートナーに接続する手順に従ってください。
11. 完了をクリックしてください。

オーディエンスはオーディエンス管理画面に表示され、パートナーにインポートされ接続されています。ただし、インポートされたオーディエンスは、データの更新頻度が日次で処理されるため、新たにインポートされたオーディエンスリストはまだパートナーにアップロードできないことをご注意ください。

CSVファイルを使用して既存オーディエンスを更新する方法：

1. インテグレーション > オーディエンスへ進みます。

2. アップロードしたいオーディエンス名をクリックしてください。
   オーディエンスの編集画面が開き、Define/定義タブが表示されます。

3. オーディエンス名を編集したい場合は、ここで編集してください。それ以外の場合は、インポートタブを選択して新しいCSVファイルをアップロードしてください。

4. CSVを使用してインポートするセクションで、アップロードされたリストをどう処理するかを選択してください。
   • 新しい端末 / ユーザーを追加：既存オーディエンスにデバイス／ユーザーを追加します。
   • 既存オーディエンスからデバイス / ユーザーを削除：オーディエンスからアップロードされたリスト内のデバイス／ユーザー識別子を削除します。
   • 既存オーディエンスを新しいデバイス／ユーザーで上書き：オーディエンス全体をアップロードされたリストに置き換えます。
5. アップロードするCSVファイルを選択してください。
   Uploaded successfully / 正常にアップロードされましたという確認メッセージが表示されるのを待ってください。
6. 次へをクリックします。
   Connect / 連携タブが表示されます。
7. 必要に応じて、このオーディエンスのパートナー接続を変更してください。
8. 完了をクリックしてください。

CSVファイルを使用してオーディエンスが更新されました。ただし、インポートされたオーディエンスはデータの更新頻度が日次で処理されるため、修正されたオーディエンスリストはまだパートナーにアップロードされていませんのでご注意ください。

オーディエンスインポートAPIは、オーディエンスからデバイスを追加または削除するために使用されます。次の手順を使用して、APIリクエストURLとAPIリクエストBodyを生成してください。

APIリクエストURL

https://hq1.appsflyer.com/audiences-import-api/v2/{action}?api_token={api_token}

APIリクエストBody

{
  "import_key": "<import_key>",
  "platform": "<platform>",
  "devices":[
    {
    "<identifier_1_name>":"<identifier_1_value>",
    "<identifier_2_name>":"<identifier_2_value>",
    "<identifier_n_name>":"<identifier_n_value>"
    }
  ]
}

APIを使って新しいオーディエンスをインポートする方法：

1. インテグレーション > オーディエンスへ進みます。
2. オーディエンスをインポートボタンをクリックしてください。
   新しいオーディエンス画面が開き、Define (定義) タブが表示されます。
3. 一意のオーディエンス名を入力してください。
4. オーディエンスのプラットフォームを選択してください：Android / iOS。
5. オーディエンスが標準オーディエンスか現状のままのオーディエンスかを指定してください。
   • 標準オーディエンスの場合は、ボックスにチェックを入れないでください。
   • 現状のままのオーディエンスの場合は、ボックスにチェックを入れてください。（注：このオプションはアドミンのみが利用できます。）
6. オーディエンスを保存して続行をクリックしてください。
   インポートタブが表示されます。
7. APIを使用してインポートセクションで、新しい端末／ユーザーを追加というデフォルトのままにしてください（新規オーディエンスのため）。
8. APIリクエストURLをコピーしてください（APIトークンは既に含まれています）。
9. APIリクエストBodyをコピーしてください。
10. 次へをクリックします。
    Connect / 連携タブが表示されます。
11. （オプション）オーディエンスをパートナーに接続する手順に従ってください。
12. 完了をクリックしてください。
13. ユーザー/デバイスの識別子を含むAPIリクエストを準備し、以下のサンプルのように、AppsFlyerにPOSTしてください。

APIを使用して既存オーディエンスを更新する方法：

1. インテグレーション > オーディエンスへ進みます。

2. アップロードしたいオーディエンス名をクリックしてください。
   オーディエンスの編集画面が開き、Define/定義タブが表示されます。

3. オーディエンス名を編集したい場合は、ここで編集してください。それ以外の場合は、インポートタブを選択してください。

4. APIを使用してインポートするセクションで、アップロードされたリストをどう処理するかを選択してください。
   • 新しい端末 / ユーザーを追加：既存オーディエンスにデバイス／ユーザーを追加します。
   • 既存オーディエンスからデバイス / ユーザーを削除：既存オーディエンスからデバイス／ユーザー識別子を削除します。
5. APIリクエストURLをコピーしてください（APIトークンは既に含まれています）。
   • 重要！このオプションを変更すると、コピーされるコードのエンドポイントのパスが変更されます。今回のAPIリクエストおよび今後のAPIリクエストにおいて、実行するアクションに適したエンドポイントを必ず使用してください。
6. APIリクエストBodyをコピーしてください。
7. 次へをクリックします。
   Connect / 連携タブが表示されます。
8. 必要に応じて、このオーディエンスのパートナー接続を変更してください。
9. 完了をクリックしてください。
10. ユーザー/デバイスの識別子を含むAPIリクエストを準備し、以下のサンプルのように、AppsFlyerにPOSTしてください。

デバイスを追加するリクエストのサンプル

HTTP POST 
https://hq1.appsflyer.com/audience-import-api?api_token=
Accept: application/json
Content-Type: application/json
body: {
     "import_key": "EKFH2UMC5PPCU8J7M5QQCBPKIH89E6NCOB7XQFWMC",
     "platform": "android", 
     "devices":[
      {
      "gaid":"c4fc2600-fd62-4511-bc1d-c3495c8b0861",
      "emails":"9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "app_id":"com.test.app-channel1"
      }
   ]
}

APIに関する制限事項

• 1つのリクエストにつき、1つのオーディエンスにのみデバイスを追加できます。
• 1つのリクエストにつき、1つのオーディエンスからのみデバイスを削除できます。
• 1つのリクエストにつき、最大1万件のデバイスIDを送信できます。