about_kpi - glossom-dev/AdfurikunSDK-Unity GitHub Wiki

KPI集計について

アドフリくんでは、アプリケーションのアクションをEventとして送信して、KPI分析のデータとして活用することができます。下記の機能についての詳細内容はお問い合わせください。

Method説明

特定のタイミングでAdfurikunEventSenderクラスのSendApplicationLogとSendApplicationLogWithDefinition関数を呼び出す事で、KPI 分析用のイベントを送信します。

public static void SendApplicationLog(string log, string appId)
public static void SendApplicationLogWithDefinition(ApplicationLog log, string appId)
パラメータ 説明
log アプリケーションアクション文字列（下記の表を参照）
appId 広告枠ID

アプリケーションアクションの定義について

ApplicationLog 説明
ApplicationLogShowCMPopup 広告を再生するボタンが表示された時
ApplicationLogClickCMPopup ユーザが再生ボタンをタッチした時
ApplicationLogNotReadyAlert 広告の準備が間に合わなくて、アプリケーションの方でユーザに広告の準備ができなかったことをポップアップで表示した時
ApplicationLogRewardCompleted 広告再生完了後、アプリケーションで報酬付与を成功した時
ApplicationLogRewardError 広告再生完了後、アプリケーションで報酬付与を失敗した時
ApplicationLogBeforeShowCMPage 広告視聴するポップアップが表示される1つ前の画面（Scene）が表示された時
ApplicationLogOnShowCMPage アプリ側で広告設置しているページが表示された時

Sample Code

    private string appId = "000000000";
    
    void Start()
    {
        var rewardObj = GameObject.Find("AdfurikunMovieRewardUtility");
        if (rewardObj != null)
        {
            rewardUtility = rewardObj.GetComponent<AdfurikunMovieRewardUtility>();
            rewardUtility.onPrepareSuccess = HandlePrepareSuccess;
            rewardUtility.onPrepareFailure = HandlePrepareFailure;
            rewardUtility.onStartPlaying = HandleStartPlaying;
            rewardUtility.onFinishPlaying = HandleFinishPlaying;
            rewardUtility.onFailedPlaying = HandleFailedPlaying;
            rewardUtility.onCloseAd = HandleCloseAd;
            
            AdfurikunEventSender.SendApplicationLogWithDefinition(ApplicationLog.ApplicationLogBeforeShowCMPage, appId);
        }
    }
    
     void OnGUI()
    {
    // 動画再生ボタン
        if (GUI.Button(new Rect(10, 300, 600, 80), "<size=48>play reward</size>")) 
        {
            AdfurikunEventSender.SendApplicationLogWithDefinition(ApplicationLog.ApplicationLogClickCMPopup, appId);
            if (rewardUtility != null && rewardUtility.isPreparedMovieReward())
            {
                rewardUtility.playMovieReward();
            }
        }
    }

再生時の追加情報送信

動画リワード広告の再生時に、AdfurikunMovieRewardUtilityクラス（インタースティシャル広告の場合はAdfurikunMovieRewardUtility）の Play関数を使用することで、アドフリくんのサーバーに追加情報を送信することができます。
これにより、KPI分析を行う際により正確・多様な分析ができるようになります。

 public void PlayMovieReward(string appId, Dictionary<string, string> customParams)
 public void PlayInterstitial(string appId, Dictionary<string, string> customParams)

Sample Code

 Dictionary<string, string> customParam = new Dictionary<string, string>() { {"user_hash", "abcdef"} };
 reward.PlayMovieReward("広告枠ID", customParam);

customParams は Map タイプですが、特に予め決められたキーは存在しません。
実装の前にアドフリくんの担当者とご相談下さい。
また、よく使われるキーは下記になります。

キー 説明
"user_hash" アプリケーションに登録されているユーザID、またはそれに相当するHash値

DAUの計測

アプリケーション起動時にAdfurikunOptionsクラスのLogApplicationLaunched関数を呼び出す事で、より正確なDAUを計測できます。

   public static void LogApplicationLaunched(List<string> appIds, String userId)
パラメータ 説明
appIds DAUを計測する全ての広告枠IDを含む配列
userId アプリケーション側で発行する、ユーザーを一意に識別するID。
nullを指定した場合は、アドフリくんSDK側で自動的に発行されるIDが使用されます

Sample Code

   var appIds = new List<string>();
   appIds.Add("広告枠1");
   appIds.Add("広告枠2");
   appIds.Add("広告枠3");
   val userId = "test_user_id"
   AdfurikunOptions.LogApplicationLaunched(appIds, userId)
⚠️ **GitHub.com Fallback** ⚠️