ระเบียนโฆษณาผลิตภัณฑ์ - จํานวนมาก

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

โฆษณาผลิตภัณฑ์ไม่สามารถใช้สําหรับสําเนาโฆษณาที่ส่งมาโดยตรงได้ แต่เครื่องมือจัดส่งจะสร้างโฆษณาผลิตภัณฑ์จากรายละเอียดผลิตภัณฑ์ที่พบในแค็ตตาล็อกร้านค้า Microsoft Merchant Center ของลูกค้า

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

ตัวอย่าง CSV จํานวนมากต่อไปนี้จะเพิ่มโฆษณาผลิตภัณฑ์ใหม่หากมีการระบุค่า ID หลัก ที่ถูกต้อง

Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Title,Text,Display Url,Destination Url,Promotion,Device Preference,Ad Format Preference,Name,App Platform,App Id,Final Url,Mobile Final Url,Tracking Template,Custom Parameter,Title Part 1,Title Part 2,Path 1,Path 2
Format Version,,,,,,,,,,,,,,6.0,,,,,,,,,,
Product Ad,Active,,-1112,ParentCampaignNameGoesHere,AdGroupNameGoesHere,ClientIdGoesHere,,,,,,Find New Customers & Increase Sales!,,,,,,,,,,,,,

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkProductAd
var bulkProductAd = new BulkProductAd
{
    // 'Parent Id' column header in the Bulk file
    AdGroupId = adGroupIdKey,
    // 'Ad Group' column header in the Bulk file
    AdGroupName = "AdGroupNameGoesHere",
    // 'Campaign' column header in the Bulk file
    CampaignName = "ParentCampaignNameGoesHere",
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // ProductAd object of the Campaign Management service.
    ProductAd = new ProductAd
    {
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Promotion' column header in the Bulk file
        PromotionalText = "Find New Customers & Increase Sales!",
        // 'Status' column header in the Bulk file
        Status = AdStatus.Active,
    },
};

uploadEntities.Add(bulkProductAd);

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

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

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

• กลุ่มโฆษณา
• แคมเปญ
• ID ไคลเอ็นต์
• สถานะการอุทธรณ์ของบรรณาธิ
• ตําแหน่งที่ตั้งของบรรณาธิการ
• รหัสเหตุผลของบรรณาธิการ
• สถานะบรรณาธิการ
• คําบรรณาธิการ
• ID
• เวลาที่ปรับเปลี่ยน
• ID แม่
• ประเทศของผู้เผยแพร่
• สถานะ

กลุ่มโฆษณา

ชื่อของกลุ่มโฆษณาที่ประกอบด้วยโฆษณา

เพิ่ม: อ่านอย่างเดียวและจําเป็น
อัพเดต: อ่านอย่างเดียวและจําเป็น
ลบ: อ่านอย่างเดียวและจําเป็น

หมายเหตุ

สําหรับการเพิ่ม อัปเดต และลบ คุณต้องระบุเขตข้อมูล ID หลักหรือกลุ่มโฆษณา

แคมเปญ

ชื่อของแคมเปญที่ประกอบด้วยกลุ่มโฆษณาและโฆษณา

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

ID ไคลเอ็นต์

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

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

สถานะการอุทธรณ์ของบรรณาธิ

พิจารณาว่าคุณสามารถอุทธรณ์ปัญหาที่พบโดยบทวิจารณ์บรรณาธิการได้หรือไม่

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

ค่า	คำอธิบาย
อุทธรณ์ได้	ประเด็นบรรณาธิการน่าดึงดูด
การพิจารณาอุทธรณ์	ประเด็นบรรณาธิการนั้นน่าสนใจและยื่นอุทธรณ์แล้ว
NotAppealable	ประเด็นบรรณาธิการไม่น่าดึงดูด

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ID

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

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

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

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

หมายเหตุ

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

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

ID แม่

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

เขตข้อมูลจํานวนมากนี้จะแมปไปยังเขตข้อมูล Id ของระเบียนกลุ่มโฆษณา

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

หมายเหตุ

สําหรับการเพิ่ม อัปเดต และลบ คุณต้องระบุเขตข้อมูล ID หลักหรือกลุ่มโฆษณา

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

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

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

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

สถานะ

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

หมายเหตุ

ในวันที่ 3 ธันวาคม 2024 การดําเนินการลบจะไม่ได้รับการสนับสนุนใน Bulk API สําหรับบันทึกโฆษณาผลิตภัณฑ์อีกต่อไป ทั้งนี้เนื่องจากเอนทิตีโฆษณาผลิตภัณฑ์ถูกสร้างขึ้นโดยระบบ

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

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