豪游海外SDK统计打点接入文档
<p>[TOC]</p>
<h1>豪游海外SDK统计打点接入文档</h1>
<h2>接入必读</h2>
<pre><code>事件埋点接口分为三部分：埋点接口，事件类型，事件参数集合的key</code></pre>
<h3>打点上报接口</h3>
<pre><code class="language-java">安卓
HYSdk.getInstance().trackEvent(this,eventName,params);</code></pre>
<pre><code class="language-objectivec">苹果
[[EventTrackManager getInstance] trackEvent:&lt;#(nonnull NSString *)#&gt; EventValue:&lt;#(nullable NSMutableDictionary *)#&gt;];</code></pre>
<h3>事件类型 (String eventName)</h3>
<table>
<thead>
<tr>
<th>打点内容</th>
<th>事件名称(字符串)</th>
<th>需要传的事件参数</th>
<th>详细说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>新手引导完成</td>
<td>tutorialComplete</td>
<td>研发&发行对齐“何为”完成新手阶段即可</td>
</tr>
<tr>
<td>加入公会</td>
<td>joinTheAlliance</td>
<td>角色加入公会即上报</td>
</tr>
<tr>
<td>在线时长</td>
<td>onlineTime1Hour</td>
<td>单次在线1小时</td>
</tr>
<tr>
<td>在线时长</td>
<td>onlineTime2Hour</td>
<td>单次在线2小时</td>
</tr>
<tr>
<td>在线时长</td>
<td>onlineTime3Hour</td>
<td>单次在线3小时</td>
</tr>
<tr>
<td>VIP等级</td>
<td>vipLevel1</td>
<td>打点记录玩家VIP等级1</td>
</tr>
<tr>
<td>VIP等级</td>
<td>vipLevel2</td>
<td>打点记录玩家VIP等级2</td>
</tr>
<tr>
<td>VIP等级</td>
<td>vipLevel3</td>
<td>打点记录玩家VIP等级3</td>
</tr>
<tr>
<td>VIP等级</td>
<td>vipLevel...</td>
<td>打点记录玩家VIP等级...</td>
</tr>
<tr>
<td>结婚</td>
<td>getMarried</td>
<td>HY_PARAM_ROLE_LEVEL,HY_PARAM_VIP_LEVEL</td>
<td>玩家进行结婚行为即触发</td>
</tr>
<tr>
<td>城堡等级</td>
<td>castleLevel1</td>
<td>SLG重要行为</td>
</tr>
<tr>
<td>城堡等级</td>
<td>castleLevel2</td>
<td>SLG重要行为</td>
</tr>
<tr>
<td>城堡等级</td>
<td>castleLevel3</td>
<td>SLG重要行为</td>
</tr>
<tr>
<td>城堡等级</td>
<td>castleLevel...</td>
<td>SLG重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness200000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness500000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness800000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness1000000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness2000000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness3000000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness4000000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness5000000</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>战斗力</td>
<td>combatEffectiveness...</td>
<td>MMO重要行为</td>
</tr>
<tr>
<td>购买周卡</td>
<td>WeekCard</td>
<td>HY_PARAM_PRICE</td>
<td>完成周卡购买后记录一次</td>
</tr>
<tr>
<td>购买月卡</td>
<td>MonthCard</td>
<td>HY_PARAM_PRICE</td>
<td>完成月卡购买后记录一次</td>
</tr>
<tr>
<td>打开游戏</td>
<td>startGame</td>
<td>打开游戏</td>
</tr>
<tr>
<td>加载固有资源</td>
<td>startLoadingMainAssetsBundle</td>
<td>预加载本地资源时打点</td>
</tr>
<tr>
<td>显示loading界面</td>
<td>showLoadingWindow</td>
<td>到达游戏登入界面时打点</td>
</tr>
<tr>
<td>开始更新资源（行为）</td>
<td>startUpdateAssets</td>
<td>开始下载更新资源是打点</td>
</tr>
<tr>
<td>更新完成，开始进入游戏</td>
<td>startUpdateAssetsEnd</td>
<td>成功完成更新时打点</td>
</tr>
<tr>
<td>到达登录页</td>
<td>openLoginWindow</td>
<td>弹出SDK登录页,调出sdk界面时打点</td>
</tr>
<tr>
<td>SDK登录成功</td>
<td>sdkLoginSuccess</td>
<td>SDK登录成功,完成sdk登入账号时打点</td>
</tr>
<tr>
<td>进入选服</td>
<td>openServerMainWindow</td>
<td>进入选服,获取到服务器列表时打点</td>
</tr>
<tr>
<td>打开服务器列表（打开界面）</td>
<td>openServerLisWindow</td>
<td>点开进入选服列表界面时打点</td>
</tr>
<tr>
<td>选择服务器（客户端操作）</td>
<td>selectServer</td>
<td>点击选服列表界面内【开始游戏】按钮时打点</td>
</tr>
<tr>
<td>开始加载创角场景</td>
<td>startLoadingCreateScene</td>
<td>进入创角界面时打点</td>
</tr>
<tr>
<td>点击创角按钮</td>
<td>startCreateRole</td>
<td>点击创角按钮</td>
</tr>
<tr>
<td>进入游戏</td>
<td>startEnterGame</td>
<td>完成创角进入到游戏新手地图时打点</td>
</tr>
<tr>
<td>APP崩溃</td>
<td>appCrash</td>
<td>HY_PARAM_ERROR_MESSAGE</td>
<td>APP崩溃</td>
</tr>
<tr>
<td>检查分包更新</td>
<td>checkPackUpdate</td>
<td>指除了游戏包本体以外的其他资源(一般游戏边玩边下载的那部分);分包资源开始更新时打点（无分包的游戏可不打）</td>
</tr>
<tr>
<td>检查分包更新成功</td>
<td>checkPackUpdateSuccess</td>
<td>指除了游戏包本体以外的其他资源;分包资源成功完成更新时打点（无分包的游戏可不打）</td>
</tr>
<tr>
<td>cdn下载游戏资源开始</td>
<td>cdnDownloadStart</td>
<td>cdn下载游戏资源开始</td>
</tr>
<tr>
<td>cdn下载游戏资源结束</td>
<td>cdnDownloadEnd</td>
<td>cdn下载游戏资源结束</td>
</tr>
<tr>
<td>加载Loading图片</td>
<td>startLoadingImage</td>
<td>加载Loading图片</td>
</tr>
</tbody>
</table>
<h3>事件参数集合的key (EventTrackParamName)</h3>
<table>
<thead>
<tr>
<th>事件参数名称</th>
<th>事件参数值(字符串)</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>HY_PARAM_PRICE</td>
<td>af_revenue</td>
<td>金额，可传字符串类型 如："18.00"</td>
</tr>
<tr>
<td>HY_PARAM_ROLE_LEVEL</td>
<td>af_role_level</td>
<td>角色等级，字符串类型 如："20"</td>
</tr>
<tr>
<td>HY_PARAM_VIP_LEVEL</td>
<td>af_vip_level</td>
<td>vip等级，字符串类型 如："5"</td>
</tr>
<tr>
<td>HY_PARAM_ERROR_MESSAGE</td>
<td>error_message</td>
<td>错误信息，字符串</td>
</tr>
</tbody>
</table>
<h4>接入实例</h4>
<p>*1.接入资源加载完毕的埋点 </p>
<pre><code class="language-java">安卓
HYSdk.getInstance().trackEvent(context,&quot;cdnDownloadEnd&quot;,null);</code></pre>
<pre><code class="language-objectivec">苹果
[[EventTrackManager getInstance] trackEvent:@&quot;cdnDownloadEnd&quot; EventValue:nil];</code></pre>
<p>*2.接入购买周卡时的埋点</p>
<pre><code>类型：WeekCard
需要传的参数集合：HY_PARAM_PRICE</code></pre>
<pre><code class="language-java">安卓
Map&lt;String,Object&gt; params = new HashMap&lt;&gt;();
params.put(EventTrackParamName.HY_PARAM_PRICE,&quot;128&quot;);
HYSdk.getInstance().trackEvent(this,&quot;WeekCard&quot;,params);</code></pre>
<pre><code class="language-objectivec">苹果
[[EventTrackManager getInstance] trackEvent:@&quot;WeekCard&quot; EventValue:[@{HY_PARAM_PRICE:@128}mutableCopy]];
或者
NSMutableDictionary *params = [NSMutableDictionary dictionary];
[params setObject:@128 forKey:HY_PARAM_PRICE];
[[EventTrackManager getInstance] trackEvent:@&quot;WeekCard&quot; EventValue:params];</code></pre>