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

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

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

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

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

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

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

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

โทเค็นที่ไม่ซ้ำกันซึ่งกำหนดให้กับบัญชี Pushwoosh ใช้เพื่อยืนยันตัวตนคำขอ API ช่วยให้สามารถเข้าถึงเพื่อจัดการโปรเจกต์, ส่งข้อความ, แก้ไขการตั้งค่า และดึงข้อมูลได้ แต่ละบัญชีจะมีโทเค็นอย่างน้อยหนึ่งรายการที่สร้างขึ้นโดยค่าเริ่มต้น [เรียนรู้เพิ่มเติม](/th/developer/api-reference/api-access-token/)

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

Pushwoosh Control Panel → API Access

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

### Hardware ID

ตัวระบุที่ไม่ซ้ำกันซึ่งกำหนดให้กับอุปกรณ์โดย Pushwoosh SDK ตั้งค่าโดยอัตโนมัติโดย SDK หรือส่งผ่านระหว่างการลงทะเบียนอุปกรณ์ [เรียนรู้เพิ่มเติม](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid)

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

* ในบันทึกของอุปกรณ์ [เรียนรู้เพิ่มเติม](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

* ใน [User Explorer](/th/product/audience-data-and-segmentation/user-explorer/) เมื่อค้นหาด้วย **User ID**
* ในไฟล์ CSV ที่ดาวน์โหลดจาก [รายการเซกเมนต์](/th/product/audience-data-and-segmentation/segmentation/segments/)

### Push token

โทเค็นที่ออกโดยผู้ให้บริการแพลตฟอร์มซึ่งระบุคู่แอป-อุปกรณ์สำหรับการส่ง push notifications รวบรวมโดยอัตโนมัติโดย SDK เมื่อได้รับอนุญาตให้ส่ง push [เรียนรู้เพิ่มเติม](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token)

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

* ในบันทึกของอุปกรณ์ [เรียนรู้เพิ่มเติม](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#how-to-obtain-hwid-and-push-token)

* ใน [User Explorer](/th/product/audience-data-and-segmentation/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

ตัวระบุที่กำหนดเองซึ่งกำหนดให้กับผู้ใช้ ทำให้สามารถกำหนดเป้าหมายข้ามอุปกรณ์และแบบส่วนบุคคลได้ [เรียนรู้เพิ่มเติม](/th/developer/pushwoosh-knowledge-hub/users-userids/users-userids/)

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

Pushwoosh Control Panel → Audience → User Explorer 

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

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

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

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

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

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

* **Pushwoosh Control Panel:** ไปที่ **Campaigns → One-time messages** จากนั้นเปิด **properties** ของข้อความที่ต้องการ Message Code จะแสดงอยู่ที่นั่น
* **การตอบกลับของ API [`/createMessage`](/th/developer/api-reference/messages-api/#createmessage):** เมื่อสร้างข้อความใหม่ผ่าน API, Message Code จะรวมอยู่ในการตอบกลับ

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

### รหัส Preset (Preset code)

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

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

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)

ตัวระบุสำหรับเทมเพลตข้อความในแอป [เรียนรู้เพิ่มเติม](/th/product/content/in-apps/)

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

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)

รหัสเนื้อหาอีเมลเป็นตัวระบุที่ไม่ซ้ำกันสำหรับเนื้อหาอีเมลที่บันทึกไว้ [เรียนรู้เพิ่มเติม](/th/product/content/email-content/)

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

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 สำหรับการกำหนดเป้าหมายผู้ชม [เรียนรู้เพิ่มเติม](/th/product/audience-data-and-segmentation/segmentation/segments/)

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

Pushwoosh Control Panel → Segments

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

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

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

- ผ่านเมธอด API [`/listFilters`](/th/developer/api-reference/segmentation-filters-api/#listfilters)

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

**ตัวอย่าง:**

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




### Tag

แอตทริบิวต์ที่กำหนดเองซึ่งกำหนดให้กับผู้ใช้หรืออุปกรณ์ ใช้สำหรับการแบ่งกลุ่มแบบไดนามิกและการปรับให้เป็นแบบส่วนบุคคล [เรียนรู้เพิ่มเติม](/th/developer/guides/audience-and-segmentation/tags/)

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

Pushwoosh Control Panel → Tags หรือผ่าน API [`/getTags`](/th/developer/api-reference/device-api/#gettags)

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

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

ชื่อของอีเวนต์ที่ติดตาม (เช่น `purchase`, `login`, `subscription`) ใช้เพื่อทริกเกอร์เวิร์กโฟลว์อัตโนมัติหรือสำหรับการวิเคราะห์ [เรียนรู้เพิ่มเติม](/th/developer/guides/audience-and-segmentation/events/)

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

Pushwoosh Control Panel → Audience → Events

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

### Geozone ID

ระบุพื้นที่ geofenced ที่ใช้เพื่อทริกเกอร์การแจ้งเตือนตามตำแหน่ง [เรียนรู้เพิ่มเติม](/th/product/messaging-channels/push-notifications/geo-based-push/)

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

Pushwoosh Control Panel → Geozones