컴패니언 광고

본 가이드는 도움이 될 것입니다.

기본 요건

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

유용한 입문서

앱에 IMA SDK를 구현해야 하는 경우 시작 가이드를 참조하세요.

앱에 컴패니언 광고 추가

컴패니언을 표시할 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는 컴패니언 광고 슬롯 목록을 가져와 한 번에 여러 컴패니언 광고를 표시할 수 있습니다. 먼저 포드의 인스턴스를 만들어 ImaSdkFactory: CompanionAdSlot를 만듭니다. 

  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입니다. 다음 예는 사용 중인 IMA Android BasicExample의 경우 Exoplayer-IMA 확장 프로그램 또는 확장 프로그램을 사용하지 않는 기타 IMA 구현을 포함합니다.

BasicExample

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

기타 구현

adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);

다음은 이제 애플리케이션에서 컴패니언을 표시하고 있습니다. 있습니다.

유동적인 컴패니언 광고 표시

이제 IMA는 유동 컴패니언 광고를 지원합니다. 이러한 컴패니언 광고는 광고의 크기에 맞게 있습니다. 상위 뷰의 너비를 100% 채우고 컴패니언의 너비에 맞게 높이를 조절합니다. 있습니다. Ad Manager에서 Fluid 컴패니언 크기를 사용하여 설정됩니다. 자세한 내용은 다음 이미지를 참조하세요.

Ad Manager의 컴패니언 광고 설정을 보여주는 이미지 컴패니언 크기 옵션을 강조 표시합니다.

유연한 컴패니언을 위한 Android 앱 업데이트

유동적 컴패니언 슬롯을 선언하려면 CompanionAdSlot.setSize() 드림 CompanionAdSlot.FLUID_SIZE 메서드를 두 매개변수로 사용할 수 있습니다. 

  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 위에 있는 콘텐츠 동영상이 위에 있고 그 아래에는 컴패니언 광고가 포함되어 있습니다.

IMA Android 컴패니언 광고의 예시 이미지입니다.