Feedelementdatensatz – Massenvorgang

Definiert ein Feedelement, das heruntergeladen und in eine Massendatei hochgeladen werden kann.

Tipp

Eine Übersicht über die Verwendung von Feeds und Feedelementen finden Sie in den technischen Anleitungen Ad Customizer Feeds, Auto Inventory Feeds und Seitenfeeds .

Hinweis

• Aktualisieren Sie Ihre erweiterten Textanzeigen bis zum 1. Februar 2023 auf reaktionsfähige Suchanzeigen. Nach diesem Datum können Sie keine neuen erweiterten Textanzeigen mehr erstellen oder bearbeiten. Weitere Informationen finden Sie unter Informationen zu reaktionsfähigen Suchanzeigen.
• Ihre geplanten Feeds werden weiterhin ausgeführt, und vorhandene erweiterte Textanzeigen mit Anzeigenanpassungsfeeds werden weiterhin bereitgestellt. Sie können Berichte zu deren Leistung anzeigen.
• Sie können Ihre vorhandenen Ad Customizer-Feeds weiterhin anhalten, ausführen oder entfernen. Andernfalls führen Versuche, vorhandene Anzeigenanpassungen für erweiterte Textanzeigen zu erstellen oder zu bearbeiten, zu einem CustomerNotEligibleForAdCustomizersFeed Fehler.
• Erfahren Sie mehr über diese Änderung.

Wenn Sie neue übergeordnete und untergeordnete Entitäten in derselben Massendatei erstellen, müssen die abhängigen Datensätze nach Abhängigkeiten gemäß der Hierarchie eingeschlossen werden:

1. Feed
2. Kampagnen
3. Anzeigengruppe
4. Feedelement

Sie können 100 Feeds pro Konto haben (diese maximale Anzahl umfasst alle Feedtypen), und die maximale Anzahl von Feedelementen (Zeilen) pro Konto beträgt 5 Millionen.

Sie können alle Feedelementdatensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von FeedItems in die Serviceanforderung DownloadCampaignsByAccountIds oder DownloadCampaignsByCampaignIds einschließen. Darüber hinaus muss die Downloadanforderung den EntityData-Bereich enthalten. Weitere Informationen zum Massendienst, einschließlich bewährter Methoden, finden Sie unter Massendownload und -upload.

Im folgenden Massen-CSV-Beispiel werden ein neuer Seitenfeed und ein Anzeigenanpassungsfeed mit jeweils einem Feedelement hinzugefügt.

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""}"

Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager zum Hochladen und Herunterladen des BulkFeedItem-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zum Analysieren der einzelnen Felder in der Massendatei zu schreiben.

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();

Für einen Feedelementdatensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

• Anzeigengruppe
• Anzeigenzeitplan
• Zielgruppen-ID
• Kampagnen
• Client-ID
• Benutzerdefinierte Attribute
• Geräteeinstellung
• Enddatum
• Id
• Schlüsselwort
• Übereinstimmungstyp
• Änderungszeit
• Übergeordnete ID
• Physische Absicht
• Startdatum
• Status
• Target
• Ziel-Anzeigengruppen-ID
• Zielkampagnen-ID

Anzeigengruppe

Der Name der Anzeigengruppe, die zum Ziel des Feedelements verwendet wird. Wenn dieses Feld festgelegt ist, ist das Feedelement nur für die angegebene Anzeigengruppe geeignet.

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Hinzufügen: Optional. Wenn Sie dieses Feld einschließen, muss auch das Feld Kampagne festgelegt werden, und die Anzeigengruppe muss innerhalb der angegebenen Kampagne vorhanden sein. Wenn sowohl die Felder Anzeigengruppe als auch Zielanzeigengruppen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben.
Aktualisieren: Optional. Wenn Sie dieses Feld einschließen, muss auch das Feld Kampagne festgelegt werden, und die Anzeigengruppe muss innerhalb der angegebenen Kampagne vorhanden sein. Wenn sowohl die Felder Anzeigengruppe als auch Zielanzeigengruppen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt

Anzeigenzeitplan

Die Liste der Tages- und Zeitbereiche, in denen das Feedelement mit Ihren Anzeigen angezeigt werden soll. Jeder Tag und Zeitbereich umfasst den geplanten Wochentag, die Start-/Endstunde und die Start-/Endminute. Jeder Tag und Zeitbereich wird durch linke und rechte Klammern eingeschlossen und von anderen Tages- und Zeitbereichen durch ein Semikolon (;) Trennzeichen) getrennt. Innerhalb jedes Tages und Zeitbereichs ist das Format Day[StartHour:StartMinue-EndHour:EndMinute].

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Die möglichen Werte von StartHour reichen von 00 bis 23, wobei 00 entspricht 12:00 Uhr und 12 :00 Uhr.

Die möglichen Werte von EndHour reichen von 00 bis 24, wobei 00 entspricht 12:00 Uhr und 12 :00 Uhr.

Die möglichen Werte von StartMinute und EndMinute liegen zwischen 00 und 60.

Im folgenden Beispiel werden Tages- und Zeitbereiche an Wochentagen von 9:00 bis 21:00 Uhr veranschaulicht: (Montag[09:00-21:00]);( Dienstag[09:00-21:00]); (Mittwoch[09:00-21:00]); (Donnerstag[09:00-21:00]); (Freitag[09:00-21:00])

Hinzufügen: Optional. Wenn Sie dieses Feld nicht festlegen, kann das Feedelement jederzeit während des Start- und Enddatums des Kalenders geplant werden.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Die einzelnen Tages- und Zeitbereiche können nicht aktualisiert werden. Sie können die Tages- und Zeitbereiche effektiv aktualisieren, indem Sie einen neuen Satz senden, der den vorherigen Satz ersetzen soll. Wenn Sie dieses Feld nicht festlegen, werden die vorhandenen Einstellungen beibehalten. Wenn Sie dieses Feld auf delete_value festlegen, entfernen Sie effektiv alle vorhandenen Tages- und Zeitbereiche.
Löschen: Schreibgeschützt

Zielgruppen-ID

Der Microsoft Advertising-Bezeichner der Zielgruppe, z. B. remarketing-Liste, die für das Ziel des Feedelements verwendet wird. Wenn dieses Feld festgelegt ist, ist das Feedelement nur für die angegebene Zielgruppe geeignet.

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Hinzufügen: Optional.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt

Kampagne

Der Name der Kampagne, die zum Ziel des Feedelements verwendet wird. Wenn dieses Feld festgelegt ist, ist das Feedelement nur für die angegebene Kampagne berechtigt.

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Hinzufügen: Optional. Wenn sowohl die Felder Kampagnen- als auch Zielkampagnen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben.
Aktualisieren: Optional. Wenn sowohl die Felder Kampagnen- als auch Zielkampagnen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt

Client-ID

Wird verwendet, um Datensätze in der Massenuploaddatei datensätzen in der Ergebnisdatei zuzuordnen. Der Wert dieses Felds wird vom Server nicht verwendet oder gespeichert. es wird einfach aus dem hochgeladenen Datensatz in den entsprechenden Ergebnisdatensatz kopiert. Es kann eine beliebige gültige Zeichenfolge sein, die eine Länge von bis zu 100 hat.

Hinzufügen: Optional
Aktualisieren: Optional
Löschen: Schreibgeschützt

Benutzerdefinierte Attribute

Die Attribute werden für jeden Feeduntertyp angepasst und definieren, welche Informationen zu Ihren Produkten oder Diensten Sie in Ihre Anzeigen einfügen möchten.

Für den Subtyp des AdCustomizerFeed-Feeds können Sie bis zu 100 benutzerdefinierte Attribute pro Feedelement einschließen, wobei jeder benutzerdefinierte Attributname eindeutig ist.

Für den Untertyp DynamicDataAutosListingFeed können Sie bis zu 100 benutzerdefinierte Attribute pro Feedelement einschließen, wobei jeder benutzerdefinierte Attributname eindeutig ist.

Für den Seitenfeedfeed-Untertyp können Sie ein oder zwei benutzerdefinierte Attribute pro Feedelement einschließen, wobei jeder benutzerdefinierte Attributname eindeutig ist.

Die benutzerdefinierten Attribute werden in der Massendatei als JSON-Zeichenfolge dargestellt. Weitere Informationen finden Sie unter feedAttributeType, isPartOfKey und name unten.

Hier finden Sie Benutzerdefinierte Beispielattribute, die Sie für einen Seitenfeed hochladen können.

Hinweis

In der durch Trennzeichen getrennten Massendatei müssen Sie die Liste der Attribute, jeden Attributschlüssel und jeden Attributwert mit einem zusätzlichen Satz doppelter Anführungszeichen einschließen, z. B. Die obige JSON-Zeichenfolge wird als "[{""name""":"Seiten-URL"","""feedAttributeType"":""Url"",""isPartOfKey"":true},{""name""name"" geschrieben.:""Custom Label"",""feedAttributeType"":""StringList""},{""name""":"Ad Title"",""feedAttributeType"":"String""}]".

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

Hier finden Sie Benutzerdefinierte Beispielattribute, die Sie für einen Anzeigenanpasserfeed hochladen können.

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

Hinzufügen: Erforderlich. Für einen Anzeigenanpasser und ein DynamicDataAutosListing-Feedelement müssen Sie mindestens ein Attribut mit einem gültigen Schlüssel-Wert-Paar festlegen. Für einen Seitenfeed müssen Sie mindestens ein Attribut mit dem Namen "Seiten-URL" festlegen.
Aktualisieren: Optional. Um alle vorhandenen benutzerdefinierten Attribute für das Feedelement beizubehalten, legen Oder lassen Sie dieses Feld leer. Wenn Sie dieses Feld festlegen, werden alle benutzerdefinierten Attribute ersetzt, die zuvor für dieses Feedelement festgelegt wurden.
Löschen: Schreibgeschützt

feedAttributeType

Der Datentyp jedes benutzerdefinierten Attributs. Sie definieren den Datentyp im Feeddatensatz und legen dann Werte im Feedelement fest. Solange jeder benutzerdefinierte Attributname innerhalb des Feeds eindeutig ist, können Sie mehrere Attribute mit demselben Datentyp definieren.

Es gibt vier verschiedene Datentypen feedAttributeType , die Sie für Ad Customizer-Feeds festlegen können:

feedAttributeType	Anwendungsfälle	Akzeptierte Feedelementwerte
Zeichenfolge	Produktnamen, Produktkategorien, Beschreibungen	Beliebige Buchstaben, Zahlen oder Symbole
Int64	Bestandsanzahl, Anzahl der verfügbaren Farben	Beliebige ganze Zahl
Kurs	Produktkosten, Rabatt	Beliebige Zahl (einschließlich Dezimalstellen) und gültige Währungszeichen
DateTime	Startzeit des Ereignisses, letzter Tag eines Verkaufs	jjjj/mm/tt HH:mm:ss Wenn sie am Anfang des Tages standardmäßig auf Mitternacht festgelegt ist, können Sie den HH:mm:ss-Teil weglassen.

Beispielsweise können wir die benutzerdefinierten Attribute eines Ad Customizer-Feeds definieren.

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

Anschließend können wir jeden Feednamen zuordnen, d. h. "DateTimeName", "Int64Name", "PriceName" und "StringName" im Feedelementupload:

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

Es gibt sechs verschiedene Datentypen feedAttributeType , die Sie für DynamicDataAutosListing-Feeds festlegen können:

feedAttributeType	Anwendungsfälle	Akzeptierte Feedelementwerte
Zeichenfolge	Fahrzeugname, Fahrzeugkategorie, Beschreibung	Beliebige Buchstaben, Zahlen oder Symbole
Int64	Fahrzeugjahr, Motor	Beliebige ganze Zahl
Kurs	Fahrzeugkosten, Rabatt	Beliebige Zahl (einschließlich Dezimalstellen) und gültige Währungszeichen
DateTime	Startzeit des Ereignisses, letzter Tag eines Verkaufs	jjjj/mm/tt HH:mm:ss Wenn sie am Anfang des Tages standardmäßig auf Mitternacht festgelegt ist, können Sie den HH:mm:ss-Teil weglassen.
Url	Enthält die URL Ihrer Website, die in den Feed eingeschlossen werden soll.	Sie müssen eine URL pro Feedelement angeben.
StringList	Bezeichnungen, mit denen Sie die URLs innerhalb des Feeds gruppieren können.	Sie können eine bis zehn benutzerdefinierte Bezeichnungen pro Feedelement einschließen. Jede benutzerdefinierte Bezeichnung wird als Listenelement in JSON-Notation dargestellt. Beispielsweise könnte der benutzerdefinierte Bezeichnungsteil des Feedelements als ""Benutzerdefinierte Bezeichnung""":[""Label_1_3001""",""Label_2_3001""]] geschrieben werden.

Beispielsweise können wir die benutzerdefinierten Attribute eines DynamicDataAutosListing-Feeds definieren.

[
	{
		"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"
	}
]

Anschließend können wir jeden Feednamen zuordnen, d. h. "DateTimeName", "Int64Name", "PriceName" und "StringName" im Feedelementupload :

{
	"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"
	],
}

Dies sind die Datentypen, die feedAttributeType Sie für Seitenfeeds festlegen können:

feedAttributeType	Anwendungsfälle	Akzeptierte Feedelementwerte
Zeichenfolge	Statische Überschrift, die anstelle der dynamisch generierten Überschrift angezeigt wird.	Alle Buchstaben, Zahlen oder Symbole bis zu 63 Zeichen. Sie können einen Anzeigentitel pro Feedelement einschließen.
StringList	Bezeichnungen, mit denen Sie die URLs innerhalb des Feeds gruppieren können.	Sie können eine bis zehn benutzerdefinierte Bezeichnungen pro Feedelement einschließen. Jede benutzerdefinierte Bezeichnung wird als Listenelement in JSON-Notation dargestellt. Beispielsweise könnte der benutzerdefinierte Bezeichnungsteil des Feedelements als ""Benutzerdefinierte Bezeichnung""":[""Label_1_3001""",""Label_2_3001""]] geschrieben werden.
Url	Enthält die URL Ihrer Website, die in den Feed eingeschlossen werden soll.	Sie müssen eine URL pro Feedelement angeben.

Beispielsweise können wir die benutzerdefinierten Attribute des Seitenfeeds definieren.

Hinweis

Ist feedAttributeType für Seitenfeeds optional. Wenn Sie festlegen feedAttributeType, muss er auf "Url" für "Seiten-URL", "StringList" für "Benutzerdefinierte Bezeichnung" und "String" für benannte Attribute " Anzeigentitel" festgelegt werden.

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

Anschließend können wir jeden Feednamen zuordnen, z. B. "Seiten-URL", "Benutzerdefinierte Bezeichnung" und "Anzeigentitel" im Feedelementupload :

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

isPartOfKey

Bestimmt isPartOfKey , ob die Werte für ein benutzerdefiniertes Attribut für alle Feedelementdatensätze, die zum Feed rollups führen, eindeutig sein müssen. Wenn auf isPartOfKey "true" festgelegt ist, müssen die Werte eindeutig sein. Andernfalls können Sie doppelte Werte für dasselbe benutzerdefinierte Attribut hochladen.

Für Anzeigenanpasserfeeds und Feedelemente wird eine Zeichenfolge mit dem Namen "Benutzerdefinierte ID" immer als eindeutiger Schlüssel behandelt, d. h. der isPartOfKey ist immer "true". Das Attribut "Benutzerdefinierte ID" ist derzeit die einzige Möglichkeit, einen eindeutigen Schlüssel für Ad Customizer-Feeds über die Microsoft Advertising-Webanwendung festzulegen. Mit der Massen-API haben Sie mehr Flexibilität, einen beliebigen Attributnamen als eindeutigen Schlüssel zu verwenden.

Für Seitenfeeds und Feedelemente wird die "Seiten-URL" immer als eindeutiger Schlüssel behandelt, d. h., der isPartOfKey ist immer "true".

Für DynamicDataAutosListing-Feeds und Feedelemente wird die "VehicleId" immer als eindeutiger Schlüssel behandelt, d. h. der isPartOfKey ist immer "true".

name

Das name -Attribut wird verwendet, um ein eindeutiges benutzerdefiniertes Attribut sowohl für den Feed als auch für das Feedelement zuzuordnen. So stellen Sie effektiv sicher, dass ein bestimmtes Feedelement ein Rollup zur gleichen "Spalte" im Feed führt. Im Ad Customizer-Beispiel oberhalb werden die Namen "DateTimeName", "Int64Name", "PriceName" und "StringName" sowohl im Feed als auch im Feedelement verwendet.

Geräteeinstellung

Dieses Feld bestimmt, ob das Feedelement auf mobilen Geräten oder allen Geräten angezeigt werden soll.

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Mögliche Werte sind All und Mobile, die sich von den werten unterscheiden, die im Kampagnenverwaltungsdienst verwendet werden.

SixMonths

In der Massendownload- und Upload-Ergebnisdatei ist dieses Feld nie leer. Wenn Sie keine Geräteeinstellung angegeben haben, wird der Standardwert Alle zurückgegeben.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt. Wenn Sie dieses Feld auf delete_value festlegen, setzen Sie effektiv auf den Standardwert Alle zurück.
Löschen: Schreibgeschützt

Enddatum

Die geplante Enddatumszeichenfolge des Feedelements, die als jjjj/mm/tt HH:mm:ss formatiert ist. Wenn sie am Anfang des Tages standardmäßig auf Mitternacht festgelegt ist, können Sie den HH:mm:ss-Teil weglassen.

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Das Enddatum ist inklusive. Wenn Sie dieses Feld beispielsweise auf 31.12.2020 00:00:00:00 festlegen, ist das Feedelement am 31.12.2020 um 12:00 Uhr nicht mehr berechtigt.

Hinzufügen: Optional. Wenn Sie kein Enddatum angeben, wird das Feedelement weiterhin übermittelt, es sei denn, Sie halten die zugehörigen Kampagnen, Anzeigengruppen oder Anzeigen an.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Das Enddatum kann verkürzt oder verlängert werden, solange das Startdatum entweder NULL ist oder vor dem neuen Enddatum liegt. Wenn Sie dieses Feld nicht festlegen, werden die vorhandenen Einstellungen beibehalten. Wenn Sie dieses Feld auf delete_value festlegen, entfernen Sie effektiv das Enddatum, und das Feedelement wird weiterhin zugestellt, es sei denn, Sie halten die zugehörigen Kampagnen, Anzeigengruppen oder Anzeigen an.
Löschen: Schreibgeschützt

Id

Der vom System generierte Bezeichner des Feeds.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

Schlüsselwort

Der Schlüsselwort (keyword) Text.

Der Text darf maximal 100 Zeichen enthalten.

Sie sollten die Schlüsselwort (keyword) im Gebietsschema der Sprache der Zielkampagne oder Anzeigengruppe angeben.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Übereinstimmungstyp

Der Typ der Übereinstimmung zum Vergleichen der Schlüsselwort (keyword) und des Suchbegriffs des Benutzers.

Die unterstützten Übereinstimmungstypwerte für eine Schlüsselwort (keyword) sind Breit, Exakt und Ausdruck.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Änderungszeit

Das Datum und die Uhrzeit der letzten Aktualisierung der Entität. Der Wert wird in UTC (Coordinated Universal Time) angegeben.

Hinweis

Der Datums- und Uhrzeitwert gibt das Datum und die Uhrzeit auf dem Server und nicht auf dem Client an. Informationen zum Format von Datum und Uhrzeit finden Sie unter dateTime-Eintrag in Primitive XML-Datentypen.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Übergeordnete ID

Der vom System generierte Bezeichner des übergeordneten Feeds.

Die benutzerdefinierten Attribute und der Untertyp des übergeordneten Feeds bestimmen, welche benutzerdefinierten Attribute für dieses Feedelement gültig sind. Derzeit werden Ad Customizer-Feeds und Seitenfeeds unterstützt, und in Zukunft könnten weitere Feedtypen hinzugefügt werden.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Physische Absicht

Bestimmt, ob sich eine Person physisch am Zielspeicherort befinden muss, damit das Feedelement berechtigt ist.

Standardmäßig kann das Feedelement Personen angezeigt werden, die in Ihrem Zielspeicherort nach Seiten suchen oder diese anzeigen. Legen Sie dieses Feld auf PeopleIn fest, wenn das Feedelement nur Personen angezeigt werden soll, die sich physisch am Zielstandort befinden.

Hinzufügen: Optional. Wenn Sie dieses Feld festlegen, muss auch der Zielspeicherort festgelegt werden.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt. Wenn Sie dieses Feld auf delete_value festlegen, setzen Sie effektiv auf den Standardwert PeopleIn zurück.
Löschen: Schreibgeschützt

Anfangstermin

Die geplante Startdatumszeichenfolge des Feedelements, die als jjjj/mm/tt HH:mm:ss formatiert ist. Wenn sie am Anfang des Tages standardmäßig auf Mitternacht festgelegt ist, können Sie den HH:mm:ss-Teil weglassen.

Das Startdatum ist inklusive. Wenn Sie dieses Feld beispielsweise auf 15.06.2020 00:00:00:00 festlegen, wird das Feedelement am 15. Juni 2020 um 12:00 Uhr berechtigt.

Hinzufügen: Optional. Wenn Sie kein Startdatum angeben, kann das Feedelement sofort während des Tages und der Zeitbereiche geplant werden.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Das Startdatum kann verkürzt oder verlängert werden, solange das Enddatum entweder NULL ist oder nach dem neuen Startdatum liegt. Wenn Sie dieses Feld nicht festlegen, werden die vorhandenen Einstellungen beibehalten. Wenn Sie dieses Feld auf delete_value festlegen, entfernen Sie effektiv das Startdatum, und das Feedelement ist sofort berechtigt, während des Tages und der Zeitbereiche geplant zu werden.
Löschen: Schreibgeschützt

Status

Die status des Feedelements.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.

Ziel

Der Bezeichner des Speicherorts, der zum Ziel des Feedelements verwendet wird. Wenn dieses Feld festgelegt ist, ist das Feedelement nur für den angegebenen Speicherort geeignet.

Wenn Sie nur Personen physisch an einem Ort ansprechen möchten, müssen Sie auch das Feld Physische Absicht festlegen.

Der Standortbezeichner entspricht dem Feld Standort-ID der Datei mit den geografischen Standorten. Weitere Informationen finden Sie unter Geografische Standortcodes und GetGeoLocationsFileUrl.

Hinzufügen: Optional
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt

Ziel-Anzeigengruppen-ID

Der Bezeichner der Anzeigengruppe, die zum Ziel des Feedelements verwendet wird. Wenn dieses Feld festgelegt ist, ist das Feedelement nur für die angegebene Anzeigengruppe geeignet.

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Hinzufügen: Optional. Wenn Sie auch das Feld Kampagne festlegen (nicht erforderlich), muss die Anzeigengruppe innerhalb der angegebenen Kampagne vorhanden sein. Wenn sowohl die Felder Anzeigengruppe als auch Zielanzeigengruppen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben.
Aktualisieren: Optional. Wenn Sie auch das Feld Kampagne festlegen (nicht erforderlich), muss die Anzeigengruppe innerhalb der angegebenen Kampagne vorhanden sein. Wenn sowohl die Felder Anzeigengruppe als auch Zielanzeigengruppen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt

Zielkampagnen-ID

Der Bezeichner der Kampagne, die zum Ziel des Feedelements verwendet wird. Wenn dieses Feld festgelegt ist, ist das Feedelement nur für die angegebene Kampagne berechtigt.

Hinweis

Dieses Feld gilt nur für Anzeigenanpassungsfeeds.

Hinzufügen: Optional. Wenn sowohl die Felder Kampagnen- als auch Zielkampagnen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben.
Aktualisieren: Optional. Wenn sowohl die Felder Kampagnen- als auch Zielkampagnen-ID festgelegt sind, wird für diesen Datensatz in der Massendatei ein Fehler zurückgegeben. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Feld auf die delete_value Zeichenfolge festlegen, wird die vorherige Einstellung entfernt.
Löschen: Schreibgeschützt