OPPO廣告 | API能力對接

一、API應用場景總覽

二、OMINI-API申請流程及使用

1、定義

用于全方位(wei)賦(fu)能客(ke)戶的程(cheng)序(xu)化接(jie)口，支(zhi)持客(ke)戶通過接(jie)口實現OPPO廣告投放(fang)、數據獲取(qu)等(deng)功(gong)能，減少運營人力

2、流程

（1）銷售人員收到API對接需(xu)求(qiu)：銷售人員確認廣告主屬(shu)性:直客(ke)/代理商(shang)/代理商(shang)子(zi)客(ke)戶(hu)

（2）微(wei)信群對(dui)接(jie)(jie)：銷售同學先拉API對(dui)接(jie)(jie)人(ren)，API對(dui)接(jie)(jie)人(ren)再拉相關(guan)測試同學

（3）測(ce)試(shi)環境聯(lian)調（統一使用測(ce)試(shi)賬號(hao)(hao)）：測(ce)試(shi)賬號(hao)(hao)需(xu)要(yao)區分廣告主(zhu)(zhu)類型，是哪個類型的(de)廣告主(zhu)(zhu)，則提供對應的(de)測(ce)試(shi)賬號(hao)(hao)

（4）測試(shi)環境通過后銷售申請(qing)正(zheng)式(shi)(shi)環境的(de)賬號密鑰（廣告(gao)(gao)主的(de)正(zheng)式(shi)(shi)賬號）：通過郵件(jian)找API對接人申請(qing)廣告(gao)(gao)主的(de)API_id和API_key，且需(xu)申請(qing)添加(jia)到白名單

（5）正式環境對接

3、說明-對接文檔

處(chu)(chu)理時間：所(suo)有(you)API對(dui)接需求(qiu)(qiu)統一(yi)在當月的第二周和第四周統一(yi)處(chu)(chu)理，當月第一(yi)周和第三周不(bu)處(chu)(chu)理新的對(dui)接需求(qiu)(qiu)（已完成(cheng)對(dui)接后(hou)，中(zhong)間出(chu)現的問題會解(jie)決）PS：Omni API對(dui)接文檔可以先提供給廣告側(ce)的開發(fa)同學(xue)了解(jie)一(yi)下。

微信拉(la)群(qun)：微信群(qun)命名(ming)規(gui)則：OPPO_API+商(shang)戶名(ming)稱（例：OPPO_API+唯品會）

郵件模板：

OPPO廣告郵(you)件(jian)模版

4、注意事項

文檔(dang)獲(huo)取(qu)入口：OPPO廣(guang)告(gao)營銷平臺(tai)工具箱(xiang)→Omini API

OPPO廣告文檔獲取入口

先同對接的(de)銷售(shou)運營申請秘鑰做(zuo)鑒權(quan)

離線(xian)側數(shu)據(ju)(ju)目前基本(ben)上在(zai)5點左右跑完(wan)，為了(le)(le)避免(mian)客戶拉取不到數(shu)據(ju)(ju)，建議(yi)客戶在(zai)7點再拉取離線(xian)側數(shu)據(ju)(ju)目前已(yi)(yi)支持數(shu)據(ju)(ju)ready on的接口(kou)，可(ke)以用于(yu)判斷數(shu)據(ju)(ju)是否已(yi)(yi)跑完(wan)，可(ke)以在(zai)請(qing)求(qiu)數(shu)據(ju)(ju)前先請(qing)求(qiu)ready on的接口(kou)，了(le)(le)解數(shu)據(ju)(ju)的準備信息

三、H5-API申請流程及使用

1、定義：用于H5表單，小(xiao)程序/小(xiao)游(you)戲等推廣(guang)類型的轉化數據對(dui)接回傳，應用oCPX廣(guang)告投放

2、H5表單流程：

OPPO廣告H5表單流程

3、小程序/小游戲流程：

分為鑒權(quan)版和免鑒權(quan)版，區別(bie)在(zai)于(yu)是否需要單獨賬號申請api_key和api_id。無(wu)鑒權(quan)版需客戶(hu)提供加蓋公章(zhang)的免責說明文(wen)件

免鑒權為(wei)例，對接流(liu)程如下(xia)：

（1）免鑒權申請書簽訂，申請請求接口

流程：OPPO廣告(gao)主(zhu)線(xian)下簽訂(ding)申請加蓋(gai)公章 (2份)一返(fan)回(hui)(hui)公章掃(sao)描件&郵(you)寄原件一申請書保留(liu)在廣告(gao)業務側銷售運營(ying)處(chu) 一運營(ying)提(ti)供客(ke)戶(hu)免鑒權API請求(qiu)接(jie)口一客(ke)戶(hu)對(dui)接(jie)API做數據回(hui)(hui)傳鑒權說明按照客(ke)戶(hu)主(zhu)體(ti)申請即可，無需分(fen)賬號(hao)申請

（2）對接API一真實環境投放驗數

運營提供API接(jie)口，按照文檔對(dui)接(jie)

回傳游(you)戲注冊(ce)，游(you)戲付費 (107) (108)

廣告(gao)小額投放，驗數是否正常回(hui)傳和歸因

廣(guang)告(gao)預(yu)覽:暫時無法不(bu)能通(tong)過落地頁的二維(wei)碼預(yu)覽實(shi)現(xian)(預(yu)覽方式:創建(jian)微信小游戲落地頁一創建(jian)廣(guang)告(gao)一工具箱(xiang)強(qiang)拉工具一配置廣(guang)告(gao)id和手(shou)機imei一OPPO瀏覽器刷廣(guang)告(gao)即(ji)可驗證鏈路

四、H5-API線索創建流程

1、權限申請優先：客戶提供廣(guang)告主ID申請api_id 和(he)api_key

2、創建(jian)分兩步(bu)：營銷平臺工具箱→轉(zhuan)化跟(gen)(gen)蹤(zong)，先創建(jian)API類(lei)線索目標，再(zai)創建(jian)網頁(ye)轉(zhuan)化跟(gen)(gen)蹤(zong)進行落地頁(ye)綁(bang)定

OPPO廣(guang)告線(xian)索跟蹤(zong)管(guan)理

3、回傳驗數：通過網頁校(xiao)驗，線索狀態為有效，落地頁才可投(tou)放

OPPO廣告(gao)回傳驗數

五、H5-API線索投放流程

1、OPPO廣(guang)告目(mu)標鏈(lian)接：選擇API線索投(tou)放。填寫需要(yao)投(tou)放的落地頁鏈(lian)接。僅在白(bai)名單內的落地頁鏈(lian)接可進行轉(zhuan)化目(mu)標的投(tou)放

OPPO廣告目標鏈接

2、轉化類型：線索提(ti)交落地(di)頁校(xiao)驗通過后(hou)可選擇

OPPO廣(guang)告轉化類型

六、H5-JS線索申請流程

1、定義：用(yong)于(yu)H5表單，小程序/小游戲等推廣(guang)類型的轉化數(shu)據對接回(hui)傳，應用(yong)oCPX廣(guang)告投放

2、H5表單流程：

OPPO廣(guang)告(gao)H5表單流程

3、小程序/小游戲流程：

分為鑒(jian)權(quan)版(ban)和免(mian)鑒(jian)權(quan)版(ban)，區別在于是否需要單獨賬號(hao)申請api_key和api_id。無(wu)鑒(jian)權(quan)版(ban)需客(ke)戶提供(gong)加蓋(gai)公章(zhang)的免(mian)責說明文件

免鑒權為例，對接流程如下：

（1）免鑒權申請書簽訂，申請請求接口

流程(cheng):廣告主線下簽(qian)訂申(shen)請(qing)(qing)加蓋(gai)公章 (2份)一(yi)(yi)返回(hui)公章掃描件&郵寄原件一(yi)(yi)申(shen)請(qing)(qing)書保留在(zai)廣告業(ye)務側(ce)銷售(shou)運營(ying)處 一(yi)(yi)運營(ying)提供客戶免鑒(jian)權(quan)API請(qing)(qing)求(qiu)接(jie)口一(yi)(yi)客戶對接(jie)API做數(shu)據回(hui)傳鑒(jian)權(quan)說(shuo)明按照客戶主體申(shen)請(qing)(qing)即可，無(wu)需分賬號申(shen)請(qing)(qing)

（2）對接API一真實環境投放驗數

運營提供API接口，按照文(wen)檔對接

回傳游戲注冊，游戲付費(fei) (107) (108)

廣(guang)告小額投放，驗數(shu)是否正常(chang)回傳(chuan)和(he)歸因

廣(guang)(guang)(guang)告(gao)預(yu)覽:暫時無法不能(neng)通過落地頁的二維碼預(yu)覽實現(xian)(預(yu)覽方(fang)式:創建(jian)微(wei)信小游(you)戲落地頁一(yi)(yi)創建(jian)廣(guang)(guang)(guang)告(gao)一(yi)(yi)工具箱強拉工具一(yi)(yi)配(pei)置(zhi)廣(guang)(guang)(guang)告(gao)id和手機imei一(yi)(yi)OPPO瀏(liu)覽器刷廣(guang)(guang)(guang)告(gao)即可(ke)驗證(zheng)鏈路

七、H5-JS線索創建流程

1、 工具箱-轉化(hua)跟(gen)蹤-線索跟(gen)蹤管(guan)理新建線索目標→JS跟(gen)蹤→選擇轉化(hua)類型

OPPO廣告跟(gen)蹤線索

2、在“查(cha)看(kan)”頁面查(cha)看(kan)JS的(de)部(bu)署(shu)(shu)代(dai)(dai)碼。OPPO廣告主需將基礎代(dai)(dai)碼和轉化(hua)代(dai)(dai)碼部(bu)署(shu)(shu)到(dao)對應(ying)的(de)頁面中

OPPO廣(guang)告(gao)JS跟蹤

3、根據校(xiao)驗步驟，進(jin)行基(ji)礎代碼和轉化代碼的校(xiao)驗，確(que)保頁(ye)面(mian)(mian)JS部署(shu)正確(que)的上報數據 頁(ye)面(mian)(mian)校(xiao)驗通(tong)過投放(fang)

OPPO廣告(gao)JS跟蹤(zong)

八、H5-JS線索投放流程

1、OPPO廣(guang)告目標鏈接：選擇JS線(xian)索投放填寫需(xu)要投放的落地頁鏈接

OPPO廣告投放

2、轉化類型(xing)：線索提交(jiao)落地頁校驗通過后可選(xuan)擇(ze)

OPPO廣告出價

本文內(nei)容主要講解了(le)OPPO廣(guang)告的API能力對(dui)接(jie)。現(xian)在OPPO廣(guang)告開戶費用5000元，想要在OPPO推廣(guang)的廣(guang)告主可(ke)以(yi)聯系巨宣網絡哦(e)！

公司優勢

開戶流程

注意事項