แดชบอร์ด
แดชบอร์ด Push ให้มุมมองเดียวเกี่ยวกับรายละเอียด สถานะการจัดส่ง และสถิติของแคมเปญที่ลงทะเบียนทั้งหมด
ค้นหา¶
คุณสามารถค้นหาสถานะและสถิติของแคมเปญที่ส่งสำหรับเกมที่ผู้ใช้ที่เชื่อมต่ออยู่มีอำนาจควบคุม
เลือกวันที่ตามตารางการจัดส่ง (ที่จองไว้) จากนั้นเลือกแอปและแคมเปญ ตารางการจัดส่งจะถูกตั้งค่าเป็นวันที่ปัจจุบันโดยอัตโนมัติ ข้อมูลทั้งหมดจะแสดงตามหน่วยรายวัน อย่างไรก็ตาม คุณยังสามารถดูกราฟแนวโน้มของช่วงเวลาที่ทำซ้ำได้โดยรวม ประเทศ และเซิร์ฟเวอร์ในช่วงข้อมูลรายละเอียดแคมเปญที่เกี่ยวข้องสำหรับแคมเปญที่ทำซ้ำเท่านั้น
Note
คุณสามารถค้นหาข้อมูลย้อนหลังได้สูงสุดหนึ่งปี
สถานะเกม¶
คุณสามารถตรวจสอบกราฟข้อมูลทั้งหมด จำนวนโทเค็น การจัดส่ง การเปิดและแคมเปญที่ลงทะเบียนในวันเฉพาะของเกมที่เกี่ยวข้อง
Note
จำนวนการเปิดหมายถึงจำนวนการเปิดสำหรับวันนั้น โปรดทราบว่าจำนวนการเปิดสำหรับแคมเปญที่ส่งในวันนั้นไม่ได้ถูกนับเพียงอย่างเดียว แต่จำนวนที่ส่งก่อนหน้านี้ก็สามารถถูกนับได้เช่นกัน ตัวอย่างเช่น หากผู้ใช้เปิดการแจ้งเตือนที่ส่งไปยังผู้ใช้เมื่อวานนี้ จำนวนการเปิดสำหรับการแจ้งเตือนนี้จะถูกนับเป็นของวันนี้ ดังนั้น อาจมีความไม่ตรงกันจากผลรวมของจำนวนการเปิดแคมเปญในวันนั้น ตัวเลขอื่น ๆ ยกเว้นจำนวนการเปิด (จำนวนโทเค็น เป็นต้น) ทั้งหมดหมายถึงการนับในวันนั้น (อย่างไรก็ตาม การนับกรณีการเปิดจะถูกยกเว้นสำหรับ Facebook)
แผนที่ด้านบนแสดงให้คุณเห็นจำนวนการจัดส่ง (ทั่วโลก) ในวันเฉพาะ ส่วนที่มีสีคือที่ที่มีการจัดส่งมาก หากคุณวางเคอร์เซอร์ไว้เหนือ คุณสามารถดูข้อมูลรายละเอียดผ่านเครื่องมือช่วยอธิบาย
กราฟด้านบนแสดงให้คุณเห็นการเปลี่ยนแปลงในจำนวนโทเค็นในวันเฉพาะ กราฟจะถูกรีเฟรชทุกชั่วโมงแบบเรียลไทม์และคุณสามารถคาดการณ์จำนวนการจัดส่งตามจำนวนโทเค็นที่สะสมโดยเฉพาะเมื่อคุณต้องส่งจำนวนมาก
ข้อมูลแคมเปญ¶
หลังจากเลือกเกมและวันที่ด้านบนแล้ว ให้คลิกค้นหาเพื่อแสดงผลลัพธ์ คุณสามารถคลิกที่แคมเปญเฉพาะเพื่อดูข้อมูลรายละเอียดของมัน
คลิกที่ปุ่มดาวน์โหลดมุมขวาบนเพื่อดาวน์โหลดข้อมูลเป็นไฟล์ Excel ในรูปแบบแผนภูมิ
แสดงจำนวนการจัดส่งทั้งหมด, กรณีที่สำเร็จ, กรณีที่เปิดอยู่, และกรณีที่ล้มเหลวของแคมเปญที่เลือกในวันนั้น.
หากแคมเปญที่เลือกเป็นแคมเปญเดียวที่ส่งเพียงวันเดียว มันจะแสดงเป็นกราฟ “จุด” เมื่อคุณคลิกที่ พื้นที่กราฟ คุณจะเห็นกราฟของอัตราความสำเร็จ/ความล้มเหลวของกรณีและเหตุผลของความล้มเหลวในวันนั้นเกี่ยวกับแคมเปญเดียว
หากแคมเปญที่เลือกเป็นแคมเปญที่เกิดซ้ำซึ่งส่งในหลายวัน จะถูกแสดงเป็นกราฟ “เส้น” สำหรับแคมเปญที่เกิดซ้ำ คุณสามารถดูแนวโน้มข้อมูลของช่วงเวลาทั้งหมดที่เกิดซ้ำ รวมถึงวันที่เฉพาะที่ด้านบน วันที่ที่เลือกที่ด้านบนจะเป็นวันที่มาตรฐานและสัปดาห์ที่มีวันที่เลือกจากช่วงเวลาการส่งทั้งหมด (ค่าดีฟอลต์) จะถูกแสดงในพื้นที่นี้ คลิกที่วันที่เฉพาะในพื้นที่กราฟ เพื่อดูรายละเอียด เช่น อัตราความสำเร็จ/ความล้มเหลวของวันที่นั้นและกราฟเหตุผลของความล้มเหลวที่ด้านล่าง หากเป็นแคมเปญที่ดำเนินการมานานกว่าหนึ่งสัปดาห์ คุณสามารถคลิกที่ปุ่ม [สัปดาห์ก่อนหน้า] หรือ [สัปดาห์ถัดไป] ที่ด้านขวาของพื้นที่ชื่อเรื่องเพื่อดูผลลัพธ์ตามสัปดาห์
สำหรับจำนวนรวมของการจัดส่งในวันของแคมเปญที่เลือก ผลลัพธ์จะแสดงกราฟวงกลมของอัตราความสำเร็จและความล้มเหลว (ซ้าย)
กราฟทางด้านขวาแสดงเหตุผลสำหรับความล้มเหลวที่ละเอียดและอัตราส่วนสำหรับจำนวนความล้มเหลวทั้งหมดของวัน ใน Google (FCM) และ Apple (APNS) หากมีความล้มเหลวเกี่ยวกับการแจ้งเตือนแบบพุชที่ร้องขอ มันจะคืนรหัสข้อผิดพลาดเพื่อให้คุณสามารถหาสาเหตุที่ทำให้เกิดความล้มเหลวได้ Google (FCM) ให้การตอบสนองทั้งหมด 16 รายการ และ Apple (APNS) ให้การตอบสนอง 28 รายการต่อข้อผิดพลาด การแจ้งเตือนแบบพุชให้เหตุผลสำหรับความล้มเหลวแก่ผู้ใช้เพื่อให้ผู้ใช้สามารถทราบเกี่ยวกับข้อผิดพลาดที่ไม่ใช่ปัญหาระบบ ภาพรวมของรหัสข้อผิดพลาดที่ล้มเหลวแต่ละรายการแสดงด้านล่าง
FCM(Google)¶
ข้อผิดพลาด | คำอธิบาย | อื่นๆ |
---|---|---|
MissingRegistration | ตรวจสอบให้แน่ใจว่าคำขอมีโทเค็นการลงทะเบียน (ใน registration_id ในข้อความธรรมดาหรือในฟิลด์ to หรือ registration_ids ใน JSON). | เกิดขึ้นเมื่อมีการละเว้นโทเค็นใน Payloads ที่ส่งไปยังบริการ FCM |
InvalidRegistration | ตรวจสอบรูปแบบของโทเค็นการลงทะเบียนที่คุณส่งไปยังเซิร์ฟเวอร์ ให้แน่ใจว่ามันตรงกับโทเค็นการลงทะเบียนที่แอปไคลเอนต์ได้รับจากการลงทะเบียนกับ Firebase Notifications อย่าตัดทอนหรือเพิ่มอักขระเพิ่มเติม | เกิดขึ้นเมื่อโทเค็นไม่ถูกต้อง |
NotRegistered | โทเค็นการลงทะเบียนที่มีอยู่สามารถหยุดใช้งานได้ในหลายสถานการณ์ รวมถึง: หากแอปไคลเอนต์ยกเลิกการลงทะเบียนกับ FCM หากแอปไคลเอนต์ถูกยกเลิกการลงทะเบียนโดยอัตโนมัติ ซึ่งอาจเกิดขึ้นได้หากผู้ใช้ลบแอปพลิเคชัน ตัวอย่างเช่น บน iOS หากบริการฟีดแบ็ก APNS รายงานว่าโทเค็น APNS ไม่ถูกต้อง หากโทเค็นการลงทะเบียนหมดอายุ (ตัวอย่างเช่น Google อาจตัดสินใจที่จะรีเฟรชโทเค็นการลงทะเบียน หรือโทเค็น APNS หมดอายุสำหรับอุปกรณ์ iOS) หากแอปไคลเอนต์ได้รับการอัปเดต แต่เวอร์ชันใหม่ไม่ได้กำหนดค่าให้รับข้อความ สำหรับกรณีทั้งหมดนี้ ให้ลบโทเค็นการลงทะเบียนนี้ออกจากเซิร์ฟเวอร์แอปและหยุดใช้งานในการส่งข้อความ | เกิดขึ้นหากแอปถูกลบ |
InvalidPackageName | โปรดตรวจสอบว่า ข้อความถูกส่งไปยังโทเค็นการลงทะเบียนที่มีชื่อแพ็กเกจตรงกับค่าที่ส่งในคำขอ | เกิดขึ้นเมื่อแอปที่ขอส่งการแจ้งเตือนจากเซิร์ฟเวอร์และแอปโทเค็นไม่ตรงกัน |
MismatchSenderId | โทเค็นการลงทะเบียนถูกผูกติดกับกลุ่มผู้ส่งที่แน่นอน เมื่อแอปไคลเอนต์ลงทะเบียนสำหรับ FCM, มันต้องระบุว่าผู้ส่งใดบ้างที่ได้รับอนุญาตให้ส่งข้อความ คุณควรใช้หนึ่งใน ID ผู้ส่งเหล่านั้นเมื่อส่งข้อความไปยังแอปไคลเอนต์ หากคุณเปลี่ยนไปใช้ผู้ส่งที่แตกต่างกัน โทเค็นการลงทะเบียนที่มีอยู่จะไม่ทำงาน | เกิดขึ้นเมื่อ ID ผู้ส่งที่ขอส่งการแจ้งเตือนจากเซิร์ฟเวอร์และ ID ผู้ส่งที่ใช้สร้างโทเค็นไม่ตรงกัน |
InvalidParameters | ตรวจสอบว่าพารามิเตอร์ที่ให้มีชื่อและประเภทที่ถูกต้อง | เกิดขึ้นเมื่อ Payloads ที่ส่งไปยังบริการ FCM ไม่ถูกต้อง |
MessageTooBig | ตรวจสอบให้แน่ใจว่าขนาดรวมของข้อมูล payload ที่รวมอยู่ในข้อความไม่เกินขีดจำกัดของ FCM: 4096 ไบต์สำหรับข้อความส่วนใหญ่ หรือ 2048 ไบต์ในกรณีของข้อความที่ส่งไปยังหัวข้อ นี่รวมถึงทั้งคีย์และค่า | เกิดขึ้นเมื่อขนาดของ Payloads ที่ส่งไปยังบริการ FCM เกิน 4K |
InvalidDataKey | ตรวจสอบว่าข้อมูลใน payload ไม่มีคีย์ (เช่น from, หรือ gcm, หรือค่าที่ขึ้นต้นด้วย google) ที่ใช้ภายในโดย FCM โปรดทราบว่าคำบางคำ (เช่น collapse_key) ก็ใช้โดย FCM แต่อนุญาตใน payload ในกรณีนี้ ค่าของ payload จะถูกแทนที่ด้วยค่าของ FCM | เกิดขึ้นเมื่อชื่อฟิลด์ของ Payloads ที่ส่งไปยังบริการ FCM ไม่ถูกต้อง |
ไม่สามารถใช้งานได้ | เซิร์ฟเวอร์ไม่สามารถประมวลผลคำขอได้ทันเวลา | ข้อผิดพลาดบริการ FCM |
InternalServerError | เซิร์ฟเวอร์พบข้อผิดพลาดขณะพยายามประมวลผลคำขอ. | ข้อผิดพลาดบริการ FCM |
APNS(Apple)¶
ข้อผิดพลาด | คำอธิบาย | อื่น ๆ |
---|---|---|
BadCollapsedId | รหัสการยุบเกินขนาดสูงสุดที่อนุญาต | เกิดขึ้นเมื่อรหัสการยุบสำหรับการเขียนทับเกินขนาดสูงสุดที่อนุญาต |
BadDeviceToken | โทเค็นอุปกรณ์ที่ระบุไม่ถูกต้อง ตรวจสอบให้แน่ใจว่าคำขอมีโทเค็นที่ถูกต้อง และว่าโทเค็นตรงกับสภาพแวดล้อม | เกิดขึ้นเมื่อโทเค็นการส่งข้อความไม่ถูกต้อง |
MissingDeviceToken | ไม่มีการระบุอุปกรณ์โทเค็นในคำขอ :path. ตรวจสอบให้แน่ใจว่า header :path มีอุปกรณ์โทเค็นอยู่ | เกิดขึ้นเมื่อมีการละเว้นโทเค็นใน Payloads ที่ส่งไปยังบริการ APNS |
PayloadEmpty | ข้อความ payload ว่างเปล่า | เกิดขึ้นเมื่อ Payloads ที่ส่งไปยังบริการ APNS ถูกละเว้น |
ใบรับรองไม่ถูกต้อง | ใบรับรองไม่ถูกต้อง. | ข้อผิดพลาดใบรับรองการผลักดัน |
BadCertificateEnvironment | ใบรับรองของไคลเอนต์ไม่ถูกต้องสำหรับสภาพแวดล้อมนี้。 | ข้อผิดพลาดใบรับรองแอป |
ไม่ได้ลงทะเบียน | โทเค็นอุปกรณ์ไม่มีการใช้งานสำหรับหัวข้อที่ระบุ | เกิดขึ้นหากแอปถูกลบ |
PayloadTooLarge | ข้อความ payload ใหญ่เกินไป | เกิดขึ้นเมื่อขนาดของ Payload ที่ส่งไปยังบริการ APNS เกิน 4K |
TooManyRequests | มีการร้องขอมากเกินไปที่ทำต่อเนื่องไปยังโทเค็นอุปกรณ์เดียวกัน | เกิดขึ้นเมื่อมีการร้องขอการส่งพุชมากเกินไปด้วยโทเค็นเดียวกัน |
InternalServerError | เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์ | ข้อผิดพลาดบริการ APNS |
บริการไม่พร้อมใช้งาน | บริการไม่พร้อมใช้งาน. | ข้อผิดพลาดบริการ APNS |
ปิดการทำงาน | เซิร์ฟเวอร์กำลังปิดการทำงาน. | ข้อผิดพลาดบริการ APNS |
ADM(Amazon)¶
ข้อผิดพลาด | คำอธิบาย | อื่นๆ |
---|---|---|
ไม่ได้ลงทะเบียน | แอปที่เชื่อมโยงกับรหัสการลงทะเบียนไม่สามารถรับข้อความได้อีกต่อไป | เกิดขึ้นเมื่อแอปถูกลบ |
InvalidRegistrationId | รหัสการลงทะเบียนไม่ตรงกับผู้ส่งที่ระบุโดยโทเค็นการเข้าถึงที่ให้มา | เกิดขึ้นเมื่อโทเค็นไม่ถูกต้อง |
ข้อมูลไม่ถูกต้อง | - | เกิดขึ้นเมื่อ Payload ที่ส่งไปยังบริการ ADM ไม่ถูกต้อง |
AccessTokenExpired | โทเค็นการเข้าถึงที่ให้มาไม่ถูกต้อง ผู้ส่งควรรีเฟรชโทเค็นการเข้าถึงของตน | การหมดอายุของโทเค็นที่ได้รับการรับรองจากเซิร์ฟเวอร์ |
MessageTooLarge | ข้อมูลที่ส่งในพารามิเตอร์ข้อมูลเกินขนาดข้อมูลสูงสุดที่อนุญาต (6 KB). | เกิดขึ้นเมื่อขนาดของ Payloads ที่ส่งไปยังบริการ ADM เกิน 6K |
MaxRateExceeded | ผู้ขอข้อมูลได้เกินอัตราสูงสุดที่อนุญาตในการส่งข้อความ ผู้ส่งอาจลองส่งใหม่ในภายหลังโดยเคารพหัวข้อ Retry-After ที่รวมอยู่ในคำตอบ เพื่อให้แน่ใจว่ามีความพร้อมใช้งานสูง ADM จึงจำกัดจำนวนข้อความที่สามารถส่งได้ในช่วงเวลาที่กำหนด | เกิดขึ้นเมื่อมีการขอการส่งพุชมากเกินไปในเวลาเดียวกัน |
InternalServerError | เกิดข้อผิดพลาดภายในเซิร์ฟเวอร์ | ส่งคืนรหัส HTTP 500 เนื่องจากข้อผิดพลาดของบริการ ADM |
ไม่สามารถใช้งานได้ | เซิร์ฟเวอร์ไม่สามารถใช้งานได้ชั่วคราว | ส่งคืนรหัส HTTP 500 เนื่องจากข้อผิดพลาดของบริการ ADM |
เฟซบุ๊ก¶
รหัสข้อผิดพลาด | ข้อความข้อผิดพลาด | อื่น ๆ |
---|---|---|
190 | ลายเซ็นโทเค็นการเข้าถึง OAuth ไม่ถูกต้อง | เกิดขึ้นเมื่อค่า app_secret และ app_id ที่ลงทะเบียนใน App Center ไม่ถูกต้อง |
100 | พารามิเตอร์เนื้อหาต้องมีความยาวอย่างน้อย 10 ตัวอักษร | การแจ้งเตือนที่เกิดขึ้นเมื่อข้อความเนื้อหามี 10 ตัวอักษรหรือน้อยกว่า |
พารามิเตอร์ชื่อจะต้องมีความยาวไม่เกิน 30 ตัวอักษร. | การแจ้งเตือนที่เกิดขึ้นเมื่อชื่อมีความยาว 30 ตัวอักษรหรือมากกว่า | |
พารามิเตอร์เนื้อหาต้องมีความยาวไม่เกิน 180 ตัวอักษร | การแจ้งเตือนที่เกิดขึ้นเมื่อข้อความในเนื้อหามีความยาว 180 ตัวอักษรหรือมากกว่า | |
พารามิเตอร์สื่อไม่ใช่ URI ที่ถูกต้อง. | การแจ้งเตือนที่เกิดขึ้นเมื่อป้อน URI รูปภาพที่ไม่ถูกต้อง | |
613 | สามารถส่งการแจ้งเตือนได้เพียง 5 รายการต่อผู้ใช้ตั้งแต่ครั้งสุดท้ายที่พวกเขาเล่น | การแจ้งเตือนที่เกิดขึ้นเมื่อเกินขีดจำกัดของการเรียก API การแจ้งเตือน |
โปรดดูที่ URL ด้านล่างสำหรับคู่มือสำหรับนักพัฒนาที่จัดทำโดย Google, Apple, Amazon และ Facebook.
Note
※รหัสข้อผิดพลาดที่ให้โดย Google (FCM), Apple (APNS), Amazon (ADM) และ Facebook รหัสข้อผิดพลาดการตอบกลับข้อความจาก FCM : ไปที่นี่ การตอบกลับ HTTP/2 จาก APNs : ไปที่นี่ รูปแบบการตอบกลับจาก ADM : ไปที่นี่ การจัดการข้อผิดพลาด Graph API จาก Facebook : ไปที่นี่
กราฟด้านซ้ายแสดงข้อมูลการจัดส่งตามประเทศและกราฟด้านขวาแสดงข้อมูลการจัดส่งตามเซิร์ฟเวอร์。
แสดงจำนวนการจัดส่ง, กรณีที่สำเร็จ, กรณีที่เปิดอยู่, และกรณีที่ล้มเหลวโดยแยกตามเซิร์ฟเวอร์หรือประเทศในวันเฉพาะของแคมเปญที่เลือก โดยค่าเริ่มต้น เซิร์ฟเวอร์หรือประเทศที่มีการจัดส่งมากที่สุดจะถูกแสดงก่อน เนื่องจากอาจมีหลายประเทศหรือเซิร์ฟเวอร์ที่มีการจัดส่งไป หากมีเซิร์ฟเวอร์หรือประเทศอย่างน้อยหนึ่งแห่งที่มีการจัดส่งไปแล้ว คุณสามารถใช้การเลือกหลายรายการที่ด้านบนเพื่อแสดงกราฟข้อมูล 2 แห่งขึ้นไปพร้อมกันและเปรียบเทียบกันได้
ข้อมูลงาน¶
เลือกแคมเปญเฉพาะที่ด้านบนเพื่อแสดง แคมเปญจะแตกต่างกันในจำนวน งาน ที่ correspond กับงานจริงขึ้นอยู่กับว่าคุณเลือกการจัดส่งแบบกลุ่มหรือไม่ ในกรณีที่เลือกการจัดส่งแบบกลุ่ม จะมีเพียง งาน เดียวเท่านั้น เพราะกรณีจะถูกส่งในครั้งเดียวตาม KST โดยไม่พิจารณาความแตกต่างของเวลา ระหว่างประเทศและเขตเวลา ในทางตรงกันข้าม หากไม่เลือกการจัดส่งแบบกลุ่ม จะสามารถมี งาน ได้สูงสุดถึง 24 งาน เพราะจะถูกส่งตามลำดับตามเวลาที่กำหนดโดยประเทศและเขตเวลา
ในส่วนนี้ คุณสามารถดูรายละเอียดของแต่ละ Task ของแคมเปญที่เลือก คุณต้อง คลิกและเลือก task ที่แน่นอน เพื่อดูข้อมูลตามด้านล่าง
แสดงข้อมูลการจัดส่งของ งาน ที่เลือกตามประเทศหรือเซิร์ฟเวอร์
แสดงข้อมูลการจัดส่งของ งาน ที่เลือกโดย AppID.
กราฟพายด้านซ้ายแสดงอัตราความสำเร็จและความล้มเหลวสำหรับงานที่เลือก โดยพิจารณาจากการส่งมอบทั้งหมดในวันนั้น
ตารางทางด้านขวาจะแสดงเหตุผลสำหรับความล้มเหลวโดยละเอียดและเปอร์เซ็นต์สำหรับจำนวนความล้มเหลวทั้งหมดในวันที่เลือก คำอธิบายโดยละเอียดของรหัสข้อผิดพลาดสาเหตุของความล้มเหลวจะเหมือนกับช่วงกราฟสาเหตุของความล้มเหลวของแคมเปญทั้งหมดที่ด้านบน
หากมีกรณีล้มเหลว 10 กรณีในแคมเปญและ 8 กรณีเกิดขึ้นใน งาน ที่เฉพาะเจาะจง คุณสามารถตรวจสอบได้ในส่วนนี้และหาสาเหตุว่าทำไมถึงล้มเหลว
หากคุณไม่ได้ใช้การจัดส่งแบบกลุ่ม และtask ถูกส่งไปยังเกาหลี และเหตุผลที่ล้มเหลวนั้นส่วนใหญ่เป็นเพราะแอปที่ถูกลบ คุณสามารถสรุปได้ว่ามีผู้ใช้ที่ลบแอปในเกาหลีมากกว่าประเทศอื่น ๆ