Ad Group Combined List Association Record – Bulk

Definiert eine kombinierte Listenzuordnung für Anzeigengruppen, die in eine 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 Ad Group Combined List Association-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von AdGroupCombinedListAssociations 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 Listenzuordnung für anzeigende Gruppen hinzugefügt, wenn ein gültiger Wert für ü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,,
Ad Group Combined List Association,Paused,,-1111,,,ClientIdGoesHere,,10,,CombinedListIdHere,My Combined List

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 BulkAdGroupCombinedListAssociation-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 BulkAdGroupCombinedListAssociation
var bulkAdGroupCombinedListAssociation = new BulkAdGroupCombinedListAssociation
{
    // 'Ad Group' column header in the Bulk file
    AdGroupName = null,

    // Map properties in the Bulk file to the 
    // BiddableAdGroupCriterion object of the Campaign Management service.
    BiddableAdGroupCriterion = new BiddableAdGroupCriterion
    {
        // 'Parent Id' column header in the Bulk file
        AdGroupId = adGroupIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = combinedListIdKey,
        },
        // 'Bid Adjustment' column header in the Bulk file
        CriterionBid = new BidMultiplier
        {
            Multiplier = 10
        },
        // 'Id' column header in the Bulk file
        Id = null,
        // 'Status' column header in the Bulk file
        Status = AdGroupCriterionStatus.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(bulkAdGroupCombinedListAssociation);

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 Listenzuordnungsdatensatz einer Anzeigengruppe sind die folgenden Attributfelder im Massendateischema verfügbar.

• Anzeigengruppe
• Zielgruppe
• Zielgruppen-ID
• Gebotsanpassung
• Kampagnen
• Client-ID
• Id
• Änderungszeit
• Übergeordnete ID
• Status

Anzeigengruppe

Der Name der Anzeigengruppe, die der kombinierten Liste 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 Anzeigengruppe angeben.

Zielgruppe

Der Name der kombinierten Liste.

Dieses Massenfeld wird dem Feld Zielgruppe des Datensatzes "Kombinierte Liste " 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 kombinierte Listenzuordnungen mit neuen kombinierten Listen in derselben Massendatei hinzufügen und das Feld Zielgruppen-ID nicht festlegen, muss dieses Feld Zielgruppe als logischer Schlüssel auf denselben Wert wie das Feld Zielgruppe des Datensatzes kombinierte Liste festgelegt werden. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Zielgruppen-ID

Der Microsoft Advertising-Bezeichner der kombinierten Liste, die der Anzeigengruppe zugeordnet ist.

Dieses Massenfeld wird dem Feld Id des Datensatzes kombinierter Liste 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 kombinierten Listenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Datensatzes der kombinierten Liste 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 Datensatzes der kombinierten Liste festlegen. Jede dieser Optionen wird empfohlen, wenn Sie neue kombinierte Listenzuordnungen für Anzeigengruppen mit neuen kombinierten Listen in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Gebotsanpassung

Der Prozentsatz, den Sie für die kombinierte Liste erhöhen/verringern möchten.

Unterstützte Werte sind negative neunzig (-90,00) bis positive neunhundert (900,00).

Wichtig

Wenn nicht angegeben, ist der Standardwert für die Gebotsanpassung 0. Der Standardwert kann geändert werden.

Wichtig

Microsoft Advertising wendet keine Gebotserhöhungen an, bis die zugeordnete kombinierte Liste mindestens 1.000 Benutzer enthält. Wenn jemand als Teil mehrerer kombinierter Listen qualifiziert ist UND die kombinierten Listen derselben Anzeigengruppe mit unterschiedlichen Gebotsanpassungen zugeordnet sind, wird die höchste Gebotsanpassung angewendet. Weitere Informationen zu Kombiniert in der kostenpflichtigen Suche finden Sie unter Erreichen Ihrer Zielgruppe.

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

Kampagne

Der Name der Kampagne, die die Anzeigengruppe enthält.

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

Id

Der vom System generierte Bezeichner für die Zuordnung zwischen einer Anzeigengruppe und einer 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 der Anzeigengruppe, die der kombinierten Liste zugeordnet ist.

Dieses Massenfeld wird dem Feld Id des Anzeigengruppendatensatzes zugeordnet.

Hinzufügen: Schreibgeschützt und Erforderlich. Sie müssen entweder einen vorhandenen Anzeigengruppenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Anzeigengruppendatensatzes entspricht. Dies wird empfohlen, wenn Sie kombinierte Listen einer neuen Anzeigengruppe 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 Anzeigengruppe angeben.

Status

Die Zuordnung status.

Mögliche Werte sind Aktiv, Angehalten 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.