ตัวระบุ API ที่สำคัญ

โพสต์นี้จะแสดงรายการตัวระบุที่สำคัญที่ใช้ในคำขอ Pushwoosh API ตัวระบุเหล่านี้จำเป็นสำหรับการยืนยันตัวตน, การสร้างข้อความ, การกำหนดเป้าหมาย, การแบ่งกลุ่ม, การติดตาม และการจัดการผู้ใช้ในแอปพลิเคชันของคุณ

ตัวระบุทั่วไป

รหัสแอปพลิเคชัน (Application code)

ตัวระบุที่ไม่ซ้ำกันซึ่งกำหนดให้กับแต่ละแอปพลิเคชันในบัญชี Pushwoosh ของคุณ จำเป็นต้องใช้ในการเรียก API ส่วนใหญ่เพื่อระบุแอปเป้าหมาย

หาได้จากที่ไหน

Pushwoosh Control Panel → ใต้ชื่อแอปพลิเคชัน

โทเค็นการเข้าถึง API (API access token)

โทเค็นที่ไม่ซ้ำกันซึ่งกำหนดให้กับบัญชี Pushwoosh ใช้เพื่อยืนยันตัวตนคำขอ API ช่วยให้สามารถเข้าถึงเพื่อจัดการโปรเจกต์, ส่งข้อความ, แก้ไขการตั้งค่า และดึงข้อมูลได้ แต่ละบัญชีจะมีโทเค็นอย่างน้อยหนึ่งรายการที่สร้างขึ้นโดยค่าเริ่มต้น เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → API Access

ตัวระบุอุปกรณ์

Hardware ID

ตัวระบุที่ไม่ซ้ำกันซึ่งกำหนดให้กับอุปกรณ์โดย Pushwoosh SDK ตั้งค่าโดยอัตโนมัติโดย SDK หรือส่งผ่านระหว่างการลงทะเบียนอุปกรณ์ เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

• ในบันทึกของอุปกรณ์ เรียนรู้เพิ่มเติม

• ใน User Explorer เมื่อค้นหาด้วย User ID

• ในไฟล์ CSV ที่ดาวน์โหลดจาก รายการเซกเมนต์

Push token

โทเค็นที่ออกโดยผู้ให้บริการแพลตฟอร์มซึ่งระบุคู่แอป-อุปกรณ์สำหรับการส่ง push notifications รวบรวมโดยอัตโนมัติโดย SDK เมื่อได้รับอนุญาตให้ส่ง push เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

• ในบันทึกของอุปกรณ์ เรียนรู้เพิ่มเติม

• ใน User Explorer ให้ป้อน HWID ในช่องค้นหาเพื่อค้นหาอุปกรณ์ที่เกี่ยวข้อง จากนั้นเปิดรายละเอียดอุปกรณ์เพื่อดู push token

ประเภทอุปกรณ์ (Device type)

ระบุแพลตฟอร์มของอุปกรณ์เป้าหมายโดยใช้รหัสตัวเลข ตั้งค่าโดยอัตโนมัติโดย SDK

ค่าที่รองรับ:

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
13 – Internet Explorer
14 – Email
16 – Baidu Android
17 – Huawei
18 – SMS
20 – Web
21 – WhatsApp
22 – Line
23 – Kakao Talk
24 – Telegram
25 – Apple Wallet
26 – Google Wallet
27 – Viber

ตัวระบุผู้ใช้

User ID

ตัวระบุที่กำหนดเองซึ่งกำหนดให้กับผู้ใช้ ทำให้สามารถกำหนดเป้าหมายข้ามอุปกรณ์และแบบส่วนบุคคลได้ เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Audience → User Explorer

ตัวระบุข้อความ

รหัสข้อความ (Message code)

ตัวระบุที่ไม่ซ้ำกันซึ่งกำหนดให้กับแต่ละข้อความเมื่อสร้างขึ้น มีรูปแบบเฉพาะ: XXXX-XXXXXXXX-XXXXXXXX

รหัสนี้จำเป็นสำหรับ:

• การติดตามสถานะและการส่งมอบของข้อความที่เฉพาะเจาะจง
• การยกเลิก (หรือลบ) ข้อความที่ส่งไปแล้ว
• การรับสถิติข้อความ

หาได้จากที่ไหน

• Pushwoosh Control Panel: ไปที่ Campaigns → One-time messages จากนั้นเปิด properties ของข้อความที่ต้องการ Message Code จะแสดงอยู่ที่นั่น
• การตอบกลับของ API /createMessage: เมื่อสร้างข้อความใหม่ผ่าน API, Message Code จะรวมอยู่ในการตอบกลับ

ตัวระบุเนื้อหา

รหัส Preset (Preset code)

ตัวระบุสำหรับ preset ข้อความที่บันทึกไว้ (เช่น push หรือ SMS) เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Content → Presets

คุณสามารถหารหัส preset ได้จากสองที่:

• ในมุมมองรายการ จะแสดงอยู่ใต้ชื่อ preset

• ใน URL เมื่อแก้ไขหรือสร้าง preset (เป็นส่วนสุดท้ายของ URL)

ตัวอย่าง:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/sms-presets/edit/AAAAA-BBBBB

รหัส Preset: AAAAA-BBBBB

รหัส Rich media (Rich media code)

ตัวระบุสำหรับเทมเพลตข้อความในแอป เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Content → Rich media

ตัวอย่าง: URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/rich-media/AAAAA-BBBBB/statistics รหัส Rich media: AAAAA-BBBBB

รหัสเนื้อหาอีเมล (Email content code)

รหัสเนื้อหาอีเมลเป็นตัวระบุที่ไม่ซ้ำกันสำหรับเนื้อหาอีเมลที่บันทึกไว้ เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Content → Email content

รหัสคือส่วนสุดท้ายของ URL

ตัวอย่าง:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/email-content/edit/AAAAA-BBBBB รหัสเนื้อหาอีเมล: AAAAA-BBBBB

ตัวระบุแคมเปญ

รหัสแคมเปญ (Campaign code)

ตัวระบุที่ไม่ซ้ำกันที่ใช้อ้างอิงแคมเปญที่เฉพาะเจาะจงสำหรับการติดตามและวิเคราะห์

หาได้จากที่ไหน

รหัสแคมเปญจะปรากฏใน URL เมื่อดูสถิติที่เกี่ยวข้องกับแคมเปญใน Pushwoosh Control Panel หากต้องการค้นหา ให้ไปที่ Statistics → Aggregated statistics คลิกที่แคมเปญที่ต้องการ และคัดลอกรหัสที่อยู่ท้าย URL

ตัวอย่าง:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/statistics/aggregated-message?campaignCode=YYYYY-YYYYY

รหัสแคมเปญ: YYYYY-YYYYY

Journey ID

ตัวระบุที่ไม่ซ้ำกันที่ใช้เพื่อเชื่อมโยงข้อความกับแคมเปญการตลาดที่เฉพาะเจาะจงสำหรับการติดตามและวิเคราะห์ประสิทธิภาพ

หาได้จากที่ไหน

Journey ID จะปรากฏใน URL ของ campaign canvas ใน Pushwoosh Control Panel

ตัวอย่าง: URL: https://app.pushwoosh.com/journeys/XXXXX-XXXXX/1/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

Journey ID: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee

ตัวระบุการแบ่งกลุ่มและการกำหนดเป้าหมาย

ชื่อเซกเมนต์ / ฟิลเตอร์ (Segment / Filter name)

ชื่อของเซกเมนต์ผู้ใช้ที่กำหนดไว้ล่วงหน้าซึ่งสร้างขึ้นใน Pushwoosh สำหรับการกำหนดเป้าหมายผู้ชม เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Segments

รหัสเซกเมนต์ / ฟิลเตอร์ (Segment / Filter code)

รหัสที่ไม่ซ้ำกันในรูปแบบ XXXXX-XXXXX ที่ระบุเซกเมนต์ (หรือที่เรียกว่าฟิลเตอร์) ใน Pushwoosh รหัสนี้ใช้ในการเรียก API, ตรรกะอัตโนมัติ และกฎการแบ่งกลุ่มแบบไดนามิก

หาได้จากที่ไหน

• ผ่านเมธอด API /listFilters

• ในแถบที่อยู่เมื่อดูเซกเมนต์ใน Pushwoosh Control Panel:

ตัวอย่าง:

URL: https://app.pushwoosh.com/applications/XXXXX-XXXXX/segments/XXXE9-XXX49/detail รหัสเซกเมนต์: XXXE9-XXX49

Tag

แอตทริบิวต์ที่กำหนดเองซึ่งกำหนดให้กับผู้ใช้หรืออุปกรณ์ ใช้สำหรับการแบ่งกลุ่มแบบไดนามิกและการปรับให้เป็นแบบส่วนบุคคล เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Tags หรือผ่าน API /getTags

ตัวระบุอีเวนต์

ชื่ออีเวนต์ (Event name)

ชื่อของอีเวนต์ที่ติดตาม (เช่น purchase, login, subscription) ใช้เพื่อทริกเกอร์เวิร์กโฟลว์อัตโนมัติหรือสำหรับการวิเคราะห์ เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Audience → Events

ตัวระบุตำแหน่งทางภูมิศาสตร์

Geozone ID

ระบุพื้นที่ geofenced ที่ใช้เพื่อทริกเกอร์การแจ้งเตือนตามตำแหน่ง เรียนรู้เพิ่มเติม

หาได้จากที่ไหน

Pushwoosh Control Panel → Geozones