Kampagne in Market Audience Association Record – Bulk

Definiert eine Kampagne in Market Audience Association, die in eine Massendatei hochgeladen und heruntergeladen werden kann.

Hinweis

Dieses Feature ist in Australien, Kanada, Frankreich, Deutschland, Großbritannien und USA verfügbar.

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 Campaign In Market Audience Association-Datensätze im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignInMarketAudienceAssociations 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 Csv-Massenbeispiel wird eine neue Campaign In Market Audience Association 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,,
Campaign In Market Audience Association,Paused,,-1111,,,ClientIdGoesHere,,10,,InMarketAudienceIdHere,My In Market 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 BulkCampaignInMarketAudienceAssociation-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 BulkCampaignInMarketAudienceAssociation
var bulkCampaignInMarketAudienceAssociation = new BulkCampaignInMarketAudienceAssociation
{
    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.
    BiddableCampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,
        Criterion = new AudienceCriterion
        {
            // 'Audience Id' column header in the Bulk file
            AudienceId = inMarketAudienceIdKey,
        },
        // '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 = 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(bulkCampaignInMarketAudienceAssociation);

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

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

Zielgruppe

Der Name der Zielgruppe im Markt.

Dieses Massenfeld wird dem Feld Zielgruppe des Datensatzes In Market Audience zugeordnet.

Der Massen-API-Download gibt alle im Markt verfügbaren Zielgruppenzuordnungen zurück, unabhängig davon, ob die Im Marktzielgruppe aktiv oder gelöscht ist. Wenn die Zuordnung für eine gelöschte Marktzielgruppe gilt, wird dieses Feld auf denselben Wert wie das Feld Zielgruppen-ID festgelegt.

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 in Marktzielgruppenzuordnungen mit neuen marktinternen Zielgruppen 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 "In Market Audience " festgelegt werden. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Zielgruppen-ID

Der Microsoft Advertising-Bezeichner der Im-Market-Zielgruppe, die der Kampagne zugeordnet ist.

Dieses Massenfeld wird dem Id-Feld des Datensatzes In Market Audience 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 marktinternen Zielgruppenbezeichner oder einen negativen Bezeichner angeben, der dem Feld Id des übergeordneten Eintrags In Market Audience 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 In Market Audience festlegen. Jede dieser Optionen wird empfohlen, wenn Sie neue Kampagnen in Market Audience Associations mit neuen marktinternen Zielgruppen in derselben Massendatei hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt
Löschen: Schreibgeschützt

Gebotsanpassung

Der Prozentsatz, den Sie den Gebotsbetrag für die Marktzielgruppe 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.

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 der Zielgruppe im Markt 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 Zielgruppe im Markt.

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 Zielgruppe im Markt 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 marktinterne 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, 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.