about_kpi - glossom-dev/AdfurikunSDK-iOS GitHub Wiki
KPI集計について
アドフリくんでは、アプリケーションのアクションをEventとして送信して、KPI分析のデータとして活用することができます。下記の機能についての詳細内容はお問い合わせください。
Method説明
ADFEventSender Class
+ (void)sendApplicationLogWithDefinition:(ApplicationLog)log;
+ (void)sendApplicationLogWithDefinition:(ApplicationLog)log appId:(NSString * _Nullable)appId;
ADFEventSenderクラスのClass MethodとしてsendApplicationLogWithDefinitionという関数があります。enum typeのApplicationLog Typeで定義されているアプリケーションのアクションをパラメータとして呼び出すとアドフリくんSDKはKPI分析用のEventを送信します。
当APIを使う前に、必ず広告枠IDに対して、初期化処理を行ってください。
ApplicationLogについては下記のテーブルをご参考ください。
アプリケーションアクションの定義について
ApplicationLog | 説明 |
---|---|
ApplicationLogShowCMPopup | 広告を再生するボタンが表示された時 |
ApplicationLogClickCMPopup | ユーザが再生ボタンをタッチした時 |
ApplicationLogNotReadyAlert | 広告の準備が間に合わなくて、アプリケーションの方でユーザに広告の準備ができなかったことをポップアップで表示した時 |
ApplicationLogRewardCompleted | 広告再生完了後、アプリケーションで報酬付与を成功した時 |
ApplicationLogRewardError | 広告再生完了後、アプリケーションで報酬付与を失敗した時 |
ApplicationLogBeforeShowCMPage | 広告視聴するポップアップが表示される1つ前の画面(UIViewController)が表示された時 |
ApplicationLogOnShowCMPage | アプリ側で広告設置しているページが表示された時 |
Sample Code
private let appId = "000000000"
override func viewDidLoad() {
super.viewDidLoad()
ADFmyMovieReward.initialize(withAppID: appId)
ADFEventSender.sendApplicationLog(withDefinition: .onShowCMPage, appId: appId)
}
@IBAction func clickCMPopupButtonTouched(_ sender: Any) {
ADFEventSender.sendApplicationLog(withDefinition: .clickCMPopup, appId: appId)
}
再生時の追加情報送信
再生情報の中にアプリケーションのユーザ情報など追加情報を設定することでKPI分析を行う際により正確・多様な分析ができるようになります。
再生関数のCustom Parameterという引数を使って追加情報送信ができます。
let customParam = ["user_hash": "abcdef"]
movieReward.play(withPresenting: self, customParam: customParam)
Custom ParameterはDictionaryタイプでキーは別途決められたものはありませんので、実装の前にGlossomの担当者とご相談下さい。また、よく使われるキーは下記になります。
キー | 説明 |
---|---|
user_hash | アプリケーションに登録されているユーザID、またはそれに相当するHash値 |