既存のインストールアトリビューション情報をSingularプラットフォームにインポートする方法をご紹介します。
アトリビューションデータのインポートとは?
他のアトリビューションプロバイダーからSingularに乗り換える場合、アプリの既存ユーザーベースをインポートするというユニークなオプションを提供します。
このインポートにより、Singularはこれらのユーザーを既存ユーザーとしてマークし、インストール数を正確に保つことができます。Singularに切り替えた際に「オーガニックスパイク」が発生するのを防ぐことはできませんが、そのような事態を防ぐことができます。
アプリがSingularでライブトラフィックを受け取る前に、履歴データをSingularアカウントにインポートする必要があります。履歴データを読み込む前にアプリをアプリストアにリリースすると、オーガニックインストールが急増し、一部のデバイスのアトリビューションソースが不正確になります。
既存ユーザーはどのようにSingularで識別されますか?
Android端末の場合:
- デバイスのGoogle Advertising ID(GAID) または Android App Set ID(ASID)が必要です!
iOSデバイスの場合:
- デバイスのIDFV(Identifier for Vendor )が 必要です!
- デバイスの広告用識別子(IDFA )は オプション ですが、お持ちの場合はご提供ください!
重要です!有効な識別子がないデバイスはインポートされません。
カスタムユーザーIDをSingularと共有している場合でも、Singularはインポート処理(またはアトリビューション機能)にカスタムユーザーIDを使用しません。
注: 社内BIポストバックが設定されている場合、インポートされたユーザーはネットワークフィールドに「インポートユーザー」と表示されます。
Singularはどのようにデータを取り込みますか?
下記のデータファイル仕様に従ってフォーマットされたデータであれば、Singularは提供されたデータを取り込みます:
データファイルの仕様:
- データファイルの仕様:ファイル名の形式は、ファイル生成日をYYYYMMDDで開始し、アプリ名とプラットフォームを指定します。YYYYMMDD_アプリ名_プラットフォーム_インポート.csv
例:20170115_SingularDeviceAssist_iOS_Import.csv
- データファイルはUnixエンコードされたCSV(カンマ区切り)形式でなければなりません。
- データファイルはエラーなく正しくフォーマットされていること。
- データファイルのサイズはそれぞれ2GB以下でなければならない。データセットが大きい場合は,ファイルを分割してもよい.
- すべてのデータファイルは,仕様書で定義されている適切なヘッダー行を含んでいなければならない.
- すべてのUUIDv4識別子(IDFA、IDFV、GAID、ASIDなど)の長さは36文字でなければならない。
- 重複する行は削除されなければならない。
- 有効なデバイス識別子がない行はインポートされません。
- すべての値から、先頭と末尾のスペースを削除する必要があります。
重要!データファイルがこれらの要件を満たしていない場合、インポートは拒否され、正しいファイルが提供されるまでインポートは延期されます。
データファイルのレイアウト仕様
サンプルファイル
20170115_SingularDeviceAssist_Android_インポート.csv
20170115_SingularDeviceAssist_iOS_インポート.csv
| カラム名 | 必須 | 説明 | 値の例 |
| app_name | Singularのアプリページに表示されるアプリ名 | マイアプリ | |
| app_id | Android/iOSそれぞれのアプリのパッケージ名/バンドルID。 注意: App Store IDは使用しないでください (例:id1441750662) |
com.singular.app | |
| os | AndroidまたはiOSを指定する | AndroidまたはiOS | |
| idfa | 広告主のiOS ID:IDFAとIDFVの両方が利用可能な場合は、両方を提供する必要があります。 | DFC5A647-9043-4699-B2A5-76F03A97064B | |
| idfv | |
ベンダー用iOS ID | 21DB6612-09B3-4ECC-84AC-B353B0AF1334 |
| gaid | グーグル広告ID | 8ecd7512-2864-440c-93f3-a3cabe62525b | |
| asid |
|
アプリセットID:GAIDが提供されていない場合のみ必要です。GAIDとASIDの両方が利用可能な場合は、両方を提供する必要があります。 | 38400000-8cf0-11bd-b23e-10b96e40000d |
| android_id |
|
Android ID: GAIDとASIDが提供されていない場合のみ必要です。GAIDとASIDの両方が利用可能な場合は、Android IDを提供すべきではありません。 | FC8D449516DE0DFB |
| user_id | カスタムユーザーID | player_1234 | |
| デバイスメーカー | Amazonデバイスのみ | アマゾン |