AppsFlyer

AppsFlyer は、モバイル広告に関する宣伝効果の測定 ( アトリビューション ) および収集したデータの分析 ( アナリティクス ) において、業界における標準のツールになりつつあります。AppsFlyer が提供する正確な測定・分析結果に基づき、広告の提供元は、広告のターゲットの絞り込み、投資額の見直しなどを行え、よって、投資対効果 ( ROI ) を最適化できます。

AppsFlyer を使用すれば、アプリのインストール状況、ダウンロード状況、コンバージョン情報 ( conversion/目的達成の成否 ) などを監視・追跡できます。また、AppsFlyer 提供の API を使用すれば、他のアプリ/プラットフォームと連携することができます。

事前準備

AppsFlyer を使用した監視・追跡を行う前に、次の情報が必要となります。

1. devKey: AppsFlyer 提供の devKey です。
2. appId: ( iOS の場合 ) App Store で使用する App ID です。

Monaca プロジェクトに AppsFlyer を追加する方法

1. Monaca クラウド IDE から、 設定 → 外部サービス連携 を選択します。

2. AppsFlyer サービスの 詳細を見る ボタンをクリックします。

3. インストール ボタンをクリックします。

   

4. インストールを継続するか確認する画面が表示されます。 OK をクリックして、インストールを開始します。

設定

次の記述を追加します。devKey ( および appID ) を渡して、監視・追跡処理を初期化します。

document.addEventListener("deviceready", function(){

    var options = {
        devKey:  'xxXXXXXxXxXXXXxXXxxxx8'  // your AppsFlyer devKey
    };

    var userAgent = window.navigator.userAgent.toLowerCase();

    if (/iphone|ipad|ipod/.test(userAgent)) {
        options.appId = "123456789";       // your ios app id in app store
    }

    window.plugins.appsFlyer.initSdk(options);

}, false);

使い方

SDK の初期化

SDK を初期化します。

initSdk(options, onSuccess, onError): void

パラメーター

options オブジェクト

例

initSdk() 関数の使用例を、次に記します。

var onSuccess = function(result) {
    //handle result
};

function onError(err) {
    // handle error
}

var options = {
    devKey:  'd3Ac9qPardVYZxfWmCspwL',
    appId: '123456789',
    isDebug: false,
    onInstallConversionDataListener: true
};

window.plugins.appsFlyer.initSdk(options, onSuccess, onError);

アプリ内イベントトラッキング API

trackEvent メソッドを使用して、AppsFlyer の分析メカニズム ( AppsFlyer analytics ) 側に、アプリ内イベントの収集データを渡します。また、このメソッドを使用すれば、監視対象のイベントを、コードに直接追加して、動的に追加できるようになります。アプリ内イベントを使用すると、ユーザーの動向を分析できます。また、各種キャンペーンおよびメディアソースへの関連付けもできます ( ユーザーの操作と、そのきっかけとなったキャンペーンなどを対応付けできます )。ROI ( 投資対効果 ) と LTV ( 顧客生涯価値 ) の計算に必要となる、データ収集対象のイベントに関しては、慎重に選択する必要があります。

trackEvent(eventName, eventValues): void (optional)

パラメーター

例

trackEvent() 関数の使用例を、次に記します。

var eventName = "af_add_to_cart";

var eventValues = {
    "af_content_id": "id123",
    "af_currency":"USD",
    "af_revenue": "2"
};

window.plugins.appsFlyer.trackEvent(eventName, eventValues);

通貨コードの設定

通貨コードを変更できます。

setCurrencyCode(currencyId): void

パラメーター

例

setCurrencyCode() 関数の使用例を、次に記します。

window.plugins.appsFlyer.setCurrencyCode("USD");
window.plugins.appsFlyer.setCurrencyCode("GBP"); // British Pound

カスタマーユーザー ID の設定 ( 詳細 )

カスタム ID をセットします。AppsFlyer 提供の ID 群 ( 端末 ID、ユーザー ID など ) と、このカスタム ID を紐づけすれば、各種情報を、カスタム ID 下に集約できるようになります。このカスタム ID ( AppsFlyer 側とユーザー側で使用している ID の紐づけに使用 ) は、AppsFlyer が提供する CSV レポートを出力時、および、PostBack 系の API の使用時にも使用できます。

setAppUserId(customerUserId): void

パラメーター

例

setAppUserId() 関数の使用例を、次に記します。

window.plugins.appsFlyer.setAppUserId(userId);

GCM プロジェクト番号の設定

GCM のプロジェクト番号をセットします。この番号を使用して、アプリのアンインストールを監視・追跡します ( Android プラットフォーム向け )。

setGCMProjectID(GCMProjectNumber): void

パラメーター

トラッキングのアンインストール

アプリのアンインストールを監視・追跡するため、iOS のデバイストークンをセットします ( iOS プラットフォーム向け )。

registerUninstall(token): void

パラメーター

AppsFlyer のデバイスIDを取得する

この API を使用すれば、AppsFlyer 側で独自に割り振っている端末 ID を取得できます。この端末 ID は、各種レポートの出力時、および、各種 API で使用されます。

getAppsFlyerUID(getUserIdCallbackFn): void

パラメーター

例

getAppsFlyerUID() 関数の使用例を、次に記します。

var getUserIdCallbackFn = function(id) {
    alert('received id is: ' + id);
}
window.plugins.appsFlyer.getAppsFlyerUID(getUserIdCallbackFn);

ディープリンク トラッキング

AppsFlyer のアトリビューション データを使用して、ディープリンクを追跡します。

handleOpenUrl(url): void

パラメーター

例

The following snippet shows how to use handleOpenurl() function:

var handleOpenURL = function(url) {
    window.plugins.appsFlyer.handleOpenUrl(url);
}