Tệp đối chiếu

Tham số adPage chỉ định trang kết quả mà quảng cáo đang được hiển thị. Thông số này được sử dụng khi người dùng điều hướng qua trang đầu tiên của kết quả tìm kiếm. Ví dụ: nếu 5 quảng cáo được yêu cầu và thông số adPage được đặt thành 2, thì quảng cáo được trả về sẽ là trang thứ hai của 5 quảng cáo.

Ví dụ:

'pubId' : 'test-property'

Lưu ý: Việc sử dụng thông số này trên Nội dung tìm kiếm có liên quan trên trang Nội dung sẽ dẫn đến kết quả không mong muốn.

Ví dụ:

'query' : 'flowers'

'query' : 'black & decker'

'query' : myQuery // myQuery is a variable containing the search query

Ví dụ:

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'

• 'content' Sử dụng tuỳ chọn này cho Nội dung tìm kiếm có liên quan trên các trang Nội dung (ví dụ: bài viết, bài đăng trên blog).
• 'query' Sử dụng tuỳ chọn này dành riêng cho Nội dung tìm kiếm có liên quan trên các trang kết quả tìm kiếm.

Lưu ý: Theo mặc định, thông số trang relatedSearchTargeting được tự động đặt thành "truy vấn". Tuy nhiên, điều quan trọng cần lưu ý là giá trị mặc định này được thiết kế dành riêng cho các trang kết quả tìm kiếm chỉ (Nội dung tìm kiếm có liên quan trên Tìm kiếm). Nếu đang dùng nội dung tìm kiếm có liên quan trên bất kỳ loại trang nào khác (ví dụ: bài viết, bài đăng trên blog), bạn phải đặt rõ tham số này thành "content".

Lưu ý: Bạn phải tuân thủ các nguyên tắc sau đây khi sử dụng thông số này:

• Một số tính năng tìm kiếm có liên quan có thể được bật hoặc tắt tuỳ thuộc vào giá trị của tham số trang này.
• Việc trình bày sai về loại trang hoặc dựa vào chế độ cài đặt "truy vấn" mặc định cho tham số relatedSearchTargeting trên các trang không phải kết quả tìm kiếm sẽ bị coi là vi phạm hướng dẫn bằng văn bản này.
• Google có thể xác minh tính chính xác của giá trị này theo định kỳ, bất kể giá trị đó được đặt theo cách thủ công hay sử dụng giá trị mặc định.

Ví dụ:

'relatedSearchTargeting' : 'content'

'relatedSearchTargeting' : 'query'

Ví dụ:

'styleId': '1234567890'

• '_top' Mở trong cùng một cửa sổ.
• '_blank' Mở trong cửa sổ mới.

Ví dụ:

'linkTarget' : '_blank'

Ví dụ:

'maxTermLength' : 50

Bạn phải tuân thủ các nguyên tắc sau đây khi sử dụng thông số này:

• Bạn chỉ nên cung cấp tham số này trong yêu cầu Nội dung tìm kiếm có liên quan cho nội dung và sẽ bị bỏ qua đối với mọi yêu cầu khác.
• Bạn chỉ nên dùng tính năng này cho lưu lượng truy cập mà bạn chủ định lấy từ các trang web khác, và không nên dùng cho lưu lượng tự nhiên.
• Tiêu đề này phải bao gồm dòng tiêu đề và/hoặc thông tin mô tả của mẫu quảng cáo hoặc đường liên kết.
• Việc đưa vào các giá trị không thuộc mẫu quảng cáo dạng đường liên kết hoặc quảng cáo bị coi là vi phạm các hướng dẫn bằng văn bản này.
• Trường này không phân biệt chữ hoa chữ thường.
• Lớp này chấp nhận phương thức mã hoá UTF-8 hợp lệ; hỗ trợ các ký tự Unicode / dấu phụ.
• Google có thể sử dụng hoặc bỏ qua thông số bạn gửi. Khi được sử dụng, giá trị này có thể ảnh hưởng đến việc lựa chọn và thứ hạng của các từ khoá.

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'

Ví dụ:

'resultsPageQueryParam' : 'query'

Lưu ý: Khi dùng tham số này, referrerAdCreative cũng là bắt buộc và relatedSearchTargeting là bắt buộc và phải được đặt thành "content".

Ví dụ:

'terms' : 'cars rental, flight ticket'

Lưu ý: Trước khi cụm từ tìm kiếm có liên quan có thể xuất hiện trên trang web của bạn, Google cần thu thập dữ liệu các trang của bạn để đảm bảo rằng những cụm từ đó phù hợp với ngữ cảnh. Khi một trang chưa được thu thập dữ liệu hoặc bị trình thu thập dữ liệu của AdSense chặn thu thập dữ liệu (ví dụ: bị tệp robots.txt), chúng tôi sẽ không hiển thị các cụm từ Tìm kiếm có liên quan mà bạn đề xuất mà bạn cung cấp cho Google.

Sản phẩm Nội dung tìm kiếm có liên quan trên nội dung hoạt động dựa trên hệ thống thu thập dữ liệu nội dung của Google để lập chỉ mục các trang và tạo những cụm từ tìm kiếm có liên quan. URL trang nội dung chứa các tham số truy vấn như biến theo dõi, mã nhận dạng người dùng, mã phiên hoặc các giá trị nhận dạng động khác có thể ảnh hưởng đến khả năng đánh giá nội dung cốt lõi của trang của trình thu thập thông tin, đồng thời có thể dẫn đến các cụm từ tìm kiếm không chính xác hoặc không liên quan. Tham số trang này hướng dẫn trình thu thập dữ liệu của Google bỏ qua các tham số không cần thiết này để đảm bảo lập chỉ mục nội dung phù hợp và giảm tải thu thập dữ liệu không cần thiết. Điều này giúp Google nhận dạng chính xác hơn một trang là đã được thu thập dữ liệu và bắt đầu cho thấy các cụm từ đề xuất (cả Google và của đối tác, nếu đủ điều kiện).

Bạn phải tuân thủ các nguyên tắc sau đây khi sử dụng thông số này:

• Bạn chỉ nên cung cấp tham số này trong yêu cầu Nội dung tìm kiếm có liên quan cho nội dung và sẽ bị bỏ qua đối với mọi yêu cầu khác.
• Giá trị của tham số này phải là danh sách các tham số URL được phân tách bằng dấu phẩy. Danh sách này có thể xuất hiện khi bất kỳ người dùng nào chuyển đến trang nội dung.
• Mã này có phân biệt chữ hoa chữ thường.
• Khi bất kỳ tham số URL nào trong danh sách này bị xoá khỏi URL của trang nội dung, thì nội dung, giao diện hoặc trải nghiệm người dùng của trang sẽ không bị ảnh hưởng đáng kể.
• Việc đưa vào một tham số URL ảnh hưởng đáng kể đến nội dung, giao diện hoặc trải nghiệm người dùng của trang bị coi là vi phạm hướng dẫn bằng văn bản này.
• Google có thể định kỳ xác minh tác động của việc bỏ qua các tham số URL được cung cấp.

Ví dụ:
Người dùng truy cập vào một trang nội dung và có URL:

http://example.com/content?utm_medium=social&page_id=123&click_id=456

'ignoredPageParams' : 'utm_medium,click_id,session_ref'

http://example.com/content?page_id=123

• 'high' Trả về quảng cáo an toàn cho gia đình. Không trả về quảng cáo không an toàn cho gia đình hoặc có nội dung tình dục người lớn.
• 'medium' Trả về quảng cáo an toàn cho gia đình và không an toàn cho gia đình. Không trả về quảng cáo có nội dung tình dục người lớn.
• 'low' Trả về tất cả các loại quảng cáo.

Theo mặc định, adsafe được đặt ở mức cao.

Ví dụ:

'adsafe': 'medium'

Khi thông số adtest có giá trị on, bạn sẽ không tạo ra doanh thu.

Các yêu cầu quảng cáo có thông số adtest được đặt thành on đến từ một miền chưa được phê duyệt trong thẻ Trang web sẽ trả về các quảng cáo có lớp phủ "quảng cáo thử nghiệm" và không thể nhấp vào.

Hãy sử dụng thông số này khi thử nghiệm, nhưng không sử dụng thông số trong các hệ thống sản xuất. 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 bị tắt.

Ví dụ:

'adtest' : 'on'

Ví dụ:

'channel' :  'testA'  

'channel' :  'testA+testB'  

Google hỗ trợ tất cả các mã ngôn ngữ API AdWords.

Lưu ý: Nhà quảng cáo chỉ định ngôn ngữ mà quảng cáo của họ nhắm mục tiêu. Nếu bạn đưa thông số này vào yêu cầu của mình, thì Google chỉ trả về các quảng cáo được nhắm mục tiêu cho ngôn ngữ đó hoặc được nhắm mục tiêu cho 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ẽ bằng ngôn ngữ được chỉ định.

Thông thường, bạn nên đặt thông số hl thành ngôn ngữ chính của trang sẽ gửi thông số này.

Ví dụ:

'hl' : 'es'

Tham số ie đặt lược đồ mã hoá ký tự sẽ được dùng để diễn giải chuỗi truy vấn.

Giá trị ie mặc định là utf-8.

Thông số oe đặt lược đồ mã hoá ký tự mà Google sẽ sử dụng để mã hoá văn bản của quảng cáo. Mặc dù về mặt kỹ thuật là không bắt buộc, bạn nên truyền một giá trị cho thông số này.

Giá trị oe mặc định là utf-8.

• true Khi thông số này không xuất hiện hoặc bạn đặt thành "true", chúng tôi sẽ đặt cookie chỉ dùng để phát hiện lưu lượng truy cập không hợp lệ và chỉ sử dụng phương pháp lưu trữ cục bộ cho lưu lượng truy cập có sự đồng ý.
• false Khi bạn đặt thông số này thành "false", chúng tôi sẽ đặt cookie chỉ dùng để phát hiện lưu lượng truy cập không hợp lệ và sử dụng phương pháp lưu trữ cục bộ cho cả lưu lượng truy cập có sự đồng ý và không có sự đồng ý của người dùng.

Theo mặc định, IVT được đặt thành true.

Ví dụ:

'ivt': false

Ví dụ:

'container' : 'afscontainer1'

Sử dụng thông số này để chỉ định số lượng quảng cáo sẽ 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. Việc sử dụng thông số maxTop trên bất kỳ vị trí nào khác trên trang là hành vi vi phạm chính sách.

Ví dụ:

'maxTop' : 4

Ví dụ:

'width' : '700px'

'width' : 700

Hàm callback có các tham số sau:

Lưu ý: Vui lòng kiểm tra hàm callback của bạn để đảm bảo hàm 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ề lệnh gọi lại 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
    }
  }
};
      

Ví dụ:

'number' : 4

Ví dụ:

'relatedSearches' : 4