Đối với người dùng nâng cao, chúng tôi đã cung cấp danh sách thông số kiểu quảng cáo tìm kiếm hiện được hỗ trợ. Mã bạn tạo trong AdSense chứa tất cả các chế độ cài đặt thông số thường dùng nhất. Có 2 thông số bắt buộc là: pubId
và query
. AdSense cung cấp thông số pubId nhưng bạn phải chỉnh sửa mã và chuyển giá trị cho thông số query
. Tất cả các thông số khác là không bắt buộc và được mô tả như dưới đây.
Các loại thông số
Có 2 loại thông số:
- Thông số cấp trang áp dụng cho tất cả các đơn vị quảng cáo trên trang
- Thông số cấp đơn vị áp dụng cho các đơn vị quảng cáo riêng lẻ.
Dưới đây là một số ví dụ về kết quả từ trình tạo mã với 2 khối quảng cáo. Để định cấu hình mã này, bạn phải đặt thông số query
bắt buộc trong bản đồ pageOptions
(ví dụ: “query”: myQuery
). Đây là tất cả những gì bạn cần để bắt đầu hiển thị quảng cáo. Bạn cũng có thể đặt các thông số không bắt buộc cấp trang trong các thông số khối cấp trang và thông số cấp đơn vị riêng lẻ trong bản đồ adblock1
và adblock2
.
<div id="afscontainer2"></div>
<script type="text/javascript" charset="utf-8">
// Page level parameters
var pageOptions = {
"pubId": "partner-pub-1234567891234567",
"styleId": "1234567890",
"query": myQuery,
};
// Unit level parameters
var adblock1 = {
"container": "afscontainer1"
};
var adblock2 = {
"container": "afscontainer2"
};
_googCsa('ads', pageOptions, adblock1, adblock2);
</script>
Nội dung mô tả thông số cấp trang
Bạn chỉ cần chỉ định các thông số này một lần cho mỗi trang. Thông số cấp trang sẽ có hiệu lực đối với tất cả các đơn vị trên trang.
Bắt buộc
Thông số | Nội dung mô tả và ví dụ |
---|---|
adPage |
Bắt buộc khi người dùng chuyển đến trang kết quả tiếp theo hoặc trang kết quả trước đó
Thông số |
pubId |
Bắt buộc Đây là client-ID AdSense của bạn. pubId là một phần của client-ID, nó đứng sau 'partner-'. Ví dụ: nếu client-ID là 'partner-test-property', thì pubId là 'test-property'. Đây là giao thức chuẩn cho Quảng cáo đi kèm kết quả tìm kiếm tuỳ chỉnh (CSA). Ví dụ: 'pubId' : 'test-property' |
query |
Bắt buộc Đây là cụm từ tìm kiếm do người dùng nhập. Không được mã hoá giá trị của thông số query. Ví dụ:
|
resultsPageBaseUrl |
Bắt buộc khi có các đơn vị tìm kiếm có liên quan trên trang Chỉ định URL của trang kết quả tìm kiếm chứa cụm từ tìm kiếm là cụm từ tìm kiếm có liên quan mà người dùng đã nhấp vào. resultsPageBaseUr l có thể bao gồm các thông số riêng, ngoại trừ cụm từ tìm kiếm sẽ được thêm tự động.
Ví dụ:
|
styleId |
Bắt buộc Chỉ định mã nhận dạng của kiểu quảng cáo tìm kiếm áp dụng cho các đơn vị quảng cáo hoặc nội dung tìm kiếm có liên quan trên trang. Tìm hiểu thêm về cách sử dụng kiểu quảng cáo tìm kiếm. Xin lưu ý rằng khi đặt styleId cho một yêu cầu, quảng cáo hoặc nội dung tìm kiếm có liên quan sẽ được hiển thị với kiểu quảng cáo đó, và các thông số của kiểu cũ sẽ bị bỏ qua. Nếu styleId không được chỉ định trong yêu cầu, thì kiểu mặc định của hệ thống sẽ hiển thị. Ví dụ:
|
Không bắt buộc
Thông số | Nội dung mô tả và ví dụ |
---|---|
linkTarget |
Không bắt buộc Chỉ định xem quảng cáo sẽ mở ra trong cùng một cửa sổ hay trong một cửa sổ mới khi người dùng nhấp vào. Giá trị mặc định là '_top'. Bạn cũng có thể dùng thông số này ở cấp đơn vị.
Ví dụ: 'linkTarget' : '_blank' |
maxTermLength |
Không bắt buộc Chỉ định số lượng ký tự tối đa của một cụm từ tìm kiếm có liên quan (bao gồm cả dấu cách). Không có số lượng tối đa nếu không được đặt. Ví dụ: 'maxTermLength' : 50 |
referrerAdCreative |
Không bắt buộc Nếu sau khi nhấp vào một quảng cáo hoặc đường liên kết thuộc quyền kiểm soát của bạn trên một trang web khác, người dùng được chuyển đến trang nội dung của bạn và trang đó có chứa một Nội dung tìm kiếm có liên quan cho đơn vị Nội dung, thì bạn cần đặt thông số này thành nguyên văn văn bản mẫu quảng cáo của quảng cáo hoặc đường liên kết đó. Bạn phải tuân theo các nguyên tắc sau khi sử dụng thông số này:
Ví dụ: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam |
Không bắt buộc Chỉ định tên của tham số URL cho cụm từ tìm kiếm trên trang kết quả tìm kiếm. Giá trị mặc định là 'q' nếu không được chỉ định. Ví dụ: 'resultsPageQueryParam' : 'query' |
terms |
Không bắt buộc Thông số này cho phép bạn cung cấp một danh sách được phân tách bằng dấu phẩy gồm các cụm từ tìm kiếm có liên quan của riêng bạn sẽ được trả về cùng với một yêu cầu tìm kiếm có liên quan, mặc dù Google có thể hoặc không thể sử dụng các cụm từ được cung cấp tại đây. Ví dụ: 'terms' : 'cars rental, flight ticket' |
Chế độ cài đặt cấu hình
Thông số | Nội dung mô tả và ví dụ | |||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
adsafe |
Không bắt buộc Chỉ định quy tắc lọc mà Google cần áp dụng cho những quảng cáo khớp với cụm từ tìm kiếm. Sau đây là các chế độ cài đặt hợp lệ cho thông số adsafe và tác động của từng giá trị đến quảng cáo trả về:
Lưu ý: Theo mặc định, thông số
adsafe được đặt thành 'high'.Ví dụ: 'adsafe': 'medium' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
adtest |
Không bắt buộc Thông số adtest được dùng để cho biết rằng một yêu cầu quảng cáo là thử nghiệm. Khi thông số adtest có giá trị 'on', Google coi yêu cầu đó là thử nghiệm và không tính số lượt hiển thị quảng cáo hoặc theo dõi kết quả lượt nhấp.
Thông số Lưu ý: Hãy sử dụng thông số này khi thử nghiệm, nhưng không sử dụng nó trong các hệ thống đã chạy chính thức. Nếu không, bạn sẽ không được thanh toán cho những quảng cáo mà mình hiển thị.
Giá trị adtest mặc định là 'off'. Ví dụ: 'adtest' : 'on' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
channel |
Không bắt buộc Bạn có thể bao gồm kênh AdSense cho Tìm kiếm để theo dõi hiệu suất của các trang khác nhau. Hãy sử dụng mã nhận dạng kênh duy nhất bạn đã tạo trong tài khoản AdSense của mình. Tìm hiểu thêm về tính năng theo dõi hiệu suất quảng cáo bằng kênh tuỳ chỉnh. Phải tách biệt các kênh bằng dấu '+'. Ví dụ: 'channel' : 'testA' 'channel' : 'testA+testB' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
hl |
Không bắt buộc Thông số này xác định ngôn ngữ mà các quảng cáo được yêu cầu nên nhắm đến. Giá trị mặc định là 'en'. Google hỗ trợ tất cả các mã ngôn ngữ API Google Ads. Lưu ý: Nhà quảng cáo chỉ định ngôn ngữ mà quảng cáo của họ nhắm đến. Nếu bạn đưa thông số này vào yêu cầu của bạn, thì Google sẽ chỉ trả về những quảng cáo được nhắm đến ngôn ngữ đó hoặc được đến tất cả các ngôn ngữ nhưng không đảm bảo rằng văn bản quảng cáo sẽ xuất hiện bằng ngôn ngữ được chỉ định.
Thông thường, bạn nên đặt thông số Ví dụ: 'hl' : 'es' |
|||||||||||||||||||||||||||||||||||||||||||||||||||
ie |
Không bắt buộc
Thông số Giá trị
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe |
Không bắt buộc
Thông số Giá trị
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
personalizedAds |
Không bắt buộc Chỉ định xem người dùng có đồng ý cho phép nhà xuất bản chia sẻ thông tin cá nhân với Google cho mục đích cá nhân hoá quảng cáo hay không.
Lưu ý: Theo mặc định, thông số
personalizedAds được đặt thành 'true'.Ví dụ: 'personalizedAds': false |
Nội dung mô tả thông số cấp đơn vị
Những thông số này ảnh hưởng đến cách hiển thị các đơn vị quảng cáo riêng lẻ trên một trang cho người dùng. Có thể đặt riêng mỗi thông số cho từng đơn vị quảng cáo.
Bắt buộc
Thông số | Nội dung mô tả và ví dụ |
---|---|
container |
Bắt buộc Mã nhận dạng của vùng chứa quảng cáo trống <div id='afscontainer1'></div> nơi quảng cáo sẽ xuất hiện.
Ví dụ:
|
maxTop |
Bắt buộc
Sử dụng thông số này để chỉ định số lượng quảng cáo được hiển thị trên đơn vị quảng cáo hàng đầu. Lưu ý: Thông số này được dùng thay cho thông số
number . Đơn vị quảng cáo này phải đủ rộng để dòng đầu tiên của quảng cáo không bị che khuất. Sử dụng thông số maxTop trên bất kỳ vị trí nào khác trên trang là vi phạm chính sách.Ví dụ:
|
width |
Bắt buộc Chỉ định chiều rộng của đơn vị quảng cáo hoặc đơn vị tìm kiếm có liên quan theo pixel. Ví dụ: 'width' : '700px' 'width' : 700 |
Chế độ cài đặt cấu hình
Thông số | Nội dung mô tả và ví dụ | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback |
Không bắt buộc Chỉ định hàm JavaScript sẽ được gọi khi quảng cáo hoặc các nội dung tìm kiếm có liên quan đã tải hoặc khi không có quảng cáo hoặc nội dung tìm kiếm có liên quan nào được phân phát. Bạn nên đặt thông số này thành hàm callback JavaScript mà bạn triển khai để cho phép thực hiện hành động khi lệnh gọi quảng cáo hoàn tất. Hàm callback này có các thông số sau:
Lưu ý: Vui lòng kiểm tra hàm callback của bạn để đảm bảo nó không tạo ra bất kỳ lỗi nào, đặc biệt là những lỗi có thể ảnh hưởng đến việc tải trang của bạn.
Ví dụ về hàm callback JavaScript: var adblock1 = {
'container' : 'adblock1_div_id', 'adLoadedCallback' : function(containerName, adsLoaded, isExperimentVariant, callbackOptions) { if (adsLoaded) { try { // most likely do nothing } catch (e) { alert ("Error in callback function"); // Do something to handle error gracefully } } else { // as you always do when there is no ad coverage from Google } } }; |
||||||||
number |
Không bắt buộc Số lượng quảng cáo sẽ xuất hiện trong đơn vị này. Giá trị mặc định là '2'. Ví dụ:
|
||||||||
relatedSearches |
Không bắt buộc Số lượng cụm từ tìm kiếm có liên quan sẽ xuất hiện trong đơn vị này. Thông số này trả về tối thiểu 3 cụm từ tìm kiếm có liên quan, trừ phi được đặt thành 0. Giá trị mặc định là 0 nếu không được chỉ định. Ví dụ: 'relatedSearches' : 4 |