ระเบียนรายการรวม - จํานวนมาก
กําหนดรายการที่รวมกันที่สามารถดาวน์โหลดและอัปโหลดในไฟล์จํานวนมาก
รายการที่รวมกันคือผู้ชมที่สร้างขึ้นจากการรวมกลุ่มผู้ชมที่มีอยู่หลายกลุ่ม
เคล็ดลับ
สําหรับภาพรวมและข้อมูลเพิ่มเติมเกี่ยวกับผู้ชม ดูคู่มือทางเทคนิคของ Audience API
คุณสามารถดาวน์โหลดระเบียนรายการรวมทั้งหมดในบัญชีผู้ใช้ได้โดยการรวมค่า DownloadEntity ของ CombinedLists ในการร้องขอบริการ DownloadCampaignsByAccountIds หรือ DownloadCampaignsByCampaignIds นอกจากนี้ คําขอดาวน์โหลดต้องมีขอบเขต EntityData ด้วย สําหรับรายละเอียดเพิ่มเติมเกี่ยวกับบริการแบบกลุ่ม รวมถึงแนวทางปฏิบัติที่ดีที่สุด ดูดาวน์โหลดและอัปโหลดเป็นกลุ่ม
ตัวอย่าง BULK CSV ต่อไปนี้จะเพิ่มรายการรวมใหม่
Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Combination Rule
Format Version,,,,,,6.0,,,,,,
Combined List,Active,-10,,ClientIdGoesHere,,,New combined list description,Customer,New Combined List,NOT(123IdGoesHere,234IdGoesHere)&AND(345IdGoesHere,456IdGoesHere)&OR(567IdGoesHere)
ถ้าคุณกําลังใช้ Bing Ads SDKs สําหรับ .NET, Java หรือ Python คุณสามารถประหยัดเวลาโดยใช้ BulkServiceManager เพื่ออัปโหลดและดาวน์โหลดวัตถุ BulkCombinedList แทนการเรียกการดําเนินการบริการโดยตรง และเขียนโค้ดแบบกําหนดเองเพื่อแยกวิเคราะห์แต่ละเขตข้อมูลในไฟล์จํานวนมาก
var uploadEntities = new List<BulkEntity>();
// Map properties in the Bulk file to the BulkCombinedList
var bulkCombinedList = new BulkCombinedList
{
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// Map properties in the Bulk file to the
// CombinedList object of the Campaign Management service.
CombinedList = new CombinedList
{
// 'Audience Network Size' column header in the Bulk file
AudienceNetworkSize = null,
// 'Description' column header in the Bulk file
Description = "New Combined List",
// 'Id' column header in the Bulk file
Id = combinedListIdKey,
// 'Membership Duration' column header in the Bulk file
MembershipDuration = 30,
// 'Audience' column header in the Bulk file
Name = "Combined List " + DateTime.UtcNow,
// 'Parent Id' column header in the Bulk file
ParentId = accountIdKey,
// 'Combination Rule' column header in the Bulk file
CombinationRules = new[]
{
// Each rule is delimited by a semicolon (;) in the Bulk file
new CombinationRule
{
AudienceIds = new [] { 123, 234 },
Operator = LogicalOperator.And
},
new CombinationRule
{
AudienceIds = new [] { 345, 456 },
Operator = LogicalOperator.And
},
},
// 'Scope' column header in the Bulk file
Scope = EntityScope.Account,
// '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(bulkCombinedList);
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 ชั่วโมงในขณะที่สร้างผู้ชม ตัวอย่างเช่น ถ้าคุณเพิ่มหรืออัปเดตระยะเวลาการเป็นสมาชิก กฎ หรือตัวระบุแท็กแบบรวม
คุณสมบัตินี้จะว่างเปล่าถ้าแท็ก UET ที่เกี่ยวข้องกับรายการที่รวมมีสถานะเป็น ไม่ผ่านการตรวจสอบ หรือ ไม่ได้ใช้งาน เนื่องจากรายการรวมไม่สามารถรับข้อมูลลูกค้าจากเว็บไซต์ของคุณที่ต้องการสร้างรายการ
เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว
ID ไคลเอ็นต์
ใช้เพื่อเชื่อมโยงระเบียนในไฟล์อัปโหลดจํานวนมากกับระเบียนในไฟล์ผลลัพธ์ ค่าของเขตข้อมูลนี้ไม่ได้ถูกใช้หรือเก็บโดยเซิร์ฟเวอร์ ให้ตั้งค่าเขตข้อมูลนี้ก่อนแล้วจึงเปิดใช้งานเขตข้อมูลนี้ เพียงแค่คัดลอกจากระเบียนที่อัปโหลดไปยังระเบียนผลลัพธ์ที่สอดคล้องกัน ซึ่งอาจเป็นสตริงที่ถูกต้องที่มีความยาวสูงสุด 100
เพิ่ม: เสริม
ปรับ ปรุง: เสริม
ลบ: อ่านอย่างเดียว
กฎการรวม
กฎการรวมประกอบด้วยเงื่อนไขที่ใช้เพื่อกําหนดว่าจะเพิ่มใครลงในรายการรวมของคุณ
คุณสามารถรวมผู้ชมแบบกําหนดเอง รายชื่อลูกค้า ผู้ชมผลิตภัณฑ์ ผู้ชมที่คล้ายกัน และรายการรีมาร์เก็ตติ้งได้ คุณไม่สามารถรวมรายการรวมหรือผู้ชมที่มีในตลาดอื่นๆ ไว้ในรายการที่รวมกัน
คุณสามารถสร้างรายการรวมได้สูงสุด 1,000 รายการต่อบัญชีโฆษณา หนึ่งบัญชี และสูงสุด 5,000 ต่อลูกค้าหนึ่งราย กฎการรวมกันของแต่ละรายการสามารถรวมชุดเงื่อนไขเชิงตรรกะได้สูงสุด 100 ชุด และแต่ละชุดสามารถมี ID ผู้ชมได้ถึง 100 ชุด
ด้วยข้อจํากัดบางอย่างที่อธิบายไว้ด้านล่าง คุณสามารถรวมผู้ชมโดยใช้ตัวดําเนินการเชิงตรรกะเหล่านี้:
- หรือ: ซึ่งจะรวมถึงลูกค้าที่อยู่ในรายการผู้ชมเหล่านี้
- และ: ซึ่งจะรวมเฉพาะลูกค้าที่อยู่ในรายการผู้ชมเหล่านี้ทุกรายการ
- ไม่: การดําเนินการนี้จะแยกลูกค้าที่อยู่ในรายชื่อผู้ชมเหล่านี้ออก
ชุดเงื่อนไขเชิงตรรกะจะอ้างอิงถึงกลุ่มของรหัสผู้ชมที่คัดสรรโดย OR, AND หรือ NOT ใน Bulk API แต่ละชุดจะถูกคั่นด้วยเครื่องหมายและ ('&')
ตัวอย่างเช่น ต่อไปนี้คือ 10 ชุดสําหรับกฎการรวมกันหนึ่งกฎ แต่ละชุดมี ID ผู้ชมหนึ่งกฎ: NOT(1)&AND(2)&OR(3)&NOT(4)&AND(5)&OR(6)&NOT(7)&AND(8)&OR(9)&NOT(10)
นี่คือตัวอย่างของ 10 ชุดสําหรับกฎการรวมหนึ่งกฎ แต่ละรายการที่มี ID ผู้ชมสองรายการ: NOT(1,101)&AND(2,102)&OR(3,103)&NOT(4,104)&AND(5,105) )&OR(6,106)&NOT(7,107)&AND(8,108)&OR(9,109)&NOT(10,110)
การประเมินนิพจน์เชิงตรรกะจะกําหนดว่าใครจะถูกเพิ่มในรายการรวม ชุดค่าผสมหลายชุดจะรวมกับฟังก์ชัน AND เสมอ ซึ่งหมายความว่าลูกค้าต้องตรงตามเกณฑ์ทั้งหมดของชุดค่าผสมแต่ละรายการเพื่อให้ปรากฏในชุดรายชื่อผู้ชมที่กําหนดเองนี้ ตัวอย่างเช่น สมมติว่ากฎการรวมกันถูกตั้งค่าเป็น NOT(123,234)&NOT(345,456)&AND(567,678)&OR(789,890)&OR(987,876) รายการรวมจะรวมลูกค้าที่เป็นลูกค้า a) ทั้งในผู้ชม 567 และ 678 และ b) อยู่ในผู้ชม 789 หรือ 890 และ c) อยู่ในผู้ชม 987 หรือ 876 เว้นแต่ว่า d) ลูกค้าอยู่ในผู้ชม 123, 234, 345 หรือ 456
รายการที่รวมต้องมีอย่างน้อยหนึ่งผู้ชมที่ใช้ตัวดําเนินการ OR หรือ AND รายการรวมไม่สามารถใช้เฉพาะตัวดําเนินการ NOT เท่านั้น ในกรณีดังกล่าว คุณควรใช้การยกเว้นผู้ชมแทน
ไม่สามารถรวมผู้ชมแบบกําหนดเองและรายการลูกค้ากับผู้ชมประเภทอื่นได้
ไม่สามารถรวมผู้ชมที่คล้ายกันผ่านตัวดําเนินการ AND หรือ NOT ได้ ผู้ชมที่คล้ายกันสามารถใช้ได้ในเงื่อนไข OR เดียวเท่านั้น กล่าวอีกนัยหนึ่งคือ สามารถมีชุดผู้ชมได้เพียงชุดเดียวที่ประกอบด้วยผู้ชมที่คล้ายกัน และชุดนั้นต้องใช้ตัวดําเนินการ OR
อนุญาตให้มีผู้ชมที่ซ้ํากันได้ แม้ว่า ID ผู้ชมเดียวกันจะไม่สามารถรวมกันผ่านทั้งตัวดําเนินการ AND และ NOT ได้
ถ้าคุณกําลังสร้างผู้ชมใหม่พร้อมกับรายการรวมนี้ในการอัปโหลดจํานวนมากเดียวกัน กฎการรวมสามารถมีตัวระบุค่าลบที่เท่ากับเขตข้อมูล Id ของผู้ชมใหม่อื่น ๆ ได้ ตัวอย่างเช่น ถ้าคุณกําลังสร้าง รายการรีมาร์เก็ตติ้ง ใหม่ และต้องการรวมไว้ในรายการที่รวมคุณสามารถตั้งค่า Id ของรายการรีมาร์เก็ตติ้งเป็น -1 ได้ ในการอัปโหลดจํานวนมากเดียวกัน คุณสามารถอ้างอิงไปยังรายการรีมาร์เก็ตติ้งใหม่โดยใช้ -1 ในกฎการรวมกัน เช่น NOT(123,234)&AND(345,456)&OR(-1,678) สําหรับข้อมูลเพิ่มเติม ดูคีย์การอ้างอิง Schema ของไฟล์จํานวนมาก
ถ้าคุณกําลังสร้างผู้ชมใหม่พร้อมกับรายการรวมนี้ในการอัปโหลดเป็นกลุ่มเดียวกัน กฎการรวมสามารถรวมคีย์อ้างอิงเชิงลบไปยังเขตข้อมูล ID เชิงลบของผู้ชมใหม่อื่น ๆ ได้ คุณยังสามารถใช้คีย์การอ้างอิงเชิงตรรกะไปยังเขตข้อมูล Audience (ชื่อ) ของผู้ชมรายใหม่อื่นได้
- ตัวอย่างของการใช้คีย์การอ้างอิงที่เป็นค่าลบ ในการอัปโหลดเป็นกลุ่มเดียวกันจะรวมรายการรีมาร์เก็ตติ้งใหม่ที่มีการตั้งค่า ID เป็น -1 จากนั้นดูรายการรีมาร์เก็ตติ้งใหม่โดยใช้ -1 ในกฎการรวมกัน เช่น NOT(123,234)&AND(345,456)&OR(-1,678)
- ตัวอย่างของการใช้คีย์การอ้างอิงเชิงตรรกะ ในการอัปโหลดเป็นกลุ่มเดียวกันจะมีรายการรีมาร์เก็ตติ้งใหม่ที่มีการตั้งค่าชื่อผู้ชมเป็นผู้ชมใหม่ของฉัน จากนั้นดูรายการรีมาร์เก็ตติ้งใหม่โดยใช้ 'ผู้ชมของฉัน' (ล้อมรอบด้วยเครื่องหมายอัญประกาศเดี่ยว) ในกฎการรวมกัน เช่น NOT(123,234)&AND(345,456)&OR('ผู้ชมใหม่ของฉัน',678)
สําหรับข้อมูลเพิ่มเติม ดูคีย์การอ้างอิง Schema ของไฟล์จํานวนมาก
เพิ่ม: ต้องระบุ
ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง
ลบ: อ่านอย่างเดียว
คำอธิบาย
คําอธิบายของรายการรวม ใช้คําอธิบายเพื่อช่วยให้คุณจําผู้ชมที่คุณกําลังกําหนดเป้าหมายด้วยรายการรวมนี้
คําอธิบายสามารถมีอักขระได้สูงสุด 1,024 อักขระ
เพิ่ม: เสริม
ปรับ ปรุง: เสริม ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง ถ้าคุณตั้งค่าฟิลด์นี้เป็นสตริง delete_value
ลบ: อ่านอย่างเดียว
Id
ตัวระบุที่ระบบสร้างขึ้นของรายการรวม
เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียวและจําเป็น
ลบ: อ่านอย่างเดียวและจําเป็น
เวลาที่ปรับเปลี่ยน
วันที่และเวลาที่มีการอัปเดตเอนทิตีครั้งล่าสุด ค่าอยู่ในเวลามาตรฐานสากล (UTC)
หมายเหตุ
ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML
เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว
ID แม่
ตัวระบุที่ระบบสร้างขึ้นของบัญชีหรือลูกค้า ถ้า ขอบเขต ถูกตั้งค่าเป็น บัญชี นี่คือ ID บัญชี และมิฉะนั้นจะเป็น ID ลูกค้า
เพิ่ม: เสริม
ปรับ ปรุง: อ่านอย่างเดียว คุณไม่สามารถเปลี่ยน ID หลักได้
ลบ: อ่านอย่างเดียว
ขอบ เขต
ขอบเขตจะกําหนดว่าบัญชีใดที่สามารถใช้รายการที่รวมนี้ได้ ถ้าขอบเขตถูกตั้งค่าเป็น บัญชี รายการรวมจะสามารถเชื่อมโยงกับแคมเปญและกลุ่มโฆษณาภายในบัญชีที่ระบุเท่านั้น (ID หลัก) หากกําหนดขอบเขตเป็น ลูกค้า รายการรวมสามารถเชื่อมโยงกับแคมเปญและกลุ่มโฆษณาในบัญชีของลูกค้าทั้งหมดได้
เพิ่ม: ต้องระบุ
ปรับ ปรุง: อ่านอย่างเดียว คุณไม่สามารถเปลี่ยนแปลงขอบเขตได้
ลบ: อ่านอย่างเดียว
สถานะ
สถานะรายการรวม
ค่าที่เป็นไปได้คือ ใช้งานอยู่ หรือ ถูกลบ
เพิ่ม: เสริม ค่าเริ่มต้นคือ ใช้งานอยู่
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: ต้องระบุ ต้องตั้งค่า สถานะ เป็น ลบ
ชนิดของแคมเปญที่ได้รับการสนับสนุน
รายการการส่งเสริมการขายแบบคั่นด้วยเครื่องหมายอัฒภาคที่สนับสนุนรายการรวมนี้
ค่าที่สนับสนุนคือ Audience, DynamicSearchAds, Search และ Shopping อาจมีการเพิ่มแคมเปญชนิดใหม่ในอนาคต คุณจึงไม่ควรพึ่งพาชุดค่าแบบคงที่
เพิ่ม: อ่านอย่างเดียว
ปรับ ปรุง: อ่านอย่างเดียว
ลบ: อ่านอย่างเดียว
คำติชม
https://aka.ms/ContentUserFeedback
เร็วๆ นี้: ตลอดปี 2024 เราจะขจัดปัญหา GitHub เพื่อเป็นกลไกคำติชมสำหรับเนื้อหา และแทนที่ด้วยระบบคำติชมใหม่ สำหรับข้อมูลเพิ่มเติม ให้ดู:ส่งและดูข้อคิดเห็นสำหรับ