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

พารามิเตอร์

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

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

ต้องระบุ

พารามิเตอร์ คําอธิบายและตัวอย่าง
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 ต้องระบุ
ระบุรหัสของสไตล์โฆษณาที่กำหนดเองใน Search ซึ่งจะใช้กับโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้องในหน้าเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้สไตล์โฆษณาที่กำหนดเองใน Search โปรดทราบว่าเมื่อมีการตั้งค่า styleId สําหรับคําขอ โฆษณาหรือการค้นหาที่เกี่ยวข้องจะแสดงผลด้วยสไตล์นี้ และระบบจะไม่สนใจพารามิเตอร์สไตล์เดิม หากไม่ได้ระบุ styleId ในคําขอ ระบบจะแสดงสไตล์ค่าเริ่มต้นของระบบ

ตัวอย่าง 

'styleId': '1234567890'

ไม่บังคับ

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

ตัวอย่าง 

'linkTarget' : '_blank'
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 หน้าเว็บของคุณก่อนเพื่อให้แน่ใจว่าข้อความมีความเกี่ยวข้องตามบริบท เมื่อCrawler ของ AdSense ยังไม่ได้ทำการ Crawl หน้าเว็บหรือถูกบล็อกไม่ให้ทำการ Crawl (เช่น โดย robots.txt) เราจะไม่แสดงคําค้นหาที่เกี่ยวข้องที่แนะนําซึ่งคุณให้ Google

ผลิตภัณฑ์การค้นหาที่เกี่ยวข้องในเนื้อหาอาศัยระบบการ Crawl เนื้อหาของ Google เพื่อจัดทำดัชนีหน้าเว็บและสร้างข้อความค้นหาที่เกี่ยวข้อง URL ของหน้าเนื้อหาที่มีพารามิเตอร์การค้นหา เช่น ตัวแปรการติดตาม รหัสผู้ใช้ รหัสเซสชัน หรือตัวระบุแบบไดนามิกอื่นๆ อาจขัดขวางความสามารถของ Crawler ในการประเมินเนื้อหาหลักของหน้าเว็บ และอาจทําให้คําค้นหาที่เกี่ยวข้องไม่ถูกต้องหรือไม่เกี่ยวข้อง พารามิเตอร์หน้าเว็บนี้จะสั่งให้ Crawler ของ Google ละเว้นพารามิเตอร์ที่ไม่จำเป็นเหล่านี้ เพื่อให้การจัดทําดัชนีเนื้อหาเป็นไปอย่างถูกต้องและลดภาระการ Crawl ที่ไม่จําเป็น ซึ่งจะช่วยให้ 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 ซึ่งมาจากโดเมนที่ยังไม่ได้รับการ อนุมัติในแท็บเว็บไซต์จะแสดงโฆษณาที่มีข้อความ "โฆษณาทดสอบ" ซ้อนทับและไม่สามารถคลิกได้

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

ค่าเริ่มต้นของ 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 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 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: สําหรับบล็อกการค้นหาที่เกี่ยวข้อง ซึ่งมี map<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