about_kpi - glossom-dev/AdfurikunSDK-Unity GitHub Wiki

KPI集計について

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

Method説明

AdfurikunEventSender Class

public static void SendApplicationLogWithDefinition(ApplicationLog log)
public static void SendApplicationLogWithDefinition(ApplicationLog log, string appId)

AdfurikunEventSenderクラスのStatic MethodとしてSendApplicationLogWithDefinitionという関数があります。enum typeのApplicationLog Typeで定義されているアプリケーションのアクションをパラメータとして呼び出すとアドフリくんSDKはKPI分析用のEventを送信します。

ApplicationLogについては下記のテーブルをご参考ください。

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

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();
            }
        }
    }

再生時の追加情報送信

再生情報の中にアプリケーションのユーザ情報など追加情報を設定することでKPI分析を行う際により正確・多様な分析ができるようになります。

再生関数のCustom Parameterという引数を使って追加情報送信ができます。

 Dictionary<string, string> customParam = new Dictionary<string, string>() { {"user_hash", "abcdef"} };
 movieReward.playMovieReward(customParam);

Custom ParameterはDictionaryタイプでキーは別途決められたものはありませんので、実装の前にGlossomの担当者とご相談下さい。また、よく使われるキーは下記になります。

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