เหตุการณ์ที่กำหนดเองของ Google Ads ที่มี Google Analytics สำหรับ Firebase - Unity

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

1. หากไม่มีโปรเจ็กต์ที่เปิดอยู่ ให้เลือกสร้างโปรเจ็กต์ใหม่
2. เลือกเทมเพลต 3 มิติจากกล่องโต้ตอบ
3. กรอกชื่อโปรเจ็กต์ เช่น เหตุการณ์ที่กําหนดเองของ Unity Firebase
4. เลือกตำแหน่งที่จะบันทึกโปรเจ็กต์ แล้วคลิกสร้าง
5. Unity จะเปิดโปรเจ็กต์ใหม่ในหน้าต่างเวิร์กスペース

3. สร้างและตั้งค่าโปรเจ็กต์ Firebase

หากต้องการเริ่มต้นใช้งาน Firebase คุณจะต้องสร้างและตั้งค่าโปรเจ็กต์ Firebase

หากคุณมีโปรเจ็กต์ Firebase เดิมที่ไม่ได้เปิดใช้ Google Analytics คุณจะเปิดใช้ Google Analytics ได้จากแท็บการผสานรวมของการตั้งค่า > การตั้งค่าโปรเจ็กต์ ไปยังขั้นตอนการกำหนดค่า Firebase ต่อ

1. ลงชื่อเข้าใช้ Firebase

ในคอนโซล Firebase ให้คลิก "เพิ่มโปรเจ็กต์" (หรือ "สร้างโปรเจ็กต์") แล้วตั้งชื่อโปรเจ็กต์ Firebase เป็น Firebase-iOS-Ads

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase ได้ที่ทําความเข้าใจโปรเจ็กต์ Firebase

4. การกำหนดค่า Unity

1. ใน Unity > ไฟล์ > การตั้งค่าการสร้าง ค่าที่สำคัญคือการตั้งค่ารหัสชุด iOS ซึ่งคุณจะได้รับจากขั้นตอนต่อไปนี้

คุณจะเห็นกล่องโต้ตอบที่แสดงในหน้าจอต่อไปนี้

2. ในโปรเจ็กต์ Unity สําหรับแอป iOS ให้เปิดกล่องโต้ตอบการตั้งค่าการสร้าง ไฟล์ > การตั้งค่าการสร้าง (หากไม่ได้ตั้งค่าแพลตฟอร์มเป็น iOS ให้เลือกแพลตฟอร์ม iOS แล้วคลิกปุ่มเปลี่ยนแพลตฟอร์ม)

3. หลังจากเปลี่ยนแพลตฟอร์ม ให้คลิกปุ่ม "การตั้งค่าโปรแกรมเล่น" เพื่อตั้งค่ารหัสชุด คุณจะเห็นช่องข้อความรอบๆ พื้นที่การระบุ
4. ค่าของช่องตัวระบุกลุ่มคือรหัสกลุ่ม iOS (เช่น com.yourcompany.yourproject) ให้คัดลอกค่านี้หรือตั้งค่าของคุณเองแล้วคัดลอก
5. ในกล่องโต้ตอบ Firebase ให้วางรหัสชุดที่คัดลอกลงในช่อง iOS bundle ID
6. คลิกลงทะเบียนแอป
7. ดำเนินการต่อใน Firebase ทำตามวิธีการเพื่อดาวน์โหลดไฟล์การกำหนดค่า GoogleService-Info.plist
8. เปิดหน้าต่างโปรเจ็กต์ของโปรเจ็กต์ Unity จากนั้นย้ายไฟล์การกําหนดค่าไปยังโฟลเดอร์ Assets
9. ข้ามขั้นตอนที่เหลือและกลับไปที่หน้าหลักของคอนโซล Firebase

5. กำหนดค่า Firebase Analytics ใน Unity

ในขั้นตอนนี้ คุณจะเริ่มเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Unity

1. ไปที่คอนโซล Firebase
2. ที่ตรงกลางของหน้าภาพรวมโปรเจ็กต์ ให้คลิกไอคอน Unity ( ) เพื่อเปิดเวิร์กโฟลว์การตั้งค่า หากเพิ่มแอปลงในโปรเจ็กต์ Firebase อยู่แล้ว ให้คลิกเพิ่มแอปเพื่อแสดงตัวเลือกแพลตฟอร์ม
3. เลือกเป้าหมายของบิลด์ในโปรเจ็กต์ Unity ที่ต้องการลงทะเบียน หรือจะเลือกลงทะเบียนทั้ง 2 เป้าหมายพร้อมกันเลยก็ได้

หมายเหตุ: หากลงทะเบียนเป้าหมายของบิลด์โปรเจ็กต์ Unity เพียง 1 รายการในตอนนี้ คุณจะกลับมายังเวิร์กโฟลว์การตั้งค่าในภายหลังเพื่อลงทะเบียนเป้าหมายของบิลด์อื่นได้เสมอ

4. ป้อนรหัสเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity

• สำหรับ iOS — ป้อนรหัส iOS ของโครงการ Unity ในช่องรหัสชุด iOS
• สำหรับ Android - ป้อนรหัส Android ของโปรเจ็กต์ Unity ในช่องชื่อแพ็กเกจ Android คำว่าชื่อแพ็กเกจและรหัสแอปพลิเคชันมักจะใช้แทนกันได้

5. คุณดูรหัสของโปรเจ็กต์ Unity ได้จากที่ใด

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

6. (ไม่บังคับ) ป้อนชื่อเล่นเฉพาะแพลตฟอร์มของโปรเจ็กต์ Unity โดยชื่อเล่นเหล่านี้เป็นตัวระบุภายในเพื่อความสะดวกและคุณจะเห็นชื่อเล่นดังกล่าวในคอนโซล Firebase เท่านั้น
7. คลิกลงทะเบียนแอป

เพิ่ม Firebase Analytics Unity SDK

1. ในคอนโซล Firebase ให้คลิกดาวน์โหลด Firebase Unity SDK จากนั้นแตกไฟล์ SDK ในจุดที่สะดวกสบาย

• คุณสามารถดาวน์โหลด Firebase Unity SDK อีกครั้งได้ทุกเมื่อ
• Firebase Unity SDK ไม่เจาะจงแพลตฟอร์ม

2. ในโปรเจ็กต์ Unity แบบเปิด ให้ไปที่เนื้อหา > นำเข้าแพ็กเกจ > แพ็กเกจที่กำหนดเอง
3. จาก SDK ที่แยกไฟล์แล้ว ให้เลือกผลิตภัณฑ์ Firebase ที่รองรับที่คุณต้องการใช้ในแอป

• เพิ่มแพ็กเกจ Firebase สำหรับ Google Analytics: FirebaseAnalytics.unitypackage
• เพิ่มแพ็กเกจสำหรับผลิตภัณฑ์อื่นๆ ของ Firebase ที่ต้องการใช้ในแอป เช่น หากต้องการใช้ Firebase Authentication และ Firebase Realtime Database ให้เพิ่ม FirebaseAuth.unitypackage และ FirebaseDatabase.unitypackage

Unity 5.x และเวอร์ชันก่อนหน้าใช้เฟรมเวิร์ก .NET 3.x ดังนั้นให้นําเข้าแพ็กเกจ dotnet3/ Unity 2017.x ขึ้นไป อนุญาตให้ใช้เฟรมเวิร์ก .NET 4.x หากโปรเจ็กต์ Unity ของคุณใช้ .NET 4.x ให้นำเข้าแพ็กเกจ dotnet4/ Unity 2019 ขึ้นไปไม่รองรับเฟรมเวิร์ก .NET 3.x แล้ว ดังนั้นโปรดนำเข้าแพ็กเกจ dotnet4/

4. คลิกนำเข้าในหน้าต่างนำเข้าแพ็กเกจ Unity
5. กลับไปที่คอนโซล Firebase แล้วคลิกถัดไปในเวิร์กโฟลว์การตั้งค่า

สำคัญ: อย่าปิดใช้การสุ่มเมธอดเมื่อใช้ Firebase Unity SDK สำหรับ iOS SDK ต้องใช้การสลับที่ หากไม่ใช้ ฟีเจอร์หลักของ Firebase (เช่น การจัดการโทเค็น FCM) จะทํางานไม่ถูกต้อง

6. บันทึกเหตุการณ์ที่กำหนดเองด้วย Firebase Analytics

ในขั้นตอนนี้ คุณจะได้เรียนรู้วิธีบันทึกเหตุการณ์ที่กำหนดเองด้วย Firebase Analytics ในแอป Unity iOS

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

บันทึกเหตุการณ์

หลังจากกําหนดค่าอินสแตนซ์ FirebaseApp แล้ว คุณสามารถเริ่มบันทึกเหตุการณ์ด้วยเมธอด logEvent()

Firebase.Analytics.FirebaseAnalytics.LogEvent("text_search", name, text);

ดูเหตุการณ์ในคอนโซลแก้ไขข้อบกพร่องของ Xcode

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

คุณเปิดใช้การบันทึกแบบละเอียดได้โดยทำดังนี้

1. ใน Xcode ให้เลือก Product > Scheme > Edit Scheme...
2. เลือกเรียกใช้จากเมนูด้านซ้าย
3. เลือกแท็บอาร์กิวเมนต์
4. ในส่วนอาร์กิวเมนต์ที่ผ่านเมื่อเปิดตัว ให้เพิ่ม -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 ดีขึ้น

1. ไปที่การตั้งค่า Firebase โดยคลิกปุ่มที่อยู่ถัดจากภาพรวมโปรเจ็กต์
2. ในแท็บการผสานรวม คุณจะเห็น Google Ads และปุ่มลิงก์ คลิก "ลิงก์และดำเนินการต่อ"

3. เลือกบัญชี Google Ads

ข้อควรระวัง: หากเหตุการณ์เป้าหมายไม่ได้ทําเครื่องหมายเป็น Conversion Google Ads จะนําเข้าไม่ได้ ตรวจสอบว่าทําเครื่องหมายเหตุการณ์เป็น Conversion อย่างถูกต้อง

เท่านี้ก็เรียบร้อย ในส่วน Firebase แล้ว

ไปที่ Google Ads และเข้าสู่ระบบ

1. ไปที่ Google Ads แล้วลงชื่อเข้าสู่ระบบ แล้วไปที่เครื่องมือและการตั้งค่า → การวัด → Conversion สําหรับการนําเข้าเหตุการณ์ที่กําหนดเองเป็น Conversion
2. คลิกปุ่ม + เพื่อเพิ่มการกระทำที่ถือเป็น Conversion ใหม่

3. เลือกพร็อพเพอร์ตี้ Google Analytics 4 (Firebase) แล้วคลิก "ดำเนินการต่อ"

4. คุณสามารถดูเหตุการณ์ Analytics ทั้งหมดที่ทําเครื่องหมายเป็น Conversion ได้ ค้นหาเหตุการณ์ clicked_counter ที่เราติดตั้งใช้งานมาก่อน

5. เลือกแล้วคลิกปุ่มนําเข้าและดําเนินการต่อ

หลังจากตั้งค่า text_search เป็นการกระทำที่ถือเป็น Conversion แล้ว ตอนนี้ถึงเวลาเปิดตัวแคมเปญที่กำหนดเป้าหมายเป็นผู้ใช้ที่มีแนวโน้มจะเรียกเหตุการณ์ text_search

8. การเปิดตัวแคมเปญการกระทำในแอปที่มีเหตุการณ์ที่นำเข้า

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

6. ไปที่แท็บแคมเปญของบัญชีปัจจุบัน แล้วเริ่มแคมเปญใหม่โดยคลิกปุ่ม + คลิกแคมเปญใหม่และดําเนินการต่อ
7. ในระหว่างนี้ เราจะเปิดตัวแคมเปญการโปรโมตแอปที่มีตัวเลือกการติดตั้งแอป

8. ค้นหาแอปของคุณโดยระบุชื่อแอป ชื่อแพ็กเกจ หรือผู้เผยแพร่
9. ในส่วนการเสนอราคา ให้เลือกการกระทําในแอปในกล่องแบบเลื่อนลงเพื่อให้ Google Ads มุ่งเน้นที่การกระทํา
10. คุณจะเห็นเหตุการณ์ที่กําหนดเองในรายการที่ให้ไว้ กำหนดต้นทุนต่อการกระทำหนึ่งครั้งเป้าหมายและเพิ่มตัวเลือกอื่นๆ ด้วย

11. กำหนดการตั้งค่าแคมเปญ การดำเนินการนี้อยู่นอกขอบเขตของ Codelab ดังนั้นโปรดดูเอกสารเหล่านี้หรือติดต่อผ่านช่องทางอื่นๆ เพื่อเพิ่มประสิทธิภาพการตั้งค่า

9. ขอแสดงความยินดี

ขอแสดงความยินดี คุณได้ผสานรวม Firebase เข้ากับ Unity และ Google Ads เรียบร้อยแล้ว ซึ่งจะช่วยเพิ่มประสิทธิภาพแคมเปญได้

สิ่งที่คุณได้เรียนรู้

• วิธีกำหนดค่า Firebase สำหรับแพลตฟอร์ม Unity สำหรับ iOS
• วิธีบันทึกเหตุการณ์ที่กำหนดเองด้วย Unity และ Firebase Analytics
• วิธีนําเข้าเหตุการณ์และใช้กับแคมเปญเพื่อกระตุ้นการกระทํา

เอกสารอ้างอิง

• เพิ่ม Firebase ไปยังโปรเจ็กต์ Unity
• GitHub: firebase/quickstart-unity