แท็ก

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

แท็กสามารถมีข้อมูลใดๆ ก็ได้ที่เกี่ยวข้องกับผู้ใช้หรืออุปกรณ์นั้นๆ ข้อมูลนี้อาจรวมถึงชื่อผู้ใช้, ID, เมือง, ทีมฟุตบอลที่ชื่นชอบ, หมวดหมู่ข่าวที่ต้องการ หรือข้อมูลอื่นๆ ที่เกี่ยวข้องกับผู้ใช้ของคุณ

การตัดสินใจว่าจะใช้แท็กใด

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

เคล็ดลับ

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

ค่าของแท็ก

ค่าของแท็กสามารถช่วยให้แคมเปญพุชของคุณฉลาดขึ้นได้ แต่ละแท็กสามารถจัดเก็บค่าได้_เกือบไม่จำกัดจำนวน_ โดยพื้นฐานแล้ว หมายความว่าแท็กเดียวก็เพียงพอที่จะบันทึกข้อมูลประเภทเฉพาะเกี่ยวกับผู้ใช้ปลายทางแต่ละคนในฐานข้อมูลของคุณ

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

ประเภทของแท็ก

• Integer — ใช้สำหรับข้อมูลจำนวนเต็ม (จำนวนเงินในเกมที่ได้รับ, ระดับที่ไปถึง, อายุ)
• String — ใช้สำหรับค่าที่เป็นข้อความ (ชื่อผู้ใช้, อีเมล, ตัวระบุ)
• List — เหมือนกับประเภท String แต่ผู้ใช้แต่ละคนอาจมีค่าหลายค่าที่ตั้งไว้พร้อมกัน (ความชอบทางดนตรี, หมวดหมู่ข่าว, ความชอบด้านอาหาร)
• Boolean — ประเภทของแท็กที่เป็น true / false
• Date — ใช้สำหรับวันที่ในปฏิทิน โดยพื้นฐานแล้ว นี่คือแท็กประเภทจำนวนเต็มที่เก็บค่าเวลา Unix Epoch (แปลงจาก/เป็นวันที่แบบเกรกอเรียนโดยอัตโนมัติ)
• Price — อนุญาตให้ตั้งค่าตามสกุลเงินที่ระบุในรูปแบบ “*.XX” เรียนรู้เพิ่มเติม
• Version — ใช้สำหรับการกำหนดเวอร์ชัน ตัวอย่างของรูปแบบที่อนุญาตคือ w.x.y.z (Major.Minor.Patch.Build) ค่าสูงสุดสำหรับแต่ละส่วนของเวอร์ชันคือ 9999 ดังนั้นหมายเลขเวอร์ชันสูงสุดจึงไม่สามารถมากกว่า 9999.9999.9999.9999 ได้

ตัวดำเนินการแท็ก

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

• ตัวดำเนินการแท็ก Integer: is, is not, are, not in, not set, any
• ตัวดำเนินการแท็ก String: is, is not, are, not in, not set, any
• ตัวดำเนินการแท็ก List: in, not in, not set, any
• ตัวดำเนินการแท็ก Boolean: is (true/false), not set, any
• ตัวดำเนินการแท็ก Date: exactly on, on or after, on or before, between, not set, any
• ตัวดำเนินการแท็ก Price: is, is not, greater or equals, less or equals, between, in, not in, not set, any
• ตัวดำเนินการแท็ก Version: is, is not, greater or equals, less or equals, between, in, not in, not set, any

หมายเหตุ

ตัวดำเนินการ “Not set” และ “any” สามารถใช้ได้กับแท็กทุกประเภท

แท็กเฉพาะแอปพลิเคชัน / ไม่เฉพาะเจาะจง

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

ตัวอย่าง

สมมติว่าคุณมีสองแอป คือแอปข่าวและเกม และคุณต้องการกำหนดเป้าหมายเฉพาะผู้ใช้ที่ตกลงอย่างชัดเจนที่จะรับพุชจากคุณ ดังนั้น คุณจึงสร้างแท็กบูลีนชื่อ “Subscribed” และตั้งค่าเป็น "true" สำหรับผู้ใช้ที่ต้องการรับพุชจากคุณ และ "false" สำหรับผู้ที่ไม่ต้องการรับการแจ้งเตือน

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

หากแท็ก “Subscribed” เป็นแท็กเฉพาะแอปพลิเคชัน ทุกอย่างจะเป็นไปตามแผน อย่างไรก็ตาม ในกรณีที่แท็กนี้ไม่เฉพาะเจาะจงแอปพลิเคชัน แอปแต่ละแอปของคุณจะเขียนทับค่าที่ตั้งไว้โดยแอปอื่น ซึ่งอาจทำลายการกำหนดเป้าหมายของคุณและทำให้เกิดความไม่พอใจได้

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

แท็กเฉพาะผู้ใช้

แท็กทั้งหมดใน Pushwoosh ถูกออกแบบมาให้เป็นแบบเฉพาะผู้ใช้และจะถูกกำหนดให้กับอุปกรณ์ทั้งหมดของผู้ใช้เมื่อตั้งค่าโดย UserID แทนที่จะเป็น HWID

Example

{
   "request":{
      "application": "XXXXX-XXXXX", // Pushwoosh application code
      "userId": "the id of a specific user",
      "tags": {
           "UserSpecificStringTag": "string value",
           "UserSpecificIntegerTag": 42
      }
   }
}

แท็กเริ่มต้น

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

Name	Type	Where it’s set	Description
Application Version	Version	SDK	เวอร์ชันปัจจุบันของแอปที่ติดตั้งบนอุปกรณ์
Browser Type	String	SDK	เมื่ออุปกรณ์ถูกลงทะเบียนสำหรับโปรเจกต์เว็บของคุณ ประเภทของมัน – มือถือหรือเดสก์ท็อป – จะถูกติดตามโดยอัตโนมัติ
City	String	Server	ตำแหน่งทางภูมิศาสตร์ล่าสุดที่ลงทะเบียนของอุปกรณ์
Country	String	Server	ตำแหน่งทางภูมิศาสตร์ล่าสุดที่ลงทะเบียนของอุปกรณ์
Device Model	String	SDK	ระบุรุ่นของอุปกรณ์ที่ติดตั้งแอป
First Install	Date	Server	ระบุเวลาที่อุปกรณ์ถูกลงทะเบียนเพื่อรับการแจ้งเตือนเป็นครั้งแรก
In-App Product	List	SDK	ผลิตภัณฑ์ในแอปที่ผู้ใช้แอปซื้อ
Last In-App Purchase Date	Date	SDK	วันที่ของการซื้อในแอปครั้งล่าสุดที่ทำบนอุปกรณ์
Language	String	SDK	ตัวย่อสองตัวอักษรพิมพ์เล็กของภาษาท้องถิ่นของอุปกรณ์ตามมาตรฐาน ISO-639-1; นำมาจากค่าติดตั้งของอุปกรณ์
Last Application Open	Date	Server	เวลาของการเปิดแอปครั้งล่าสุดบนอุปกรณ์
OS Version	Version	SDK	เวอร์ชันของระบบปฏิบัติการที่ทำงานบนอุปกรณ์
Platform	String	SDK	แพลตฟอร์มที่ผู้ใช้กำลังใช้โปรเจกต์ของคุณ
Push Alerts Enabled	Boolean	SDK	ระบุว่าการแจ้งเตือนแบบพุชได้รับอนุญาตในการตั้งค่าอุปกรณ์หรือไม่
SDK Version	Version	SDK	เวอร์ชันของ Pushwoosh SDK ที่ใช้งานบนอุปกรณ์
Unsubscribed Emails	Boolean	SDK	ระบุว่าผู้ใช้ได้ยกเลิกการสมัครรับอีเมลจากแอปของคุณหรือไม่

แท็กที่กำหนดเอง

นี่คือส่วนที่ความคิดสร้างสรรค์ของคุณเข้ามามีบทบาทเพื่อบรรลุเป้าหมายทางธุรกิจเฉพาะของคุณ แท็กที่กำหนดเองสามารถสร้างขึ้นตามตรรกะการแบ่งกลุ่มหรือรูปแบบการกำหนดเป้าหมายที่เหมาะสมกับความต้องการทางธุรกิจที่เป็นเอกลักษณ์ของคุณ ทำงานร่วมกับทีมการตลาดของคุณเพื่อกำหนดแท็กที่กำหนดเองเพิ่มเติมที่จำเป็นสำหรับแคมเปญของคุณ

วิธีการตั้งค่าแท็กที่กำหนดเอง

คุณสามารถเพิ่มแท็กใหม่ได้ใน Pushwoosh Control Panel หรือใช้วิธีการ /addTag

addTag

POST https://api.pushwoosh.com/json/1.3/addTag

สร้างแท็กในบัญชีของคุณ

Request Body

Name	Type	Description
auth*	string	API access token จาก Pushwoosh Control Panel
tag*	object	พารามิเตอร์ของแท็ก
tag.name*	string	ชื่อแท็ก
tag.type*	integer	ประเภทของแท็ก ดูค่าที่เป็นไปได้ด้านล่าง
tag.application_specific	boolean	กำหนดว่าค่าของแท็กควรจะแตกต่างกันสำหรับแอปหลายตัวหรือเหมือนกันในแอปหลายตัว

200

{
    "status_code": 200,
    "status_message": "OK",
    "response": {
        "result": true
    }
}

Example

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // required, API access token from Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME", // required
      "type": 1, // required, see possible values below
      "application_specific": true, // or 'false', optional. Defines whether the tag value should be different for multiple apps or be the same across multiple apps
      "user_specific": true // or 'false', optional, used for application_specific tags
    }
  }
}

ประเภทค่าแท็กที่เป็นไปได้:

• 1 - Integer
• 2 - String
• 3 - List
• 4 - Date
• 5 - Boolean
• 6 - Decimal. เช่น: 19.95
• 7 - Version. เช่น: “1.0.0.0”

วิธีการรวบรวมข้อมูลจากผู้ใช้

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

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

ด้านล่างนี้คือตัวอย่างการใช้งานสำหรับเฟรมเวิร์กต่างๆ โดยใช้ฟังก์ชัน setTags

iOS Native

iOS Native

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};

[[PushNotificationManager pushManager] setTags:tags];

เอกสารประกอบ

Android Native

Android Native

pushwoosh.setTags(Tags.intTag("intTag", 42));

เอกสารประกอบ

Cordova

Cordova

PushNotification.prototype.setTags = function(  config, success, fail  )

เอกสารประกอบ

Flutter

Flutter

Future<void> setTags(Map tags) async {
  await _channel.invokeMethod("setTags", {"tags" : tags});
}

เอกสารประกอบ

React Native

React Native

pushNotification.setTags({
    "string_tag" : "Hello world",
    "int_tag" : 42,
    "list_tag":["hello", "world"]
});

เอกสารประกอบ

Unity

Unity

SetIntTag

ตั้งค่า Integer Tag สำหรับอุปกรณ์

public virtual void SetIntTag(string tagName, int tagValue)

SetStringTag

ตั้งค่า String Tag สำหรับอุปกรณ์

public virtual void SetStringTag(string tagName, string tagValue)

SetListTag

ตั้งค่า List Tag สำหรับอุปกรณ์

public virtual void SetListTag(string tagName, List<object> tagValues)

เอกสารประกอบ

Unreal Engine

Unreal Engine

FPushwooshModule& pushwoosh = FPushwooshModule::Get();
pushwoosh.SetTags("{ \"intTag\" : 1, \"stringTag\" : \"example\", \"listTag\" : [ \"a\", \"b\", \"c\" ] }");

เอกสารประกอบ

Expo

Expo

Pushwoosh.setTags({ "key": keyValue, "value": inputValue });

เอกสารประกอบ

.NET MAUI

.NET MAUI

NSDictionary *tags = @{
    @"Alias" : aliasField.text,
    @"FavNumber" : @([favNumField.text intValue]),
    @"price" : [PWTags incrementalTagWithInteger:5],
    @"List" : @[ @"Item1", @"Item2", @"Item3" ]
};
[[PushNotificationManager pushManager] setTags:tags];

เอกสารประกอบ

Outsystems

Outsystems

พารามิเตอร์อินพุต Tags – รายการของระเบียนแท็กที่ประกอบด้วย TagName และ TagValue

• TagName ต้องเป็นประเภท Text เสมอ
• TagValue สามารถเป็น Text, Integer, Boolean, Date ฯลฯ

เรียนรู้เพิ่มเติม

การตั้งค่าแท็กผ่าน API

ในขณะที่ในกรณีส่วนใหญ่ (99%) แท็กจะถูกตั้งค่าจากแอปพลิเคชัน คุณยังสามารถตั้งค่าแท็กผ่าน Pushwoosh API ได้อีกด้วย ด้านล่างนี้คือตัวอย่างของคำขอทั่วไปไปยัง endpoint /setTags:

POST https://api.pushwoosh.com/json/1.3/setTags

{
   "request": {
      "application": "XXXXX-XXXXX", // required, Pushwoosh application code
      "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // required, hardware device ID used in /registerDevice API
      "tags": { // required
           "StringTag": "string value", // Example of a string tag
           "IntegerTag": 42, // Example of an integer tag
           "ListTag": ["string1", "string2"], // Example of a list tag
           "DateTag": "2024-10-02 22:11", // Note: time must be in UTC
           "BooleanTag": true // Valid values: true, false
      }
   }
}

สำหรับรายละเอียดเพิ่มเติม โปรดดูเอกสารประกอบ setTags API

การใช้แท็ก City เริ่มต้น

ตำแหน่งของอุปกรณ์จะถูกกำหนดตามที่อยู่ IP ของอุปกรณ์ในขณะที่แอปของคุณถูกเปิดใช้งานบนอุปกรณ์นั้นเป็นครั้งล่าสุด GeoIP จะส่งข้อมูลตำแหน่งไปยัง Pushwoosh และ Pushwoosh จะบันทึกตำแหน่งที่ได้รับจาก GeoIP เป็นค่าแท็ก City สำหรับอุปกรณ์นั้นๆ

ในบางกรณี ตำแหน่งที่ส่งโดย GeoIP อาจแตกต่างจากชื่อเมือง — ตัวอย่างเช่น เมื่ออ้างถึงพื้นที่ของเมืองหรือหน่วยการปกครองอื่น โปรดระมัดระวังเมื่อใช้แท็ก City เริ่มต้นเพื่อวัตถุประสงค์ในการแบ่งกลุ่ม: ตรวจสอบให้แน่ใจว่าได้เลือกค่าที่เหมาะสม

ตัวอย่างเช่น หากคุณจะกำหนดเป้าหมายผู้ใช้จากมิวนิก คุณจะต้องครอบคลุมด้วยค่าแท็ก City หลายค่า รวมถึง “Munich” เอง (พร้อมค่าที่สอดคล้องกันทั้งหมด เช่น การสะกดที่แตกต่างกันซึ่งอาจถูกส่งคืนโดย GeoIP และบันทึกเป็นค่าแท็ก) และพื้นที่ใกล้เคียงหลายแห่ง

เคล็ดลับ

ก่อนที่จะ สร้าง Segment ผ่าน API ให้ตรวจสอบค่าที่ผู้ใช้ของคุณมีบนอุปกรณ์ของพวกเขาผ่านคำขอ /getTagStats