เหตุการณ์ที่กำหนดเองของ Google Ads ที่มี Google Analytics สำหรับ Firebase - iOS
เกี่ยวกับ Codelab นี้
1 บทนำ
อัปเดตล่าสุด 14-12-2020
สิ่งที่คุณจะสร้าง
ใน Codelab นี้ คุณจะได้ศึกษาวิธีติดตั้งใช้งานเหตุการณ์ที่กำหนดเองด้วย GA4F iOS SDK และเปิดตัวแคมเปญเพื่อกระตุ้นการกระทำผ่าน Google Ads
ผ่าน Codelab นี้ คุณจะได้เห็นกระบวนการทั้งหมดของธุรกิจแอปที่ลูกค้าของเราพบ หากต้องการดูข้อมูลเบื้องต้นที่เข้าใจง่ายขึ้นเกี่ยวกับ Firebase iOS ให้เริ่มด้วย Firebase iOS Codelab Swift
สิ่งที่คุณจะได้เรียนรู้
- วิธีเริ่มต้น GA4F (Google Analytics สําหรับ Firebase) ใน iOS Swift
- วิธีสร้างเหตุการณ์และพารามิเตอร์ที่กําหนดเอง
- วิธีนําเข้าเหตุการณ์จาก Firebase ไปยัง Google Ads
- ปล่อยแคมเปญเพื่อกระตุ้นการกระทำด้วยเหตุการณ์ที่กําหนดเอง
สิ่งที่ต้องมี
- Xcode
- บัญชี Firebase
- บัญชี Google Ads
2 เริ่มโปรเจ็กต์ Swift ใหม่ใน iOS
สร้างแอป iOS Swift เทมเพลตง่ายๆ คุณสามารถแก้ไขแอปเริ่มต้นนี้เพื่อสร้างแอปที่เสร็จสมบูรณ์
ก่อนอื่น ให้เปิด Xcode
- หากไม่มีโปรเจ็กต์ที่เปิดอยู่ ให้เลือกสร้างโปรเจ็กต์ Xcode ใหม่จากหน้าต้อนรับ
- เลือก iOS ที่ด้านบนของกล่องโต้ตอบ
- ในส่วนแอปพลิเคชัน ให้เลือก "แอป" แล้วคลิก "ถัดไป"
- ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ใช้ค่าต่อไปนี้เพื่อตั้งชื่อแอปของคุณและเลือกตัวเลือกเพิ่มเติมสำหรับโปรเจ็กต์ของคุณ แล้วคลิก ถัดไป :
- ชื่อผลิตภัณฑ์: เช่น ios-app
Xcode จะใช้ชื่อผลิตภัณฑ์ที่คุณป้อนเพื่อตั้งชื่อโปรเจ็กต์และแอป
- ทีม: หากระบบไม่ได้กรอกข้อมูลนี้โดยอัตโนมัติ ให้ตั้งค่าทีมเป็น "ไม่มี"
- ชื่อองค์กร: ชื่อองค์กรหรือชื่อของคุณเอง
- ตัวระบุกลุ่ม: ระบบจะสร้างค่านี้โดยอัตโนมัติตามชื่อผลิตภัณฑ์และตัวระบุองค์กร
- ภาษา: Swift
- เลือกตำแหน่งที่ตั้งเพื่อบันทึกโปรเจ็กต์ แล้วคลิกสร้าง
- Xcode จะเปิดโปรเจ็กต์ใหม่ในหน้าต่างพื้นที่ทำงาน
3 สร้างและตั้งค่าโปรเจ็กต์ Firebase
หากต้องการเริ่มต้นใช้งาน Firebase คุณจะต้องสร้างและตั้งค่าโปรเจ็กต์ Firebase
สร้างโปรเจ็กต์ Firebase
หากมีโปรเจ็กต์ Firebase เดิมที่ไม่ได้เปิดใช้ Google Analytics ให้เปิดใช้ Google Analytics จากแท็บการผสานรวมของการตั้งค่า > การตั้งค่าโปรเจ็กต์ ไปยังขั้นตอนการกำหนดค่า Firebase
- ลงชื่อเข้าใช้ Firebase
ในคอนโซล Firebase ให้คลิก "เพิ่มโปรเจ็กต์" (หรือ "สร้างโปรเจ็กต์") และตั้งชื่อโปรเจ็กต์ Firebase ของคุณว่า Firebase-iOS-Ads
- คลิกตัวเลือกการสร้างโปรเจ็กต์ ยอมรับข้อกำหนดของ Firebase หากได้รับข้อความแจ้ง คุณควรเปิดใช้ Google Analytics สําหรับโปรเจ็กต์นี้ เนื่องจากต้องใช้เหตุการณ์ Google Analytics เพื่อติดตามเหตุการณ์การกระทําและ Conversion
ดูข้อมูลเพิ่มเติมเกี่ยวกับโปรเจ็กต์ Firebase ได้ที่ทําความเข้าใจโปรเจ็กต์ Firebase
4 การกําหนดค่า Firebase
- ในคอนโซล Firebase ให้เลือกภาพรวมโปรเจ็กต์ > การตั้งค่าโปรเจ็กต์ในการนําทางด้านซ้าย จากนั้นคลิกปุ่ม iOS ในส่วนทั่วไป > แอปของคุณ
คุณจะเห็นกล่องโต้ตอบที่แสดงในหน้าจอต่อไปนี้
- ค่าสำคัญที่ต้องระบุคือรหัสชุด iOS ซึ่งคุณจะได้รับจากขั้นตอนต่อไปนี้
- ในโปรเจ็กต์ Xcode สําหรับแอป iOS ให้เลือกแอประดับบนสุดในเครื่องมือนําทางโปรเจ็กต์ แล้วเลือกแท็บทั่วไป
- ค่าของช่องตัวระบุชุดคือรหัสชุด iOS (เช่น
com.yourcompany.yourproject
) คัดลอกค่านี้ - ในกล่องโต้ตอบ Firebase ให้วางรหัสกลุ่มที่คัดลอกลงในช่อง
iOS bundle ID
- คลิกลงทะเบียนแอป
- ดำเนินการต่อใน Firebase โดยทำตามวิธีการเพื่อดาวน์โหลดไฟล์การกําหนดค่า
GoogleService-Info.plist
- ไปที่โปรเจ็กต์ Xcode แล้วย้ายไฟล์
GoogleService-Info.plist
(ที่คุณเพิ่งดาวน์โหลด) ไปยังรูทของโปรเจ็กต์ Xcode - ข้ามขั้นตอนที่เหลือและกลับไปที่หน้าหลักของคอนโซล Firebase
5 กำหนดค่า Firebase Analytics ใน Xcode
ในขั้นตอนนี้ คุณจะเริ่มเพิ่ม Firebase SDK ลงในโปรเจ็กต์ Xcode
- เปิดหน้าต่างเทอร์มินัลและไปที่ตำแหน่งของโปรเจ็กต์ Xcode สำหรับแอป
- สร้าง Podfile หากคุณยังไม่มี:
$ pod init
- เปิด Podfile และเพิ่ม :
$ vi Podfile
$ pod 'Firebase/Analytics'
- บันทึกไฟล์และเรียกใช้คำสั่งต่อไปนี้
$ pod install
- เพิ่มโค้ดการเริ่มต้น ดังนี้
หากต้องการเชื่อมต่อ Firebase เมื่อแอปของคุณเริ่มขึ้น ให้เพิ่มโค้ดการเริ่มต้นด้านล่างลงในคลาส AppDelegate หลัก
import UIKit
import Firebase
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
var window: UIWindow?
func application(_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions:
[UIApplicationLaunchOptionsKey: Any]?) -> Bool {
FirebaseApp.configure()
return true
}
}
- คุณพร้อมแล้ว ไปที่คอนโซล
ตอนนี้คุณพร้อมที่จะเริ่มบันทึกเหตุการณ์ที่กำหนดเองบางส่วนแล้ว
6 บันทึกเหตุการณ์ที่กำหนดเองด้วย Firebase Analytics
ในขั้นตอนนี้ คุณจะได้เรียนรู้วิธีบันทึกเหตุการณ์ที่กำหนดเองด้วย Firebase Analytics ในแอป iOS
Firebase Analytics จะบันทึกเหตุการณ์บางอย่างให้คุณโดยอัตโนมัติ คุณไม่จำเป็นต้องเพิ่มโค้ดใดๆ เพื่อรับเหตุการณ์ดังกล่าว หากแอปจําเป็นต้องรวบรวมข้อมูลเพิ่มเติม คุณสามารถบันทึกเหตุการณ์ที่กําหนดเองของ Analytics ประเภทต่างๆ ในแอปได้สูงสุด 500 ประเภท
บันทึกเหตุการณ์
หลังจากกำหนดค่าอินสแตนซ์ FirebaseApp แล้ว คุณจะเริ่มบันทึกเหตุการณ์ด้วยเมธอด logEvent() ได้
Analytics.logEvent("text_search", parameters: [
"name": name as NSObject,
"full_text": text as NSObject
])
ตั้งค่าพารามิเตอร์เหตุการณ์เริ่มต้น
คุณบันทึกพารามิเตอร์ข้ามเหตุการณ์ได้โดยใช้ setDefaultEventParameters พารามิเตอร์เริ่มต้นจะเชื่อมโยงกับเหตุการณ์ในอนาคตทั้งหมดที่บันทึกไว้
Analytics.setDefaultEventParameters([
"level_name": "Caverns01",
"level_difficulty": 4
])
ดูเหตุการณ์ในคอนโซลแก้ไขข้อบกพร่องของ Xcode
คุณสามารถเปิดใช้การบันทึกแบบละเอียดเพื่อตรวจสอบการบันทึกเหตุการณ์โดย SDK เพื่อช่วยยืนยันว่ามีการบันทึกเหตุการณ์อย่างถูกต้อง ซึ่งรวมถึงเหตุการณ์ที่บันทึกโดยอัตโนมัติและบันทึกด้วยตนเอง
คุณสามารถเปิดใช้การบันทึกแบบละเอียดได้ดังนี้
- ใน Xcode ให้เลือก Product > Scheme > Edit Scheme...
- เลือกเรียกใช้จากเมนูด้านซ้าย
- เลือกแท็บอาร์กิวเมนต์
- ในส่วน Arguments Passed On Launch ให้เพิ่ม -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 ดีขึ้น
- ไปที่การตั้งค่า 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 และ Google Ads เรียบร้อยแล้ว ซึ่งจะช่วยเพิ่มประสิทธิภาพแคมเปญ
คุณได้ติดตั้งสคริปต์ สร้างและจัดเตรียมรายการการเปลี่ยนแปลง Codelab รายการใหม่ อัปเดตและจัดเตรียมรายการการเปลี่ยนแปลง Codelab ที่รอดำเนินการ ตรวจสอบและอนุมัติรายการการเปลี่ยนแปลง Codelab และส่งและเผยแพร่รายการการเปลี่ยนแปลง Codelab
คุณได้เรียนรู้
- วิธีกําหนดค่า Firebase สําหรับ iOS
- วิธีบันทึกเหตุการณ์ที่กําหนดเองด้วย iOS และ Firebase Analytics
- วิธีนําเข้าเหตุการณ์และใช้สําหรับแคมเปญเพื่อกระตุ้นการกระทำ