วิธีการผสานรวม SDK กิจกรรมแอปของ TikTok

อัปเดตล่าสุด: มีนาคม 2026

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

คุณจะต้องมีบัญชีโฆษณา TikTok และ ID แอป TikTok เพื่อใช้ SDK กิจกรรมแอปของ TikTok สำหรับ Android และ iOS คุณสามารถใช้แอปที่มีอยู่ได้หากมี หรือจะสร้างแอปใหม่เลยก็ได้


หมายเหตุ: ขณะนี้ SDK กิจกรรมแอปของ TikTok รองรับการตั้งค่าแบบไฮบริดกับ MMP ในบัญชีเดียวกันแล้ว คุณสามารถสร้างบัญชีโฆษณา TikTok ใหม่เพื่อผสานรวม SDK หรือใช้บัญชี MMP ที่มีอยู่เพื่อผสานรวม SDK ก็ได้

วิธีการควบรวมระบบการทำงานสำหรับ SDK กิจกรรมแอปของ TikTok

ขั้นตอนที่ 1: สร้างแอปหรือใช้แอปที่มีอยู่แล้ว และสร้าง ID แอป TikTok และข้อมูลลับของแอป

ตัวเลือกที่ 1: เพิ่ม SDK ลงในแอปที่เชื่อมต่อกับ MMP (การตั้งค่าแบบไฮบริด)

  1. เข้าสู่ระบบตัวจัดการโฆษณาบน TikTok

  2. คลิกแท็บเครื่องมือ และไปที่ตัวจัดการกิจกรรม

  3. เลือกแหล่งที่มาข้อมูล และเลือกแอปที่คุณต้องการเพื่อเพิ่มการเชื่อมต่อ SDK

    App Events SDK - screenshot 1

  4. ไปที่แท็บการตั้งค่า และคลิกเลือกพาร์ทเนอร์ใต้ SDK กิจกรรมแอปของ TikTok

    App Events SDK - screenshot 2

  5. ทำตามขั้นตอนและเพิ่ม SDK ลงในบัญชี สร้าง ID แอป TikTok และข้อมูลลับของแอป

    App Events SDK - screenshot 3

ตัวเลือกที่ 2: เพิ่ม SDK ในแอปที่สร้างขึ้นใหม่

  1. เข้าสู่ระบบตัวจัดการโฆษณาบน TikTok

  2. คลิกแท็บเครื่องมือ และไปที่ตัวจัดการกิจกรรม

  3. เลือกเชื่อมต่อแหล่งที่มาข้อมูลในเมนูนำทางด้านซ้ายบน และเลือกแอป

    App Events SDK - screenshot 4

  4. เลือก TikTok SDK เพื่อเชื่อมต่อแอปของคุณ

    App Events SDK - screenshot 5

  5. ระบุรายละเอียดของแอปและสร้างแอป ทำตามขั้นตอนและสร้าง ID แอป TikTok และข้อมูลลับของแอป

    App Events SDK - screenshot 6

ขั้นตอนที่ 2: ทำตามคำแนะนำในคู่มือศูนย์นักพัฒนา TikTok เพื่อควบรวมระบบการทำงานสำหรับ SDK กิจกรรมแอปของ TikTok

  1. ในการเริ่มต้นใช้งาน SDK คุณจำเป็นต้องมี ID แอป, ID แอป TikTok และข้อมูลลับของแอปล่วงหน้าจากขั้นตอนที่ 1

    1. ตัวอย่าง ID แอป และ ID แอป TikTok:

      TikTok App ID - screenshot

    2. ตัวอย่างข้อมูลลับของแอป:

      App secret - screenshot

  2. ดาวน์โหลด SDK ใน GitHub ขณะนี้เรารองรับ iOS SDK แบบเนทีฟ, Android SDK แบบเนทีฟ และ Unity SDK

ขั้นตอนที่ 3: การส่งกลับข้อมูลกิจกรรมผ่าน SDK

  1. หากต้องการดูรายการกิจกรรมแอปมาตรฐานทั้งหมดที่คุณสามารถบันทึกได้ รวมทั้งกิจกรรมที่บันทึกอัตโนมัติ โปรดไปที่กิจกรรมมาตรฐาน

  2. กิจกรรมที่บันทึกอัตโนมัติจะแสดงอยู่ด้านล่าง หมายเหตุ: คุณสามารถปิดกิจกรรมที่บันทึกอัตโนมัติได้ หากต้องการเรียนรู้เพิ่มเติม โปรดไปที่เอกสารนักพัฒนา SDK กิจกรรมแอป

    1. LaunchApp: เมื่อผู้ใช้เปิดแอป

    2. InstallApp: เมื่อผู้ใช้เปิดแอปเป็นครั้งแรก

    3. 2DRetention: เมื่อผู้ใช้เปิดแอปอีกครั้งในวันต่อมาหลังจากที่เปิดแอปครั้งแรก

    4. การซื้อ: การชำระเงินที่เสร็จสมบูรณ์สำหรับการซื้อแบบใช้แล้วหมดไป/ใช้แล้วไม่หมดไป/การสมัครสมาชิก

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

ข้อควรทราบพิเศษเกี่ยวกับกิจกรรมการซื้อแบบรายการบันทึกอัตโนมัติ: SDK สามารถบันทึกธุรกรรมโดยอัตโนมัติที่ทำผ่าน StoreKit (iOS) หรือ Google Play Billing (Android) ได้ หากคุณต้องการส่งคุณสมบัติและพารามิเตอร์เพิ่มเติม หรือหากคุณ ไม่ได้ใช้ช่องทางการชำระเงินแบบเนทีฟจาก Apple หรือ Google เราขอแนะนำให้คุณใช้การส่งกลับข้อมูลการซื้อแบบดำเนินการด้วยตนเอง

ขั้นตอนที่ 4: [iOS] วัดผลกิจกรรม SKAN

ในสภาพแวดล้อม SKAdNetwork (SKAN) เราแนะนำให้มี SDK เดียวในการรายงานผลมูลค่าคอนเวอร์ชัน หากคุณใช้ MMP หรือ SDK อื่นในการอัปเดตมูลค่าคอนเวอร์ชันไปยัง SKAdNetwork อย่าลืมเพิ่ม disableSKAdNetworkSupport() ในการกำหนดค่าเพื่อหลีกเลี่ยงความขัดแย้งในการอัปเดต


พิจารณาว่าคุณจำเป็นต้องเปิดใช้งานการวัดผล SKAN ของ TikTok SDK หรือไม่ในกรณีต่อไปนี้


หากคุณมี MMP:

  • MMP SDK อัปเดตมูลค่าคอนเวอร์ชัน (CV) และคุณตั้งใจที่จะใช้สคีมา SKAN ของ MMP: ให้ปิดการรองรับ SKAdNetwork ใน TikTok SDK และไม่ต้องอัปโหลดสคีมาไปที่ตัวจัดการกิจกรรม TikTok (MMP ของคุณจะยังคงเป็นแหล่งที่มาแหล่งเดียวสำหรับการอัปเดต CV และสคีมา)

หากคุณไม่มี MMP:

ตรวจสอบให้แน่ใจว่าในแอปของคุณมีเพียง SDK เดียวที่ทำการอัปเดตมูลค่าคอนเวอร์ชัน SKAN

  • SDK อื่นที่ไม่ใช่ MMP กำลังอัปเดต CV: ให้ปิดการรองรับ SKAdNetwork ใน TikTok SDK แต่ให้อัปโหลดสคีมาไปที่ตัวจัดการกิจกรรม TikTok (TikTok จะใช้สคีมาของคุณ แต่จะไม่ทำการอัปเดต CV ซ้ำ)

  • TikTok SDK รับผิดชอบในการอัปเดต CV: ให้เปิดใช้งานการรองรับ SKAdNetwork ใน TikTok SDK และอัปโหลดสคีมาไปที่ตัวจัดการกิจกรรม TikTok (TikTok จะกลายเป็นผู้ดำเนินการหลักสำหรับการอัปเดต CV ของ SKAN)

สำหรับรายละเอียดเพิ่มเติม โปรดดูเอกสารสำหรับนักพัฒนา SDK กิจกรรมแอป

ขั้นตอนที่ 5: ตรวจสอบการส่งข้อมูลกลับแบบเรียลไทม์ด้วยโหมดดีบั๊ก

ตั้งแต่ SDK เวอร์ชัน 1.5.0 เป็นต้นไป ผู้ใช้สามารถยืนยันการควบรวมระบบการทำงานสำหรับ SDK ก่อนเปิดใช้งานได้ 2 วิธี ได้แก่

  • (แนะนำ) โหมดกิจกรรมการทดสอบแบบใช้โทเค็น ซึ่งวิธีนี้ดำเนินการทั้งหมดในตัวจัดการกิจกรรม TikTok และไม่ต้องทำการแก้ไขโค้ด

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

    • โหมดดีบั๊ก: เปิด

      App Event SDK - Debug Mode ON

      โหมดดีบั๊ก: ปิด

      App Event SDK - Debug Mode OFF

ขั้นตอนที่ 6: ลงแอปเวอร์ชันใหม่ที่มี TikTok SDK ไปยัง App Store (iOS) / Play Store (Android)

คุณจะสามารถเห็นกิจกรรม SDK แสดงขึ้นในแท็บการรายงานผลบนตัวจัดการกิจกรรม เมื่อ TikTok เริ่มได้รับสัญญาณแบบเรียลไทม์จาก SDK สัญญาณที่อยู่ภายใต้โหมดทดสอบจะไม่แสดงในส่วนนี้

App Events SDK - screenshot 5

ขั้นตอนที่ 7: เริ่มแคมเปญของคุณโดยใช้ TikTok SDK

หากพบปัญหาในการควบรวมระบบการทำงานสำหรับ SDK กิจกรรมแอป คุณสามารถส่งคำขอเพื่อรับการสนับสนุนจากฝ่ายสนับสนุนลูกค้าได้ ตรวจสอบให้แน่ใจว่าได้เลือกการวัดผล แล้วเลือกหมวดหมู่ปัญหาเป็น SDK กิจกรรมแอป