Đối với người dùng nâng cao, chúng tôi đã cung cấp danh sách các tham số của 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 tham 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
| Tham 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, đứng sau "partner-". Ví dụ: nếu client-ID là "partner-test-property", thì pubId sẽ 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ụ:
|
referrerAdCreative |
Bắt buộc (nếu có lưu lượng truy cập) Nếu người dùng truy cập vào trang nội dung của bạn có chứa một đơn vị nội dung tìm kiếm có liên quan từ một nguồn thuộc quyền kiểm soát của bạn (bao gồm cả mạng, dịch vụ hoặc đơn vị liên kết của bên thứ ba mà bạn hợp tác), thì bạn phải đặt tham số này thành nguyên văn văn bản mẫu quảng cáo của nguồn đó. Bạn phải tuân theo các nguyên tắc sau khi sử dụng tham số này:
Lưu ý: Tham số này là bắt buộc khi sử dụng tham số
terms.Ví dụ: 'referrerAdCreative': 'search for ads related to dental implants''referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
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. resultsPageBaseUrl 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 vị quảng cáo 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 bạn đặt styleId cho một yêu cầu, quảng cáo hoặc cụm từ tìm kiếm có liên quan sẽ hiển thị với kiểu đó và các tham 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
| Tham 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 |
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
| Tham 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.
Tham số Lưu ý:
Giá trị mặc định của tham số adtest 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ữ Google Ads API. 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 được dùng nữa
Lưu ý: Tính năng cá nhân hoá quảng cáo hiện không còn được dùng cho AdSense cho Tìm kiếm. Để biết thêm thông tin, hãy xem bài viết: AdSense cho Tìm kiếm và các sản phẩm quảng cáo Tìm kiếm khác để sử dụng các miền phân phát mới và ngừng sử dụng tính năng cá nhân hoá quảng cáo.
|
Nội dung mô tả tham 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
| Tham 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ụ: |
Chế độ cài đặt cấu hình
| Tham 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 } } }; |
||||||||
maxTop |
Không bắt buộc
Dùng tham 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ụ: |
||||||||
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. Tham 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 |
||||||||
width |
Không bắt buộc Chỉ định chiều rộng (bằng pixel) cho đơn vị quảng cáo hoặc đơn vị tìm kiếm có liên quan. Ví dụ: 'width' : '700px''width' : 700 |