เหตุการณ์ที่กำหนดเองของ 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. เลือกเทมเพลต 3D จากกล่องโต้ตอบ
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 ในตอนนี้ คุณจะกลับไปที่เวิร์กโฟลว์การตั้งค่าในภายหลังได้เสมอเพื่อลงทะเบียนเป้าหมายบิลด์อื่น

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 และฐานข้อมูลเรียลไทม์ของ Firebase: 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 กำหนดให้ใช้เนื้อหาแบบ Swiming หากไม่มี ฟีเจอร์หลักๆ ของ 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 > รูปแบบ > แก้ไขรูปแบบ...
2. เลือกเรียกใช้จากเมนูด้านซ้าย
3. เลือกแท็บอาร์กิวเมนต์
4. ในส่วนอาร์กิวเมนต์ที่ผ่านเมื่อเปิดตัว ให้เพิ่ม -FIRAnalyticsDebugEnabled

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

ดูเหตุการณ์ในแดชบอร์ด

คุณจะเห็นเหตุการณ์ที่บันทึกในคอนโซล Firebase เป็นเวลาหลายชั่วโมง จะอยู่ใน 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