百度智能小程序 配置頁面基礎(chǔ)信息的接口

2020-09-05 14:44 更新

swan.setPageInfo

setPageInfo 接口目前只針對百度 APP 開放使用。

配置頁面基礎(chǔ)信息的接口,目前在 Web 態(tài)代碼和收藏里會被使用;小程序頁面被收藏時,會用到 setPageInfo 中設(shè)置的頁面標(biāo)題。setMetaDescription/setMetaKeywords/setDocumentTitle 已停止維護(hù),推薦使用 setPageInfo 。

建議在 Page 的 onShow 生命周期中使用。由于 onShow 生命周期會在用戶前進(jìn)后退時觸發(fā),若數(shù)據(jù)來自 onLoad 等其他生命周期,建議使用變量形式存儲并在 onShow 中調(diào)用 setPageInfo 函數(shù),詳情參見下面的參考示例 1 。

解釋:智能小程序可接入百度搜索和宿主 App 信息流,swan.setPageInfo 負(fù)責(zé)為小程序設(shè)置各類頁面基礎(chǔ)信息,包括標(biāo)題、關(guān)鍵字、頁面描述以及圖片信息、視頻信息等。開發(fā)者為智能小程序設(shè)置完備的頁面基礎(chǔ)信息,有助于智能小程序在搜索引擎和信息流中得到更加有效的展示和分發(fā)。其中 title 和 image 字段也增強(qiáng)了用戶添加頁面收藏的模板展現(xiàn)和回訪體驗(yàn)(用戶可以在小程序菜單中收藏當(dāng)前頁面,并通過百度 App “我的-常用功能-收藏”回訪已收藏的頁面)。

方法參數(shù)

Object object

object參數(shù)說明

屬性名類型必填默認(rèn)值說明
titleString頁面標(biāo)題。
keywordsString頁面關(guān)鍵詞,多個關(guān)鍵詞之間使用英文逗號 “,” 隔開。
descriptionString頁面描述信息。
releaseDateString否(如宿主 APP 信息流則為必填)原始發(fā)布時間(年-月-日 時:分:秒 帶有前導(dǎo)零),如:2010-07-01 16:30:30。
articleTitleString文章【內(nèi)容】標(biāo)題(適用于當(dāng)前頁面是圖文、視頻類的展示形式,文章標(biāo)題需要準(zhǔn)確標(biāo)識當(dāng)前文章的主要信息點(diǎn);至少 6 個字,不可以全英文。)。
imageString/Array否(頁面有焦點(diǎn)圖,或者正文有圖片時需要設(shè)置)圖片線上地址,用于信息流/搜索等流量場景分發(fā)、用戶收藏后的頁面封面顯示,展現(xiàn)時有圖片可提升用戶點(diǎn)擊率。開發(fā)者可針對一個頁面設(shè)置最多 3 張,圖片必須為頁面內(nèi)圖片。單張圖片最大 2M ;封面圖尺寸:寬>=375px ,高>=250px ,圖片寬高比例 3:2 為佳。多張圖時,用數(shù)組表示。
videoObject/Array否(頁面存在視頻情況下必填)視頻信息,多個視頻時,用數(shù)組表示。
visitObject瀏覽信息。最低支持版本 3.40.6。
likesString點(diǎn)贊量,若頁面未統(tǒng)計(jì)可為空。最低支持版本 3.40.6。
commentsString評論量,若頁面未統(tǒng)計(jì)可為空。最低支持版本 3.40.6。
collectsString收藏量,若頁面未統(tǒng)計(jì)可為空。最低支持版本 3.40.6。
sharesString分享量,若頁面未統(tǒng)計(jì)可為空。最低支持版本 3.40.6。
followersString關(guān)注量,若頁面未統(tǒng)計(jì)可為空。最低支持版本 3.40.6。
successFunction接口調(diào)用成功的回調(diào)函數(shù)。
failFunction接口調(diào)用失敗的回調(diào)函數(shù)。
completeFunction接口調(diào)用結(jié)束的回調(diào)函數(shù)(調(diào)用成功、失敗都會執(zhí)行)。

video 參數(shù)說明

參數(shù)名類型必填說明
urlString視頻地址。
durationString視頻時長(單位為秒)。
imageString視頻封面圖。

visit 參數(shù)說明

參數(shù)名類型必填說明
pvString頁面的瀏覽量(不去重用戶)。
uvString頁面的點(diǎn)擊量(去重用戶)。
sessionDurationString頁面的用戶人均停留時長,以秒為單位。

示例 

在開發(fā)者工具中打開

圖片示例


代碼示例 1: 

在開發(fā)者工具中打開

Page({
    onShow() {
        swan.setPageInfo({
            title: '曬元宵節(jié)活動紅包,愛奇藝60張年卡、600張季卡等你拿!-百度貼吧',
            keywords: '百度,百度貼吧,好運(yùn)中國年,60,曬元,宵節(jié)',
            description: '曬元宵節(jié)活動紅包,愛..昨天的百度APP元宵節(jié)活動中,共發(fā)出2億現(xiàn)金紅包、含151萬個手氣現(xiàn)金大獎和240輛紅旗轎車,誰是好運(yùn)錦鯉,快來分享!馬上驚喜升級~搖中紅包的錦鯉們即刻曬出紅包金額截圖,我們將會抽取660位好運(yùn)錦鯉',
            articleTitle: '曬元宵節(jié)活動紅包,愛奇藝60張年卡、600張季卡等你拿!',
            releaseDate: '2019-01-02 12:01:30',
            image: [
                'https://c.hiphotos.baidu.com/forum/w%3D480/sign=73c62dda83b1cb133e693d1bed5456da/f33725109313b07e8dee163d02d7912396dd8cfe.jpg',
                'https://hiphotos.baidu.com/fex/%70%69%63/item/43a7d933c895d143e7b745607ef082025baf07ab.jpg'
            ],
            video: [{
                url: 'https://www.baidu.com/mx/v12.mp4',
                duration: '100',
                image: 'https://smartprogram.baidu.com/docs/img/image-scaleToFill.png'
            }],
            visit: {
                pv: '1000',
                uv: '100',
                sessionDuration: '130'
            },
            likes: '75',
            comments: '13',
            collects: '23',
            shares: '8',
            followers: '35',
            success: res => {
                console.log('setPageInfo success', res);
            },
            fail: err => {
                console.log('setPageInfo fail', err);
            }
        })
    }
});

參考示例

參考示例 1:開發(fā)者動態(tài)設(shè)置 swan.setPageInfo 字段 
在開發(fā)者工具中打開

Page({
    onLoad() {
        this.requestTask = new Promise((resolve, reject) => {
            const requestHandler = swan.request({
                url: '開發(fā)者服務(wù)器地址',
                header: {
                    'content-type': 'application/json'
                },
                method: 'POST',
                dataType: 'json',
                responseType: 'text',
                data: {
                    key: 'value'
                },
                success: res => {
                    this.setData('data', res.data);
                    resolve();
                },
                fail: err => {
                    console.log('錯誤碼:' + err.errCode);
                    console.log('錯誤信息:' + err.errMsg);
                }
            });
        });
    },
    onShow() {
        this.requestTask.then( requestData => {
            let res = this.getData('data');
            swan.setPageInfo({
                title: res.title,
                keywords: res.keywords,
                description: res.description,
                articleTitle: res.articleTitle,
                releaseDate: res.releaseDate,
                image: res.image,
                video: res.video,
                visit: res.visit,
                likes: '75',
                comments: '13',
                collects: '23',
                shares: '8',
                followers: '35',
                success: res => {
                    console.log('setPageInfo success');
                },
                fail: err => {
                    console.log('setPageInfo fail', err);
                }
            })
        })
    }
});

Bug & Tip

  • releaseData 、 articleTitle 、 image 、 video 、 visit 字段用于宿主 APP 信息流抓取收錄分發(fā),并有助于搜索準(zhǔn)確理解頁面內(nèi)容。
  • title 字段用于搜索抓取當(dāng)前頁面,articleTitle 字段用于當(dāng)前頁面在宿主 APP 信息流中的標(biāo)題展示。
  • 當(dāng)前頁面包含視頻信息時 video 為必填字段, url 、 duration 、 image 為 video 的必填參數(shù);如當(dāng)前頁面不包含視頻信息,可不填寫。
  • 當(dāng)前頁面包含焦點(diǎn)圖或者正文圖片時 image 為必填字段。
  • 當(dāng)前頁面能夠統(tǒng)計(jì)到用戶分發(fā)、互動和時長等數(shù)據(jù)時,visit 字段建議填寫。開發(fā)者可根據(jù)頁面實(shí)際統(tǒng)計(jì)的情況完善 pv 、 uv 、 sessionDuration 、 likes 、 comments 、 collects 、 shares 、 followers 字段,若頁面不包含以上字段時,可不填寫。


以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號