Tài liệu tham khảo

Thông số adPage chỉ định trang kết quả mà quảng cáo đang được hiển thị trên đó. 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à tham số adPage được đặt thành 2, thì quảng cáo được trả về trong số 5 quảng cáo sẽ xuất hiện trên trang thứ hai.

Ví dụ:

'pubId' : 'test-property'

Lưu ý: Việc sử dụng tham số này trên Cụm từ 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 lựa chọn này cho Cụm từ tìm kiếm có liên quan trên trang Nội dung (ví dụ: bài viết, bài đăng trên blog).
• 'query' Chỉ sử dụng lựa chọn này cho Cụm từ tìm kiếm có liên quan trên trang kết quả tìm kiếm.

Lưu ý:Tham số trang relatedSearchTargeting được đặt thành "query" theo mặc định. Tuy nhiên, bạn cần lưu ý rằng giá trị mặc định này chỉ được thiết kế riêng cho trang kết quả tìm kiếm (Nội dung tìm kiếm có liên quan trên Tìm kiếm). Nếu đang sử dụng cụm từ 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 tham số này thành "content" một cách rõ ràng.

Lưu ý: Bạn phải tuân theo các nguyên tắc sau 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 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 trang kết quả tìm kiếm được coi là hành vi vi phạm các hướng dẫn bằng văn bản này.
• Google có thể định kỳ xác minh tính chính xác của giá trị này, bất kể bạn đặt giá trị 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'

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

• Thông số này chỉ được cung cấp trên Nội dung tìm kiếm có liên quan cho yêu cầu Nội dung, và nó sẽ bị bỏ qua trong tất cả các yêu cầu khác.
• Tham số này chỉ được dùng cho lưu lượng truy cập mà bạn cố ý lấy từ các trang web khác và không được dùng cho lưu lượng truy cập tự nhiên.
• Thông số này phải bao gồm dòng tiêu đề, nội dung mô tả và/hoặc mọi từ ngữ khác trong quảng cáo hoặc mẫu quảng cáo liên kết.
• Việc bỏ qua các giá trị trong mẫu quảng cáo hoặc mẫu quảng cáo liên kết (hoặc thêm các giá trị khác) được coi là vi phạm những hướng dẫn bằng văn bản này.
• Thông số này không phân biệt chữ hoa chữ thường.
• Thông số này chấp nhận phương thức mã hoá UTF-8 hợp lệ; có hỗ trợ 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, thông số này có thể ảnh hưởng đến việc lựa chọn và xếp hạng 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 sử dụng tham số này, referrerAdCreative cũng là tham số bắt buộc và relatedSearchTargeting là tham số 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 thông tin trên các trang của bạn để đảm bảo các cụm từ này phù hợp với bối cảnh. Khi một trang chưa được trình thu thập thông tin thu thập hoặc bị chặn thu thập thông tin (ví dụ: do tệp robots.txt) bởi trình thu thập thông tin của AdSense, chúng tôi sẽ không hiển thị các cụm từ tìm kiếm có liên quan được đề xuất mà bạn cung cấp cho Google.

Sản phẩm Cụm từ tìm kiếm có liên quan trên nội dung dựa vào 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 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 (chẳng hạ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 của trình thu thập thông tin trong việc đánh giá nội dung cốt lõi của trang và có thể dẫn đến các cụm từ tìm kiếm có liên quan 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 những tham số không cần thiết này, đảm bảo lập chỉ mục nội dung đúng cách 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 diện một trang hiệu quả hơn vì trang đó đã được thu thập dữ liệu và bắt đầu hiển thị các cụm từ được đề xuất (cả của Google và của đối tác, nếu đủ điều kiện).

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

• Thông số này chỉ được cung cấp trên Nội dung tìm kiếm có liên quan cho yêu cầu Nội dung, và nó sẽ bị bỏ qua trong tất cả các 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 có thể xuất hiện khi người dùng chuyển đến trang nội dung bất kỳ.
• Thông số này có phân biệt chữ hoa chữ thường.
• Khi bạn xoá bất kỳ tham số URL nào trong danh sách này khỏi URL của trang nội dung, 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 thêm một tham số URL có ả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 được coi là vi phạm các hướng dẫn bằng văn bản này.
• Google có thể định kỳ xác minh hiệu quả của việc bỏ qua các tham số URL được cung cấp.

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

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 khiêu dâm 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 khiêu dâm 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 thành high.

Ví dụ:

'adsafe': 'medium'

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

Những 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ề quảng cáo có lớp phủ "quảng cáo thử nghiệm" và không thể nhấp vào được.

Hãy sử dụng tham số này khi thử nghiệm, nhưng đừng sử dụng tham số này trong các hệ thống sản phẩm. Nếu không, bạn sẽ không được thanh toán cho những quảng cáo mà bạn hiển thị.

Giá trị mặc định của tham số adtest là off.

Ví dụ:

'adtest' : 'on'

Ví dụ:

'channel' :  'testA'  

'channel' :  'testA+testB'  

Google hỗ trợ tất 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 đến. Nếu bạn đưa thông số này vào yêu cầu của mình, thì Google sẽ chỉ trả về những quảng cáo được nhắm đến ngôn ngữ đó hoặc được nhắm đế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 tham số hl thành ngôn ngữ chính của trang sẽ gửi tham số này.

Ví dụ:

'hl' : 'es'

Thông số ie đặt lược đồ mã hoá ký tự sẽ được dùng để diễn giải chuỗi cụm từ tìm kiếm.

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 đây là thông số không bắt buộc, nhưng bạn nên chuyể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ông số này 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à sử dụng bộ nhớ cục bộ chỉ trên 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 mộ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 bộ nhớ cục bộ cho cả lưu lượng truy cập có sự đồng ý và lưu lượng truy cập không có sự đồng ý.

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

Ví dụ:

'ivt': false

Ví dụ:

'container' : 'afscontainer1'

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 ý: Tham số này được dùng thay cho tham 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 tham 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 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 hàm này 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ề một 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