หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
ประกอบด้วยวิธีการที่ใช้ในการกําหนดและเพิ่มกลุ่มโฆษณา สําหรับข้อมูลเกี่ยวกับตัวสร้าง ให้ดูตัวสร้าง
ตัวอย่างการใช้งาน:
// Get a campaign to add the ad group to.
var iterator = AdsApp.campaigns()
.withIds(['CAMPAIGN ID GOES HERE'])
.get();
while (iterator.hasNext()) {
var campaign = iterator.next();
// Get the campaign's ad group builder and add an ad group.
var operation = campaign.newAdGroupBuilder()
.withName("AD GROUP NAME GOES HERE")
.withStatus("ENABLED")
.build();
// See the Builders topic for performance considerations
// when using the operation object's methods.
if (!operation.isSuccessful()) {
for (var error of operation.getErrors()) {
Logger.log(`${error}\n`);
}
}
}
วิธีการ
| ชื่อวิธี | ชนิดการส่งคืน | คำอธิบาย |
|---|---|---|
| รุ่น | AdGroupOperation | สร้างกลุ่มโฆษณาและส่งกลับวัตถุการดําเนินการที่ใช้ตรวจสอบว่าเพิ่มกลุ่มโฆษณาสําเร็จหรือไม่ |
| withBiddingStrategy(string biddingStrategy) | AdGroupBuilder | ตั้งค่ากลยุทธ์การเสนอราคาของกลุ่มโฆษณา |
| withCpc(double cpc) | AdGroupBuilder | ตั้งค่าราคาเสนอ CPC สูงสุดของกลุ่มโฆษณา |
| withCpm(double cpm) | AdGroupBuilder | ตั้งค่าราคาเสนอ CPM สูงสุดของกลุ่มโฆษณา |
| withCpv(double cpv) | AdGroupBuilder | ตั้งค่าราคาเสนอ CPV สูงสุดของกลุ่มโฆษณา |
| withCustomParameters(Object, customParameters) | AdGroupBuilder | ตั้งค่าพารามิเตอร์แบบกําหนดเองของกลุ่มโฆษณา |
| withEndDate(สตริง endDate) | AdGroupBuilder | ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาหยุดให้บริการ |
| withEndDate(Object, endDate) | AdGroupBuilder | ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาหยุดให้บริการ |
| withLanguage(string language) | AdGroupBuilder | ตั้งค่าภาษาที่ใช้โดยกลุ่มโฆษณานี้ |
| withName(string name) | AdGroupBuilder | ตั้งชื่อกลุ่มโฆษณา |
| withStartDate(สตริง วันที่เริ่มต้น) | AdGroupBuilder | ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาเริ่มแสดง |
| withStartDate(Object startDate) | AdGroupBuilder | ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาเริ่มแสดง |
| withStatus(string status) | AdGroupBuilder | ตั้งค่าสถานะของกลุ่มโฆษณา |
| withTrackingTemplate(string trackingTemplate) | AdGroupBuilder | ตั้งค่าเทมเพลตการติดตามของกลุ่มโฆษณา |
รุ่น
สร้างกลุ่มโฆษณาและส่งกลับวัตถุการดําเนินการที่ใช้ตรวจสอบว่าเพิ่มกลุ่มโฆษณาสําเร็จหรือไม่
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupOperation | วัตถุปฏิบัติการที่ใช้เพื่อตรวจสอบว่าเพิ่มกลุ่มโฆษณาสําเร็จหรือไม่ |
withBiddingStrategy(string biddingStrategy)
ตั้งค่ากลยุทธ์การเสนอราคาของกลุ่มโฆษณา
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| การเสนอราคากลยุทธ์ | สตริง | กลยุทธ์การเสนอราคาที่จะนําไปใช้กับกลุ่มโฆษณา ต่อไปนี้คือค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้
|
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | เครื่องมือสร้างกลุ่มโฆษณาที่ใช้กลยุทธ์การเสนอราคา |
withCpc(double cpc)
ตั้งค่าราคาเสนอ CPC ของกลุ่มโฆษณา
ระบุจํานวนราคาเสนอที่จะใช้เมื่อคําสําคัญตรงกับคําค้นหาของผู้ใช้และกลยุทธ์การเสนอราคาของกลุ่มโฆษณา MANUAL_CPC การเสนอราคานี้จะใช้หากเอนทิตีระดับล่าง เช่น คําสําคัญ ไม่ได้แทนที่
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| CPC | สองเท่า | ราคาเสนอ CPC สูงสุดของกลุ่มโฆษณา สกุลเงินของบัญชีจะกําหนดมูลค่าการเสนอราคาต่ําสุดและสูงสุด สําหรับข้อมูลเพิ่มเติม ให้ดูสกุลเงินที่เสนอราคาและงบประมาณ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้ราคาเสนอ CPC |
withCpm(double cpm)
ตั้งค่าราคาเสนอ CPM ของกลุ่มโฆษณา
ระบุจํานวนราคาเสนอที่จะใช้ต่อการแสดงโฆษณาที่ดู 1,000 ครั้ง และเมื่อ MANUAL_CPM กลยุทธ์การเสนอราคาของกลุ่มโฆษณา
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| CPM | สองเท่า | ราคาเสนอ CPM สูงสุดของกลุ่มโฆษณา สกุลเงินของบัญชีจะกําหนดมูลค่าการเสนอราคาต่ําสุดและสูงสุด สําหรับข้อมูลเพิ่มเติม ให้ดูสกุลเงินที่เสนอราคาและงบประมาณ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้ราคาเสนอ CPM |
withCpv(double cpv)
ตั้งค่าราคาเสนอ CPV ของกลุ่มโฆษณา
ระบุจํานวนเงินเสนอที่จะใช้ต่อการดูหรือต่อการคลิกโฆษณาวิดีโอ และเมื่อ MANUAL_CPV กลยุทธ์การเสนอราคาของกลุ่มโฆษณา
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| CPV | สองเท่า | ราคาเสนอ CPV สูงสุดของกลุ่มโฆษณา สกุลเงินของบัญชีจะกําหนดมูลค่าการเสนอราคาต่ําสุดและสูงสุด สําหรับข้อมูลเพิ่มเติม ให้ดูสกุลเงินที่เสนอราคาและงบประมาณ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | เครื่องมือสร้างกลุ่มโฆษณาที่ใช้ราคาเสนอ CPV |
withCustomParameters(Object, customParameters)
ตั้งค่าพารามิเตอร์แบบกําหนดเองของกลุ่มโฆษณาเพื่อใช้ใน URL สุดท้ายหรือเทมเพลตการติดตาม
พารามิเตอร์แบบกําหนดเองมีประโยชน์ในการแชร์ข้อมูลแบบไดนามิกระหว่าง URL หลายรายการ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้งาน ให้ดู พารามิเตอร์แบบกําหนดเอง
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| customParameters | วัตถุ | แผนที่ของพารามิเตอร์แบบกําหนดเองสูงสุดสามรายการเพื่อนําไปใช้กับกลุ่มโฆษณา ตัวอย่างเช่น {key1: 'value1', key2: 'value2', key3: 'value3'}เมื่อ key คือชื่อของพารามิเตอร์แบบกําหนดเอง และ value คือค่าของพารามิเตอร์ ชื่ออาจมีอักขระ 8 ไบต์สูงสุด 16 ตัว และค่าอาจมีอักขระ 8 ไบต์สูงสุด 200 ตัว |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้พารามิเตอร์แบบกําหนดเอง |
withEndDate(สตริง endDate)
ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาหยุดให้บริการ เรียกใช้วิธีนี้ก็ต่อเมื่อคุณต้องการให้โฆษณาในกลุ่มหยุดให้บริการในวันที่ระบุเท่านั้น
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| endDate | สตริง | วันที่หยุดให้บริการโฆษณา ระบุวันที่ในฟอร์ม YYYYMMDD |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้วันที่สิ้นสุด |
withEndDate(Object, endDate)
ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาหยุดให้บริการ เรียกใช้วิธีนี้ก็ต่อเมื่อคุณต้องการให้โฆษณาในกลุ่มหยุดให้บริการในวันที่ระบุเท่านั้น
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| endDate | วัตถุ | วันที่หยุดให้บริการโฆษณา ระบุวันที่โดยใช้วัตถุที่มีเขตข้อมูลต่อไปนี้
ตัวอย่างเช่น: var date = {year: 2018, month: 5, day: 13};เดือนเป็นฐานหนึ่ง โดยที่ 1 คือเดือนมกราคม และ 12 คือธันวาคม |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้วันที่สิ้นสุด |
withLanguage(string language)
ตั้งค่าภาษาที่ใช้โดยโฆษณาในกลุ่มโฆษณานี้
ตามค่าเริ่มต้น กลุ่มโฆษณาจะสืบทอดภาษาจากแคมเปญหลัก ระบุภาษาในระดับกลุ่มโฆษณาเพื่อแทนที่ภาษาที่ระบุในระดับแคมเปญ หรือหากแคมเปญไม่ได้ระบุภาษา (ต้องระบุภาษาที่ระดับแคมเปญและ/หรือกลุ่มโฆษณา)
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| ภาษา | สตริง | ภาษาที่ใช้โดยโฆษณาในกลุ่มโฆษณา ตัวอย่างเช่น ภาษาอังกฤษ สตริงไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก ห้ามใช้รหัสภาษาที่มีอักขระสองตัว สําหรับรายการภาษาที่รองรับ โปรดดูภาษาของโฆษณา |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้ภาษา |
withName(string name)
ตั้งชื่อกลุ่มโฆษณา
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| ชื่อ | สตริง | ชื่อของกลุ่มโฆษณา ต้องระบุชื่อ ชื่อสามารถมีอักขระได้สูงสุด 256 ตัว และต้องไม่ซ้ํากันในกลุ่มโฆษณาที่ใช้งานอยู่ทั้งหมดในแคมเปญ |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้ชื่อ |
withStartDate(สตริง วันที่เริ่มต้น)
ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาเริ่มแสดง เรียกใช้วิธีนี้ก็ต่อเมื่อคุณต้องการให้โฆษณาในกลุ่มเริ่มแสดงในวันที่ระบุเท่านั้น มิฉะนั้น โฆษณาจะเริ่มให้บริการทันที
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| endDate | สตริง | วันที่ที่จะเริ่มให้บริการโฆษณา ระบุวันที่ในฟอร์ม YYYYMMDD |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้วันที่เริ่มต้น |
withStartDate(Object startDate)
ตั้งค่าวันที่ที่โฆษณาในกลุ่มโฆษณาเริ่มแสดง เรียกใช้วิธีนี้ก็ต่อเมื่อคุณต้องการให้โฆษณาในกลุ่มเริ่มแสดงในวันที่ระบุเท่านั้น มิฉะนั้น โฆษณาจะเริ่มให้บริการทันที
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| endDate | วัตถุ | วันที่ที่จะเริ่มให้บริการโฆษณา ระบุวันที่โดยใช้วัตถุที่มีเขตข้อมูลต่อไปนี้
ตัวอย่างเช่น: var date = {year: 2018, month: 5, day: 13};เดือนเป็นฐานหนึ่ง โดยที่ 1 คือเดือนมกราคม และ 12 คือธันวาคม |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้วันที่เริ่มต้น |
withStatus(string status)
ตั้งค่าสถานะของกลุ่มโฆษณา
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| สถานะ | สตริง | สถานะของกลุ่มโฆษณา ต่อไปนี้คือค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้
|
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่มีสถานะที่ใช้ |
withTrackingTemplate(string trackingTemplate)
ตั้งค่าเทมเพลตการติดตามของกลุ่มโฆษณา
เทมเพลตการติดตามจะใช้กับ FinalUrl ของคําสําคัญเพื่อสร้าง URL ปลายทางที่ใช้โดยโฆษณา สําหรับข้อมูลเพิ่มเติม ให้ดู ฉันสามารถใช้พารามิเตอร์การติดตามหรือ URL ใดได้บ้าง
อาร์กิวเมนต์
| ชื่อ | พิมพ์ | คำอธิบาย |
|---|---|---|
| trackingTemplate | สตริง | เทมเพลตการติดตามที่จะใช้กับกลุ่มโฆษณา |
ส่งกลับ
| พิมพ์ | คำอธิบาย |
|---|---|
| AdGroupBuilder | ตัวสร้างกลุ่มโฆษณาที่ใช้เทมเพลตการติดตาม |