AdGroupBuilder

ประกอบด้วยวิธีการที่ใช้ในการกําหนดและเพิ่มกลุ่มโฆษณา สําหรับข้อมูลเกี่ยวกับผู้สร้าง ดูผู้สร้าง

การใช้งานตัวอย่าง:

    // 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 (สตริง biddingStrategy)	AdGroupBuilder	ตั้งค่ากลยุทธ์การเสนอราคาของกลุ่มโฆษณา
withCpc(double cpc)	AdGroupBuilder	ตั้งค่าการเสนอราคา CPC สูงสุดของกลุ่มโฆษณา
withCpm(double cpm)	AdGroupBuilder	ตั้งค่าการเสนอราคา CPM สูงสุดของกลุ่มโฆษณา
withCpv(double cpv)	AdGroupBuilder	ตั้งค่าการเสนอราคา CPV สูงสุดของกลุ่มโฆษณา
withCustomParameters(Object customParameters)	AdGroupBuilder	ตั้งค่าพารามิเตอร์แบบกําหนดเองของกลุ่มโฆษณา
withEndDate(string endDate)	AdGroupBuilder	ตั้งวันที่โฆษณาในกลุ่มโฆษณาหยุดแสดง
withEndDate(Object endDate)	AdGroupBuilder	ตั้งวันที่โฆษณาในกลุ่มโฆษณาหยุดแสดง
withLanguage(ภาษาของสตริง)	AdGroupBuilder	ตั้งค่าภาษาที่ใช้โดยกลุ่มโฆษณานี้
withName(ชื่อสตริง)	AdGroupBuilder	ตั้งชื่อกลุ่มโฆษณา
withStartDate(สตริง startDate)	AdGroupBuilder	ตั้งวันที่โฆษณาในกลุ่มโฆษณาเริ่มแสดงโฆษณา
withStartDate(Object startDate)	AdGroupBuilder	ตั้งวันที่โฆษณาในกลุ่มโฆษณาเริ่มแสดงโฆษณา
withStatus(สถานะสตริง)	AdGroupBuilder	ตั้งค่าสถานะของกลุ่มโฆษณา
withTrackingTemplate(string trackingTemplate)	AdGroupBuilder	ตั้งค่าเทมเพลตการติดตามของกลุ่มโฆษณา

สร้าง

สร้างกลุ่มโฆษณาและแสดงออบเจ็กต์การดําเนินการที่ใช้ในการตรวจสอบว่ามีการเพิ่มกลุ่มโฆษณาสําเร็จหรือไม่

กลับ

ชนิด	คำอธิบาย
AdGroupOperation	วัตถุการดําเนินการที่ใช้เพื่อตรวจสอบว่ามีการเพิ่มกลุ่มโฆษณาสําเร็จแล้วหรือไม่

withBiddingStrategy (สตริง biddingStrategy)

ตั้งค่ากลยุทธ์การเสนอราคาของกลุ่มโฆษณา

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
biddingStrategy	สาย อักขระ	กลยุทธ์การเสนอราคาเพื่อนําไปใช้กับกลุ่มโฆษณา ต่อไปนี้คือค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ MANUAL_CPC MANUAL_CPM MANUAL_CPV สําหรับข้อมูลเกี่ยวกับกลยุทธ์เหล่านี้ ดูประเภทกลยุทธ์การเสนอราคา

กลับ

ชนิด	คำอธิบาย
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'}โดยที่คีย์คือชื่อและค่าของพารามิเตอร์แบบกําหนดเองคือค่าของพารามิเตอร์ ชื่อสามารถมีอักขระได้สูงสุด 16 อักขระ 8 ไบต์ และค่าสามารถมีอักขระได้สูงสุด 200 8 ไบต์

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่มีการใช้พารามิเตอร์แบบกําหนดเอง

withEndDate(string endDate)

ตั้งวันที่โฆษณาในกลุ่มโฆษณาหยุดแสดง เรียกใช้วิธีนี้เฉพาะเมื่อคุณต้องการให้โฆษณาในกลุ่มหยุดการแสดงโฆษณาในวันที่ระบุ

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
endDate	สาย อักขระ	วันที่หยุดการแสดงโฆษณา ระบุวันที่ในแบบฟอร์ม YYYYMMDD

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่มีการใช้วันที่สิ้นสุด

withEndDate(Object endDate)

ตั้งวันที่โฆษณาในกลุ่มโฆษณาหยุดแสดง เรียกใช้วิธีนี้เฉพาะเมื่อคุณต้องการให้โฆษณาในกลุ่มหยุดการแสดงโฆษณาในวันที่ระบุ

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
endDate	วัตถุ	วันที่หยุดการแสดงโฆษณา ระบุวันที่โดยใช้วัตถุที่มีเขตข้อมูลต่อไปนี้: ปี เดือน วัน ตัวอย่างเช่น: var date = {year: 2018, month: 5, day: 13}; เดือนจะเป็นแบบหนึ่งโดยที่ 1 คือมกราคมและ 12 คือธันวาคม

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่มีการใช้วันที่สิ้นสุด

withLanguage(ภาษาของสตริง)

ตั้งค่าภาษาที่ใช้โดยโฆษณาในกลุ่มโฆษณานี้

ตามค่าเริ่มต้น กลุ่มโฆษณาจะสืบทอดภาษาจากแคมเปญหลัก ระบุภาษาที่ระดับกลุ่มโฆษณาเพื่อแทนที่ภาษาที่ระบุในระดับแคมเปญ หรือหากแคมเปญไม่ได้ระบุภาษา (ต้องระบุภาษาที่ระดับแคมเปญและ/หรือระดับกลุ่มโฆษณา)

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
ภาษา	สาย อักขระ	ภาษาที่ใช้โดยโฆษณาในกลุ่มโฆษณา ตัวอย่างเช่น ภาษาอังกฤษ สตริงไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก อย่าใช้รหัสภาษาแบบสองอักขระ สําหรับรายการภาษาที่รองรับ โปรดดู ภาษาของโฆษณา

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่ใช้ภาษา

withName(ชื่อสตริง)

ตั้งชื่อกลุ่มโฆษณา

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
ชื่อ	สาย อักขระ	ชื่อของกลุ่มโฆษณา คุณต้องใส่ชื่อ ชื่อต้องมีอักขระไม่เกิน 256 ตัว และต้องไม่ซ้ํากันในกลุ่มโฆษณาที่ใช้งานอยู่ทั้งหมดในแคมเปญ

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่ใช้ชื่อ

withStartDate(สตริง startDate)

ตั้งวันที่โฆษณาในกลุ่มโฆษณาเริ่มแสดงโฆษณา เรียกใช้วิธีนี้เฉพาะเมื่อคุณต้องการให้โฆษณาในกลุ่มเริ่มการแสดงโฆษณาในวันที่ระบุ มิฉะนั้น โฆษณาจะเริ่มแสดงทันที

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
endDate	สาย อักขระ	วันที่เริ่มแสดงโฆษณา ระบุวันที่ในแบบฟอร์ม YYYYMMDD

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่ใช้วันที่เริ่มต้น

withStartDate(Object startDate)

ตั้งวันที่โฆษณาในกลุ่มโฆษณาเริ่มแสดงโฆษณา เรียกใช้วิธีนี้เฉพาะเมื่อคุณต้องการให้โฆษณาในกลุ่มเริ่มการแสดงโฆษณาในวันที่ระบุ มิฉะนั้น โฆษณาจะเริ่มแสดงทันที

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
endDate	วัตถุ	วันที่เริ่มแสดงโฆษณา ระบุวันที่โดยใช้วัตถุที่มีเขตข้อมูลต่อไปนี้: ปี เดือน วัน ตัวอย่างเช่น: var date = {year: 2018, month: 5, day: 13}; เดือนจะเป็นแบบหนึ่งโดยที่ 1 คือมกราคมและ 12 คือธันวาคม

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่ใช้วันที่เริ่มต้น

withStatus(สถานะสตริง)

ตั้งค่าสถานะของกลุ่มโฆษณา

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
สถานะ	สตริง	สถานะของกลุ่มโฆษณา ต่อไปนี้คือค่าที่ตรงตามตัวพิมพ์ใหญ่-เล็กที่เป็นไปได้ เปิด หยุด ชั่ว คราว ถูก เอา ออก ค่าเริ่มต้นถูกหยุดชั่วคราว

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่มีสถานะนําไปใช้

withTrackingTemplate(string trackingTemplate)

ตั้งค่าเทมเพลตการติดตามของกลุ่มโฆษณา

เทมเพลตการติดตามจะใช้กับ FinalUrl ของคําหลักเพื่อสร้าง URL ปลายทางที่โฆษณาใช้ สําหรับข้อมูลเพิ่มเติม โปรดดู ที่ ฉันสามารถใช้พารามิเตอร์การติดตามหรือ URL ใดได้บ้าง

อาร์กิวเมนต์

ชื่อ	ชนิด	คำอธิบาย
trackingTemplate	สาย อักขระ	เทมเพลตการติดตามที่จะใช้กับกลุ่มโฆษณา

กลับ

ชนิด	คำอธิบาย
AdGroupBuilder	ตัวสร้างกลุ่มโฆษณาที่ใช้เทมเพลตการติดตาม

ดูเพิ่มเติม

Campaign.newAdGroupBuilder()