ตั้งค่า Google Mobile Ads SDK

เลือกแพลตฟอร์ม: Android iOS Unity Flutter Android (เวอร์ชันเก่า)

หากต้องการแสดงโฆษณาและสร้างรายได้ ให้ผสานรวม Google Mobile Ads SDK เข้ากับ แอป iOS ของคุณ หากต้องการเตรียมโปรเจ็กต์ ให้คุณนำเข้าและเริ่มต้น Google Mobile Ads SDK ก่อนที่จะขอโฆษณา

คู่มือนี้ครอบคลุมการนำเข้าและการเริ่มต้น Google Mobile Ads SDK รวมถึงการเลือก รูปแบบโฆษณา

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

• ใช้ Xcode 16.0 ขึ้นไป
• กำหนดเป้าหมายเป็น iOS 13.0 ขึ้นไป

นำเข้า Google Mobile Ads SDK

หากต้องการนำเข้า Google Mobile Ads SDK ให้ทำตามขั้นตอนในส่วนใดส่วนหนึ่งต่อไปนี้

Swift Package Manager (แนะนำ)

หากต้องการเพิ่มทรัพยากร Dependency ของแพ็กเกจ ลงในโปรเจ็กต์ ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด Xcode
2. ไปที่ไฟล์ > เพิ่มทรัพยากร Dependency ของแพ็กเกจ...

3. ติดตั้งแพ็กเกจ Google Mobile Ads SDK Swift

4. ในข้อความแจ้งที่ปรากฏขึ้น ให้ค้นหารีโปซิโทรี GitHub ของแพ็กเกจ Google Mobile Ads Swift

   https://github.com/googleads/swift-package-manager-google-mobile-ads.git
   

5. เลือกเวอร์ชันของแพ็กเกจ Google Mobile Ads SDK Swift ที่ต้องการใช้ สำหรับโปรเจ็กต์ใหม่ เราขอแนะนำให้ใช้สูงสุดเป็นเวอร์ชันหลักถัดไป

CocoaPods

หากต้องการใช้ CocoaPods ให้ทำตามขั้นตอนต่อไปนี้

1. เปิด Podfile ของโปรเจ็กต์ แล้วเพิ่มบรรทัดนี้ลงในการกำหนดค่าบิลด์ target ของแอป

   pod 'Google-Mobile-Ads-SDK'
   

2. เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัล

   pod install --repo-update

กำหนดค่าเป้าหมายการติดตั้งใช้งานสำหรับ Xcode 27

Xcode 27 กำหนดให้เป้าหมายการติดตั้งใช้งานขั้นต่ำคือ iOS 15.0 สำหรับเป้าหมายทั้งหมด เนื่องจาก Google Mobile Ads SDK รองรับ iOS 13.0 การบิลด์ Xcode 27 จึงล้มเหลวเมื่อใช้ CocoaPods

หากต้องการแก้ไขปัญหานี้ โปรดทำตามขั้นตอนต่อไปนี้

1. เปิด Podfile ของโปรเจ็กต์ แล้วเพิ่มฮุก post_install ที่ตั้งค่าเป้าหมายการติดตั้งใช้งานเป็น 15.0 หากคุณมีบล็อก post_install ให้เพิ่มลูปด้านในลงในบล็อกที่มีอยู่

   ตัวอย่างต่อไปนี้จะตั้งค่าคีย์ IPHONEOS_DEPLOYMENT_TARGET เป็น 15.0 สำหรับเป้าหมายพ็อดทั้งหมด

   post_install do |installer|
     installer.pods_project.targets.each do |target|
       target.build_configurations.each do |config|
         config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'
       end
     end
   end
   

2. หากต้องการติดตั้งพ็อดใหม่ ให้เรียกใช้คำสั่งต่อไปนี้

   pod install --repo-update

ดาวน์โหลดด้วยตนเอง

หากต้องการดาวน์โหลด Google Mobile Ads SDK ด้วยตนเอง ให้ทำดังนี้

1. ดาวน์โหลด Google Mobile Ads SDK
2. แตกแพ็กเกจ googlemobileadssdkios.zip

3. เพิ่มเฟรมเวิร์กต่อไปนี้ในโปรเจ็กต์ Xcode

   • GoogleMobileAds.xcframework
   • UserMessagingPlatform.xcframework

4. ในการตั้งค่าทั่วไป ของเป้าหมาย ให้ไปที่เฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง

5. ยืนยันว่าคุณได้ตั้งค่า GoogleMobileAds.xcframework และ UserMessagingPlatform.xcframework เป็นฝังและลงชื่อ

6. ในการตั้งค่าบิลด์ของโปรเจ็กต์ ให้ทำดังนี้

   • เพิ่มเส้นทาง /usr/lib/swift ลงในเส้นทางการค้นหา Runpath
   • เพิ่มแฟล็ก Linker -ObjC ลงในแฟล็ก Linker อื่นๆ

อัปเดตไฟล์ Info.plist

เพิ่มคีย์ต่อไปนี้ในไฟล์ Info.plist ของแอป

• คีย์ GADApplicationIdentifier ที่มีค่าสตริงเป็นรหัสแอป Ad Manager ซึ่งอยู่ใน UI ของ Ad Manager และมีรูปแบบ ca-app-pub-################~##########

• คีย์ SKAdNetworkItems คีย์นี้มีค่า SKAdNetworkIdentifier สำหรับ Google cstr6suwn9.skadnetwork และ ผู้ซื้อบุคคลที่สามบางราย

ตัวอย่างที่เสร็จสมบูรณ์

<key>GADApplicationIdentifier</key>
<!-- Sample Ad Manager app ID: ca-app-pub-3940256099942544~1458002511 -->
<string>SAMPLE_APP_ID</string>
<key>SKAdNetworkItems</key>
<array>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cstr6suwn9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4fzdc2evr5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2fnua5tdw4.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ydx93a7ass.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>p78axxw29g.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v72qych5uu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ludvb6z3bs.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>cp8zw746q7.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3sh42y64q3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c6k4g5qg8m.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>s39g8k73mm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wg4vff78zm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qy4746246.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>f38h382jlk.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>hs6bdukanm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>mlmmfzh3r3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v4nxqhlyqp.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>wzmmz9fp6w.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>su67r6k2v3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>yclnxrl5pm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>t38b2kh725.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>7ug5zh24hu.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>gta9lk7p23.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>vutu7akeur.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>y5ghdn5j9k.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>v9wttpbfk9.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>n38lu8286q.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>47vhws6wlr.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbd757ywx3.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>9t245vhmpl.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>a2p9lx4jpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>22mmun2rn5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>44jx6755aq.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>k674qkevps.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4468km3ulz.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>2u9pt9hc89.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8s468mfl3y.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>klf5c3l5u5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>ppxm28t8ap.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>kbmxgpxpgc.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>uw77j35x4d.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>578prtvx9j.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>4dzt52r2t5.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>tl55sbb4fm.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>c3frkrj4fj.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>e5fvkxwrpn.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>8c4e2ghe7u.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3rd42ekr43.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>97r2b46745.skadnetwork</string>
  </dict>
  <dict>
    <key>SKAdNetworkIdentifier</key>
    <string>3qcr597p9d.skadnetwork</string>
  </dict>
</array>

แทนที่ SAMPLE_APP_ID ด้วยรหัสแอป Ad Manager ขณะทดสอบ ให้ใช้รหัสแอปตัวอย่างที่แสดงในตัวอย่างก่อนหน้า

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

เริ่มต้น Google Mobile Ads SDK

ก่อนโหลดโฆษณา ให้เริ่มต้น Google Mobile Ads SDK โดยเรียกใช้เมธอด start() จากพร็อพเพอร์ตี้ GADMobileAds.sharedInstance เมธอดนี้จะเรียกใช้ตัวแฮนเดิลการดำเนินการให้เสร็จสมบูรณ์หลังจาก Google Mobile Ads SDK และ อะแดปเตอร์สื่อกลางประมวลผลเสร็จแล้ว หรือหลังจากผ่านไป 30 วินาที

ตัวอย่างต่อไปนี้จะเริ่มต้น Google Mobile Ads SDK

Swift

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
ViewController.swift

SwiftUI

// Initialize the Google Mobile Ads SDK.
MobileAds.shared.start()
GoogleMobileAdsConsentManager.swift

Objective-C

// Initialize the Google Mobile Ads SDK.
[GADMobileAds.sharedInstance startWithCompletionHandler:nil];
ViewController.m

เมื่อเริ่มต้น Google Mobile Ads SDK อาจโหลดโฆษณาไว้ล่วงหน้าหรือเริ่มต้น SDK ของบุคคลที่สาม เมื่อเรียกใช้เมธอด startWithCompletionHandler: หากคุณต้องขอความยินยอมจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA), สหราชอาณาจักร (UK) หรือสวิตเซอร์แลนด์ ให้ตั้งค่าแฟล็กที่เฉพาะเจาะจงสำหรับคำขอ หากต้องการตั้งค่า แฟล็กที่เฉพาะเจาะจงสำหรับคำขอ โปรดตั้งค่าแฟล็กก่อนที่จะเริ่มต้น Google Mobile Ads SDK ดูรายละเอียดได้ที่การกำหนดเป้าหมาย

เลือกรูปแบบโฆษณา

หลังจากนำเข้า Google Mobile Ads SDK แล้ว คุณจะเลือกรูปแบบโฆษณาที่จะนำไปใช้ได้

Ad Manager มีรูปแบบโฆษณาต่อไปนี้

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