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

1. บทนำ

อัปเดตล่าสุด: 14-12-2020

สิ่งที่คุณจะสร้าง

ใน Codelab นี้ คุณจะได้เรียนรู้วิธีติดตั้งใช้งานเหตุการณ์ที่กําหนดเองด้วย SDK ของ GA4F iOS และเปิดตัวแคมเปญกระตุ้นการกระทําผ่าน 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

1. หากไม่มีโปรเจ็กต์ที่เปิดอยู่ ให้เลือก "สร้างโปรเจ็กต์ Xcode ใหม่" จากหน้าต้อนรับ
2. เลือก iOS ที่ด้านบนของกล่องโต้ตอบ
3. ในส่วนแอปพลิเคชัน ให้เลือกแอป แล้วคลิกถัดไป
4. ในกล่องโต้ตอบที่ปรากฏขึ้น ให้ใช้ค่าต่อไปนี้เพื่อตั้งชื่อแอปและเลือกตัวเลือกเพิ่มเติมสำหรับโปรเจ็กต์ แล้วคลิกถัดไป
5. ชื่อผลิตภัณฑ์: เช่น ios-app

Xcode จะใช้ชื่อผลิตภัณฑ์ที่คุณป้อนเพื่อตั้งชื่อโปรเจ็กต์และแอป

2. ทีม: หากระบบไม่กรอกข้อมูลนี้โดยอัตโนมัติ ให้ตั้งค่าทีมเป็น "ไม่มี"
3. ชื่อองค์กร: ชื่อองค์กรหรือชื่อของคุณ
4. ตัวระบุ Bundle: ระบบจะสร้างค่านี้โดยอัตโนมัติตามชื่อผลิตภัณฑ์และตัวระบุองค์กร
5. ภาษา: Swift
6. เลือกตำแหน่งที่จะบันทึกโปรเจ็กต์ แล้วคลิกสร้าง
7. Xcode จะเปิดโปรเจ็กต์ใหม่ในหน้าต่างพื้นที่ทำงาน

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

หากต้องการเริ่มต้นใช้งาน 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. การกำหนดค่า Firebase

1. ในคอนโซล Firebase ให้เลือกภาพรวมโปรเจ็กต์ > การตั้งค่าโปรเจ็กต์ในแถบนำทางด้านซ้าย จากนั้นคลิกปุ่ม iOS ในส่วนทั่วไป > แอปของคุณ

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

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

8. ไปที่โปรเจ็กต์ Xcode แล้วย้ายไฟล์ GoogleService-Info.plist (ที่คุณเพิ่งดาวน์โหลด) ไปยังรากของโปรเจ็กต์ Xcode
9. ข้ามขั้นตอนที่เหลือและกลับไปที่หน้าหลักของคอนโซล Firebase

5. กําหนดค่า Firebase Analytics ใน Xcode

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

หมายเหตุ: บริการของ Google ใช้ CocoaPods ในการติดตั้งและจัดการทรัพยากร Dependency หากไม่เคยใช้ CocoaPods มาก่อน คุณจะต้องติดตั้งก่อนโดยเรียกใช้คำสั่งนี้ในเทอร์มินัล

$ sudo gem install cocoapods

1. เปิดหน้าต่างเทอร์มินัลแล้วไปที่ตำแหน่งของโปรเจ็กต์ Xcode สำหรับแอปของคุณ
2. สร้าง Podfile หากคุณยังไม่มี:

$ pod init

3. เปิด Podfile และเพิ่มโค้ดต่อไปนี้

$ vi Podfile

$ pod 'Firebase/Analytics'

4. บันทึกไฟล์และเรียกใช้คำสั่งต่อไปนี้

$ pod install

5. เพิ่มโค้ดการเริ่มต้น :

หากต้องการเชื่อมต่อ 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. เรียบร้อยแล้ว ดำเนินการต่อที่คอนโซล

ตอนนี้คุณพร้อมที่จะเริ่มทำงานบันทึกเหตุการณ์ที่กำหนดเองแล้ว

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 ได้ เพื่อช่วยยืนยันว่าระบบบันทึกเหตุการณ์อย่างถูกต้อง ซึ่งรวมถึงเหตุการณ์ที่บันทึกโดยอัตโนมัติและด้วยตนเอง

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

1. ใน Xcode ให้เลือกผลิตภัณฑ์ > รูปแบบ > แก้ไขรูปแบบ...
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 หากยังไม่พร้อมเผยแพร่แอป ให้ข้ามขั้นตอนนี้ไปก่อน

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

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

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

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

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

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

คุณได้เรียนรู้

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