Freigeben über

Benutzerdefinierter Zielgruppendatensatz – Massenvorgang

  • Artikel

Definiert eine benutzerdefinierte Zielgruppe, die heruntergeladen und in eine Massendatei hochgeladen werden kann.

Hinweis

Für den Upload werden nur Aktualisierungen der Felder Zielgruppe (Zielgruppenname) und Beschreibung unterstützt. Sie können mithilfe der Bing Ads-API löschen, aber keine benutzerdefinierte Zielgruppe hinzufügen. Abgesehen davon können Sie benutzerdefinierte Zielgruppenzuordnungen und -ausschlüsse hinzufügen und löschen.

Eine benutzerdefinierte Zielgruppe ist eine Art Remarketing-Liste, die mithilfe Ihrer eigenen Kundendaten generiert wird, um umfangreichere Benutzersegmente zu erstellen. Sie können benutzerdefinierte Zielgruppen in Verbindung mit Ihren Remarketing-Listen verwenden, in der Regel über Ihren Datenverwaltungsanbieter (Data Management Provider, DMP). Wenn Ihr DMP eine Verbindung mit unserem Custom Audience-Feature herstellt, können Sie Ihre benutzerdefinierten Zielgruppen für suchorientiertes Remarketing in Microsoft Advertising importieren. Sie können benutzerdefinierte Zielgruppen getrennt vom Remarketing verwenden, ohne dass UET erforderlich ist.

Tipp

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

Sie können alle Custom Audience-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CustomAudiences 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 Beispiel für Massen-CSV wird die Beschreibung einer benutzerdefinierten Zielgruppe aktualisiert. Hinweis: Für eine benutzerdefinierte Zielgruppe ist die Mitgliedschaftsdauer in der Microsoft Advertising-Webanwendung nicht festgelegt, und Microsoft Advertising verschiebt sich auf die Einstellungen Ihres benutzerdefinierten Zielgruppenanbieters.

Type,Status,Id,Parent Id,Client Id,Modified Time,Name,Description,Scope,Audience,Supported Campaign Types
Format Version,,,,,,6.0,,,,,
Custom Audience,Active,IdHere,ParentIdHere,ClientIdGoesHere,,,Updated Custom Audience Description,30,Account,Custom Audience,Search;DynamicSearchAds;Shopping;Audience

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 BulkCustomAudience-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 BulkCustomAudience
var bulkCustomAudience = new BulkCustomAudience
{
    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // CustomAudience object of the Campaign Management service.
    CustomAudience = new CustomAudience
    {
        // 'Audience Network Size' column header in the Bulk file
        AudienceNetworkSize = null,
        // 'Description' column header in the Bulk file
        Description = "Updated Custom Audience Description",
        // 'Id' column header in the Bulk file
        Id = customAudienceIdKey,
        // 'Audience' column header in the Bulk file
        Name = null,
        // 'Parent Id' column header in the Bulk file
        ParentId = accountIdKey,
        // 'Scope' column header in the Bulk file
        Scope = null,
        // '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(bulkCustomAudience);

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 Custom Audience-Datensatz sind die folgenden Attributfelder im Massendateischema verfügbar.

Zielgruppe

Der Name der benutzerdefinierten Zielgruppe.

Der Name darf maximal 128 Zeichen lang sein.

Hinzufügen: Nicht unterstützt
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: Nicht unterstü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. Wenn Sie beispielsweise neue benutzerdefinierte Zielgruppen aus DMP importiert haben, dauert es 24 Stunden, die Zielgruppe zu erstellen, und in der Zwischenzeit ist diese Eigenschaft leer.

Hinzufügen: Nicht unterstü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: Nicht unterstützt
Aktualisieren: Optional
Löschen: Schreibgeschützt

Beschreibung

Die Beschreibung der benutzerdefinierten Zielgruppe. Verwenden Sie eine Beschreibung, um sich daran zu erinnern, für welche Zielgruppe Sie diese benutzerdefinierte Zielgruppe verwenden.

Die Beschreibung darf maximal 1.024 Zeichen enthalten.

Hinzufügen: Nicht unterstützt
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 benutzerdefinierten Zielgruppe.

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

Mitgliedschaftsdauer

Die Mitgliedschaftsdauer bestimmt, wie weit microsoft Advertising nach Aktionen sucht, die Ihrer benutzerdefinierten Zielgruppendefinition entsprechen, um Ihrer Liste Personen hinzuzufügen. Für eine benutzerdefinierte Zielgruppe ist die Mitgliedschaftsdauer in der Microsoft Advertising-Webanwendung nicht festgelegt, und Microsoft Advertising verschiebt sich an die Einstellungen ihres benutzerdefinierten Zielgruppenanbieters.

Wenn Sie die benutzerdefinierte Zielgruppe über die Bing Ads-API anfordern, ist die zurückgegebene Mitgliedschaftsdauer NULL.

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstü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: Nicht unterstützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Übergeordnete ID

Der Microsoft Advertising-Bezeichner des Kunden, der die benutzerdefinierte Zielgruppe enthält.

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

Bereich

Bereich definiert, welche Konten diese benutzerdefinierte Zielgruppe verwenden können. Für eine benutzerdefinierte Zielgruppe ist der einzige unterstützte Bereich Der Kunde, und die benutzerdefinierte Zielgruppe kann allen Kampagnen und Anzeigengruppen in allen Konten des Kunden zugeordnet werden.

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

Status

Die benutzerdefinierte Zielgruppe status.

Mögliche Werte sind Aktiv oder Gelöscht.

Hinzufügen: Nicht unterstützt
Aktualisieren: Schreibgeschützt
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden.

Unterstützte Kampagnentypen

Die durch Semikolons getrennte Liste der Kampagnentypen, die diese benutzerdefinierte Zielgruppe 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: Nicht unterstützt
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt