概要:BIやCRMなどの社内システムで定義したオーディエンスセグメントをAppsFlyer Audiencesにインポートすると、Audiencesを使って広告パートナーとの接続やセグメントの維持・更新を行えます。
オーディエンスをインポートする理由
社内システムですでにオーディエンスセグメントを定義している場合があります。デバイス識別子やユーザー識別子のリストとしてこれらをAppsFlyerにインポートすると、Audiencesを通じて、すべてのオーディエンスセグメントと広告パートナーの接続を一元的に管理・維持できます。識別子のマッチングやデータの補完、接続先のキャンペーン指標など、Audiencesのほかの機能も活用できます。
以下に例を示します。
例
プロモーションによるリマーケティング
ユーザーの誕生月に、特典などのプロモーションを配信する場合。
Audiencesでは、以下のように対応できます。
- 社内CRMで、誕生日情報を含むユーザーリストを作成します。
- 誕生月ごとにリストを分割し、それぞれ広告IDのリストとして出力します。
- 各リストをオーディエンスとしてAppsFlyerにインポートし、プロモーションを実施するパートナーに接続します。
- 対象のパートナーでキャンペーンを設定し、それぞれのオーディエンスに配信します。
新たなユーザーの獲得
自社のアプリ開発スタジオが別のスタジオを買収した場合。買収したスタジオが保有する、過去にアプリをインストールしたユーザーのデバイスIDを使い、自社の既存アプリのインストールを促します。
Audiencesでは、以下のように対応できます。
- 買収したスタジオからデバイスIDのリストを取得し、オーディエンスとしてAppsFlyerにインポートします。
- キャンペーンを実施するパートナーにオーディエンスを接続します。
- 対象のパートナーでキャンペーンを設定し、該当ユーザーに配信します。
AudiencesインポートV2.0
この記事では、新しいAudiencesインポート機能V2.0(CSVとAPIによるインポートに対応)の概念と手順を説明します。
インポートするオーディエンスの種類
オーディエンスをインポートする際は、2種類のいずれかを指定します。この指定により、AppsFlyerでの処理方法とパートナーへのアップロード方法が決まります。種類は初回インポート時に指定し、後から変更することはできません。
標準のインポートオーディエンス:
- 識別子のマッチングとデータ補完を行います。この処理では、インポートした識別子を、Audiencesのデータベースにある同じアプリの同じユーザーの識別子と照合し、パートナーにアップロードするオーディエンスデータを補完します。
- アカウントのユーザー識別子の共有ポリシーに従って、パートナーにアップロードします。
- この記事で説明するV2.0のインポート機能を使用する必要があります。
インポートしたままのオーディエンス:
- 識別子のマッチングやデータ補完を行いません。
- アカウントのユーザー識別子の共有ポリシーを参照せず、インポートしたすべての識別子をパートナーにアップロードします。
- この記事で説明するV2.0のインポート機能を使用できます。
重要
- 2021年11月23日時点で存在するすべてのオーディエンスは、インポートしたままのオーディエンスに指定されており、標準オーディエンスには変更できません。これらのオーディエンスは、この記事で説明するV2.0のインポート機能で引き続き更新できます。
- 同時に有効にできるインポートオーディエンスは、最大500件です。
- 新しいインポートオーディエンスを「インポートしたまま」に指定できるのは、管理者のみです。
- CUIDを識別子に使用してインポートする場合、関連デバイスとの完全な紐付けとデバイス識別子(GAID、IDFA)によるデータ補完を行うには、インストール時にAppsFlyerがCUIDの関連付け情報を受信している必要があります。インストール後のイベントだけで送信しても不十分です。詳細はこちら
オーディエンスのインポート手順
CSVファイルのアップロード、またはImport Audience APIを使ってインポートします。
CSVファイルのインポート
以下の仕様に従ってCSVファイルを作成します。
形式
- アップロードするユーザー識別子ごとに1列
- 各列の識別子名をすべて小文字で記載したヘッダー行
- 空行なし
- 最大行数:100万行
- Excelで作成する場合は、以下の画像のように、CSV(コンマ区切り)(*.csv)形式で保存してください。
識別子のハッシュ
注意
このCSV形式は、オーディエンスセグメントのインポート用です。ユーザー属性データをインポートする場合は、ユーザー属性データを活用したオーディエンス作成を参照してください。ヘッダー行のない、別のCSV形式を使用します。
列と識別子
- ヘッダー行で各列のデータを識別するため、以下のように指定できます。
- 列の順序は任意です。
- アップロードしない識別子の列は不要です。
- 以下で説明する必須の識別子を各行に含めれば、1つのCSVファイルに複数の識別子を含められます。
- 利用可能な識別子:
- app_id
- idfv
- idfa
- gaid
- oaid
- imei
- cuid
- emails
- phone
- phone_e164
- braze_id
- amplitude_id
注意:emailsやphoneなどの追加識別子は、SHA256でハッシュ化するか、空欄にする必要があります。
- 必須の識別子:
- Androidオーディエンス:app_idと、gaid、oaid、imei、cuid、braze_id、amplitude_idのいずれか1つ
- iOSオーディエンス:app_idと、idfv、cuid、braze_id、amplitude_idのいずれか1つ
- Googleによる2024年3月6日のデジタル市場法(DMA)への対応に伴い、「インポートしたままのオーディエンス」をインポートする際には、AppsFlyerの同意に関する列を2つ追加する必要があります。追加する列は、以下のとおりです。
| AppsFlyerの同意に関する列 | Googleのフィールド | 値 | 項目の意味 |
|---|---|---|---|
| ad_personalization_enabled | ad_personalization | true/false | データをパーソナライズ広告に使用することについて、ユーザーがGoogleに同意したか。 |
| ad_user_data_enabled | ad_user_data | true/false | ユーザーデータをGoogleに送信することについて、ユーザーが同意したか。 |
同意フィールドに値がない場合は「Unspecified」としてGoogleに送信され、Google側のオーディエンスには含まれない可能性が高くなります。これらを入力することで、欧州経済領域(EEA)のユーザーをGoogleのオーディエンスに最大限含めることができます。
CSVファイルの例:
new-import-android-example.csv
new-import-ios-example.csv
CSVファイルで新しいオーディエンスを作成・インポートするには:
- AppsFlyerの左側のメニューで[Engage]>[Audiences]に移動します。
- [新しいオーディエンス]をクリックします。
- [オーディエンスをインポート]を選択します。
[オーディエンスをインポート]ウィンドウが開きます。 - 一意の[オーディエンス名]を入力します。
注意:オーディエンス名には、以下の特殊文字を使用できません(" ’ # % & * + / : ; < = > ? ( ) [ ] { } \ | ~) - オーディエンスのプラットフォームとして、AndroidまたはiOSを選択します。
- 標準オーディエンスか、インポートしたままのオーディエンスかを指定します。
- 標準オーディエンスの場合は、チェックボックスをオフのままにします。
- インポートしたままのオーディエンスの場合は、チェックボックスをオンにします。(注意:この選択肢は管理者のみ利用できます。)
- [オーディエンスを保存して続行]をクリックします。
[インポート]タブが表示されます。 - 新しいオーディエンスのため、[CSVでインポート]の設定はデフォルトの[新しいデバイス・ユーザーを追加]のままにします。
- アップロードするCSVファイルを選択します。
確認メッセージ[アップロードが完了しました]が表示されるまで待ちます。 - [次へ]をクリックします。
[接続]タブが表示されます。 - [任意]オーディエンスをパートナーに接続する手順に従います。
- [完了]をクリックします。
オーディエンスがインポートされ、パートナーに接続されて、Audiencesの管理画面に表示されます。ただし、インポートしたオーディエンスの処理は日次更新のため、この時点ではパートナーへのアップロードにまだ使用できません。
CSVファイルで既存のオーディエンスを更新するには:
- AppsFlyerの左側のメニューで[Engage]>[Audiences]に移動します。
- 更新するオーディエンスの名前をクリックします。
[オーディエンスを編集]画面が開き、[定義]タブが表示されます。 - オーディエンス名を変更する場合は、ここで編集できます。変更しない場合は、[インポート]タブを選択し、新しいCSVファイルをアップロードします。
- [CSVでインポート]で、アップロードするリストの処理を選択します。
- 新しいデバイス・ユーザーを追加:既存オーディエンスにデバイス識別子・ユーザー識別子を追加
- 既存オーディエンスからデバイス・ユーザーを削除:アップロードしたリストのデバイス識別子・ユーザー識別子を、オーディエンスから削除
- 新しいデバイス・ユーザーで既存オーディエンスを上書き:オーディエンス全体をアップロードしたリストに置き換え
- アップロードするCSVファイルを選択します。
確認メッセージ[アップロードが完了しました]が表示されるまで待ちます。 - [次へ]をクリックします。
[接続]タブが表示されます。 - 必要に応じて、このオーディエンスのパートナー接続を変更します。
- [完了]をクリックします。
CSVファイルでオーディエンスが更新されます。ただし、インポートしたオーディエンスの処理は日次更新のため、この時点では変更後のリストはまだパートナーにアップロードされていません。
エラーメッセージ
| メッセージ | 原因 | 対処方法 |
|---|---|---|
| デバイスリストに問題があります | デバイスリストに1つ以上の問題がある |
CSVファイルが以下の条件を満たすことを確認してください。
|
| デバイスリストが空のようです。デバイスIDを追加して、もう一度お試しください | CSVファイルが空 | CSVに少なくとも1つのデバイスIDが含まれることを確認してください。 |
| 1つ以上のデバイスIDを認識できませんでした。 |
|
|
| オーディエンスにアカウントのポリシーを適用している場合、インポートV1は使用できません。 | 標準オーディエンス用のCSVファイルを、V1.0の形式でアップロードしている標準オーディエンスは、V2.0形式のCSVでアップロードする必要があります。 | 上記の形式、列、識別子を使用するようCSVファイルを修正してください。 |
| 一時的な接続の問題により、ファイルをアップロードできませんでした。もう一度お試しください。 | ネットワークエラーの可能性 | CSVファイルを再度アップロードしてください。 |
Import Audience APIの使用
Import Audience APIは、オーディエンスへのデバイスの追加・削除に使用します。
APIで新しいオーディエンスをインポートするには:
- AppsFlyerの左側のメニューで[Engage]>[Audiences]に移動します。
- [新しいオーディエンス]をクリックします。
- [オーディエンスをインポート]を選択します。
[オーディエンスをインポート]ウィンドウが開きます。 - 一意の[オーディエンス名]を入力します。
注意:オーディエンス名には、以下の特殊文字を使用できません(" ’ # % & * + / : ; < = > ? ( ) [ ] { } \ | ~) - オーディエンスのプラットフォームとして、AndroidまたはiOSを選択します。
-
標準オーディエンスか、インポートしたままのオーディエンスかを指定します。
- 標準オーディエンスの場合は、チェックボックスをオフのままにします。
- インポートしたままのオーディエンスの場合は、チェックボックスをオンにします(この選択肢は管理者のみ利用できます)。 Googleによる2024年3月6日のデジタル市場法(DMA)への対応に伴い、「インポートしたままのオーディエンス」のインポートには、2つの同意フィールドの追加が必要です。これらを入力することで、欧州経済領域(EEA)のユーザーをGoogleのオーディエンスに最大限含めることができます。
- [保存]をクリックします。
インポートページが表示されます。 - 新しいオーディエンスのため、[APIでインポート]の設定はデフォルトの[新しいデバイス・ユーザーを追加]のままにします。
- 新しいオーディエンスのインポートAPIのページから、APIリクエストURLをコピーします(APIトークンはすでに含まれています)。
- 続いて、APIリクエスト本文をコピーして貼り付けます。
- [完了]をクリックします。
[接続]タブが表示されます。 - [任意]オーディエンスをパートナーに接続する手順に従います。
- [完了]をクリックします。
- ユーザー識別子・デバイス識別子を含むAPIリクエストを作成し、AppsFlyerにPOSTします。
APIで既存のオーディエンスを更新するには:
- AppsFlyerの左側のメニューで[Engage]>[Audiences]に移動します。
- 更新するオーディエンスの名前をクリックします。
[オーディエンスを編集]画面が開き、[定義]タブが表示されます。 - オーディエンス名を変更する場合は、ここで編集できます。変更しない場合は、[インポート]タブを選択します。
- [APIでインポート]で、アップロードするリストの処理を選択します。
- 新しいデバイス・ユーザーを追加:既存オーディエンスにデバイス識別子・ユーザー識別子を追加します。
- 既存オーディエンスからデバイス・ユーザーを削除:既存オーディエンスからデバイス識別子・ユーザー識別子を削除します。
- 新しいオーディエンスのインポートAPIのページから、[APIリクエストURL]をコピーします(APIトークンはすでに含まれています)。注意:この選択肢を変更すると、コピーするコード内のエンドポイントのパスも変わります。今回と今後のAPIリクエストでは、実行する操作に対応した正しいエンドポイントを使用してください。
- 続いて、[APIリクエスト本文]をコピーします。
- [次へ]をクリックします。
[接続]タブが表示されます。 - 必要に応じて、このオーディエンスのパートナー接続を変更します。
- [完了]をクリックします。
- ユーザー識別子・デバイス識別子を含むAPIリクエストを作成し、AppsFlyerにPOSTします。
注意:APIでインポートした場合、オーディエンスの更新まで24時間かかります。
レスポンスコード
| コード | メッセージ | 説明 |
|---|---|---|
| 200 | リクエストが成功しました | オーディエンスのインポートが完了 |
| 400 | オーディエンスのプラットフォームが無効です。このオーディエンスはすでにAndroid/iOS用に設定されています。別のプラットフォームを使用する場合は、UIで新しいオーディエンスを作成してください | リクエスト本文のプラットフォームが、オーディエンス作成時の設定と一致しない |
| 400 | X行以上でアプリIDが指定されていません。各行にアプリIDを指定する必要があります。 |
各行にapp_idが必要
|
| 400 | X行以上で有効な一意の識別子が指定されていません |
すべてまたは一部の行で、以下のいずれかの識別子が有効な形式で指定されていない
|
| 400 | 1リクエストでY台を超えるデバイスは処理できません(このリクエストにはn台含まれています) | リクエスト本文のデバイスIDが10,000件を超えている |
| 400 | デバイスリストは空にできません |
リクエスト本文のデバイスリストが空 1リクエストにつき、少なくとも1つのデバイスIDが必要です |
| 400 | 1つ以上のデバイスIDを認識できませんでした | すべてまたは一部のデバイスIDの形式が無効 |
| 400 | 削除対象のX台以上で、デバイスごとに複数の識別子が指定されています | デバイスごとに複数の識別子を指定した削除リクエストが送信されている |
| 403 | アクセスが拒否されました | 未認証のリクエスト:インポートキーが正しくないか、指定されていない |
| 429 | リクエスト数が多すぎます | リクエストは毎分350件まで |
| 500 | リクエストを解析できませんでした |
リクエスト本文の形式が無効(想定したJSON構造ではない、またはJSONではない) 上記のリクエスト例を参照してください |
APIの制限
- 1リクエストでデバイスを追加できるオーディエンスは1つのみです。
- 1リクエストでデバイスを削除できるオーディエンスは1つのみです。
- 1リクエストで送信できるデバイスIDは最大10,000件です。
- リクエストは毎分最大350件まで送信できます。
Imported Audience Management API
Imported Audience Management APIでは、インポートオーディエンスの作成・設定、パートナーへの接続、パートナーへのアップロードなどを行えます。
- new-import-ios-example.csv374 バイト
- new-import-android-example.csv352 バイト