社交分享

為滿足開發(fā)者對社交傳播的訴求，我們提供了分享小程序到QQ好友、QQ群聊和QQ空間的能力。

同時，為了進(jìn)一步提升分享效率，平臺也提供了特定場景下快速分享的能力。

分享面板&最近聯(lián)系人列表 快速分享能力 設(shè)置多種分享消息模板

1. 分享面板&最近聯(lián)系人列表

在分享面板中，可以分享給QQ好友、QQ空間，同時會顯示用戶的最近聯(lián)系人列表，方便用戶快速傳播。

有以下兩種調(diào)用方式：

• qq.showShareMenu
• 小程序/小游戲內(nèi)調(diào)用分享組件

1.2 小程序/小游戲內(nèi)調(diào)用分享組件

1.2.1 小程序

通過設(shè)置button組件的share屬性，可以在小程序內(nèi)調(diào)用上述分享面板，且開發(fā)者可以自由組合分享渠道，進(jìn)一步提升分享效率。

分享面板內(nèi)顯示內(nèi)容設(shè)置，具體見button文檔。

1.2.2 小游戲

可以通過qq.shareAppMessage，調(diào)用分享面板。

2. 快速分享能力

2.1 快速分享面板

在多人參與的場景中，有時用戶不滿足于僅分享到單個QQ會話。在當(dāng)前能力下，用戶操作路徑較長，點(diǎn)擊分享到QQ--選擇好友--發(fā)送--返回再點(diǎn)擊按鈕。

QQ提供了一次調(diào)用、多次發(fā)送的快速分享面板，可大大降低用戶操作成本，助力優(yōu)秀內(nèi)容的快速傳播。

快速分享能力

2.1.1 小程序

button組件的 share-mode 需要設(shè)置元素值'recentContacts'（>=基礎(chǔ)庫1.15.0）

2.1.2 小游戲

qq.shareAppMessage，設(shè)置shareAppType=qqFastShareList

2.2 直接分享到原會話

當(dāng)用戶從某會話中打開小程序，我們預(yù)期用戶有一定可能性會把小程序分享回原聊天會話。

平臺提供了直接分享到原會話能力，幫助開發(fā)者減輕用戶分享心理門檻。

直接分享到原會話

2.2.1 生效場景

群加號面板-一起玩-某個小程序/小游戲 群右上角-群友愛玩-某個小程序/小游戲 分享到群內(nèi)的小程序消息（>=QQ版本8.2.0) 2.2.2 小程序

button組件的 share-mode 需要設(shè)置元素值'quickToDialog'（>=基礎(chǔ)庫1.15.0）

2.2.3 小游戲

qq.shareAppMessage，設(shè)置shareAppType=qqFastShare

3. 一鍵發(fā)空間說說

1.從外部App分享

已有App的開發(fā)者可以通過接入QQ互聯(lián)SDK，讓用戶可以將App分享文字、圖片、視頻、網(wǎng)頁、小程序等內(nèi)容分享給QQ好友、QQ群聊和QQ空間，開發(fā)者僅需在QQ互聯(lián)中將已有的App和小程序關(guān)聯(lián)后即可實(shí)現(xiàn)。 互聯(lián)sdk小程序分享文檔：IOS、Android

TIP

在下列場景接收小程序類型分享，將按照開發(fā)者設(shè)定的分享參數(shù)轉(zhuǎn)成網(wǎng)頁類型分享：

• Mobile QQ ≥ 8.1.0
  - PC QQ
  - macOS QQ
  - iPad
  - AndroidPad

2.通過二維碼打開

為滿足開發(fā)者通過二維碼掃描打開指定小程序，并且跳轉(zhuǎn)到指定頁面的訴求，我們提供了 url 跳轉(zhuǎn)小程序的能力，開發(fā)者按照下述規(guī)則生成 url ，再生成 url 對應(yīng)的二維碼即可使用。

url規(guī)則： https://m.q.qq.com/a/p/{APPID}

參數(shù)

示例： https://m.q.qq.com/a/p/1108291530?s=pages%2Fgame-list%2Fgame-list%3Fmode%3Dwanba

warning 注意

1. s參數(shù)必須進(jìn)行encode
2. QQ低版本的場景會展示為默認(rèn)頁，不需要額外做兼容邏輯
3. url 生效版本如下：
   • Android QQ Version ≥ 8.05
   • iOS QQ Version ≥ 8.03

3. 外部APP打開小程序

已有App的開發(fā)者可以通過接入QQ互聯(lián)SDK，在相同主體前提下，通過APP打開QQ小程序。

互聯(lián)SDK下載地址：Android、iOS

消息觸達(dá)

基于QQ的通知渠道，我們?yōu)殚_發(fā)者提供了可以高效觸達(dá)用戶的消息能力，以便實(shí)現(xiàn)服務(wù)的閉環(huán)并提供更佳的體驗(yàn)。

為滿足不同場景下的消息觸達(dá)，平臺提供了兩種下發(fā)消息的能力，模板消息 & 訂閱消息。

模板消息：無需用戶感知，即可獲取消息下發(fā)權(quán)限。下發(fā)權(quán)限有時限，適合需要對用戶行為進(jìn)行及時反饋的場景。

訂閱消息：需用戶主動訂閱后，才可獲取消息下發(fā)權(quán)限。下發(fā)權(quán)限長期有效，適合中長期運(yùn)營。

推送位置：QQ主界面下拉-右上角信封-小程序通知。（如果存在訂閱消息/模板消息的未讀通知，游戲icon和信封會有紅點(diǎn)顯示）

模板消息

使用簡介

• 功能簡介：QQ每日推送符合條件的用戶信息（7天內(nèi)登陸過游戲且沒收到過服務(wù)消息的用戶），小游戲/小程序開發(fā)商可針對這部分用戶推送消息卡片，卡片模板由平臺提供，開發(fā)商只需更換icon及文案。
• 價值：可推送小游戲/小程序內(nèi)最新活動/版本信息/回流活動等，有效觸達(dá)用戶，獲取更多小程序、小游戲曝光。
• 模板消息下發(fā)條件：當(dāng)用戶有使用QQ小程序/小游戲時，平臺后臺將會為當(dāng)前用戶在當(dāng)前小程序生成一個下發(fā)消息的憑證，即formid，并通過開發(fā)者提供的回調(diào)地址，將formid返回給開發(fā)者。同個appid下，單個用戶7天內(nèi)最多觸發(fā)1個formid，即，同個appid 7天內(nèi)，給1個用戶最多下發(fā)1條消息。
• 數(shù)據(jù)統(tǒng)計(jì)：可通過場景值 = 1014，計(jì)算訂閱消息來源用戶數(shù)據(jù)。

使用說明

步驟一：從開發(fā)者管理端，獲取模板 ID

步驟二：頁面的 form 組件，屬性 report-submit 為 true 時，可以聲明為需要發(fā)送模板消息，此時點(diǎn)擊按鈕提交表單可以獲取 formId，用于發(fā)送模板消息。或者當(dāng)用戶完成 支付行為，可以獲取 prepay_id 用于發(fā)送模板消息。

步驟三：調(diào)用接口下發(fā)模板消息

小程序

詳見 sendTemplateMessage

小游戲

在小游戲里，由于沒有類似小程序的表單組件，因此采用一套新方案來實(shí)現(xiàn)類似模板消息能力。

1. 在開發(fā)者管理端，配置回調(diào)地址（填寫的URL需要正確響應(yīng)QQ發(fā)送的Token驗(yàn)證，填寫說明請閱讀 消息推送服務(wù)器配置指南）

1. 當(dāng)有用戶使用QQ小游戲時，小游戲服務(wù)后臺可接收1次QQ服務(wù)器通知的formid。同個appid下，單個用戶7天內(nèi)最多觸發(fā)1個formid。

1. 通過formid，調(diào)用sendTemplateMessage驗(yàn)證模板消息可以成功下發(fā)后，再進(jìn)行全量推廣。

下發(fā)條件說明

1. 支付 當(dāng)用戶在小程序內(nèi)完成過支付行為，可允許開發(fā)者向用戶在7天內(nèi)推送有限條數(shù)的模板消息（1次支付可下發(fā)1條，多次支付下發(fā)條數(shù)獨(dú)立，互相不影響）
2. 提交表單 當(dāng)用戶在小程序內(nèi)發(fā)生過提交表單行為且該表單聲明為要發(fā)模板消息的，開發(fā)者需要向用戶提供服務(wù)時，可允許開發(fā)者向用戶在7天內(nèi)推送有限條數(shù)的模板消息（1次提交表單可下發(fā)1條，多次提交下發(fā)條數(shù)獨(dú)立，相互不影響）

審核說明

1. 標(biāo)題 標(biāo)題不能存在相同 標(biāo)題意思不能存在過度相似 標(biāo)題必須以“提醒”或“通知”結(jié)尾 標(biāo)題不能帶特殊符號、個性化字詞等沒有行業(yè)通用性的內(nèi)容 標(biāo)題必須能體現(xiàn)具體服務(wù)場景 標(biāo)題不能涉及營銷相關(guān)內(nèi)容，包括不限于：消費(fèi)優(yōu)惠類、購物返利類、商品更新類、優(yōu)惠券類、代金券類、紅包類、會員卡類、積分類、活動類等營銷傾向通知
2. 關(guān)鍵詞 同一標(biāo)題下，關(guān)鍵詞不能存在相同 同一標(biāo)題下，關(guān)鍵詞不能存在過度相似 關(guān)鍵詞不能帶特殊符號、個性化字詞等沒有行業(yè)通用性的內(nèi)容 關(guān)鍵詞內(nèi)容示例必須與關(guān)鍵詞對應(yīng)匹配 關(guān)鍵詞不能太過寬泛，需要具有限制性，例如：“內(nèi)容”這個就太寬泛，不能審核通過
3. 違規(guī)說明 除不能違反運(yùn)營規(guī)范外，還不能違反以下規(guī)則，包括但不限于： 不允許惡意誘導(dǎo)用戶進(jìn)行觸發(fā)操作，以達(dá)到可向用戶下發(fā)模板目的 不允許惡意騷擾，下發(fā)對用戶造成騷擾的模板 不允許惡意營銷，下發(fā)營銷目的模板
4. 處罰說明 根據(jù)違規(guī)情況給予相應(yīng)梯度的處罰，一般處罰規(guī)則如下： 第一次違規(guī)，刪除違規(guī)模板以示警告， 第二次違規(guī)，封禁接口7天， 第三次違規(guī)，封禁接口30天， 第四次違規(guī)，永久封禁接口 處罰結(jié)果及原因以站內(nèi)信形式告知

溫馨提示

1. 用戶分層 我們建議小程序/小游戲在發(fā)送通知時進(jìn)行用戶分層，針對不同的用戶群體推送不同內(nèi)容的信息，如對流失用戶推出回流禮包，對新注冊用戶推出新手禮包，對老用戶進(jìn)行版本和活動通知等。
2. 推送內(nèi)容建議 為優(yōu)化用戶體驗(yàn)，推送文案可以設(shè)計(jì)得詼諧有趣。

優(yōu)秀案例——《歡樂水杯》

1. 推送策略 （1）體力召回 推送時間：用戶體力滿時 面向用戶：新用戶 （2）版本更新、福利發(fā)放等 推送時間：晚上6點(diǎn)（經(jīng)測試，該時間推送效果最好） 面向用戶：新用戶

1. 推送時間 游戲測試了早上9點(diǎn)、中午12點(diǎn)、晚上6點(diǎn)三個推送時間段，發(fā)現(xiàn)晚上6點(diǎn)推送效果最好。

1. 數(shù)據(jù)表現(xiàn) 游戲?qū)⑿掠脩舴譃閮山M：一組在用戶登錄當(dāng)天發(fā)送模板消息，另一組不發(fā)送。經(jīng)試驗(yàn)，接收到模板消息的新用戶比未接收到的新用戶次留高2%。

1. 文案示例 （1）內(nèi)容更新：水杯更新貓貓皮膚啦！多款萌貓水杯等你來擼！ （2）玩法提示：只要墨水夠，畫線可以分開畫噢！ （3）福利預(yù)告: 貓咪老師杯會在第143關(guān)出現(xiàn)噢！ （4）關(guān)卡預(yù)告：第173關(guān)有不用提示就過關(guān)的高手嗎？

訂閱消息

功能介紹

1. 功能簡介：開發(fā)者在小游戲/小程序內(nèi)向用戶發(fā)起訂閱小游戲/小程序消息的授權(quán)彈窗，用戶點(diǎn)擊“允許”后，小游戲/小程序開發(fā)者每天可以給用戶發(fā)送一條訂閱消息。
2. 價值：與模板消息不同，訂閱消息一旦開通長期有效。開發(fā)商可以通過該能力實(shí)現(xiàn)老用戶召回、活動通知等能力，進(jìn)行長線的用戶關(guān)系維護(hù)，從而提高用戶活躍和留存。
3. 訂閱消息下發(fā)條件：用戶自主訂閱。訂閱后，一位用戶1天內(nèi)最多收到1次訂閱消息。
4. 數(shù)據(jù)統(tǒng)計(jì)：可通過場景值 = 2085，計(jì)算訂閱消息來源用戶數(shù)據(jù)。 （備注：授權(quán)文案不可修改，授權(quán)時機(jī)可自行決定）

使用說明

步驟一：獲取模板 ID

在開發(fā)者管理端，手動配置獲取模板 ID：

步驟二：引導(dǎo)用戶授權(quán)下發(fā)訂閱消息

向用戶發(fā)起主動訂閱小程序授權(quán)請求。調(diào)用后會立刻彈窗詢問用戶是否同意主動訂閱小程序。

如果用戶之前已經(jīng)同意授權(quán)，則不會出現(xiàn)彈窗，直接返回成功。（授權(quán)體系詳見相關(guān)文檔）

1. 小程序端授權(quán)接口
2. 小游戲端授權(quán)接口

步驟三：調(diào)用消息下發(fā)接口

1. 小程序端消息訂閱接口
2. 小游戲端消息訂閱接口

審核說明

1. 標(biāo)題 標(biāo)題意思不能存在過度相似 標(biāo)題不能帶特殊符號、個性化字詞等沒有行業(yè)通用性的內(nèi)容 標(biāo)題必須能體現(xiàn)具體服務(wù)場景 標(biāo)題不能涉及營銷相關(guān)內(nèi)容，包括不限于：消費(fèi)優(yōu)惠類、購物返利類、商品更新類、優(yōu)惠券類、代金券類、紅包類、會員卡類、積分類、活動類等營銷傾向通知
2. 關(guān)鍵詞 同一標(biāo)題下，關(guān)鍵詞不能存在相同 同一標(biāo)題下，關(guān)鍵詞不能存在過度相似 關(guān)鍵詞不能帶特殊符號、個性化字詞等沒有行業(yè)通用性的內(nèi)容 關(guān)鍵詞內(nèi)容示例必須與關(guān)鍵詞對應(yīng)匹配 關(guān)鍵詞不能太過寬泛，需要具有限制性，例如：“內(nèi)容”這個就太寬泛，不能審核通過
3. 違規(guī)說明 除不能違反運(yùn)營規(guī)范外，還不能違反以下規(guī)則，包括但不限于： 不允許惡意誘導(dǎo)用戶進(jìn)行觸發(fā)操作，以達(dá)到可向用戶下發(fā)模板目的 不允許惡意騷擾，下發(fā)對用戶造成騷擾的模板 不允許惡意營銷，下發(fā)營銷目的模板
4. 處罰說明 根據(jù)違規(guī)情況給予相應(yīng)梯度的處罰，一般處罰規(guī)則如下： 第一次違規(guī)，刪除違規(guī)模板以示警告， 第二次違規(guī)，封禁接口7天， 第三次違規(guī)，封禁接口30天， 第四次違規(guī)，永久封禁接口 處罰結(jié)果及原因以站內(nèi)信形式告知

溫馨提示

1. 用戶主動訂閱路徑 第一次進(jìn)入小游戲/小程序時若選擇“暫不接受”訂閱消息，后續(xù)仍可通過“浮點(diǎn)-關(guān)于-設(shè)置-小程序訂閱消息“開啟該功能。
2. 增加“訂閱”圖標(biāo) 為了提升該能力的利用率，開發(fā)商可以在小游戲/小程序界面中添加”訂閱“的圖標(biāo)，并且為訂閱的用戶提供一定的小游戲/小程序獎勵，激勵用戶主動添加該功能。（下圖為《一起打桌球》游戲界面）
3. 用戶分層 我們建議小游戲/小程序在發(fā)送通知時進(jìn)行用戶分層，針對不同的用戶群體推送不同內(nèi)容的信息，如對流失用戶推出回流禮包，對新注冊用戶推出新手禮包，對老用戶進(jìn)行版本和活動通知等。
4. 推送內(nèi)容建議 為提升用戶體驗(yàn)，推送文案可以設(shè)計(jì)得詼諧有趣。