紅書筆記投放
|
行業資訊 |
小紅書廣告推廣表單API 對接發表時間：2023-12-07 19:39 小紅書廣告推廣表單API 對接 1. 表單數據 API 對接文檔1.1 對接流程第一步：在落地頁-數據推送功能處填寫有效的POST消息接收地址 1.2 平臺功能截圖
1.3 消息發送小紅書廣告推廣當用戶提交表單時，會將信息以 POST 請求的方式，JSON數據格式推送到在落地頁配置頁面中填寫的消息接收地址。對于response code為200即認為推送成功，對于推送失敗的情況，會每隔 30s重試一次，最多重試 3 次。 地址格式要求：對外開放的，可接受PSOST請求的http服務URL 1.4 簽名驗證為了確保消息來源是小紅書，可以選擇對POST數據的來源進行安全認證（非必須），驗證方法如下： ● 解析POST消息header中的X-Red-Signature參數（格式為sha1=5bf9f4192d049dfe442edbcd533223673bb188e4） ● 解析POST 消息的request body（未經反序列化的原始body數據） ● 以落地頁配置頁面獲取的token為secretKey，和body數據生成簽名，與header中的signature進行校驗 Java示例代碼：Java示例代碼 Python示例代碼：Python示例代碼 推送消息示例：直接提供代碼示例，包含姓名，電話，郵箱，性別，地址，單選，多選，文本，數值等類型的代碼示例 推送消息示例 簽名驗證 demo（Java）：簽名驗證 2. 有效表單回傳 API 對接文檔目前，若客戶在落地頁-數據推送功能處填寫了有效的POST消息接收地址，則用戶提交的表單數據會通過小紅書廣告推廣表單數據API回傳給客戶。有效表單是指，用戶通過廣告點擊，跳轉建站落地頁后進行留資，客戶收到線索后通過電話、微信等形式回訪用戶，確認用戶轉化意向的，當做有效表單。本API解決的是有效表單回傳的問題。 2.1 操作流程1) 小紅書廣告推廣在落地頁 - 數據推送功能處填寫有效的 POST 消息接收地址 2) 發送測試消息進行聯調測試（response code 必須為 200 才可聯調成功） 3) 使用聯調成功的落地頁進行投放，API 實時回傳表單數據 4) 通過接口回傳表單相關數據，回傳的表單數據會默認為有效表單 2.2 接口說明請求地址：https://www.xiaohongshu.com/api/hawking/leads/return 請求方法：POST 請求頭：Content-Type:application/json 2.3 參數解釋
2.4 請求示例curl -X POST --header 'Content-Type: application/json' --header 'Accept: text/json' -d '{"campaignId": 1834295, "creativityId": 9725765, "leadsId": "61935e4f2e299c0001fea6e8", "unitId": 2244696 }' 'https://www.xiaohongshu.com/api/hawking/leads/return' 正確返回： { "result": 0, "success": true, "msg": "success" } |
