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

บทความ
12/21/2023

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

เคล็ดลับ

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

หมายเหตุ

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

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

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

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

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

Type,Status,Id,Parent Id,Sub Type,Campaign,Ad Group,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 เพื่ออัปโหลดและดาวน์โหลดวัตถุ BulkFeed แทนที่จะเรียกใช้การดําเนินการบริการโดยตรงและเขียนโค้ดแบบกําหนดเองเพื่อแยกวิเคราะห์แต่ละเขตข้อมูลในไฟล์จํานวนมาก

var uploadEntities = new List<BulkEntity>();

// Map properties in the Bulk file to the BulkFeed
var bulkAdCustomizerFeed = new BulkFeed
{
    // 'Parent Id' column header in the Bulk file
	AccountId = 0,

	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = new[]
	{
		// Each FeedCustomAttributeContract is represented as a JSON list item in the Bulk file.
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "DateTime",
			Name = "DateTimeName"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "Int64",
			Name = "Int64Name"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "Price",
			Name = "PriceName"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "String",
			Name = "StringName",
			IsPartOfKey = true
		}
	},

	// 'Id' column header in the Bulk file
	Id = adCustomizerFeedIdKey,
	// 'Feed Name' column header in the Bulk file
	Name = "My AdCustomizerFeed " + DateTime.UtcNow,
	// 'Sub Type' column header in the Bulk file
	SubType = "AdCustomizerFeed",
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkAdCustomizerFeed);

// Map properties in the Bulk file to the BulkFeed
var bulkPageFeed = new BulkFeed
{
	// 'Parent Id' column header in the Bulk file
	AccountId = 0,

	// 'Custom Attributes' column header in the Bulk file
	CustomAttributes = new []
	{
		// Each FeedCustomAttributeContract is represented as a JSON list item in the Bulk file.
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "Url",
			Name = "Page Url"
		},
		new FeedCustomAttributeContract
		{
			FeedAttributeType = "StringList",
			Name = "Custom Label"
		}
	},
	
	// 'Id' column header in the Bulk file
	Id = pageFeedIdKey,                    
	// 'Feed Name' column header in the Bulk file
	Name = "My PageFeed " + DateTime.UtcNow,
	// 'Sub Type' column header in the Bulk file
	SubType = "PageFeed",
	// 'Client Id' column header in the Bulk file
	ClientId = "ClientIdGoesHere",
	// 'Status' column header in the Bulk file
	Status = Status.Active
};

uploadEntities.Add(bulkPageFeed);

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 ไคลเอ็นต์

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

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

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

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

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

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

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

แอตทริบิวต์แบบกําหนดเองจะแสดงในไฟล์จํานวนมากเป็นสตริง 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"
	}
]

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

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": "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ถูกใช้เพื่อแมปแอตทริบิวต์แบบกําหนดเองที่แตกต่างกันทั้งรายการฟีดและฟีด นี่คือวิธีที่คุณมั่นใจได้ว่ารายการฟีดเฉพาะจะสะสมไปยัง "คอลัมน์" เดียวกันในฟีด ในตัวอย่างผู้กําหนดค่าโฆษณาด้านบน จะใช้ชื่อ "DateTimeName", "Int64Name", "PriceName" และ "StringName" ทั้งในรายการฟีดและตัวดึงข้อมูล

ชื่อตัวดึงข้อมูล

ชื่อของตัวดึงข้อมูล

ชื่อต้องไม่ซ้ํากัน (ไม่เทียบตรงตามตัวพิมพ์ใหญ่-เล็ก) ระหว่างตัวดึงข้อมูลทั้งหมดภายในบัญชี ชื่อสามารถมีอักขระได้สูงสุด 128 อักขระ

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

Id

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

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

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

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

หมายเหตุ

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

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

ID แม่

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

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

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

สถานะ

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

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

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

ชนิดย่อย

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

ค่าที่เป็นไปได้คือ:

PageFeed
AdCustomizerFeed
DynamicDataToursAndActivitiesFeed
DynamicDataCreditCardsFeed
DynamicDataCruisesFeed
DynamicDataHealthInsuranceFeed
DynamicDataProfessionalServiceFeed
DynamicDataMortgageLendersFeed
DynamicDataEventsFeed
DynamicDataHotelsAndVacationRentalsFeed
DynamicDataCustomFeed
DynamicDataAutosListingFeed

ค่าใหม่อาจได้รับการสนับสนุนในอนาคต ดังนั้นคุณต้องไม่พึ่งพาชุดค่าคงที่

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

แชร์ผ่าน

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

ID ไคลเอ็นต์

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

feedAttributeType

isPartOfKey

ชื่อ

ชื่อตัวดึงข้อมูล

Id

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

ID แม่

สถานะ

ชนิดย่อย

คำติชม

แหล่งทรัพยากรเพิ่มเติม