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