互聯(lián)網(wǎng)曝光量與點(diǎn)擊量檢測(cè)方法1范圍本方法適用于互聯(lián)網(wǎng)廣告曝光量與點(diǎn)擊量的檢測(cè)。2引用文件本方法引用下列文件：GB/T34090.1—2017《互動(dòng)廣告》第1部分：術(shù)語(yǔ)概述GB/T34090.1—2017《互動(dòng)廣告》第2部分：投放驗(yàn)證要求T/CAAAD002—2020《互聯(lián)網(wǎng)廣告投放監(jiān)測(cè)與驗(yàn)證要求》T/CAAAD003—2020《移動(dòng)互聯(lián)網(wǎng)廣告標(biāo)識(shí)技術(shù)規(guī)范》凡是注日期的引用文件，僅注日期的版本適用于本規(guī)則；凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本規(guī)則。3術(shù)語(yǔ)和定義JJF1001-2011《通用計(jì)量術(shù)語(yǔ)及定義》、GB/T34090.1—2017互動(dòng)廣告第1部分：術(shù)語(yǔ)概述、T/CAAAD003—2020《移動(dòng)互聯(lián)網(wǎng)廣告標(biāo)識(shí)技術(shù)規(guī)范》中界定的有關(guān)術(shù)語(yǔ)和定義以及下列術(shù)語(yǔ)和定義適用于本方法。3.1廣告曝光AdImpression廣告曝光是指廣告在用戶的設(shè)備屏幕上被展示的行為。當(dāng)廣告出現(xiàn)在用戶的視野范圍內(nèi)，無(wú)論用戶是否真正注意到這個(gè)廣告，都算作一次曝光。根據(jù)用戶的請(qǐng)求，廣告平臺(tái)向媒體發(fā)送廣告素材，在媒體上開(kāi)始渲染并進(jìn)行展示，記為一次曝光。3.2曝光量Impression互聯(lián)網(wǎng)廣告被展示的總次數(shù)。3.3點(diǎn)擊量ClicksVolume用戶點(diǎn)擊廣告的總次數(shù)。3.4廣告點(diǎn)擊AdClick用戶與廣告的有效交互行為（點(diǎn)擊、搖晃、劃動(dòng)等），該行為促成廣告頁(yè)面的打開(kāi)。3.5廣告請(qǐng)求：AdvertisementRequest由用戶的移動(dòng)終端向廣告平臺(tái)請(qǐng)求廣告的行為。3.6監(jiān)測(cè)平臺(tái)MeasurementPlatform采集廣告曝光、廣告點(diǎn)擊等各種數(shù)據(jù)，并實(shí)現(xiàn)監(jiān)測(cè)、驗(yàn)證和歸因功能的平臺(tái)。3.7廣告標(biāo)識(shí)符AdvertisingIdentifier應(yīng)用于互聯(lián)網(wǎng)廣告業(yè)務(wù)的非永久性標(biāo)識(shí)符，能夠標(biāo)記、識(shí)別互聯(lián)網(wǎng)廣告服務(wù)對(duì)象，如IDFA、OAID等。3.8同步監(jiān)測(cè)SynchronousMonitoring是指用戶點(diǎn)擊廣告后，先訪問(wèn)監(jiān)測(cè)鏈接，跳至監(jiān)測(cè)平臺(tái)服務(wù)器，再跳至落地頁(yè)。指在網(wǎng)頁(yè)或者應(yīng)用程序中，按照順序執(zhí)行的監(jiān)測(cè)代碼。當(dāng)瀏覽器或應(yīng)用解析到這段代碼時(shí)，會(huì)暫停其他內(nèi)容的處理，直到代碼執(zhí)行完畢。3.9異步監(jiān)測(cè)代碼AsynchronousMonitoring點(diǎn)擊廣告后，直接跳轉(zhuǎn)至落地頁(yè)，與此同時(shí)，媒體服務(wù)器發(fā)送監(jiān)測(cè)請(qǐng)求給監(jiān)測(cè)平臺(tái)服務(wù)器。一種不會(huì)阻塞頁(yè)面其他內(nèi)容加載的代碼。在瀏覽器或應(yīng)用解析到異步監(jiān)測(cè)代碼時(shí)，會(huì)將其放入一個(gè)單獨(dú)的執(zhí)行線程中，使其在后臺(tái)運(yùn)行，頁(yè)面的其他元素（如文本、圖像、其他腳本等）可以繼續(xù)正常加載。4概述對(duì)于互聯(lián)網(wǎng)廣告業(yè)務(wù)而言，互聯(lián)網(wǎng)曝光量和點(diǎn)擊量是最重要的兩個(gè)過(guò)程數(shù)值，是媒體平臺(tái)（流量主）和廣告投放方結(jié)算方式中最重要的計(jì)算數(shù)值。互聯(lián)網(wǎng)廣告曝光量為通過(guò)對(duì)網(wǎng)頁(yè)或互聯(lián)網(wǎng)廣告文件加入的監(jiān)測(cè)代碼，對(duì)用戶看到廣告的次數(shù)進(jìn)行檢測(cè)統(tǒng)計(jì)。點(diǎn)擊量為通過(guò)對(duì)互聯(lián)網(wǎng)廣告文件進(jìn)行監(jiān)測(cè)代碼植入后，對(duì)指定時(shí)間段內(nèi)的廣告點(diǎn)擊次數(shù)進(jìn)行匯總統(tǒng)計(jì)。對(duì)于監(jiān)測(cè)數(shù)據(jù)傳輸，主要存在ClienttoServer（簡(jiǎn)稱C2S）和ServertoServer（簡(jiǎn)稱S2S）兩種模式。C2S是由監(jiān)測(cè)平臺(tái)通過(guò)在媒體端部署的監(jiān)測(cè)代碼實(shí)時(shí)獲得用戶端觸發(fā)的廣告行為數(shù)據(jù)，而S2S是由媒體端將實(shí)時(shí)獲取的用戶觸發(fā)的廣告行為數(shù)據(jù)通過(guò)監(jiān)測(cè)代碼接口上報(bào)到媒體服務(wù)器，媒體服務(wù)器將采集到的數(shù)據(jù)實(shí)時(shí)或者批量上報(bào)到監(jiān)測(cè)平臺(tái)。宜采用C2S的模式，也可采用S2S的模式。兩種監(jiān)測(cè)模式采集的數(shù)據(jù)均來(lái)自用戶端。實(shí)施S2S傳輸模式的媒體方與監(jiān)測(cè)方宜定期測(cè)試數(shù)據(jù)傳輸質(zhì)量的穩(wěn)定及有效性。桌面端的瀏覽器或客戶端在需要展示廣告時(shí)，即時(shí)地從廣告平臺(tái)加載廣告，在廣告素材開(kāi)始渲染時(shí)，瀏覽器或客戶端將曝光行為數(shù)據(jù)上報(bào)給監(jiān)測(cè)平臺(tái)。監(jiān)測(cè)流程如圖1所示：圖1曝光檢測(cè)流程圖點(diǎn)擊的檢測(cè)流程有同步和異步兩種方式，其中同步的方式流程如下圖圖2同步點(diǎn)擊檢測(cè)流程圖異步的流程中，用戶點(diǎn)擊廣告，APP接收到用戶點(diǎn)擊事件之后，在處理點(diǎn)擊事件，發(fā)送點(diǎn)擊數(shù)據(jù)給廣告服務(wù)器的同時(shí)，將點(diǎn)擊數(shù)據(jù)異步上傳給第三方監(jiān)測(cè)平臺(tái)。圖3異步點(diǎn)擊檢測(cè)流程圖5檢測(cè)項(xiàng)目和檢測(cè)方法5.1檢測(cè)項(xiàng)目表1檢測(cè)項(xiàng)目一覽表序號(hào)檢測(cè)項(xiàng)目名稱1廣告點(diǎn)擊量2廣告曝光量3CTRClickThroughRate點(diǎn)擊率，點(diǎn)擊量和曝光量的比值除了上述指標(biāo)，需要在檢測(cè)結(jié)果中注明相關(guān)維度，方便廣告主和媒體等數(shù)據(jù)使用方清楚了解測(cè)量的范圍，維度包括：項(xiàng)目名稱和時(shí)間范圍，地域，媒體名稱，廣告位等信息。示例如下：5.1.1廣告點(diǎn)擊量廣告點(diǎn)擊是指用戶在瀏覽網(wǎng)頁(yè)時(shí)鼠標(biāo)指向互聯(lián)網(wǎng)廣告的位置，手指對(duì)鼠標(biāo)鍵進(jìn)行按擊；或手機(jī)端APP使用時(shí)手指對(duì)屏幕顯示的廣告進(jìn)行觸按的行為，統(tǒng)稱為廣告點(diǎn)擊。廣告點(diǎn)擊量為通過(guò)對(duì)互聯(lián)網(wǎng)廣告文件進(jìn)行監(jiān)測(cè)代碼植入后，對(duì)指定時(shí)間段內(nèi)的廣告點(diǎn)擊次數(shù)進(jìn)行匯總統(tǒng)計(jì)。有同步檢測(cè)和異步檢測(cè)兩種方式。同步檢測(cè)是用戶點(diǎn)擊互聯(lián)網(wǎng)網(wǎng)頁(yè)后，用戶先訪問(wèn)檢測(cè)鏈接，跳至檢測(cè)公司服務(wù)器，再跳至落地頁(yè)。異步檢測(cè)是點(diǎn)擊網(wǎng)頁(yè)后，直接跳轉(zhuǎn)至落地頁(yè)，媒體服務(wù)器發(fā)送檢測(cè)請(qǐng)求給檢測(cè)公司服務(wù)器。5.1.2廣告曝光量互聯(lián)網(wǎng)廣告曝光為用戶瀏覽網(wǎng)頁(yè)或手機(jī)端APP時(shí)，看到互聯(lián)網(wǎng)廣告，視為廣告曝光。互聯(lián)網(wǎng)廣告曝光數(shù)為用戶看到被成功展示的互聯(lián)網(wǎng)廣告次數(shù)，（MediaRatingCouncil）即美國(guó)分級(jí)委員會(huì)展示類廣告視頻廣告像素露出要求50%像素50%像素露出時(shí)長(zhǎng)要求連續(xù)1秒連續(xù)2秒互聯(lián)網(wǎng)廣告曝光量為通過(guò)對(duì)網(wǎng)頁(yè)或互聯(lián)網(wǎng)廣告文件加入的監(jiān)測(cè)代碼，對(duì)用戶看到廣告的次數(shù)進(jìn)行匯總統(tǒng)計(jì)。5.2檢測(cè)方法根據(jù)投放互聯(lián)網(wǎng)廣告的不同場(chǎng)景，檢測(cè)包括：應(yīng)用程序接口檢測(cè)（簡(jiǎn)稱API檢測(cè)），是通過(guò)媒體的API接口回傳轉(zhuǎn)化事件的軟件開(kāi)發(fā)工具包檢測(cè)（簡(jiǎn)稱SDK檢測(cè)）。5.2.1API監(jiān)測(cè)API監(jiān)測(cè)機(jī)制互聯(lián)網(wǎng)平臺(tái)將廣告的監(jiān)測(cè)數(shù)據(jù)通過(guò)API上報(bào)到第三方監(jiān)測(cè)平臺(tái)。第三方監(jiān)測(cè)平臺(tái)負(fù)責(zé)對(duì)采集到的監(jiān)測(cè)數(shù)據(jù)進(jìn)行清洗、分析、挖掘處理，生成監(jiān)測(cè)結(jié)果。舉例，APP機(jī)制如下圖4所示：圖4APP監(jiān)測(cè)機(jī)制圖API監(jiān)測(cè)說(shuō)明API監(jiān)測(cè)為被監(jiān)測(cè)的媒體方以API的方式，在廣告獲得展示后，從用戶端發(fā)送數(shù)據(jù)至監(jiān)測(cè)服務(wù)器并進(jìn)行記錄。其實(shí)現(xiàn)流程如下：監(jiān)測(cè)后臺(tái)生成監(jiān)測(cè)代碼，并部署在廣告服務(wù)器上。用戶通過(guò)瀏覽器或客戶端訪問(wèn)頁(yè)面時(shí)，向媒體主服務(wù)器請(qǐng)求頁(yè)面。媒體主服務(wù)器返回頁(yè)面時(shí)將返回頁(yè)面資源。頁(yè)面在展示時(shí)監(jiān)聽(tīng)到有廣告位置，從瀏覽器或客戶端向廣告服務(wù)器請(qǐng)求廣告。廣告服務(wù)器發(fā)放包含監(jiān)測(cè)代碼的廣告素材后，在瀏覽器或客戶端相應(yīng)位置進(jìn)行展示。廣告曝光展示給用戶上傳曝光監(jiān)測(cè)數(shù)據(jù)，觸發(fā)監(jiān)測(cè)代碼，將監(jiān)測(cè)數(shù)據(jù)（見(jiàn)附表1）曝光量及點(diǎn)擊記錄返回至監(jiān)測(cè)服務(wù)器。監(jiān)測(cè)服務(wù)器記錄并最終形成監(jiān)測(cè)報(bào)告。圖5API監(jiān)測(cè)流程5.2.2SDK監(jiān)測(cè)SDK系統(tǒng)模塊描述（1）媒體廣告投放系統(tǒng)即媒體部署的用于廣告管理、決策和投放的服務(wù)器。（2）媒體APP安裝于瀏覽者（個(gè)人用戶）移動(dòng)終端的軟件（如視頻、游戲、工具、閱讀等移動(dòng)應(yīng)用），除了正常的APP內(nèi)容和場(chǎng)景外，還包含廣告監(jiān)測(cè)及驗(yàn)證統(tǒng)一SDK，SDK中封裝有各種監(jiān)測(cè)參數(shù)的獲取方法；（3）第三方監(jiān)測(cè)統(tǒng)計(jì)系統(tǒng)第三方監(jiān)測(cè)公司部署的服務(wù)器，用于記錄數(shù)據(jù)并向廣告主提供統(tǒng)計(jì)報(bào)告。SDK監(jiān)測(cè)數(shù)據(jù)通信流程圖6SDK監(jiān)測(cè)數(shù)據(jù)通信流程圖SKD監(jiān)測(cè)機(jī)制SDK遠(yuǎn)程動(dòng)態(tài)加載存放于媒體廣告投放系統(tǒng)的監(jiān)測(cè)參數(shù)配置文檔，并解析保存相應(yīng)配置規(guī)則。媒體APP內(nèi)的投放管理模塊從投放系統(tǒng)加載廣告素材及其第三方監(jiān)測(cè)URL，一般包含曝光監(jiān)測(cè)URL、點(diǎn)擊監(jiān)測(cè)URL。媒體APP內(nèi)的投放管理模塊調(diào)用廣告監(jiān)測(cè)及驗(yàn)證統(tǒng)一SDK的“提交監(jiān)測(cè)”方法，廣告監(jiān)測(cè)及驗(yàn)證統(tǒng)一SDK，根據(jù)投放管理模塊傳遞的參數(shù)，按照監(jiān)測(cè)參數(shù)配置文檔，在提供的監(jiān)測(cè)URL后拼接SDK額外獲取的參數(shù)，向第三方監(jiān)測(cè)系統(tǒng)服務(wù)器提交監(jiān)測(cè)請(qǐng)求，同時(shí)將請(qǐng)求成功發(fā)送的狀態(tài)向媒體APP回調(diào)。廣告監(jiān)測(cè)及驗(yàn)證統(tǒng)一SDK中的簽名模塊對(duì)監(jiān)測(cè)URL進(jìn)行簽名校驗(yàn)。廣告監(jiān)測(cè)及驗(yàn)證統(tǒng)一SDK根據(jù)輸入U(xiǎn)RL生成簽名校驗(yàn)串并拼接在URL尾部，發(fā)送到監(jiān)測(cè)系統(tǒng)，監(jiān)測(cè)公司在服務(wù)器端反解簽名串進(jìn)行校驗(yàn)。媒體APP內(nèi)的投放管理模塊響應(yīng)用戶的交互操作，內(nèi)嵌WebView或打開(kāi)瀏覽器跳轉(zhuǎn)到廣告主站點(diǎn)或執(zhí)行撥號(hào)、短信、打開(kāi)其他APP等操作。圖7SDK檢測(cè)流程圖SDK監(jiān)測(cè)說(shuō)明SDK監(jiān)測(cè)主要為針對(duì)移動(dòng)端APP的監(jiān)測(cè)方式，APP預(yù)先集成監(jiān)測(cè)SDK于APP內(nèi)，在發(fā)生APP瀏覽行為時(shí)，APP通過(guò)廣告SDK向廣告平臺(tái)獲取廣告創(chuàng)意后，根據(jù)預(yù)設(shè)的展示條件進(jìn)行廣告調(diào)用并展示，監(jiān)測(cè)SDK將廣告展示后的數(shù)據(jù)回傳至監(jiān)測(cè)服務(wù)器。SDK通過(guò)數(shù)據(jù)通路直接在廣告平臺(tái)APP和用戶APP進(jìn)行回調(diào)，流程如下：通過(guò)媒體主APP統(tǒng)一集成一個(gè)監(jiān)測(cè)的SDK。配置監(jiān)測(cè)數(shù)據(jù)，通過(guò)對(duì)XML文檔在廣告平臺(tái)上進(jìn)行監(jiān)測(cè)參數(shù)的配置，并進(jìn)行定制維護(hù)。通過(guò)SDK的遠(yuǎn)程動(dòng)態(tài)加載存檔在廣告平臺(tái)的XML配置文檔，解析并保存相應(yīng)配置規(guī)則。監(jiān)測(cè)平臺(tái)生成監(jiān)測(cè)代碼。將曝光及點(diǎn)擊監(jiān)測(cè)代碼分別部署至廣告平臺(tái)中。用戶打開(kāi)APP，媒體主APP監(jiān)控到有廣告位置，并向廣告服務(wù)器請(qǐng)求廣告。廣告服務(wù)器發(fā)放包含了監(jiān)測(cè)代碼的廣告素材給APP或?yàn)g覽器。廣告曝光展示給用戶。監(jiān)測(cè)SDK將觸發(fā)提交監(jiān)測(cè)，按一定的規(guī)則及參數(shù)配置文檔的約定，獲取OPENUDID、機(jī)型、操作系統(tǒng)、分辨率、加密的MAC地址等參數(shù)（見(jiàn)附表4）返回至監(jiān)測(cè)服務(wù)器。監(jiān)測(cè)服務(wù)器記錄并最終形成監(jiān)測(cè)報(bào)告。檢測(cè)數(shù)據(jù)發(fā)送策略在配置文件中，有三個(gè)可配置的值，含義分別是：（1）length：取整數(shù)，待發(fā)送隊(duì)列的長(zhǎng)度，如果監(jiān)測(cè)請(qǐng)求個(gè)數(shù)達(dá)到length的值，自動(dòng)發(fā)送第三方監(jiān)測(cè)的請(qǐng)求。（2）queueExpirationSecs：取整數(shù)，單位秒，默認(rèn)值3600（1小時(shí)），失敗隊(duì)列的重試時(shí)間間隔。（3）timeout：取整數(shù)，單位秒，默認(rèn)值10，發(fā)送請(qǐng)求的超時(shí)時(shí)間。當(dāng)程序內(nèi)部通過(guò)調(diào)用SDK中的方法發(fā)起監(jiān)測(cè)請(qǐng)求時(shí)，該請(qǐng)求不會(huì)被立即發(fā)送，而是記錄在一個(gè)待發(fā)送隊(duì)列中，當(dāng)監(jiān)測(cè)請(qǐng)求個(gè)數(shù)達(dá)到length的值，或者距離上次發(fā)送請(qǐng)求時(shí)間間隔超過(guò)1小時(shí)，SDK會(huì)自動(dòng)發(fā)送待發(fā)送隊(duì)列中的請(qǐng)求。為了減少網(wǎng)絡(luò)調(diào)用，SDK可以配置監(jiān)測(cè)日志達(dá)到一定數(shù)量時(shí)再進(jìn)行批量發(fā)送，通過(guò)修改配置文件中的length參數(shù)進(jìn)行設(shè)置，比如length的值設(shè)定為5時(shí)，本地監(jiān)測(cè)條數(shù)大于5條時(shí)，本地的監(jiān)測(cè)日志才會(huì)批量發(fā)送給遠(yuǎn)程的服務(wù)器，如果要保證監(jiān)測(cè)實(shí)時(shí)發(fā)送，請(qǐng)將配置文件中的length參數(shù)設(shè)定為0。監(jiān)測(cè)請(qǐng)求如果發(fā)送成功，該請(qǐng)求會(huì)被從待發(fā)送隊(duì)列中刪除，如果發(fā)送失敗，該請(qǐng)求會(huì)進(jìn)入失敗隊(duì)列。聯(lián)網(wǎng)情況下，失敗隊(duì)列中的請(qǐng)求每隔queueExpirationSecs的時(shí)間會(huì)發(fā)送一次，如果發(fā)送成功，該請(qǐng)求會(huì)被刪除，如果發(fā)送失敗，該請(qǐng)求繼續(xù)保留在失敗請(qǐng)求隊(duì)列中，如果失敗次數(shù)超過(guò)3次，該記錄會(huì)被移除。5.3曝光的驗(yàn)證附表5曝光驗(yàn)證表5.4監(jiān)測(cè)服務(wù)數(shù)據(jù)統(tǒng)計(jì)規(guī)范監(jiān)測(cè)服務(wù)在接收到客戶端發(fā)送的數(shù)據(jù)后，需要進(jìn)行數(shù)據(jù)的清洗、計(jì)算、并形成監(jiān)測(cè)報(bào)告。其中關(guān)鍵指標(biāo)計(jì)算方法如下：指標(biāo)計(jì)算方法計(jì)算公式廣告點(diǎn)擊量采集到的點(diǎn)擊監(jiān)測(cè)請(qǐng)求的總和Click廣告曝光量采集到的曝光監(jiān)測(cè)請(qǐng)求的總和ImpCTRClickThroughRate點(diǎn)擊率點(diǎn)擊量和曝光量的比值CTR附表1監(jiān)測(cè)系統(tǒng)參數(shù)表參數(shù)用途描述格式和示例是否必填獲取方法OS客戶端操作系統(tǒng)的類型0–Android1–iOS2–WP4-HarmonyOS3-Others是APPIMEI用戶終端的IMEI，15位數(shù)字。取md5sum摘要OS=0時(shí)，IMEI/MAC/MAC1/OAID/AndroidID/AAID至少一項(xiàng)必填；OS=1時(shí)，MAC/MAC1/IDFA/CAID至少一項(xiàng)必填A(yù)PPMAC用戶終端的eth0接口的MAC地址（大寫(xiě)去除冒號(hào)分隔符），md5加密。去除分隔符":"，（保持大寫(xiě)）取md5sum摘要。同上APPMAC1用戶終端的eth0接口的MAC地址（大寫(xiě)且保留冒號(hào)分隔符），md5加密。保留分隔符":"，（保持大寫(xiě)）取md5sum摘要。同上APPIDFAiOSIDFA適用于iOS6及以上保留原始值同上APPCAID用戶終端的CAID，適用于iOS系統(tǒng)。版本號(hào)以及具體的CAID值，以ver_CAID（原始值）這樣的格式，每次傳輸傳兩個(gè)CAID，分別為當(dāng)前最新版本號(hào)和上一版本號(hào)的CAID值，兩者之間以逗號(hào)分隔。示例：CAID=20231011_xxxxxx,20230927_xxxxxx。如果當(dāng)前只有一個(gè)版本的CAID，可以只傳一個(gè)，如：CAID=20231011_xxxxxxxx。同上APPAAIDAndroidAdvertisingID保留原始值。同上APPOAID用戶終端的OAID，適用于Android系統(tǒng)。保留原始值。同上APPDUIDWindowsPhone用戶終端的DUID，md5加密。取md5sum摘要。當(dāng)OS=2時(shí)，為必填A(yù)ppIP媒體投放系統(tǒng)獲取的用戶終端的公網(wǎng)IP地址，用于比對(duì)智能路由IP差異。A.B.C.D(4段點(diǎn)分），如8是服務(wù)器UA數(shù)據(jù)上報(bào)終端設(shè)備的UserAgent字符串，需URLEncode，如Mozilla%2F5.0(Linux%3BAndroid4.0.4%3BGT-I9220%20Build%2FIMM76D)是APPTS客戶端觸發(fā)監(jiān)測(cè)的時(shí)間UTC時(shí)間戳，自1970年起的毫秒數(shù)。否AppLBS用戶終端設(shè)備的經(jīng)緯度地理坐標(biāo)十進(jìn)制保留6位小數(shù)，西經(jīng)南緯保留負(fù)數(shù)，用字母x分割緯度與精度（先緯后經(jīng)，最后精度），如35.758134x-122.406722x100.0否AppGEO用戶終端設(shè)備的經(jīng)緯度地理坐標(biāo)十進(jìn)制保留3位小數(shù)，西經(jīng)南緯保留負(fù)數(shù)，用字母x分割緯度與精度（先緯后經(jīng)，最后精度），如35.7x-122.4x10000.否App附表2廣告點(diǎn)擊監(jiān)測(cè)測(cè)試用例格式用例標(biāo)題廣告點(diǎn)擊監(jiān)測(cè)測(cè)試用例參與者APP客戶端、重點(diǎn)機(jī)型覆蓋、點(diǎn)擊數(shù)據(jù)監(jiān)測(cè)方、對(duì)比數(shù)據(jù)方用例描述通過(guò)不同重點(diǎn)機(jī)型訪問(wèn)測(cè)試廣告并進(jìn)行點(diǎn)擊，查看監(jiān)測(cè)代碼是否成功獲取數(shù)據(jù)，不同監(jiān)測(cè)代碼的數(shù)據(jù)gap值是否在正常范圍內(nèi)前置條件已對(duì)接文件位、返回廣告，監(jiān)測(cè)代碼被正常添加后置條件點(diǎn)擊量據(jù)統(tǒng)計(jì)列表事件流編號(hào)操作步驟預(yù)期結(jié)果進(jìn)入已對(duì)接廣告位頁(yè)面廣告接口返回廣告數(shù)據(jù)及曝光監(jiān)測(cè)鏈接①監(jiān)測(cè)鏈接中的宏參數(shù)正確回填由接口返回，如設(shè)備唯一標(biāo)識(shí)IMEI等設(shè)備信息，更多重要參數(shù)見(jiàn)參數(shù)詳細(xì)說(shuō)明②監(jiān)測(cè)鏈接包含對(duì)應(yīng)廣告ID、廣告位PID、廣告樣式等廣告素材信息點(diǎn)擊廣告點(diǎn)擊監(jiān)測(cè)鏈接請(qǐng)求由客戶端發(fā)起①點(diǎn)擊廣告后，廣告可成功跳轉(zhuǎn)至目標(biāo)落地頁(yè)②監(jiān)測(cè)鏈接請(qǐng)求狀態(tài)200③一次點(diǎn)擊觸發(fā)一次點(diǎn)擊跳轉(zhuǎn)，點(diǎn)擊監(jiān)測(cè)鏈接記錄到請(qǐng)求；同一廣告每間隔一段時(shí)間點(diǎn)擊一次，每次能觸發(fā)一次點(diǎn)擊跳轉(zhuǎn)記錄到一次點(diǎn)擊；④點(diǎn)擊監(jiān)測(cè)上報(bào)時(shí)間、IP等實(shí)時(shí)數(shù)據(jù)統(tǒng)計(jì)正常統(tǒng)計(jì)到數(shù)據(jù)離線數(shù)據(jù)統(tǒng)計(jì)正常統(tǒng)計(jì)到數(shù)據(jù)多方監(jiān)測(cè)數(shù)據(jù)比對(duì)說(shuō)明無(wú)附表3廣告曝光監(jiān)測(cè)測(cè)試用例格式用例標(biāo)題登錄改造參與者APP客戶端、重點(diǎn)機(jī)型適配用例描述廣告曝光監(jiān)測(cè)前置條件已對(duì)接文件位、返回廣告后置條件曝光量據(jù)統(tǒng)計(jì)列表事件流編號(hào)操作步驟預(yù)期結(jié)果進(jìn)入已對(duì)接廣告位頁(yè)面廣告接口返回廣告數(shù)據(jù)及曝光監(jiān)測(cè)鏈接①監(jiān)測(cè)鏈接中的宏參數(shù)正確回填由接口返回，如設(shè)備唯一標(biāo)識(shí)IMEI等設(shè)備信息，更多重要參數(shù)見(jiàn)參數(shù)詳細(xì)說(shuō)明。②監(jiān)測(cè)鏈接包含對(duì)應(yīng)廣告ID、廣告位PID、廣告樣式等廣告素材信息。廣告展示曝光監(jiān)測(cè)鏈接請(qǐng)求由客戶端發(fā)起展示即請(qǐng)求曝光監(jiān)測(cè)鏈接：曝光監(jiān)控觸發(fā)條件是廣告加載成功，素材被成功加載并展示。監(jiān)測(cè)鏈接請(qǐng)求狀態(tài)200。請(qǐng)求不重復(fù)：一次廣告請(qǐng)求對(duì)應(yīng)的監(jiān)控鏈接只允許觸發(fā)一次，本次觸發(fā)的監(jiān)控鏈接必須來(lái)自本次廣告請(qǐng)求，嚴(yán)禁在一次廣告請(qǐng)求中對(duì)同一個(gè)監(jiān)控鏈接進(jìn)行多次觸發(fā)。注意監(jiān)控鏈接觸發(fā)的先后順序。監(jiān)測(cè)鏈接必需請(qǐng)求參數(shù)：監(jiān)控鏈接在上報(bào)時(shí)發(fā)送的http請(qǐng)求的header中須包含“User-Agent”。曝光監(jiān)測(cè)上報(bào)時(shí)間、IP等頁(yè)面不刷新，同一廣告不可見(jiàn)，再回到可見(jiàn)不重復(fù)請(qǐng)求曝光監(jiān)測(cè)頁(yè)面刷新，返回同一廣告并可見(jiàn)重新請(qǐng)求曝光監(jiān)測(cè)，設(shè)備信息、廣告信息、時(shí)間、IP等對(duì)應(yīng)實(shí)時(shí)數(shù)據(jù)統(tǒng)計(jì)正常統(tǒng)計(jì)到數(shù)據(jù)離線數(shù)據(jù)統(tǒng)計(jì)正常統(tǒng)計(jì)到數(shù)據(jù)多方監(jiān)測(cè)數(shù)據(jù)比對(duì)說(shuō)明無(wú)附表4SDK監(jiān)測(cè)參數(shù)表參數(shù)用途描述格式和示例是否必填OS用戶終端的操作系統(tǒng)類型0-Android1-iOS2-WP4-HarmonyOS3-Others是IMEI用戶終端的IMEI，md5加密。取md5sum摘要OS=0時(shí)，IMEI/MAC/MAC1/AAID/OAID至少一項(xiàng)必填；OS=1時(shí)，MAC/MAC1/IDFA至少一項(xiàng)必填。MAC用戶終端的eth0接口的MAC地址（大寫(xiě)去除冒號(hào)分隔符），md5加密。去除分隔符":"，（保持大寫(xiě)）取md5sum摘要OS=0時(shí)，IMEI/MAC/MAC1/AAID/OAID至少一項(xiàng)必填；OS=1時(shí)，MAC/MAC1/IDFA至少一項(xiàng)必填。MAC1用戶終端的eth0接口的MAC地址（大寫(xiě)且保留冒號(hào)分隔符），md5加密。保留分隔符":"，（保持大寫(xiě)）取md5sum摘要OS=0時(shí)，IMEI/MAC/MAC1/AAID/OAID至少一項(xiàng)必填；OS=1時(shí)，MAC/MAC1/IDFA至少一項(xiàng)必填。IDFAiOSIDFA適用于iOS6及以上保留原始值OS=0時(shí)，IMEI/MAC/MAC1/AAID/OAID至少一項(xiàng)必填；OS=1時(shí)，MAC/MAC1/IDFA至少一項(xiàng)必填。AAIDAndroidAdvertisingID保留原始值OS=0時(shí)，IMEI/MAC/MAC1/AAID/OAID至少一項(xiàng)必填；OS=1時(shí)，MAC/MAC1/IDFA至少一項(xiàng)必填DUIDWindowsPhone用戶終端的DUID，md5加密取md5sum摘要OS=2時(shí)，是OAID用戶終端的OAID，適用于Android系統(tǒng)保留原始值OS=0時(shí)，IMEI/MAC/MAC1/AAID/OAID至少一項(xiàng)必填；OS=1時(shí)，MAC/MAC1/IDFA至少一項(xiàng)必填I(lǐng)P媒體投放系統(tǒng)獲取的用戶終端的公網(wǎng)IP地址，用于比對(duì)智能路由IP差異A.B.C.D(4段點(diǎn)分），如8是GEO用戶終端設(shè)備的經(jīng)緯度地理坐標(biāo)。十進(jìn)制保留1位小數(shù)，西經(jīng)南緯保留負(fù)數(shù)，用字母x分割緯度與精度（先緯后經(jīng)，最后精度），如35.7x-22.4x10000.0否OSVS用戶終端的操作系統(tǒng)版本。字符串，需RLencode否TERM用戶終端的機(jī)型字符串，需RLencode否WIFI客戶端觸發(fā)監(jiān)測(cè)時(shí)是否使用wifi。0=2/3Gmode1=wifimode否WIFIBSSID客戶端使用wifi的MAC地址。去除分隔符":"，（保持大寫(xiě)）取md5sum摘要否WIFISSID客戶端使用wifi的名稱。字符串，wifi名稱做encode處理否SCWH用戶終端的屏幕分辨率寬x高，用字母x分割否ADWH素材實(shí)際播放時(shí)的尺寸（考慮素材的縮放）寬x高，用字母x分割否AKEY媒體APPKey字符串，需URLencode是ANAME媒體APPName字符串，需URLencode否SDKVSSDK版本字符串，需URLencode是SIGN簽名串字符串，需URLencode否ImpressionType在曝光監(jiān)測(cè)中，標(biāo)志是否滿足廣告開(kāi)始渲染（BtR）的要求0=不滿足1=滿足否ImpressionID每次曝光時(shí)生成的唯一ID，用以關(guān)聯(lián)用戶在同一次會(huì)話中的曝光、可見(jiàn)/不可見(jiàn)曝光、點(diǎn)擊事件字符串，需URLencode是isRoot標(biāo)志設(shè)備是否ROOT/越獄0-否，1-是，2-未知否isSimulator標(biāo)志設(shè)備是否是模擬器0-否，1-是，2-未知否isHook設(shè)備是否被hook0-否，1-是，2-未知否isADB是否處于，僅用于Android設(shè)備0-否，1-是，2-未知否附表5曝光驗(yàn)證表參數(shù)用途描述格式和示例是否必填是否可禁用獲取方法API兼容AdviewabilityResult標(biāo)識(shí)廣告的可見(jiàn)性0–可見(jiàn)監(jiān)測(cè)中發(fā)出的普通曝光1-可見(jiàn)曝光4-不可見(jiàn)曝光2-監(jiān)測(cè)中出現(xiàn)不可測(cè)量報(bào)告是否SDK僅用于SDKAdviewabilityRecord可見(jiàn)監(jiān)測(cè)的時(shí)間片數(shù)據(jù)是否上報(bào)，在監(jiān)測(cè)代碼中預(yù)先配置本參數(shù)的值為1，SDK將會(huì)把時(shí)間片數(shù)據(jù)（AdviewabilityEvents）上報(bào)僅能等于1否否預(yù)先配置僅用于SDKAdviewabilityEvents可見(jiàn)性監(jiān)測(cè)中采集的時(shí)間片信息以json數(shù)組的方式將時(shí)間片信息拼接起來(lái)，并做URLencode。如：%5b%7b1%