คำอธิบายพารามิเตอร์สำหรับ Custom Search Ads

สำหรับผู้ใช้ขั้นสูง เราได้เตรียมรายการพารามิเตอร์สไตล์โฆษณาในเครือข่าย Search ที่ระบบรองรับในปัจจุบันไว้ให้ โค้ดที่คุณสร้างขึ้นใน AdSense มีการตั้งค่าพารามิเตอร์ที่ใช้บ่อยทั้งหมด พารามิเตอร์ที่ต้องใช้มี 2 ค่า ได้แก่ pubId และ query AdSense จะแสดง pubId แต่คุณต้องแก้ไขโค้ดและส่งค่าสำหรับพารามิเตอร์ query พารามิเตอร์อื่นๆ ทั้งหมดนั้นไม่บังคับ โดยจะอธิบายไว้ด้านล่าง

ประเภทพารามิเตอร์

พารามิเตอร์มี 2 ประเภทดังนี้

• พารามิเตอร์ระดับหน้าเว็บที่ใช้กับหน่วยโฆษณาทั้งหมดในหน้าเว็บ
• พารามิเตอร์ระดับหน่วยโฆษณาที่ใช้กับหน่วยโฆษณาแต่ละหน่วย

ต่อไปนี้เป็นตัวอย่างข้อมูลจากโปรแกรมสร้างโค้ดที่มีการบล็อกโฆษณา 2 รายการ หากต้องการกำหนดค่าโค้ดนี้ คุณต้องตั้งค่าพารามิเตอร์ query ในแมป pageOptions (เช่น “query”: myQuery) นี่คือทั้งหมดที่จำเป็นสำหรับการเริ่มแสดงโฆษณา นอกจากนี้คุณยังตั้งค่าพารามิเตอร์ระดับหน้าเว็บในการบล็อกระดับหน้าเว็บและพารามิเตอร์ระดับหน่วยโฆษณาแต่ละรายการในแมป adblock1 และ adblock2 ได้ด้วย (ไม่บังคับ)

<div id="afscontainer1"></div>
<div id="afscontainer2"></div>

<script type="text/javascript" charset="utf-8">

  // Page level parameters
  var pageOptions = {
    "pubId": "partner-pub-1234567891234567",
    "styleId": "1234567890",
    "query": myQuery,
  };

  // Unit level parameters
  var adblock1 = {
    "container": "afscontainer1"
  };

  var adblock2 = {
    "container": "afscontainer2"
  };

  _googCsa('ads', pageOptions, adblock1, adblock2);

</script>

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

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

จำเป็น

พารามิเตอร์	คำอธิบายและตัวอย่าง
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 // where myQuery is a JavaScript variable containing the search query
resultsPageBaseUrl	ต้องระบุเมื่อมีหน่วยการค้นหาที่เกี่ยวข้องในหน้าเว็บ ระบุ URL ของหน้าผลการค้นหาที่คําค้นหาเป็นข้อความค้นหาที่เกี่ยวข้องซึ่งผู้ใช้คลิก resultsPageBaseUrl อาจมีพารามิเตอร์ของตัวเอง ยกเว้นคําค้นหาที่จะเพิ่มต่อท้ายโดยอัตโนมัติ ตัวอย่าง 'resultsPageBaseUrl' : 'http://www.example.com/search?a=v1&b=v2'
styleId	ต้องระบุ ระบุรหัสของสไตล์โฆษณาในเครือข่าย Search ซึ่งจะใช้กับโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้องในหน้าเว็บ ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้สไตล์โฆษณาในเครือข่าย Search โปรดทราบว่าเมื่อมีการตั้งค่า styleId สําหรับคําขอ โฆษณาหรือการค้นหาที่เกี่ยวข้องจะแสดงผลด้วยสไตล์นี้ และระบบจะไม่สนใจพารามิเตอร์สไตล์เดิม หากไม่ได้ระบุ styleId ในคําขอ ระบบจะแสดงสไตล์ค่าเริ่มต้นของระบบ ตัวอย่าง 'styleId': '1234567890'

ไม่บังคับ

พารามิเตอร์	คำอธิบายและตัวอย่าง
linkTarget	ไม่บังคับ ระบุว่าการคลิกโฆษณาจะเปิดในหน้าต่างเดิมหรือหน้าต่างใหม่ ค่าเริ่มต้นคือ "_top" และคุณใช้พารามิเตอร์นี้ในระดับหน่วยได้ด้วย '_top' เปิดในหน้าต่างเดิม '_blank' เปิดในหน้าต่างใหม่ ตัวอย่าง 'linkTarget' : '_blank'
maxTermLength	ไม่บังคับ ระบุจํานวนอักขระสูงสุดของข้อความค้นหาที่เกี่ยวข้องซึ่งรวมการเว้นวรรคด้วย ไม่จํากัดหากไม่ได้ตั้งค่า ตัวอย่าง 'maxTermLength' : 50
referrerAdCreative	ไม่บังคับ หากผู้ใช้เข้ามาที่หน้าเนื้อหาซึ่งมีหน่วยการค้นหาที่เกี่ยวข้องกับเนื้อหาด้วยการคลิกโฆษณาหรือลิงก์ในเว็บไซต์อื่น และโฆษณาหรือลิงก์นั้นอยู่ในการควบคุมของคุณ ควรตั้งค่าพารามิเตอร์นี้เป็นข้อความครีเอทีฟโฆษณาของโฆษณาหรือลิงก์ดังกล่าวให้เหมือนกันทุกคำ โดยต้องเป็นไปตามหลักเกณฑ์ต่อไปนี้ ควรระบุพารามิเตอร์นี้ในการค้นหาที่เกี่ยวข้องสําหรับคำขอเนื้อหาเท่านั้น และไม่สนใจคําขออื่นๆ ทั้งหมด ควรใช้กับการเข้าชมซึ่งตั้งใจให้มีแหล่งที่มาจากเว็บไซต์อื่นเท่านั้น และไม่ควรใช้กับการเข้าชมจากการค้นหาทั่วไป อาจมีบรรทัดชื่อและ/หรือคําอธิบายของโฆษณาหรือลิงก์ครีเอทีฟโฆษณา ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ ยอมรับการเข้ารหัส UTF-8 ที่ถูกต้อง รองรับอักขระ Unicode / เครื่องหมายกำกับการออกเสียง Google อาจใช้หรือไม่สนใจพารามิเตอร์ที่คุณส่งก็ได้ เมื่อใช้อาจส่งผลต่อการเลือกและการจัดอันดับคำดังกล่าว ตัวอย่าง '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'

การตั้งค่า

พารามิเตอร์	คำอธิบายและตัวอย่าง
adsafe	ไม่บังคับ ระบุกฎของการกรองที่ Google ควรใช้กับโฆษณาที่ตรงกับคำค้นหา ต่อไปนี้คือการตั้งค่าที่ถูกต้องสำหรับ adsafe และผลที่แต่ละค่ามีต่อโฆษณาที่แสดง 'high' แสดงโฆษณาที่เหมาะสำหรับเยาวชน ไม่แสดงโฆษณาที่ไม่เหมาะสำหรับเยาวชนหรือโฆษณาที่มีเนื้อหาเกี่ยวกับเรื่องเพศ 'medium' - แสดงโฆษณาที่เหมาะและไม่เหมาะสำหรับเยาวชน แต่จะไม่แสดงโฆษณาที่มีเนื้อหาเรื่องเพศสำหรับผู้ใหญ่ 'low' - แสดงโฆษณาทุกประเภท หมายเหตุ: ตามค่าเริ่มต้น adsafe จะตั้งค่าเป็น 'high' ตัวอย่าง 'adsafe': 'medium'
adtest	ไม่บังคับ พารามิเตอร์ adtest ใช้เพื่อระบุว่าคำขอโฆษณาเป็นการทดสอบ เมื่อพารามิเตอร์ adtest มีค่าเป็น 'on' Google จะถือว่าคำขอนั้นเป็นการทดสอบและไม่นับการแสดงโฆษณาหรือติดตามผลการคลิกผ่าน เมื่อพารามิเตอร์ adtest ตั้งค่าไว้เป็น 'on' คุณจะไม่สร้างรายได้ใดๆ หมายเหตุ: ใช้พารามิเตอร์นี้เมื่อทำการทดสอบ แต่อย่าใช้ในระบบที่ใช้งานจริง มิฉะนั้นคุณจะไม่ได้รับรายได้จากโฆษณาที่คุณแสดง ค่าเริ่มต้นของ adtest จะเป็น 'off' ตัวอย่าง 'adtest' : 'on'
channel	ไม่บังคับ คุณอาจรวมแชแนลของ AdSense สำหรับ Search เพื่อติดตามประสิทธิภาพของหน้าเว็บต่างๆ ใช้รหัสแชแนลเฉพาะที่คุณสร้างขึ้นในบัญชี AdSense ดูข้อมูลเพิ่มเติมเกี่ยวกับการติดตามประสิทธิภาพโฆษณาด้วยแชเนลที่กำหนดเอง หากมีหลายแชแนล ควรแยกจากกันโดยใช้สัญลักษณ์ "+"   ตัวอย่าง 'channel' : 'testA' 'channel' : 'testA+testB'
hl	ไม่บังคับ พารามิเตอร์นี้เป็นตัวระบุภาษาซึ่งโฆษณาที่ขอควรกำหนดเป้าหมาย ค่าเริ่มต้นจะเป็น "en" Google รองรับรหัสภาษา Google Ads API ทั้งหมด หมายเหตุ: ผู้ลงโฆษณาเป็นผู้กำหนดภาษาที่โฆษณาของตนกำหนดเป้าหมาย หากคุณใส่พารามิเตอร์นี้ในคำขอของคุณ Google จะแสดงเฉพาะโฆษณาที่กำหนดเป้าหมายสำหรับภาษานั้นหรือที่กำหนดเป้าหมายสำหรับทุกภาษาเท่านั้น แต่จะไม่รับประกันว่าข้อความโฆษณาจะอยู่ในภาษาที่กำหนด โดยปกติคุณควรตั้งค่าพารามิเตอร์ hl เป็นภาษาหลักของหน้าเว็บที่มีการส่งพารามิเตอร์นี้ ตัวอย่าง 'hl' : 'es'
ie	ไม่บังคับ พารามิเตอร์ ie กำหนดรูปแบบการเข้ารหัสอักขระที่ควรใช้เพื่อตีความสตริงคำค้นหา ค่าเริ่มต้นของ ie จะเป็น 'utf-8' ค่า ชื่อมาตรฐาน ภาษาที่รองรับที่เกี่ยวข้อง latin1 ISO-8859-1 ยุโรปตะวันตก (คาตาลัน เดนมาร์ก ดัตช์ อังกฤษ ฟินแลนด์ ฝรั่งเศส เยอรมัน อินโดนีเซีย อิตาเลียน นอร์เวย์ โปรตุเกส สเปน สวีเดน) latin2 ISO-8859-2 ยุโรปตะวันออก (โครเอเชีย เช็ก ฮังการี โปแลนด์ โรมาเนีย เซอร์เบีย สโลวัก สโลวีเนีย) latin3 ISO-8859-3   latin4 ISO-8859-4 บอลติค (เอสโตเนีย ลัตเวีย ลิทัวเนีย) cyrillic ISO-8859-5 บัลแกเรีย รัสเซีย arabic ISO-8859-6   greek 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' ค่า ชื่อมาตรฐาน ภาษาที่รองรับที่เกี่ยวข้อง latin1 ISO-8859-1 ยุโรปตะวันตก (คาตาลัน เดนมาร์ก ดัตช์ อังกฤษ ฟินแลนด์ ฝรั่งเศส เยอรมัน อินโดนีเซีย อิตาเลียน นอร์เวย์ โปรตุเกส สเปน สวีเดน) latin2 ISO-8859-2 ยุโรปตะวันออก (โครเอเชีย เช็ก ฮังการี โปแลนด์ โรมาเนีย เซอร์เบีย สโลวัก สโลวีเนีย) latin3 ISO-8859-3   latin4 ISO-8859-4 บอลติค (เอสโตเนีย ลัตเวีย ลิทัวเนีย) cyrillic ISO-8859-5 บัลแกเรีย รัสเซีย arabic ISO-8859-6   greek 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 ทั้งหมด
personalizedAds	ไม่บังคับ ระบุว่าผู้ใช้ยินยอมให้ผู้เผยแพร่โฆษณาแชร์ข้อมูลส่วนบุคคลกับ Google เพื่อวัตถุประสงค์ในการโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้หรือไม่ true แสดงโฆษณาที่กำหนดเป้าหมายตามคำค้นหาและโฆษณาบางรายการที่อาจกำหนดเป้าหมายไปยังคุกกี้ Google ของผู้ใช้ หากผู้ใช้อยู่ในสหภาพยุโรป ผู้ใช้ต้องยินยอมให้เว็บไซต์ของคุณแชร์ข้อมูลส่วนบุคคลกับ Google เพื่อการโฆษณาที่ปรับเปลี่ยนให้เหมาะกับแต่ละบุคคลก่อน false แสดงเฉพาะโฆษณาที่กำหนดเป้าหมายตามคำค้นหา การดำเนินการนี้จะไม่แสดงโฆษณาที่กำหนดเป้าหมายไปยังคุกกี้ Google ของผู้ใช้ หากผู้ใช้ปฏิเสธความยินยอมในการให้เว็บไซต์แชร์ข้อมูลส่วนบุคคลกับ Google เพื่อวัตถุประสงค์ในการโฆษณาที่ปรับตามโปรไฟล์ของผู้ใช้ คุณต้องตั้งค่านี้เป็น false หมายเหตุ: ตามค่าเริ่มต้น personalizedAds จะตั้งไว้เป็น "true" ตัวอย่าง 'personalizedAds': false

คำอธิบายพารามิเตอร์ระดับหน่วยโฆษณา

พารามิเตอร์เหล่านี้ส่งผลต่อวิธีที่แต่ละหน่วยโฆษณาบนหน้าเว็บปรากฏต่อผู้ใช้ แต่ละพารามิเตอร์จะตั้งค่าให้แตกต่างกันได้สำหรับแต่ละหน่วยโฆษณา

ต้องระบุ

พารามิเตอร์	คำอธิบายและตัวอย่าง
container	ต้องระบุ รหัสของคอนเทนเนอร์โฆษณาว่างเปล่า <div id='afscontainer1'></div> ที่โฆษณาจะปรากฏ ตัวอย่าง 'container' : 'afscontainer1'
maxTop	ต้องระบุ ใช้พารามิเตอร์นี้เพื่อระบุจำนวนโฆษณาที่จะแสดงในหน่วยโฆษณาด้านบน หมายเหตุ: พารามิเตอร์นี้ใช้แทนพารามิเตอร์ number หน่วยโฆษณานี้ควรกว้างพอเพื่อให้บรรทัดแรกของโฆษณาไม่มีการตัดขึ้นบรรทัดใหม่ การใช้พารามิเตอร์ maxTop ในตำแหน่งอื่นๆ บนหน้าเว็บเป็นการละเมิดนโยบาย ตัวอย่าง 'maxTop' : 4
width	ต้องระบุ ระบุความกว้างของหน่วยโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้องเป็นพิกเซล ตัวอย่าง 'width' : '700px' 'width' : 700

การตั้งค่า

พารามิเตอร์	คำอธิบายและตัวอย่าง
adLoadedCallback	ไม่บังคับ ระบุฟังก์ชัน JavaScript ที่จะเรียกใช้เมื่อโฆษณาหรือการค้นหาที่เกี่ยวข้องโหลดขึ้น หรือเมื่อไม่มีการแสดงโฆษณาหรือการค้นหาที่เกี่ยวข้อง ควรตั้งค่าพารามิเตอร์เป็นฟังก์ชันเรียกกลับของ JavaScript ที่คุณใช้เพื่ออนุญาตให้ดําเนินการเมื่อการเรียกโฆษณาเสร็จสิ้น ฟังก์ชันเรียกกลับจะใช้พารามิเตอร์ต่อไปนี้ containerName ชื่อคอนเทนเนอร์ของโฆษณาหรือหน่วยการค้นหาที่เกี่ยวข้อง adsLoaded ตั้งค่าเป็นจริงเมื่อมีโฆษณาหรือข้อความค้นหาที่เกี่ยวข้องอย่างน้อย 1 รายการที่จะแสดง ตั้งค่าเป็นเท็จเมื่อไม่มีโฆษณาหรือการค้นหาที่เกี่ยวข้องแสดง isExperimentVariant ตั้งค่าเป็นจริงหากการทดสอบสไตล์ที่กําหนดเองนั้นทํางานอยู่และเลือกตัวแปรของการทดสอบเพื่อแสดงโฆษณา callbackOptions ออบเจ็กต์ JSON ที่มีช่องต่อไปนี้ termPositions: สําหรับบล็อกการค้นหาที่เกี่ยวข้อง ซึ่งมี map<string,int> ของคําที่ผู้เผยแพร่โฆษณาระบุไว้ให้กับตําแหน่งที่ไม่มีการจัดทําดัชนีของคําเหล่านี้ในการตอบสนอง หากมีการระบุคําไว้แต่ไม่ได้ส่งคืน ก็จะไม่ปรากฏในแมป หมายเหตุ: โปรดทดสอบฟังก์ชันเรียกกลับเพื่อตรวจสอบว่าไม่มีข้อผิดพลาด โดยเฉพาะอย่างยิ่งข้อผิดพลาดที่อาจรบกวนการโหลดหน้าเว็บ ตัวอย่างโค้ดเรียกกลับ 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	ไม่บังคับ จํานวนการค้นหาที่เกี่ยวข้องที่ควรปรากฏในหน่วยนี้ พารามิเตอร์นี้จะแสดงการค้นหาที่เกี่ยวข้องอย่างน้อย 3 รายการ ยกเว้นกรณีที่ตั้งค่าเป็น 0 ค่าเริ่มต้นจะเป็น 0 หากไม่ได้ระบุไว้ ตัวอย่าง 'relatedSearches' : 4