พารามิเตอร์
คำอธิบายพารามิเตอร์ระดับหน้าเว็บ
ระบุพารามิเตอร์เหล่านี้เพียง 1 ครั้งต่อ 1 หน้าเว็บเท่านั้น ซึ่งจะมีผลต่อหน่วยโฆษณาทั้งหมดบนหน้าเว็บ
จำเป็น
พารามิเตอร์ | คำอธิบายและตัวอย่าง |
---|---|
adPage
|
ต้องระบุเมื่อผู้ใช้ไปที่หน้าผลลัพธ์ถัดไปหรือหน้าผลการค้นหาก่อนหน้า พารามิเตอร์ |
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
|
ต้องระบุเมื่อมีหน่วยการค้นหาที่เกี่ยวข้องในหน้า ต้องใช้พารามิเตอร์นี้เมื่อมีการขอหน่วยการค้นหาที่เกี่ยวข้อง ซึ่งจะควบคุมประเภทของประสบการณ์การค้นหาที่เกี่ยวข้องที่จะแสดง โดยขึ้นอยู่กับบริบทของหน้า ดังนี้
หมายเหตุ: พารามิเตอร์หน้า relatedSearchTargeting จะตั้งค่าเป็น "query" โดยอัตโนมัติโดยค่าเริ่มต้น อย่างไรก็ตาม โปรดทราบว่าค่าเริ่มต้นนี้ออกแบบมาสำหรับหน้าผลการค้นหาโดยเฉพาะเท่านั้น (การค้นหาที่เกี่ยวข้องบน Search) หากใช้การค้นหาที่เกี่ยวข้องในหน้าเว็บประเภทอื่นๆ (เช่น บทความ บล็อกโพสต์) คุณต้องตั้งค่าพารามิเตอร์เป็น "content" อย่างชัดเจน หมายเหตุ: การใช้พารามิเตอร์นี้ต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้
ตัวอย่าง 'relatedSearchTargeting' : 'content' 'relatedSearchTargeting' : 'query' |
styleId
|
ต้องระบุ ระบุรหัสของสไตล์โฆษณาที่กำหนดเองในเครือข่ายการค้นหาที่จะใช้กับโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้องในหน้าเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้สไตล์โฆษณาที่กำหนดเองในเครือข่ายการค้นหา โปรดทราบว่าเมื่อมีการตั้งค่า styleId สําหรับคําขอ โฆษณาหรือการค้นหาที่เกี่ยวข้องจะแสดงผลด้วยสไตล์ดังกล่าว และระบบจะไม่สนใจพารามิเตอร์การจัดรูปแบบเดิม หากไม่ได้ระบุ styleId ในคําขอ ระบบจะแสดงสไตล์ค่าเริ่มต้นของระบบ ตัวอย่างเช่น 'styleId': '1234567890' |
ไม่บังคับ
พารามิเตอร์ | คำอธิบายและตัวอย่าง |
---|---|
linkTarget
|
ไม่บังคับ ระบุว่าการคลิกโฆษณาจะเปิดในหน้าต่างเดียวกันหรือหน้าต่างใหม่ ค่าเริ่มต้นคือ "_top" และคุณใช้พารามิเตอร์นี้ในระดับหน่วยได้ด้วย
ตัวอย่างเช่น 'linkTarget' : '_blank' |
maxTermLength
|
ไม่บังคับ ระบุจํานวนอักขระสูงสุดของข้อความค้นหาที่เกี่ยวข้องรวมถึงการเว้นวรรค ไม่จํากัดหากไม่ได้ตั้งค่า ตัวอย่างเช่น 'maxTermLength' : 50 |
referrerAdCreative
|
ไม่บังคับ หากผู้ใช้เข้ามาที่หน้าเนื้อหาของคุณซึ่งมีหน่วยการค้นหาที่เกี่ยวข้องสำหรับเนื้อหา โดยการคลิกที่โฆษณาหรือลิงก์บนเว็บไซต์อื่น และโฆษณาหรือลิงก์นั้นอยู่ในการควบคุมของคุณ ควรตั้งค่าพารามิเตอร์นี้เป็นข้อความครีเอทีฟโฆษณาของโฆษณาหรือลิงก์นั้นแบบคำต่อคำ การใช้พารามิเตอร์นี้ต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้
หมายเหตุ: คุณต้องระบุพารามิเตอร์นี้เมื่อใช้พารามิเตอร์ ตัวอย่าง: 'referrerAdCreative': 'search for ads related to dental implants' 'referrerAdCreative': 'The Early Signs of Psoriatic Arthritis' |
resultsPageQueryParam
|
ไม่บังคับ ระบุชื่อพารามิเตอร์ของ URL สําหรับคําค้นหาในหน้าผลการค้นหา ค่าเริ่มต้นจะเป็น "q" หากไม่ได้ระบุไว้ ตัวอย่างเช่น 'resultsPageQueryParam' : 'query' |
terms
|
ไม่บังคับ พารามิเตอร์นี้ช่วยให้สามารถระบุรายการที่คั่นด้วยคอมมาของข้อความค้นหาที่เกี่ยวข้องของคุณเองเพื่อให้แสดงพร้อมกับคําขอการค้นหาที่เกี่ยวข้อง แม้ว่า Google อาจใช้หรือไม่ใช้ข้อความที่ระบุไว้ที่นี่ก็ได้
หมายเหตุ: เมื่อใช้พารามิเตอร์นี้ ต้องระบุ ตัวอย่าง: 'terms' : 'cars rental, flight ticket' |
ignoredPageParams
|
ไม่บังคับ ระบุรายการพารามิเตอร์ของ URL สำหรับหน้าเนื้อหาที่มีหน่วยการค้นหาที่เกี่ยวข้องสำหรับเนื้อหา ซึ่งจะละเว้นได้อย่างปลอดภัยโดยไม่ส่งผลต่อเนื้อหาหลักหรือประสบการณ์ของผู้ใช้ หมายเหตุ: ก่อนที่ข้อความค้นหาที่เกี่ยวข้องจะปรากฏในเว็บไซต์ Google จำเป็นต้องรวบรวมข้อมูลหน้าเว็บเพื่อให้แน่ใจว่าข้อความเหล่านั้นมีความเกี่ยวข้องตามบริบท หากหน้าเว็บยังไม่ได้ถูก Crawl หรือถูกบล็อกไม่ให้ทำการ Crawl (เช่น โดย robots.txt) โปรแกรมรวบรวมข้อมูลของ AdSense เราจะไม่แสดงข้อความค้นหาที่เกี่ยวข้องที่แนะนำซึ่งคุณให้ไว้กับ Google ผลิตภัณฑ์การค้นหาที่เกี่ยวข้องกับเนื้อหาใช้ระบบการรวบรวมข้อมูลเนื้อหาของ Google ในการจัดทำดัชนีหน้าและสร้างข้อความค้นหาที่เกี่ยวข้อง URL ของหน้าเนื้อหาที่มีพารามิเตอร์การค้นหา เช่น ตัวแปรการติดตาม รหัสผู้ใช้ รหัสเซสชัน หรือตัวระบุแบบไดนามิกอื่นๆ อาจรบกวนความสามารถของโปรแกรมรวบรวมข้อมูลในการประเมินเนื้อหาหลักของหน้า และอาจนำไปสู่ข้อความค้นหาที่เกี่ยวข้องที่ไม่ถูกต้องหรือไม่เกี่ยวข้อง พารามิเตอร์ของหน้านี้บอกให้โปรแกรมรวบรวมข้อมูลของ Google เพิกเฉยต่อพารามิเตอร์ที่ไม่จำเป็นเหล่านี้ เพื่อให้มีการจัดทำดัชนีเนื้อหาที่เหมาะสมและลดปริมาณการรวบรวมข้อมูลที่ไม่จำเป็น วิธีนี้ช่วยให้ Google จดจำหน้าเว็บได้ดีขึ้นว่ามีการ Crawl แล้ว และเริ่มแสดงคำที่แนะนำ (ทั้ง Google และของพาร์ทเนอร์ หากมีสิทธิ์) การใช้พารามิเตอร์นี้ต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้
ตัวอย่างเช่น
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 และผลที่แต่ละค่ามีต่อโฆษณาที่แสดง
โดยค่าเริ่มต้นของ 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
|
ไม่บังคับ พารามิเตอร์ ค่าเริ่มต้นของ
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
oe
|
ไม่บังคับ พารามิเตอร์ ค่าเริ่มต้นของ
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
ivt
|
ไม่บังคับ พารามิเตอร์นี้ทำให้คุณสามารถใส่บูลีนที่แจ้ง Google ว่าคุณต้องการอนุญาตโฆษณาที่ใช้คุกกี้และพื้นที่เก็บข้อมูลในเครื่องที่มีไว้เพื่อตรวจจับการเข้าชมที่ไม่ถูกต้องเท่านั้นในการเข้าชมที่ได้รับความยินยอมและไม่ได้รับความยินยอม
ระบบจะตั้งค่า IVT เป็น "จริง" โดยค่าเริ่มต้น ตัวอย่างเช่น 'ivt': false |
คำอธิบายพารามิเตอร์ระดับหน่วยโฆษณา
พารามิเตอร์เหล่านี้ส่งผลต่อวิธีที่แต่ละหน่วยโฆษณาบนหน้าเว็บปรากฏต่อผู้ใช้ แต่ละพารามิเตอร์สามารถตั้งค่าให้แตกต่างกันได้สำหรับแต่ละหน่วยโฆษณา
จำเป็น
พารามิเตอร์ | คำอธิบายและตัวอย่าง |
---|---|
container
|
ต้องระบุ รหัสของคอนเทนเนอร์โฆษณาว่างเปล่า <div> ที่โฆษณาควรจะปรากฏ
ตัวอย่างเช่น 'container' : 'afscontainer1' |
maxTop
|
ต้องระบุเมื่อหน่วยโฆษณาอยู่เหนือผลการค้นหา ใช้พารามิเตอร์นี้เพื่อระบุจำนวนโฆษณาที่จะแสดงในหน่วยโฆษณาด้านบน หมายเหตุ: พารามิเตอร์นี้ใช้แทนพารามิเตอร์ "number" หน่วยโฆษณานี้ควรกว้างพอเพื่อให้บรรทัดแรกของโฆษณาไม่มีการตัดขึ้นบรรทัดใหม่ การใช้พารามิเตอร์ maxTop ในตำแหน่งอื่นๆ บนหน้าเว็บเป็นการละเมิดนโยบาย เช่น 'maxTop' : 4 |
width
|
ต้องระบุ ระบุความกว้างของโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้องเป็นพิกเซล ตัวอย่างเช่น 'width' : '700px' 'width' : 700 |
การตั้งค่า
พารามิเตอร์ | คำอธิบายและตัวอย่าง | ||||||||
---|---|---|---|---|---|---|---|---|---|
adLoadedCallback
|
ไม่บังคับ ระบุฟังก์ชัน JavaScript ที่จะเรียกใช้เมื่อโฆษณาหรือการค้นหาที่เกี่ยวข้องโหลดขึ้น หรือเมื่อไม่มีการแสดงโฆษณาหรือการค้นหาที่เกี่ยวข้อง ควรตั้งค่าพารามิเตอร์เป็นฟังก์ชัน Callback ของ JavaScript ที่คุณใช้เพื่ออนุญาตให้ดําเนินการเมื่อการเรียกโฆษณาเสร็จสิ้น ฟังก์ชัน Callback จะใช้พารามิเตอร์ต่อไปนี้
หมายเหตุ: โปรดทดสอบฟังก์ชัน 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 |