ตัวระบุ 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 จะตั้งค่านี้โดยอัตโนมัติหรือส่งผ่านระหว่างการลงทะเบียนอุปกรณ์ เรียนรู้เพิ่มเติม

ตำแหน่งที่ค้นหา

ในบันทึกของอุปกรณ์ (device logs) เรียนรู้เพิ่มเติม
ใน User Explorer เมื่อค้นหาด้วย User ID
ในไฟล์ CSV ที่ดาวน์โหลดจาก Segments list

Push token

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

ตำแหน่งที่ค้นหา

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

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

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

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

1 – iOS
3 – Android
7 – macOS
8 – Windows
9 – Amazon
10 – Safari
11 – Chrome
12 – Firefox
14 – Email
17 – Huawei
18 – SMS
21 – WhatsApp
22 – Line

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

User ID

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

ตำแหน่งที่ค้นหา

Pushwoosh Control Panel → Audience → User Explorer

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

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

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

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

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

ตำแหน่งที่ค้นหา

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

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

รหัสพรีเซ็ต (Preset code)

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

ตำแหน่งที่ค้นหา

Pushwoosh Control Panel → Content → Presets

คุณสามารถค้นหารหัสพรีเซ็ตได้จากสองที่:

ในมุมมองรายการ (list view) ซึ่งจะแสดงอยู่ใต้ชื่อพรีเซ็ต
ใน URL เมื่อแก้ไขหรือสร้างพรีเซ็ต (จะเป็นส่วนสุดท้ายของ URL)

ตัวอย่าง:

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

รหัสพรีเซ็ต: AAAAA-BBBBB

รหัส Rich media (Rich media code)

ตัวระบุสำหรับเทมเพลต Rich media เรียนรู้เพิ่มเติม

ตำแหน่งที่ค้นหา

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, ตรรกะอัตโนมัติ และกฎการแบ่งกลุ่มแบบไดนามิก

ตำแหน่งที่ค้นหา

คุณสามารถค้นหารหัสเซกเมนต์ได้ในตัวอย่างคำจำกัดความของเซกเมนต์ภายในส่วน Segments ของ Pushwoosh Control Panel รหัสฟิลเตอร์จะปรากฏที่ตอนต้นของตรรกะการกำหนดเป้าหมาย

ตัวอย่าง:

Tag("XXXXX-XXXXX", "In-app Purchase", noteq, "0.00")

ในกรณีนี้ XXXXX-XXXXX คือรหัสฟิลเตอร์ (เซกเมนต์)

แท็ก (Tag)

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

ตำแหน่งที่ค้นหา

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

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

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

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

ตำแหน่งที่ค้นหา

Pushwoosh Control Panel → Audience → Events

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

Geozone ID

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

ตำแหน่งที่ค้นหา

Pushwoosh Control Panel → Geozones