ระเบียนผู้ชมแบบกําหนดเอง - กลุ่มขนาดใหญ่
กําหนดผู้ชมแบบกําหนดเองที่สามารถดาวน์โหลดและอัปโหลดในไฟล์จํานวนมากได้
หมายเหตุ
เฉพาะการอัปเดตของเขตข้อมูล Audience (ชื่อผู้ชม) และ คําอธิบาย เท่านั้นที่ได้รับการสนับสนุนสําหรับการอัปโหลด คุณสามารถลบแต่ไม่สามารถเพิ่มกลุ่มเป้าหมายแบบกําหนดเองโดยใช้ API โฆษณา Bing ได้ เมื่อกล่าวแล้วคุณสามารถเพิ่มและลบความสัมพันธ์และการยกเว้นผู้ชมที่กําหนดเองได้
กลุ่มเป้าหมายแบบกําหนดเองคือประเภทรายการรีมาร์เก็ตติ้งที่สร้างขึ้นโดยใช้ข้อมูลลูกค้าของคุณเองเพื่อสร้างเซกเมนต์ผู้ใช้ที่หลากหลายขึ้น คุณสามารถใช้ผู้ชมแบบกําหนดเองร่วมกับรายการรีมาร์เก็ตติ้งของคุณได้ ซึ่งโดยปกติแล้วจะผ่านผู้ให้บริการการจัดการข้อมูลของคุณ (DMP) เมื่อ DMP ของคุณเชื่อมต่อกับคุณลักษณะผู้ชมแบบกําหนดเองของเรา คุณสามารถนําเข้าผู้ชมแบบกําหนดเองของคุณลงใน Microsoft Advertising สําหรับรีมาร์เก็ตติ้งการค้นหา คุณสามารถใช้กลุ่มเป้าหมายแบบกําหนดเองแยกต่างหากจากรีมาร์เก็ตติ้งโดยไม่จําเป็นต้องใช้ UET
เคล็ดลับ
สําหรับภาพรวมและข้อมูลเพิ่มเติมเกี่ยวกับผู้ชม ดูคู่มือทางเทคนิคของ Audience API
คุณสามารถดาวน์โหลดระเบียนผู้ชมแบบกําหนดเองทั้งหมดในบัญชีได้โดยการรวมค่า DownloadEntity ของ CustomAudiences ในคําขอบริการ DownloadCampaignsByAccountIds หรือ DownloadCampaignsByCampaignIds นอกจากนี้ คําขอดาวน์โหลดต้องมีขอบเขต EntityData ด้วย สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับบริการแบบกลุ่ม รวมถึงแนวทางปฏิบัติที่ดีที่สุด ดูดาวน์โหลดและอัปโหลดเป็นกลุ่ม
ตัวอย่าง CSV จํานวนมากต่อไปนี้จะอัปเดตคําอธิบายของผู้ชมแบบกําหนดเอง หมายเหตุ: สําหรับผู้ชมแบบกําหนดเอง ระยะเวลาการเป็นสมาชิกไม่ได้ตั้งค่าในแอปพลิเคชันบนเว็บ Microsoft Advertising และ Microsoft Advertising จะเลื่อนไปยังการตั้งค่าผู้ให้บริการผู้ชมแบบกําหนดเองของคุณ
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;Audience
ถ้าคุณกําลังใช้ Bing Ads SDKs สําหรับ .NET, Java หรือ Python คุณสามารถประหยัดเวลาโดยใช้ BulkServiceManager เพื่ออัปโหลดและดาวน์โหลดวัตถุ BulkCustomAudience แทนการเรียกการดําเนินการบริการโดยตรง และเขียนโค้ดแบบกําหนดเองเพื่อแยกวิเคราะห์แต่ละเขตข้อมูลในไฟล์จํานวนมาก
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// CustomAudience object of the Campaign Management service.
CustomAudience = new CustomAudience
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "Updated Custom Audience Description",
// 'Id' column header in the Bulk file
Id = customAudienceIdKey,
// 'Audience' column header in the Bulk file
Name = null,
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Scope' column header in the Bulk file
Scope = null,
// 'Audience Search Size' column header in the Bulk file
SearchSize = null,
// 'Supported Campaign Types' column header in the Bulk file
SupportedCampaignTypes = null,
},
// 'Status' column header in the Bulk file
Status = Status.Active
};
uploadEntities.Add(bulkCustomAudience);
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 แม่
- ขอบ เขต
- สถานะ
- ชนิดของแคมเปญที่ได้รับการสนับสนุน
ผู้ชม
ชื่อของผู้ชมที่กําหนดเอง
ชื่อสามารถมีอักขระได้สูงสุด 128 อักขระ
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง
ลบ: อ่านอย่างเดียว
ขนาดเครือข่ายผู้ชม
จํานวนรวมของบุคคลที่เป็นสมาชิกที่ใช้งานอยู่ของผู้ชมนี้ในเครือข่ายผู้ชม ซึ่งจะช่วยให้คุณทราบจํานวนผู้ใช้เครือข่ายผู้ชมที่คุณกําหนดเป้าหมายได้
ผู้ชมต้องมีอย่างน้อย 300 คนก่อนที่ Microsoft Advertising จะใช้เพื่อการปรับให้เหมาะสม
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว
ขนาดการค้นหาผู้ชม
จํานวนรวมของบุคคลที่เป็นสมาชิกที่ใช้งานอยู่ของผู้ชมนี้ในเครือข่ายการค้นหา ซึ่งช่วยให้คุณทราบจํานวนผู้ใช้การค้นหาที่คุณสามารถกําหนดเป้าหมายได้
ผู้ชมต้องมีอย่างน้อย 300 คนก่อนที่ Microsoft Advertising จะใช้เพื่อการปรับให้เหมาะสม
คุณสมบัตินี้จะว่างเปล่านานถึง 24 ชั่วโมงในขณะที่ผู้ชมกําลังถูกสร้างขึ้น ตัวอย่างเช่น ถ้าคุณได้นําเข้าผู้ชมแบบกําหนดเองใหม่จาก DMP จะใช้เวลา 24 ชั่วโมงในการสร้างผู้ชม และในระหว่างนี้คุณสมบัตินี้จะว่างเปล่า
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว
ID ไคลเอ็นต์
ใช้เพื่อเชื่อมโยงระเบียนในไฟล์อัปโหลดจํานวนมากกับระเบียนในไฟล์ผลลัพธ์ ค่าของเขตข้อมูลนี้ไม่ได้ถูกใช้หรือเก็บโดยเซิร์ฟเวอร์ ให้ตั้งค่าเขตข้อมูลนี้ก่อนแล้วจึงเปิดใช้งานเขตข้อมูลนี้ เพียงแค่คัดลอกจากระเบียนที่อัปโหลดไปยังระเบียนผลลัพธ์ที่สอดคล้องกัน ซึ่งอาจเป็นสตริงที่ถูกต้องที่มีความยาวสูงสุด 100
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: เสริม
ลบ: อ่านอย่างเดียว
คำอธิบาย
คําอธิบายของผู้ชมแบบกําหนดเอง ใช้คําอธิบายเพื่อช่วยให้คุณจําผู้ชมที่คุณกําลังกําหนดเป้าหมายด้วยผู้ชมแบบกําหนดเองนี้
คําอธิบายสามารถมีอักขระได้สูงสุด 1,024 อักขระ
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง ถ้าคุณตั้งค่าฟิลด์นี้เป็นสตริง delete_value
ลบ: อ่านอย่างเดียว
Id
ตัวระบุที่ระบบสร้างขึ้นของผู้ชมแบบกําหนดเอง
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: ต้องระบุ
ลบ: อ่านอย่างเดียวและจําเป็น
ระยะเวลาการเป็นสมาชิก
ระยะเวลาการเป็นสมาชิกจะกําหนดว่า Microsoft Advertising ควรค้นหาการดําเนินการที่ตรงกับข้อกําหนดของผู้ชมแบบกําหนดเองของคุณนานเพียงใดเพื่อเพิ่มบุคคลลงในรายการของคุณ สําหรับผู้ชมแบบกําหนดเอง ระยะเวลาการเป็นสมาชิกไม่ได้ตั้งค่าในแอปพลิเคชันบนเว็บ Microsoft Advertising และ Microsoft Advertising จะเลื่อนไปยังการตั้งค่าผู้ให้บริการผู้ชมแบบกําหนดเองของคุณ
เมื่อคุณร้องขอผู้ชมแบบกําหนดเองผ่าน API โฆษณา Bing ระยะเวลาการเป็นสมาชิกที่ส่งกลับจะเป็น Null
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: ไม่สนับสนุน
ลบ: อ่านอย่างเดียว
เวลาที่ปรับเปลี่ยน
วันที่และเวลาที่มีการอัปเดตเอนทิตีครั้งล่าสุด ค่าอยู่ในเวลามาตรฐานสากล (UTC)
หมายเหตุ
ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว
ID แม่
ตัวระบุ Microsoft Advertising ของลูกค้าที่ประกอบด้วยผู้ชมที่กําหนดเอง
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: ต้องระบุ
ลบ: อ่านอย่างเดียว
ขอบ เขต
ขอบเขตจะกําหนดว่าบัญชีผู้ใช้ใดที่สามารถใช้ผู้ชมแบบกําหนดเองนี้ได้ สําหรับกลุ่มเป้าหมายแบบกําหนดเอง ขอบเขตที่รองรับคือ ลูกค้าเท่านั้น และผู้ชมแบบกําหนดเองสามารถเชื่อมโยงกับแคมเปญและกลุ่มโฆษณาในบัญชีของลูกค้าทั้งหมดได้
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว
สถานะ
สถานะของผู้ชมแบบกําหนดเอง
ค่าที่เป็นไปได้คือ ใช้งานอยู่ หรือ ถูกลบ
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: ต้องระบุ ต้องตั้งค่า สถานะ เป็น ลบ
ชนิดของแคมเปญที่ได้รับการสนับสนุน
รายการแบบคั่นด้วยเครื่องหมายอัฒภาคของชนิดการส่งเสริมการขายที่สนับสนุนผู้ชมแบบกําหนดเองนี้
ค่าที่สนับสนุนคือ Audience, DynamicSearchAds, Search และ Shopping อาจมีการเพิ่มแคมเปญชนิดใหม่ในอนาคต คุณจึงไม่ควรพึ่งพาชุดค่าแบบคงที่
เพิ่ม: ไม่สนับสนุน
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว