iOS

AdKit สำหรับ ADOP: iOS¶

การตั้งค่า¶

เพิ่มคีย์ GADApplicationIdentifier ลงในไฟล์ Info.plist ของโปรเจกต์ Xcode และเพิ่มค่า AdMobId (รูปแบบใน ca-app-pub-XXXXX~YYYYY) เป็นค่าของคีย์นี้ นอกจากนี้ ให้ป้อน ADOP APP_KEY เป็นค่าของคีย์ BidmadAppKey คีย์ ADOP APP_KEY สามารถพบได้ในการจัดการบัญชี > ข้อมูลของฉัน > รายละเอียด หลังจากเข้าสู่ระบบ ADOP Insight
```
        GADApplicationIdentifier
        ca-app-pub-XXXXX~YYYYY
        BidmadAppKey
        6b097551-7f78-11ed-a117-026864a21938        
```

คุณสามารถระบุการตั้งค่าจากโครงการ UMP เมื่อจัดการความยินยอมตาม GDPR

บน iOS 14 และสูงกว่า ให้เพิ่มรายการ SKAdNetwork ลงในไฟล์ Info.plist โดยอ้างอิงจากคู่มือ Preparing for iOS 14.

เพิ่มสิ่งต่อไปนี้ลงในการตั้งค่า CocoaPods ของแอปโปรเจกต์ของคุณ:

source 'https://github.com/CocoaPods/Specs.git'
source 'https://github.com/Com2uSPlatformCorp/HiveAdKit-iOS.git'
                platform :ios, '12.0'
                use_frameworks!
                inhibit_all_warnings!

                target 'MyGame-mobile' do
                        pod 'HiveAdKit_ADOP', '1.4.6'
                end

4. รันคำสั่งต่อไปนี้เพื่อใช้การตั้งค่า CocoaPod.

$pod install

Note

โปรดดูที่ คู่มือการสำรวจความเป็นส่วนตัว สำหรับข้อมูลเกี่ยวกับการกรอกแบบฟอร์มการสำรวจความเป็นส่วนตัวเมื่อแจกจ่ายแอปของคุณ.

วิธีการใช้งาน¶

กุญแจโฆษณาทดสอบใน ADOP¶

การใช้กุญแจโฆษณาทดสอบที่ ADOP ออกให้ ไม่ใช่ AdMob เป็นสิ่งจำเป็น

let rewardVideoUnitId: String =      "29e1ef67-98d2-47b3-9fa2-9192327dd75d"
let InterstitialAdUnitId: String =   "228b95a9-6f42-46d8-a40d-60f17f751eb1"
let AdaptiveBannerAdUnitId: String = "1c3e3085-333f-45af-8427-2810c26a72fc"
let AppOpenAdUnitId: String =        "0ddd6401-0f19-49ee-b1f9-63e910f92e77"

เริ่มต้น AdKit¶

ทำการเริ่มต้น AdKit.

เมื่อทำการรีเซ็ต หากคุณอยู่ในภูมิภาคยุโรปและสหราชอาณาจักร (EEA & UK) จะมีการแสดงป๊อปอัปการยินยอม GDPR โดยอัตโนมัติ ในภูมิภาคอื่น ๆ จะทำการรีเซ็ตทันที

หากเกมของคุณมุ่งเป้าไปที่ภูมิภาค EEA และสหราชอาณาจักร ให้แน่ใจว่าหน้าต่างขอความยินยอม GDPR ของคุณถูกตั้งค่าให้ตรงตาม คู่มือข้อความ GDPR.

import AdKit
// Commercial
AdKit.InitializeWithShowGDPRConsent(appKey: appKey, vc: self, bLog: false, gdprTestDeviceId: nil)
// GDPR EEA test mode
AdKit.InitializeWithShowGDPRConsent(appKey: appKey, vc: self, bLog: true, gdprTestDeviceId: gdprTestDeviceId)

การส่งข้อมูลเพิ่มเติมของผู้ใช้สามารถรวมอยู่เมื่อเกิดบันทึกการวิเคราะห์ และข้อมูลจะถูกส่งในประเภท JSONObject

let dict = Dictionary<String, Any> (dictionaryLiteral: ("level",1),("gold",100))
AdKit.SetAdditionalInfo(additionalInfo: dict)

ประเภท RewardVideo¶

โฆษณาประเภท Rewardedvideo จะให้รางวัลแก่ผู้ใช้ที่ดูวิดีโอเป็นระยะเวลาหนึ่ง และสามารถโหลดโฆษณาได้ครั้งละหนึ่งรายการ

// RewardVideo Instance Create
var rewardVideo:RewardVideo? = nil
rewardVideo = RewardVideo.initialize(vc: self, adUnitId: rewardVideoUnitId, eventHandler: self)
// RewardVideo Load
rewardVideo?.LoadAd(adPlacementInfo: "Native-RewardVideo-Load")
// RewardVideo Show
rewardVideo?.Show(adPlacementInfo: "Native-RewardVideo-Show")

นอกจากนี้, adPlacementInfo สามารถถูกส่งเป็นสตริงที่ตั้งค่าในขณะที่ Load สำเร็จหรือแสดงโฆษณาผ่าน Show

ประเภทโฆษณาแบบ Interstitial¶

โฆษณาประเภท Interstitial ใช้หน้าจอเต็มที่ปกคลุมส่วนติดต่อของเกม.

// Interstitial Instance Create
var interstitialAd:Interstitial? = nil
interstitialAd = Interstitial.initialize(vc: self, adUnitId: InterstitialAdUnitId, eventHandler: self)
// Interstitial Load
interstitialAd?.LoadAd(adPlacementInfo: "Native-Interstitial-Load")
// Interstitial Show
interstitialAd?.Show(adPlacementInfo: "Native-Interstitial-Show")

นอกจากนี้, adPlacementInfo สามารถส่งเป็นสตริงที่ตั้งค่าในขณะที่ Load สำเร็จหรือแสดงโฆษณาผ่าน Show

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

// Create AdaptiveBanner Instance
var adaptiveBanner:AdaptiveBanner? = nil
// Initialize AdaptiveBanner Instance at the Top of View
adaptiveBanner = AdaptiveBanner.initialize(vc: self, adUnitId: AdaptiveBannerAdUnitId, bannerPosition: BannerPosition.Top, eventHandler: self)
// Initialize AdaptiveBanner Instance at the Bottom of View
adaptiveBanner = AdaptiveBanner.initialize(vc: self, adUnitId: AdaptiveBannerAdUnitId, bannerPosition: BannerPosition.Bottom, eventHandler: self)
// Load AdaptiveBanner
adaptiveBanner?.LoadAd(adPlacementInfo: "Native-AdaptiveBanner-Load")
// Destroy AdaptiveBanner
adaptiveBanner?.Destroy()

// This example shows adjusting the banner position with specifiying the yPos value.
// Banner Instance Create
var adaptiveBanner: AdaptiveBanner? = null
adaptiveBanner = AdaptiveBanner.initialize(vc: self, adUnitId: AdaptiveBannerAdUnitId, yPos: yPos, eventHandler: self)

// Load AdaptiveBanner
adaptiveBanner?.LoadAd(adPlacementInfo: "Native-AdaptiveBanner-Load")

// The position is adjusted following the yPos value.
adaptiveBanner?.setPosition(yPosition:yPos)

นอกจากนี้, adPlacementInfo สามารถถูกส่งเป็นสตริงที่ตั้งค่าในขณะที่ Load สำเร็จหรือการแสดงโฆษณาผ่าน Show

โฆษณาประเภท AppOpen¶

ประเภทที่แสดงโฆษณาเมื่อสถานะของแอปเปลี่ยนจากพื้นหลังเป็นพื้นหน้า.

// Create AppOpenAd Instance
var appOpen: AppOpen? =nil
appOpen = AppOpen.initialize(vc: self, adUnitId: AppOpenAdUnitId, eventHandler: self, adPlacementInfo: "Native-AppOpen-LoadInfo")

// Automatically load & show AppOpenAd when the app comes to the foreground
appOpen?.LoadAd(adPlacementInfo: "Native-AppOpen-LoadInfo")

// Destroy AppOpenAd
appOpen?.Destroy()

โฆษณาทดสอบ¶

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

อ้างอิงจาก Google Developers เพื่อใช้โฆษณาทดสอบ

iOS