เริ่มต้นใช้งานเหตุการณ์ในแอพสำหรับ iOS

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

ก่อนเริ่มต้น

คุณจะต้องมีสิ่งต่อไปนี้และดำเนินการดังนี้

• บัญชีผู้พัฒนาสำหรับ Facebook
• บัญชีโฆษณาสำหรับ Facebook
• พอร์ตโฟลิโอธุรกิจสำหรับ Facebook (ให้สร้างพอร์ตโฟลิโอธุรกิจใหม่หากคุณยังไม่มี)
• แอพ Facebook

ขั้นตอนที่1: กำหนดค่าแอพ Facebook ของคุณ

ไปที่แดชบอร์ดของแอพ คลิกแอพของฉัน และสร้างแอพใหม่ขึ้นมาหากคุณยังไม่มีแอพ ไปที่การตั้งค่า > พื้นฐาน เพื่อดูแผงรายละเอียดของแอพที่มี ID ของแอพ, ข้อมูลลับของแอพ และรายละเอียดอื่นๆ เกี่ยวกับแอพของคุณ

เลื่อนลงไปที่ด้านล่างของหน้า แล้วคลิกเพิ่มแพลตฟอร์ม เลือก iOS เพิ่มรายละเอียดแอพของคุณ แล้วบันทึกการเปลี่ยนแปลง

ตั้งค่าแอพของคุณเพื่อการโฆษณาโดยเพิ่มรายละเอียดต่อไปนี้

• โดเมนของแอพ - ระบุ URL สำหรับ Apple App Store ของแอพของคุณ
• URL ของนโยบายความเป็นส่วนตัว - ระบุ URL ของนโยบายความเป็นส่วนตัวจำเป็นต้องตั้งค่าแอพของคุณให้เป็นสาธารณะ
• URL ของข้อกำหนดในการใช้บริการ - ระบุ URL ของข้อกำหนดในการใช้บริการ
• แพลตฟอร์ม - เลื่อนลงไปที่ส่วนล่างสุดของแผงการตั้งค่าเพื่อเพิ่มแพลตฟอร์ม iOS

เรียนรู้เพิ่มเติมเกี่ยวกับการเพิ่มรายละเอียดลงในแอพของคุณ เช่น ไอคอนหรือหมวดหมู่ ได้ที่เอกสารเกี่ยวกับการพัฒนาแอพ

ขั้นตอนที่ 2: เชื่อมโยงบัญชีโฆษณาและพอร์ตโฟลิโอธุรกิจ

หากต้องการแสดงโฆษณาและวัดผลการติดตั้งในตัวจัดการโฆษณา ให้เชื่อมโยงจัดการบัญชีโฆษณาและพอร์ตโฟลิโอธุรกิจอย่างน้อย 1 รายการกับแอพของคุณ

1. ในแดชบอร์ดของแอพ ให้คลิกการตั้งค่า > ขั้นสูง
2. ใน ID บัญชีโฆษณาที่ได้รับอนุญาต ให้เพิ่ม ID บัญชีโฆษณาของคุณ โดยคุณสามารถรับ ID บัญชีโฆษณาได้จากตัวจัดการโฆษณา
3. ในแผงควบคุมบัญชีโฆษณา ให้คลิกเริ่มต้นใช้งาน และทำตามคำแนะนำในการเชื่อมต่อแอพกับธุรกิจ

ขั้นตอนที่ 3: ตั้งค่าสภาพแวดล้อมการพัฒนาของคุณ

ขั้นตอนต่อไปนี้จะใช้โปรแกรมจัดการแพ็คเกจ Swift ในการตั้งค่าสภาพแวดล้อมการพัฒนาของคุณใน Xcode

1. ใน Xcode ให้คลิกไฟล์ > เพิ่มแพ็คเกจ...
2. ในช่องค้นหาที่ปรากฏขึ้นมา ให้ป้อน URL ที่เก็บข้อมูล: https://github.com/facebook/facebook-ios-sdk
3. ในกฎของการขึ้นต่อกัน ให้เลือก “จนกว่าจะถึงเวอร์ชั่นใหญ่ถัดไป” และป้อนเวอร์ชั่นล่าสุด รุ่นล่าสุดจะระบุไว้ใน https://github.com/facebook/facebook-ios-sdk/releases/
4. เลือกไลบรารีที่คุณจะใช้และเป้าหมายที่คุณต้องการเพิ่มไลบรารีดังกล่าวเข้าไป
5. คลิกที่เพิ่มแพ็คเกจเพื่อตั้งค่าให้เสร็จสมบูรณ์

ขั้นตอนที่ 4: ลงทะเบียนและกำหนดค่าแอพของคุณกับ Facebook

1. ในแดชบอร์ดของแอพ ให้ไปที่ "การตั้งค่าแอพ > พื้นฐาน" แล้วเลื่อนลงมาคลิก "+ เพิ่มแพลตฟอร์ม"
2. เลื่อนลงไปที่การ์ด "iOS" แล้วเพิ่ม ID ชุดของคุณ ค้นหาตัวระบุชุดในเป้าหมายแอพพลิเคชั่น iOS ของโปรเจ็กต์ Xcode ของคุณ คุณสามารถอัพเดต ID ชุดของคุณได้ทุกเมื่อ

ขั้นตอนที่ 5: กำหนดค่าโปรเจ็กต์ของคุณ

ขั้นตอนที่ 6: เชื่อมต่อ App Delegate และ Scene Delegate ของคุณ

  
// AppDelegate.swift
import UIKit
import FBSDKCoreKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {          
        ApplicationDelegate.shared.application(
            application,
            didFinishLaunchingWithOptions: launchOptions
        )

        return true
    }
          
    func application(
        _ app: UIApplication,
        open url: URL,
        options: [UIApplication.OpenURLOptionsKey : Any] = [:]
    ) -> Bool {
        ApplicationDelegate.shared.application(
            app,
            open: url,
            sourceApplication: options[UIApplication.OpenURLOptionsKey.sourceApplication] as? String,
            annotation: options[UIApplication.OpenURLOptionsKey.annotation]
        )
    }  
}

 
// SceneDelegate.swift
import FBSDKCoreKit
  ...
func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else {
        return
    }

    ApplicationDelegate.shared.application(
        UIApplication.shared,
        open: url,
        sourceApplication: nil,
        annotation: [UIApplication.OpenURLOptionsKey.annotation]
    )
}

ขั้นตอนที่ 7: เพิ่มเหตุการณ์ในแอพ

เหตุการณ์ในแอพของคุณจะได้รับการติดตามด้วย 3 วิธี ดังนี้

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

เหตุการณ์แบบลงบันทึกโดยอัตโนมัติ

เหตุการณ์การซื้อในแอพแบบลงบันทึกโดยอัตโนมัติ

Apple มีการซื้อในแอพอยู่ 4 ประเภท ได้แก่ การซื้อผลิตภัณฑ์ที่ใช้แล้วหมดไป การซื้อผลิตภัณฑ์ที่ไม่ได้ใช้แล้วหมดไป การสมัครใช้บริการแบบต่ออายุโดยอัตโนมัติ และการสมัครใช้บริการแบบไม่ต่ออายุ หากคุณนำการซื้อในแอพไปใช้กับ StoreKit 1 เราจะลงบันทึกการซื้อในแอพแต่ละประเภทเหล่านี้โดยอัตโนมัติ หากคุณนำการซื้อในแอพไปใช้กับ StoreKit 2 เราจะลงบันทึกการสมัครใช้บริการแบบต่ออายุโดยอัตโนมัติ การสมัครใช้บริการแบบไม่ต่ออายุ และผลิตภัณฑ์ที่ซื้อครั้งเดียวแล้วใช้ได้ต่อเนื่องโดยอัตโนมัติ หากคุณต้องการให้ลงบันทึกการซื้อผลิตภัณฑ์ที่ใช้แล้วหมดไปด้วย คุณจะต้องเพิ่มคีย์ SKIncludeConsumableInAppPurchaseHistory ลงใน Info.plist ของคุณ ดังนี้

<key>SKIncludeConsumableInAppPurchaseHistory</key>

<true/>

ใน StoreKit 1 เราจะลงบันทึกเหตุการณ์โดยอัตโนมัติเมื่อผู้ใช้ซื้อผลิตภัณฑ์สำเร็จ กู้คืนผลิตภัณฑ์สำเร็จ หรือพยายามซื้อผลิตภัณฑ์แต่ซื้อไม่สำเร็จ ใน StoreKit 2 เราจะลงบันทึกเหตุการณ์โดยอัตโนมัติเมื่อผู้ใช้ซื้อผลิตภัณฑ์หรือกู้คืนผลิตภัณฑ์สำเร็จ หากคุณต้องการให้ลงบันทึกเมื่อผู้ใช้ซื้อไม่สำเร็จใน Store Kit 2 ด้วย เราก็มี API ที่คุณต้องเรียกใช้ด้วยตนเองไว้ให้บริการ คุณสามารถเรียกใช้ API นี้ในขั้นตอนการซื้อใน StoreKit 2 ของคุณโดยทำตามวิธีต่อไปนี้

do {
   let result = try await product.purchase()
   switch result {
   case .success(let verificationResult):
       // Handle success case
   case .pending:
       // Handle pending case
   default:
       AppEvents.shared.logFailedStoreKit2Purchase(product.id)
   }
} catch {
   AppEvents.shared.logFailedStoreKit2Purchase(product.id)
}

รับการยินยอมสำหรับอุปกรณ์

ตั้งแต่ iOS 14.5 เป็นต้นไป คุณจะต้องตั้งค่า isAdvertiserTrackingEnabled และลงบันทึกแต่ละครั้งที่อนุญาตให้อุปกรณ์แชร์ข้อมูลกับ Facebook

หากอุปกรณ์ให้การยินยอม ให้ตั้งค่า Settings.shared.isAdvertiserTrackingEnabled = true

หากอุปกรณ์ไม่อนุญาตให้ติดตาม ให้ตั้งค่า Settings.shared.isAdvertiserTrackingEnabled = false

<key>FacebookAutoLogAppEventsEnabled</key>
<false/>

<key>FacebookAdvertiserIDCollectionEnabled</key>
<false/>

เหตุการณ์แบบลงบันทึกด้วยตนเอง

หากต้องการลงบันทึกเหตุการณ์ที่กำหนดเอง ให้ทำเพียงส่งชื่อของเหตุการณ์นั้นในรูปแบบ AppEvents.Name ดังนี้

AppEvents.shared.logEvent(AppEvents.Name("battledAnOrc"))

พารามิเตอร์เหตุการณ์

Meta ได้สร้างชุดพารามิเตอร์เหตุการณ์ที่เป็นประโยชน์สำหรับรวมเข้ากับเหตุการณ์แบบมาตรฐานหรือกับเหตุการณ์ที่คุณกำหนดเอง คุณยังสามารถระบุพารามิเตอร์ของคุณเองได้อีกด้วย

หากคุณต้องการใช้เหตุการณ์ในแอพเพื่อวัดผลคอนเวอร์ชั่นของโฆษณาแบบไดนามิก โปรดตั้งค่าพารามิเตอร์ fb_content_id เป็นค่าของ ID สินค้าที่ใช้ในโฆษณาแบบไดนามิกที่เกี่ยวข้อง

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

พารามิเตอร์จะส่งผ่านพจนานุกรมซึ่งมีคีย์ที่มีชื่อพารามิเตอร์อยู่ในรูปแบบ AppEvents.ParameterName และค่าจะต้องอยู่ในรูปแบบ String หรือตัวเลข (Int, Double ฯลฯ)

ขั้นตอนที่ 8: ทดสอบเหตุการณ์ของคุณ

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

1. เปิดตัวช่วยเหลือในการลงโฆษณาแอพ
2. ในเลือกแอพ ให้เลือกแอพของคุณ จากนั้นเลือกส่ง
3. เลื่อนลงไปที่ด้านล่างสุดแล้วเลือกทดสอบเหตุการณ์
4. เปิดแอพของคุณแล้วส่งเหตุการณ์ เหตุการณ์จะปรากฏบนหน้า

เรียนรู้เพิ่มเติม

• คู่มือเกี่ยวกับหลักปฏิบัติที่ดีที่สุด - ดูแอพตัวอย่างต่างๆ มากมาย รวมถึงวิธีที่แต่ละแอพจัดการกับเหตุการณ์ในแอพ
• คำถามที่พบบ่อย - ดูคำถามที่พบบ่อยของเรา
• หลักสูตร Blueprints ของ Meta: กำหนดค่า SDK และเหตุการณ์ในแอพสำหรับ iOS
• หลักสูตร Blueprints ของ Meta: ใช้เหตุการณ์ในแอพเพื่อกำหนดเป้าหมาย ปรับให้เหมาะสม และวัดผล

แอพตัวอย่าง

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