既存のアトリビューション・データのインポート FAQ

ドキュメント

既存のインストールアトリビューション情報を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 check.svg Singularのアプリページに表示されるアプリ名 マイアプリ
app_id check.svg Android/iOSそれぞれのアプリのパッケージ名/バンドルID。

注意: App Store IDは使用しないでください (例:id1441750662)

com.singular.app
os check.svg AndroidまたはiOSを指定する AndroidまたはiOS
idfa 広告主のiOS ID:IDFAとIDFVの両方が利用可能な場合は、両方を提供する必要があります。 DFC5A647-9043-4699-B2A5-76F03A97064B
idfv check.svg ベンダー用iOS ID 21DB6612-09B3-4ECC-84AC-B353B0AF1334
gaid check.svg グーグル広告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デバイスのみ アマゾン