Hướng dẫn này dành cho các nhà xuất bản quan tâm đến việc thêm quảng cáo đồng hành vào hoạt động triển khai IMA Android của họ.
Điều kiện tiên quyết
- Ứng dụng Android có tích hợp SDK IMA. Hãy xem BasicExample nếu bạn chưa tích hợp ứng dụng nào có SDK.
- Một 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 xem thử, hãy tham khảo phần Câu hỏi thường gặp của chúng tôi.
Các đoạn mồi hữu ích
Nếu bạn vẫn cần triển khai SDK IMA trong ứng dụng của mình, hãy xem Hướng dẫn bắt đầu của chúng tôi.
Thêm quảng cáo đồng hành vào ứ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 không gian cho quảng cáo đó trong bố cục. Trong XML bố cục, hãy thêm phần tử ViewGroup
; ví dụ này sử dụng LinearLayout
. Ở bước sau, bạn sẽ truyền tham chiếu đến phần tử này đến AdDisplayContainer
của mình.
Nếu bạn đang tích hợp vào ứng dụng BasicExample, hãy thêm đoạn mã này vào
activity_my.xml
bên dưới com.google.android.exoplayer2.ui.PlayerView
.
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" />
Tạo CompanionAdSlot
Bước tiếp theo là tạo đối tượng CompanionAdSlot
. Sau đó, đối tượng này sẽ được thêm vào ArrayList<CompanionAdSlot>
.
AdDisplayContainer
sẽ lấy danh sách các vùng 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 ImaSdkFactory
để tạo 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);
Tạo vùng quảng cáo đồng hành cho mỗi kích thước quảng cáo đồng hành mà bạn định hiển thị trong ứng dụng của mình.
SDK IMA sẽ điền vào vùng quảng cáo đồng hành với bất kỳ quảng cáo đồng hành nào 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 chế độ xem. SDK IMA cũng hỗ trợ việc sử dụng quảng cáo đồng hành có kích thước linh hoạt.
Sau khi bạn tạo companionAdSlots
, bạn cần thêm chúng vào AdsLoader
. Các ví dụ sau đây cho biết cách thực hiện việc này tuỳ thuộc vào việc bạn đang sử dụng IMA Android BasicExample có sử dụng phần mở rộng Exoplayer-IMA hay các phương thức triển khai IMA khác không sử dụng phần mở rộng.
BasicExample
adsLoader = new ImaAdsLoader.Builder(this).setCompanionAdSlots(companionAdSlots).build();
Các phương pháp triển khai khác
adsLoader.getAdDisplayContainer().setCompanionSlots(companionAdSlots);
Vậy là xong! Ứng dụng của bạ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 hiện hỗ trợ quảng cáo đồng hành linh hoạt. Các 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ùng quảng cáo. Các quảng cáo này lấp đầy 100% chiều rộng của khung hiển thị gốc, sau đó đổi kích thước chiều cao để vừa với nội dung của quảng cáo đồng hành. Các quảng cáo này được đặt 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 khung giờ đồ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 thông số.
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);
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 thẻ của bạn thực sự trả về quảng cáo đồng hành. Để làm việc này, hãy mở thẻ trong trình duyệt web và tìm thẻ CompanionAds. Nếu thấy như vậy, hãy kiểm tra để đảm bảo 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ùng 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 bên dưới đượ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.