オーディエンス—従来のインポート手順（V1.0）

前提条件

次の形式とスキーマを使用してCSVファイルを用意します。

• 1カラムのみ
• ヘッダー行は設定しない
• 空白行は含めないでください
• 各行には一つの広告IDのみを含めてください
• 最大行数：1000万。
• エクセルで作成した場合は、CSV（カンマ区切り）（*。csv）ファイルで保存してください。次の図のように、ファイルタイプを選択します。

  

CSVファイルの例：legacy_import_example_advertising_ID.csv

オーディエンスCSVファイルをアップロードする方法：

1. インテグレーション > オーディエンスを開きます。
   オーディエンス画面が表示されます。

2. オーディエンスを追加をクリックします。
   オーディエンス画面が開きます。[作成] タブが表示されます。

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

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

5. オーディエンスをインポートするを選択してください。
6. 新しいオーディエンスの場合：
   • オーディエンス名を入力してください。
   • 保存 をクリックしてください。
7. CSVをアップロードをクリックしてください。
8. インポートされたオーディエンスの操作を選択します。
   • 新しいデバイスを追加：デバイスIDリストを既存のオーディエンスに追加します。
   • 既存のすべてのデバイスを上書き：オーディエンス全体をアップロードされたリストに入れ替えます。
   • 既存のデバイスリストから除外する：オーディエンスからアップロードするデバイスを除外します。
9. アップロードするCSVファイルを選択してください。
10. アップロード をクリックしてください。
    正常にアップロードされましたという確認メッセージが表示されるのを待ってください。
11. オーディエンスを保存して続行をクリックします。
12. 連携するパートナーを選択してください。
13. 必要に応じて、パートナーに連携の手順に従ってください。
14. 閉じるをクリックしてください。
    リストはすぐには利用できません。リストが処理される頻度は毎日です。

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

APIリクエストURL

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

APIリクエストBody

{
 "import_key": "{mport_key}",
 "platform": "{plaform}",
 "devices": [
             "{device}",
             "{device2}",
             "{devicen}"
            ]
}

 始める前に ：

• AppsFlyerでオーディエンス作成が完了したことを確認します。

APIリクエストURLを準備する方法：

1. インテグレーション > オーディエンスを開きます。
   オーディエンス画面が表示されます。

2. オーディエンスを追加をクリックします。
   オーディエンス画面が開きます。作成タブが表示されます。

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

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

5. オーディエンスをインポートするを選択してください。
6. APIをクリックしてください。
7. APIアクション を選択してください。
   • デバイスの追加：既存のオーディエンスにデバイス広告IDを追加します。
   • デバイスの削除：既存のオーディエンスからリスト内のデバイス広告IDを削除します。
     注：APIアクションを選択すると、参照されるエンドポイントパスが変更されます。オーディエンスを保存した後は保持されません。オーディエンスにデバイスを追加または削除する場合、必要なパスを使用してアクションを指定できます。
8. APIリクエストURLをコピー：APIトークンはすでにURLに含まれています。
9. APIリクエスト本文をコピーしてください。
10. オーディエンスを保存して続行をクリックしてください。
11. （オプション）オーディエンスをパートナーに連携してください。
12. デバイスIDを含むAPIを用意し、上記の例で示すようにAPIをAppsFlyerにポストしてください。

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

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": [
      "a23416b8-a21a-4051-a62f-5d3cb85e16ed",
      "09a14a6b-cce8-44f3-8f77-62eff8b5aa4f",
      "289da41f-0473-4977-89ae-8fc92234a921"
     ]
}

APIに関する制限事項

• 1つのリクエストにつき、1つのオーディエンスにのみデバイスを追加できます。
• 1つのリクエストにつき、1つのオーディエンスからのみデバイスを削除できます。
• バッチリクエスト（複数オーディエンス）はサポートされていません
• 1つのリクエストにつき、最大1万件のデバイスIDを送信できます。