ExpandedTextAdBuilder

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

หมายเหตุ

• อัปเกรดโฆษณาข้อความที่ขยายเป็นโฆษณาการค้นหาที่ตอบสนองภายในวันที่ 1 กุมภาพันธ์ 2023 หลังจากวันที่นี้ คุณจะไม่สามารถสร้างโฆษณาแบบข้อความที่ขยายใหม่หรือแก้ไขโฆษณาแบบข้อความที่ขยายที่มีอยู่ได้อีกต่อไป หากต้องการข้อมูลเพิ่มเติม โปรดดูเกี่ยวกับโฆษณาการค้นหาที่ตอบสนอง
• โฆษณาแบบข้อความที่ขยายที่มีอยู่จะยังคงให้บริการต่อไป และคุณจะสามารถดูรายงานประสิทธิภาพการทํางานของโฆษณาได้
• คุณจะยังคงสามารถหยุดชั่วคราว เปิดใช้งาน หรือลบโฆษณาแบบข้อความที่ขยายออกได้ มิฉะนั้น ความพยายามที่จะเพิ่มหรืออัปเดตโฆษณาแบบข้อความที่ขยายจะส่งผลให้เกิด CampaignServiceAdTypeInvalid ข้อผิดพลาด
• เรียนรู้เพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้

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

    var operation = adGroup.newAd().expandedTextAdBuilder()
        .withHeadlinePart1('FIRST PART OF TITLE GOES HERE')
        .withHeadlinePart2('SECOND PART OF TITLE GOES HERE')
        .withDescription('AD TEXT GOES HERE')
        .withFinalUrl('LANDING PAGE URL GOES HERE')
        .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`);
        }
    }

วิธีการ

ชื่อวิธี	ชนิดการส่งคืน	คำอธิบาย
รุ่น	AdOperation	สร้างโฆษณาและส่งคืนวัตถุการดําเนินการที่ใช้ในการตรวจสอบว่าสคริปต์เพิ่มโฆษณาสําเร็จหรือไม่
withCustomParameters(Object, customParameters)	ExpandedTextAdBuilder	ตั้งค่าพารามิเตอร์แบบกําหนดเองของโฆษณา
withDescription(string description)	ExpandedTextAdBuilder	ตั้งค่าคําอธิบายแรกของโฆษณา วิธีนี้ไม่ได้รับการสนับสนุนแทน withDescription1(string description1)
withDescription1(string description1)	ExpandedTextAdBuilder	ตั้งค่าคําอธิบายแรกของโฆษณา วิธีนี้จะตั้งค่าเขตข้อมูลเดียวกับ withDescription(string description)
withDescription2(string description2)	ExpandedTextAdBuilder	ตั้งค่าคําอธิบายที่สองของโฆษณา
withFinalUrl(สตริง finalUrl)	ExpandedTextAdBuilder	ตั้งค่า URL หน้าเริ่มต้นของโฆษณา
withHeadlinePart1(string headlinePart1)	ExpandedTextAdBuilder	ตั้งค่าส่วนแรกของชื่อโฆษณา
withHeadlinePart2(string headlinePart2)	ExpandedTextAdBuilder	ตั้งค่าส่วนที่สองของชื่อโฆษณา
withHeadlinePart3(string headlinePart3)	ExpandedTextAdBuilder	ตั้งค่าส่วนที่สามของชื่อโฆษณา
withMobileFinalUrl(สตริง mobileFinalUrl)	ExpandedTextAdBuilder	ตั้งค่า URL สุดท้ายของโฆษณาสําหรับอุปกรณ์เคลื่อนที่
withPath1(สตริง urlPath1)	ExpandedTextAdBuilder	ตั้งค่าเส้นทางทางเลือกแรกเพื่อผนวกเข้ากับ URL ที่แสดงของโฆษณา
withPath2(สตริง urlPath2)	ExpandedTextAdBuilder	ตั้งค่าเส้นทางทางเลือกที่สองเพื่อผนวกไปยัง URL ที่แสดงของโฆษณา
withTrackingTemplate(string trackingTemplate)	ExpandedTextAdBuilder	ตั้งค่าเทมเพลตการติดตามของโฆษณา

รุ่น

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

สําหรับขีดจํากัดจํานวนโฆษณาที่คุณสามารถเพิ่มลงในกลุ่มโฆษณาได้ ให้ดูขีดจํากัดลําดับชั้นของเอนทิตี

ส่งกลับ

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

withCustomParameters(Object, customParameters)

ตั้งค่าพารามิเตอร์แบบกําหนดเองของโฆษณา

พารามิเตอร์แบบกําหนดเองมีประโยชน์ในการแชร์ข้อมูลแบบไดนามิกระหว่าง URL หลายรายการ สําหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้งาน ให้ดู พารามิเตอร์แบบกําหนดเอง

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

ชื่อ	พิมพ์	คำอธิบาย
customParameters	วัตถุ	แผนที่ของพารามิเตอร์ที่กําหนดเองเพื่อนําไปใช้กับ URL สุดท้ายของโฆษณา ตัวอย่างเช่น {key1: 'value1', key2: 'value2', key3: 'value3'}เมื่อ key คือชื่อของพารามิเตอร์แบบกําหนดเอง และ value คือค่าของพารามิเตอร์ ชื่ออาจมีอักขระ 8 ไบต์สูงสุด 16 ตัว และค่าอาจมีอักขระ 8 ไบต์สูงสุด 200 ตัว

ส่งกลับ

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

withDescription(string description)

ตั้งค่าคําอธิบายแรกของโฆษณา วิธีนี้ไม่ได้รับการสนับสนุนแทน withDescription1(string description1)

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

ชื่อ	พิมพ์	คำอธิบาย
คําอธิบาย	สตริง	คําอธิบายแรกของโฆษณา สําหรับข้อมูลเกี่ยวกับขีดจํากัดการคัดลอกและรวมถึงสตริงข้อความแบบไดนามิก ให้ดู Bing Ads API

ส่งกลับ

พิมพ์	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่ใช้คําอธิบาย

withDescription1(string description1)

ตั้งค่าคําอธิบายแรกของโฆษณา วิธีนี้จะตั้งค่าเขตข้อมูลเดียวกับ withDescription(string description)

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

ชื่อ	พิมพ์	คำอธิบาย
รายละเอียด 1	สตริง	คําอธิบายแรกของโฆษณา สําหรับข้อมูลเกี่ยวกับขีดจํากัดการคัดลอกและรวมถึงสตริงข้อความแบบไดนามิก ให้ดู Bing Ads API

ส่งกลับ

พิมพ์	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่ใช้คําอธิบาย

withDescription2(string description2)

ตั้งค่าคําอธิบายที่สองของโฆษณา

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

ชื่อ	พิมพ์	คำอธิบาย
รายละเอียด 2	สตริง	คําอธิบายที่สองของโฆษณา สําหรับข้อมูลเกี่ยวกับขีดจํากัดการคัดลอกและรวมถึงสตริงข้อความแบบไดนามิก ให้ดู Bing Ads API

ส่งกลับ

พิมพ์	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่ใช้คําอธิบาย

withFinalUrl(สตริง finalUrl)

ตั้งค่า URL หน้าเริ่มต้นของโฆษณา

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

ชื่อ	พิมพ์	คำอธิบาย
URL สุดท้าย	สตริง	URL หน้าเริ่มต้นของโฆษณา สําหรับข้อมูลเกี่ยวกับขีดจํากัด URL โปรดดู Bing Ads API

ส่งกลับ

พิมพ์	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่ใช้ URL สุดท้าย

withHeadlinePart1(string headlinePart1)

ตั้งค่าส่วนแรกของชื่อโฆษณา

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

ชื่อ	พิมพ์	คำอธิบาย
พาดหัวส่วนที่ 1	สตริง	ส่วนแรกของชื่อโฆษณา เมื่อ Microsoft สร้างชื่อโฆษณาโดยใช้ส่วน 1, 2 และ 3 ของชื่อโฆษณา จะเชื่อมต่อส่วนต่างๆ เข้าด้วยกันโดยใช้ " - " อย่าระบุเส้นประในส่วนชื่อเรื่องใดๆ แต่ละส่วนของชื่อเรื่องต้องมีอย่างน้อยหนึ่งคํา สําหรับข้อมูลเกี่ยวกับขีดจํากัดชื่อเรื่องเพิ่มเติมและการรวมสตริงข้อความแบบไดนามิกในชื่อเรื่อง ให้ดู Bing Ads API

ส่งกลับ

พิมพ์	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่นําส่วน 1 ของชื่อโฆษณาไปใช้

withHeadlinePart2(string headlinePart2)

ตั้งค่าส่วนที่สองของชื่อโฆษณา

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

ชื่อ	พิมพ์	คำอธิบาย
พาดหัวส่วนที่ 2	สตริง	ส่วนที่สองของชื่อโฆษณา เมื่อ Microsoft สร้างชื่อโฆษณาโดยใช้ส่วน 1, 2 และ 3 ของชื่อโฆษณา จะเชื่อมต่อส่วนต่างๆ เข้าด้วยกันโดยใช้ " - " อย่าระบุเส้นประในส่วนชื่อเรื่องใดๆ แต่ละส่วนของชื่อเรื่องต้องมีอย่างน้อยหนึ่งคํา สําหรับข้อมูลเกี่ยวกับขีดจํากัดชื่อเรื่องเพิ่มเติมและการรวมสตริงข้อความแบบไดนามิกในชื่อเรื่อง ให้ดู Bing Ads API

ส่งกลับ

พิมพ์	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่นําส่วน 1 ของชื่อโฆษณาไปใช้

withHeadlinePart3(string headlinePart3)

ตั้งค่าส่วนที่สามของชื่อโฆษณา

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

ชื่อ	พิมพ์	คำอธิบาย
พาดหัวส่วนที่ 3	สตริง	ส่วนที่สามของชื่อโฆษณา เมื่อ Microsoft สร้างชื่อโฆษณาโดยใช้ส่วน 1, 2 และ 3 ของชื่อโฆษณา จะเชื่อมต่อส่วนต่างๆ เข้าด้วยกันโดยใช้ " - " อย่าระบุเส้นประในส่วนชื่อเรื่องใดๆ แต่ละส่วนของชื่อเรื่องต้องมีอย่างน้อยหนึ่งคํา สําหรับข้อมูลเกี่ยวกับขีดจํากัดชื่อเรื่องเพิ่มเติมและการรวมสตริงข้อความแบบไดนามิกในชื่อเรื่อง ให้ดู Bing Ads API

ส่งกลับ

พิมพ์	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่นําส่วน 1 ของชื่อโฆษณาไปใช้

withMobileFinalUrl(สตริง mobileFinalUrl)

ตั้งค่า URL สุดท้ายของโฆษณาสําหรับอุปกรณ์เคลื่อนที่

URL สุดท้ายจะระบุเว็บเพจที่ผู้ใช้ถูกนําไปเมื่อคลิกโฆษณา เมื่อต้องการระบุ URL สุดท้ายสําหรับอุปกรณ์มือถือ ให้ระบุ URL สุดท้ายสําหรับอุปกรณ์ที่ไม่ใช่อุปกรณ์เคลื่อนที่ก่อน (ให้ดู)withFinalUrl()

สําหรับข้อมูลเพิ่มเติม ให้ดู ฉันสามารถใช้พารามิเตอร์การติดตามหรือ URL ใดได้บ้าง

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

ชื่อ	พิมพ์	คำอธิบาย
mobileFinalUrl	สตริง	URL สุดท้ายสําหรับอุปกรณ์เคลื่อนที่

ส่งกลับ

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

withPath1(สตริง urlPath1)

ตั้งค่าเส้นทางทางเลือกแรกเพื่อผนวกเข้ากับ URL ที่แสดงของโฆษณา

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

ชื่อ	พิมพ์	คำอธิบาย
mobileFinalUrl	สตริง	เส้นทางทางเลือกแรกที่จะผนวกกับ URL ที่แสดงของโฆษณา Microsoft ใช้โดเมนที่ระบุเป็น withFinalUrl URL ที่แสดง หากโดเมนของ URL สุดท้ายเป็น contoso.com และเส้นทางคือ Shoes URL ที่แสดงของโฆษณาจะเป็น contoso.com/shoes สําหรับการใช้งานและขีดจํากัด โปรดดู Path1

ส่งกลับ

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

withPath2(สตริง urlPath2)

ตั้งค่าเส้นทางทางเลือกที่สองเพื่อผนวกไปยัง URL ที่แสดงของโฆษณา

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

ชื่อ	พิมพ์	คำอธิบาย
mobileFinalUrl	สตริง	เส้นทางเพิ่มเติมที่สองเพื่อผนวกกับ URL ที่แสดงของโฆษณา เมื่อต้องการระบุเส้นทางที่สอง ให้ระบุเส้นทางแรกก่อน (ดู)withPath1 Microsoft ใช้โดเมนที่ระบุเป็น withFinalUrl URL ที่แสดง หากโดเมนของ URL สุดท้ายคือ contoso.com เส้นทางแรกคือรองเท้า และเส้นทางที่สองคือผู้หญิง URL ที่แสดงของโฆษณาจะถูก contoso.com/shoes/ladies สําหรับการใช้งานและขีดจํากัด ให้ดู Path2

ส่งกลับ

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

withTrackingTemplate(string trackingTemplate)

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

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

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

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

ส่งกลับ

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