컴패니언 광고

이 가이드는 Android IMA 구현에 컴패니언 광고를 추가하는 데 관심이 있는 게시자를 대상으로 합니다.

기본 요건

• IMA SDK가 통합된 Android 애플리케이션입니다. 아직 SDK가 통합된 앱이 없다면 BasicExample을 참고하세요.
• 컴패니언 광고를 반환하도록 구성된 광고 태그.
  • 샘플이 필요한 경우 FAQ를 확인하세요.

유용한 입문서

앱에서 IMA SDK를 구현해야 하는 경우 Google의 시작 가이드를 확인하세요.

앱에 컴패니언 광고 추가

컴패니언을 표시할 ViewGroup 만들기

컴패니언을 요청하기 전에 레이아웃에서 컴패니언의 공간을 만들어야 합니다. 레이아웃 XML에서 ViewGroup 요소를 추가합니다. 이 예에서는 LinearLayout를 사용합니다. 이후 단계에서 이 요소에 대한 참조를 AdDisplayContainer에 전달합니다. BasicExample 앱에 통합하는 경우 com.google.android.exoplayer2.ui.PlayerView 아래의 activity_my.xml에 추가합니다.

activity_my.xml

<LinearLayout
  android:id="@+id/companionAdSlot"
  android:layout_width="match_parent"
  android:layout_height="250dp"
  android:layout_gravity="center_horizontal"
  android:gravity="center"
  android:orientation="vertical"
  android:textAlignment="center" />

CompanionAdSlot 만들기

다음 단계는 CompanionAdSlot 객체를 빌드하는 것입니다. 이 객체는 ArrayList<CompanionAdSlot>에 추가됩니다. AdDisplayContainer는 컴패니언 광고 슬롯의 목록을 가져오므로 한 번에 여러 컴패니언 광고를 표시할 수 있습니다. CompanionAdSlot를 만들려면 ImaSdkFactory의 인스턴스를 만들어야 합니다.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

앱에 표시하려는 각 컴패니언 크기의 컴패니언 광고 슬롯을 만듭니다. IMA SDK는 VAST 응답의 크기가 보기의 높이 및 너비와 일치하는 컴패니언으로 컴패니언 광고 슬롯을 채웁니다. IMA SDK는 유동적인 크기의 컴패니언 사용도 지원합니다. companionAdSlots를 만든 후에는 AdsLoader에 추가해야 합니다. 다음 예는 Exoplayer-IMA 확장 프로그램을 사용하는 IMA Android BasicExample을 사용하는지 또는 확장 프로그램을 사용하지 않는 다른 IMA 구현을 사용하는지에 따라 방법을 보여줍니다.

BasicExample

adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();

기타 구현

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

다음은 이제 애플리케이션에 컴패니언 광고가 표시됩니다.

유동적인 컴패니언 광고 게재

이제 IMA에서 유동적인 컴패니언 광고를 지원합니다. 이러한 컴패니언 광고는 광고 슬롯의 크기에 맞게 크기를 조정할 수 있습니다. 상위 뷰 너비의 100% 를 채운 다음 컴패니언의 콘텐츠에 맞게 높이를 조정합니다. Ad Manager에서 Fluid 컴패니언 크기를 사용하여 설정됩니다. 이 값을 설정하는 위치는 다음 이미지를 참고하세요.

유동적인 컴패니언을 위해 Android 앱 업데이트

CompanionAdSlot.FLUID_SIZE를 두 매개변수로 사용하도록 CompanionAdSlot.setSize() 메서드를 업데이트하여 유동 컴패니언 슬롯을 선언할 수 있습니다.

  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  ViewGroup companionViewGroup = (ViewGroup) findViewById(R.id.companionAdSlot);

  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot();
  companionAdSlot.setContainer(companionViewGroup);
  companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);

FAQ

가이드를 따랐지만 컴패니언 광고가 표시되지 않습니다. 어떻게 해야 하나요?

먼저 태그가 실제로 컴패니언을 반환하는지 확인합니다. 이렇게 하려면 웹브라우저에서 태그를 열고 CompanionAds 태그를 찾습니다. 이러한 경우 반환되는 컴패니언의 크기가 CompanionAdSlot 객체에 전달하는 크기와 같은지 확인하세요.

이 가이드를 따르면 컴패니언 광고 슬롯이 어떻게 표시되나요?

아래의 이미지는 BasicExample 에서 만든 이미지로, 위의 콘텐츠 동영상이 재생되고 아래의 컴패니언 광고가 포함되어 있습니다.