การติดแท็กฝั่งเซิร์ฟเวอร์สําหรับแอปบนอุปกรณ์เคลื่อนที่

คุณสามารถกําหนดค่าแอปบนอุปกรณ์เคลื่อนที่โดยใช้ SDK ของ Google Analytics สําหรับ Firebase เพื่อทํางานร่วมกับการติดแท็กฝั่งเซิร์ฟเวอร์ใน Google Tag Manager

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

วิธีตั้งค่าการติดแท็กฝั่งเซิร์ฟเวอร์สำหรับแอปบนอุปกรณ์เคลื่อนที่

1. เตรียมแอปให้พร้อมสําหรับการติดแท็กฝั่งเซิร์ฟเวอร์
2. กำหนดค่าคอนเทนเนอร์เซิร์ฟเวอร์ให้รองรับการรับส่งข้อมูลบนอุปกรณ์เคลื่อนที่
3. เปิดใช้การติดแท็กฝั่งเซิร์ฟเวอร์ในพร็อพเพอร์ตี้ GA4

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

• คุณต้องใส่ SDK ของ Google Analytics สําหรับ Firebase ในแอปและเชื่อมต่อกับพร็อพเพอร์ตี้ Google Analytics 4 ดูข้อมูลเพิ่มเติมเกี่ยวกับ SDK ของ Google Analytics สําหรับ Firebase
• คุณต้องมีบัญชี Google Tag Manager และคอนเทนเนอร์เซิร์ฟเวอร์ หากยังไม่มี ให้สร้างบัญชีและคอนเทนเนอร์ Tag Manager ใหม่
• คุณต้องตั้งค่าเซิร์ฟเวอร์การติดแท็ก

ขั้นตอนที่ 1: ทําให้แอปพร้อมสําหรับการติดแท็กฝั่งเซิร์ฟเวอร์

iOS

1. เปิดใช้ฟีเจอร์การอัปโหลดการติดแท็กฝั่งเซิร์ฟเวอร์และตั้งค่ารูปแบบ URL ที่กำหนดเองสำหรับโหมดแก้ไขข้อบกพร่องของการติดแท็กฝั่งเซิร์ฟเวอร์ในไฟล์ Info.plist แทนที่ BUNDLE_ID ในรายการต่อไปนี้ด้วยตัวระบุชุดของแอป

   <?xml version="1.0" encoding="UTF-8"?>
   <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
   <plist version="1.0">
   <dict>
   ...
           <key>CFBundleURLTypes</key>
           <array>
                   <dict>
                           <key>CFBundleTypeRole</key>
                           <string>None</string>
                           <key>CFBundleURLName</key>
                           <string>BUNDLE_ID</string>
                           <key>CFBundleURLSchemes</key>
                           <array>
                                   <string>tagmanager.sgtm.c.BUNDLE_ID</string>
                           </array>
                   </dict>
           </array>
           <key>GOOGLE_ANALYTICS_SGTM_UPLOAD_ENABLED</key>
           <true/>
   </dict>
   </plist>
   

2. หากต้องการเปิดใช้โหมดแก้ไขข้อบกพร่องหรือโหมดแสดงตัวอย่าง ให้เพิ่มการเรียกใช้ Analytics.handleOpen(_:) ในเมธอดวงจรเพื่อส่ง URL การเปิดตัว

   SwiftUI

   @main
   struct MyApplication: App {
     var body: some Scene {
       WindowGroup {
         ContentView()
           .onOpenURL { url in
             Analytics.handleOpen(url)
           }
       }
     }
   }
   

   UIScene

   class SceneDelegate: UIResponder, UIWindowSceneDelegate {
   func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
           options connectionOptions: UIScene.ConnectionOptions) {
   ...
       if let urlContext = connectionOptions.urlContexts.first {
           let url = urlContext.url
           Analytics.handleOpen(url)
       }
     }
   }
   

   สำหรับแอปที่ไม่ได้ใช้ SwiftUI หรือ UIScene คุณไม่ต้องดำเนินการใดๆ SDK ได้รับ URL การเปิดตัวจาก ApplicationDidFinishLaunchingNotification

Android

1. ติดตั้ง รุ่นล่าสุดของ SDK ของ Google Analytics สําหรับ Firebase

2. เปิดใช้ sGTM ด้วยการเพิ่มค่าต่อไปนี้ลงในไฟล์ AndroidManifest.xml ของแอปพลิเคชัน

   <!-- Preview Activity to enable preview mode –->
     <activity
         android:name="com.google.firebase.analytics.GoogleAnalyticsServerPreviewActivity"
         android:exported="true"
         android:noHistory="true" >
       <intent-filter>
         <action android:name="android.intent.action.VIEW" />
         <category android:name="android.intent.category.DEFAULT" />
         <category android:name="android.intent.category.BROWSABLE" />
         <data android:scheme="tagmanager.sgtm.c.<APP_PACKAGE_ID>" />
       </intent-filter>
     </activity>
   
   <!-- Meta-data that enables uploads to sGTM –->
     <meta-data android:name="google_analytics_sgtm_upload_enabled" android:value="true" />
   

ขั้นตอนที่ 2: กําหนดค่าคอนเทนเนอร์ของเซิร์ฟเวอร์ให้รองรับการรับส่งข้อมูลบนอุปกรณ์เคลื่อนที่

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

ตั้งค่าไคลเอ็นต์ Google Analytics: GA4 (แอป)

ไคลเอ็นต์เป็นทรัพยากรประเภท Tag Manager ที่สกัดกั้นคำขอขาเข้าบางประเภทและสร้างเหตุการณ์ที่ส่งไปยังปลายทางได้ เช่น Google Analytics 4 ในกรณีนี้ คําขอ HTTP คือเหตุการณ์ Google Analytics 4 คุณจึงต้องกําหนดค่าไคลเอ็นต์ Google Analytics: GA4 (แอป) ในตัว คุณต้องใช้ไคลเอ็นต์ GA4 เพียง 1 รายการต่อแหล่งข้อมูล เช่น GA SDK และเว็บไซต์ ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีทํางานของไคลเอ็นต์

1. ในคอนเทนเนอร์เซิร์ฟเวอร์ ให้ไปที่ไคลเอ็นต์ แล้วคลิกใหม่

2. คลิกการกําหนดค่าไคลเอ็นต์ แล้วเลือก Google Analytics: GA4 (แอป)

   

3. ป้อนชื่อลูกค้าแล้วคลิกบันทึก

กำหนดค่า Google Analytics: แท็ก GA4

หากต้องการส่งข้อมูลไปยัง Google Analytics คุณจะต้องสร้างแท็ก Google Analytics: GA4 ในคอนเทนเนอร์ของเซิร์ฟเวอร์ ไคลเอ็นต์จะแยกวิเคราะห์คําขอ HTTP ขาเข้าให้เป็นออบเจ็กต์ข้อมูลเหตุการณ์ แท็กจะนำออบเจ็กต์ข้อมูลเหตุการณ์นี้ไปจับคู่กับรูปแบบที่ถูกต้อง แล้วส่งไปยัง Google Analytics 4

1. ในคอนเทนเนอร์ของเซิร์ฟเวอร์ ให้ไปที่แท็ก แล้วคลิกใหม่

2. คลิกการกําหนดค่าแท็ก แล้วเลือก Google Analytics: GA4

   

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

• หากคําขอ Google Analytics 4 ที่เข้ามาผ่านไคลเอ็นต์ Google Analytics: GA4 (แอป) แท็กจะรับค่าพารามิเตอร์รหัสแอปและเหตุการณ์
• หากคําขอ Google Analytics 4 ที่เข้ามาผ่านไคลเอ็นต์ Google Analytics: GA4 (เว็บ) แท็กจะรับค่ารหัสการวัดและพารามิเตอร์เหตุการณ์มา

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

ตั้งค่าทริกเกอร์สำหรับการเข้าชมบนอุปกรณ์เคลื่อนที่

จากนั้นคุณควรกำหนดว่าแท็ก GA4 ควรเริ่มทํางานเมื่อใด ไคลเอ็นต์ Google Analytics: GA4 (แอป) จะแยกวิเคราะห์คําขอขาเข้าให้เป็นออบเจ็กต์ข้อมูลเหตุการณ์ และแท็กจะรับค่านั้นมา ดังนั้น โดยทั่วไปแล้ว คุณจะต้องให้แท็กเริ่มทํางานทุกครั้งที่ไคลเอ็นต์ GA4 อ้างสิทธิ์ในคําขอ

วิธีตั้งค่าทริกเกอร์

1. ในการตั้งค่าแท็ก ให้คลิกการทริกเกอร์
2. หากต้องการสร้างทริกเกอร์ใหม่ ให้คลิกไอคอน + ที่มุมขวาบน
3. คลิกการกำหนดค่าทริกเกอร์เพื่อเลือกประเภททริกเกอร์

4. เลือกกําหนดเองหรือเหตุการณ์ที่กําหนดเองจากรายการ

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

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

   1. คุณจะเห็นชื่อเหตุการณ์ที่เลือกไว้ล่วงหน้า คลิกตัวเลือกนั้นแล้วเลือกเลือกตัวแปรในตัวจากรายการ
   2. หากต้องการแสดงชื่อไคลเอ็นต์ที่สร้างเหตุการณ์โดยอัตโนมัติ ให้เลือกชื่อไคลเอ็นต์

   3. ใช้ชื่อไคลเอ็นต์ที่คุณกําหนดค่าไว้ก่อนหน้านี้เพื่อตั้งค่าเงื่อนไข ทริกเกอร์ควรมีลักษณะดังนี้

      

      หมายเหตุ: ชื่อของลูกค้าคือชื่อที่คุณระบุไว้ในขั้นตอนก่อนหน้า ประเภทไคลเอ็นต์คือ Google Analytics: GA4 (แอป) ตัวแปรชื่อไคลเอ็นต์จะแสดงผลชื่อ ไม่ใช่ประเภทของไคลเอ็นต์

6. บันทึกทริกเกอร์และป้อนชื่อที่สื่อความหมาย ตัวอย่างเช่น คุณสามารถใช้ "เหตุการณ์แอป GA4 ทั้งหมด"

7. ตอนนี้คุณควรกลับไปที่การตั้งค่าแท็กที่มีทริกเกอร์ใหม่แล้ว บันทึกแท็กและป้อนชื่อที่สื่อความหมาย เช่น "GA4" แท็กควรมีลักษณะดังนี้

   

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

แสดงตัวอย่างคอนเทนเนอร์

คุณสามารถใช้ Google Tag Manager เพื่อแสดงตัวอย่างและแก้ไขข้อบกพร่องของคอนเทนเนอร์ของเซิร์ฟเวอร์ก่อนเผยแพร่การเปลี่ยนแปลงได้ โปรดทราบว่าการดูตัวอย่างจะไม่ทำงานจนกว่าคุณจะเปิดใช้การติดแท็กฝั่งเซิร์ฟเวอร์ในพร็อพเพอร์ตี้ GA4

หากต้องการให้คำขอของแอปทริกเกอร์การกำหนดค่าการแสดงตัวอย่าง คุณต้องทำดังนี้

1. เลือกแสดงตัวอย่างขณะที่อยู่ในคอนเทนเนอร์เซิร์ฟเวอร์ Google Tag Manager
2. คลิกไอคอนการดำเนินการเพิ่มเติม ⋮ ที่ด้านขวาบน แล้วเลือกส่งคำขอจากแอป

3. ป้อนรหัสแอปแล้วคลิกสร้างคิวอาร์โค้ด

   

4. สแกนคิวอาร์โค้ดด้วยแอปกล้องของโทรศัพท์ แล้วโต้ตอบกับแอปตามปกติเพื่อสร้างเหตุการณ์ตัวอย่าง

5. คลิกตกลงเพื่อปิดกล่องโต้ตอบ

นำคอนเทนเนอร์ไปใช้จริง

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

ขั้นตอนที่ 3: เปิดใช้การติดแท็กฝั่งเซิร์ฟเวอร์ในพร็อพเพอร์ตี้ GA4

1. ไปที่ผู้ดูแลระบบในพร็อพเพอร์ตี้ Google Analytics 4
2. เปิดสตรีมข้อมูล

3. เลือกการกําหนดค่าสตรีมของแอปพลิเคชันจากแท็บ iOS หรือ Android

   

4. คลิกกําหนดการตั้งค่า SDK แล้วคลิกกําหนดค่า Tag Manager ฝั่งเซิร์ฟเวอร์

   

5. วิธีเปิดใช้ SDK เพื่อส่งข้อมูลการวัดผลไปยัง URL ของคอนเทนเนอร์เซิร์ฟเวอร์

   1. สลับส่งข้อมูลไปยังคอนเทนเนอร์ Tag Manager ฝั่งเซิร์ฟเวอร์
   2. คัดลอก URL ของคอนเทนเนอร์เซิร์ฟเวอร์ คุณจะดูข้อมูลนี้ได้ใน Google Tag Manager โดยไปที่ผู้ดูแลระบบ > การตั้งค่าคอนเทนเนอร์ > URL ของคอนเทนเนอร์เซิร์ฟเวอร์

   3. เลือกเปอร์เซ็นต์ของการเข้าชมที่ต้องการกําหนดเส้นทางไปยังคอนเทนเนอร์เซิร์ฟเวอร์ คุณเลือกตัวเลือกที่น้อยกว่า 100% ได้เพื่อตรวจสอบการตั้งค่าและการกําหนดค่าเซิร์ฟเวอร์ก่อนใช้การติดแท็กฝั่งเซิร์ฟเวอร์สําหรับการเข้าชมทั้งหมด

      หมายเหตุ: ใช้ตัวเลือก "อุปกรณ์แก้ไขข้อบกพร่องเท่านั้น" เพื่อเปิดใช้เฉพาะแอปที่เปิดโดยใช้โหมดแสดงตัวอย่างเพื่อส่งข้อมูลไปยังเซิร์ฟเวอร์

   

6. คลิกบันทึก SDK จะดึงข้อมูล URL ของคอนเทนเนอร์เซิร์ฟเวอร์ที่อัปเดตแล้วและส่งข้อมูลการวัดผลไปยัง URL ดังกล่าว

ข้อจำกัดที่ทราบ

• สำหรับแอปพลิเคชัน Android

  • เหตุการณ์จะผ่านพร็อกซีเซิร์ฟเวอร์แบบไม่เก็บสถานะที่อยู่ระหว่าง SDK กับคอนเทนเนอร์ของเซิร์ฟเวอร์เพื่อหลีกเลี่ยงช่องโหว่ด้านความปลอดภัยที่อาจเกิดขึ้นได้ซึ่งเกี่ยวข้องกับคอนเทนเนอร์เซิร์ฟเวอร์และบริการ Google Play พร็อกซีนี้จะตรวจสอบแหล่งที่มาและปลายทางของคำขอ แต่จะไม่ตรวจสอบหรือจัดเก็บข้อมูลเกี่ยวกับเหตุการณ์ พร็อกซีจะอยู่ในสหภาพยุโรปสําหรับการเข้าชมในสหภาพยุโรป เพื่อให้สอดคล้องกับวิธีที่ GA4 รวบรวมข้อมูลจากอุปกรณ์ในสหภาพยุโรป
  • การซื้อในแอปที่บันทึกโดยอัตโนมัติจะอาศัยการผสานรวมกับแบ็กเอนด์ของ Google Play และจะไม่ส่งไปยังคอนเทนเนอร์เซิร์ฟเวอร์
  • ระบบจะไม่รายงานกิจกรรม app_remove ใน Android

• คุณยังคงต้องเชื่อมต่อสตรีมข้อมูลแอปใน Google Analytics กับบัญชี Google Ads เพื่อให้ระบบนําเข้าข้อมูล SDK และ Conversion ไปยัง Google Ads การติดแท็กฝั่งเซิร์ฟเวอร์ไม่มีการผสานรวม SDK กับ Google Ads โดยพื้นฐาน

API

คุณสามารถใช้ Tag Manager REST API เพื่อเข้าถึงข้อมูลการกําหนดค่า Tag Manager ได้ ดูข้อมูลเพิ่มเติมเกี่ยวกับ API

• โปรดดูวิธีใช้ API ในคู่มือสําหรับนักพัฒนาซอฟต์แวร์
• อ่านข้อมูลอ้างอิงเกี่ยวกับ Tag Manager API เพื่อทําความคุ้นเคยกับแหล่งข้อมูลและการดำเนินการที่มีให้ของ Tag Manager