 |
字節巨量引擎-巨量引擎
專用API
【更新時間: 2024.07.23】
巨量引擎商業開放平臺提供廣告投放、賬戶管理、數據洞察、人群管理、轉化管理等一站式服務，支持批量操作和實時管理。
咨詢
去服務商官網采購>
|
瀏覽次數
225
采購人數
1
試用次數
0
SLA: N/A
響應: N/A
適用于個人&企業
收藏
×
完成
取消
×
書簽名稱
確定
|
相似API
飛豬旅行開放服務
430
飛豬開放平臺是阿里巴巴集團旗下的綜合性旅游服務平臺的重要組成部分，旨在為開發者提供全面的旅行服務接入能力。
Linkedln廣告標題生成
46
LinkedIn廣告標題生成器是一款專為LinkedIn廣告設計的API服務，旨在幫助用戶創建引人注目、吸引點擊且轉化率高的廣告標題。通過分析用戶提供的廣告相關信息和目標受眾特征，此API能夠生成與廣告內容高度相關且吸引人的標題，提升廣告的效果和轉化率。
谷歌廣告生成
49
谷歌廣告文案生成專門設計用于創建最佳效果的Google廣告文案，幫助將訪問者轉化為客戶。該服務通過分析用戶的廣告目標和目標受眾，結合市場趨勢和搜索引擎優化(SEO)原則，生成具有高轉化率的廣告內容。
- API詳情
- 使用指南
- 常見 FAQ
- 關于我們
- 相關推薦
產品介紹
什么是巨量引擎的字節巨量引擎?
巨量引擎商業開放平臺是一個為廣告主和開發者提供全面服務的平臺，包括廣告投放管理、賬戶管理、數據洞察、DMP人群管理、轉化管理和建站管理等。該平臺支持廣告組/計劃/創意的批量化操作，實現實時的賬號資料及資金消耗管理，提供多維度的報表數據查詢，以及高效的人群包管理和轉化目標設置。此外，平臺還支持搜索廣告的精準投放和定向包管理，以及素材的上傳和管理。平臺還提供企業號相關的私信管理、自動回復設置和經營數據分析等功能，旨在幫助用戶優化廣告投放效果，構建卓越的開發者生態。
什么是巨量引擎的字節巨量引擎接口？
由服務使用方的應用程序發起，以Restful風格為主、通過公網HTTP協議調用巨量引擎的字節巨量引擎，從而實現程序的自動化交互，提高服務效率。
巨量引擎的字節巨量引擎有哪些核心功能？
|
投放管理 轉化管理 賬戶管理 建站管理 數據洞察 搜索廣告 DMP人群管理 定向包管理 |
投放管理
賬戶管理
數據報表
素材管理 |
任務列表
訂單列表
投后分析
受眾分析 |
私信管理 私信菜單 自動回復 經營分析 |
巨量引擎的字節巨量引擎的核心優勢是什么？
-
全面的廣告投放能力：巨量引擎提供了從廣告組、計劃到創意的批量化增刪改查功能，支持廣告主在不同場景下進行精準的廣告投放。
-
高效的數據管理：通過連山數據同步服務，巨量引擎能夠實現數據與廣告后臺的自動同步，確保廣告主能夠實時獲取到最新的數據，同時支持指定數據的訂閱更新，提高數據查詢效率。
-
豐富的營銷解決方案：巨量引擎不僅支持傳統的廣告投放，還通過巨量千川為商家和創作者提供抖音電商一體化營銷解決方案，幫助商家在抖音平臺上實現銷售增長。同時，巨量星圖觸達頭條、抖音、西瓜視頻等多端海量創作者，為品牌提供高價值的內容服務。
-
多場景支持：巨量引擎、巨量千川、巨量星圖、企業號等多個業務板塊的開放能力，能夠滿足不同客戶的廣告營銷訴求，無論是品牌宣傳、產品銷售還是內容營銷，都能找到適合的解決方案。
-
卓越的開發者生態：巨量引擎開放平臺致力于構建卓越的開發者生態，通過提供接口開放能力、數據訂閱推送等相關服務，支持開發者快速接入平臺，共同推動廣告營銷行業的創新發展。
在哪些場景會用到巨量引擎的字節巨量引擎？
|
廣告投放優化 廣告主可以使用巨量引擎的API接口來管理廣告組、計劃和創意，實現批量化的增刪改查操作，從而優化廣告投放效果。 |
 |
 |
數據分析和報表生成 通過API接口，廣告主可以實時獲取廣告投放后的數據，進行全方位的投后數據分析，并生成詳細的數據報表，幫助廣告主更好地了解廣告效果。 |
|
素材管理 廣告主可以使用API接口上傳和獲取圖片、視頻等廣告素材，提高素材管理的效率和準確性。 |
 |
 |
電商營銷 對于在抖音等平臺進行電商銷售的商家，巨量千川的API接口可以幫助他們實現商品與廣告的深度結合，提升銷售效果。 |
|
內容營銷 品牌主可以通過巨量星圖的API接口觸達海量創作者，合作創作高質量的內容，進行品牌宣傳和產品推廣。 |
 |
 |
企業號運營 企業號用戶可以使用API接口來管理自己的賬戶信息和關系，以及接收和處理各類事件通知，提升企業在抖音平臺上的運營效率。 |
使用指南
產品問答
?
調取接口，提示“Request too frequent”？
接口調用超出頻控限制，具體說明可以查看：頻控限制說明
?
調接口時，返回“No permission to operate advertiser XXXX”的...
該報錯是由于使用Access Token下已授權的相應廣告主賬戶中不包含要操作的廣告主ID，可參考下述方式查詢Token下已授權的賬戶。 查詢已授權賬戶可參考接口文檔：獲取已授權賬戶 注意：如果是通過代理商或縱橫組織賬戶授權（接口返回advertiser_role字段 = 2-縱橫組織，3-一級代理商，4-二級代理商），還需要通過相應接口獲取對應代理商或縱橫組織賬戶下廣告主賬戶。 查詢代理商賬戶下廣告主列表：廣告主列表（代理商） 查詢管家賬戶下廣告主列表：廣告主列表（縱橫組織） 按照上述方式查詢沒有相應廣告主ID，如需操作該廣告主，則需要申請對應廣告主授權，并使用獲取到的auth_code重新獲取該廣告主相應的AccessToken，授權方式可參考文檔：Oauth2.0 授權
?
調用接口時，返回504/502錯誤？
接口調用峰期，持續獲取大量數據易導致超時。目前的建議如下： 1）服務在整時整點壓力較大（比如12:00，12:30這種），建議獲取數據時候錯開這些時間點，請求數據相應時間會變的快一些; 2）page_size設置的小一些，減少一次請求的數據量 ; 3）設置過濾條件，減少整體處理（total_number）的數據量 ; 4）建議設置一個重試機制; 5）歷史報表數據獲取建議可以通過異步任務獲取
?
對某些可選的字段，實際不需要，能否傳“”或者null/調用接口，報錯“xxx不能為空”
不可以，如果您實際不需要，參數中就不要傳這個字段，而不是將這個字段置空或者null，如果傳了就會檢驗；
?
調取接口時，返回http 414 url 太長？
傳遞的參數太長，可以用json的形式傳遞過來（get請求也可以發json）。Python形式,可以參考文檔示例。Java形式可以查看如下代碼： // 請求參數 Map data = new HashMap(){}; // 構造請求 HttpEntityEnclosingRequestBase httpEntity = new HttpEntityEnclosingRequestBase() { @Override public String getMethod() { return "GET";} }; client = HttpClientBuilder.create().build(); httpEntity.setEntity(new StringEntity(JSONObject.toJSONString(data),ContentType.APPLICATION_JSON));
?
調取接口時，返回“405 Method Not Allowed”錯誤？
請求方法使用錯誤，確認使用的請求方法與此接口請求方法是否相同（POST請求或者GET請求）。
?
調用接口，報： advertiser does no grant you XXXX permissi...
您可以按照以下兩個步驟完成授權： 步驟一： 確認開發者賬戶是否擁有相應Scope權限 1. 登陸開發者賬戶，進入APPID管理（點擊進入），確認開發者是否擁有相應權限 2. 開發者賬戶尚未擁有相應權限，點擊申請進入提交 注意：對于第三方角色暫不開放「廣告主信息與資質管理」、「代理商賬號管理-創建和修改廣告主」、「代理商賬號管理-資金和流水管理」權限，如果需要獲取賬戶信息可以通過廣告主公開信息（/advertiser/public_info/）接口查詢到賬戶名、公司名等基礎信息。 步驟二： 開發者擁有相應權限后需申請廣告主重新授權 1. 確認申請接口對應scope權限點 可以對照【接口清單】查詢接口對應Scope權限點數值 2. 設置授權URL（注意授權URL中的Scope授權范圍） 設置授權URL：授權URL的形式如： https://ad.oceanengine.com/openapi/audit/oauth.html?app_id=XXX&state=xxx&scope=xxx&redirect_uri=xxx 其中主要包括四個元素 app_id： 即應用ID，開發者創建應用的唯一標識，可通過應用管理查看； state：即自定義參數，可用于傳遞自定義信息，回調時會原樣帶回。常見應用比如將廣告主賬號作為自定義參數，回調時以區分授權碼對應的廣告主，其他應用方式可按實際需要選擇 scope：即授權范圍，授權的權限范圍，不傳時代表當前應用擁有的所有權限。注意，權限范圍只能在此應用擁有的權限范圍之內。格式例如：scope=[1, 2, 3, 41]。具體權限范圍取值見Scope權限說明，每個權限后面的數字記為該權限的表示數值 redirect_uri：即回調鏈接，由開發者自行提供和定義，用于授權成功跳轉并接受回調信息。注意：redirect_uri 需要與APP應用的回調鏈接保持一致，否則會報錯,回調地址示范：https://yourdomain.com/oauth2/callback/ 3. 授權URL發送給廣告主，引導廣告主完成授權，重新獲取Token使用即可
?
調用接口時，報： Missing data for required field ？
您需要確認對應的字段是否傳進來了哈（可以在代碼里debugger仔細排查），如果確實傳進來了，可以確認接口尾部是否帶上了反斜杠/。
?
對于PHP傳數組的建議
以上內容未解決問題可反饋工單【提交工單】
?
對于一個廣告主創建廣告計劃及廣告創意的要求
單日最多創建500個計劃 單日最多創建500個自定義創意
?
傳入advertiser_id非廣告主類型，導致接口返回報錯或沒有數據內容
字段 類型 描述 advertiser_role number 1-普通廣告主，2-縱橫組織，3-一級代理商，4-二級代理商 參考文檔：獲取已授權賬戶 注：類型為1-普通廣告主的對應advertiser_id為廣告主id，其他類型還需通過相應接口獲取對應賬戶下的廣告主id 賬號管家：廣告主列表（縱橫組織） 代理商：廣告主列表
關于我們
北京巨量引擎網絡技術有限公司是一家位于北京的高科技企業，專注于提供全場景的數字營銷解決方案。公司依托強大的技術平臺和豐富的廣告資源，為品牌和商家提供從廣告創意制作到效果優化的一站式服務。通過智能化的內容分發、技術應用、規?；脩舾采w和科學化評估，巨量引擎助力企業實現品牌建設、搜索營銷、電商經營等多目標營銷，推動商業增長。同時，公司還提供營銷學堂、成功案例分享等學習資源，幫助企業提升營銷能力。
聯系信息
API接口列表
使用指南
依賴服務
產品問答
?
調取接口，提示“Request too frequent”？
接口調用超出頻控限制，具體說明可以查看：頻控限制說明
?
調接口時，返回“No permission to operate advertiser XXXX”的...
該報錯是由于使用Access Token下已授權的相應廣告主賬戶中不包含要操作的廣告主ID，可參考下述方式查詢Token下已授權的賬戶。 查詢已授權賬戶可參考接口文檔：獲取已授權賬戶 注意：如果是通過代理商或縱橫組織賬戶授權（接口返回advertiser_role字段 = 2-縱橫組織，3-一級代理商，4-二級代理商），還需要通過相應接口獲取對應代理商或縱橫組織賬戶下廣告主賬戶。 查詢代理商賬戶下廣告主列表：廣告主列表（代理商） 查詢管家賬戶下廣告主列表：廣告主列表（縱橫組織） 按照上述方式查詢沒有相應廣告主ID，如需操作該廣告主，則需要申請對應廣告主授權，并使用獲取到的auth_code重新獲取該廣告主相應的AccessToken，授權方式可參考文檔：Oauth2.0 授權
?
調用接口時，返回504/502錯誤？
接口調用峰期，持續獲取大量數據易導致超時。目前的建議如下： 1）服務在整時整點壓力較大（比如12:00，12:30這種），建議獲取數據時候錯開這些時間點，請求數據相應時間會變的快一些; 2）page_size設置的小一些，減少一次請求的數據量 ; 3）設置過濾條件，減少整體處理（total_number）的數據量 ; 4）建議設置一個重試機制; 5）歷史報表數據獲取建議可以通過異步任務獲取
?
對某些可選的字段，實際不需要，能否傳“”或者null/調用接口，報錯“xxx不能為空”
不可以，如果您實際不需要，參數中就不要傳這個字段，而不是將這個字段置空或者null，如果傳了就會檢驗；
?
調取接口時，返回http 414 url 太長？
傳遞的參數太長，可以用json的形式傳遞過來（get請求也可以發json）。Python形式,可以參考文檔示例。Java形式可以查看如下代碼： // 請求參數 Map data = new HashMap(){}; // 構造請求 HttpEntityEnclosingRequestBase httpEntity = new HttpEntityEnclosingRequestBase() { @Override public String getMethod() { return "GET";} }; client = HttpClientBuilder.create().build(); httpEntity.setEntity(new StringEntity(JSONObject.toJSONString(data),ContentType.APPLICATION_JSON));
?
調取接口時，返回“405 Method Not Allowed”錯誤？
請求方法使用錯誤，確認使用的請求方法與此接口請求方法是否相同（POST請求或者GET請求）。
?
調用接口，報： advertiser does no grant you XXXX permissi...
您可以按照以下兩個步驟完成授權： 步驟一： 確認開發者賬戶是否擁有相應Scope權限 1. 登陸開發者賬戶，進入APPID管理（點擊進入），確認開發者是否擁有相應權限 2. 開發者賬戶尚未擁有相應權限，點擊申請進入提交 注意：對于第三方角色暫不開放「廣告主信息與資質管理」、「代理商賬號管理-創建和修改廣告主」、「代理商賬號管理-資金和流水管理」權限，如果需要獲取賬戶信息可以通過廣告主公開信息（/advertiser/public_info/）接口查詢到賬戶名、公司名等基礎信息。 步驟二： 開發者擁有相應權限后需申請廣告主重新授權 1. 確認申請接口對應scope權限點 可以對照【接口清單】查詢接口對應Scope權限點數值 2. 設置授權URL（注意授權URL中的Scope授權范圍） 設置授權URL：授權URL的形式如： https://ad.oceanengine.com/openapi/audit/oauth.html?app_id=XXX&state=xxx&scope=xxx&redirect_uri=xxx 其中主要包括四個元素 app_id： 即應用ID，開發者創建應用的唯一標識，可通過應用管理查看； state：即自定義參數，可用于傳遞自定義信息，回調時會原樣帶回。常見應用比如將廣告主賬號作為自定義參數，回調時以區分授權碼對應的廣告主，其他應用方式可按實際需要選擇 scope：即授權范圍，授權的權限范圍，不傳時代表當前應用擁有的所有權限。注意，權限范圍只能在此應用擁有的權限范圍之內。格式例如：scope=[1, 2, 3, 41]。具體權限范圍取值見Scope權限說明，每個權限后面的數字記為該權限的表示數值 redirect_uri：即回調鏈接，由開發者自行提供和定義，用于授權成功跳轉并接受回調信息。注意：redirect_uri 需要與APP應用的回調鏈接保持一致，否則會報錯,回調地址示范：https://yourdomain.com/oauth2/callback/ 3. 授權URL發送給廣告主，引導廣告主完成授權，重新獲取Token使用即可
?
調用接口時，報： Missing data for required field ？
您需要確認對應的字段是否傳進來了哈（可以在代碼里debugger仔細排查），如果確實傳進來了，可以確認接口尾部是否帶上了反斜杠/。
?
對于PHP傳數組的建議
以上內容未解決問題可反饋工單【提交工單】
?
對于一個廣告主創建廣告計劃及廣告創意的要求
單日最多創建500個計劃 單日最多創建500個自定義創意
?
傳入advertiser_id非廣告主類型，導致接口返回報錯或沒有數據內容
字段 類型 描述 advertiser_role number 1-普通廣告主，2-縱橫組織，3-一級代理商，4-二級代理商 參考文檔：獲取已授權賬戶 注：類型為1-普通廣告主的對應advertiser_id為廣告主id，其他類型還需通過相應接口獲取對應賬戶下的廣告主id 賬號管家：廣告主列表（縱橫組織） 代理商：廣告主列表
關于我們
北京巨量引擎網絡技術有限公司是一家位于北京的高科技企業，專注于提供全場景的數字營銷解決方案。公司依托強大的技術平臺和豐富的廣告資源，為品牌和商家提供從廣告創意制作到效果優化的一站式服務。通過智能化的內容分發、技術應用、規模化用戶覆蓋和科學化評估，巨量引擎助力企業實現品牌建設、搜索營銷、電商經營等多目標營銷，推動商業增長。同時，公司還提供營銷學堂、成功案例分享等學習資源，幫助企業提升營銷能力。
聯系信息
