注册推送活动
您可以创建一个活动以发送实际的推送消息。点击列表中的 注册活动 按钮并进入相应的页面。活动派发所需的元素应按顺序从顶部注册,由于需要的信息较多,我们提供了便利功能,例如加载预先输入的文本。
您可以通过点击右侧的[顶部]按钮返回页面顶部。如果您尝试在未填写必填字段的情况下保存,页面将自动滚动到该空字段。
活動標題¶
輸入活動標題。您可以輸入最多50個字符的韓文。
如果您有預先註冊的標題模板,可以通過單擊右側的加載標題模板按鈕來導入文本。
要將您剛剛輸入的標題文本保存為標題模板,請按“保存為標題模板”按鈕。
應用程式(遊戲)¶
選擇您要發送活動的應用程式(遊戲)。一個活動只能向一個應用程式(遊戲)發送消息。搜索並選擇一個應用程式(遊戲)標題,以查看所有已註冊該遊戲標題的應用程式列表。您可以同時選擇 Android 和 iOS 應用程式,或者您可以選擇一個或多個應用程式。
如果您想仅向所选应用的特定版本发送活动,请点击应用信息右侧的版本按钮。默认情况下,活动将发送到应用的所有版本,因此如果您不想指定版本,则无需进行任何调整。
當你點擊版本按鈕時,選擇版本的區域會向下展開,你可以輸入所需的版本。你必須直接輸入所需版本的文本,因此請提前檢查你想要發送的版本信息。
交付目標¶
選擇送貨類型。
如果您選擇捆綁包,將會為該應用的所有標記發送活動。
如果您選擇目標設定,您可以通過選擇預先註冊的目標數據來發送目標推送。您需要在推送 > 註冊目標數據菜單中單獨註冊目標數據。如果您有預先提取的目標數據,您可以在註冊目標數據菜單中註冊該數據並輸入活動詳細信息。如果您根據註冊日期搜索目標數據,則會顯示在註冊目標數據菜單中註冊的數據。找到並選擇您想要使用的目標數據。
如果您通过前往分析 v2> 段> 注册目标活动菜单进行注册,则交付类型固定为目标,并且在该段中生成的目标数据会自动注册。在这种情况下,目标信息无法修改。
交付地點¶
選擇配送地點。點擊 ['+'] 或 ['-'] 來選擇全部或取消所有下級類別。
您可以同时按服务器/国家/时区发送活动。
當按國家/時區發送時,請點擊您希望發送的洲名以展開下面的各個國家列表。
伺服器資訊會自動顯示該應用程式(遊戲)中的伺服器列表。如果您選擇特定的伺服器並指定國家/時區,則如果在所選伺服器內沒有與該國家/時區匹配的用戶資訊,則可能無法發送消息。換句話說,如果您選擇“韓國”伺服器並將國家指定為“美洲 > 美國”,則可能沒有目標。相反,如果您希望向“美國”伺服器內的“亞洲/南韓”用戶發送推送消息,您可以通過上述方式發送消息,而無需單獨的目標設定。請指定適合交付和目標目的的地點值。
Note
要使用服务器的交付功能,您必须在实际应用中发送服务器 ID 和令牌,以便向相应服务器中的用户发送推送。Hive SDK 已经提供了与服务器信息相关的 API。在使用该功能之前,您需要检查您想要使用该功能的游戏是否提供服务器信息。请参考配置指南,以检查游戏是否正在传输服务器信息或查看如何传输信息。指南中“ Hive 设置文件(hive_config.xml)”类别中的“ServerId”设置是必需的。
送貨預約¶
指定您希望發送活動的時間。
請先選擇是否重複。如果您選擇重複,您可以將重複間隔設置為“每日”或“每週”,並且還可以選擇重複的日期間隔。如果您選擇“每週”並選擇所有7天,則活動將每天發送,就像您選擇了“每日”一樣。如果您想重複活動但不想在特定日期發送活動,您可以在“跳過日期”字段中選擇所需的日期並添加它。
選擇日期、是否使用捆綁配送以及時間。時間基於韓國標準時間(UTC +9)。使用捆綁配送時,活動會根據輸入的時間(KST)一次性發送,而不考慮目的地的當地時間。在這種情況下,您可以使用“%hh:mm%”轉換代碼來輸入消息。
如果不使用捆绑交付,交付将根据目的地的时区考虑当地时间。也就是说,您输入下午3点,活动将根据当地时间在下午3点按顺序发送。%hh:mm% 转换代码无法使用。
Note
中間的世界時間計算器是一個簡單的便利功能,不會影響投遞功能。當你想知道時差時,可以在這裡計算時差並在上方輸入信息。計算時差不會影響活動註冊選項或投遞。
如果您想要分散投遞,您可以按時間發送指定數量的投遞。如果您設置每分鐘發送10,000個案例,則在指定時間將首先發送10,000個案例,然後每分鐘向其餘目標發送10,000個案例。如果目標過多且單位較小,最後一個人收到活動的時間可能會很長。發送的案例數量或時間單位沒有限制。請僅在不希望所有收件人同時接收推送消息的情況下使用此功能。
訊息¶
輸入要發送的活動內容。每個輸入表單的詳細功能如下。(由於iOS的功能與Android相同,而iOS的格式較簡單,因此本指南是基於Android編寫的。)
如標題所示,如果您有預先註冊的消息模板,您可以通過單擊右側的加載消息模板按鈕一次加載文本。您還可以將剛剛輸入的消息文本直接保存為模板。
或者,您可以上傳已預先註冊的文件以註冊該消息。請點擊表單下載按鈕以下載表單並提前輸入消息。
第一次下載模板時,內容將是空的,模板僅包含標題。請按照上面的範例填寫所需的欄位。最右邊的“isDefault”欄位表示應指定哪種語言為預設值,您只需在其中一種語言中輸入 Y。
Warning
如果您在isDefault列中输入多个Y,则默认语言将根据最后输入的Y进行设置。这可能会导致您将意外的语言设置为默认语言,因此请小心不要输入多个Y。
消息支持總共16種語言。五種主要語言,如韓語、中文、中文、英語和日語,默認展開,其他11種語言可以通過點擊“顯示其他語言”按鈕展開。
韓文(ko) | 簡體中文(zh-hans) | 繁體中文(zh-hant) | 英文(en) | 日文(ja) | - |
阿拉伯語(ar) | 法語(fr) | 德語(de) | 西班牙語(es) | 葡萄牙語(pt) | 泰語(th) |
意大利語(it) | 俄語(ru) | 印尼語(id) | 越南語(vi) | 土耳其語(tr) |
當您輸入多種語言時,如果包含了默認語言以外的語言,則只要與伺服器中接收者令牌中儲存的語言值匹配,就會發送推送。如果您沒有輸入與接收者令牌中儲存的語言值匹配的語言,則將發送在默認欄位中輸入的消息。因此,默認值是必需的。換句話說,如果您希望無論地區如何都以英語全球發送推送,只需在默認欄位中輸入英語文本,並將其餘語言留空。請注意,輸入在英語欄位中的文本只能被語言值設置為英語的用戶接收。
Note
儲存語言值於標記中的標準如下。首先,如果遊戲語言是透過SDK單獨傳送並且可以儲存,則儲存遊戲的語言值。(最高優先權,遊戲語言) 如果遊戲沒有單獨將遊戲語言發送到SDK,則導入設備的語言值並將其儲存到標記中。(第二優先權,設備語言)
例如,如果您想向所有用户发送英文推送,除了韩国用户,您可以将英文添加到默认字段,并将韩文文本添加到韩文字段。
如果您同時選擇 Android 和 iOS 應用程序,您可以一次輸入要發送的消息。發送推送消息到 Android 和 iOS 應用程序所需的格式不同,因此請檢查您想要發送的推送消息格式。對於 Android 和 iOS,您必須填寫標題和短消息(消息)字段。
對於媒體,您只能為 Android 發送一個 JPG/ JPEG/ PNG/ GIF 文件(僅限圖像,最大 10MB)。對於 iOS,您不僅可以發送圖像,還可以為 iOS 10 或更高版本的設備發送音頻和視頻文件。請參考以下有關在 iOS 上傳輸媒體的資訊。
Warning
然而,您不能直接从推送后台上传媒体文件。您必须将文件上传到单独的位置并注册链接 URL。
此外,出于安全原因,仅可以使用 HTTPS 协议的地址。(https://...格式)預覽¶
當您完成輸入消息後,可以在預覽區域檢查消息在實際設備上的顯示方式。左側的圖像是 Android 的預覽,右側的圖像是 iOS 的預覽。您可以通過點擊設備頂部的顏色選擇器按鈕來更改推送通知 UI 的背景顏色。如果您已應用字體顏色,可以使用此功能提前檢查在特定背景顏色上是否能清楚看到文本。
您也可以预览附加的媒体。您可以再次检查是否插入了无效的媒体。
Warning
通知界面因設備而異,並非所有通知在各設備上看起來都相同。請將其用作參考,例如換行、字體顏色,以及媒體是否正確插入。此外,如果您需要在推送消息中包含 <,> 符號(而不是 HTML 標籤),請將 < 更改為 <,將 > 更改為 >。
此外,臨時授權 將在安裝了 Hive SDK v4.11.4 或更高版本的 iOS 12 及以上設備上自動應用,因此,根據用戶的設備設置,通知可能不會立即顯示。選項¶
選擇與交付相關的選項。所有選項都是可選的。僅在有必要的功能時應用。
指定通知聲音¶
設置用戶收到推送通知時聽到的通知聲音。請輸入遊戲客戶端中包含的資源名稱。
指定推送圖示¶
您可以更改在用戶收到推送通知時顯示在屏幕上的圖標。
當禁用時,應用程式圖示將預設顯示為左側的圖像。不過,您可以使用該功能指定右側圖像作為圖示。
要啟用此功能,請輸入遊戲客戶端中包含的資源名稱或輸入圖片網頁網址。
震動¶
您可以設定當用戶接收到推播通知時,設備是否震動。
覆蓋¶
選擇是否在用戶收到推送通知時使用覆蓋功能。指定從 1 到 99 的代碼值之一會自動啟用覆蓋功能。
覆蓋功能是一種根據推送代碼覆蓋任何先前推送的新推送的功能,無論用戶是否檢查過推送內容。如果用戶尚未檢查之前發送的消息,您將發送一個新的推送,覆蓋之前的推送消息,而不會向用戶的設備添加新的通知。此功能的主要目的是防止向用戶發送垃圾推送通知,並增加用戶實際閱讀的推送消息數量。然而,它也可以用於不希望用戶閱讀早期推送消息的情況,特別是那些在一天內過期的每日推送消息。
以下是如何使用覆盖功能:如果您在前一天的活动中使用代码编号“1”发送了“游戏A”的推送,则应在接下来的活动中以相同的条件(使用代码编号“1”发送“游戏A”)发送推送。通过这种方式,覆盖功能将被启用,新推送将覆盖前一天发送的推送。(但是,覆盖功能仅在用户尚未阅读推送的情况下有效。用户已经阅读的推送与覆盖功能无关。)
輸入評論,例如使用覆蓋功能的目的和必要時的評論,因為您可以使用評論來搜索已使用覆蓋功能的推送消息。輸入評論不是強制性的。
用戶參與¶
您可以設定是否使用用戶參與。
用戶參與是Hive SDK v1.10及以上版本中支持的一項功能,以支持推送中的深層鏈接。
您可以在通过短信(SMS)或推送通知发送的消息中插入链接,以便用户可以访问并到达游戏中的特定位置。您还可以在深层链接中插入优惠券值并发送,以便用户在点击时可以直接从游戏的收件箱中领取奖励。
要使用遊戲內的深層連結,只需輸入遊戲名稱/APPID/發佈的下載網址/目標位置以創建連結,然後將生成的網址插入推送中。
Note
要使用用戶參與功能,必須提前準備以下內容:
1. 需要應用Hive SDK v1.10或更高版本。 不支持單獨的模塊。
2. 必須註冊Schema URL。 請檢查每個遊戲客戶端是否註冊了該方案,以便訪問相應的遊戲。
3. 需要自動分支的遊戲下載URL。 要在後台創建深度鏈接,必須發出可以根據操作系統自動分支的遊戲下載URL。
方案選項值如下。
未使用 是在您不使用此功能时选择的值。如果您想启用用户参与功能,请选择 UE。
如果您在之前的下拉框中选择了UE,则会显示上述内容。如果您选择“游戏”,您将能够根据游戏中指定的格式输入内容。这是一个设置,让您能够访问游戏的内部功能,并且您需要一个预定义的路径值。请联系相应的游戏团队以获取路径值。如果您选择“ Hive”,您将能够根据Hive中预定义的格式输入内容。选择后,第二个下拉框将被启用,允许您选择一个预设值。
可用的路徑列表按方案選項的詳細列表如下。
對於 Hive 內的地址<
AppID://hive/authlogin | 轉到 Hive 登入頁面。如果以訪客身份登入,將轉到官方登入頁面。如果通過官方 Hive 帳戶登入,將自動登入而不顯示頁面。 |
AppID://hive/socalinquery | 轉到 1:1 查詢頁面。 |
AppID://hive/socialmyinquiry | 只有以 Hive 會員身份登入的用戶才能進入我的查詢。 |
AppID://hive/promotionshow?type={number} | 轉到自定義視圖頁面,該頁面對應於作為類型值輸入的值。 |
AppID://hive/offerwallsh | 轉到 Offerwall 頁面。(僅限 Android) |
AppID://hive/promotioncoupon?couponid={couponid} | 消耗輸入的 Couponid 代碼的優惠券。結果將作為回調發送到 C2SModuleApi_EngagementConsumeCoupon。 |
AppID://hive/socialmessage?uid={uid}&text={message} | 在 uid 欄位中輸入用戶 uid 資訊,在消息欄位中輸入詳細信息,以檢查 Hive 消息中的詳細信息。 |
AppID://hive/socialinvitation?uid={uid} | 在 uid 欄位中輸入用戶 uid 資訊,邀請消息將發送給相應的用戶。 |
遊戲內的地址
AppID://game/{path}?{query} | 用於轉到遊戲內部功能的架構。輸入遊戲中定義的路徑值。(聯繫遊戲團隊以獲取路徑值) “C2SModuleApi_EngagementProcessScheme” 回調將會發生。如果此回調發生,您必須檢查傳遞的事件日期並執行相應的操作。 |
時間敏感¶
僅適用於 iOS 15 或更高版本。如果用戶將應用程序設置為“允許時間敏感”,則可以接收通知。不支持帶廣告的批量推送通知。但是,請僅將其用於“時間敏感通知”。
例如) 需要立即確認的帳戶安全通知、必須在特定時間內接收的產品等。
Note
要使用時間敏感通知功能,必須準備以下條件。
1. 對於操作系統,僅適用於 iOS,且操作系統必須為 iOS 15 或更高版本。
2. 應用的 SDK 必須為 SDK 1.19.4 或更高版本以及 SDK 4.15.4 或更高版本。
3. iOS 15 或更高版本 > 設定 > 通知 > 選擇應用 > 必須開啟時間敏感通知切換。
4. iOS 15 或更高版本 > 設定 > 專注模式 > 選擇應用 > 必須開啟時間敏感通知切換。
5. 但是,即使專注模式的時間敏感通知切換未開啟,如果在通知中開啟了時間敏感通知切換,仍然會收到通知。
6. 如果操作系統低於 iOS 15 或未滿足上述條件,推送通知將會收到,但會顯示為通知摘要。
7. 只有在註冊活動時選擇“目標推送”時,UI 才會顯示。
參考 iOS 15 或更高版本的操作系統設定流程
選擇“使用”當您想要使用時間敏感通知功能時。時間敏感通知的選項值如下。
注意¶
什麼是 iOS 通知服務擴展?¶
這是一個利用 iOS 10 中新增的 UserNotiTcations.framework 功能的特性。它允許您將媒體(圖片、音頻、視頻)添加到推送通知區域並進行轉移。
該功能可在安裝了 Xcode 8.0 或更高版本的設備上使用,或在運行 iOS 10 或更高版本的設備上使用。在版本低於這些的設備上,即使您使用此功能,使用者仍將收到與之前相同的推送。
允許的媒體類型和容量如下:
類別 | 類型 | 最大限制 |
音頻 | WAV, MP3, MP4(音頻) | 5MB |
圖片 | JPG, JPEG, PNG, GIF | 10MB |
視頻 | MP4, AVI | 50MB |
什麼是 iOS 臨時授權?¶
這是一個針對 iOS 12 及以上版本的新推播通知接收功能。
在應用此功能的操作系統版本上,推播通知在接收時不會立即顯示。相反,用戶必須從上方的 iOS 通知中心向下滑動以查看推播通知。以這種方式接收的所有通知將詢問用戶是否希望默認以相同的方式繼續接收通知。
用戶可以通過點擊“保留”按鈕來指定他或她希望如何接收應用程序的通知。如果用戶覺得應用程序的通知有用,他或她可以點擊“顯著傳送”以正常方式接收通知。否則,他或她可以點擊“繼續靜默傳送”以繼續靜默接收通知。
使用者可以點擊“‘關閉…”以移動到一個可以關閉相應應用程式通知的螢幕。