サーバー間: iOSクライアントのセットアップガイド
自社メディエーションは一般公開されません
Audience Networkによる自社入札は、現時点で非公開ベータ版であり、一般公開されません。この状況が変化した時点で、アップデートが提供される予定です。
それまでの間、Facebookとパートナー関係にあるメディエーションプラットフォームのうちのいずれか1つにより、Audience Network入札にアクセスできます。
このガイドでは、iOSクライアントアプリの作成方法について説明します。以下では、インタースティシャル広告でオークションリクエストを オークションサーバー に送信する場合を例として、詳細な手順を説明しています。Audience Networkインタースティシャル広告の使用法について、前もって確認しておいてください。入札では、その他にネイティブ、バナー、インタースティシャル、インストリーム動画、動画リワードの各形式がサポートされています。インタースティシャル形式以外の広告形式を使用する場合は、サーバーの設定を変更してください。
前提条件
- Audience Networkモバイルアプリ入札の概要 および モバイルアプリ入札統合のベストプラクティスを読んでおいてください。
- Android Audience Network SDK をアプリに統合し、サポートされている次の広告フォーマットのいずれかを実装すること: ネイティブ広告、ネイティブバナー広告、インタースティシャル広告、バナー広告、R動画リワード広告。
- iOS Audience Network SDK をアプリに統合し、サポートされている次の広告フォーマットのいずれかを実装すること: ネイティブ広告、ネイティブバナー広告、インタースティシャル広告、バナー広告、動画リワード広告。
iOSクライアント側の設定手順
ステップ1: iOSクライアントからのオークションリクエストの作成
ステップ2: iOSクライアントの入札レスポンスからの広告の読み込み
iOSクライアント側の設定手順
ステップ1: iOSクライアントからのオークションリクエストの作成
クライアント側でオークションリクエストに必要なパラメーターを収集し、HTTPリクエストを使用してオークションサーバーに送信する必要があります。以下は、上記の形式に従い作成した、iOS用オークションリクエストの実装例です。
- (NSMutableURLRequest *)getRequest {
NSURL *url = [NSURL URLWithString:@"${AUCTION_SERVER_ENDPOINT}"];
NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:url];
NSDictionary *buyerToken = @{@"audience_network": [FBAdSettings bidderToken]};
NSString *bundleIdentifier = [[NSBundle mainBundle] bundleIdentifier];
NSString *bundleVersion = [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleVersion"];
NSString *idfa = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
int32_t dnt = [[ASIdentifierManager sharedManager] isAdvertisingTrackingEnabled] ? 0 : 1;
NSDictionary *bodyDict = @{@"app_id": @"101",
@"placement_id": @"1",
@"bundle": bundleIdentifier,
@"bundle_version": bundleVersion,
@"ifa": idfa,
@"coppa": @0,
@"dnt": [NSNumber numberWithInt:dnt],
@"buyer_tokens": buyerToken,
@"test": @1};
NSData *bodyData = [NSJSONSerialization dataWithJSONObject:bodyDict options:0 error:nil];
[request setHTTPBody:bodyData];
[request setHTTPMethod:@"POST"];
return request;
}以下は、オークションリクエストをサーバーに送信し、サーバーレスポンスによりコールバックメソッドを呼び出す静的関数のコードスニペット例です。
NSURLSession *session = [NSURLSession sharedSession];
[[session dataTaskWithRequest: self.getRequest
completionHandler:^(NSData *data,
NSURLResponse *response,
NSError *error) {
if (!error) {
NSMutableDictionary *json = [NSJSONSerialization JSONObjectWithData:data options:0 error:nil];
if (json) {
self.placementId = json[@"placement_id"];
self.adFormat = json[@"ad_format"];
self.platformName = json[@"platform_name"];
self.platformPlacementId = json[@"platform_placement_id"];
self.payload = json[@"bid_payload"];
dispatch_async(dispatch_get_main_queue(), ^{
self.statusLabel.text = @"Ad is available";
});
} else {
NSLog(@"Requesting Error: unknow error.");
dispatch_async(dispatch_get_main_queue(), ^{
self.statusLabel.text = @"Ad is NOT available";
});
}
} else {
NSLog(@"Requesting Error: %@", error.localizedDescription);
self.placementId = nil;
self.adFormat = nil;
self.platformName = nil;
self.platformPlacementId = nil;
self.payload = nil;
dispatch_async(dispatch_get_main_queue(), ^{
self.statusLabel.text = @"Ad is NOT available";
});
}
}] resume];ステップ2: iOSクライアントの入札レスポンスからの広告の読み込み
クライアントアプリでレスポンスのパラメーターを使用して、オークションを落札したプラットフォームを通知し、広告を読み込むことができます。オークションが終了し、Audience Networkがオークションで落札した場合、レスポンスのパラメーターには、広告の読み込み元となるペイロード文字列が追加されます。適切な広告形式クラスで loadAdWithBidPayload メソッドを呼び出し、広告を読み込むことができます。以下は、オークションリクエストコールバックメソッドの実装例です。
- (IBAction)didShow:(UIButton *)sender {
if ([self.statusLabel.text isEqualToString:@"Ad is NOT available"]) {
return;
}
if (![self.platformName isEqualToString:@"audience_network"] ||
![self.adFormat isEqualToString:@"interstitial"] ||
!self.platformPlacementId) {
self.statusLabel.text = @"Ad is NOT available";
return;
}
self.interstitialAd = [[FBInterstitialAd alloc] initWithPlacementID:self.platformPlacementId];
self.interstitialAd.delegate = self;
[self.interstitialAd loadAdWithBidPayload:self.payload];
}結果として、Audience Networkが落札した場合にはサンプルアプリにより広告が読み込まれますが、その他の場合はオークションサーバーからのエラーメッセージが表示されます。