네이티브 광고

인모비 네이티브 광고는 앱의 콘텐츠에 원활하게 섞여 들어가 사용자 경험에 영향을 주지 않으면서 사용자 참여를 최대화합니다. 앱의 디자인과 가장 잘 맞는 레이아웃을 선택하여 사용자 지정할 수 있습니다. 인모비 네이티브 광고는 뉴스, 유틸리티 및 커뮤니케이션 앱에 이상적입니다.

인모비 네이티브 광고는 비디오 및/또는 정적 이미지를 모두 포함할 수 있습니다. 배치 위치에 따라 다음을 선택할 수 있습니다.

• 인피드 광고 - 음소거된 자동 재생 HD 비디오 또는 간단한 정적 이미지 광고입니다.
• 스플래시 광고 - 앱 실행 화면에 혼합되어 앱이 백그라운드에서 로드될 때 사용자 시간으로 수익을 창출합니다. 음소거된 자동 재생 HD 비디오 광고 또는 간단한 정적 이미지 광고가 사용될 수 있습니다.

다음의 간단한 단계에 따라 네이티브 광고를 통해 수익을 창출하십시오.

• 네이티브 광고 배치 위치 설정
• 네이티브 광고 API
• 인피드 광고 통합
• 스플래시 광고 통합
• 프리롤 광고 통합
• 고급
• 백필 구현
• 통합 테스트

네이티브 광고 배치 위치 설정

1. 네이티브 콘텐츠 배치를 생성합니다.

2. 인피드 비디오 광고 배치

   1. 네이티브 광고 레이아웃으로 STREAM을 선택합니다.
   2. 인피드 비디오의 경우 가로 세로 비율 256:135 또는 16:9를 선택합니다. 두 가로 세로 비율을 선택할 경우 비슷한 가로 세로 비율로 기본 정적 네이티브 폴백이 활성화됩니다.

   
   정적 피드 광고 배치

   1. 네이티브 광고 레이아웃으로 FEED를 선택합니다.
   2. 통합 코드에서 -(UIView*)primaryViewOfWidth:(CGFloat)width
      를 확인합니다. primaryView를 가져오는 동안 너비를 25로 지정합니다. 그러면 AdChoices 아이콘이 표시되고 광고 렌더링 이벤트가 실행됩니다.

   
   스플래시 비디오 광고 배치

   • 옵션 1 - 320*568 스플래시 광고의 경우:

     네이티브 광고 레이아웃으로 SPLASH를 선택합니다.

   • 옵션 2 - 320*480 스플래시 광고의 경우:
     1. 네이티브 광고 레이아웃으로 STREAM을 선택합니다.
     2. 가로 세로 비율 2:3을 선택합니다. 그러면 비슷한 가로 세로 비율로 기본 정적 네이티브 폴백이 활성화됩니다.

네이티브 광고 API

IMNative 클래스에는 다음 개체가 포함됩니다.

• NSString* adTitle - 광고 제목을 반환합니다.
• NSString* adDescription - 광고 설명을 반환합니다.
• UIImage* adIcon - 광고의 아이콘 이미지를 반환합니다.
• NSString* adCtaText - 광고의 CTA(Click To Action) 텍스트를 반환합니다.
• NSString* adRating - 광고 평가를 반환합니다(옵션).
• NSURL* adLandingPageUrl - 광고 연결 URL을 반환합니다.
• BOOL isAppDownload - 광고가 앱 다운로드용인지 여부를 반환합니다.
• NSString* customAdContent - 여기에는 광고의 기본 뷰 주위에 사용자화된 UI를 생성하는 데 사용될 수 있는 추가 정보(설명, 이미지 URL 등)가 있습니다.

IMNative 클래스는 다음 함수를 지원합니다.

• -(UIView*)primaryViewOfWidth:(CGFloat)width - 지정된 너비로 UIView를 반환합니다. 네이티브 광고의 메인 광고 콘텐츠입니다. 네이티브 배치를 생성하는 동안 인모비 대시보드에서 선택한 것과 동일한 가로 세로 비율의 뷰가 반환됩니다. 이 기본 뷰가 화면에 표시될 때 모든 광고노출 렌더링 이벤트도 자동으로 실행됩니다.

  배치를 생성하는 동안 피드 레이아웃을 선택한 경우 primaryView를 가져오는 동안 너비를 25로 지정하십시오. 그러면 AdChoices 아이콘이 표시되고 광고 렌더링 이벤트가 실행됩니다.

• -(void)load - 광고를 메모리에 로드하는 함수입니다.
• -(BOOL)isReady - True는 광고를 표시할 준비가 되었음을 의미합니다.
• -(void)reportAdClickAndOpenLandingPage - 이 함수는 클릭 이벤트를 실행하고 연결 페이지를 엽니다. 이 함수를 사용하는 동안 연결 페이지를 직접 열지 않아도 됩니다.
• -(void)recyclePrimaryView - 광고가 화면의 가시 영역을 벗어날 때마다 이 함수를 호출합니다. 또한 동일한 개체에 네이티브 광고를 다시 로드하기 전에 이 함수를 호출하십시오.

인피드 광고 통합

1. 인모비 SDK 헤더 파일을 가져옵니다.

   #import <inmobisdk inmobisdk.h="">
   		</inmobisdk>
   

2. 피드에 광고를 표시할 위치를 선언합니다. 아래 예에서는 4번째 위치에 광고를 표시합니다.

   #define IM_AD_INSERTION_POSITION 4
   
   

3. 다음 위치에 네이티브 광고 인스턴스를 선언합니다. ViewController.m

   @interface TableViewController () <imnativedelegate>
   @property(nonatomic,strong) IMNative *InMobiNativeAd;
   @end
   		</imnativedelegate>
   

4. 최종 ViewDidLoad 코드는 다음과 같아야 합니다.

   - (void)viewDidLoad {
       [super viewDidLoad];
       self.InMobiNativeAd = [[IMNative alloc] initWithPlacementId:<insert here="" id="" inmobi="" placement="">];
       self.InMobiNativeAd.delegate = self;
       [self.InMobiNativeAd load];
       //Your app content
   }
   		</insert>
   

5. 성공 콜백을 위해 IMNativeDelegate 메서드를 구현합니다. 성공 콜백은 광고가 화면에 표시될 준비가 되었음을 나타냅니다. 여기서는 TableView의 데이터 소스에 InMobiNativeAd 개체를 추가해야 합니다.

   -(void)nativeDidFinishLoading:(IMNative*)native{
       [self.tableData insertObject:native atIndex:IM_AD_INSERTION_POSITION];
       [self.tableView reloadData];
       NSLog(@"Native Ad did finish loading");
   }
   
   

6. 네이티브 광고 렌더링 및 광고노출 추적

   콜백 nativeAdDidFinishLoading을 가져올 때 네이티브 광고가 성공적으로 수신되었습니다. 다음 예제에서는 tableView delegate cellForRowAtIndexPath에서 adView를 가져오는 방법을 보여 줍니다.

   참고: 네이티브 광고의 기본 뷰가 화면의 가시 영역 안에 있을 때만 광고노출 이벤트가 실행됩니다.

   - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
   	InFeedTableCell *cell = (InFeedTableCell *)[tableView 
                          dequeueReusableCellWithIdentifier:@"InFeedTableCell"];
   	NSArray *nib = [[NSBundle mainBundle] loadNibNamed:@"InFeedTableCell" 
                           owner:self options:nil];
   	cell = [nib objectAtIndex:0];
   	id slide = [self.tableData objectAtIndex:indexPath.row];
   	if ([self isAdAtIndexPath:indexPath]) {
           	IMNative * currentNativeAd = slide;
           	cell.iconImageView.image = currentNativeAd.adIcon;
          		cell.titleLabel.text = currentNativeAd.adTitle;
           	cell.subTitleLabel.text = @"Sponsored";
          		cell.descriptionLabel.text = currentNativeAd.adDescription;
           	cell.ctaLabel.text = currentNativeAd.adCtaText;
   		//Calculate your feed's primaryImageViewWidth and use it to fetch and
                    Ad Primary view of same width.
           	UIView* AdPrimaryViewOfCorrectWidth = [currentNativeAd 
                  primaryViewOfWidth:primaryImageViewWidth];
   		//Set the frame of Ad Primary View same as that of your feed's Primary 
                    View
   		AdPrimaryViewOfCorrectWidth.frame = primaryImageViewFrame;
                 [cell addSubview:AdPrimaryViewOfCorrectWidth];
                 UITapGestureRecognizer *singleTapAndOpenLandingPage = 
                 [[UITapGestureRecognizer alloc] initWithTarget:currentNativeAd 
                 action:@selector(reportAdClickAndOpenLandingPage)];
           	cell.ctaLabel.userInteractionEnabled = YES;
           	[cell.ctaLabel addGestureRecognizer:singleTapAndOpenLandingPage];
       	}
   	else{
   		//Your App’s TableCell implementation
   	}
           return cell;
   }
   
   

7. 광고가 화면 영역 밖으로 나갈 때마다 네이티브 광고의 기본 뷰를 재활용해야 합니다. 이것은 메모리 사용량을 최적화하고 AdView가 앱의 네이티브 뷰와 충돌하지 않도록 하기 위한 것입니다. 광고가 가시 영역을 벗어날 때마다 InMobiNativeAd 개체의 recyclePrimaryView 메서드를 호출합니다. TableView에서는, didEndDisplayingCell 메서드에서 호출될 수 있습니다.

   - (void)tableView:(UITableView *)tableView didEndDisplayingCell:(UITableViewCell *)cell forRowAtIndexPath:(NSIndexPath *)indexPath {
       if([self isAdAtIndexPath:indexPath]){
           [self.InMobiNativeAd recyclePrimaryView];
       }
   }
   
   

   
   참고: recyclePrimaryView를 호출한 후 화면에서 이 뷰를 다시 추가하려면 이전 뷰가 재활용되었을 때 [self.InMobiNativeAd primaryViewOfWidth:<custom width="">]</custom>에서 가져와야 합니다. 8단계에서 설명한 대로 cellForRowAtIndexPath delegate 에서 추가한 경우에는 여기에서 아무 것도 수행할 필요가 없습니다.

8. 광고 새로 고침 - 사용자에 대한 광고 노출을 최적화하려면 다양한 시점에 광고를 새로 고침해야 합니다. 광고를 새로 고침하려면 동일한 순서로 다음 함수를 호출해야 합니다.

   참고: tableData에서 IMNative 개체를 제거하고 현재 광고 개체를 삭제하는 것이 중요합니다. 그런 다음 새 개체를 생성하고 개체에서 load를 호출해야 합니다. 또한 기존 개체를 삭제하기 전에 기본 뷰를 재활용해야 합니다.

   -(void)refreshInMobiStrandAd {
      [self.tableData removeObject:self.InMobiNativeAd];
      [self.tableView reloadData];
      [self.InMobiNativeAd recyclePrimaryView];
      self.InMobiNativeAd = [[IMNative alloc] initWithPlacementId:<insert here="" id="" inmobi="" placement="">];
      self.InMobiNativeAd.delegate = self;
      [self.InMobiNativeAd load];
   }
   		</insert>
   

9. 방향 변경 처리 - 방향 변경 시 광고 기본 뷰의 새 너비를 계산하고 [self.InMobiNativeAd primaryViewOfWidth:<custom width="">]</custom> 메서드를 다시 호출하여 현재 광고 기본 뷰를 새 뷰로 교체해야 합니다.

10. ViewController 클래스의 dealloc 메서드에서 InMobiNativeAd 개체와 해당 delegate 를 nil로 설정해야 합니다. 할당 취소하기 전에 뷰를 재활용하여 adView에 대한 모든 참조를 제거하십시오.

    -(void)dealloc {
    	[self.InMobiNativeAd recyclePrimaryView];
    	self.InMobiNativeAd.delegate = nil;
    	self.InMobiNativeAd = nil;
    }
    
    

스플래시 광고 통합

1. 스플래쉬 경험은 동일한 IMNative 클래스를 사용하여 구현할 수 있습니다.
2. self.InMobiNativeAd.isReady 함수를 사용하여 광고를 표시할 준비가 되었는지 확인해야 합니다. 때로는 주 스레드가 점유된 상태일 수 있으므로 nativeDidFinishLoading을 제때 수신하지 못할 수 있습니다. 그러므로 차단 기간이 경과된 직후에 광고가 준비되었는지 사전에 확인하는 것이 좋습니다.

3. 중요: 광고의 두 번째 화면이 표시되면 광고를 닫지 마십시오. nativeWillPresentScreen에서 이를 확인하고 이 delegate 가 실행되면 광고를 닫지 않을 수 있습니다. 샘플 구현은 다음과 같습니다.

   @property(nonatomic,strong) bool *isSecondScreenDisplayed;// Use this to check if second screen has to be shown or not 
   -(void)nativeWillPresentScreen:(IMNative*)native{
       NSLog(@"Native Ad will present screen");
       isSecondScreenDisplayed = YES;
   }
   
   

4. 광고를 닫기 전에 기본 뷰를 재활용해야 합니다. 다음과 같이 구현될 수 있습니다.

   @property (nonatomic, strong) UIView* SplashAdView; // Use this view to check for visibility of splash screen 
   -(void)dismissAd{
       if(isSecondScreenDisplayed){
           NSLog(@"DO NOT DISMISS THE AD WHILE THE SCREEN IS BEING DISPLAYED");
       }
       else{
           self.SplashAdView.hidden = true;
           [self.InMobiNativeAd recyclePrimaryView];
           self.InMobiNativeAd = nil;
       }
   }
   
   

프리롤 광고 통합

1. 프리롤 비디오 경험은 동일한 IMNative 클래스를 사용하여 구현할 수 있습니다. 다음 delegate 에서 광고 뷰를 닫아야 합니다.

   -(void)nativeDidFinishPlayingMedia:(IMNative *)native{
       [self dismissAd];
   }
   
   

2. 프리롤 광고는 다음과 같이 닫을 수 있습니다.

   @property (nonatomic, strong) UIView* PrerollAdView; //Use this to store the primaryView returned by the IMNative instance.
   -(void)dismissAd{
       self.PrerollAdView.hidden = true;
       [self.InMobiNativeAd recyclePrimaryView];
       self.InMobiNativeAd = nil;
   }
   
   

고급

추가 콜백을 가져오려면 다음 단계를 수행합니다. ViewController.m 파일에 다음과 같은 delegate 메서드를 구현하십시오.

/*Indicates that the naive has received the ad markup. */
- (void)nativeAdIsAvailable:(IMNative *)native {
NSLog(@"nativeAdIsAvailable");
}
-(void)nativeDidFinishLoading:(IMNative*)native{
    NSLog(@"Native Ad load Successful"); // Ad is ready to be displayed
}
-(void)native:(IMNative*)native didFailToLoadWithError:(IMRequestStatus*)error{
    NSLog(@"Native Ad load Failed"); // No Fill or error
}
-(void)nativeWillPresentScreen:(IMNative*)native{
    NSLog(@"Native Ad will present screen"); //Full Screen experience is about to be presented
}
-(void)nativeDidPresentScreen:(IMNative*)native{
    NSLog(@"Native Ad did present screen"); //Full Screen experience has been presented
}
-(void)nativeWillDismissScreen:(IMNative*)native{
    NSLog(@"Native Ad will dismiss screen"); //Full Screen experience is going to be dismissed
}
-(void)nativeDidDismissScreen:(IMNative*)native{
    NSLog(@"Native Ad did dismiss screen"); //Full Screen experience has been dismissed
}
-(void)userWillLeaveApplicationFromNative:(IMNative*)native{
    NSLog(@"User leave"); //User is about to leave the app on clicking the ad
}
-(void)native:(IMNative *)native didInteractWithParams:(NSDictionary *)params{
    NSLog(@"User clicked"); // Called when the user clicks on the ad.
}
-(void)nativeAdImpressed:(IMNative *)native{
    NSLog(@"User viewed the ad"); // Called when impression event is fired.
}
-(void)nativeDidFinishPlayingMedia:(IMNative*)native{
    NSLog(@"The Video has finished playing"); // Called when the video has finished playing. Used for preroll use-case
}
-(void)native:(IMNative *)native rewardActionCompletedWithRewards:(NSDictionary *)rewards{
    NSLog(@"Rewarded"); // Called when the user is rewarded to watch the ad.
}
-(void)userDidSkipPlayingMediaFromNative:(IMNative*) native {
    NSLog(@"User has skipped playing media"); // Called when the user has opted to skip the media being shown. 
}
-(void)native:(IMNative*)native adAudioStateChanged:(BOOL)audioStateMuted {
     if (audioStateMuted) {
        NSLog(@"Inline video-ad audio state changed to mute");
    } else {
        NSLog(@"Inline video-ad audio state changed to unmute");
    }
   //This is called when inline video audio state changes.
}

백필 구현

인모비의 SDK는 당신의 네이티브 지면을 배치할 때, HTML 방식과 Native Unit 방식을 모두 실행할 수 있습니다. 다음과 같은 사이즈의 광고를 귀사가 지정해둔 네이티브 지면에 배치할 수 있습니다.

• 320x50 HTML 배너
• 300x250 HTML 배너
• 320x480 HTML 전체 화면 배너
• 320x568 HTML 전체 화면 배너

이 기능을 설정하려면 원하는 백필 크기로 담당 파트너 관리자에게 문의해야 합니다. 또한 코드에서 다음과 같이 처리해야 합니다

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {
	InFeedTableCell *cell = (InFeedTableCell *)[tableView 
                       dequeueReusableCellWithIdentifier:@"InFeedTableCell"];
	NSArray *nib = [[NSBundle mainBundle] loadNibNamed:@"InFeedTableCell" 
                        owner:self options:nil];
	cell = [nib objectAtIndex:0];
	id slide = [self.tableData objectAtIndex:indexPath.row];
	if ([self isAdAtIndexPath:indexPath]) {
		if ([currentNativeAd.customAdContent rangeOfString:@"isHTMLResponse"].location != NSNotFound)
		 {
			IMNative * currentNativeAd = slide;
			//Depending on the selected backfill size, provide accurate width below
			UIView* AdPrimaryViewOfCorrectWidth = [currentNativeAd primaryViewOfWidth:250];
			AdPrimaryViewOfCorrectWidth.frame = primaryImageViewFrame;
           		[cell addSubview:AdPrimaryViewOfCorrectWidth];
		}
		else
		{
        		IMNative * currentNativeAd = slide;
        		cell.iconImageView.image = currentNativeAd.adIcon;
       			cell.titleLabel.text = currentNativeAd.adTitle;
        		cell.subTitleLabel.text = @"Sponsored";
       			cell.descriptionLabel.text = currentNativeAd.adDescription;
        		cell.ctaLabel.text = currentNativeAd.adCtaText;
			//Calculate your feed's primaryImageViewWidth and use it to fetch and Ad Primary view of same width.
        		UIView* AdPrimaryViewOfCorrectWidth = [currentNativeAd primaryViewOfWidth:primaryImageViewWidth];
			//Set the frame of Ad Primary View same as that of your feed's Primary View
			AdPrimaryViewOfCorrectWidth.frame = primaryImageViewFrame;
           		 [cell addSubview:AdPrimaryViewOfCorrectWidth];
           		 UITapGestureRecognizer *singleTapAndOpenLandingPage = 
              		[[UITapGestureRecognizer alloc] initWithTarget:currentNativeAd 
              		action:@selector(reportAdClickAndOpenLandingPage)];
        		cell.ctaLabel.userInteractionEnabled = YES;
        		[cell.ctaLabel addGestureRecognizer:singleTapAndOpenLandingPage];
    		}
	}	
	else {
		//Your App’s TableCell implementation
	}
        return cell;
}

참고:

• 응답이 백필인지 확인하기 위해 customAdContent에 isHTMLResponse라는 문자열이 포함됩니다.
• HTML 배너 응답의 너비를 조정하지 마십시오. 예를 들어 300x250의 백필을 선택한 경우 제공된 너비가 하드 코딩된 250인지 확인하십시오.
• 백필 응답의 경우 CTA 버튼을 추가하지 마십시오. 이 버튼을 광고 옆에 추가하면 클릭 수로 수익이 창출되지 않습니다.

CreativeID 검색 중

진행되고 있는 모든 광고 품질 검사를 피해나와, 관련성이없고 불쾌한 소재 또는 사용자에게 혼란을주는 광고를 보여줌으로써 앱의 사용자 경험을 손상시키는 불량 광고주가 가끔 있습니다. 이러한 상황을 극복하기 위해 광고 인스턴스의 creativeID를 검색하고 InMobi 담당자에게 암호화 된 creativeID를보고 할 수 있습니다.

mNativeAd.creativeId // mNativeAd는 예제 인스턴스입니다.

통합 테스트

1. 인모비 포털에서 테스트 모드를 구성할 수 있습니다.

   Tools(도구) - Diagnostics(진단)로 이동하여 테스트 모드를 Global ON(전역 켜기) 또는 Selective ON(선택 켜기)으로 전환합니다.

   광고 단위를 처음으로 통합하는 경우	Test Mode(테스트 모드)를 Global ON(전역 켜기)으로 설정합니다.
   한 세트의 장치에 대한 테스트 트래픽을 선택적으로 켜려는 경우 이 특정 광고 단위에 SDK의 이전 버전이 이미 통합되어 있으므로 테스트를 일부 장치에만 제한해야 합니다.	Test Mode(테스트 모드)를 Selective ON(선택 켜기)으로 설정합니다. 장치 섹션에서: Device ID(장치 ID) 상자에 장치 ID를 입력합니다. Device Name(장치 이름) 상자에 원하는 이름을 입력합니다. Add Device(장치 추가)를 클릭하여 테스트 장치를 추가합니다. 이미 장치가 구성되어 있으면 장치를 선택하고 테스트 모드를 사용할 수 있습니다.

   참고: 게시하기 전에 반드시 테스트 모드를 해제해야 합니다. 그렇지 않으면 앱에서 수익을 창출하지 못합니다.

   이제는 모두 테스트 광고를 가져올 준비가 되었습니다.

   장치 ID 가져오기

   장치 ID는 기본적으로 IDFA 또는 IFA(광고용 식별자)입니다. 장치 ID를 가져오는 가장 쉬운 방법은 SDK의 로그 수준을 "디버그"로 설정하는 것입니다. 디버그 로그를 사용하려면 아래에 표시된대로 AppDelegate.m 파일 내의 didFinishLaunchingWithOptions 메서드에 추가하십시오.

   - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
   {    
   	//Initialize InMobi SDK with your account ID
   [IMSdk initWithAccountID:@"Insert InMobi account ID here"];
   //Set log level to Debug
   [IMSdk setLogLevel:kIMSDKLogLevelDebug]; 
   	// Do your stuff.
   	return YES;
   }
   
   

   디버그 모드에서 장치 ID는 XCode 개발자 콘솔에 다음과 같이 기록됩니다. “Publisher device ID is <device-id>�</device-id>

   Device ID(장치 ID) 상자에 이 장치 ID를 입력할 수 있습니다.

2. 광고 단위 및 광고 요청의 진단 탭에서 피드백도 받게 되며, 이는 통합 과정에서 특히 유용할 수 있습니다.
3. 네이티브 광고가 성공적으로 로드되면 콘솔에 다음 키 인모비 SDK 로그가 표시되어야 합니다.

   [InMobi] InMobi SDK initialized with account id: <your account="" here="" id="" />

   [InMobi] Fetching native ad for placement id: <your here="" id="" placement="" />

   [InMobi] Publisher device id is <device here="" id="" />

   [InMobi] Native ad successfully fetched for placement id: <your here="" id="" placement="" />

4. 이제 애플리케이션에 인모비 테스트 광고가 표시됩니다.
5. 광고를 생성하기 전에 SDK가 올바르게 초기화되지 않은 경우 일반적으로 다음 로그가 표시됩니다.

   ** ERROR ** [InMobi] ___ Please initialize the SDK before creating a <ad format="" /> ad.

   ** ERROR ** [InMobi] ___ Account id cannot be null or empty. Please provide a valid Account id.

   [InMobi] Invalid account id passed to init. Please provide a valid account id.

일반 SDK 초기화 메시지

일반적인 광고 수명 주기 메시지