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(คําอธิบายสตริง)	ExpandedTextAdBuilder	ตั้งค่าคําอธิบายแรกของโฆษณา วิธีนี้ไม่ได้รับการสนับสนุนจาก withDescription1(string description1)
withDescription1(string description1)	ExpandedTextAdBuilder	ตั้งค่าคําอธิบายแรกของโฆษณา เมธอดนี้ตั้งค่าเขตข้อมูลเดียวกันกับ withDescription(คําอธิบายสตริง)
withDescription2(string description2)	ExpandedTextAdBuilder	ตั้งค่าคําอธิบายที่สองของโฆษณา
withFinalUrl(string finalUrl)	ExpandedTextAdBuilder	ตั้งค่า URL ของหน้า Landing Page ของโฆษณา
withHeadlinePart1(พาดหัวสตริง Part1)	ExpandedTextAdBuilder	ตั้งค่าส่วนแรกของชื่อโฆษณา
withHeadlinePart2(พาดหัวสตริง Part2)	ExpandedTextAdBuilder	ตั้งค่าส่วนที่สองของชื่อโฆษณา
withHeadlinePart3(พาดหัวสตริง Part3)	ExpandedTextAdBuilder	ตั้งค่าส่วนที่สามของชื่อโฆษณา
withMobileFinalUrl(string mobileFinalUrl)	ExpandedTextAdBuilder	ตั้งค่า URL สุดท้ายของโฆษณาสําหรับอุปกรณ์เคลื่อนที่
withPath1(string urlPath1)	ExpandedTextAdBuilder	ตั้งค่าเส้นทางที่เลือกได้เส้นทางแรกเพื่อผนวกเข้ากับ URL ที่แสดงของโฆษณา
withPath2(string urlPath2)	ExpandedTextAdBuilder	ตั้งค่าเส้นทางที่เลือกได้เส้นทางที่สองเพื่อผนวกเข้ากับ URL ที่แสดงของโฆษณา
withTrackingTemplate(string trackingTemplate)	ExpandedTextAdBuilder	ตั้งค่าเทมเพลตการติดตามของโฆษณา

สร้าง

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

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

กลับ

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

withCustomParameters(Object customParameters)

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

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

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

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

กลับ

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

withDescription(คําอธิบายสตริง)

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

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

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

กลับ

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

withDescription1(string description1)

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

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

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

กลับ

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

withDescription2(string description2)

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

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

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

กลับ

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

withFinalUrl(string finalUrl)

ตั้งค่า URL ของหน้า Landing Page ของโฆษณา

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

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

กลับ

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

withHeadlinePart1(พาดหัวสตริง Part1)

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

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

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

กลับ

ชนิด	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่ใช้ชื่อโฆษณาส่วนที่ 1

withHeadlinePart2(พาดหัวสตริง Part2)

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

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

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

กลับ

ชนิด	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่ใช้ชื่อโฆษณาส่วนที่ 1

withHeadlinePart3(พาดหัวสตริง Part3)

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

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

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

กลับ

ชนิด	คำอธิบาย
ExpandedTextAdBuilder	ตัวสร้างโฆษณาที่ใช้ชื่อโฆษณาส่วนที่ 1

withMobileFinalUrl(string mobileFinalUrl)

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

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

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

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

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

กลับ

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

withPath1(string urlPath1)

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

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

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

กลับ

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

withPath2(string 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	ตัวสร้างโฆษณาที่มีการใช้เทมเพลตการติดตาม