기본 SDK를 사용하여 클라이언트 측 광고 구현

개요

클라이언트 측 광고는 클라이언트 디바이스에서 광고 서버에 요청을 하는 것을 포함한다. 광고 동영상을 검색하는 동안 일부 버퍼링 시간이 발생할 수 있습니다. 좀 더 TV와 비슷한 경험을 원한다면서버 측 광고 삽입을 사용할 수있습니다.

클라이언트측 광고를 사용하면 광고 큐 포인트가 감지되거나 VMAP 응답의 광고 타이밍에 도달할 때까지 콘텐츠 비디오가 재생됩니다. 구성된 광고 서버에 대한 요청이 이루어지며, 이 서버는 광고 세부 정보로 응답합니다. 그런 다음 플레이어는 요청된 광고의 재생을 시작합니다.

브라이트코브 네이티브 SDK는 다음 기술에 대한 플러그인을 제공합니다.

• Google의 양방향 미디어 광고 (IMA)
• 프리휠

기본 SDK는 Google의 광고 관리자 및 게시자 (DFP) 에 대한 더블 클릭, 구글 애드 센스 네트워크를 사용할 때 생성 된 VMAP를 지원합니다.

광고 유형

동영상에 사용할 수 있는 광고의 세 가지 주요 유형이 있습니다.

선형 광고 -주요 콘텐츠 동영상을 일시 중지하고 플레이어의 전체 프레임에 표시되는 광고

비선형 광고 -메인 콘텐츠 동영상 위에 오버레이 광고가 표시됩니다. 텍스트, 그래픽 이미지 또는 비디오 오버레이 일 수 있습니다.

컴패니언 광고 -동영상 플레이어 외부에 표시되는 광고

광고 표준

표준 XML 파일을 사용하여 플레이어에게 광고를 재생할 시기와 재생할 광고를 알릴 수 있습니다. 인터랙티브 광고국 (IAB)은 동영상 플레이어와 광고 단위 간의 다음과 같은 공통 인터페이스를 마련했습니다.

동영상 광고 게재 템플릿 (VAST) -디지털 비디오 플레이어에 광고를 제공하기위한 범용 XML 스키마. 이 파일은 표시할 광고를 지정합니다.

VMAP (Video Multiple Ad Playlist) -이 파일은 프리 롤, 미드 롤, 포스트 롤 및 비선형 광고를 포함한 VAST 광고의 재생 목록을 설명합니다. 여기에서 광고 나누기가 발생하는 시기와 각 휴식 시간 동안 재생되는 광고를 지정할 수 있습니다.

동영상 플레이어 광고 게재 인터페이스 정의 (VPAID) -인터랙티브 광고 경험을 제공하기위한 공통 인터페이스를 설정합니다.

광고 용어를 처음 접하는 경우 먼저 동영상 광고학습 가이드를검토하세요.

앱에서 광고 재생하기

클라이언트 쪽 광고를 재생하려면 다음과 같이 하십시오.

1. 광고 태그 정의
2. 광고 태그 확인
3. 큐 포인트 만들기

4. 앱 빌드

   • Android 구현
   • iOS 구현

광고 태그 정의

광고 태그는 검색 및 재생할 광고를 정의합니다. 다음 형식 중 하나를 사용할 수 있습니다.

• VAST - XML 스키마에 대한 자세한 내용은 IAB VAST 사양을 참조하십시오 .
• VMAP - XML 템플릿에 대한 자세한 내용은 IAB VMAP 사양을 참조하십시오 .

광고 태그 확인

광고 태그가 유효하고 예상대로 작동하는지 확인하는 것이 좋습니다. 이렇게하면 구현 프로세스 중에 다른 문제를 디버깅하는 데 도움이됩니다.

Google에서는 광고 태그를 확인할 수 있는동영상 모음 인스펙터를제공합니다.

FreeWheel은광고 서버 응답을 확인할수 있는 광고 미리보기를 제공합니다.

큐 포인트 만들기

VMAP 광고 태그를 사용하는 경우 이 단계를 건너뛸 수 있습니다. VMAP은 광고의 재생 목록을 정의하고 광고의 재생 시기를 지정합니다. 참고로구글의 IMA 광고 규칙은 VMAP을사용합니다.

당신은 BAST 광고 태그를 사용하는 경우, 당신은 광고 삽입 시기를 플레이어에게 알리기 위해 큐 포인트를 만들어야합니다. 앱에서 이러한 항목을 만들어야 합니다. 다음은이를 수행하는 방법에 대한 몇 가지 예입니다.

Android

• 기본 IMA VAST 샘플

iOS

• 기본 IMA 샘플

안드로이드 구현

Android용 네이티브 SDK는 다음과 같은 기술을 사용하여 VMAP, VAST, 서버 측 광고 규칙 및 동반자 광고를 지원합니다.

구글 이마

Google IMA 광고 규칙을 사용하려면 다음 단계를 따르세요.

1. 광고 규칙 IMA샘플 앱을 찾아 검토하세요.
2. MainActivity.java파일을 엽니다.

3. 값을 사용하여 프로젝트를 사용자 정의하십시오. Video Cloud 라이브러리에서 콘텐츠를 검색하는 데 필요한 값은 다음과 같습니다.

   • 재생 API 정책 키
   • 계정 ID
   • 비디오 ID

4. IMA 광고에 액세스하기 위한 값 포함:

   • 광고 규칙 URL
5. 이setupGoogleIMA()메서드는 브라이트코브 IMA 플러그인과의 연결을 설정합니다.
6. GoogleIMAEventType.ADS_REQUEST_FOR_VIDEO이벤트를 들어보세요. 여기에서 광고 요청 객체를 작성하고 광고 태그 URL을 가리킵니다. 이 경우 광고 규칙 VMAP 파일입니다.
7. 이setupAdMarkers()방법은 선택 사항입니다. 이 메서드는 IMA AdManager를 호출하고 탐색 바에 광고 마커를 만들어 사용자가 광고가 언제 재생되는지 시각적으로 확인할 수 있습니다.

광고 없이 검색

사용자가 동영상을 검색하는 동안 광고 재생을 비활성화하려면 광고 없는 Seek코드 스니펫을 참조하세요.

코드 샘플

다음은 전체 코드 샘플입니다.

• 기본 IMA 패스트 플레이어 : VAST 태그를 사용하려면 앱에서 Playback API 호출에서 반환된Video객체 메타데이터에서 큐 포인트 세트를 만들어야 합니다. 메타데이터에는 Video Cloud Studio에서 생성한 광고 큐 포인트가 포함됩니다.

• IMA 광고 규칙 IMA 플레이어 : 또는 앱에서 플레이어Activity클래스에 큐 포인트 객체 세트를 만들 수 있습니다.

• 광고 규칙 IMA 와이드바인 모듈식 : 클라이언트 측 광고를 콘텐츠 보호와 결합합니다.

프리휠

이러한 광고는 FreeWheel 애드매니저 라이브러리를 구매해야 합니다.

FreeWheel 광고를 사용하려면 다음 단계를 따르세요.

1. FreeWheel에문의하여 AdManager.aar 라이브러리 아카이브를 구입하여 일반적으로 /home/ 디렉토리의 루트에 있는 libs/ 디렉터리에 설치하십시오. 안드로이드용 네이티브 SDK 및 프리휠 샘플 앱에는 프리휠 애드매니저 라이브러리 버전 6.28.0이 필요합니다.
2. FreeWheel샘플 앱을 찾아 검토하세요.
3. MainActivity.java파일을 엽니다.
4. 값을 사용하여 프로젝트를 사용자 정의하십시오. 이 샘플에서는 원격 비디오 자산을 사용합니다.

5. FreeWheel 광고에 액세스하기 위한 값 포함:

   • 광고 URL
   • 광고 네트워크 ID
   • 광고 프로필
6. 이setupFreeWheel()메서드는 브라이트코브 FreeWheel 플러그인과의 연결을 설정합니다.
7. 광고 URL을 가리 키도록 FreeWheel 컨트롤러를 구성합니다. freeWheelController.setAdURL("http://demo.v.fwmrm.net/");
8. 이는 나중에 FreeWheel AdRequestConfiguration클래스를 인스턴스화하는 데 사용됩니다.
9. FreeWheelEventType.WILL_SUBMIT_AD_REQUEST이벤트를 들어보세요. 여기서 FreeWheel 컨트롤러를 사용하고 프리롤, 미드롤, 포스트롤 및 오버레이 광고 슬롯을 설정할 수 있습니다.

광고 없이 검색

사용자가 동영상을 검색하는 동안 광고 재생을 비활성화하려면 광고 없는 Seek코드 스니펫을 참조하세요.

코드 샘플

다음은 전체 코드 샘플입니다.

• 기본 FreeWheel 플레이어

• 프리휠 와이드바인 모듈러 플레이어 : 클라이언트 측 광고를 콘텐츠 보호와 결합합니다.

iOS 구현

iOS용 네이티브 SDK는 다음 기술을 사용하여 VMAP, VAST, 서버 측 광고 규칙 및 컴패니언 광고를 지원합니다.

구글 이마

설치, 빠른 시작 및 사용에 대한 자세한 내용은 iOS용 브라이트코브 플레이어 SDK용 IMA 플러그인레퍼런스를 참조하십시오.

다음 단계에 따라 Google IMA 광고를 사용합니다.

1. 기본 IMA Player샘플 앱을 찾아 검토하세요.
2. 뷰컨트롤러파일을 엽니다.

3. 값을 사용하여 프로젝트를 사용자 정의하십시오. Video Cloud 라이브러리에서 콘텐츠를 검색하는 데 필요한 값은 다음과 같습니다.

   • 재생 API 정책 키
   • 계정 ID
   • 비디오 ID

4. IMA 광고에 액세스하기 위한 값 포함:

   • 게시자 ID
   • 언어
   • 광고 태그 URL
5. 광고 요청 정책 (VAST, VMAP 또는 서버 측 광고 규칙) 을 포함하여 적절한 IMA 설정을 사용하여 생성하세요. playbackController
6. 광고 이벤트는 라이프 사이클 이벤트를 통해 BCOVIMA 플러그인에 의해 방출됩니다. 이러한 이벤트는 BCOVIMAComponent.h파일에 정의되어 있습니다.
7. 샘플 앱에는 광고가 재생되는 동안 플레이어 컨트롤을 숨기고 광고가 완료되면 표시하는 기능이 포함되어 있습니다.

광고 없이 검색

사용자가 동영상을 검색하는 동안 광고 재생을 비활성화하려면 플러그인 참조의 광고 없이검색섹션을 참조하십시오.

코드 샘플

다음은 전체 코드 샘플입니다.

• 기본 IMA 플레이어

• 페어플레이를 지원하는 기본 IMA 플레이어 : 클라이언트 측 광고를 콘텐츠 보호와 결합합니다.

프리휠

프리휠 애드관리자 SDK는 코코아포드를 사용 하 여 설치 되지 않습니다. 대신 수동으로 프로젝트의 응용 프로그램 대상에 추가해야 합니다.

FreeWheel 광고를 사용하려면 다음 단계를 따르세요.

1. 프로젝트에 프리휠 어드매너 SDK를 수동으로 추가합니다. 자세한 단계는 기본 프리휠 플레이어의 README파일을 참조하십시오.
2. 기본 프리휠 플레이어샘플 앱을 찾아 검토하세요.
3. 뷰컨트롤러파일을 엽니다.

4. 값을 사용하여 프로젝트를 사용자 정의하십시오. Video Cloud 라이브러리에서 콘텐츠를 검색하는 데 필요한 값은 다음과 같습니다.

   • 재생 API 정책 키
   • 계정 ID
   • 비디오 ID
5. 프리휠 광고 관리자를 만듭니다. 이는 모든 광고 컨텍스트에 대한 책임이 있습니다.
6. 광고 컨텍스트 정책을 사용하여 세션 공급자 및 재생 컨트롤러를 만듭니다.
7. 자신의 FreeWheel 구성 값을 사용하여 프로젝트를 사용자 정의합니다. FreeWheel 설명서를참조하거나 FreeWheel 계정 관리자에게 문의하십시오.
8. 광고 보기, 광고 컨트롤 및 컴패니언 슬롯을 구성합니다.

광고 없이 검색

사용자가 동영상을 검색하는 동안 광고 재생을 비활성화하려면 플러그인 참조의 광고 없이검색섹션을 참조하십시오.

코드 샘플

다음은 전체 코드 샘플입니다.

• 기본 프리휠 플레이어