Câu hỏi thường gặp về SDK quảng cáo trên phương tiện truyền thông tương tác của Google
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
- Tại sao tôi không nhận lại được quảng cáo cho tất cả các định dạng?
-
Các thẻ quảng cáo thử nghiệm được thiết lập để luôn trả về quảng cáo cho các yêu cầu hợp lệ. Đây là
nhằm tạo điều kiện tích hợp cũng như giúp thử nghiệm
cách trình phát của bạn
yêu cầu và hiển thị quảng cáo. Tuy nhiên, không phải lúc nào quảng cáo cũng có sẵn ở mọi
cho trang web, tài khoản hoặc đơn vị quảng cáo của mình. Nếu quá trình tích hợp của bạn đang hoạt động
đúng cách cho thẻ thử nghiệm nhưng không phù hợp với thẻ của chính bạn, thì nguyên nhân có thể là một trong
như sau:
- Bạn đang phân phối video có định dạng không được hỗ trợ đến môi trường của mình. Ví dụ:
bạn chỉ phân phát quảng cáo HTML5 đến iOS hoặc Android.
- Nếu bạn đang sử dụng Ad Manager, mã nhà xuất bản của bạn có thể không có quảng cáo nào được nhắm mục tiêu đến
tại thời điểm này. Ngoài ra, hãy đảm bảo rằng bạn đã phê duyệt các quảng cáo có liên quan và
mẫu quảng cáo trong Ad Manager.
- Nếu bạn đang sử dụng AdSense, tiêu chí nhắm mục tiêu cho trang web hoặc trang thử nghiệm của bạn có thể
không có quảng cáo nào đang hoạt động. Nguyên nhân phổ biến nhất là việc sử dụng
các trang web riêng tư, chưa được thu thập dữ liệu.
- Nếu bạn đang sử dụng Quản lý đối tác mạng Ad Exchange và
descriptionURL chưa được đặt hoặc không thuộc sở hữu hoặc điều hành
danh sách quản lý miền, quảng cáo sẽ không phân phát tới danh sách này.
- Kiểm tra ngưỡng minCPM được xác định trong Video Ad Exchange. Đáp
CPM khá cao có thể khiến tỷ lệ đáp ứng rất thấp. Để khắc phục vấn đề này, hãy thử
xóa minCPM hoặc xóa thông số đơn vị quảng cáo khỏi yêu cầu quảng cáo
(tức là tên vị trí) để xác minh xem điều này có ảnh hưởng đến tỷ lệ lấp đầy hay không.
- Một
descriptionUrl tốt trông như thế nào?
-
Để có hiệu quả nhất, nội dung của trang mà
descriptionUrl
điểm đến không được là một tập hợp các từ hoặc cụm từ mà thay vào đó
1-3 đoạn mô tả chính xác về nội dung và vai trò của bạn trong việc cung cấp nội dung đó.
Một phương pháp đã thành công trước đây là ghép lại với nhau
descriptionUrl nội dung trang một cách linh động từ các khối được xác định trước.
Ví dụ: một vài câu về nội dung, một vài câu về
sản phẩm/dịch vụ của trang web, rồi một vài đoạn mã được xác định trước được liên kết với mỗi
Kênh AdSense (như "Giải trí" hoặc "Thể thao"). Kết quả là mỗi phần
nội dung có descriptionUrl khác biệt hợp lý liên quan đến
tệp này cung cấp cả thông tin chung (như từ mô tả thể loại) lẫn
dưới dạng thông tin cụ thể (trực tiếp là nội dung).
HTML siêu dữ liệu này phải đơn giản, ví dụ:
<html>
<head>
<title>Domain.com - Your tag line here!</title>
</head>
<body>
<h1>Descriptions</h1>
<h2>About this Content</h2>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
<h2>About Domain.com</h2>
<p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. ...</p>
</body>
</html>
- Tại sao tôi gặp lỗi "Phản hồi quảng cáo không chứa loại quảng cáo hợp lệ"?
- Lỗi này thường xuất hiện vì không có quảng cáo nào được nhắm mục tiêu đến
publisherId cụ thể (trong khoảng thời gian nhất định). Điều kiện này
có thể thay đổi trong ngày hoặc qua vài ngày khi chiến dịch bắt đầu và kết thúc.
Bạn nên kiểm tra để đảm bảo rằng quảng cáo mà bạn muốn nhắm mục tiêu chưa hết hạn và
tiêu chí nhắm mục tiêu quảng cáo đều chính xác.
Miễn là quảng cáo được yêu cầu, nhận và hiển thị đúng cách bằng cách sử dụng
publisherId thử nghiệm, bạn có thể chắc chắn rằng những quảng cáo này
được xử lý đúng cách bằng cách sử dụng publisherId trực tiếp khi quảng cáo
sẵn có.
- Bạn có thẻ quảng cáo video Ad Manager mà tôi có thể sử dụng để thử nghiệm không?
- Thẻ mẫu có sẵn trên trang thẻ mẫu.
- Tôi có nên đặt
adSlotWidth và adSlotHeight thành cùng một không
có giá trị dưới dạng sz trong thẻ quảng cáo Ad Manager của tôi không?
- Không cần thiết.
adSlotWidth và adSlotHeight
phải được đặt thành chiều rộng/chiều cao của trình phát hoặc khu vực mà bạn muốn quảng cáo của mình xuất hiện
điền. Các tham số này được AdSense sử dụng để xác định những quảng cáo có sẵn để phù hợp
vào không gian đó. Cặp khoá/giá trị sz trong thẻ quảng cáo Ad Manager của bạn là
tham số nhắm mục tiêu và không nhất thiết ảnh hưởng đến quảng cáo được phân phối
(xem thêm thông tin bên dưới).
- Thẻ quảng cáo thử nghiệm trông tuyệt vời, nhưng khi tôi chuyển thẻ này bằng thẻ quảng cáo của mình, không có quảng cáo nào xuất hiện.
-
Kiểm tra để đảm bảo rằng có gì đó được quản lý tới thẻ quảng cáo của bạn
đang yêu cầu. Cách dễ nhất để tìm hiểu là theo dõi lưu lượng truy cập HTTP. Nếu một
Hình ảnh 1x1 pixelgray.gif được trả về trong khối neo HTML,
thì bạn cần kiểm tra việc nhắm mục tiêu trong Ad Manager.
- Tôi muốn yêu cầu quảng cáo sử dụng cùng một thẻ nhiều lần, nhưng tôi chỉ nhận được quảng cáo cho lần đầu tiên
của bạn. Làm cách nào để khắc phục lỗi này?
-
Khi yêu cầu quảng cáo nhiều lần, bạn cần cho máy chủ quảng cáo biết
đây là những yêu cầu hợp lệ chứ không phải những yêu cầu trùng lặp do vô tình. SDK
thực hiện việc này cho bạn bằng 2 lệnh gọi API nhanh:
- Gọi
destroy() trên thực thể AdsManager.
Thao tác này sẽ ngăn mọi quảng cáo sau video phát khi bạn thực hiện lệnh gọi bên dưới đến
contentComplete(). Bạn sẽ nhận được một AdsManager mới
khi bạn đưa ra yêu cầu tiếp theo.
- Gọi cho
contentComplete() trên AdsLoader của bạn
thực thể. Thao tác này sẽ đặt lại SDK để yêu cầu quảng cáo mới trông không giống như một
bản sao của quảng cáo trước đó.
Sau khi thực hiện hai cuộc gọi trên, bạn có thể gọi requestAds() trên
bản sao AdsLoader của bạn để có một tập hợp quảng cáo khác phát cho
video mới.
- Làm thế nào để yêu cầu quảng cáo AdSense lớp phủ và quảng cáo toàn thời gian bằng SDK IMA?
-
Để yêu cầu quảng cáo AdSense bằng SDK, trước tiên bạn cần có được một tài khoản AdSense
thẻ quảng cáo. Bạn có thể tìm hiểu thêm về điều này trên trang AdSense
cho trang Video. Sau khi có thẻ, bạn cần làm theo các bước sau
các bước để tạo yêu cầu quảng cáo lớp phủ hoặc yêu cầu quảng cáo toàn thời gian:
Quảng cáo lớp phủ
- Trong
AdsRequest, hãy đặt ViewModes thành
NORMAL
- Trong thẻ quảng cáo, hãy thêm thông số
overlay=1.
Quảng cáo toàn thời gian
- Trong
AdsRequest, hãy đặt ViewModes thành
FULLSCREEN
- Trong thẻ quảng cáo, hãy thêm thông số
overlay=0.
- Tôi nhận được "URL nhấp chuột không hợp lệ" lỗi khi nhấp vào quảng cáo của mình. Đâu có thể là nguyên nhân?
-
Nguyên nhân phổ biến nhất gây ra lỗi này là lượt nhấp được thoát không đúng cách
URL. Nếu bạn thấy lỗi này, hãy kiểm tra để đảm bảo rằng bạn nhấp chuột
URL được thoát đúng cách trong phản hồi VAST của bạn.
- Trong SDK Android và iOS, có cách nào để toàn bộ quảng cáo dạng video có thể nhấp vào được không?
- Trải nghiệm tiêu chuẩn của người xem đối với tính năng theo dõi lượt nhấp vào toàn bộ video
của một video dành cho thiết bị di động đã nổi lên là việc nhấn vào video
tạm dừng trò chơi hoặc hiển thị các nút điều khiển trình phát. Để tránh người dùng
vô tình nhấp vào quảng cáo khi họ thực sự chỉ muốn truy cập vào
các nút điều khiển trình phát, IMA sử dụng nút Tìm hiểu thêm để cho phép
người dùng nhấp vào quảng cáo và tìm hiểu thêm về sản phẩm đang được quảng cáo.
- Tại sao tôi thấy "Tài liệu VAST trống" lỗi?
- Lỗi này xảy ra khi thẻ quảng cáo trả về một tài liệu VAST trống, cho biết rằng
rằng quảng cáo không được phân phát đúng cách. Trao đổi với người quản lý tài khoản của bạn
hoặc đại diện máy chủ quảng cáo để biết lý do tại sao thẻ quảng cáo của bạn không hoạt động.
- Tôi có thể thay đổi kích thước/văn bản của hộp Bỏ qua quảng cáo hoặc các thành phần giao diện người dùng khác không?
- SDK IMA không hỗ trợ việc thay đổi bố cục, kích thước hoặc nội dung của các phần tử trên giao diện người dùng.
Để biết thêm thông tin về các thành phần trên giao diện người dùng, hãy xem
AdsManager.uiElements.
- Tại sao tôi nhận được thông báo "Không có phương thức ảo" lỗi trong thời gian chạy là bao nhiêu?
-
Các thông báo lỗi tương tự như sau là do sử dụng phiên bản cũ gây ra
dịch vụ Google Play không có mã nhận dạng cho quảng cáo.
No virtual method
getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in
class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its
super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'
Nâng cấp lên phiên bản 4.0 trở lên (nhưng tốt nhất là phiên bản mới nhất) sẽ giải quyết được vấn đề này.
- Tôi có thể sử dụng nhiều luồng để khởi chạy và thao tác trên giao diện người dùng không?
-
Không, tất cả việc khởi chạy và thao tác trên giao diện người dùng đều phải được thực hiện trên
luồng chính. Trong Android, các đối tượng giao diện người dùng không an toàn cho luồng. Xem
Threads (Luồng) để biết thêm thông tin.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-31 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\u003cp\u003eThe test ad tags always return ads for valid requests to help with integration and testing; however, live ads might not always be available due to factors like ad targeting, formats, and publisher settings.\u003c/p\u003e\n"],["\u003cp\u003eWhen using your own ad tag, ensure it's properly trafficked and targeted in Ad Manager to avoid issues like no ads appearing or a 1x1 pixel grey.gif being returned.\u003c/p\u003e\n"],["\u003cp\u003eFor repeated ad requests using the same tag, use \u003ccode\u003edestroy()\u003c/code\u003e on the \u003ccode\u003eAdsManager\u003c/code\u003e and \u003ccode\u003econtentComplete()\u003c/code\u003e on the \u003ccode\u003eAdsLoader\u003c/code\u003e to prevent duplicate requests and ensure proper ad serving.\u003c/p\u003e\n"],["\u003cp\u003eAn "Ad response does not contain a valid ad type" error usually indicates an issue with ad targeting for your publisher ID; verify the ad's status and targeting criteria in Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eadSlotWidth\u003c/code\u003e and \u003ccode\u003eadSlotHeight\u003c/code\u003e should be set to the player's dimensions for ad fitting, while the \u003ccode\u003esz\u003c/code\u003e parameter in the Ad Manager tag is for targeting and may not directly influence creative selection.\u003c/p\u003e\n"]]],[],null,["# Google Interactive Media Ads SDK FAQs\n\n- [Why am I not getting ads back for all formats?](#1)\n- [What does a good descriptionUrl look like?](#2)\n- [Why am I receiving the error \"Ad response does not contain a valid ad type\"?](#3)\n- [Do you have an Ad Manager video ad tag that I can use for testing?](#4)\n- [Should I set the adSlotWidth and adSlotHeight to the same values\n as the sz in my Ad Manager ad tag?](#5)\n- [The demo ad tag looks great, but when I switch it with my ad tag,\n no ad appears.](#7)\n- [I want to request ads using the same tag more than once, but I\n only get ads for my first request. How do I fix this?](#8)\n- [How do I request overlay and full slot AdSense ads using the IMA\n SDK?](#9)\n- [I'm getting an \"Invalid clickthrough URL\" error when I click on my\n ad. What could be the cause?](#10)\n- [In the Android and iOS SDKs, is there a way to make the entire video\n ad clickable?](#11)\n- [Why do I see a \"VAST Document Empty\" error?](#12)\n- [Can I change the size/text of the \"Skip Ad\" box or other UI elements?](#13)\n- [Why am I getting \"No virtual method\" errors at runtime?](#14)\n- [Can I use multiple threads to initialize and manipulate the UI?](#18)\n\n*** ** * ** ***\n\nWhy am I not getting ads back for all formats?\n:\n The test ad tags are set up to always return ads for valid requests. This is\n meant to facilitate integration and make it easier to test how your player\n requests and renders ads. However, ads are not always available in every\n format for your site, account, or ad unit. If your integration is working\n properly for the test tag but not for your own tag, the cause may be one of\n the following:\n\n - You're serving videos of an unsupported format to your environment. For example, you're serving only HTML5 ads to iOS or Android.\n - If you're using Ad Manager, your publisher ID may not have any ads targeted to it at this time. Also, ensure that you have approved the relevant ads and creatives in Ad Manager.\n - If you're using AdSense, the targeting criteria for your site or test page may not have any active advertisements. The most common cause is the use of private, uncrawled websites.\n - If you're using Ad Exchange Network Partner Management and `descriptionURL` is not set or is not on the owned or operated domains management list, ads do not serve to this.\n - Check the *minCPM* thresholds defined in Ad Exchange Video. A fairly high CPM may result in very low fill rates. To correct this, try either removing the minCPM or removing the ad unit parameter from the ad request (i.e., slotname) to verify whether this is affecting the fill rate.\n\nWhat does a good `descriptionUrl` look like?\n:\n To be most effective, the content of the page that `descriptionUrl`\n points to shouldn't be a collection of words or phrases but rather\n 1-3 paragraphs actually describing the content and your role in providing it.\n One method that has been successful in the past is to stitch together\n `descriptionUrl` page content dynamically from predefined blocks.\n For example, a few sentences about the content, a few sentences about your\n site's offering, and then a few predefined snippets associated with each\n AdSense channel (like \"Entertainment\" or \"Sports\"). As a result, each piece of\n content has a reasonably distinct `descriptionUrl` associated with\n it that provides both general information (such as genre descriptors) as well\n as specific information (content about the content directly).\n\n This metadata HTML should be simple, for example:\n\n ```text\n \u003chtml\u003e\n \u003chead\u003e\n \u003ctitle\u003eDomain.com - Your tag line here!\u003c/title\u003e\n \u003c/head\u003e\n \u003cbody\u003e\n \u003ch1\u003eDescriptions\u003c/h1\u003e\n \u003ch2\u003eAbout this Content\u003c/h2\u003e\n \u003cp\u003eLorem ipsum dolor sit amet, consectetur adipiscing elit. ...\u003c/p\u003e\n \u003ch2\u003eAbout Domain.com\u003c/h2\u003e\n \u003cp\u003eLorem ipsum dolor sit amet, consectetur adipiscing elit. ...\u003c/p\u003e\n \u003c/body\u003e\n \u003c/html\u003e\n \n ```\n\nWhy am I receiving the error \"Ad response does not contain a valid ad type\"?\n: This error generally appears because no ads have been targeted to the\n specific `publisherId` (for the given time period). This condition\n may vary throughout the day, or over several days as campaigns begin and end.\n You should check that the ad you wish to target has not expired and that the\n ad targeting criteria are correct.\n As long as ads are properly requested, received, and rendered using\n the test `publisherId`, you can be sure that these ads are\n properly handled using your live `publisherId` when the ads are\n available.\n\nDo you have an Ad Manager video ad tag that I can use for testing?\n: Sample tags are available on the [sample tags](/interactive-media-ads/docs/sdks/android/client-side/tags) page.\n\nShould I set the `adSlotWidth` and `adSlotHeight` to the same\nvalues as the `sz` in my Ad Manager ad tag?\n: Not necessarily. The `adSlotWidth` and `adSlotHeight`\n must be set to the width/height of the player or area you want your ads to\n fill. They are used by AdSense to determine which ads are available to fit\n into that space. The `sz` key/value pair in your Ad Manager ad tag is\n a targeting parameter and does not necessarily affect the creative served\n (more information below).\n\nThe demo ad tag looks great, but when I switch it with my ad tag, no ad appears.\n:\n Check to ensure that something is trafficked to the ad tag you are\n requesting. The easiest way to find out is to watch the HTTP traffic. If a\n **1x1 pixel grey.gif** image is returned within an HTML anchor block,\n then you need to check your targeting in Ad Manager.\n\nI want to request ads using the same tag more than once, but I only get ads for my first\nrequest. How do I fix this?\n:\n When you request ads more than once, you need to let the ad server know\n that these are legitimate requests, and not accidental duplicates. The SDK\n does this for you with two quick API calls:\n\n 1. Call `destroy()` on your `AdsManager` instance. This prevents any post-rolls from playing when you make the below call to `contentComplete()`. You get a new `AdsManager` when you make your next request.\n 2. Call `contentComplete()` on your `AdsLoader` instance. This resets the SDK so the new ad request doesn't look like a duplicate of the previous one.\n\n\n After making the two calls above, you can call `requestAds()` on\n your `AdsLoader` instance to get another set of ads to play for your\n new video.\n\nHow do I request overlay and full slot AdSense ads using the IMA SDK?\n\n: To request AdSense ads using the SDK, you need to first obtain an AdSense\n ad tag. You can learn more about that on the [AdSense\n for Video page](//support.google.com/adsense/answer/1705822). Once you have your tag, you need to take the following\n steps to make either an overlay or a full slot ad request:\n\n **Overlay ads**\n\n 1. In your `AdsRequest`, set your ViewModes to `NORMAL`.\n 2. In your ad tag, add the parameter `overlay=1`.\n\n **Full slot ads**\n\n 1. In your `AdsRequest`, set your ViewModes to `FULLSCREEN`.\n 2. In your ad tag, add the parameter `overlay=0`.\n\nI'm getting an \"Invalid clickthrough URL\" error when I click on my ad. What could be the cause?\n:\n The most common cause for this error is an improperly escaped clickthrough\n URL. If you're seeing this error, check to make sure that your clickthrough\n URL is properly escaped in your VAST response.\n\nIn the Android and iOS SDKs, is there a way to make the entire video ad clickable?\n: As far as whole-video click tracking goes, the standard viewer experience\n for mobile video that has emerged is that tapping on a video either\n pauses it or brings up the player controls. To avoid users\n unintentionally clicking on ads when they really just want access to the\n player controls IMA uses the **Learn more** button to let\n users click on an ad and learn more about the product being advertised.\n\nWhy do I see a \"VAST Document Empty\" error?\n: This error occurs when the ad tag returns an empty VAST document, indicating\n that the ad was not served properly. Talk to your account manager\n or ad server representative to see why your ad tag is not working.\n\nCan I change the size/text of the **Skip Ad** box or other UI elements?\n: The IMA SDKs do not support changing the layout, size, or content of UI elements.\n For more details on UI elements, see `AdsManager.uiElements`.\n\nWhy am I getting \"No virtual method\" errors at runtime?\n\n: Error messages similar to the following are caused by using an older version\n of Google Play services that does not include the advertising ID.\n\n ```\n No virtual method\n getInfo()Lcom/google/android/gms/ads/identifier/AdvertisingIdClient$Info; in\n class Lcom/google/android/gms/ads/identifier/AdvertisingIdClient; or its\n super classes (declaration of 'com.google.android.gms.ads.identifier.AdvertisingIdClient'\n ```\n\n Upgrading to version 4.0 or later (but preferably the latest) solves this problem.\n\nCan I use multiple threads to initialize and manipulate the UI?\n:\n\n No, all initialization and manipulation of the UI must be done on the\n main thread. In Android, UI objects are not thread-safe. See\n [Threads](//developer.android.com/guide/components/processes-and-threads.html#Threads) for more information."]]
