Google Ads ที่มีเหตุการณ์ที่กําหนดเองของ Google Analytics สําหรับ Firebase - Unity
เกี่ยวกับ Codelab นี้
1 บทนำ
อัปเดตล่าสุด 19-02-2021
สิ่งที่คุณจะสร้าง
ใน Codelab นี้ คุณจะได้ทราบวิธีติดตั้งใช้งานเหตุการณ์ที่กำหนดเองด้วย GA4F iOS บนสภาพแวดล้อม Unity และเปิดตัวแคมเปญเพื่อกระตุ้นการกระทำผ่าน Google Ads
ตลอดทั้ง Codelab นี้ คุณจะได้สัมผัสกับกระบวนการทั้งหมดของธุรกิจแอปที่ลูกค้าของเรากำลังเผชิญ หากคุณต้องการทราบข้อมูลเบื้องต้นเกี่ยวกับ Firebase และ AdMob บน iOS อย่างนุ่มนวล ให้เริ่มจาก AdMob+Firebase 101 Unity: การตั้งค่าและข้อมูลพื้นฐานเกี่ยวกับ Analytics
สิ่งที่คุณจะได้เรียนรู้
- วิธีเริ่มต้น GA4F (Google Analytics สําหรับ Firebase) ใน Unity + iOS
- วิธีสร้างเหตุการณ์และพารามิเตอร์ที่กําหนดเอง
- วิธีนำเข้าเหตุการณ์จาก Firebase ไปยัง Google Ads
- เปิดตัวแคมเปญเพื่อกระตุ้นการกระทําด้วยเหตุการณ์ที่กําหนดเอง
สิ่งที่ต้องมี
- Xcode
- Unity
- บัญชี Firebase
- บัญชี Google Ads
2 เริ่มโปรเจ็กต์ Unity ใหม่
สร้างแอป Unity ที่ใช้เทมเพลตอย่างง่าย คุณสามารถแก้ไขแอปง่ายๆ นี้เพื่อสร้างแอปที่เสร็จสมบูรณ์
เปิด Unity
- หากไม่มีโปรเจ็กต์ที่เปิดอยู่ ให้เลือกสร้างโปรเจ็กต์ใหม่
- เลือกเทมเพลต 3 มิติจากกล่องโต้ตอบ
- กรอกชื่อโปรเจ็กต์ เช่น เหตุการณ์ที่กําหนดเองของ Unity Firebase
- เลือกตำแหน่งที่จะบันทึกโปรเจ็กต์ แล้วคลิกสร้าง
- Unity จะเปิดโปรเจ็กต์ใหม่ในหน้าต่างเวิร์กスペース
3 สร้างและตั้งค่าโปรเจ็กต์ Firebase
หากต้องการเริ่มต้นใช้งาน Firebase คุณจะต้องสร้างและตั้งค่าโปรเจ็กต์ Firebase
หากคุณมีโปรเจ็กต์ Firebase เดิมที่ไม่ได้เปิดใช้ Google Analytics คุณจะเปิดใช้ Google Analytics ได้จากแท็บการผสานรวมของการตั้งค่า > การตั้งค่าโปรเจ็กต์ ไปยังขั้นตอนการกำหนดค่า Firebase ต่อ
- ลงชื่อเข้าใช้ Firebase
ในคอนโซล Firebase ให้คลิก "เพิ่มโปรเจ็กต์" (หรือ "สร้างโปรเจ็กต์") แล้วตั้งชื่อโปรเจ็กต์ Firebase เป็น Firebase-iOS-Ads
- คลิกตัวเลือกการสร้างโปรเจ็กต์ ยอมรับข้อกำหนดของ Firebase หากได้รับข้อความแจ้ง คุณควรเปิดใช้ Google Analytics สำหรับโปรเจ็กต์นี้ เนื่องจากต้องมีเหตุการณ์ Google Analytics สำหรับติดตามเหตุการณ์การดำเนินการและ Conversion
ดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase ได้ที่ทําความเข้าใจโปรเจ็กต์ Firebase
4 การกำหนดค่า Unity
- ใน Unity > ไฟล์ > การตั้งค่าการสร้าง ค่าที่สำคัญคือการตั้งค่ารหัสชุด iOS ซึ่งคุณจะได้รับจากขั้นตอนต่อไปนี้
คุณจะเห็นกล่องโต้ตอบที่แสดงในหน้าจอต่อไปนี้
- ในโปรเจ็กต์ Unity สําหรับแอป iOS ให้เปิดกล่องโต้ตอบการตั้งค่าการสร้าง ไฟล์ > การตั้งค่าการสร้าง (หากไม่ได้ตั้งค่าแพลตฟอร์มเป็น iOS ให้เลือกแพลตฟอร์ม iOS แล้วคลิกปุ่มเปลี่ยนแพลตฟอร์ม)
- หลังจากเปลี่ยนแพลตฟอร์ม ให้คลิกปุ่ม "การตั้งค่าโปรแกรมเล่น" เพื่อตั้งค่ารหัสชุด คุณจะเห็นช่องข้อความรอบๆ พื้นที่การระบุ
- ค่าของช่องตัวระบุกลุ่มคือรหัสกลุ่ม iOS (เช่น
com.yourcompany.yourproject
) ให้คัดลอกค่านี้หรือตั้งค่าของคุณเองแล้วคัดลอก - ในกล่องโต้ตอบ Firebase ให้วางรหัสชุดที่คัดลอกลงในช่อง
iOS bundle ID
- คลิกลงทะเบียนแอป
- ดำเนินการต่อใน Firebase ทำตามวิธีการเพื่อดาวน์โหลดไฟล์การกำหนดค่า
GoogleService-Info.plist
- เปิดหน้าต่างโปรเจ็กต์ของโปรเจ็กต์ Unity จากนั้นย้ายไฟล์การกําหนดค่าไปยังโฟลเดอร์ Assets
- ข้ามขั้นตอนที่เหลือและกลับไปที่หน้าหลักของคอนโซล Firebase
5 กำหนดค่า Firebase Analytics ใน Unity
ในขั้นตอนนี้ คุณจะเริ่มเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Unity
- ไปที่คอนโซล Firebase
- ที่ตรงกลางของหน้าภาพรวมโปรเจ็กต์ ให้คลิกไอคอน Unity (
) เพื่อเปิดเวิร์กโฟลว์การตั้งค่า หากเพิ่มแอปลงในโปรเจ็กต์ Firebase อยู่แล้ว ให้คลิกเพิ่มแอปเพื่อแสดงตัวเลือกแพลตฟอร์ม
- เลือกเป้าหมายของบิลด์ในโปรเจ็กต์ Unity ที่ต้องการลงทะเบียน หรือจะเลือกลงทะเบียนทั้ง 2 เป้าหมายพร้อมกันเลยก็ได้
- ป้อนรหัสเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity
- สำหรับ iOS — ป้อนรหัส iOS ของโครงการ Unity ในช่องรหัสชุด iOS
- สำหรับ Android - ป้อนรหัส Android ของโปรเจ็กต์ Unity ในช่องชื่อแพ็กเกจ Android คำว่าชื่อแพ็กเกจและรหัสแอปพลิเคชันมักจะใช้แทนกันได้
- คุณดูรหัสของโปรเจ็กต์ Unity ได้จากที่ใด
- (ไม่บังคับ) ป้อนชื่อเล่นเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity โดยชื่อเล่นเหล่านี้เป็นตัวระบุภายในเพื่อความสะดวกและคุณจะเห็นชื่อเล่นดังกล่าวในคอนโซล Firebase เท่านั้น
- คลิกลงทะเบียนแอป
เพิ่ม Firebase Analytics Unity SDK
- ในคอนโซล Firebase ให้คลิกดาวน์โหลด Firebase Unity SDK จากนั้นแตกไฟล์ SDK ในจุดที่สะดวกสบาย
- คุณสามารถดาวน์โหลด Firebase Unity SDK อีกครั้งได้ทุกเมื่อ
- Firebase Unity SDK ไม่เจาะจงแพลตฟอร์ม
- ในโปรเจ็กต์ Unity แบบเปิด ให้ไปที่เนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง
- จาก SDK ที่แยกไฟล์แล้ว ให้เลือกผลิตภัณฑ์ Firebase ที่รองรับที่คุณต้องการใช้ในแอป
- เพิ่มแพ็กเกจ Firebase สำหรับ Google Analytics: FirebaseAnalytics.unitypackage
- เพิ่มแพ็กเกจสำหรับผลิตภัณฑ์อื่นๆ ของ Firebase ที่ต้องการใช้ในแอป เช่น หากต้องการใช้ Firebase Authentication และ Firebase Realtime Database ให้เพิ่ม FirebaseAuth.unitypackage และ FirebaseDatabase.unitypackage
- คลิกนำเข้าในหน้าต่างนำเข้าแพ็กเกจ Unity
- กลับไปที่คอนโซล Firebase แล้วคลิกถัดไปในเวิร์กโฟลว์การตั้งค่า
6 บันทึกเหตุการณ์ที่กำหนดเองด้วย Firebase Analytics
ในขั้นตอนนี้ คุณจะได้เรียนรู้วิธีบันทึกเหตุการณ์ที่กำหนดเองด้วย Firebase Analytics ในแอป Unity iOS
Firebase Analytics จะบันทึกเหตุการณ์บางอย่างให้คุณโดยอัตโนมัติ คุณไม่จำเป็นต้องเพิ่มโค้ดใดๆ เพื่อรับเหตุการณ์ดังกล่าว หากแอปจําเป็นต้องรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกเหตุการณ์ที่กําหนดเองของ Analytics ประเภทต่างๆ ในแอปได้สูงสุด 500 ประเภท
บันทึกเหตุการณ์
หลังจากกําหนดค่าอินสแตนซ์ FirebaseApp แล้ว คุณสามารถเริ่มบันทึกเหตุการณ์ด้วยเมธอด logEvent()
Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);
ดูเหตุการณ์ในคอนโซลแก้ไขข้อบกพร่องของ Xcode
คุณสามารถเปิดใช้การบันทึกแบบละเอียดเพื่อตรวจสอบการบันทึกเหตุการณ์โดย SDK เพื่อช่วยยืนยันว่ามีการบันทึกเหตุการณ์อย่างถูกต้อง ซึ่งรวมทั้งเหตุการณ์ที่บันทึกโดยอัตโนมัติและด้วยตนเอง
คุณเปิดใช้การบันทึกแบบละเอียดได้โดยทำดังนี้
- ใน Xcode ให้เลือก Product > Scheme > Edit Scheme...
- เลือกเรียกใช้จากเมนูด้านซ้าย
- เลือกแท็บอาร์กิวเมนต์
- ในส่วนอาร์กิวเมนต์ที่ผ่านเมื่อเปิดตัว ให้เพิ่ม -FIRAnalyticsDebugEnabled
ครั้งถัดไปที่คุณเรียกใช้แอป เหตุการณ์จะแสดงในคอนโซลแก้ไขข้อบกพร่องของ Xcode ซึ่งจะช่วยให้คุณยืนยันได้ทันทีว่ามีการส่งเหตุการณ์
ดูเหตุการณ์ในหน้าแดชบอร์ด
คุณจะเห็นเหตุการณ์ที่บันทึกไว้ในคอนโซล Firebase ในอีก 2-3 ชั่วโมง ซึ่งอยู่ใน Analytics → เหตุการณ์ คุณยังค้นหาค่าพารามิเตอร์ได้โดยคลิกเหตุการณ์
คุณจะทําเครื่องหมาย "text_search" เป็น Conversion โดยการเลื่อนสวิตช์ "ทําเครื่องหมายเป็น Conversion" ไปทางขวา
คุณสามารถตรวจสอบอีกครั้งว่าทําเครื่องหมายเหตุการณ์เป็น Conversion สําเร็จหรือไม่ผ่านแท็บ Conversion ของ Firebase Analytics เมื่อทําเครื่องหมายเหตุการณ์เป็น Conversion แล้ว Google Ads จะนําเข้าเหตุการณ์เป็น Conversion ได้ด้วย
7 การนําเข้าเหตุการณ์ Analytics ใน Google Ads
การตั้งค่า Firebase-iOS เสร็จสมบูรณ์แล้ว และคุณพร้อมที่จะเปิดตัว App Campaign ที่มีเหตุการณ์การกระทําที่บันทึกไว้ คุณจะเริ่มด้วยการลิงก์ Firebase กับ Google Ads การลิงก์ Firebase กับ Google Ads จะช่วยให้ App Campaign เรียนรู้เพิ่มเติมเกี่ยวกับกลุ่มเป้าหมายและเพิ่มการเรียนรู้ของ App Campaign ซึ่งมักจะทําให้ประสิทธิภาพและ Conversion ดีขึ้น
- ไปที่การตั้งค่า Firebase โดยคลิกปุ่มที่อยู่ถัดจากภาพรวมโปรเจ็กต์
- ในแท็บการผสานรวม คุณจะเห็น Google Ads และปุ่มลิงก์ คลิก "ลิงก์และดำเนินการต่อ"
- เลือกบัญชี Google Ads
เท่านี้ก็เรียบร้อย ในส่วน Firebase แล้ว
ไปที่ Google Ads และเข้าสู่ระบบ
- ไปที่ Google Ads แล้วลงชื่อเข้าสู่ระบบ แล้วไปที่เครื่องมือและการตั้งค่า → การวัด → Conversion สําหรับการนําเข้าเหตุการณ์ที่กําหนดเองเป็น Conversion
- คลิกปุ่ม + เพื่อเพิ่มการกระทำที่ถือเป็น Conversion ใหม่
- เลือกพร็อพเพอร์ตี้ Google Analytics 4 (Firebase) แล้วคลิก "ดำเนินการต่อ"
- คุณสามารถดูเหตุการณ์ Analytics ทั้งหมดที่ทําเครื่องหมายเป็น Conversion ได้ ค้นหาเหตุการณ์
clicked_counter
ที่เราติดตั้งใช้งานมาก่อน
- เลือกแล้วคลิกปุ่มนําเข้าและดําเนินการต่อ
หลังจากตั้งค่า text_search เป็นการกระทำที่ถือเป็น Conversion แล้ว ตอนนี้ถึงเวลาเปิดตัวแคมเปญที่กำหนดเป้าหมายเป็นผู้ใช้ที่มีแนวโน้มจะเรียกเหตุการณ์ text_search
8 การเปิดตัวแคมเปญการกระทำในแอปที่มีเหตุการณ์ที่นำเข้า
- ไปที่แท็บแคมเปญของบัญชีปัจจุบัน แล้วเริ่มแคมเปญใหม่โดยคลิกปุ่ม + คลิกแคมเปญใหม่และดําเนินการต่อ
- ในระหว่างนี้ เราจะเปิดตัวแคมเปญการโปรโมตแอปที่มีตัวเลือกการติดตั้งแอป
- ค้นหาแอปของคุณโดยระบุชื่อแอป ชื่อแพ็กเกจ หรือผู้เผยแพร่
- ในส่วนการเสนอราคา ให้เลือกการกระทําในแอปในกล่องแบบเลื่อนลงเพื่อให้ Google Ads มุ่งเน้นที่การกระทํา
- คุณจะเห็นเหตุการณ์ที่กําหนดเองในรายการที่ให้ไว้ กำหนดต้นทุนต่อการกระทำหนึ่งครั้งเป้าหมายและเพิ่มตัวเลือกอื่นๆ ด้วย
- กำหนดการตั้งค่าแคมเปญ การดำเนินการนี้อยู่นอกขอบเขตของ Codelab ดังนั้นโปรดดูเอกสารเหล่านี้หรือติดต่อผ่านช่องทางอื่นๆ เพื่อเพิ่มประสิทธิภาพการตั้งค่า
9 ขอแสดงความยินดี
ขอแสดงความยินดี คุณได้ผสานรวม Firebase เข้ากับ Unity และ Google Ads เรียบร้อยแล้ว ซึ่งจะช่วยเพิ่มประสิทธิภาพแคมเปญได้
สิ่งที่คุณได้เรียนรู้
- วิธีกำหนดค่า Firebase สำหรับแพลตฟอร์ม Unity สำหรับ iOS
- วิธีบันทึกเหตุการณ์ที่กำหนดเองด้วย Unity และ Firebase Analytics
- วิธีนําเข้าเหตุการณ์และใช้กับแคมเปญเพื่อกระตุ้นการกระทํา