全部产品问题

字節跳動小程序

最近更新时间： 2026年01月01日

注意：僅營銷版（及以上版本）支持字節小程序

暫時不支持 在線銷售功能，沒有支付功能

一.註冊賬號

註冊並登陸

在 開發者平臺 https://developer.toutiao.com/ 中點擊右上角的「快捷登錄」進行帳號註冊。

1571206466115175.png

1571109444426864.png

申請小程序

註冊帳號成功後，系統會自動提示進行小程序申請。點擊自動彈出的「申請」按鈕，即可進入小程序申請頁面。（若此次未申請，之後可通過頁面中的「進入開發者平臺」進入）

1571110340130792.png

在該頁面的「選擇類型」條目下選擇「小程序」類型，後續內容根據具體情況各自補充。

小程序申請發出後，字節小程序將在兩個工作日內通過您註冊時的 手機號 以及 郵箱 給予您答覆。若您收到邀請信息，說明您的產品已經通過，可以在後臺進行接入。

注意事項

  • 註冊後該賬號就是後續提交小程序的賬號，手機號等信息請如實填寫；
  • 在必填信息中， 申請註冊的公司主體信息請填寫完整 ，請勿填寫簡稱，小程序簡介儘量與產品功能相關（後續可修改）；
  • 在選填信息中， 儘量不要空白 ，如實填寫相關情況。

二.創建小程序

填寫信息

進入 開發者平臺 ，登錄帳號後，點擊「進入開發者平臺」，點擊「創建一個小程序」。

1571110360713285.png

點擊創建小程序，即進入下圖所示頁面，按提示輸入相關內容。

1571110430154520.png

點擊下一步之後需進行賬號手機動態驗證，驗證成功即可進入小程序後臺。

1571110548620479.png

根據小程序開發引導，完整小程序對應的基礎信息填寫，請如實填寫相關信息。

特別注意：基本信息中的分類請如實填寫，將影響小程序的推薦精準度；小程序服務類型請如實填寫，不同類型需上傳不同的服務資格證明。

三.主體認證

創建完成後，進入小程序總覽頁，點擊「去認證」，進行主體認證。

1571110534882819.png

主體身份選擇

目前支持的主體身份類型：企業開發者，個人開發者。

身份選擇後，不可進行修改。請開發者根據自身情況時間選擇。

1571111244705023.png

企業開發者

填寫管理員個人信息：

1571111442149847.png

填寫企業信息：

1571111452568966.png

填寫審覈聯繫人信息及發票信息：

企業認證審覈服務費可開具票面內容爲【技術服務費】的增值稅普通發票（電子票），發票抬頭爲當前認證公司全稱（不可更改）。 繳費之日起30個工作日內開具。發送到您所留的郵箱。

1571111467108624.png

支付審覈費用，進入審覈流程：

企業開發者需支付300元/次的審覈服務費用。這是用戶基於字節跳動提供的資質審覈服務而支付的一次性費用，用戶每申請一次認證服務需要支付一次審覈服務費。無論認證成功或失敗，都需要支付審覈服務費。

1571111523811941.png

等待審覈結果，企業開發者的結果將在1~3個工作日反饋給開發者。 審覈期間，可正常開發、配置小程序信息。

1571111545107060.png

個人開發者：

填寫管理員信息：

1571111558822330.png

等待審覈結果，結果將在1~3個工作日反饋給開發者。 審覈期間，可正常開發、配置小程序。

1571111572604025.png

四.開發前準備

添加協作者/管理員

進入協作欄，點擊添加按鈕即可添加管理員/協作者，點擊添加之後會出現邀請頁面。

1571116885834332.png

沒有註冊過的用戶可通過郵箱邀請，通過以下權限管理選擇給其添加的權限，點擊完成則添加成功，受邀者郵箱會收到信息，從郵箱點擊進行操作即可。

獲取 Appid、AppSecret

登錄頭條開發者平臺，選擇需要獲得的小程序，進入對應的小程序「開發」欄，選擇開發。

1571117017933866.png

設置服務器域名

進入小程序頁面，點擊開發欄，即可看到服務器域名配置區域。

  • request 合法域名
  • socket 合法域名
  • uploadFile 合法域名
  • downloadFile 合法域名

1571117034114981.png

企業資質的開發者可以開通 webview 域名「必須通過域名校驗」。

1571117101984613.png

五.開發與調試

開發

請直接使用小程序開發者工具進行開發，最新版下載地址： 開發者工具下載

具體能力說明可查看： 官方開發文檔

有問題請在論壇中查詢及反饋： 字節跳動開放社區

操作流程

在建站小程序編輯器右上角點擊生成、填寫好之前獲取的Appid和AppSecret等。

1571117138700181.png

點擊保存後彈出下載代碼界面，下載後解壓文件。

1571117156471728.png

打開字節跳動開發者工具，導入剛剛解壓的文件。

1571117189819651.png

上傳時版本號 按以下格式填寫 0.0.1 不能有 字母 只能是數字

調試流程

當小程序更新完成後，將會生成對應的二維碼，可掃碼進行真機調試。

1571117208128500.png

真機調試步驟如下：

  • 手機重新安裝今日頭條線上最新版，kill 掉進程重啓，打開 App 左右滑動 tab 頁，正常瀏覽 app 幾秒；
  • 使用安裝測試 App 的手機掃碼（測試某個應用，則使用對應的應用掃碼），掃碼後 Android 下使用 Chrome、iOS 使用 Safair 打開對應網址，點擊打開小程序即可喚起，請務必使用 Chorme 和 Safair ，不然不能正常喚起；
  • 注意事項：

1571117227109858.png

登錄及獲取用戶信息

如果需要獲取用戶信息（getUserinfo 文檔： 獲取已登錄用戶的相關信息 ），調用之前那請務必使用 login（文檔： 獲取臨時登錄憑證 ）。

由於頭條用戶存在未登錄情況，使用 login 及 getUserinfo時，需要兼容未登錄用戶的情況，避免出現未登錄用戶反覆彈出登錄框，不能進入小程序的情況。

請依據你的小程序設計需要來合理選擇是否調用獲取 getUserinfo 。

部分功能接入說明

六.審覈流程

上傳

當測試完成，小程序的功能和體驗都較爲完整時，在開發中工具中點擊「上傳」按鈕，一鍵上傳代碼包。

1571117242134286.png

提審

在開發者工具上完成上傳後，登錄開發者平臺，可以在小程序詳情頁的「發佈」中查看到上傳的測試版本，填寫當前版本信息並上傳三張小程序內容截圖，完成提審，審覈將會在 1-2 個工作日完成。

注： 版本號應符合字節跳動小程序 字節跳動小程序運營審覈規範

可以在「審覈版本」中看到正在審覈的小程序版本及審覈狀態，若審覈不通過，會顯示未通過原因（藍字爲相關截屏和截圖信息）。審覈狀態顯示通過後，方可發佈小程序上線。

1571117256303499.png

特別提醒：

  • 小程序在提審前會有自測環節，爲了保證通過率，請開發者提審前通過自測環節進行自查；
  • 在審覈過程中，開發者請遵循後臺中的提示進行操作補全對應信息；
  • 小程序首次上線前的審覈都需進行 qa 迴歸，預計在 1-2 個工作日；
  • 當小程序提審後，務必於後臺配置"安全域名”，不然將影響小程序上線，安全域名必須爲 https://；
  • 目前的審覈是基於雙端審覈，即頭條端和抖音端，若只需上線一端，請在更新日誌中備註清楚，方便加快審覈速度。

七.發佈小程序

審覈通過後，發佈按鈕亮起，開發者點擊發布，小程序即可入線上版本。

設置搜索關鍵詞與分享

當發佈未配置搜索關鍵詞與分享內容版本時，會彈出提示與跳轉地址，點擊【前往配置】。

1571117272440333.png

如果已有搜索關鍵詞和分享內容，想要查看或進行修改，可以在小程序詳情頁中的【設置】進行相應的配置。配置搜索關鍵詞：提交的搜索關鍵詞應符合 小程序關鍵詞搜索 。

1571117283109459.png

1571117294106652.png

1571117307581595.png

1571117323102372.png

發佈上線

通過審覈並且配置過搜索關鍵詞與分享內容的版本，在【審覈版本】中點擊發布即可將小程序發佈至線上。

1571117337110478.png

可以在小程序列表中看到相應小程序線上的版本號。

1571117350113268.png