Negativer Benutzerdefinierter Benutzergruppenzuordnungsdatensatz der Kampagne – Massenvorgang
Definiert eine negative Benutzerdefinierte Zielgruppenzuordnung für Kampagnen, die in einer Massendatei hochgeladen und heruntergeladen werden kann.
Zielgruppenziele können nicht sowohl auf Kampagnen- als auch auf Anzeigengruppenebene festgelegt werden. Wenn Sie Zielgruppenkriterien auf Kampagnenebene auf Gebotsebene festlegen, können Sie keine Zielgruppenkriterien auf Anzeigengruppenebene festlegen. Zielgruppenausschlüsse können sowohl auf Kampagnen- als auch auf Anzeigengruppenebene festgelegt werden. Microsoft Advertising wendet eine Vereinigung von Ausschlüssen auf Kampagnen- und Anzeigengruppenebene an.
Tipp
Eine Übersicht und weitere Informationen zu Zielgruppen finden Sie im technischen Leitfaden zu Zielgruppen-APIs .
Sie können alle Kampagnen negative Custom Audience Association-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignNegativeCustomAudienceAssociations 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 wird eine neue Kampagne negative Custom Audience Association hinzugefügt, wenn ein gültiger Wert für die übergeordnete ID angegeben wird.
Type,Status,Id,Parent Id,Campaign,Ad Group,Client Id,Modified Time,Bid Adjustment,Name,Audience Id,Audience
Format Version,,,,,,,,,6.0,,
Campaign Negative Custom Audience Association,Paused,,-1111,,,ClientIdGoesHere,,,,CustomAudienceIdHere,My Custom Audience
Wenn Sie die Bing Ads SDKs für .NET, Java oder Python verwenden, können Sie Zeit sparen, indem Sie bulkServiceManager verwenden, um das BulkCampaignNegativeCustomAudienceAssociation-Objekt hochzuladen und herunterzuladen, 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 BulkCampaignNegativeCustomAudienceAssociation
var bulkCampaignNegativeCustomAudienceAssociation = new BulkCampaignNegativeCustomAudienceAssociation
{
// 'Campaign' column header in the Bulk file
CampaignName = null,
// Map properties in the Bulk file to the
// NegativeCampaignCriterion object of the Campaign Management service.
NegativeCampaignCriterion = new NegativeCampaignCriterion
{
// 'Parent Id' column header in the Bulk file
CampaignId = campaignIdKey,
Criterion = new AudienceCriterion
{
// 'Audience Id' column header in the Bulk file
AudienceId = customAudienceIdKey,
},
// 'Id' column header in the Bulk file
Id = null,
// 'Status' column header in the Bulk file
Status = CampaignCriterionStatus.Paused
},
// 'Campaign' column header in the Bulk file
CampaignName = null,
// 'Client Id' column header in the Bulk file
ClientId = "ClientIdGoesHere",
// 'Audience' column header in the Bulk file
AudienceName = null,
};
uploadEntities.Add(bulkCampaignNegativeCustomAudienceAssociation);
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 kampagnen negativen Custom Audience Association-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.For a Campaign Negative Custom Audience Association record, the following attribute fields are available in the Bulk File Schema.
Zielgruppe
Der Name der benutzerdefinierten Zielgruppe.
Dieses Massenfeld wird dem Feld Zielgruppe des Custom Audience-Datensatzes zugeordnet.
Hinzufügen: Schreibgeschützt und für einige Anwendungsfälle erforderlich. Sie müssen entweder das Feld Zielgruppe oder Zielgruppen-ID angeben. Wenn Sie neue Kampagnen negative custom Audience-Zuordnungen mit neuen benutzerdefinierten Zielgruppen in derselben Massendatei hinzufügen und das Feld Zielgruppen-ID nicht festlegen, muss dieses Zielgruppenfeld als logischer Schlüssel auf denselben Wert wie das Feld Zielgruppe des Custom Audience-Datensatzes festgelegt werden. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Zielgruppen-ID
Der Microsoft Advertising-Bezeichner der benutzerdefinierten Zielgruppe, die der Kampagne zugeordnet ist.
Dieses Massenfeld wird dem Id-Feld des Custom Audience-Datensatzes zugeordnet.
Hinzufügen: Schreibgeschützt und für einige Anwendungsfälle erforderlich. Sie müssen entweder das Feld Zielgruppe oder Zielgruppen-ID angeben. Wenn Sie das Feld Zielgruppen-ID festlegen, müssen Sie entweder einen vorhandenen benutzerdefinierten Zielgruppenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Custom Audience-Datensatzes entspricht. Wenn das Feld Zielgruppen-ID nicht festgelegt ist, müssen Sie das Feld Zielgruppe als logischen Schlüssel auf denselben Wert wie das Feld Zielgruppe des Custom Audience-Datensatzes festlegen. Jede dieser Optionen wird empfohlen, wenn Sie neue kampagnen negative benutzerdefinierte Zielgruppenzuordnungen mit neuen benutzerdefinierten Zielgruppen in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt
Kampagne
Der Name der Kampagne, die der benutzerdefinierten Zielgruppe zugeordnet ist.
Hinzufügen: Schreibgeschützt und erforderlich
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Hinweis
Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Kampagne angeben.
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
Id
Der vom System generierte Bezeichner für die Zuordnung zwischen einer Kampagne und einer benutzerdefinierten Zielgruppe.
Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Ä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 der Kampagne, die der benutzerdefinierten Zielgruppe zugeordnet ist.
Dieses Massenfeld wird dem Feld Id des Kampagnendatensatzes zugeordnet.
Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Kampagnenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Kampagnendatensatzes entspricht. Dies wird empfohlen, wenn Sie benutzerdefinierte Zielgruppen einer neuen Kampagne in derselben Massendatei zuordnen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich
Hinweis
Zum Hinzufügen, Aktualisieren und Löschen müssen Sie entweder das Feld Übergeordnete ID oder Kampagne angeben.
Status
Die Zuordnung status.
Mögliche Werte sind Aktiv oder Gelöscht.
Hinzufügen: Optional. Der Standard status Wert ist Aktiv.
Aktualisieren: Optional
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.