แท็ก

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

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

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

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

เคล็ดลับ

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

ค่าของแท็ก

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

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

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

• 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” สามารถใช้ได้กับแท็กทุกประเภท

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

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

ตัวอย่าง

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

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

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

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

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

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

ตัวอย่าง

{
   "request":{
      "application": "XXXXX-XXXXX", // รหัสแอปพลิเคชัน Pushwoosh
      "userId": "the id of a specific user",
      "tags": {
           "UserSpecificStringTag": "string value",
           "UserSpecificIntegerTag": 42
      }
   }
}

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

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

ชื่อ	ประเภท	ตั้งค่าที่ไหน	คำอธิบาย
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	ระบุว่าการแจ้งเตือนแบบ push ได้รับอนุญาตในการตั้งค่าอุปกรณ์หรือไม่
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

ชื่อ	ประเภท	คำอธิบาย
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
    }
}

ตัวอย่าง

{
  "request": {
    "auth": "yxoPUlwqm…………pIyEX4H", // จำเป็น, API access token จาก Pushwoosh Control Panel
    "tag": {
      "name": "TAG_NAME", // จำเป็น
      "type": 1, // จำเป็น, ดูค่าที่เป็นไปได้ด้านล่าง
      "application_specific": true, // หรือ 'false', ไม่จำเป็น กำหนดว่าค่าแท็กควรแตกต่างกันสำหรับหลายแอปหรือเหมือนกันในหลายแอป
      "user_specific": true // หรือ 'false', ไม่จำเป็น, ใช้สำหรับแท็ก application_specific
    }
  }
}

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

• 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", // จำเป็น, รหัสแอปพลิเคชัน Pushwoosh
      "hwid": "8f65bXXXf378eXXXbeceXXX4e153XXX2", // จำเป็น, ID อุปกรณ์ฮาร์ดแวร์ที่ใช้ใน /registerDevice API
      "tags": { // จำเป็น
           "StringTag": "string value", // ตัวอย่างแท็กสตริง
           "IntegerTag": 42, // ตัวอย่างแท็กจำนวนเต็ม
           "ListTag": ["string1", "string2"], // ตัวอย่างแท็กลิสต์
           "DateTag": "2024-10-02 22:11", // หมายเหตุ: เวลาต้องเป็น UTC
           "BooleanTag": true // ค่าที่ถูกต้อง: true, false
      }
   }
}

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

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

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

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

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

เคล็ดลับ

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