แชร์ผ่าน


ระเบียนรายการตัวดึงข้อมูล - จํานวนมาก

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

เคล็ดลับ

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

หมายเหตุ

  • อัปเกรดโฆษณาแบบข้อความที่ขยายเป็นโฆษณาในการค้นหาที่ตอบสนองภายในวันที่ 1 กุมภาพันธ์ ค.ศ. 2023 หลังจากวันที่ดังกล่าว คุณจะไม่สามารถสร้างโฆษณาแบบข้อความใหม่หรือแก้ไขโฆษณาแบบข้อความที่ขยายแล้วที่มีอยู่ได้อีกต่อไป สําหรับข้อมูลเพิ่มเติม โปรดดูเกี่ยวกับโฆษณาในการค้นหาแบบตอบสนอง
  • ฟีดที่กําหนดเวลาไว้จะยังคงทํางานต่อไปและโฆษณาแบบข้อความที่ขยายแล้วที่ใช้ฟีดผู้กําหนดค่าโฆษณาจะยังคงแสดงต่อไป คุณจะสามารถดูรายงานเกี่ยวกับประสิทธิภาพของพวกเขาได้
  • คุณจะยังคงสามารถหยุดชั่วคราว เรียกใช้ หรือลบฟีดผู้กําหนดค่าโฆษณาที่มีอยู่ได้ มิฉะนั้น ความพยายามในการสร้างหรือแก้ไขผู้กําหนดค่าโฆษณาที่มีอยู่สําหรับโฆษณาแบบข้อความที่ขยายแล้วจะส่งผลให้ CustomerNotEligibleForAdCustomizersFeed เกิดข้อผิดพลาด
  • เรียนรู้เพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงนี้

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

  1. ฟีด
  2. แคมเปญ
  3. กลุ่มโฆษณา
  4. รายการตัวดึงข้อมูล

คุณสามารถมีฟีดได้ 100 ตัวต่อบัญชี (จํานวนสูงสุดนี้มีฟีดทุกประเภท) และจํานวนสูงสุดของรายการฟีด (แถว) ต่อบัญชีคือ 5 ล้านรายการ

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

ตัวอย่าง CSV จํานวนมากต่อไปนี้จะเพิ่มฟีดหน้าใหม่และ ฟีด ผู้กําหนดค่าโฆษณาที่มีฟีดหนึ่งรายการสําหรับแต่ละรายการ

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,Target Campaign Id,Target Ad Group Id,Client Id,Modified Time,Start Date,End Date,Device Preference,Keyword,Match Type,Target,Physical Intent,Name,Ad Schedule,Audience Id,Feed Name,Custom Attributes
Format Version,,,,,,,,,,,,,,,,,,6,,,,
Feed,Active,-20,,PageFeed,,,,,PageFeedClientIdGoesHere,,,,,,,,,,,,MyPageFeedName,"[{""name"":""Page Url"",""feedAttributeType"":""Url"",""isPartOfKey"":true},{""name"":""Custom Label"",""feedAttributeType"":""StringList""},{""name"":""Ad Title"",""feedAttributeType"":""String""}]"
Feed,Active,-21,,AdCustomizerFeed,,,,,AdCustomizerFeedClientIdGoesHere,,,,,,,,,,,,MyAdCustomizerFeedName,"[{""name"":""DateTimeName"",""feedAttributeType"":""DateTime""},{""name"":""Int64Name"",""feedAttributeType"":""Int64""},{""name"":""PriceName"",""feedAttributeType"":""Price""},{""name"":""StringName"",""feedAttributeType"":""String"",""isPartOfKey"":true}]"
Feed,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,-21,,DynamicDataAutosListingFeed,,"[{""name"":""Vehicle ID""},{""name"":""Final URL""},{""name"":""Image URL""},{""name"":""Make""},{""name"":""Model""},{""name"":""Price""},{""name"":""Title""},{""name"":""Target campaign""},{""name"":""Target ad group""},{""name"":""Latitude""},{""name"":""Longitude""},{""name"":""Mileage value""},{""name"":""Mileage unit""},{""name"":""Year""},{""name"":""Fuel type""},{""name"":""Transmission""},{""name"":""City""},{""name"":""VIN""},{""name"":""State of vehicle""}]"
Feed Item,Active,123456789,DynamicDataAutoListingFeedNew,CampaignName,AUTO ad group,,-21,,,"{""Vehicle Id"":""2g161290-1d13"",""""Final Url"""":""https:\/\/www.contoso.com\/used-Redmond1"",""Image Urls"":""https:\/\/www.contoso.com\/inventoryphotos\/01.jpg;https:\/\/www.contoso.com\/inventoryphotos\/02.jpg"",""Make"":""Contoso"",""Model"":""SUV"",""Price"":""65495.00 USD"",""Title"":""2020 SUV"",""Target campaign"":""CampaignName"",""Target ad group"":"""",""Latitude"":"""",""Logitude"":"""",""Mileage Value"":""13000"",""Mileage Unit"":""MI"",""Year"":""2020"",""Fuel Type"":"""",""Transmission"":"""",""City"":""Redmond"",""Vin"":""SALLJGML8HA004044"",""State of Vehicle"":""USED"",""Trim"":""HSE""}"
Feed Item,Active,-200,-20,,,,20;200,,2020/06/22 00:00:00,2020/06/30 00:00:00,,,,,,,,,,"{""Page Url"":""https://contoso.com/3001"",""Custom Label"":[""Label_1_3001"",""Label_2_3001""],""Ad Title"":""An ad title""}"
Feed Item,Active,-210,-21,,,,21;210,,2020/06/22 00:00:00,2020/06/30 00:00:00,,value,Broad,,PeopleIn,,(Sunday[09:00-17:00]),,,"{""DateTimeName"":""2020/06/22 00:00:00"",""Int64Name"":237601,""PriceName"":""$601"",""StringName"":""s237601""}"

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

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkFeedItem
var bulkAdCustomizerFeedItem = new BulkFeedItem
{
	// 'Parent Id' column header in the Bulk file
	FeedId = adCustomizerFeedIdKey,
	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = adCustomizerFeedItemCustomAttributesJson,
	// 'Id' column header in the Bulk file
	Id = null,
	// 'Target Ad Group Id' column header in the Bulk file
	AdGroupId = null,
	// 'Ad Group' column header in the Bulk file
	AdGroupName = null,
	// 'Audience Id' column header in the Bulk file
	AudienceId = null,
	// 'Target Campaign Id' column header in the Bulk file
	CampaignId = null,
	// 'Campaign' column header in the Bulk file
	CampaignName = null,
	// 'Ad Schedule' column header in the Bulk file
	DayTimeRanges = new[]
	{
		// Each day and time range is delimited by a semicolon (;) in the Bulk file
		// 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 = null,
	// 'Start Date' column header in the Bulk file
	StartDate = null,
	// 'Physical Intent' column header in the Bulk file
	IntentOption = IntentOption.PeopleIn,
	// 'Keyword' column header in the Bulk file
	Keyword = "insurance",
	// 'Target' column header in the Bulk file
	LocationId = 190,
	// 'Match Type' column header in the Bulk file
	MatchType = MatchType.Exact,
	// 'Device Preference' column header in the Bulk file
	DevicePreference = null,
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkAdCustomizerFeedItem);

// Map properties in the Bulk file to the BulkFeedItem
var bulkPageFeedItem = new BulkFeedItem
{
    // 'Parent Id' column header in the Bulk file
    FeedId = pageFeedIdKey,
    // 'Custom Attributes' column header in the Bulk file
    CustomAttributes = pageFeedItemCustomAttributesJson,
    // 'Id' column header in the Bulk file
    Id = null,
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",
    // 'Status' column header in the Bulk file
    Status = Status.Active
};

uploadEntities.Add(bulkPageFeedItem);

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

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

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

กลุ่มโฆษณา

ชื่อของกลุ่มโฆษณาที่ใช้เพื่อกําหนดเป้าหมายรายการฟีด หากตั้งค่าเขตข้อมูลนี้ รายการฟีดจะมีสิทธิ์สําหรับกลุ่มโฆษณาที่ระบุเท่านั้น

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

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

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

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

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

ค่าที่เป็นไปได้ของ 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 ผู้ชม

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

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

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

แคมเปญ

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

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

เพิ่ม: เสริม ถ้าทั้งฟิลด์รหัส การส่งเสริมการขาย และ รหัสการส่งเสริมการขายเป้าหมาย ถูกตั้งค่า ข้อผิดพลาดจะถูกส่งกลับสําหรับเรกคอร์ดนี้ในไฟล์จํานวนมาก
ปรับ ปรุง: เสริม ถ้าทั้งฟิลด์รหัส การส่งเสริมการขาย และ รหัสการส่งเสริมการขายเป้าหมาย ถูกตั้งค่า ข้อผิดพลาดจะถูกส่งกลับสําหรับเรกคอร์ดนี้ในไฟล์จํานวนมาก ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง ถ้าคุณตั้งค่าฟิลด์นี้เป็นสตริง delete_value
ลบ: อ่านอย่างเดียว

ID ไคลเอ็นต์

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

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

แอตทริบิวต์แบบกําหนดเอง

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

สําหรับชนิดย่อยของฟีด AdCustomizerFeed คุณสามารถใส่แอตทริบิวต์แบบกําหนดเองได้สูงสุด 100 รายการต่อรายการฟีดที่ชื่อแอตทริบิวต์แบบกําหนดเองแต่ละชื่อไม่ซ้ํากัน

สําหรับชนิดย่อย DynamicDataAutosListingFeed คุณสามารถใส่แอตทริบิวต์แบบกําหนดเองได้สูงสุด 100 แอตทริบิวต์ต่อรายการตัวดึงข้อมูลที่ชื่อแอตทริบิวต์แบบกําหนดเองแต่ละ ชื่อ ไม่ซ้ํากัน

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

แอตทริบิวต์แบบกําหนดเองจะแสดงในไฟล์จํานวนมากเป็นสตริง JSON สําหรับรายละเอียดเพิ่มเติม ดู feedAttributeTypeคือ PartOfKey และ ชื่อ ด้านล่าง

ต่อไปนี้เป็นตัวอย่างแอตทริบิวต์แบบกําหนดเองที่คุณสามารถอัปโหลดสําหรับตัวดึงข้อมูลหน้าได้

หมายเหตุ

ในไฟล์จํานวนมากที่คั่นด้วยเครื่องหมายจุลภาค คุณจะต้องล้อมรอบรายการแอตทริบิวต์ แต่ละแอตทริบิวต์คีย์ และแต่ละค่าแอตทริบิวต์ด้วยชุดเครื่องหมายอัญประกาศคู่เพิ่มเติม เช่น สตริง JSON ด้านบนจะถูกเขียนเป็น "[{""ชื่อ":"Url ของหน้า"","feedAttributeType"":"Url","isPartOfKey"":true},{"name"" :""ป้ายชื่อแบบกําหนดเอง"","feedAttributeType"":"StringList"},{""name":""Ad Title",""feedAttributeType"":"String""}]"

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

ต่อไปนี้คือตัวอย่างแอตทริบิวต์แบบกําหนดเองที่คุณสามารถอัปโหลดสําหรับฟีดผู้กําหนดค่าโฆษณา

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601"
}

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

feedAttributeType

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

มีประเภทข้อมูลที่แตกต่างกัน feedAttributeType สี่ประเภทที่คุณสามารถตั้งค่าสําหรับฟีด Ad Customizer:

feedAttributeType ใช้กรณี ค่ารายการตัวดึงข้อมูลที่ยอมรับ
สตริง ชื่อผลิตภัณฑ์ หมวดหมู่ผลิตภัณฑ์ คําอธิบาย ตัวอักษร ตัวเลข หรือสัญลักษณ์ใดๆ
Int64 จํานวนสินค้าคงคลัง จํานวนสีที่พร้อมใช้งาน จํานวนเต็มใดๆ
ราคา ต้นทุนผลิตภัณฑ์ ส่วนลดในการขาย ตัวเลขใดๆ (รวมถึงทศนิยม) และอักขระสกุลเงินที่ถูกต้อง
Datetime เวลาเริ่มต้นเหตุการณ์ วันสุดท้ายของการขาย yyyy/mm/dd HH:mm:ss
หากต้องการเริ่มต้นถึงเที่ยงคืนในตอนต้นของวัน คุณสามารถเว้นส่วน HH:mm:ss ได้

ตัวอย่างเช่น เราสามารถกําหนดแอตทริบิวต์แบบกําหนดเองของฟีดผู้กําหนดค่าโฆษณา

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	}
]

จากนั้นเราสามารถแมปชื่อตัวดึงข้อมูลแต่ละ ตัว เช่น "DateTimeName", "Int64Name", "PriceName" และ "StringName" ในการอัปโหลดรายการตัวดึงข้อมูล:

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601"
}

มีชนิดข้อมูลที่แตกต่างกัน feedAttributeType หกชนิดที่คุณสามารถตั้งค่าสําหรับตัวดึงข้อมูล DynamicDataAutosListing:

feedAttributeType ใช้กรณี ค่ารายการตัวดึงข้อมูลที่ยอมรับ
สตริง ชื่อยานพาหนะหมวดหมู่ยานพาหนะคําอธิบาย ตัวอักษร ตัวเลข หรือสัญลักษณ์ใดๆ
Int64 ปียานพาหนะ, เครื่องยนต์ จํานวนเต็มใดๆ
ราคา ต้นทุนของยานพาหนะ, ส่วนลดในการขาย ตัวเลขใดๆ (รวมถึงทศนิยม) และอักขระสกุลเงินที่ถูกต้อง
Datetime เวลาเริ่มต้นเหตุการณ์ วันสุดท้ายของการขาย yyyy/mm/dd HH:mm:ss
หากต้องการเริ่มต้นถึงเที่ยงคืนในตอนต้นของวัน คุณสามารถเว้นส่วน HH:mm:ss ได้
Url มี URL ของเว็บไซต์ของคุณที่จะรวมไว้ในตัวดึงข้อมูล คุณต้องใส่หนึ่ง URL ต่อหนึ่งรายการตัวดึงข้อมูล
StringList ป้ายชื่อที่ช่วยให้คุณสามารถจัดกลุ่ม URL ภายในตัวดึงข้อมูล คุณสามารถใส่ป้ายชื่อแบบกําหนดเองได้ตั้งแต่หนึ่งถึงสิบป้ายต่อหนึ่งรายการฟีด
ป้ายชื่อแบบกําหนดเองแต่ละป้ายจะแสดงเป็นข้อมูลในรายการในสัญลักษณ์ JSON ตัวอย่างเช่น ส่วนป้ายชื่อแบบกําหนดเองของรายการ ฟีด อาจเขียนเป็น ""ป้ายชื่อแบบกําหนดเอง"":[""Label_1_3001",""Label_2_3001"]

ตัวอย่างเช่น เราสามารถกําหนดแอตทริบิวต์แบบกําหนดเองของตัวดึงข้อมูล DynamicDataAutosListing ได้

[
	{
		"name": "DateTimeName",
		"feedAttributeType": "DateTime"
	},
	{
		"name": "Int64Name",
		"feedAttributeType": "Int64"
	},
	{
		"name": "PriceName",
		"feedAttributeType": "Price"
	},
	{
		"name": "StringName",
		"feedAttributeType": "String",
		"isPartOfKey": true
	},
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	}
]

จากนั้นเราสามารถแมปชื่อตัวดึงข้อมูลแต่ละ ชื่อ เช่น "DateTimeName", "Int64Name", "PriceName" และ "StringName" ในการอัปโหลด รายการฟีด :

{
	"DateTimeName": "2020/06/22 00:00:00",
	"Int64Name": 237601,
	"PriceName": "$601",
	"StringName": "s237601",
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
}

ต่อไปนี้คือ feedAttributeType ชนิดข้อมูลที่คุณสามารถตั้งค่าสําหรับตัวดึงข้อมูลหน้า:

feedAttributeType ใช้กรณี ค่ารายการตัวดึงข้อมูลที่ยอมรับ
สตริง พาดหัวข่าวแบบคงที่ที่แสดงแทนที่จะเป็นพาดหัวที่สร้างขึ้นแบบไดนามิก ตัวอักษร ตัวเลข หรือสัญลักษณ์ใดๆ ที่มีอักขระไม่เกิน 63 ตัว คุณสามารถใส่ชื่อโฆษณาได้หนึ่งชื่อต่อหนึ่งรายการในฟีด
StringList ป้ายชื่อที่ช่วยให้คุณสามารถจัดกลุ่ม URL ภายในตัวดึงข้อมูล คุณสามารถใส่ป้ายชื่อแบบกําหนดเองได้ตั้งแต่หนึ่งถึงสิบป้ายต่อหนึ่งรายการฟีด
ป้ายชื่อแบบกําหนดเองแต่ละป้ายจะแสดงเป็นข้อมูลในรายการในสัญลักษณ์ JSON ตัวอย่างเช่น ส่วนป้ายชื่อแบบกําหนดเองของรายการ ฟีด อาจเขียนเป็น ""ป้ายชื่อแบบกําหนดเอง"":[""Label_1_3001",""Label_2_3001"]
Url มี URL ของเว็บไซต์ของคุณที่จะรวมไว้ในตัวดึงข้อมูล คุณต้องใส่หนึ่ง URL ต่อหนึ่งรายการตัวดึงข้อมูล

ตัวอย่างเช่น เราสามารถกําหนดแอตทริบิวต์แบบกําหนดเองของฟีดหน้าได้

หมายเหตุ

feedAttributeTypeเป็นตัวเลือกสําหรับตัวดึงข้อมูลหน้า ถ้าคุณตั้งค่า feedAttributeTypeจากนั้นจะต้องตั้งค่าเป็น "URL" สําหรับ "Url ของหน้า", "StringList" สําหรับ "ป้ายชื่อแบบกําหนดเอง" และ "สตริง" สําหรับแอตทริบิวต์ ที่มีชื่อ "Ad Title"

[
	{
		"name": "Page Url",
		"feedAttributeType": "Url",
		"isPartOfKey": true
	},
	{
		"name": "Custom Label",
		"feedAttributeType": "StringList"
	},
	{
		"name": "Ad Title",
		"feedAttributeType": "String"
	}
]

จากนั้นเราสามารถแมปชื่อตัวดึงข้อมูลแต่ละ ตัว เช่น "URL ของหน้า", "ป้ายชื่อแบบกําหนดเอง" และ "ชื่อโฆษณา" ในการอัปโหลด รายการฟีด :

{
	"Page Url": "https://contoso.com/3001",
	"Custom Label": [
		"Label_1_3001",
		"Label_2_3001"
	],
    "Ad Title": "Find New Customers & Increase Sales!",
}

isPartOfKey

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

สําหรับฟีดผู้กําหนดค่าโฆษณาและรายการฟีด สตริงที่ชื่อ "รหัสที่กําหนดเอง" จะถือว่าเป็นคีย์ที่ไม่ซ้ํากันเสมอ เช่น isPartOfKey "จริง" เสมอ แอตทริบิวต์ "รหัสที่กําหนดเอง" ในขณะนี้เป็นวิธีเดียวที่จะตั้งค่าคีย์เฉพาะสําหรับฟีด Ad Customizer ผ่านเว็บแอปพลิเคชัน Microsoft Advertising ด้วย Bulk API คุณมีความยืดหยุ่นมากขึ้นในการใช้ชื่อแอตทริบิวต์ใด ๆ เป็นคีย์ที่ไม่ซ้ํากัน

สําหรับตัวดึงข้อมูลหน้าและป้อนรายการ "URL ของหน้า" จะถือว่าเป็นคีย์ที่ไม่ซ้ํากันเสมอ เช่น isPartOfKey "จริง" เสมอ

สําหรับตัวดึงข้อมูล DynamicDataAutosListing และฟีดรายการ "VehicleId" จะถือว่าเป็นคีย์ที่ไม่ซ้ํากันเสมอ เช่น isPartOfKey จะเป็น "จริง" เสมอ

ชื่อ

แอตทริบิวต์ name ถูกใช้เพื่อแมปแอตทริบิวต์แบบกําหนดเองที่แตกต่างกันทั้งรายการ ฟีด และฟีด นี่คือวิธีที่คุณมั่นใจได้ว่ารายการฟีดเฉพาะจะสะสมไปยัง "คอลัมน์" เดียวกันในฟีด ในตัวอย่าง ad customizer เหนือชื่อ "DateTimeName", "Int64Name", "PriceName" และ "StringName" จะถูกใช้ทั้งในรายการฟีดและฟีด

การกําหนดลักษณะอุปกรณ์

ฟิลด์นี้กําหนดว่าการกําหนดลักษณะเป็นรายการฟีดที่จะแสดงบนอุปกรณ์เคลื่อนที่หรืออุปกรณ์ทั้งหมด

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

ค่าที่เป็นไปได้คือ ทั้งหมด และ โมบาย ซึ่งแตกต่างจากค่าที่ใช้ในบริการจัดการแคมเปญ

ค่าเริ่มต้นคือ ทั้งหมด

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

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

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

สตริงวันที่สิ้นสุดตามกําหนดการของรายการฟีดที่จัดรูปแบบเป็น yyyy/mm/dd HH:mm:ss หากต้องการเริ่มต้นถึงเที่ยงคืนในตอนต้นของวัน คุณสามารถเว้นส่วน HH:mm:ss ได้

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

วันที่สิ้นสุดรวมอยู่ด้วย ตัวอย่างเช่น ถ้าคุณตั้งค่าเขตข้อมูลนี้เป็น 2020/12/31 00:00:00 รายการฟีดจะหยุดมีสิทธิ์ในเวลา 12:00 น. ในวันที่ 12/31/2020

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

Id

ตัวระบุที่ระบบสร้างขึ้นของตัวดึงข้อมูล

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

คำ

ข้อความคําสําคัญ

ข้อความสามารถมีอักขระได้สูงสุด 100 อักขระ

คุณควรระบุคีย์เวิร์ดในตําแหน่งที่ตั้งของภาษาของแคมเปญเป้าหมายหรือกลุ่มโฆษณา

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

ชนิดการตรงกัน

ชนิดของรายการที่ตรงกันเพื่อเปรียบเทียบคําสําคัญและคําค้นหาของผู้ใช้

ค่าประเภทการจับคู่ที่ได้รับการสนับสนุนสําหรับคําสําคัญคือกว้าง, Exact และ Phrase

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

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

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

หมายเหตุ

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

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

ID แม่

ตัวระบุที่ระบบสร้างขึ้นของ ตัวดึงข้อมูลแม่

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

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

จุดประสงค์ทางกายภาพ

กําหนดว่าบุคคลต้องอยู่ในตําแหน่งที่ตั้งเป้าหมายเพื่อให้รายการตัวดึงข้อมูลมีสิทธิ์หรือไม่

ตามค่าเริ่มต้น รายการตัวดึงข้อมูลสามารถแสดงให้บุคคลใน ค้นหา หรือดูหน้าเกี่ยวกับตําแหน่งที่ตั้งเป้าหมายของคุณได้ ตั้งค่าเขตข้อมูลนี้เป็น PeopleIn ถ้าคุณต้องการให้รายการตัวดึงข้อมูลแสดงเฉพาะบุคคลที่อยู่ในตําแหน่งที่ตั้งเป้าหมายเท่านั้น

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

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

สตริงของวันที่เริ่มตามกําหนดการของรายการตัวดึงข้อมูลซึ่งจัดรูปแบบเป็น yyyy/mm/dd HH:mm:ss หากต้องการเริ่มต้นถึงเที่ยงคืนในตอนต้นของวัน คุณสามารถเว้นส่วน HH:mm:ss ได้

วันที่เริ่มต้นรวมอยู่ด้วย ตัวอย่างเช่น ถ้าคุณตั้งค่าเขตข้อมูลนี้เป็น 2020/06/15 00:00:00 รายการฟีดจะเริ่มมีสิทธิ์ในเวลา 12:00 น. ในวันที่ 15 มิถุนายน 2020

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

สถานะ

สถานะของรายการตัวดึงข้อมูล

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

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

เป้าหมาย

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

หากคุณต้องการกําหนดเป้าหมายเฉพาะบุคคลในตําแหน่งที่ตั้งคุณจะต้องตั้งค่าเขตข้อมูล จุดประสงค์ทางกายภาพ ด้วยเช่นกัน

ตัวระบุตําแหน่งที่ตั้งสอดคล้องกับเขตข้อมูล ID ตําแหน่งที่ตั้ง ของไฟล์ตําแหน่งที่ตั้งทางภูมิศาสตร์ สําหรับข้อมูลเพิ่มเติม ดูรหัสตําแหน่งที่ตั้งทางภูมิศาสตร์และ GetGeoLocationsFileUrl

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

ID กลุ่มโฆษณาเป้าหมาย

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

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

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

ID การส่งเสริมการขายเป้าหมาย

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

หมายเหตุ

เขตข้อมูลนี้ใช้ได้กับฟีด Ad Customizer เท่านั้น

เพิ่ม: เสริม ถ้าทั้งฟิลด์รหัส การส่งเสริมการขาย และ รหัสการส่งเสริมการขายเป้าหมาย ถูกตั้งค่า ข้อผิดพลาดจะถูกส่งกลับสําหรับเรกคอร์ดนี้ในไฟล์จํานวนมาก
ปรับ ปรุง: เสริม ถ้าทั้งฟิลด์รหัส การส่งเสริมการขาย และ รหัสการส่งเสริมการขายเป้าหมาย ถูกตั้งค่า ข้อผิดพลาดจะถูกส่งกลับสําหรับเรกคอร์ดนี้ในไฟล์จํานวนมาก ถ้าไม่มีการตั้งค่าสําหรับการอัปเดต การตั้งค่านี้จะไม่ถูกเปลี่ยนแปลง ถ้าคุณตั้งค่าฟิลด์นี้เป็นสตริง delete_value
ลบ: อ่านอย่างเดียว