การผสานรวมกับ Piano Analytics

ต้องการความช่วยเหลือจากนักพัฒนา

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

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

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

ภาพรวมการผสานรวม

ประเภทการผสานรวม

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

ข้อกำหนดเบื้องต้น

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

อภิธานศัพท์ (การจับคู่ชื่อเอนทิตีหากแตกต่างกัน)

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

Pushwoosh	Piano Analytics
UserID/hwid	visitorID
PostEvent.EventName	PianoEvent.Name
PostEvent.UserID	PianoEvent.PushwooshID
PostEvent.CampaignID	PianoEvent.SrcMedium
PostEvent.PlatformID	PianoEvent.DeviceType

เอนทิตีที่ซิงโครไนซ์

Source

• Events
• Push Stats
• Tags (เป็นแอตทริบิวต์ของอีเวนต์)

Destination

• Segments

กรณีการใช้งาน

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

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

การแบ่งกลุ่ม (Segmentation)

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

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

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

การผสานรวมทำงานอย่างไร?

ภาพรวมขั้นตอน

1. การตั้งค่า: กำหนดการตั้งค่าการผสานรวมทั้งในบัญชี Pushwoosh และ Piano Analytics
2. การจับคู่อีเวนต์: จับคู่อีเวนต์ของ Pushwoosh กับอีเวนต์ของ Piano (เช่น PostEvent.EventName กับ PianoEvent.Name)
3. การถ่ายโอนข้อมูล: Pushwoosh ส่งอีเวนต์ (Post Events และ Tracking Log Events) ไปยัง Piano Analytics
4. การนำเข้าเซกเมนต์: 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 คัดลอก Collection Domain ID ตรวจสอบให้แน่ใจว่าคุณป้อน collection domain ในรูปแบบ ****.pa-cd.com โดยไม่มีคำนำหน้า https://

3. Piano API Access และ Secret keys

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

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

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

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

ข้อควรระวัง

เพื่อความปลอดภัย Secret Key จะแสดงเพียงครั้งเดียวเท่านั้น โปรดตรวจสอบให้แน่ใจว่าคุณได้บันทึกคีย์ทั้งสองไว้ในที่ปลอดภัยก่อนดำเนินการต่อ

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

การสร้างอีเวนต์ใน Piano เพื่อให้ตรงกับอีเวนต์ของ Pushwoosh

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

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

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

หมายเหตุ

การตั้งชื่ออีเวนต์ไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก หากคุณสร้างชื่ออีเวนต์เป็นตัวพิมพ์ใหญ่ใน Pushwoosh เช่น PW_SiteOpened มันจะตรงกับอีเวนต์ pw_siteopened ใน Piano

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

การตั้งค่าเขตเวลาของเว็บไซต์ของคุณใน Piano

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

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

การสร้าง property สำหรับระบุอีเวนต์ที่ส่งจาก Pushwoosh ใน Piano

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

นี่คือวิธีการสร้าง property:

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

การตรวจสอบว่าอีเวนต์ของ Pushwoosh ถูกส่งไปยัง Piano หรือไม่

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

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

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

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

การสร้างเซกเมนต์ใน Piano

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

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

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

การส่งเซกเมนต์จาก Piano ไปยัง Pushwoosh

หมายเหตุ

โปรดทราบว่าเฉพาะเจ้าของบัญชี (Account Owners) เท่านั้นที่สามารถนำเข้าเซกเมนต์ได้

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

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

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

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

การจับคู่ Piano VisitorID กับ Pushwoosh UserID/HWID สำหรับการวิเคราะห์สะสมข้าม SDK

หากลูกค้าต้องการสะสมการวิเคราะห์จากทั้ง 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 ที่ไม่ซ้ำกัน

ตัวอย่างโค้ด

Web Push SDK (JavaScript)

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

Android (Java)

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

iOS (Swift)

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

iOS (Objective-C)

__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 (ในบางกรณี)

วิธีตรวจสอบว่าการผสานรวมทำงานอยู่

Source: การตรวจจับอีเวนต์ที่ส่งไปยัง Piano Analytics

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

Stream Inspector

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

ตรวจสอบอีเวนต์ใน Overall Traffic

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

Destination: การนำเข้าเซกเมนต์ของ Piano

เพื่อตรวจสอบการผสานรวมทางฝั่ง destination:

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

การแก้ไขปัญหา FAQ: ปัญหาที่พบบ่อย

ฉันจะแน่ใจได้อย่างไรว่าอีเวนต์ถูกส่งจาก Pushwoosh ไปยัง Piano Analytics อย่างถูกต้อง?

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

ฉันควรทำอย่างไรหากข้อมูลเซกเมนต์ไม่ถูกนำเข้าสู่ Pushwoosh อย่างถูกต้อง?

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

ฉันสามารถผสานรวม Piano VisitorID กับ Pushwoosh เพื่อการวิเคราะห์ที่ดียิ่งขึ้นได้หรือไม่?

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

ฉันควรทำอย่างไรหากมีปัญหากับการกำหนดค่า API key?

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