พารามิเตอร์
คำอธิบายพารามิเตอร์ระดับหน้าเว็บ
ระบุพารามิเตอร์เหล่านี้เพียง 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 อาจมี URL ของตนเอง ยกเว้นคำค้นหาที่จะต่อท้ายโดยอัตโนมัติ ตัวอย่าง 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2' |
relatedSearchTargeting
|
ต้องระบุเมื่อมีหน่วยการค้นหาที่เกี่ยวข้องในหน้า คุณต้องระบุพารามิเตอร์นี้เมื่อมีการขอหน่วยการค้นหาที่เกี่ยวข้อง โดยจะควบคุมประเภทของ ประสบการณ์การค้นหาที่เกี่ยวข้องจะปรากฏขึ้น โดยขึ้นอยู่กับบริบทของหน้า ดังนี้
หมายเหตุ: ระบบจะตั้งค่าพารามิเตอร์หน้า relatedSearchTarget เป็นโดยอัตโนมัติ "query" โดยค่าเริ่มต้น อย่างไรก็ตาม คุณต้องทราบว่ามูลค่าเริ่มต้นนี้ ออกแบบมาสำหรับหน้าผลการค้นหาเท่านั้น (การค้นหาที่เกี่ยวข้องในการค้นหา) หากคุณ โดยใช้การค้นหาที่เกี่ยวข้องในหน้าเว็บประเภทอื่นๆ (เช่น บทความ บล็อกโพสต์) คุณต้อง ตั้งค่าพารามิเตอร์เป็น "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) Crawler ของ AdSense เราจะไม่แสดงข้อความค้นหาที่เกี่ยวข้องที่แนะนำซึ่งคุณให้ไว้กับ Google ผลิตภัณฑ์การค้นหาที่เกี่ยวข้องในเนื้อหาอาศัยระบบการ Crawl เนื้อหาของ 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 |