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

พารามิเตอร์

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

ระบุพารามิเตอร์เหล่านี้เพียง 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 อาจมี URL ของตนเอง ยกเว้นคำค้นหาที่จะต่อท้ายโดยอัตโนมัติ

ตัวอย่าง

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

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

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

  • คุณลักษณะการค้นหาที่เกี่ยวข้องบางอย่างอาจเปิดหรือปิดใช้งาน ขึ้นอยู่กับค่าของ พารามิเตอร์หน้า
  • สื่อให้เข้าใจผิดเกี่ยวกับประเภทของหน้าเว็บหรือใช้ "คำค้นหา" เริ่มต้น การตั้งค่าสำหรับ พารามิเตอร์ relatedSearchTarget ในหน้าผลการค้นหาที่ไม่ใช่หน้าการค้นหาถือว่าเป็นการละเมิด คำสั่งที่เป็นลายลักษณ์อักษรเหล่านี้
  • 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 กับ "เนื้อหา"

ตัวอย่าง

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

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

ผลิตภัณฑ์การค้นหาที่เกี่ยวข้องในเนื้อหาอาศัยระบบการ Crawl เนื้อหาของ 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

ค่า ชื่อมาตรฐาน ภาษาที่รองรับที่เกี่ยวข้อง
ลาติน1 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

ค่า ชื่อมาตรฐาน ภาษาที่รองรับที่เกี่ยวข้อง
ลาติน1 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