SDK 8 Mopub Mediation Native - 修訂歷史

imported>Wikiuser 於 2021年11月18日 (四) 10:00

2021-11-18T10:00:39Z

←上個修訂		於 2021年11月18日 (四) 10:00 的修訂
行 2：		行 2：
	NativeAd 需要建立4個客製化class來串接廣告，其中 TAMediaCustomNativeAdEventSetting 為非必要，其他三個都必須加入專案內。		NativeAd 需要建立4個客製化class來串接廣告，其中 TAMediaCustomNativeAdEventSetting 為非必要，其他三個都必須加入專案內。

	[[MoPub Mediation Setting\|回MoPub教學]]		[[SDK8 MoPub Mediation Setting\|回MoPub教學]]

	== TAMediaCustomNativeAdEventAdapter(必要) ==		== TAMediaCustomNativeAdEventAdapter(必要) ==

imported>Wikiuser：/* TAMediaCustomNativeAdEvent(必要) */

2021-08-26T06:28:21Z

TAMediaCustomNativeAdEvent(必要)

←上個修訂		於 2021年8月26日 (四) 06:28 的修訂
行 212：		行 212：

	== TAMediaCustomNativeAdEvent(必要) ==		== TAMediaCustomNativeAdEvent(必要) ==
	此 class 需繼承 MPNativeCustomEvent，由 TAmedia 取得 TADNativeAd 廣告後，建立 TADNativeAdView，並透過 adapter 取得 ~~MPNativeAd~~<br>		此 class 需繼承 MPNativeCustomEvent，由 TAmedia 取得 TADNativeAd 廣告後，建立 TADNativeAdView，並透過 adapter 取得 MPNativeAd。<br>
			取得 TADNativeAd 廣告可以參考 [[NativeAd \|TADNativeAd]] 介紹，對 TADRequest 設定參數或帶入 TADNativeAdOptions。<br>
	#建立 class 繼承 MPNativeCustomEvent<br>		#建立 class 繼承 MPNativeCustomEvent<br>
	#複寫<code> - (void)requestAdWithCustomEventInfo:(NSDictionary )info adMarkup:(NSString )adMarkup</code> 在此用 TADNativeAd 去取得廣告<br>		#複寫<code> - (void)requestAdWithCustomEventInfo:(NSDictionary )info adMarkup:(NSString )adMarkup</code> 在此用 TADNativeAd 去取得廣告<br>

imported>Wikiuser：/* TAMediaCustomNativeAdEventAdapter(必要) */

2021-08-25T01:38:20Z

TAMediaCustomNativeAdEventAdapter(必要)

←上個修訂		於 2021年8月25日 (三) 01:38 的修訂
行 9：		行 9：
	#建立初始化方法，將TADNativeAd 及 TADNativeAdView 作為參數帶入，將由 TADNativeAd 拿到的 TADNativeAdContent 與 MPNativeAdConstants.h 提供的 key 值建立相對應的 dictionary 後賦予給 proerties <br>		#建立初始化方法，將TADNativeAd 及 TADNativeAdView 作為參數帶入，將由 TADNativeAd 拿到的 TADNativeAdContent 與 MPNativeAdConstants.h 提供的 key 值建立相對應的 dictionary 後賦予給 proerties <br>
	#defaultActionURL 則回傳 nil，點擊的部分將交由 TADNativeAdView 處理<br>		#defaultActionURL 則回傳 nil，點擊的部分將交由 TADNativeAdView 處理<br>
	#~~實作<code>displayContentForURL:rootViewController:completion:</code>當 user 點擊時觸發<br>~~		#將由 TADNativeAd delegate 接收到的事件 nativeAdDidClick、nativeAdDidImpression、adViewWillLeaveApplication 透過 MPNativeAdAdapterDelegate 傳回給 Mopub
	參考以下代碼<br>		參考以下代碼<br>
	<source>		<source>

imported>Wikiuser：/* TAMediaCustomNativeAdEvent(必要) */

2021-08-24T01:54:21Z

TAMediaCustomNativeAdEvent(必要)

←上個修訂		於 2021年8月24日 (二) 01:54 的修訂
行 212：		行 212：

	== TAMediaCustomNativeAdEvent(必要) ==		== TAMediaCustomNativeAdEvent(必要) ==
	此 class 需繼承 ~~MPNativeCustomEvent，用來取得~~ TAmedia ~~native ad 提供給 MoPub~~<br>		此 class 需繼承 MPNativeCustomEvent，由 TAmedia 取得 TADNativeAd 廣告後，建立 TADNativeAdView，並透過 adapter 取得 MPNativeAd<br>
	#建立 class 繼承 MPNativeCustomEvent<br>		#建立 class 繼承 MPNativeCustomEvent<br>
	#複寫<code> - (void)requestAdWithCustomEventInfo:(NSDictionary *)info</code>在此用 TADNativeAd 去取得廣告<br>		#複寫<code> - (void)requestAdWithCustomEventInfo:(NSDictionary )info adMarkup:(NSString )adMarkup</code> 在此用 TADNativeAd 去取得廣告<br>
	#~~取得廣告後用取得的 Dictionary~~ 建立 ~~TAMediaCustomNativeAdEventAdapter 後再用~~ adapter ~~建立MPNativeAd<br>~~		#取得廣告後建立 TADNativeAdView
	~~#呈現廣告前先呼叫父類別<code>precacheImagesWithURLs:completionBlock:<code/>取得image後，再呼叫<code>customNativeEvent:didLoadAd:</code>~~<br>		#透過 TADNativeAd 及 TADNativeAdView 建立 TAMediaCustomNativeAdEventAdapter，再用 adapter 建立 MPNativeAd<br>

	<source>		<source>

imported>Wikiuser：/* TAMediaCustomNativeAdRenderer(必要) */

2021-08-24T01:44:42Z

TAMediaCustomNativeAdRenderer(必要)

←上個修訂		於 2021年8月24日 (二) 01:44 的修訂
行 93：		行 93：

	== TAMediaCustomNativeAdRenderer(必要) ==		== TAMediaCustomNativeAdRenderer(必要) ==
	此 class 需實做 MPNativeAdRenderer ~~protocol，用於設置客製化事件處理的~~ class ~~(TAMediaCustomNativeAdEvent) 以及將由 adapter 取得的 Dictionary 呈現到所需的 adView 內並回傳~~<br>		此 class 需實做 MPNativeAdRenderer protocol，用於提供實際所要呈現的廣告視圖的 class<br>
	#實作<code>+ (MPNativeAdRendererConfiguration *)rendererConfigurationWithRendererSettings:(id<MPNativeAdRendererSettings>)rendererSettings</code>建立 MPNativeAdRendererConfiguration物件<br>		#實作<code>+ (MPNativeAdRendererConfiguration *)rendererConfigurationWithRendererSettings:(id<MPNativeAdRendererSettings>)rendererSettings</code>建立 MPNativeAdRendererConfiguration物件<br>
	#設置 rendering class 為本身class<br>		#設置 rendering class 為本身class<br>

imported>Wikiuser：/* TAMediaCustomNativeAdEventAdapter(必要) */

2021-08-24T01:35:42Z

TAMediaCustomNativeAdEventAdapter(必要)

←上個修訂		於 2021年8月24日 (二) 01:35 的修訂
行 5：		行 5：

	== TAMediaCustomNativeAdEventAdapter(必要) ==		== TAMediaCustomNativeAdEventAdapter(必要) ==
	此 class 是作為 TADNativeAd 與 MPNativeAd 的橋樑，將 TADNativeAd ~~轉換為~~ MPNativeAd ~~所需要的 Dictionary~~ <br>		此 class 是作為 TADNativeAd 與 MPNativeAd 的橋樑，將 TAmdia 得到的 TADNativeAd 提供給 mopub 建立 MPNativeAd <br>
	#建立一class實做 MPNativeAdAdapter protocol，protocol 有兩必須實作 property:properties 及 defaultActionURL<br>		#建立一class實做 MPNativeAdAdapter protocol，protocol 有兩必須實作 property:properties 及 defaultActionURL<br>
	#建立初始化方法，將TADNativeAd 及 TADNativeAdView 作為參數帶入，將由 TADNativeAd 拿到的 TADNativeAdContent 與 MPNativeAdConstants.h 提供的 key 值建立相對應的 dictionary 後賦予給 proerties <br>		#建立初始化方法，將TADNativeAd 及 TADNativeAdView 作為參數帶入，將由 TADNativeAd 拿到的 TADNativeAdContent 與 MPNativeAdConstants.h 提供的 key 值建立相對應的 dictionary 後賦予給 proerties <br>
行 22：		行 22：
	@property (nonatomic, readonly) NSDictionary *properties;		@property (nonatomic, readonly) NSDictionary *properties;
	@property (nonatomic, readonly) NSURL *defaultActionURL;		@property (nonatomic, readonly) NSURL *defaultActionURL;
	@property (nonatomic,strong) TADNativeAdView *nativeAdView;		@property (nonatomic, strong) TADNativeAdView *nativeAdView;
	@property (nonatomic, weak) id<MPNativeAdAdapterDelegate> delegate;		@property (nonatomic, weak) id<MPNativeAdAdapterDelegate> delegate;

imported>Wikiuser：/* TAMediaCustomNativeAdEvent(必要) */

2021-08-23T12:15:50Z

TAMediaCustomNativeAdEvent(必要)

←上個修訂		於 2021年8月23日 (一) 12:15 的修訂
行 314：		行 314：
	[self.delegate nativeCustomEvent:self didFailToLoadAdWithError:error];		[self.delegate nativeCustomEvent:self didFailToLoadAdWithError:error];
	}		}
	}

	~~- (void)dealloc {~~

	}

	@end		@end

imported>Wikiuser 於 2021年8月23日 (一) 12:13

2021-08-23T12:13:55Z

顯示變更

imported>Wikiuser：新頁面: 官方教學：[https://developers.mopub.com/networks/integrate/build-adapters-ios/#quick-start-for-native-ads 連結]
NativeAd 需要建立4個客製化class來串接廣告，其...

2021-08-23T04:03:20Z

新頁面: 官方教學：[https://developers.mopub.com/networks/integrate/build-adapters-ios/#quick-start-for-native-ads 連結] NativeAd 需要建立4個客製化class來串接廣告，其...

新頁面

官方教學：[https://developers.mopub.com/networks/integrate/build-adapters-ios/#quick-start-for-native-ads 連結] 
NativeAd 需要建立4個客製化class來串接廣告，其中 TAMediaCustomNativeAdEventSetting 為非必要，其他三個都必須加入專案內。

[[MoPub Mediation Setting|回MoPub教學]]

== TAMediaCustomNativeAdEventAdapter(必要) ==
此 class 是作為 TADNativeAd 與 MPNativeAd 的橋樑，將 TADNativeAd 轉換為 MPNativeAd 所需要的 Dictionary 
1.建立一class實做 MPNativeAdAdapter protocol，protocol 有兩必須實作 property:properties 及 defaultActionURL 
2.建立初始化方法，將TAMedia native ad作為參數帶入，將由 TAMeida native ad 拿到的 dictionary 與 MPNativeAdConstants.h 提供的 key 值建立相對應的 dictionary 後賦予給 proerties 
3.defaultActionURL 則為 TAmedia 拿到的 nurl 
4.實作<code>displayContentForURL:rootViewController:completion:</code>當 user 點擊時觸發 
參考以下代碼 
// TAMediaCustomNativeAdEventAdapter.h
#import <Foundation/Foundation.h>
#import <MoPub/MoPub.h>
#import <TAMediaAdsFramework/TAMediaAdsFramework.h>

@interface TAMediaCustomNativeAdEventAdapter : NSObject <MPNativeAdAdapter>

- (instancetype)initWithTADNativeAd:(TADNativeAd *)nativeAd;

@property (nonatomic, readonly) NSDictionary *properties;
@property (nonatomic, readonly) NSURL *defaultActionURL;
@property (nonatomic, weak) id<MPNativeAdAdapterDelegate> delegate;
@end

// TAMediaCustomNativeAdEventAdapter.m
#import "TAMediaCustomNativeAdEventAdapter.h"

@interface TAMediaCustomNativeAdEventAdapter () <TADNativeAdDelegate>
@property (nonatomic,strong) TADNativeAd *nativeAd;
@end

@implementation TAMediaCustomNativeAdEventAdapter

- (instancetype)initWithTADNativeAd:(TADNativeAd *)nativeAd {
self = [super init];
NSDictionary *tadDic = [nativeAd getNativeAdContent];
nativeAd.delegate = self;
self.nativeAd = nativeAd;
self = [self initWithTADic:tadDic];
return self;
}
- (instancetype)initWithTADic:(NSDictionary *)taDic {
self = [super init];
NSDictionary *taMeidaDicMapping = @{@"LONGSUBJECT":kAdTitleKey,
@"BODY":kAdTextKey,
@"ICONSQUARE":kAdIconImageKey,
@"IMAGE1200X627":kAdMainImageKey,
@"VIDEO":kVASTVideoKey,
@"nurl":kDefaultActionURLKey,
@"CTA":kAdCTATextKey
};

NSMutableDictionary *dic = [NSMutableDictionary new];
for (NSString *key in taDic.allKeys) {
NSString *newKey = taMeidaDicMapping[key];
if (newKey == nil) {
newKey = key;
}
[dic setObject:taDic[key] forKey:newKey];
}
_properties = dic;
_defaultActionURL = [NSURL URLWithString:taDic[@"nurl"]];
return self;
}

- (void)displayContentForURL:(NSURL *)URL rootViewController:(UIViewController *)controller {
[self.nativeAd handleClick];
if ([self.delegate respondsToSelector:@selector(nativeAdDidClick:)]) {
[self.delegate nativeAdDidClick:self];
}
}
- (void)adViewWillLeaveApplication:(TADNativeAd *)adView {
if ([self.delegate respondsToSelector:@selector(nativeAdWillLeaveApplicationFromAdapter:)]) {
[self.delegate nativeAdWillLeaveApplicationFromAdapter:self];
}
}
@end

== TAMediaCustomNativeAdRenderer ==
此 class 需實做 MPNativeAdRenderer protocol，用於設置客製化事件處理的 class (TAMediaCustomNativeAdEvent) 以及將由 adapter 取得的 Dictionary 呈現到所需的 adView 內並回傳 
1.實作<code>+ (MPNativeAdRendererConfiguration *)rendererConfigurationWithRendererSettings:(id<MPNativeAdRendererSettings>)rendererSettings</code>建立 MPNativeAdRendererConfiguration物件 
2.設置 rendering class 為本身class 
3.設置 rendererSettings 為參數傳入的rendererSettings 
4.設置 supportedCustomEvents 為 TAMediaCustomNativeAdEvent class 
5.實作<code>initWithRendererSettings:</code>設置物件viewSizeHandler，以及任何客製化設定 
6.實作<code>retrieveViewWithAdapter:</code>回傳要來呈顯在畫面上的 View 
參考以下代碼 

// TAMediaCustomNativeAdRenderer.h
#import <Foundation/Foundation.h>
#import <MoPub/MoPub.h>
@interface TAMediaCustomNativeAdRenderer : NSObject <MPNativeAdRenderer>

@property (nonatomic, readonly) MPNativeViewSizeHandler viewSizeHandler;

@end

// TAMediaCustomNativeAdRenderer.m
#import "TAMediaCustomNativeAdRenderer.h"
#import "MPNativeAdView.h"

@interface TAMediaCustomNativeAdRenderer() <MPNativeAdRendererImageHandlerDelegate>

@property (nonatomic,strong) id<MPNativeAdRendererSettings>setting;

@property (nonatomic,strong) MPNativeAdRendererImageHandler *rendererImageHandler;

@end

@implementation TAMediaCustomNativeAdRenderer

+ (MPNativeAdRendererConfiguration *)rendererConfigurationWithRendererSettings:(id<MPNativeAdRendererSettings>)rendererSettings {
MPNativeAdRendererConfiguration *config = [[MPNativeAdRendererConfiguration alloc] init];
config.rendererSettings = rendererSettings;
config.supportedCustomEvents = @[@"TAMediaCustomNativeAdEvent"];'''//設置客製化事件處理的class'''
config.rendererClass = [self class];
return config;
}

- (instancetype)initWithRendererSettings:(id<MPNativeAdRendererSettings>)rendererSettings {
self = [super init];
_viewSizeHandler = [rendererSettings.viewSizeHandler copy];
self.setting = rendererSettings;
self.rendererImageHandler = [MPNativeAdRendererImageHandler new];
self.rendererImageHandler.delegate = self;
return self;
}

- (UIView *)retrieveViewWithAdapter:(id<MPNativeAdAdapter>)adapter error:(NSError **)error {
UIView<MPNativeAdRendering> *adView = [MPNativeAdView new];
'''//MPNativeAdRendering potocol設置的項目'''
'''//需依照串接不同的Native廣告，設定不同的值'''
adView.nativeTitleTextLabel.text = adapter.properties[kAdTitleKey];
adView.nativeMainTextLabel.text = adapter.properties[kAdTextKey];
adView.nativeCallToActionTextLabel.text = adapter.properties[kAdCTATextKey];
[self.rendererImageHandler loadImageForURL:[NSURL URLWithString:[adapter.properties objectForKey:kAdIconImageKey]] intoImageView:adView.nativeIconImageView];
[self.rendererImageHandler loadImageForURL:[NSURL URLWithString:[adapter.properties objectForKey:kAdMainImageKey]] intoImageView:adView.nativeMainImageView];

'''//MPNativeAdRendering potocol以外的項目用以下方式設置'''
MPNativeAdRenderingImageLoader *imageLoader = [[MPNativeAdRenderingImageLoader alloc] initWithImageHandler:self.rendererImageHandler];
[adView layoutCustomAssetsWithProperties:adapter.properties imageLoader:imageLoader];
return adView;
}

- (BOOL)nativeAdViewInViewHierarchy
{
return YES;
}
@end

== TAMediaCustomNativeAdEvent(必要) ==
此 class 需繼承 MPNativeCustomEvent，用來取得 TAmedia native ad 提供給 MoPub 
1.建立 class 繼承 MPNativeCustomEvent 
2.複寫<code> - (void)requestAdWithCustomEventInfo:(NSDictionary *)info</code>在此用 TADNativeAd 去取得廣告 
3.取得廣告後用取得的 Dictionary 建立 TAMediaCustomNativeAdEventAdapter 後再用 adapter 建立MPNativeAd 
4.呈現廣告前先呼叫父類別<code>precacheImagesWithURLs:completionBlock:<code/>取得image後，再呼叫<code>customNativeEvent:didLoadAd:</code> 

#import <MoPub/MoPub.h>
#import <TAMediaAdsFramework/TAMediaAdsFramework.h>

@interface TAMediaCustomNativeAdEvent : MPNativeCustomEvent <TADNativeAdDelegate> {
TADNativeAd *nativeAd;
}

@end

#import "TAMediaCustomNativeAdEvent.h"
#import "TAMediaCustomNativeAdEventAdapter.h"
#import <MoPub/MoPub.h>

@implementation TAMediaCustomNativeAdEvent

- (void)requestAdWithCustomEventInfo:(NSDictionary *)info adMarkup:(NSString *)adMarkup {
TADRequest *request = [TADRequest request];
request.testing = NO;
// Type: TADGender
request.gender = kTADGenderUnknown;

// NAD 物件初始化, 帶入自訂的origin
if (!nativeAd) {
nativeAd = [[TADNativeAd alloc] initWithAdUnitId:info[@"NativeId"]];
}
// 必須要設定delegate
nativeAd.delegate = self;
// 載入廣告
[nativeAd loadRequest:request];

}

- (void)nativeAdDidReceiveAd:(TADNativeAd *)ad {
// 表示本次請求收到廣告
TAMediaCustomNativeAdEventAdapter *adapter = [[TAMediaCustomNativeAdEventAdapter alloc] initWithTADNativeAd:ad];
MPNativeAd *mpNativeAd = [[MPNativeAd alloc] initWithAdAdapter:adapter];
//藉由 getNativeAdContent 取得包含回覆內容的 NSDictionary
NSDictionary *nadDic = [nativeAd getNativeAdContent];
NSMutableArray *imageURLs = [NSMutableArray array];
for (NSString *key in nadDic.allKeys) {
if ([[key lowercaseString] hasPrefix:@"image"] || [key hasPrefix:@"ICON"]) {
if (nadDic[key] && ![nadDic[key] isEqualToString:@""]) {
NSURL *url = [NSURL URLWithString:nadDic[key]];
[imageURLs addObject:url];
}
}
}
//在呼叫delegate didloadAd前先將圖片預載
[super precacheImagesWithURLs:imageURLs completionBlock:^(NSArray *errors) {
if (errors) {
[self.delegate nativeCustomEvent:self didFailToLoadAdWithError:MPNativeAdNSErrorForImageDownloadFailure()];
} else {
[self.delegate nativeCustomEvent:self didLoadAd:mpNativeAd];
}
}];
}

- (void)nativeAd:(TADNativeAd *)ad didFailToReceiveAdWithError:(TADRequestError *)error {
if ([self.delegate respondsToSelector:@selector(nativeCustomEvent:didFailToLoadAdWithError:)]) {
[self.delegate nativeCustomEvent:self didFailToLoadAdWithError:error];
}
}

- (void)dealloc {
if (nativeAd != nil) {
nativeAd.delegate = nil;
nativeAd = nil;
}
}

@end

== TAMediaCustomNativeAdEventSetting ==
此class需實做MPNativeAdRendererSettings protocol，用來設定 viewSize，與指定需要來呈現廣告的 View，亦可使用 MPNativeAdRendererSettings 取代 
// TAMediaCustomNativeAdEventSetting.h
#import <Foundation/Foundation.h>
#import <MoPub/MoPub.h>
@interface TAMediaCustomNativeAdEventSetting : NSObject <MPNativeAdRendererSettings>

@property (nonatomic, assign) Class renderingViewClass;

@property (nonatomic, readwrite, copy) MPNativeViewSizeHandler viewSizeHandler;
@end

// TAMediaCustomNativeAdEventSetting.m
#import "TAMediaCustomNativeAdEventSetting.h"
@implementation TAMediaCustomNativeAdEventSetting
@end

SDK 8 Mopub Mediation Native - 修訂歷史

imported>Wikiuser 於 2021年11月18日 (四) 10:00

imported>Wikiuser：/* TAMediaCustomNativeAdEvent(必要) */

imported>Wikiuser：/* TAMediaCustomNativeAdEventAdapter(必要) */

imported>Wikiuser：/* TAMediaCustomNativeAdEvent(必要) */

imported>Wikiuser：/* TAMediaCustomNativeAdRenderer(必要) */

imported>Wikiuser：/* TAMediaCustomNativeAdEventAdapter(必要) */

imported>Wikiuser：/* TAMediaCustomNativeAdEvent(必要) */

imported>Wikiuser 於 2021年8月23日 (一) 12:13

imported>Wikiuser：新頁面: 官方教學：[https://developers.mopub.com/networks/integrate/build-adapters-ios/#quick-start-for-native-ads 連結] NativeAd 需要建立4個客製化class來串接廣告，其...

imported>Wikiuser：新頁面: 官方教學：[https://developers.mopub.com/networks/integrate/build-adapters-ios/#quick-start-for-native-ads 連結]
NativeAd 需要建立4個客製化class來串接廣告，其...