หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
มีวิธีการสําหรับการจัดการคําสําคัญ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับคําสําคัญ ให้ดูคําสําคัญ
วิธีการ
| ชื่อวิธี | ชนิดการส่งคืน | คำอธิบาย |
|---|---|---|
| adParams | AdParamSelector | รับตัวเลือกที่ใช้เพื่อรับพารามิเตอร์การทดแทนทั้งหมดที่ใช้ในโฆษณาสําหรับคําสําคัญนี้ |
| applyLabel(string name) | เป็นโมฆะ | นําป้ายกํากับไปใช้กับคําสําคัญนี้ |
| การเสนอราคา | การเสนอราคาคําสําคัญ | รับวิธีการที่ใช้จัดการราคาเสนอของคําสําคัญนี้ |
| clearDestinationUrl | เป็นโมฆะ | นํา URL ปลายทางของคําสําคัญนี้ออก |
| เปิดใช้งาน | เป็นโมฆะ | เปิดใช้งานคําสําคัญนี้ |
| getAdGroup | กลุ่มโฆษณา | รับกลุ่มโฆษณาที่คําสําคัญนี้เป็นสมาชิก |
| getApprovalStatus | สตริง | ได้รับสถานะการอนุมัติจากบรรณาธิการของคําสําคัญนี้ |
| getCampaign | แคมเปญ | รับแคมเปญที่คําสําคัญนี้เป็นของแคมเปญ |
| getEntityType | สตริง | รับชนิดของเอนทิตีนี้ |
| getFirstPageCpc | สองเท่า | รับการเสนอราคาโดยประมาณที่จําเป็นเพื่อให้อยู่ในหน้าแรกของผลลัพธ์การค้นหา |
| getId | สตริง | รับ ID ที่ระบุคําสําคัญนี้โดยเฉพาะ |
| getMatchType | สตริง | รับชนิดการทํางานของคีย์เวิร์ดนี้ |
| getQualityScore | จํานวนเต็ม | รับคะแนนคุณภาพของคําสําคัญนี้ |
| getStats | สถิติ | รับข้อมูลประสิทธิภาพการทํางานของคําสําคัญนี้ |
| getText | สตริง | รับข้อความของคําสําคัญ |
| getTopOfPageCpc | สองเท่า | รับการเสนอราคาโดยประมาณที่จําเป็นต่อการอยู่ที่ด้านบนของผลการค้นหา |
| isEnabled | บูลีน | รับค่าบูลีนที่ระบุว่าคําสําคัญนี้เปิดใช้งานหรือไม่ |
| isPaused | บูลีน | รับค่าบูลีนที่ระบุว่าคําสําคัญนี้ถูกหยุดชั่วคราวหรือไม่ |
| ป้ายชื่อ | LabelSelector | ใช้ ตัวเลือก เพื่อกรองรายการป้ายกํากับที่เกี่ยวข้องกับคําสําคัญนี้ |
| หยุดชั่วคราว | เป็นโมฆะ | หยุดคําสําคัญนี้ชั่วคราว |
| เอาออก | เป็นโมฆะ | ลบคําสําคัญนี้ออก |
| removeLabel(string name) | เป็นโมฆะ | เอาป้ายกํากับออกจากคําสําคัญนี้ |
| setAdParam(int index, string insertionText) | เป็นโมฆะ | เพิ่มพารามิเตอร์การแทนที่ และตั้งค่าให้กับข้อความที่ระบุ |
| URL | URL คําสําคัญ | รับวิธีการที่ใช้ในการจัดการ URL สุดท้าย เทมเพลตการติดตาม และพารามิเตอร์ที่กําหนดเองของคําสําคัญนี้ |
adParams
รับตัวเลือกพารามิเตอร์ทดแทนทั้งหมดที่ใช้ในโฆษณาสําหรับคําสําคัญนี้
ค่าการทดแทนจะถูกใช้ในโฆษณาหากชื่อเรื่อง ข้อความ URL ที่แสดง หรือ URL ปลายทางของโฆษณามีสตริงทดแทนแบบไดนามิก {Param1}, {Param2} หรือ {Param3}
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdParamSelector | ตัวเลือกที่ประกอบด้วยรายการของพารามิเตอร์ทดแทนสําหรับคําสําคัญนี้ |
applyLabel(string name)
นําป้ายกํากับไปใช้กับคําสําคัญ
คุณสามารถใช้ป้ายกํากับคําสําคัญได้สูงสุด 50 ป้าย ตัวอย่างเช่น การเพิ่มป้ายชื่อให้กับคําสําคัญ ให้ดูที่ การใช้ป้ายชื่อ
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| ชื่อ | สตริง | ชื่อตรงตามตัวพิมพ์ใหญ่-เล็กของป้ายชื่อ หากต้องการดูรายการป้ายกํากับในบัญชีนี้ที่คุณนําไปใช้ได้ ให้ดู AdsApp.labels |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| เป็นโมฆะ | ไม่ส่งกลับค่าใดๆ |
การเสนอราคา
รับวิธีการที่ใช้จัดการราคาเสนอของคําสําคัญนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| การเสนอราคาคําสําคัญ | ประกอบด้วยวิธีการที่ใช้ในการจัดการราคาเสนอของคําสําคัญนี้ |
clearDestinationUrl
นํา URL ปลายทางของคําสําคัญนี้ออก
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| เป็นโมฆะ | ไม่ส่งกลับค่าใดๆ |
เปิดใช้งาน
เปิดใช้งานคําสําคัญนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| เป็นโมฆะ | ไม่ส่งกลับค่าใดๆ |
getAdGroup
รับกลุ่มโฆษณาที่คําสําคัญนี้เป็นสมาชิก
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| กลุ่มโฆษณา | กลุ่มโฆษณาที่มีคําสําคัญนี้เป็นของกลุ่มโฆษณา |
getApprovalStatus
ได้รับสถานะการอนุมัติจากบรรณาธิการของคําสําคัญนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สตริง | สถานะการอนุมัติบรรณาธิการของคําสําคัญ สถานะจะระบุว่าคําสําคัญอยู่ระหว่างการตรวจทาน อนุมัติ หรือไม่อนุญาต ค่าที่เป็นไปได้คือ
|
getCampaign
รับแคมเปญที่คําสําคัญนี้เป็นของแคมเปญ
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| แคมเปญ | แคมเปญที่คําสําคัญนี้เป็นของแคมเปญ |
getEntityType
ส่งกลับชนิดของเอนทิตีนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สตริง | ชนิดของเอนทิตีนี้ ซึ่งเป็น คําสําคัญ |
getId
รับ ID ที่ระบุคําสําคัญนี้โดยเฉพาะ
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สตริง | ID ที่ระบุคําสําคัญนี้โดยเฉพาะ |
getFirstPageCpc
รับการเสนอราคาโดยประมาณที่จําเป็นสําหรับโฆษณาเพื่อแสดงบนแถบด้านข้าง
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สองเท่า | ราคาเสนอโดยประมาณที่จําเป็นสําหรับโฆษณาเพื่อแสดงบนแถบด้านข้าง |
getMatchType
รับชนิดการทํางานของคีย์เวิร์ดนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สตริง | ชนิดการทํางานของคีย์เวิร์ด ค่าที่เป็นไปได้คือ
|
getQualityScore
รับคะแนนคุณภาพของคําสําคัญนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| จํานวนเต็ม | คะแนนคุณภาพของคําสําคัญ คะแนนอยู่ในช่วง 1 ถึง 10 (สูงสุด) ถ้าไม่สามารถคํานวณคะแนนคุณภาพของคําสําคัญได้ วิธีนี้จะส่งกลับ NULL คะแนนจะแสดงให้คุณเห็นว่าโฆษณาของคุณมีการแข่งขันในตลาดเพียงใด โดยการวัดว่าคําสําคัญและหน้าเริ่มต้นของคุณเกี่ยวข้องกับคําค้นหาของลูกค้ามากน้อยเพียงใด สําหรับข้อมูลเพิ่มเติม ให้ดู รายงานประสิทธิภาพของคําสําคัญ |
getStats
รับข้อมูลประสิทธิภาพของคําสําคัญนี้
ในการเรียกใช้เมธอดนี้ คุณต้องรวมเมธอดใดวิธีการหนึ่งforDateRangeไว้ในสายโซ่ของตัวเลือกคําสําคัญ
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สถิติ | ข้อมูลประสิทธิภาพของคําสําคัญ ตัวอย่างเช่น การคลิกและการแสดงผล |
getText
รับข้อความของคําสําคัญ ข้อความจะมีไวยากรณ์ชนิดที่ตรงกันของคําสําคัญ หากมี ตัวอย่างเช่น:
- คําสําคัญคือ books หากประเภทการทํางาน เป็นแบบกว้าง หรือ +books หากคําสําคัญใช้ตัวปรับเปลี่ยนแบบกว้าง
- คําสําคัญคือ "หนังสือ" ถ้าประเภทที่ตรงกันเป็น วลี
- คําสําคัญคือ [หนังสือปกแข็ง] ถ้า ชนิดที่ตรง กันตรงกัน
สําหรับข้อมูลเพิ่มเติมเกี่ยวกับชนิดเหล่านี้ ให้ดู ประเภทการจับคู่คําสําคัญคืออะไร และฉันจะใช้คําเหล่านั้นได้อย่างไร
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สตริง | ข้อความของคําสําคัญ |
getTopOfPageCpc
รับราคาเสนอโดยประมาณที่จําเป็นสําหรับโฆษณาเพื่อแสดงอยู่เหนือผลลัพธ์การค้นหาแบบออร์แกนิก
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| สองเท่า | ราคาเสนอโดยประมาณที่จําเป็นสําหรับโฆษณาเพื่อแสดงเหนือผลลัพธ์การค้นหาแบบออร์แกนิก |
isEnabled
รับค่าบูลีนที่ระบุว่าคําสําคัญนี้เปิดใช้งานหรือไม่
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| บูลีน | Is true if this keyword is enabled; มิฉะนั้น เป็นเท็จ |
isPaused
รับค่าบูลีนที่ระบุว่าคําสําคัญนี้ถูกหยุดชั่วคราวหรือไม่
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| บูลีน | Is true if this keyword is paused; มิฉะนั้น เป็นเท็จ |
ป้ายชื่อ
ใช้ ตัวเลือก เพื่อกรองรายการป้ายกํากับที่เกี่ยวข้องกับคําสําคัญนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| LabelSelector | ตัวเลือกที่ใช้ในการกรองรายการป้ายกํากับที่เกี่ยวข้องกับคําสําคัญนี้ |
หยุดชั่วคราว
หยุดคําสําคัญนี้ชั่วคราว
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| เป็นโมฆะ | ไม่ส่งกลับค่าใดๆ |
เอาออก
ลบคําสําคัญนี้ออก
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| เป็นโมฆะ | ไม่ส่งกลับค่าใดๆ |
removeLabel(string name)
นําป้ายกํากับออกจากคําสําคัญ
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| ชื่อ | สตริง | ชื่อตรงตามตัวพิมพ์ใหญ่-เล็กของป้ายชื่อ เมื่อต้องการรับรายการป้ายชื่อที่เชื่อมโยงกับคําสําคัญนี้ ให้ดูป้ายชื่อ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| เป็นโมฆะ | ไม่ส่งกลับค่าใดๆ |
setAdParam(int index, string insertionText)
เพิ่มพารามิเตอร์การแทนที่ และตั้งค่าให้กับข้อความที่ระบุ ถ้ามีพารามิเตอร์การแทนที่ ข้อความนั้นจะถูกเขียนทับ
ค่าการทดแทนจะถูกใช้ในโฆษณาหากชื่อเรื่อง ข้อความ URL ที่แสดง หรือ URL สุดท้ายของโฆษณามีสตริงการแทนที่แบบไดนามิก {Param1}, {Param2} หรือ {Param3} สําหรับข้อจํากัดและข้อมูลเกี่ยวกับการใช้พารามิเตอร์เหล่านี้ ให้ดูที่ Param1, Param2 และ Param3
ค่าการทดแทนยังถูกใช้ในเทมเพลตการติดตาม ถ้าเทมเพลตระบุพื้นที่ที่สํารองไว้ {param1:default}, {param2:default} หรือ {param3:default}
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| ดัชนี | int | ดัชนีของพารามิเตอร์การแทนที่ที่จะตั้งค่า ค่าดัชนีที่ถูกต้อง คือ 1 ถึง 3 ปิดแล้ว ใช้ 1 สําหรับ param1, 2 สําหรับ param2 และ 3 สําหรับ param3 |
| insertionText | สตริง | ข้อความที่จะตั้งค่าพารามิเตอร์การแทนที่ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| เป็นโมฆะ | ไม่ส่งกลับค่าใดๆ |
URL
รับวิธีการที่ใช้ในการจัดการ URL สุดท้าย เทมเพลตการติดตาม และพารามิเตอร์ที่กําหนดเองของคําสําคัญนี้
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| URL คําสําคัญ | ประกอบด้วยวิธีการที่ใช้ URL สุดท้ายของคําสําคัญ เทมเพลตการติดตาม และพารามิเตอร์แบบกําหนดเอง |