オーディエンス - オーディエンスをインポート

次の仕様に従って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 + 以下のいずれか: idfv、cuid、braze_id、amplitude_id
• Googleが2024年3月6日に施行するデジタルマーケット法（DMA）に則り、「現状のまま」のオーディエンスをインポートする場合は、AppsFlyerの同意列を2つ追加する必要があります。それらは以下の通りです：

同意フィールドに値が入力されていない場合、「未指定」としてGoogleに送信され、Google上のオーディエンスには含まれない可能性があります。これらのフィールドを満たすと、Googleのオーディエンスに欧州経済地域（EEA）のユーザーを最大限に含めることができます。

CSVファイルの例:

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

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

1. AppsFlyer の左側のパネルで、Engage > オーディエンス に進んでください。
2. "新しいオーディエンス" をクリックしてください。
3. オーディエンスのインポートを選択します。
   オーディエンスのインポートウィンドウが開きます。
4. 一意のオーディエンス名を入力してください。
5. オーディエンスプラットフォームを選択してください:Android または iOS。
6. このオーディエンスが標準オーディエンスか、現状のままのオーディエンスかを示してください。
7. 標準オーディエンスの場合、ボックスにチェックを入れないでください。
8. 現状のままのオーディエンスの場合、ボックスにチェックを入れてください。(注意: このオプションは管理者のみが利用できます。)
9. 「オーディエンスを保存して続行」をクリックします。
   インポートタブが表示されます。
10. CSVを使用したインポートセクションで、デフォルトの新しいデバイス/ユーザーの追加をそのまま使用します（新しいオーディエンスなので）。
11. アップロードするCSVファイルを選んでください。
    確認メッセージアップロード成功を待ちます。
12. ［次へ］をクリックします。
    接続タブが表示されます。
13. (オプション)オーディエンスをパートナーに接続する手順に従ってください。
14. 「完了」をクリックします。

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

既存オーディエンスをCSVファイルで更新するには：

1. AppsFlyer の左側のパネルで、Engage > オーディエンス に進んでください。
2. 更新したいオーディエンスの名前をクリックします。
   オーディエンス編集画面が開き、定義タブが表示されます。
3. オーディエンス名を編集したい場合はここで編集できます。それ以外の場合は、インポートタブを選択して新しいCSVファイルをアップロードします。
4. CSVを使用したインポートセクションで、アップロードされたリストの処理方法を選択します。
5. 新しいデバイス/ユーザーを追加する既存のオーディエンスにデバイス/ユーザー識別子を追加します。
6. 既存のオーディエンスからデバイス/ユーザーを削除する:アップロードされたリスト内のデバイス/ユーザー識別子をオーディエンスから削除します。
7. 既存のオーディエンスを新しいデバイス/ユーザーで上書きする:オーディエンス全体をアップロードしたリストに置き換えます。
8. アップロードするCSVファイルを選んでください。
   確認メッセージアップロード成功を待ちます。
9. ［次へ］をクリックします。
   接続タブが表示されます。
10. 必要に応じて、このオーディエンスのパートナー接続を変更します。
11. 「完了」をクリックします。

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

エラーメッセージ

オーディエンスインポートAPIは、オーディエンスにデバイスを追加または削除するために使用します。 

APIを利用して新しいオーディエンスをインポートするには:

1. AppsFlyer の左側のパネルで、Engage > オーディエンス に進んでください。
2. 「新しいオーディエンス」をクリックします。
3. オーディエンスのインポートを選択します。
   オーディエンスのインポートウィンドウが開きます。
4. 一意のオーディエンス名を入力してください。
5. オーディエンスプラットフォームを選択してください:Android または iOS。
6. このオーディエンスが標準オーディエンスか、現状のままのオーディエンスかを示してください。
   • 標準のオーディエンスの場合は、チェックボックスをオフのままにします。
   • 現状のままのオーディエンスをインポートする場合、チェックボックスをオンにします（このオプションは管理者のみが利用可）。Googleが2024年3月6日にデジタルマーケット法（DMA）を施行するにあたり、「現状のままのオーディエンス」をインポートするには2つの追加の同意フィールドが必要です。これらのフィールドに入力することで、Googleオーディエンスに欧州経済領域（EEA）のユーザーを最大限に含められます。
7. 「保存」をクリックします。
   インポート ページが表示されます。
8. 「APIを使用してインポート」セクションでは、新しいオーディエンスのため、デフォルトの「新しいデバイス／ユーザーの追加」のままにします。
9. 「 新しいオーディエンスAPIのインポート 」ページからAPIリクエストURLをコピーします (APIトークンは既に含まれています)。
10. 次に、APIリクエストの本文をコピーして貼り付けます。
11. 「完了」をクリックします。
    接続タブが表示されます。
12. (オプション)オーディエンスをパートナーに接続する手順に従ってください。
13. 「完了」をクリックします。
14. ユーザー／デバイス識別子を含むAPIリクエストを準備し、AppsFlyerにPOSTしてください。 

APIを使用して既存のオーディエンスを更新するには:

1. AppsFlyer の左側のパネルで、Engage > オーディエンス に進んでください。
2. 更新したいオーディエンスの名前をクリックします。
   オーディエンス編集画面が開き、定義タブが表示されます。
3. オーディエンス名を編集したい場合はここで編集できます。それ以外の場合は「インポート」タブを選択します。
4. 「APIを使用してインポート」セクションで、アップロードされたリストをどう処理するかを選びます。
5. 新しいデバイス／ユーザーを追加:既存のオーディエンスにデバイス／ユーザー識別子を追加します。
6. 既存のオーディエンスからデバイス／ユーザーを削除する:既存のオーディエンスからデバイス／ユーザー識別子を削除します。
7. APIリクエストURLを新しいオーディエンスAPIのインポートページからコピーします (APIトークンは既に含まれています)。注: このオプションを変更すると、コピーされるコード内のエンドポイントパスが変更されます。実行するアクションに適したエンドポイントを必ず使用してください（このAPIリクエストおよび今後のAPIリクエスト）。
8. 次に、APIリクエスト本文をコピーします。
9. ［次へ］をクリックします。
   接続タブが表示されます。
10. 必要に応じて、このオーディエンスのパートナー接続を変更します。
11. 「完了」をクリックします。
12. ユーザー／デバイス識別子を含むAPIリクエストを準備し、AppsFlyerにPOSTしてください。

注:API経由でインポートする場合、オーディエンスの更新には24時間かかります。

応答コード

APIの制限

• 1つのリクエストで1つのオーディエンスにのみデバイスを追加できます。
• 1つのリクエストで1つのオーディエンスからのみデバイスを削除できます。
• 1回のリクエストで最大20,000個のデバイスIDを送信できます。
• 1分あたり最大350件のリクエストを送信できます。

インポートされたオーディエンス管理APIを利用すると、広告主はインポートしたオーディエンスを作成・設定し、パートナーに接続・アップロードすることが可能です。