แหล่งอ้างอิง

พารามิเตอร์

คำอธิบายพารามิเตอร์ระดับหน้าเว็บ

ระบุพารามิเตอร์เหล่านี้เพียง 1 ครั้งต่อ 1 หน้าเว็บเท่านั้น ซึ่งจะมีผลต่อหน่วยโฆษณาทั้งหมดบนหน้าเว็บ

จำเป็น

พารามิเตอร์ คำอธิบายและตัวอย่าง
adPage ต้องระบุเมื่อผู้ใช้ไปที่หน้าผลลัพธ์ถัดไปหรือหน้าผลการค้นหาก่อนหน้า

พารามิเตอร์ adPage ระบุหน้าผลลัพธ์ที่แสดงโฆษณา พารามิเตอร์นี้ใช้เมื่อผู้ใช้ผ่านหน้าแรกของผลการค้นหาไป ตัวอย่างเช่น หากมีการขอโฆษณา 5 รายการและมีการตั้งค่าพารามิเตอร์ adPage เป็น 2 โฆษณาที่แสดงจะเป็นหน้าที่ 2 ของโฆษณา 5 รายการ

pubId ต้องระบุ
นี่คือ Client-ID AdSense ของคุณ pubId เป็นส่วนหนึ่งของ Client-ID ที่อยู่หลัง "partner-" ตัวอย่างเช่น หาก Client-ID คือ "partner-test-property" pubId ของคุณจะเป็น "test-property" นี่คือโปรโตคอลมาตรฐานสำหรับ CSA

ตัวอย่างเช่น 

'pubId' : 'test-property'
query ต้องระบุ ยกเว้นในการค้นหาที่เกี่ยวข้องในหน้าเนื้อหา
นี่คือคําค้นหาที่ผู้ใช้ป้อน ค่าของพารามิเตอร์การค้นหาไม่ควรมีการเข้ารหัส

หมายเหตุ: การใช้พารามิเตอร์นี้ในการค้นหาที่เกี่ยวข้องในหน้าเนื้อหาจะทำให้เกิดผลลัพธ์ที่ไม่คาดคิด

ตัวอย่าง: 

'query' : 'flowers'
'query' : 'black & decker'
'query' : myQuery // myQuery is a variable containing the search query
resultsPageBaseUrl ต้องระบุเมื่อมีหน่วยการค้นหาที่เกี่ยวข้องในหน้า
ระบุ URL ของหน้าผลการค้นหาที่คำค้นหาเป็นข้อความค้นหาที่เกี่ยวข้องซึ่งผู้ใช้คลิก resultsPageBaseUrl อาจมีพารามิเตอร์ของตัวเอง ยกเว้นคําค้นหาที่จะต่อท้ายโดยอัตโนมัติ

ตัวอย่างเช่น 

'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
relatedSearchTargeting ต้องระบุเมื่อมีหน่วยการค้นหาที่เกี่ยวข้องในหน้า
ต้องใช้พารามิเตอร์นี้เมื่อมีการขอหน่วยการค้นหาที่เกี่ยวข้อง ซึ่งจะควบคุมประเภทของประสบการณ์การค้นหาที่เกี่ยวข้องที่จะแสดง โดยขึ้นอยู่กับบริบทของหน้า ดังนี้
  • 'content' ใช้ตัวเลือกนี้สำหรับการค้นหาที่เกี่ยวข้องในหน้าเนื้อหา (เช่น บทความ บล็อกโพสต์)
  • 'query' ใช้ตัวเลือกนี้โดยเฉพาะสำหรับการค้นหาที่เกี่ยวข้องในหน้าผลการค้นหา

หมายเหตุ: พารามิเตอร์หน้า relatedSearchTargeting จะตั้งค่าเป็น "query" โดยอัตโนมัติโดยค่าเริ่มต้น อย่างไรก็ตาม โปรดทราบว่าค่าเริ่มต้นนี้ออกแบบมาสำหรับหน้าผลการค้นหาโดยเฉพาะเท่านั้น (การค้นหาที่เกี่ยวข้องบน Search) หากใช้การค้นหาที่เกี่ยวข้องในหน้าเว็บประเภทอื่นๆ (เช่น บทความ บล็อกโพสต์) คุณต้องตั้งค่าพารามิเตอร์เป็น "content" อย่างชัดเจน

หมายเหตุ: การใช้พารามิเตอร์นี้ต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้

  • ระบบอาจเปิดหรือปิดใช้ฟีเจอร์การค้นหาที่เกี่ยวข้องบางรายการ โดยขึ้นอยู่กับค่าของพารามิเตอร์หน้านี้
  • การสื่อให้เข้าใจผิดเกี่ยวกับประเภทของหน้าเว็บหรือการใช้การตั้งค่า "query" เริ่มต้นสำหรับพารามิเตอร์ relatedSearchTargeting ในหน้าผลการค้นหาที่ไม่ใช่หน้าการค้นหา ถือว่าเป็นการละเมิดวิธีการที่เป็นลายลักษณ์อักษรเหล่านี้
  • Google อาจตรวจสอบความถูกต้องของค่านี้เป็นระยะๆ ไม่ว่าจะมีการตั้งค่าด้วยตนเองหรือใช้ค่าเริ่มต้น

ตัวอย่าง

'relatedSearchTargeting' : 'content'
'relatedSearchTargeting' : 'query'
styleId ต้องระบุ
ระบุรหัสของสไตล์โฆษณาที่กำหนดเองในเครือข่ายการค้นหาที่จะใช้กับโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้องในหน้าเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้สไตล์โฆษณาที่กำหนดเองในเครือข่ายการค้นหา โปรดทราบว่าเมื่อมีการตั้งค่า styleId สําหรับคําขอ โฆษณาหรือการค้นหาที่เกี่ยวข้องจะแสดงผลด้วยสไตล์ดังกล่าว และระบบจะไม่สนใจพารามิเตอร์การจัดรูปแบบเดิม หากไม่ได้ระบุ styleId ในคําขอ ระบบจะแสดงสไตล์ค่าเริ่มต้นของระบบ

ตัวอย่างเช่น 

'styleId': '1234567890'

ไม่บังคับ

พารามิเตอร์ คำอธิบายและตัวอย่าง
linkTarget ไม่บังคับ
ระบุว่าการคลิกโฆษณาจะเปิดในหน้าต่างเดียวกันหรือหน้าต่างใหม่ ค่าเริ่มต้นคือ "_top" และคุณใช้พารามิเตอร์นี้ในระดับหน่วยได้ด้วย
  • '_top' เปิดในหน้าต่างเดิม
  • '_blank' เปิดในหน้าต่างใหม่

ตัวอย่างเช่น 

'linkTarget' : '_blank'
maxTermLength ไม่บังคับ
ระบุจํานวนอักขระสูงสุดของข้อความค้นหาที่เกี่ยวข้องรวมถึงการเว้นวรรค ไม่จํากัดหากไม่ได้ตั้งค่า

ตัวอย่างเช่น 

'maxTermLength' : 50
referrerAdCreative ไม่บังคับ
หากผู้ใช้เข้ามาที่หน้าเนื้อหาของคุณซึ่งมีหน่วยการค้นหาที่เกี่ยวข้องสำหรับเนื้อหา โดยการคลิกที่โฆษณาหรือลิงก์บนเว็บไซต์อื่น และโฆษณาหรือลิงก์นั้นอยู่ในการควบคุมของคุณ ควรตั้งค่าพารามิเตอร์นี้เป็นข้อความครีเอทีฟโฆษณาของโฆษณาหรือลิงก์นั้นแบบคำต่อคำ

การใช้พารามิเตอร์นี้ต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้

  • ควรระบุพารามิเตอร์นี้ในการค้นหาที่เกี่ยวข้องสําหรับคำขอเนื้อหาเท่านั้น และไม่สนใจคําขออื่นๆ ทั้งหมด
  • ควรใช้กับการเข้าชมซึ่งตั้งใจให้มีแหล่งที่มาจากเว็บไซต์อื่นเท่านั้น และไม่ควรใช้กับการเข้าชมจากการค้นหาทั่วไป
  • โดยควรมีบรรทัดชื่อและ/หรือคำอธิบายของโฆษณาหรือลิงก์ครีเอทีฟโฆษณา
  • การรวมค่าที่ไม่ได้เป็นส่วนหนึ่งของโฆษณาหรือครีเอทีฟโฆษณาลิงก์จะถือว่าเป็นการละเมิดวิธีการที่เขียนขึ้นเหล่านี้
  • ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
  • ยอมรับการเข้ารหัส UTF-8 ที่ถูกต้อง รองรับอักขระ Unicode / เครื่องหมายกำกับการออกเสียง
  • Google อาจใช้หรือไม่สนใจพารามิเตอร์ที่คุณส่ง เมื่อใช้อาจส่งผลต่อการเลือกและการจัดอันดับคำ

หมายเหตุ: คุณต้องระบุพารามิเตอร์นี้เมื่อใช้พารามิเตอร์ terms

ตัวอย่าง: 

'referrerAdCreative': 'search for ads related to dental implants'

'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis'
resultsPageQueryParam ไม่บังคับ
ระบุชื่อพารามิเตอร์ของ URL สําหรับคําค้นหาในหน้าผลการค้นหา ค่าเริ่มต้นจะเป็น "q" หากไม่ได้ระบุไว้

ตัวอย่างเช่น 

'resultsPageQueryParam' : 'query'
terms ไม่บังคับ
พารามิเตอร์นี้ช่วยให้สามารถระบุรายการที่คั่นด้วยคอมมาของข้อความค้นหาที่เกี่ยวข้องของคุณเองเพื่อให้แสดงพร้อมกับคําขอการค้นหาที่เกี่ยวข้อง แม้ว่า Google อาจใช้หรือไม่ใช้ข้อความที่ระบุไว้ที่นี่ก็ได้

หมายเหตุ: เมื่อใช้พารามิเตอร์นี้ ต้องระบุ referrerAdCreative ด้วย รวมถึงต้องตั้งค่า relatedSearchTargeting และต้องตั้งค่าเป็น "content"

ตัวอย่าง: 

'terms' : 'cars rental, flight ticket'
ignoredPageParams ไม่บังคับ
ระบุรายการพารามิเตอร์ของ URL สำหรับหน้าเนื้อหาที่มีหน่วยการค้นหาที่เกี่ยวข้องสำหรับเนื้อหา ซึ่งจะละเว้นได้อย่างปลอดภัยโดยไม่ส่งผลต่อเนื้อหาหลักหรือประสบการณ์ของผู้ใช้

หมายเหตุ: ก่อนที่ข้อความค้นหาที่เกี่ยวข้องจะปรากฏในเว็บไซต์ Google จำเป็นต้องรวบรวมข้อมูลหน้าเว็บเพื่อให้แน่ใจว่าข้อความเหล่านั้นมีความเกี่ยวข้องตามบริบท หากหน้าเว็บยังไม่ได้ถูก Crawl หรือถูกบล็อกไม่ให้ทำการ Crawl (เช่น โดย robots.txt) โปรแกรมรวบรวมข้อมูลของ AdSense เราจะไม่แสดงข้อความค้นหาที่เกี่ยวข้องที่แนะนำซึ่งคุณให้ไว้กับ Google

ผลิตภัณฑ์การค้นหาที่เกี่ยวข้องกับเนื้อหาใช้ระบบการรวบรวมข้อมูลเนื้อหาของ Google ในการจัดทำดัชนีหน้าและสร้างข้อความค้นหาที่เกี่ยวข้อง URL ของหน้าเนื้อหาที่มีพารามิเตอร์การค้นหา เช่น ตัวแปรการติดตาม รหัสผู้ใช้ รหัสเซสชัน หรือตัวระบุแบบไดนามิกอื่นๆ อาจรบกวนความสามารถของโปรแกรมรวบรวมข้อมูลในการประเมินเนื้อหาหลักของหน้า และอาจนำไปสู่ข้อความค้นหาที่เกี่ยวข้องที่ไม่ถูกต้องหรือไม่เกี่ยวข้อง พารามิเตอร์ของหน้านี้บอกให้โปรแกรมรวบรวมข้อมูลของ Google เพิกเฉยต่อพารามิเตอร์ที่ไม่จำเป็นเหล่านี้ เพื่อให้มีการจัดทำดัชนีเนื้อหาที่เหมาะสมและลดปริมาณการรวบรวมข้อมูลที่ไม่จำเป็น วิธีนี้ช่วยให้ Google จดจำหน้าเว็บได้ดีขึ้นว่ามีการ Crawl แล้ว และเริ่มแสดงคำที่แนะนำ (ทั้ง Google และของพาร์ทเนอร์ หากมีสิทธิ์)

การใช้พารามิเตอร์นี้ต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้

  • ควรระบุพารามิเตอร์นี้ในการค้นหาที่เกี่ยวข้องสําหรับคำขอเนื้อหาเท่านั้น และไม่สนใจคําขออื่นๆ ทั้งหมด
  • ค่าของพารามิเตอร์นี้ควรเป็นรายการพารามิเตอร์ของ URL ที่คั่นด้วยคอมมา ซึ่งอาจปรากฏขึ้นเมื่อผู้ใช้ไปที่หน้าเนื้อหา
  • โดยพิจารณาตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
  • เมื่อมีการนำพารามิเตอร์ของ URL จากรายการนี้ออกจาก URL ของหน้าเนื้อหา เนื้อหา ลักษณะที่ปรากฏ หรือประสบการณ์ของผู้ใช้จะไม่ส่งผลกระทบอย่างมีนัยสำคัญ
  • การใส่พารามิเตอร์ของ URL ที่มีผลกระทบอย่างมากต่อเนื้อหาของหน้าเว็บ รูปลักษณ์ หรือประสบการณ์ของผู้ใช้จะถือเป็นการละเมิดวิธีการที่เป็นลายลักษณ์อักษรเหล่านี้
  • Google อาจตรวจสอบผลของการละเว้นพารามิเตอร์ของ URL ที่ระบุเป็นระยะๆ

ตัวอย่างเช่น
ผู้ใช้เข้าชมหน้าเนื้อหาและมี URL เป็นที่ 

http://example.com/content?utm_medium=social&page_id=123&click_id=456
การระบุพารามิเตอร์ของ URL ที่เพิกเฉยต่อไปนี้ได้ 
'ignoredPageParams' : 'utm_medium,click_id,session_ref'
จะถือว่า URL ของหน้าเนื้อหามีลักษณะดังต่อไปนี้ 
http://example.com/content?page_id=123

การตั้งค่า

พารามิเตอร์ คำอธิบายและตัวอย่าง
adsafe ไม่บังคับ
ระบุกฎการกรองที่ Google ควรใช้กับโฆษณาที่ตรงกับคําค้นหา ต่อไปนี้คือการตั้งค่าที่ถูกต้องสำหรับ Adsafe และผลที่แต่ละค่ามีต่อโฆษณาที่แสดง
  • 'high' แสดงโฆษณาที่เหมาะสำหรับเยาวชน ไม่แสดงโฆษณาที่ไม่เหมาะสำหรับเยาวชนหรือโฆษณาที่มีเนื้อหาเกี่ยวกับเรื่องเพศ
  • 'medium' แสดงโฆษณาที่เหมาะและไม่เหมาะสำหรับเยาวชน ไม่แสดงโฆษณาที่มีเนื้อหาเกี่ยวกับเรื่องเพศสำหรับผู้ใหญ่
  • 'low' แสดงโฆษณาทุกประเภท

โดยค่าเริ่มต้นของ adsafe จะตั้งค่าเป็น High

ตัวอย่างเช่น 

'adsafe': 'medium'
adtest ไม่บังคับ
พารามิเตอร์ adtest ใช้เพื่อระบุว่าคำขอโฆษณาเป็นการทดสอบ เมื่อพารามิเตอร์ adtest ตั้งค่าไว้เป็น on Google จะถือว่าคำขอนั้นเป็นการทดสอบ และจะไม่นับการแสดงผลโฆษณาหรือติดตามผลการคลิกผ่าน

เมื่อพารามิเตอร์ adtest ตั้งค่าไว้เป็น on คุณจะไม่สร้างรายได้ใดๆ

คำขอโฆษณาที่มีการตั้งค่าพารามิเตอร์ adtest เป็น on ที่มาจากโดเมนที่ไม่ อนุมัติในแท็บ Sites จะแสดงโฆษณาที่มีการวางซ้อน "โฆษณาทดสอบ" และไม่สามารถคลิกได้

ใช้พารามิเตอร์นี้เมื่อทำการทดสอบ แต่อย่าใช้ในระบบที่ใช้งานจริง มิฉะนั้นคุณจะไม่ได้รับรายได้จากโฆษณาที่คุณแสดง

ค่าเริ่มต้นของ adtest ปิดอยู่

ตัวอย่างเช่น 

'adtest' : 'on'
channel ไม่บังคับ
คุณอาจรวมแชแนลของ AdSense สำหรับ Search เพื่อติดตามประสิทธิภาพของหน้าเว็บต่างๆ ใช้รหัสแชแนลเฉพาะที่สร้างในบัญชี AdSense หรือโดยผู้จัดการทางเทคนิคของบัญชี ดูข้อมูลเพิ่มเติมเกี่ยวกับแชแนลได้ที่นี่

หากมีหลายแชแนล ควรแยกจากกันโดยใช้สัญลักษณ์ "+"

ตัวอย่าง: 

'channel' :  'testA'  
'channel' :  'testA+testB'

hl ไม่บังคับ
พารามิเตอร์นี้เป็นตัวระบุภาษาที่เป็นเป้าหมายของโฆษณาที่ขอหรือการค้นหาที่เกี่ยวข้อง ค่าเริ่มต้นคือ en

Google สนับสนุนรหัสภาษา AdWords API ทั้งหมด

หมายเหตุ: ผู้ลงโฆษณาเป็นผู้กำหนดภาษาที่โฆษณาของตนกำหนดเป้าหมาย หากคุณใส่พารามิเตอร์นี้ในคำขอของคุณ Google จะแสดงเฉพาะโฆษณาที่กำหนดเป้าหมายสำหรับภาษานั้นหรือที่กำหนดเป้าหมายสำหรับทุกภาษาเท่านั้น แต่จะไม่รับประกันว่าข้อความโฆษณาจะอยู่ในภาษาที่กำหนด

โดยปกติคุณควรตั้งค่าพารามิเตอร์ hl เป็นภาษาหลักของหน้าเว็บที่มีการส่งพารามิเตอร์นี้

ตัวอย่าง: 

'hl' : 'es'
ie ไม่บังคับ

พารามิเตอร์ ie กำหนดรูปแบบการเข้ารหัสอักขระที่ควรใช้เพื่อตีความสตริงการค้นหา

ค่าเริ่มต้นของ ie คือ utf-8

ค่า ชื่อมาตรฐาน ภาษาที่รองรับที่เกี่ยวข้อง
latin1 ISO-8859-1 ยุโรปตะวันตก (คาตาลัน เดนมาร์ก ดัตช์ อังกฤษ ฟินแลนด์ ฝรั่งเศส เยอรมัน อินโดนีเซีย อิตาลี นอร์เวย์ โปรตุเกส สเปน สวีเดน)
latin2 ISO-8859-2 ยุโรปตะวันออก (โครเอเชีย เช็ก ฮังการี โปแลนด์ โรมาเนีย เซอร์เบีย สโลวัก สโลวีเนีย)
latin3 ISO-8859-3  
latin4 ISO-8859-4 บอลติก (เอสโตเนีย ลัตเวีย ลิทัวเนีย)
ซีริลลิก ISO-8859-5 บัลแกเรีย รัสเซีย
arabic ISO-8859-6  
กรีก ISO-8859-7 กรีก
hebrew ISO-8859-8 ฮีบรู
latin5 ISO-8859-9  
latin6 ISO-8859-10 ไอซ์แลนด์
euc-jp EUC-JP ญี่ปุ่น
สกุลเงินยูโร EUC-KR เกาหลี
Sjis Shift_JIS ญี่ปุ่น
big5 Big5 จีนตัวเต็ม
gb GB2312 จีนตัวย่อ
utf-8 UTF-8 ทั้งหมด
oe ไม่บังคับ

พารามิเตอร์ oe กำหนดรูปแบบการเข้ารหัสอักขระที่ Google ควรใช้เพื่อเข้ารหัสข้อความของโฆษณา ในทางเทคนิคอาจไม่บังคับ แต่การใช้พารามิเตอร์นี้เป็นวิธีที่ดี

ค่าเริ่มต้นของ oe คือ utf-8

ค่า ชื่อมาตรฐาน ภาษาที่รองรับที่เกี่ยวข้อง
latin1 ISO-8859-1 ยุโรปตะวันตก (คาตาลัน เดนมาร์ก ดัตช์ อังกฤษ ฟินแลนด์ ฝรั่งเศส เยอรมัน อินโดนีเซีย อิตาลี นอร์เวย์ โปรตุเกส สเปน สวีเดน)
latin2 ISO-8859-2 ยุโรปตะวันออก (โครเอเชีย เช็ก ฮังการี โปแลนด์ โรมาเนีย เซอร์เบีย สโลวัก สโลวีเนีย)
latin3 ISO-8859-3  
latin4 ISO-8859-4 บอลติก (เอสโตเนีย ลัตเวีย ลิทัวเนีย)
ซีริลลิก ISO-8859-5 บัลแกเรีย รัสเซีย
arabic ISO-8859-6  
กรีก ISO-8859-7 กรีก
hebrew ISO-8859-8 ฮีบรู
latin5 ISO-8859-9  
latin6 ISO-8859-10 ไอซ์แลนด์
euc-jp EUC-JP ญี่ปุ่น
สกุลเงินยูโร EUC-KR เกาหลี
Sjis Shift_JIS ญี่ปุ่น
gb GB2312 จีนตัวย่อ
utf-8 UTF-8 ทั้งหมด
ivt ไม่บังคับ
พารามิเตอร์นี้ทำให้คุณสามารถใส่บูลีนที่แจ้ง Google ว่าคุณต้องการอนุญาตโฆษณาที่ใช้คุกกี้และพื้นที่เก็บข้อมูลในเครื่องที่มีไว้เพื่อตรวจจับการเข้าชมที่ไม่ถูกต้องเท่านั้นในการเข้าชมที่ได้รับความยินยอมและไม่ได้รับความยินยอม
  • true เมื่อพารามิเตอร์นี้ไม่แสดงหรือคุณตั้งค่าเป็น "จริง" เราจะตั้งค่าคุกกี้สำหรับการเข้าชมที่ไม่ถูกต้องเท่านั้นและใช้พื้นที่เก็บข้อมูลในเครื่องสำหรับการเข้าชมที่ได้รับความยินยอมเท่านั้น
  • false เมื่อตั้งค่าพารามิเตอร์นี้เป็น "เท็จ" เราจะตั้งค่าคุกกี้ที่มีไว้เพื่อตรวจจับการเข้าชมที่ไม่ถูกต้องเท่านั้นและใช้พื้นที่เก็บข้อมูลในเครื่องทั้งกับการเข้าชมที่ได้รับความยินยอมและไม่ได้รับความยินยอม

ระบบจะตั้งค่า IVT เป็น "จริง" โดยค่าเริ่มต้น

ตัวอย่างเช่น 

'ivt': false

คำอธิบายพารามิเตอร์ระดับหน่วยโฆษณา

พารามิเตอร์เหล่านี้ส่งผลต่อวิธีที่แต่ละหน่วยโฆษณาบนหน้าเว็บปรากฏต่อผู้ใช้ แต่ละพารามิเตอร์สามารถตั้งค่าให้แตกต่างกันได้สำหรับแต่ละหน่วยโฆษณา

จำเป็น

พารามิเตอร์ คำอธิบายและตัวอย่าง
container ต้องระบุ
รหัสของคอนเทนเนอร์โฆษณาว่างเปล่า <div> ที่โฆษณาควรจะปรากฏ

ตัวอย่างเช่น 

'container' : 'afscontainer1'
maxTop ต้องระบุเมื่อหน่วยโฆษณาอยู่เหนือผลการค้นหา

ใช้พารามิเตอร์นี้เพื่อระบุจำนวนโฆษณาที่จะแสดงในหน่วยโฆษณาด้านบน

หมายเหตุ: พารามิเตอร์นี้ใช้แทนพารามิเตอร์ "number" หน่วยโฆษณานี้ควรกว้างพอเพื่อให้บรรทัดแรกของโฆษณาไม่มีการตัดขึ้นบรรทัดใหม่ การใช้พารามิเตอร์ maxTop ในตำแหน่งอื่นๆ บนหน้าเว็บเป็นการละเมิดนโยบาย

เช่น

'maxTop' : 4
width ต้องระบุ
ระบุความกว้างของโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้องเป็นพิกเซล

ตัวอย่างเช่น 

'width' : '700px'
'width' : 700

การตั้งค่า

พารามิเตอร์ คำอธิบายและตัวอย่าง
adLoadedCallback ไม่บังคับ
ระบุฟังก์ชัน JavaScript ที่จะเรียกใช้เมื่อโฆษณาหรือการค้นหาที่เกี่ยวข้องโหลดขึ้น หรือเมื่อไม่มีการแสดงโฆษณาหรือการค้นหาที่เกี่ยวข้อง ควรตั้งค่าพารามิเตอร์เป็นฟังก์ชัน Callback ของ JavaScript ที่คุณใช้เพื่ออนุญาตให้ดําเนินการเมื่อการเรียกโฆษณาเสร็จสิ้น

ฟังก์ชัน Callback จะใช้พารามิเตอร์ต่อไปนี้

containerName ชื่อคอนเทนเนอร์ของโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้อง
adsLoaded ตั้งค่าเป็นจริงเมื่อมีโฆษณาหรือข้อความค้นหาที่เกี่ยวข้องอย่างน้อย 1 รายการที่จะแสดง และตั้งค่าเป็นเท็จเมื่อไม่มีโฆษณาหรือการค้นหาที่เกี่ยวข้องแสดง
isExperimentVariant ตั้งค่าเป็น "จริง" หากการทดสอบการจัดรูปแบบที่กำหนดเองทำงานอยู่และมีการเลือกตัวแปรของการทดสอบเพื่อแสดงโฆษณา
callbackOptions ออบเจ็กต์ JSON ที่มีช่องต่อไปนี้
termPositions: สําหรับบล็อกการค้นหาที่เกี่ยวข้อง มีแมป<string,int> ของคำที่ผู้เผยแพร่โฆษณาระบุไว้กับตําแหน่งที่ไม่มีการจัดทําดัชนีของคําเหล่านี้ในการตอบสนอง หากมีการระบุคําไว้แต่ไม่ได้ส่งคืน ก็จะไม่ปรากฏในแผนที่

หมายเหตุ: โปรดทดสอบฟังก์ชัน Callback เพื่อตรวจสอบว่าไม่มีข้อผิดพลาด โดยเฉพาะอย่างยิ่งข้อผิดพลาดที่อาจรบกวนการโหลดหน้าเว็บ

ตัวอย่าง 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 ไม่บังคับ
จำนวนโฆษณาที่ควรปรากฏในหน่วยนี้ ค่าเริ่มต้นคือ 2

ตัวอย่างเช่น 

'number' : 4
relatedSearches ไม่บังคับ
จํานวนการค้นหาที่เกี่ยวข้องที่ควรปรากฏในหน่วยนี้ ค่าเริ่มต้นจะเป็น 0 หากไม่ได้ระบุไว้

ตัวอย่างเช่น 

'relatedSearches' : 4