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

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

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

ส่ง user ID เดียวกันไปยัง Google Analytics 4 และ Pushwoosh แล้วทั้งสองเครื่องมือจะถือว่าบุคคลที่เข้าชมเว็บไซต์หรือแอปของคุณเป็นผู้ใช้คนเดียวกัน จากนั้นคุณจะส่งข้อความถึงผู้ใช้ที่คุณวิเคราะห์ใน Google Analytics ได้ และสร้างเซกเมนต์ของ Pushwoosh จากข้อมูล Google Analytics ได้

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

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

ปลายทาง: กลุ่มเป้าหมายของ Google Analytics และข้อมูลที่ Google Analytics ส่งออกไปยัง BigQuery จะกลายเป็นเซกเมนต์ของ Pushwoosh โดย user ID จะถูกส่งจากเว็บไซต์หรือแอปของคุณไปยังแต่ละเครื่องมือแยกกัน Pushwoosh ไม่ส่งข้อมูลไปยัง Google Analytics

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

• บัญชี Pushwoosh และ Pushwoosh SDK (Web, Android หรือ iOS) บนเว็บไซต์หรือในแอปที่คุณใช้ส่ง user ID
• พร็อพเพอร์ตี Google Analytics 4 ที่เก็บข้อมูลจากเว็บไซต์หรือแอปเดียวกัน

หากต้องการนำเข้ากลุ่มเป้าหมายของ Google Analytics คุณต้องมีสิ่งต่อไปนี้ด้วย:

• service account ของ Google Cloud และคีย์ JSON ของบัญชีนั้น ดู Create and delete service account keys
• Google Analytics Data API และ Admin API ที่เปิดใช้งานในโปรเจกต์ของ service account นั้น
• บทบาท Viewer ของ service account บนพร็อพเพอร์ตี Google Analytics ดู Add, edit, and delete users and user groups

หากต้องการคิวรีข้อมูลที่ส่งออกไปยัง BigQuery คุณต้องมีสิ่งต่อไปนี้ด้วย:

• พร็อพเพอร์ตี Google Analytics 4 ที่ลิงก์กับ BigQuery แล้ว ดู Set up BigQuery Export
• คีย์ของ service account ที่มีบทบาท BigQuery Data Viewer และ BigQuery Job User ดู BigQuery roles and permissions

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

Pushwoosh จับคู่ผู้ใช้ด้วย ID ของผู้ใช้:

1. เว็บไซต์หรือแอปของคุณส่ง user ID เดียวกันไปยัง Google Analytics และ Pushwoosh
2. Pushwoosh อ่าน user ID จากกลุ่มเป้าหมายของ Google Analytics หรือจากข้อมูลที่ส่งออกไปยัง BigQuery ของคุณ
3. ผู้ใช้จะเข้าสู่เซกเมนต์เมื่อ ID ของผู้ใช้ตรงกับ Pushwoosh User ID

เซกเมนต์จะรีเฟรชแตกต่างกันไปตามแหล่งข้อมูล:

• เซกเมนต์จากกลุ่มเป้าหมายจะรีเฟรชประมาณวันละครั้งในขณะที่คุณใช้งานอยู่
• เซกเมนต์จาก BigQuery จะแสดงกิจกรรมจนถึงวันก่อนหน้า

การตั้งค่าการผสานรวม

การตั้งค่ามีสองส่วน ส่วนแรก นักพัฒนาของคุณส่ง user ID จากเว็บไซต์หรือแอปของคุณ จากนั้นคุณสร้างเซกเมนต์จากข้อมูล Google Analytics ใน Control Panel

1. เลือก user ID ร่วมกับนักพัฒนาของคุณ
2. นักพัฒนาของคุณส่ง ID นั้นไปยัง Google Analytics และ Pushwoosh จากเว็บไซต์หรือแอปมือถือของคุณ
3. หากต้องการ ให้สร้างเซกเมนต์ของ Pushwooshจากข้อมูล Google Analytics จากนั้นคุณสามารถใช้เซกเมนต์นั้นได้เหมือนเซกเมนต์อื่นๆ

ส่ง user ID ไปยัง Google Analytics และ Pushwoosh

นักพัฒนาของคุณเป็นผู้ทำส่วนนี้ โปรดแชร์ส่วนต่างๆ ด้านล่างกับพวกเขา

เลือก user ID

ใช้ตัวระบุที่ระบบของคุณเองมีอยู่แล้วสำหรับผู้ใช้แต่ละราย เช่น ID บัญชีจากฐานข้อมูลของคุณ ค่าเดียวกันนี้จะถูกส่งไปยัง Google Analytics เป็น user ID และส่งไปยัง Pushwoosh เป็น User ID

อย่าใช้ข้อมูลส่วนบุคคลใน user ID

นโยบายของ Google Analyticsไม่อนุญาตให้มีข้อมูลส่วนบุคคลใน user ID อย่าใช้ที่อยู่อีเมล หมายเลขโทรศัพท์ หรือข้อมูลส่วนบุคคลอื่นๆ

ตั้งค่า ID ในขณะที่ผู้ใช้เข้าสู่ระบบหรือถูกระบุตัวตนด้วยวิธีอื่น

ส่ง user ID จากเว็บไซต์ของคุณ

ส่ง ID ไปยัง Google Analytics ในพารามิเตอร์ user_id ของแท็ก Google หากคุณใช้ Google Tag Manager ให้ตั้งค่าฟิลด์ user_id ในการกำหนดค่าแท็ก Google แทน ดู Send user IDs ในเอกสารประกอบของ Google

JavaScript

gtag('config', 'G-XXXXXXXXXX', {
  'user_id': 'USER_ID'
});

ส่ง ID เดียวกันไปยัง Pushwoosh ด้วย Web Push SDK:

JavaScript

Pushwoosh.push((api) => {
  api.registerUser('USER_ID');
});

ส่ง user ID จากแอปมือถือของคุณ

แอปมือถือส่งข้อมูลไปยัง Google Analytics 4 ผ่าน Firebase ตั้งค่า ID ด้วย setUserId ของ Firebase Analytics (ดู Set a user ID ในเอกสารประกอบของ Firebase) และตั้งค่าเดียวกันด้วย Pushwoosh SDK

Android

Java

FirebaseAnalytics.getInstance(context).setUserId("USER_ID");
Pushwoosh.getInstance().setUserId("USER_ID");

iOS

Swift

Analytics.setUserID("USER_ID")
Pushwoosh.sharedInstance().setUserId("USER_ID")

สร้างเซกเมนต์จากข้อมูล Google Analytics

คุณทำส่วนนี้ใน Control Panel หลังจากที่นักพัฒนาของคุณส่ง user ID แล้ว Pushwoosh สามารถเปลี่ยนข้อมูล Google Analytics ให้เป็นเซกเมนต์ได้สองวิธี ซึ่งทั้งสองวิธีทำผ่านเซกเมนต์ภายนอก:

• นำเข้ากลุ่มเป้าหมายของ Google Analytics: เลือกกลุ่มเป้าหมายที่คุณสร้างไว้แล้วใน Google Analytics ไม่ต้องใช้ SQL และไม่ต้องใช้ BigQuery
• คิวรีข้อมูลที่ส่งออกไปยัง BigQuery: เขียน SQL ของคุณเองบนอีเวนต์ดิบที่ Google Analytics ส่งออกไปยัง BigQuery สำหรับเงื่อนไขที่กลุ่มเป้าหมายไม่สามารถแสดงได้

นำเข้ากลุ่มเป้าหมายของ Google Analytics

ขอให้นักพัฒนาหรือผู้ดูแลระบบ Google Cloud ของคุณทำขั้นตอนต่อไปนี้ใน Google Cloud และ Google Analytics:

1. เตรียม service account และคีย์ JSON ของบัญชีนั้น ดู Create and delete service account keys ในเอกสารประกอบของ Google Cloud
2. ในโปรเจกต์ Google Cloud ของ service account ให้เปิดใช้งาน Google Analytics Data API และ Google Analytics Admin API
3. ใน Google Analytics ไปที่ Admin → Property access management แล้วเพิ่มอีเมลของ service account ด้วยบทบาท Viewer บทบาทที่มอบใน Google Cloud IAM ไม่ได้ให้สิทธิ์เข้าถึง Google Analytics

จากนั้นทำขั้นตอนต่อไปนี้ใน Control Panel:

1. สร้างเซกเมนต์ภายนอกโดยตั้งค่า ประเภทฐานข้อมูล เป็น Google Analytics 4 audience

2. ป้อน รหัสพร็อพเพอร์ตี GA4 คุณสามารถค้นหาได้ใน Google Analytics ภายใต้ Admin → Property details

3. วางคีย์ JSON จากรายการแรกลงใน Service account JSON

4. คลิก โหลดกลุ่มเป้าหมาย แล้วเลือก กลุ่มเป้าหมาย

   

5. คลิก ตรวจสอบการเชื่อมต่อ

6. คลิก สร้าง

Pushwoosh จะรีเฟรชเซกเมนต์เมื่ออ่านเซกเมนต์ทั้งหมด เช่น เมื่อคุณส่งแคมเปญหรือ Journey ไปยังเซกเมนต์นั้น หรือเมื่อคำนวณขนาดของเซกเมนต์:

• หากข้อมูลมีอายุน้อยกว่า 24 ชั่วโมง Pushwoosh จะใช้ข้อมูลนั้นตามเดิม เนื่องจาก Google Analytics อัปเดตสมาชิกของกลุ่มเป้าหมายประมาณวันละครั้ง
• หากข้อมูลมีอายุมากกว่า 24 ชั่วโมง Pushwoosh จะใช้ข้อมูลปัจจุบันและรีเฟรชเซกเมนต์ในเบื้องหลัง
• หากข้อมูลมีอายุมากกว่า 72 ชั่วโมง Pushwoosh จะรอให้การรีเฟรชเสร็จสิ้น

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

คิวรีข้อมูลที่ส่งออกไปยัง BigQuery

หากคุณส่งออกข้อมูล Google Analytics 4 ไปยัง BigQuery คุณสามารถเลือกผู้ใช้ด้วยเงื่อนไข SQL ใดก็ได้บนอีเวนต์ของผู้ใช้ เช่น ทุกคนที่ซื้อสินค้าในช่วง 30 วันที่ผ่านมา

ขอให้นักพัฒนาหรือผู้ดูแลระบบ Google Cloud ของคุณทำขั้นตอนต่อไปนี้ใน Google Cloud และ Google Analytics:

1. ลิงก์พร็อพเพอร์ตี Google Analytics 4 ของคุณกับโปรเจกต์ BigQuery และเปิดการส่งออกรายวัน ทำตาม Set up BigQuery Export ในเอกสารประกอบของ Google

   จากนั้น Google Analytics จะเขียนอีเวนต์ของแต่ละวันลงในตารางชื่อ events_YYYYMMDD ในชุดข้อมูลชื่อ analytics_<property ID> โดย user ID ที่คุณส่งในส่วนก่อนหน้าจะอยู่ในคอลัมน์ user_id

2. สร้างคีย์ของ service account ที่มีบทบาท BigQuery Data Viewer และ BigQuery Job User ทั้ง ตรวจสอบการเชื่อมต่อ และ ตรวจสอบคำสั่ง จะรันงาน query ทดสอบในโปรเจกต์ของคุณ จึงล้มเหลวหากไม่มี BigQuery Job User

จากนั้นใน Control Panel ให้สร้างเซกเมนต์ภายนอกโดยตั้งค่า ประเภทฐานข้อมูล เป็น Google BigQuery ป้อนคีย์ของ service account สำหรับการเชื่อมต่อ และ query ที่ส่งคืน user ID ของผู้ใช้ที่คุณต้องการ

ตัวอย่างเช่น query นี้ส่งคืนผู้ใช้ที่ซื้อสินค้าในช่วง 30 วันที่ผ่านมา แทนที่ my-project ด้วย ID โปรเจกต์ Google Cloud ของคุณ และแทนที่ analytics_123456789 ด้วยชื่อชุดข้อมูลของคุณ:

SQL

SELECT DISTINCT user_id
FROM `my-project.analytics_123456789.events_*`
WHERE event_name = 'purchase'
  AND user_id IS NOT NULL
  AND _TABLE_SUFFIX >= FORMAT_DATE('%Y%m%d', DATE_SUB(CURRENT_DATE(), INTERVAL 30 DAY))

เซกเมนต์จะแสดงกิจกรรมจนถึงวันก่อนหน้า เนื่องจาก Google Analytics ส่งออกข้อมูลวันละครั้ง

คุณจะทราบได้อย่างไรว่าการผสานรวมทำงานอยู่

• User ID: ใน Pushwoosh ไปที่ กลุ่มเป้าหมาย → User Explorer แล้วค้นหาด้วย User IDสำหรับ ID ที่คุณส่งไปยัง Google Analytics หากพบผู้ใช้ แสดงว่าทั้งสองเครื่องมือมี ID เดียวกัน
• เซกเมนต์: ใน กลุ่มเป้าหมาย → เซกเมนต์ภายนอก สถานะของเซกเมนต์คือ ใช้งานได้ หากต้องการดูจำนวนผู้ใช้ที่ตรงกัน ให้ตรวจสอบขนาดเซกเมนต์

การแก้ไขปัญหา

โหลดกลุ่มเป้าหมายหรือตรวจสอบการเชื่อมต่อแสดงข้อผิดพลาด

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

• Service account JSON เป็นคีย์ของ service account ไฟล์ข้อมูลประจำตัวอื่นๆ ของ Google จะถูกปฏิเสธ
• รหัสพร็อพเพอร์ตี GA4 เป็นหมายเลขจาก Admin → Property details
• service account มีบทบาท Viewer ใน Google Analytics ที่ Admin → Property access management บทบาทที่มอบใน Google Cloud IAM ไม่นับ
• เปิดใช้งาน Google Analytics Admin API ในโปรเจกต์ Google Cloud ของ service account แล้ว

รายการกลุ่มเป้าหมายว่างเปล่า

พร็อพเพอร์ตียังไม่มีกลุ่มเป้าหมาย สร้างกลุ่มเป้าหมายใน Google Analytics ภายใต้ Admin → Audiences แล้วคลิก โหลดกลุ่มเป้าหมาย อีกครั้ง

ไม่มีใครเข้าสู่เซกเมนต์

• ตรวจสอบให้แน่ใจว่าได้เปิดใช้งาน Google Analytics Data API แล้ว ตรวจสอบการเชื่อมต่อ ไม่ได้ทดสอบ API นี้ แต่ Pushwoosh ต้องใช้ API นี้เพื่ออ่านสมาชิกของกลุ่มเป้าหมาย
• ตรวจสอบให้แน่ใจว่าเว็บไซต์หรือแอปของคุณส่ง user ID เดียวกันไปยัง Google Analytics และ Pushwoosh เฉพาะผู้ใช้ที่มี user ID ใน Google Analytics ตรงกับ Pushwoosh User ID เท่านั้นที่จะเข้าสู่เซกเมนต์ ผู้ใช้ที่ Google Analytics รู้จักเพียงจาก client ID แบบไม่ระบุตัวตนจะไม่เข้าสู่เซกเมนต์

ตรวจสอบการเชื่อมต่อหรือตรวจสอบคำสั่งล้มเหลวสำหรับ BigQuery

การตรวจสอบทั้งสองจะรันงาน query ทดสอบในโปรเจกต์ Google Cloud ของคุณโดยไม่อ่านข้อมูลใดๆ ตรวจสอบว่า:

• service account มีทั้งบทบาท BigQuery Data Viewer และ BigQuery Job User หากไม่มี BigQuery Job User การตรวจสอบทั้งสองจะรันไม่ได้
• query ใช้ ID โปรเจกต์ของคุณและชื่อชุดข้อมูล analytics_<property ID> และการส่งออกได้เขียนตาราง events_YYYYMMDD รายวันไว้แล้วอย่างน้อยหนึ่งตาราง
• query ส่งคืนคอลัมน์เดียวพอดี ชื่อ user_id