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

プレミアム機能

概要:社内システム (BI、CRM など) から既に定義済みのオーディエンスセグメントを AppsFlyer オーディエンスにインポートしましょう。そうすることで、オーディエンスを使用して、これらのセグメントを広告パートナーと連携し、維持することができます。

オーディエンスをインポートする必要性

社内システムで定義済みのオーディエンスセグメントがある場合、これらのオーディエンス (デバイスおよび/またはユーザー識別子の一覧) をAppsFlyerにインポートすることで、AppsFlyerのオーディエンス機能を中心に、全てのオーディエンスセグメントを広告パートナーと接続し一元管理することができます。また、識別子の照合やデータの充実、キャンペーンの指標との連携など、他のオーディエンス機能を最大限に活用することができます。

次のユースケースをご覧ください。

 例

販促版リマーケティング
誕生月のユーザーを対象にプロモーションを実施したいと考えています。

このためにオーディエンス機能を使った方法をご紹介します。

  1. 社内 CRM を使ってユーザーのリストを誕生日と一緒に作成してください。
  2. 誕生月に応じてリストをセグメント化し、広告IDの個別リストをエクスポートしてください。
  3. このリストをオーディエンスとして AppsFlyer にインポートし、プロモーション・キャンペーンを実施したいパートナーと連携してください。
  4. パートナーと関連するオーディエンスを対象とするキャンペーンを設定してください。

追加ユーザーの獲得
アプリ開発スタジオが別のスタジオを買収します。買収したスタジオは以前同社のアプリをインストール済のユーザーのデバイスIDを把握しています。今回これらのユーザーを対象に、自社アプリをインストールを促すキャンペーンを実施します。

このためにオーディエンス機能を使った方法をご紹介します。

  1. 買収したスタジオからデバイス ID のリストを取得し、AppsFlyer にオーディエンスとしてインポートしてください。
  2. キャンペーンを実施したいパートナーにオーディンスを接続してください。
  3. これらのユーザーを対象に、関連するパートナーとキャンペーンを設定してください。

オーディエンスインポート V2.0

こちらの記事では、新しいオーディエンスインポート機能 V2.0(CSV と API によるインポートのオプション)に関するコンセプトと手順について説明します。 

インポートするオーディエンスの種類

オーディエンスをインポートする際、次のいずれかの種類を指定する必要があります。これにより、AppsFlyerがアップロードされたオーディエンスをどのように処理しパートナーへアップロードするかが決まります。この指定は、オーディエンスが最初にインポートされたときに行われるもので、あとで変更することはできません。

標準的なインポートオーディエンス:

  • 識別子の照合とデータの強化を実施します パートナーにアップロードされたオーディエンスデータを充実させるために、オーディエンスがインポートされた識別子をオーディエンスデータベース内の既存の識別子(同じアプリの同じユーザーのもの)と照合するプロセスです。
  • パートナーへのアップロードは、アカウントのユーザー識別子ポリシーに従って実行されます。
  • この記事で紹介しているV2.0のインポート機能を使ってインポートする必要があります。

インポートされた「現状のまま」のオーディエンス

  • 識別子マッチングとデータエンリッチメントの処理は実行されません。
  • アカウントのユーザー識別子ポリシーを無視してパートナーにアップロードされます(つまり、インポートされたすべての識別子がパートナーにアップロードされます)。
  • V2.0 のインポート機能(この記事で紹介)を使ってインポートすることができます。

 重要:

  • 2021年11月23日の時点で存在する全てのオーディエンスは、現状のままのオーディエンスと定義され標準オーディエンスに変更することはできません。これらのオーディエンスは、V2.0 のインポート機能(こちらの記事で説明)を使用して、必要に応じて更新し続けることができます。
  • インポートしたオーディエンスは一度に500人までアクティブにすることができます。
  • アドミンのみが新しいインポートオーディエンスを現状のままのオーディエンスとして指定できます。
  • CUIDを識別子としてオーディエンスをインポートする場合、関連するデバイスとの完全な関連付けとデバイス識別子(GAID、IDFAなど)によるエンリッチメントを成功させるために、インストール時に(インストール後のイベントだけでなく)CUIDの関連付けをAppsFlyerが受信する必要があります。詳細はこちら

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

CSVファイルをアップロードするか、オーディエンスインポートAPIを使用して、オーディエンスをインポートしてください。

CSVファイルのインポート

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

形式

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

    CSV.jpg

列と識別子

  • データは、各列のデータを識別するためにヘッダー行を使用して取り込まれます。そのため、
    • 列の並び順には、特に指定がありません。
    • アップロードされていない識別子の欄を設ける必要はありません。
    • 以下で詳しく説明するとおり、各行に必要な識別子が含まれていれば、1つのCSVファイルに必要な数の識別子をインポートすることができます。
  • 使用できる識別子:
    • app_id
    • idfv
    • idfa
    • gaid
    • oaid
    • imei
    • cuid
    • emails
    • phone
    • phone_e164
    • braze_id
    • amplitude_id
  • 必須の識別子:
    • Androidオーディエンス:app_id + 次のいずれか一つ:gaidoiadimeicuidbraze_id または amplitude_id
    • iOSオーディエンス:app_id + 次のうち1つ:idfv または cuid または braze_id または amplitude_id
  • 2024年3月6日の Google によるデジタルマーケット法(DMA)の施行に伴い、「現状のまま」のオーディエンスをインポートする場合、AppsFlyer の同意欄を2つ追加する必要があります。これらは以下の通りです:
AppsFlyer の同意欄  Google のフィールド  フィールドの説明
ad_personalization_enabled ad_personalization true/false ユーザーが Google に対し、自分のデータをパーソナライズ広告に使用することに同意したかどうか
ad_user_data_enabled ad_user_data true/false ユーザーがユーザーデータをGoogleに送信することに同意したかどうか 

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

CSVファイルの例:

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

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

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

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

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

  1. AppsFlyer の左側のパネルで、エンゲージ > オーディエンスの順で移動します。
  2. アップロードしたいオーディエンス名をクリックしてください。
    オーディエンスの編集画面が開き、Define/定義タブが表示されます。
  3. オーディエンス名を編集したい場合は、ここで編集してください。それ以外の場合は、インポートタブを選択して新しいCSVファイルをアップロードしてください。
  4. CSVを使用してインポートするセクションで、アップロードされたリストをどう処理するかを選択してください。
  5. 新しいデバイス/ユーザーを追加する:既存のオーディエンスにデバイス/ユーザー識別子を追加する。
  6. 既存のオーディエンスからデバイス/ユーザーを除外する:アップロードされたリストのデバイス/ユーザー識別子をオーディエンスから削除する
  7. 既存のオーディエンスを新しいデバイス/ユーザーで上書きする:オーディエンス全員をアップロードされたリストに置き換える
  8. アップロードする CSV ファイルを選択してください。
    Uploaded successfully / 正常にアップロードされましたという確認メッセージが表示されるのを待ってください。
  9. 次へをクリックします。
    Connect / 連携タブが表示されます。
  10. 必要に応じて、このオーディエンスのパートナー接続を変更してください。
  11. 完了をクリックしてください。

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

確認メッセージ

メッセージ 原因 対処法
正常にアップロードされました    
デバイスリストに問題がある デバイスリストに関する1つまたは複数の問題 CSV ファイルを確認してください:
  • デバイスと GAID/IDFA 識別子が正しい形式で入力されている
  • 必要な識別子が含まれている
  • ヘッダー行が含まれ、ヘッダーが正しい形式である
  • 空白行がない
  • app_idには、オーディエンスに使用する正しいアプリが入力されている
デバイスリストが空です。デバイスIDを追加してから再度実行してください CSVファイルが空です。

CSVに少なくとも1つのデバイスIDが含まれていることを確認してください。

デバイス ID の1つまたは複数を識別できませんでした
  • CSV 形式が正しくありません
  • アップロードしたファイルが CSV 形式ではありません。
  • CSV ファイルは、有効な CSV エディター以外のプログラムによって編集および保存されました(例、Microsoft Excel)
  • デバイス ID の形式に誤りがあります。
  • CSV が必要な形式に沿っていることを確認してください。
  • すべてのデバイス ID が正しい形式であることを確認してください。
  • Excel を使用した場合、上記のとおり CSV ファイルで保存してください。
オーディエンスにユーザーアカウントポリシーを適用する場合、インポートv1は使用できません。 V1.0のインポート構成を使用して、標準オーディエンスのCSVファイルをアップロードしました。標準オーディエンスはV2.0の構成でのCSVを使用してアップロードする必要があります。 アップロードするCSVファイルを、上記のフォーマット、列、識別子に合わせて編集してください。
一時的な接続障害が発生し、ファイルをアップロードできませんでした。You can try again now(接続に一時的な問題が発生したため、ファイルをアップロードできませんでした。今すぐ再試行してください) ネットワークエラーの可能性があります。 再度CSVファイルをアップロードしてください。

オーディエンスインポートAPIの使用

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

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

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

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

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

レスポンスステイタスコード

コード メッセージ 説明

200

リクエストに成功しました

オーディエンスが正常にインポートされました。

400 無効なオーディエンスプラットフォームです。このオーディエンスはすでに Android/iOS 用に設定されています。別のプラットフォームを使用するには、UI で新しいオーディエンスを作成してください。 リクエスト本体で指定されたプラットフォームとオーディエンス作成のプラットフォームが一致していません。
400 行の X またはそれ以上にアプリ ID が含まれていません。App ID を各行に付ける必要があります。

各行に app_id が含める必要があります

  • 注:V1.0 インポート機能を使用してインポートされる as-is audience では、app_id は必要ありません。
400 行の X またはそれ以上にy有効な一位の識別子が含まれていません

すべての行または一部の行に、以下の識別子のうち少なくとも1つが有効な形式で含まれていません。

  • Androidオーディエンス:gaidoiadimeicuidbraze_id または amplitude_id
  • iOSオーディエンス:idfvcuidbraze_id または amplitude_id
400 一つのリクエストにつき Y 以上のデバイスを処理できません (このリクエストには n 個のデバイスがふくまれています)

リクエスト本文に、10,000以上のデバイスIDリストが含まれています。

400 デバイスリストは空にできません

リクエスト・ボディに空のデバイスリストが含まれています

リクエストにつき最低1つのデバイス ID を提供する必要があります

400 デバイス ID の1つまたは複数を識別できませんでした すべてまたは一部のデバイスIDが有効なフォーマットではありません。

400

削除するデバイスのX個以上に、デバイスごとに複数の識別子が含まれています

デバイスごとに複数の識別子を含む削除リクエストが送信されました

403 禁止されています 不正なリクエスト:インポートキーが間違っているか、見つかりません
429 リクエストが多すぎます リクエストは1分間に350件まで
500 リクエストを解析できませんでした

無効なリクエスト・ボディの形式です(指定された形式の JSON ではないか、そもそも JSON ではありません

上記のリクエストサンプルを参照してください。

API の制限

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

インポート済みオーディエンス管理 API

インポート済みオーディエンス管理 API を使用すると、広告主はインポートされたオーディエンスの作成と設定、インポートされたオーディエンスのパートナーへの接続、インポートされたオーディエンスのパートナーへのアップロードなどを行うことができます。