React Nativeプラグインの実装

AppsFlyerのDev Keyはアカウント毎にユニークで、アカウントを識別するために必要です。SDKがAppsFlyerアカウントに関するデータを安全に送受信できるようにするために、Dev Keyは必須です。アカウント管理者のみがDev Keyをを取得できます。

Dev Keyを取得する方法：

1. AppsFlyerの管理画面へ移動してください。
2. メニューバーにて、設定の下にあるアプリ設定をクリックしてください。
3. SDK初期化の下にて、表示されるDev Keyをコピーします。

プラグインを初期化する方法：

1. app.js にて、次をインポートします。
   

   import appsFlyer from 'react-native-appsflyer';

2. 次のパラメーターを使用して、initSDK メソッドを呼び出します。

import React, {Component} from 'react';
import {Platform, StyleSheet, Text, View} from 'react-native';
import appsFlyer from 'react-native-appsflyer';

appsFlyer.initSdk(
{
    devKey: 'K2***********99',
    isDebug: false, // set to true if you want to see data in the logs 
    appId: '4*******4', // iOS app id
  },
  (result) => {
    console.log(result);
  },
  (error) => {
    console.error(error);
  }
);

アプリ内イベントを計測するには、推奨されるイベント名とパラメーターのリストを使用してください。

推奨設定以下の理由により、イベント名とパラメータを使用してください。

• これらの共通となるアプリ内イベント名を使うと、AppsFlyerからFacebook、Google、TwitterやSnapchatなどに自動的にマッピングします。
• 下位互換性：AppsFlyerがイベント名やパラメータを変更した場合でも、互換性があるため実装に影響はありません。

アプリ内イベントを計測するには、logEvent メソッドを使用します。

logEvent パラメーター

const eventName = "af_add_to_cart";
const eventName = "af_add_to_cart";
const eventValues = {
  af_content_id: "id123",
};
appsFlyer.logEvent(
eventName,
  eventValues,
  (res) => {
    console.log(res);
  },
  (err) => {
    console.error(err);
  }
);

af_revenue のイベントパラメーターを使用して、アプリ内イベントの収益の値を送信してください。

• af_revenue には、正負を問わず、あらゆる数値を入力できます。
• af_revenue は、ローデータレポートと管理画面上で実際の収益とみなされる唯一のイベントパラメーターです。詳細についてはこちらを参照してください。

通貨設定、通貨換算、管理画面上での表示の詳細も参照してください。

収益を含むイベントを送信する場合は、以下の通貨コードに関する要素を考慮してください。

• デフォルトの通貨設定：USD
• 通貨コードを3文字のISO 4217コードに従って設定します。
• コンマの値区切り、通貨記号、テキストなどは収益の値に含めないでください。
  収益値の例：1234.56

例：収益を含むアプリ内イベントの計測

const eventName = "purchase";
const eventValues = {
   "af_content_id": "id123",
   "af_currency":"USD",
   "af_revenue": "2"
};

 appsFlyer.logEvent(eventName,eventValues, (error, result) => {
   if (error) {
     console.error(error);
   } else {
     //...
   }
 });

ユーザーに払い戻しをする場合など、マイナスの収益を記録する必要がある場合があります。

const eventName = "refund";
const eventValues = {
   "af_content_id": "id123",
   "af_currency":"USD",
   "af_revenue": "-2" // The revenue value is preceded by a minus sign.
};

 appsFlyer.logEvent(eventName,eventValues, (error, result) => {
   if (error) {
     console.error(error);
   } else {
     //...
   }
 });

• イベント名：最大45文字まで(半角)
• イベント値：最大半角1000文字。超えた場合は切り捨てられる可能性があります
• 英字以外の文字は、iOSおよびAndroidのバージョン4.81.1（アプリ内イベントと他のSDK API）からサポートされています。
• 価格と収益について：
  • 5や5.2など、数値と小数点のみを使用してください。
  • 5.12345など、小数点以下は5桁まで使用可能です。

この機能の詳細については、アプリ内購入の検証のページを参照してください。

アプリ内購入の検証の機能は、 validateAndLogInAppPurchase を介してReact Nativeプラグインでも利用可能です。

コンバージョンデータを取得するには2つの方法があります。

• ディファードディープリンクは、コンバージョンデータに基づいて、ユーザーを特定のアクティビティとカスタマイズされたコンテンツに誘導します。
• 直接ディープリンクは、特定のアクティビティでアプリを起動し、コンバージョンデータに従ってコンテンツをカスタマイズします。

ディファードディープリンク：onInstallConversionData

コンバージョンデータを取得するには、onInstallConversionData を実装します。コードサンプル：

this.onInstallConversionDataCanceller = appsFlyer.onInstallConversionData(
(res) => {
    if (JSON.parse(res.data.is_first_launch)== true) {
      if (res.data.af_status=== 'Non-organic') {
        var media_source = res.data.media_source;
        var campaign = res.data.campaign;
        alert('This is first launch and a Non-Organic install. Media source: ' + media_source + ' Campaign: ' + campaign);
      } else if (res.data.af_status=== 'Organic') {
        alert('This is first launch and a Organic Install');
      }
    } else {
      alert('This is not first launch');
    }
  }
);

appsFlyer.initSdk(/*...*/);

直接ディープリンク：onAppOpenAttribution

コンバージョンデータを取得するには、onAppOpenAttribution を実装します。コードサンプル：

this.onAppOpenAttributionCanceller = appsFlyer.onAppOpenAttribution((res)=> {
  console.log(res);
  // implement logic to customize content
});

appsFlyer.initSdk(/*...*/);

1. React Nativeプロジェクトに、onInstallConversionData と onAppOpenAttribution を実装します。
2. ディープリンクをサポートするロジックをアプリ内で設定します。各OSの手順に従ってください。

• Android
• iOS