แชร์ผ่าน

ตรวจทานระเบียนส่วนขยายโฆษณา - จํานวนมาก

  • บทความ

กําหนดส่วนขยายโฆษณาสําหรับการตรวจสอบที่สามารถดาวน์โหลดและอัปโหลดในไฟล์จํานวนมากได้

คุณสามารถเชื่อมโยงส่วนขยายโฆษณาสําหรับตรวจสอบกับบัญชีหรือกับแคมเปญและกลุ่มโฆษณาในบัญชีได้ แต่ละเอนทิตี (บัญชี แคมเปญ หรือกลุ่มโฆษณา) สามารถเชื่อมโยงกับส่วนขยายโฆษณาได้สูงสุด 20 รายการ โฆษณาแบบข้อความที่ขยายแล้วจะประกอบด้วยการตรวจสอบต่อการแสดงผลหนึ่งครั้งเท่านั้น ใช้ ส่วนขยาย Ad Review Account, ส่วนขยาย Ad Review Group และเรคคอร์ด ส่วนขยายการตรวจสอบแคมเปญ เพื่อจัดการความสัมพันธ์ส่วนขยายโฆษณาที่ตรวจสอบ

คุณสามารถดาวน์โหลดระเบียนตรวจสอบส่วนขยายโฆษณาทั้งหมดในบัญชีได้โดยการรวมค่า DownloadEntity ของ ReviewAdExtensions ในคําขอบริการ DownloadCampaignsByAccountIds หรือ DownloadCampaignsByCampaignIds นอกจากนี้ คําขอดาวน์โหลดต้องมีขอบเขต EntityData ด้วย สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับบริการแบบกลุ่ม รวมถึงแนวทางปฏิบัติที่ดีที่สุด ดูดาวน์โหลดและอัปโหลดเป็นกลุ่ม

ตัวอย่าง CSV จํานวนมากต่อไปนี้จะเพิ่มส่วนขยายการตรวจสอบโฆษณาใหม่ลงในไลบรารีที่แชร์ของบัญชี

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Start Date,End Date,Text,Device Preference,Name,Ad Schedule,Use Searcher Time Zone,Is Exact,Source,Url
Format Version,,,,,,,,,,,,6.0,,,,,
Review Ad Extension,Active,-16,0,,,ClientIdGoesHere,,,12/31/2020,Review Text,,,(Monday[09:00-21:00]),FALSE,TRUE,Review Source Name,http://review.contoso.com

ถ้าคุณกําลังใช้ Bing Ads SDKs สําหรับ .NET, Java หรือ Python คุณสามารถประหยัดเวลาโดยใช้ BulkServiceManager เพื่ออัปโหลดและดาวน์โหลดวัตถุ BulkReviewAdExtension แทนการเรียกการดําเนินการบริการโดยตรง และเขียนโค้ดแบบกําหนดเองเพื่อแยกวิเคราะห์แต่ละเขตข้อมูลในไฟล์จํานวนมาก

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkReviewAdExtension
var bulkReviewAdExtension = new BulkReviewAdExtension
{
    // 'Parent Id' column header in the Bulk file
    AccountId = 0,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
                
    // Map properties in the Bulk file to the 
    // ReviewAdExtension object of the Campaign Management service.
    ReviewAdExtension = new ReviewAdExtension
    {
        // 'Id' column header in the Bulk file
        Id = reviewAdExtensionIdKey,
        // 'Is Exact' column header in the Bulk file
        IsExact = true,
        // 'Source' column header in the Bulk file
        Source = "Review Source Name",
        // 'Text' column header in the Bulk file
        Text = "Review Text",
        // 'Url' column header in the Bulk file
        Url = "http://review.contoso.com", 
                    
        // 'Ad Schedule' column header in the Bulk file
        Scheduling = new Schedule
        {
            // Each day and time range is delimited by a semicolon (;) in the Bulk file
            DayTimeRanges = new[]
            {
                // Within each day and time range the format is Day[StartHour:StartMinue-EndHour:EndMinute].
                new DayTime
                {
                    Day = Day.Monday,
                    StartHour = 9,
                    StartMinute = Minute.Zero,
                    EndHour = 21,
                    EndMinute = Minute.Zero,
                },
            },
            // 'End Date' column header in the Bulk file
            EndDate = new Microsoft.BingAds.V13.CampaignManagement.Date
            {
                Month = 12,
                Day = 31,
                Year = DateTime.UtcNow.Year + 1
            },
            // 'Start Date' column header in the Bulk file
            StartDate = null,
            // 'Use Searcher Time Zone' column header in the Bulk file
            UseSearcherTimeZone = false,
        },

        // 'Status' column header in the Bulk file
        Status = AdExtensionStatus.Active,
    },
};

uploadEntities.Add(bulkReviewAdExtension);

var entityUploadParameters = new EntityUploadParameters
{
    Entities = uploadEntities,
    ResponseMode = ResponseMode.ErrorsAndResults,
    ResultFileDirectory = FileDirectory,
    ResultFileName = DownloadFileName,
    OverwriteResultFile = true,
};

var uploadResultEntities = (await BulkServiceManager.UploadEntitiesAsync(entityUploadParameters)).ToList();

สําหรับระเบียนตรวจสอบส่วนขยายโฆษณา เขตข้อมูลแอตทริบิวต์ต่อไปนี้จะพร้อมใช้งานใน Schema ไฟล์จํานวนมาก

กําหนดการโฆษณา

รายการช่วงวันและเวลาที่คุณต้องการให้แสดงส่วนขยายโฆษณาด้วยโฆษณา แต่ละวันและช่วงเวลาประกอบด้วยวันในสัปดาห์ ที่กําหนดไว้ ชั่วโมงเริ่มต้น/สิ้นสุด และนาทีเริ่มต้น/สิ้นสุด แต่ละวันและช่วงเวลาจะอยู่ในวงเล็บซ้ายและขวา และคั่นจากวันและช่วงเวลาอื่นๆ ด้วยเครื่องหมายอัฒภาค (ตัวคั่น;) ภายในแต่ละวันและช่วงเวลารูปแบบคือ Day[StartHour:StartMinue-EndHour:EndMinute]

ค่าที่เป็นไปได้ของ StartHour อยู่ในช่วงตั้งแต่ 00 ถึง 23 โดย 00 มีค่าเท่ากับ 12:00 น. และ 12 คือ 12:00 น.

ค่าที่เป็นไปได้ของ EndHour อยู่ในช่วงตั้งแต่ 00 ถึง 24 โดย 00 มีค่าเท่ากับ 12:00 น. และ 12 คือ 12:00 น.

ค่าที่เป็นไปได้ของ StartMinute และ EndMinute อยู่ในช่วงตั้งแต่ 00 ถึง 60

ตัวอย่างต่อไปนี้แสดงวันและช่วงเวลาระหว่างวันธรรมดาตั้งแต่เวลา 9:00 น. ถึง 21:00 น.: (วันจันทร์[09:00-21:00]);( วันอังคาร[09:00-21:00]); (วันพุธ[09:00-21:00]); (วันพฤหัสบดี[09:00-21:00]); (วันศุกร์[09:00-21:00])

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

ID ไคลเอ็นต์

ใช้เพื่อเชื่อมโยงระเบียนในไฟล์อัปโหลดจํานวนมากกับระเบียนในไฟล์ผลลัพธ์ ค่าของเขตข้อมูลนี้ไม่ได้ถูกใช้หรือเก็บโดยเซิร์ฟเวอร์ ให้ตั้งค่าเขตข้อมูลนี้ก่อนแล้วจึงเปิดใช้งานเขตข้อมูลนี้ เพียงแค่คัดลอกจากระเบียนที่อัปโหลดไปยังระเบียนผลลัพธ์ที่สอดคล้องกัน ซึ่งอาจเป็นสตริงที่ถูกต้องที่มีความยาวสูงสุด 100

เพิ่ม: เสริม
ปรับ ปรุง: เสริม
ลบ: อ่านอย่างเดียว

ตําแหน่งที่ตั้งของบรรณาธิการ

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

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

รหัสเหตุผลของบรรณาธิการ

รหัสที่ระบุเหตุผลสําหรับความล้มเหลว สําหรับรายการรหัสเหตุผลที่เป็นไปได้ ให้ดู รหัสเหตุผลของบรรณาธิการ

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

สถานะบรรณาธิการ

สถานะบรรณาธิการของส่วนขยายโฆษณา

มีการอธิบายค่าที่เป็นไปได้ในตารางด้านล่าง

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

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

คําบรรณาธิการ

คําที่ไม่สามารถตรวจทานโดยบรรณาธิการได้

ฟิลด์นี้จะไม่ถูกตั้งค่าถ้าชุดของเงื่อนไขทําให้เกิดความล้มเหลว หรือถ้าความล้มเหลวขึ้นอยู่กับการละเมิดนโยบาย

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

วันที่สิ้นสุด

สตริงวันที่สิ้นสุดตามกําหนดเวลาของส่วนขยายโฆษณาที่จัดรูปแบบเป็น MM/DD/YYYY

วันที่สิ้นสุดรวมอยู่ด้วย ตัวอย่างเช่น ถ้าคุณตั้งค่าเขตข้อมูลนี้เป็น 12/31/2020 ส่วนขยายโฆษณาจะหยุดแสดงในเวลา 23:59 น. ในวันที่ 31/12/2020

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

Id

ตัวระบุที่ระบบสร้างขึ้นของส่วนขยายโฆษณา

เพิ่ม: เสริม คุณต้องปล่อยฟิลด์นี้ว่างไว้ หรือระบุตัวระบุค่าลบ จากนั้น คุณสามารถอ้างอิงชุดตัวระบุเชิงลบสําหรับส่วนขยายโฆษณาในเขตข้อมูล ID ของประเภทระเบียนที่ขึ้นต่อกัน ได้ เช่น ส่วนขยาย Ad Review Ad Group และส่วนขยายโฆษณารีวิวแคมเปญ ขอแนะนําให้คุณเพิ่มส่วนขยายโฆษณาใหม่และระเบียนที่ขึ้นต่อกันใหม่ในไฟล์ Bulk เดียวกัน สําหรับข้อมูลเพิ่มเติม ดูคีย์การอ้างอิง Schema ของไฟล์จํานวนมาก
ปรับ ปรุง: อ่านอย่างเดียวและจําเป็น
ลบ: อ่านอย่างเดียวและจําเป็น

เป็นค่าที่แน่นอน

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

เพิ่ม: เสริม
ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัพเดต การตั้งค่าก่อนหน้าจะถูกลบออก
ลบ: อ่านอย่างเดียว

เวลาที่ปรับเปลี่ยน

วันที่และเวลาที่มีการอัปเดตเอนทิตีครั้งล่าสุด ค่าอยู่ในเวลามาตรฐานสากล (UTC)

หมายเหตุ

ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

ID แม่

ตัวระบุที่ระบบสร้างขึ้นของบัญชีที่มีส่วนขยายโฆษณา

เขตข้อมูลจํานวนมากนี้จะแมปไปยังเขตข้อมูล Id ของระเบียนบัญชี

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

ประเทศของผู้เผยแพร่

รายการของประเทศหรือภูมิภาคของผู้เผยแพร่ที่มีแนวทางบรรณาธิการไม่อนุญาตให้มี คําที่ระบุ

ในไฟล์จํานวนมาก รายการประเทศหรือภูมิภาคของผู้เผยแพร่จะถูกคั่นด้วยเครื่องหมายอัฒภาค (;))

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว

แหล่ง

ชื่อแหล่งที่มาของการรีวิว

ความยาวรวมของสตริง ต้นทาง และ ข้อความ ต้องไม่เกิน 67 อักขระ

เพิ่ม: ต้องระบุ
ปรับ ปรุง: ต้องระบุ
ลบ: อ่านอย่างเดียว

วันที่เริ่มต้น

สตริงวันที่เริ่มต้นตามกําหนดการของส่วนขยายโฆษณาที่จัดรูปแบบเป็น MM/DD/YYYY

วันที่เริ่มต้นรวมอยู่ด้วย ตัวอย่างเช่น หากคุณตั้งค่า StartDate เป็น 5/5/2020 ส่วนขยายโฆษณาจะเริ่มแสดงในเวลา 12:00 น. ในวันที่ 5/5/2020

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

สถานะ

สถานะของส่วนขยายโฆษณา

ค่าที่เป็นไปได้คือ ใช้งานอยู่ หรือ ถูกลบ

เพิ่ม: เสริม ค่าเริ่มต้นคือ ใช้งานอยู่
ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง
ลบ: ต้องระบุ ต้องตั้งค่า สถานะ เป็น ลบ

ข้อความ

ข้อความที่เป็นวลีย่อหน้าหรือคําอ้างอิงที่แน่นอนจากแหล่งการรีวิว

ความยาวรวมของสตริง ต้นทาง และ ข้อความ ต้องไม่เกิน 67 อักขระ

หมายเหตุ

อย่าล้อมรอบข้อความด้วยเครื่องหมายอัญระบุ หากเขตข้อมูล Is Exact ถูกตั้งค่าเป็น TRUE ข้อความรีวิวจะถูกล้อมรอบโดยอัตโนมัติด้วยเครื่องหมายอัญประกาศเมื่อแสดงพร้อมกับโฆษณา

เพิ่ม: ต้องระบุ
ปรับ ปรุง: ต้องระบุ
ลบ: อ่านอย่างเดียว

Url

URL แหล่งที่มาของการรีวิว

URL ต้องเริ่มต้นด้วยคํานําหน้า http:// หรือ https://

ความยาวของสตริงนี้จํากัดไว้ที่ 2,048 อักขระ

เพิ่ม: ต้องระบุ
ปรับ ปรุง: ต้องระบุ
ลบ: อ่านอย่างเดียว

ใช้โซนเวลาของตัวค้นหา

พิจารณาว่าจะใช้โซนเวลาของบัญชีหรือโซนเวลาของผู้ใช้การค้นหาที่สามารถแสดงโฆษณาได้

ตั้งค่าคุณสมบัตินี้เป็น TRUE ถ้าคุณต้องการให้ส่วนขยายโฆษณาแสดงในโซนเวลาของผู้ใช้การค้นหา และตั้งค่าเป็น FALSE

เพิ่ม: เสริม ถ้าคุณไม่ได้ระบุฟิลด์นี้หรือปล่อยว่างไว้ ค่าเริ่มต้นของ FALSE จะถูกตั้งค่าและจะใช้โซนเวลาของบัญชี
ปรับ ปรุง: เสริม ถ้าคุณตั้งค่าเขตข้อมูลนี้เป็นสตริง delete_value คุณจะรีเซ็ตเป็นค่าเริ่มต้นของ FALSE ได้อย่างมีประสิทธิภาพ เขตข้อมูล กําหนดการโฆษณาวันที่สิ้นสุดวันที่เริ่มต้น และใช้ เขตเวลาของเครื่องมือค้นหา ขึ้นอยู่กับแต่ละส่วนและอัปเดตพร้อมกัน หากคุณปล่อยให้เขตข้อมูลเหล่านี้ทั้งหมดว่างเปล่าในระหว่างการอัปเดต จะไม่มีการอัปเดตใดๆ ถ้าคุณรวมค่าสําหรับเขตข้อมูลเหล่านี้ ค่าก่อนหน้าสําหรับเขตข้อมูลเหล่านี้ทั้งหมดจะถูกลบหรือแทนที่ หากต้องการลบการตั้งค่ากําหนดการก่อนหน้าทั้งหมด ให้ตั้งค่าแต่ละเขตข้อมูลเหล่านี้เป็น delete_value
ลบ: อ่านอย่างเดียว

เวอร์ชัน

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

เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว