การผสานการทำงานกับ Piano Analytics

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

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

• ปลายทาง (Destination): ข้อมูลถูกส่งจาก Piano Analytics ไปยัง Pushwoosh
• ต้นทาง (Source): ข้อมูลถูกส่งจาก Pushwoosh ไปยัง Piano Analytics

บัญชีแบบชำระเงินทั้งใน Pushwoosh และ Piano Analytics

เมื่อทำการผสานการทำงานระหว่าง Pushwoosh และ Piano Analytics ชื่อเอนทิตีบางชื่ออาจแตกต่างกันระหว่างสองแพลตฟอร์ม นี่คือการจับคู่ระหว่าง Pushwoosh และ Piano Analytics:

ต้นทาง (Source)

• อีเวนต์
• สถิติพุช
• แท็ก (ในฐานะแอตทริบิวต์ของอีเวนต์)

ปลายทาง (Destination)

• เซกเมนต์

การวิเคราะห์แบบครบวงจร

รวมข้อมูลการมีส่วนร่วมจาก Pushwoosh เข้ากับ Piano Analytics เพื่อให้ได้ข้อมูลเชิงลึกเกี่ยวกับผู้ใช้ที่ครอบคลุม ซึ่งช่วยให้คุณเห็นภาพรวมของพฤติกรรมผู้ใช้และการโต้ตอบในทุกจุดสัมผัส

การแบ่งเซกเมนต์

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

การตรวจสอบประสิทธิภาพ

ติดตามประสิทธิภาพของแคมเปญและการโต้ตอบของผู้ใช้ในทุกแพลตฟอร์ม

1. ตั้งค่า (Setup): กำหนดการตั้งค่าการผสานการทำงานในบัญชี Pushwoosh และ Piano Analytics
2. การจับคู่อีเวนต์ (Event Mapping): จับคู่อีเวนต์ของ Pushwoosh กับอีเวนต์ของ Piano (เช่น PostEvent.EventName กับ PianoEvent.Name)
3. การถ่ายโอนข้อมูล (Data Transfer): Pushwoosh ส่งอีเวนต์ (Post Events และ Tracking Log Events) ไปยัง Piano Analytics
4. การนำเข้าเซกเมนต์ (Segment Import): Piano Analytics ส่งข้อมูลเซกเมนต์ไปยัง Pushwoosh เพื่อการแบ่งกลุ่มเป้าหมาย

1. Post Events
   • Pushwoosh ส่งข้อมูลอีเวนต์ไปยัง Piano Analytics
   • แอตทริบิวต์จะถูกจับคู่ดังนี้:
     • UserID (Pushwoosh) -> PushwooshID (Piano)
     • CampaignID (Pushwoosh) -> SrcMedium (Piano)
     • PlatformID (Pushwoosh) -> DeviceType (Piano)
2. Tracking Log Events:
   • Pushwoosh ส่งข้อมูลการติดตาม (เช่น Push Sent, Push Delivered) ไปยัง Piano Analytics
   • ข้อมูลนี้จะเพิ่มความสมบูรณ์ให้กับ Piano Analytics ด้วยเมตริกการส่งมอบและการมีส่วนร่วม
3. การผสานการทำงาน Piano VisitorID:
   • สามารถเลือกผสานการทำงาน Piano VisitorID กับ Pushwoosh เพื่อการวิเคราะห์แบบครบวงจรใน SDK ต่างๆ ได้

เพื่อตั้งค่าการผสานการทำงาน ไปที่ Settings > 3rd Party Integrations ในบัญชี Pushwoosh ของคุณและค้นหา Piano คลิก Configure

ในหน้าต่างที่เปิดขึ้นมา ให้ระบุข้อมูลรับรองต่อไปนี้:

1. Site ID

เพื่อค้นหา Site ID ของคุณ ให้ลงชื่อเข้าใช้บัญชี Piano ของคุณและไปที่ Analytics > Data Collection Portal > Dashboard ค้นหาเว็บไซต์ที่เกี่ยวข้องและคัดลอก ID ของมัน

2. Collection Domain

เพื่อค้นหา Collection Domain ให้ไปที่ Tagging > Collection Domains คัดลอก ID ของ Collection Domain ตรวจสอบให้แน่ใจว่าได้ป้อนโดเมนการรวบรวมข้อมูลในรูปแบบ ****.pa-cd.com โดยไม่มีคำนำหน้า https://

3. คีย์การเข้าถึงและคีย์ลับของ Piano API

เพื่อรับคีย์:

• ในบัญชี Piano ของคุณ คลิกที่ See profile ใต้ชื่อบัญชีของคุณ

• ไปที่แท็บ API Keys และสร้างคีย์ใหม่พร้อมชื่อและคำอธิบายที่ชัดเจน จากนั้นคลิก OK

• ในหน้าต่างที่เปิดขึ้นมา คัดลอก Access Key และ Secret Key ของคุณ

• ในช่อง API key ใน Pushwoosh ให้ป้อนทั้ง Access Key และ Secret Key โดยคั่นด้วยเครื่องหมายขีดล่าง (underscore) ตัวอย่างเช่น: accesskey_secretkey

เพื่อติดตามอีเวนต์ที่ส่งมาจาก Pushwoosh ใน Piano คุณต้องสร้างอีเวนต์ที่สอดคล้องกันด้วยตนเองภายใน Piano

นี่คือวิธีการทำในบัญชี Piano ของคุณ:

1. ไปที่ Settings > Data management > Data model
2. เลือก Events และคลิกไอคอนเครื่องหมายบวกเพื่อสร้างอีเวนต์ใหม่
3. ในหน้าต่างที่เปิดขึ้นมา ให้ระบุชื่อและคำอธิบายอีเวนต์ เช่น “pw_siteopened”

4. ในช่อง Type เลือก On-site
5. ในช่อง Categories เลือก Events
6. คลิก Save

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

เพื่อแก้ไขโซนเวลาใน Piano ไปที่ Dashboard และคลิกบรรทัดที่มีข้อมูลเว็บไซต์ของคุณ ในหน้าต่างป๊อปอัป คลิก Edit และเลือกโซนเวลาที่ต้องการ จากนั้นคลิก Save

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

นี่คือวิธีการสร้างพร็อพเพอร์ตี้:

1. ใน Piano ไปที่ Settings > Data Management > Properties
2. คลิก Create Property
3. ในช่อง Name ป้อน pushwooshid
4. ในช่อง Property Key ป้อน pushwooshid
5. ตั้งค่า Type เป็น String
6. คลิก Save

เพื่อยืนยันว่าอีเวนต์ที่ตั้งค่าใน Pushwoosh ถูกส่งไปยัง Piano สำเร็จ ให้ทำตามขั้นตอนต่อไปนี้:

1. ในบัญชี Piano ของคุณ ไปที่ Explorer > Audience > Overall Traffic
2. สร้างเซกเมนต์โดยอิงจากอีเวนต์ที่พร็อพเพอร์ตี้ pushwooshid ไม่ใช่ค่าว่าง

มุมมองที่กรองแล้วจะแสดงข้อมูลการเข้าชมโดยรวม รวมถึงอีเวนต์ที่เกี่ยวข้อง

สำหรับมุมมองที่ละเอียดขึ้นของอีเวนต์ที่ส่งมาจาก Pushwoosh ให้ไปที่ Content > Events ส่วนนี้จะให้รายละเอียดของอีเวนต์ทั้งหมดที่ส่งมาจาก Pushwoosh รวมถึงจำนวนครั้งที่แต่ละอีเวนต์เกิดขึ้น

เมื่อคุณตั้งค่าการผสานการทำงานเสร็จสิ้นแล้ว คุณสามารถเริ่มวิเคราะห์อีเวนต์ที่ส่งมาจาก Pushwoosh ภายใน Piano ได้ หากต้องการเข้าถึงอีเวนต์เหล่านี้ ให้ไปที่ Explorer > Content > Events ในบัญชี Piano ของคุณ

จากนั้น สร้างเซกเมนต์ โดยใช้อีเวนต์เหล่านี้ เมื่อสร้างเซกเมนต์ ให้เลือกพร็อพเพอร์ตี้ pushwooshid ที่คุณสร้างไว้ก่อนหน้านี้เพื่อกรองอีเวนต์

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

เพื่อให้ Pushwoosh สามารถดึงเซกเมนต์จาก Piano ได้ ให้ระบุ SegmentKey ที่คุณสร้างขึ้นให้กับ Pushwoosh หากต้องการค้นหา SegmentKey สำหรับเซกเมนต์ ให้ไปที่ Analysis > Library > Segments คลิกที่เซกเมนต์ที่คุณต้องการและคัดลอก Segment Key

ในส่วน Integrations ของ Pushwoosh ให้ค้นหา Piano และคลิกที่ Import Segment จากนั้น ป้อน Segment key ที่คุณคัดลอกมา

หากการนำเข้าสำเร็จ คุณจะเห็นข้อความยืนยัน

คุณสามารถเข้าถึงเซกเมนต์ที่นำเข้ามาได้ใน Pushwoosh เมื่อการนำเข้าเสร็จสมบูรณ์ เซกเมนต์เหล่านั้นจะปรากฏในส่วน Audience > Segments ของบัญชี Pushwoosh ของคุณ

หากลูกค้าต้องการสะสมข้อมูลการวิเคราะห์จากทั้ง Pushwoosh SDK และ Piano Analytics SDK ทาง Pushwoosh จำเป็นต้องจับคู่ Piano VisitorID กับ Pushwoosh UserID/HWID วิธีการคือการส่งแท็ก Piano VisitorID ไปยัง Pushwoosh สำหรับผู้ใช้/อุปกรณ์นั้น

สำหรับสิ่งนี้ ให้ทำดังต่อไปนี้:

1. สร้างแท็กชื่อ ‘Piano Visitor ID’ ในฝั่ง Pushwoosh สำหรับแอปพลิเคชัน หมายเหตุ: ชื่อแท็กต้องตรงตามที่ระบุไว้ทุกประการ
2. ในฝั่งแอปพลิเคชันของลูกค้า ให้รับ Piano Visitor ID ภายใน Piano SDK โดยใช้เมธอด getVisitorId
3. ในฝั่งแอปพลิเคชันของลูกค้า ให้ใช้ Pushwoosh SDK เพื่อเรียกใช้คำขอ setTags พร้อมค่าแท็กหนึ่งครั้ง

หากค่าแท็ก (Piano Visitor ID) มีอยู่สำหรับผู้ใช้/อุปกรณ์ Pushwoosh จะรวมค่านั้นเป็น Client ID ในคำขอที่ส่งไปยัง Piano Analytics โดยอัตโนมัติ ในฝั่งของ Piano Analytics ค่านี้จะถูกแปลงเป็นค่า visitor ID ที่ไม่ซ้ำกัน

Pushwoosh.push(function(api) {
// Set tags for a user
api.setTags({
'Piano Visitor ID': pa.getVisitorID(),
});

String value1 = PianoAnalytics.getInstance().visitorId();
TagsBundle pianoTag = new TagsBundle.Builder()
    .putString("Piano Visitor ID", value1)
    .build();
Pushwoosh.getInstance().setTags(pianoTag);

var pianoId: String = pa.getVisitorId(completionHandler: { visitorId in
Pushwoosh.sharedInstance().setTags([
 "Piano Visitor ID": visitorId
 ])
})

__block NSString *pianoId;
[pa getVisitorIdWithCompletionHandler:^(NSString *visitorId) {
    Piano Visitor ID = visitorId;
    [[Pushwoosh sharedInstance] setTags:@{@"Piano Visitor ID": visitorId}];
}];

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

• Country
• Device Model
• OS Version
• Browser Type (ในบางกรณี)

มีสองวิธีง่ายๆ ในการตรวจจับอีเวนต์ที่ถูกส่งไปยัง Piano Analytics:

1. ไปที่บัญชี Piano Analytics ของคุณ
2. ไปที่ Settings -> Data Collection Portal -> Tools -> Stream Inspector
3. เลือกไซต์ที่เชื่อมต่อที่คุณต้องการตรวจสอบ
4. เลือกอีเวนต์ที่คุณต้องการตรวจสอบและเริ่มเซสชัน
5. ตรวจสอบว่า Piano Analytics ได้รับอีเวนต์แล้ว

1. ไปที่บัญชี Piano Analytics ของคุณ
2. ไปที่ Settings -> Explorer -> Audience -> Overall Traffic
3. เลือกไซต์และช่วงวันที่ในเมนูด้านล่าง

เพื่อตรวจสอบการผสานการทำงานในฝั่งปลายทาง:

• นำเข้าเซกเมนต์ของ Piano
• คุณควรจะเห็นเซกเมนต์ใหม่ (ตัวกรอง) ที่มีชื่อสร้างขึ้นในรูปแบบ segment_key (Piano Autogenerated)
• คำนวณเซกเมนต์ใหม่เพื่อรับข้อมูลล่าสุดเกี่ยวกับอุปกรณ์ปัจจุบันที่กำลังประมวลผล

วิธีแก้ไข: ใช้ Stream Inspector ของ Piano หรือตรวจสอบ Overall Traffic ใน Piano Analytics เพื่อตรวจสอบอีเวนต์ที่เข้ามาจาก Pushwoosh

วิธีแก้ไข: ตรวจสอบให้แน่ใจว่า Segment Key จาก Piano ตรงกับการตั้งค่าใน Pushwoosh ตรวจสอบข้อผิดพลาดในการคำนวณขนาดเซกเมนต์หรือการดึงข้อมูล

วิธีแก้ไข: ได้ โดยการตั้งค่าแท็กเฉพาะใน Pushwoosh และใช้ SDK ของ Piano เพื่อดึง VisitorID คุณสามารถซิงโครไนซ์ ID ผู้ใช้ระหว่างแพลตฟอร์มได้

วิธีแก้ไข: ตรวจสอบบันทึกคำขอ API ตรวจสอบให้แน่ใจว่า URL ปลายทางและโทเค็นการรับรองความถูกต้อง (คีย์ API) ถูกต้อง และตรวจสอบข้อผิดพลาดฝั่งเซิร์ฟเวอร์ที่รายงานโดยบริการใดบริการหนึ่ง