Freigeben über

Kombinierter Listendatensatz – Massenvorgang

  • Artikel

Definiert eine kombinierte Liste, die heruntergeladen und in eine Massendatei hochgeladen werden kann.

Eine kombinierte Liste ist eine Zielgruppe, die aus einer Kombination mehrerer vorhandener Zielgruppen erstellt wird.

Tipp

Eine Übersicht und weitere Informationen zu Zielgruppen finden Sie im technischen Leitfaden zu Zielgruppen-APIs .

Sie können alle Kombinierten Listendatensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CombinedLists 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 kombinierte Liste hinzugefügt.

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)

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 BulkCombinedList-Objekts verwenden, anstatt die Dienstvorgänge direkt aufzurufen und benutzerdefinierten Code zu schreiben, um jedes Feld in der Massendatei zu analysieren.

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

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

Zielgruppe

Der Name der kombinierten Liste.

Der Name darf maximal 128 Zeichen lang sein.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Größe des Zielgruppennetzwerks

Die Gesamtzahl der Personen, die aktive Mitglieder dieser Zielgruppe im Zielgruppennetzwerk sind. Dadurch erhalten Sie eine Vorstellung davon, wie viele Benutzer des Audience-Netzwerks Sie ansprechen können.

Die Zielgruppe muss mindestens 300 Personen haben, bevor Microsoft Advertising es für Optimierungen verwendet.

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

Größe der Zielgruppensuche

Die Gesamtzahl der Personen, die aktive Mitglieder dieser Zielgruppe im Suchnetzwerk sind. Dadurch erhalten Sie eine Vorstellung davon, wie viele Suchbenutzer Sie als Ziel verwenden können.

Die Zielgruppe muss mindestens 300 Personen haben, bevor Microsoft Advertising es für Optimierungen verwendet.

Diese Eigenschaft ist bis zu 24 Stunden leer, während die Zielgruppe erstellt wird, z. B. wenn Sie die kombinierte Listenmitgliedschaftsdauer, Regel oder Tag-ID hinzufügen oder aktualisieren.

Diese Eigenschaft ist leer, wenn das der kombinierten Liste zugeordnete UET-Tag den status "Nicht überprüft" oder "Inaktiv" aufweist, da die kombinierte Liste keine Kundeninformationen von Ihrer Website empfangen kann, die sie zum Erstellen der Liste benötigt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt
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

Kombinationsregel

Eine Kombinationsregel enthält Bedingungen, mit denen bestimmt wird, wer ihrer kombinierten Liste hinzugefügt werden soll.

Sie können benutzerdefinierte Zielgruppen, Kundenlisten, Produktgruppen, ähnliche Zielgruppen und Remarketing-Listen kombinieren. Sie können keine anderen kombinierten Listen oder marktinternen Zielgruppen in eine kombinierte Liste aufnehmen.

Sie können maximal 1.000 kombinierte Listen pro Anzeigenkonto und bis zu 5.000 pro Kunde erstellen. Die Kombinationsregel jeder Liste kann bis zu 100 Sätze logischer Bedingungen enthalten, und jede Gruppe kann bis zu 100 Zielgruppen-IDs enthalten.

Mit einigen unten beschriebenen Einschränkungen können Sie Zielgruppen mithilfe dieser logischen Operatoren kombinieren:

  • ODER: Dies schließt Kunden ein, die in einer dieser Zielgruppenlisten enthalten sind.
  • UND: Dies schließt nur Kunden ein, die in jeder einzelnen dieser Zielgruppenlisten enthalten sind.
  • NICHT: Dadurch werden Kunden ausgeschlossen, die in einer dieser Zielgruppenlisten enthalten sind.

Ein logischer Bedingungssatz bezieht sich auf eine Gruppe von Zielgruppen-IDs, die durch OR, AND oder NOT qualifiziert sind. In der Massen-API wird jeder Satz durch ein kaufmännisches und-zeichen (&) getrennt.

Hier sind beispielsweise 10 Sätze für eine Kombinationsregel mit jeweils einer Zielgruppen-ID: NOT(1)&AND(2)&OR(3)&NOT(4)&AND(5)&OR(6)&NOT(7)&AND(8)&OR(9)&NOT(10)

Hier ist ein Beispiel von 10 Sätzen für eine Kombinationsregel: jeweils mit zwei Zielgruppen-IDs: 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)

Die Auswertung des logischen Ausdrucks bestimmt, wer der kombinierten Liste hinzugefügt wird. Mehrere Kombinationen werden immer mit einer AND-Funktion kombiniert. Dies bedeutet, dass ein Kunde alle Kriterien jeder Kombination erfüllen muss, um in dieser benutzerdefinierten Zielgruppenliste für Kombinationen angezeigt zu werden. Angenommen, die Kombinationsregel ist auf NOT(123.234)&NOT(345.456)&AND(567.678)&OR(789.890)&OR(987.876) festgelegt. Die kombinierte Liste enthält Kunden, die sich a) sowohl in der Zielgruppe 567 als auch 678 befinden, und b) sich entweder in der Zielgruppe 789 oder 890 befinden und c) entweder in der Zielgruppe 987 oder 876 sind, es sei denn, d) der Kunde befindet sich in der Zielgruppe 123, 234, 345 oder 456.

Eine kombinierte Liste muss mindestens eine Zielgruppe enthalten, die die Operatoren OR oder AND verwendet. Eine kombinierte Liste kann nicht nur den NOT-Operator verwenden. In diesem Fall sollten Sie stattdessen Zielgruppenausschlüsse verwenden.

Benutzerdefinierte Zielgruppen und Kundenlisten können nicht mit anderen Zielgruppentypen kombiniert werden.

Ähnliche Zielgruppen können nicht über die Operatoren AND oder NOT kombiniert werden. Ähnliche Zielgruppen können nur in einer einzelnen OR-Bedingung verwendet werden. Anders ausgedrückt: Es kann nur eine Zielgruppengruppe geben, die ähnliche Zielgruppen enthält, und diese Gruppe muss den OR-Operator verwenden.

Doppelte Zielgruppen sind zulässig, obwohl dieselbe Zielgruppen-ID nicht über den OPERATOR AND und NOT kombiniert werden kann.

Wenn Sie eine neue Zielgruppe zusammen mit dieser kombinierten Liste im gleichen Massenupload erstellen, kann die Kombinationsregel einen negativen Bezeichner enthalten, der dem Id-Feld der anderen neuen Zielgruppe entspricht. Wenn Sie beispielsweise eine neue Remarketing-Liste erstellen und diese auch in die kombinierte Liste aufnehmen möchten, können Sie den Id-Wert der Remarketing-Liste auf -1 festlegen. Im gleichen Massenupload können Sie mithilfe von -1 in der Kombinationsregel auf die neue Remarketing-Liste verweisen, z. B. NOT(123,234)&AND(345,456)&OR(-1.678). Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.

Wenn Sie eine neue Zielgruppe zusammen mit dieser kombinierten Liste im gleichen Massenupload erstellen, kann die Kombinationsregel einen negativen Verweisschlüssel auf das negative Id-Feld der anderen neuen Zielgruppe enthalten. Sie können auch einen logischen Verweisschlüssel für das Feld Zielgruppe (Name) der anderen neuen Zielgruppe verwenden.

  • Als Beispiel für die Verwendung eines negativen Verweisschlüssels fügen Sie im gleichen Massenupload eine neue Remarketing-Liste ein, bei der die ID auf -1 festgelegt ist. Verweisen Sie dann auf die neue Remarketing-Liste mit -1 in der Kombinationsregel, z. B. NOT(123,234)&AND(345,456)&OR(-1,678).
  • Als Beispiel für die Verwendung eines logischen Verweisschlüssels fügen Sie im selben Massenupload eine neue Remarketing-Liste ein, bei der der Zielgruppenname auf Meine neue Zielgruppe festgelegt ist. Verweisen Sie dann auf die neue Remarketing-Liste mit "Meine Zielgruppe" (in einfache Anführungszeichen eingeschlossen) in der Kombinationsregel, z. B. NOT(123,234)&AND(345,456)&OR('My New Audience',678).

Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.

Hinzufügen: Erforderlich
Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.
Löschen: Schreibgeschützt

Beschreibung

Die Beschreibung der kombinierten Liste. Verwenden Sie eine Beschreibung, um sich daran zu erinnern, welche Zielgruppe Sie mit dieser kombinierten Liste ansprechen.

Die Beschreibung darf maximal 1.024 Zeichen enthalten.

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

Id

Der vom System generierte Bezeichner der kombinierten Liste.

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 des Kontos oder Kunden. Wenn der Bereich auf Konto festgelegt ist, ist dies die Konto-ID und andernfalls die Kunden-ID.

Hinzufügen: Optional
Aktualisieren: Schreibgeschützt. Sie können die übergeordnete ID nicht ändern.
Löschen: Schreibgeschützt

Bereich

Bereich definiert, welche Konten diese kombinierte Liste verwenden können. Wenn der Bereich auf Konto festgelegt ist, kann die kombinierte Liste nur Kampagnen und Anzeigengruppen innerhalb eines angegebenen Kontos (übergeordnete ID) zugeordnet werden. Wenn scope auf Customer festgelegt ist, kann die kombinierte Liste allen Kampagnen und Anzeigengruppen in allen Konten des Kunden zugeordnet werden.

Hinzufügen: Erforderlich
Aktualisieren: Schreibgeschützt. Sie können den Bereich nicht ändern.
Löschen: Schreibgeschützt

Status

Die kombinierte Liste status.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Optional. Der Standardwert ist Aktiv.
Aktualisieren: Schreibgeschützt
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.

Unterstützte Kampagnentypen

Die durch Semikolons getrennte Liste von Kampagnentypen, die diese kombinierte Liste unterstützen.

Unterstützte Werte sind Audience, DynamicSearchAds, Search und Shopping. Möglicherweise werden in Zukunft neue Kampagnentypen hinzugefügt, sodass Sie keine Abhängigkeit von einem festen Satz von Werten annehmen sollten.

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