SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google ยังรองรับสไตล์โฆษณาที่กำหนดเองในเครือข่ายการค้นหาด้วย หากแอปของคุณใช้ SDK โฆษณาในอุปกรณ์เคลื่อนที่ของ Google อยู่แล้ว เราขอแนะนำให้ใช้เวอร์ชัน AFSMA SDK แทน
ข้อกำหนดเบื้องต้น
- ใช้ Xcode 8.0 ขึ้นไป
- กําหนดเป้าหมายเป็น iOS 8.0 ขึ้นไป
- รหัสเว็บพร็อพเพอร์ตี้ของผู้เผยแพร่โฆษณาที่ถูกต้อง (เช่น vert-ppa-test1-srp)
- CocoaPods
นำเข้า SDK เนทีฟของ AFS
CocoaPods
นําเข้า Google-AFSNative SDK ไปยังโปรเจ็กต์ iOS โดยใช้ CocoaPods เปิด Podfile ของโปรเจ็กต์และเพิ่มบรรทัดนี้ลงในเป้าหมายของแอป
pod 'Google-AFSNative'
จากนั้นเมื่อเรียกใช้บรรทัดคำสั่ง ให้ทำดังนี้
pod install --repo-update
หากคุณเพิ่งเคยใช้ CocoaPods ให้ดูเอกสารอย่างเป็นทางการสำหรับข้อมูลเกี่ยวกับวิธีสร้างและใช้ Podfiles
ภาพรวม
หากคุณกำลังอัปเกรดเป็นเวอร์ชัน 4.0 หรือใหม่กว่าจาก 2.0.8 หรือเก่ากว่า โปรดดูคำแนะนำในการย้ายข้อมูล
เอกสารนี้ระบุขั้นตอนการผสานรวมโฆษณาเนทีฟ AFS ในแอปบนอุปกรณ์เคลื่อนที่ iOS
- คุณต้องระบุรหัสเว็บพร็อพเพอร์ตี้ของผู้เผยแพร่โฆษณา รหัสการตั้งค่าที่ต้องการ และออบเจ็กต์
GANSearchAdControllerOptions
ที่เชื่อมโยงด้วยตัวสร้างGANSearchAdController
- การเรียก
loadAds()
แต่ละครั้งหมายถึงการค้นหาใหม่ และจะทำให้ชุดโฆษณาปัจจุบันถูกยกเลิกและใช้งานไม่ได้ - ครีเอทีฟโฆษณาจัดเก็บอยู่ใน
GANAdView
- โฆษณาแทรกลงในโฆษณา
GANAdView
ด้วยเมธอดpopulateAdView
นอกเหนือจากGANAdView
ที่จะป้อนข้อมูลแล้ว ผู้โทรจะระบุadIdentifier
ซึ่งเป็นสตริงที่กำหนดเองที่ควรระบุโฆษณาโดยไม่ซ้ำกัน ภายใน API จะมีการกำหนดโฆษณาที่เฉพาะเจาะจงให้กับ adIdentifier แต่ละรายการที่ส่งผ่าน จากนั้นเมื่อใดก็ตามที่มีการส่ง adKey นั้นอีกครั้งในอนาคต โฆษณาเดิมจะถูกส่งคืน ตัวอย่างเช่น หากมีการเรียกpopulateAdView
เป็นครั้งแรกด้วย adIdentifier "keyA" การเรียกต่อไปยังpopulateAdView
แต่ละครั้งขณะส่ง "keyA" เนื่องจากadIdentifier
จะส่งผลให้มีโฆษณาเดียวกันแสดงขึ้น
- นี่คือ UIView ที่มีครีเอทีฟโฆษณาดังกล่าว
- สร้างมุมมองนี้ด้วยโฆษณาโดยใช้เมธอด
populateAdView
ในGANSearchAdController
- ส่งออบเจ็กต์นี้ไปยังตัวสร้าง
GANSearchAdController
เพื่อระบุลักษณะการทำงานของการขอและแสดงโฆษณา
- เรียกใช้เมธอด
loadAds
บนอินสแตนซ์GANSearchAdController
ด้วยออบเจ็กต์นี้เพื่อสร้างคำขอโฆษณา
- ใช้อินเทอร์เฟซนี้และส่งให้กับ
GANSearchAdController
เพื่อลงทะเบียนโค้ดเรียกกลับในหลายสถานะ
ตัวอย่างการใช้งาน
ตัวอย่างด้านล่างแสดงการสร้าง GANSearchAdController
และ GANView
เพื่อแสดงโฆษณาในตัวอย่าง ViewController
// SampleAppViewController.m implementation
#import <AFSNative/AFSNative.h>
@interface GBannerViewController () {
// The Ad Controller used by the sample application.
GANSearchAdController *_adController;
// The Ad View to display the loaded ad.
GANAdView *_adView;
}
// scrollView will be where we place our ads in this example.
@property(nonatomic, strong) UIScrollView *scrollView;
@end
...
- (void)viewDidLoad {
[super viewDidLoad];
// Create the scroll view.
...
[self.view addSubview:scrollView];
// Create a test button and link the ad request to its action.
UIButton *loadBannerButton = [UIButton buttonWithType:UIButtonTypeCustom];
...
[loadBannerButton addTarget:self
action:@selector(loadAd:)
forControlEvents:UIControlEventTouchUpInside];
[self.scrollView addSubview:loadBannerButton];
// Construct the Ad Controller.
GANSearchAdControllerOptions *options = [[GANSearchAdControllerOptions alloc] init];
options.prefetchEnabled = YES;
options.adType = GANSearchAdTypeSPA;
options.adFetchCount = 3;
_adController = [[GANSearchAdController alloc]
initWithPublisherID: @"your-client-id"
styleID: @"your-settings-id"
options: options
delegate: self];
_adView = [_adController adView];
[self.scrollView addSubview:_adView];
}
// Request ads when the test button is pressed.
- (void)loadAd:(id)sender {
// Construct the Ad Request.
GANSearchAdRequest *adRequest = [[GANSearchAdRequest alloc] init];
adRequest.query = @"some-query";
// Start loading ads. Note that the loading is asynchronous.
[_adController loadAds: adRequest];
}
// Insert ads into GANAdView if the request returns successfully.
- (void)searchAdController:(GANSearchAdController *)adController
didLoadAds:(NSInteger)numberOfAds {
if (numberOfAds <= 0) {
NSLog(@"No ads found on the server");
} else {
[_adController populateAdView:_adView identifier:@"demoAd"];
}
}
...