Thêm tính năng hỗ trợ quảng cáo đồng hành

Hướng dẫn này dành cho những nhà xuất bản muốn thêm quảng cáo đồng hành vào quá trình triển khai IMA trên Android.

Điều kiện tiên quyết

• Ứng dụng Android đã tích hợp IMA SDK. Hãy xem BasicExample nếu bạn chưa có ứng dụng đã tích hợp SDK. Nếu bạn cần trợ giúp về cách triển khai IMA SDK trong ứng dụng, hãy xem bài viết Thiết lập IMA SDK.
• Thẻ quảng cáo được định cấu hình để trả về quảng cáo đồng hành. Nếu bạn cần một mẫu, hãy xem phần Câu hỏi thường gặp.

Thêm quảng cáo đồng hành vào ứng dụng

Hãy làm theo hướng dẫn để thêm một vị trí quảng cáo đồng hành và hiển thị quảng cáo đồng hành trong ứng dụng.

Tạo ViewGroup để hiển thị quảng cáo đồng hành

Trước khi yêu cầu quảng cáo đồng hành, bạn cần tạo một không gian cho quảng cáo đó trong bố cục. Trong XML bố cục, hãy thêm một phần tử ViewGroup; ví dụ này sử dụng LinearLayout. Trong một bước sau, bạn sẽ truyền một tham chiếu đến phần tử này vào AdDisplayContainer.

Nếu bạn đang tích hợp vào ứng dụng BasicExample, hãy thêm phần này vào tệp activity_my.xml, bên dưới videoPlayerContainer.

<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" />
companion_ad_slot_snippet.xml

Tạo CompanionAdSlot

Bước tiếp theo là tạo một đối tượng CompanionAdSlot, sau đó đối tượng này sẽ được thêm vào một thực thể ArrayList<CompanionAdSlot>. Giao diện AdDisplayContainer lấy một danh sách các vị trí quảng cáo đồng hành để bạn có thể hiển thị nhiều quảng cáo đồng hành cùng một lúc. Bạn cần tạo một thực thể của lớp ImaSdkFactory để tạo đối tượng CompanionAdSlot.

public void createCompanionAdSlot(ViewGroup companionViewGroup) {
  ImaSdkFactory sdkFactory = ImaSdkFactory.getInstance();
  CompanionAdSlot companionAdSlot = sdkFactory.createCompanionAdSlot(companionViewGroup);
  companionAdSlot.setSize(300, 250);
  ArrayList<CompanionAdSlot> companionAdSlots = new ArrayList<CompanionAdSlot>();
  companionAdSlots.add(companionAdSlot);
}
CompanionAdSnippets.java

Tạo một vị trí quảng cáo đồng hành cho từng kích thước quảng cáo đồng hành mà bạn dự định hiển thị trong ứng dụng. IMA SDK sẽ điền sẵn vị trí quảng cáo đồng hành bằng mọi quảng cáo đồng hành từ phản hồi VAST có kích thước phù hợp với chiều cao và chiều rộng của khung hiển thị. IMA SDK cũng hỗ trợ sử dụng quảng cáo đồng hành có kích thước linh hoạt. Sau khi tạo companionAdSlots, hãy thêm các vị trí này vào AdsLoader. Các ví dụ sau đây cho thấy cách thực hiện việc này tuỳ thuộc vào việc bạn đang sử dụng tiện ích Exoplayer-IMA, hay các cách triển khai IMA khác không sử dụng tiện ích này.

public void setCompanionAdSlotExoPlayer(
    Context context, ArrayList<CompanionAdSlot> companionAdSlots) {
  ImaAdsLoader adsLoader =
      new ImaAdsLoader.Builder(context).setCompanionAdSlots(companionAdSlots).build();
}
CompanionAdSnippets.java

public void setCompanionAdSlot(
    AdDisplayContainer adDisplayContainer, ArrayList<CompanionAdSlot> companionAdSlots) {
  adDisplayContainer.setCompanionSlots(companionAdSlots);
}
CompanionAdSnippets.java

Vậy là xong! Ứng dụng của bạn hiện đang hiển thị quảng cáo đồng hành.

Hiển thị quảng cáo đồng hành linh hoạt

IMA hỗ trợ quảng cáo đồng hành linh hoạt. Những quảng cáo đồng hành này có thể đổi kích thước để phù hợp với kích thước của vị trí quảng cáo. Chúng sẽ lấp đầy 100% chiều rộng của khung hiển thị mẹ, sau đó đổi kích thước chiều cao để phù hợp với nội dung của quảng cáo đồng hành. Bạn có thể đặt kích thước này bằng cách sử dụng kích thước quảng cáo đồng hành Fluid trong Ad Manager. Hãy xem hình ảnh sau đây để biết vị trí đặt giá trị này.

Cập nhật ứng dụng Android cho quảng cáo đồng hành linh hoạt

Bạn có thể khai báo một vị trí quảng cáo đồng hành linh hoạt bằng cách cập nhật phương thức CompanionAdSlot.setSize() để lấy CompanionAdSlot.FLUID_SIZE làm cả hai tham số.

companionAdSlot.setSize(CompanionAdSlot.FLUID_SIZE, CompanionAdSlot.FLUID_SIZE);
CompanionAdSnippets.java

Câu hỏi thường gặp

Tôi đã làm theo hướng dẫn nhưng không thấy quảng cáo đồng hành. Tôi cần làm gì?

Trước tiên, hãy kiểm tra để đảm bảo rằng thẻ của bạn thực sự đang trả về quảng cáo đồng hành. Để thực hiện việc này, hãy mở thẻ trong trình duyệt web và tìm thẻ <CompanionAds>. Nếu bạn thấy thẻ đó, hãy kiểm tra để đảm bảo rằng kích thước của quảng cáo đồng hành được trả về có cùng kích thước với kích thước mà bạn đang truyền vào đối tượng CompanionAdSlot.

Vị trí quảng cáo đồng hành của tôi sẽ trông như thế nào khi làm theo hướng dẫn này?

Hình ảnh sau đây được tạo từ BasicExample và có video nội dung phát ở trên cùng với quảng cáo đồng hành ở bên dưới.