Kampagnenradiuskriteriumsdatensatz – Massen

Definiert ein Kampagnenradiuskriterium, das in eine Massendatei hochgeladen und heruntergeladen werden kann.

Mit Radiuskriterien können Sie potenziellen Kunden Anzeigen in einem bestimmten Radius um eine Postleitzahl, Koordinaten, einen Orientierungspunkt oder einen Bestimmten Bereich anzeigen, nach Seiten suchen oder anzeigen.

Jedes Radiuskriterium definiert einen Radius, Breitengrad und Längengrad für die begleitende Gebotsanpassung des Kriteriums.

Die maximale Anzahl von Radiuskriterien, die Sie pro Kampagne oder Anzeigengruppe angeben können, beträgt 2.000.

Hinweis

Sie können nur einen Datensatz für das Kampagnenstandortzielkriterium pro Kampagne verwenden, um die Standortabsichtsoption zu bestimmen, die für alle Datensätze Kampagnenstandortkriterium und Kampagnenradiuskriterium gilt. Wenn Sie das erste Kriterium der Kampagne erstellen, wird auch automatisch ein Datensatz für das Kampagnenstandortziel hinzugefügt, wobei der Standardziel auf PeopleInOrSearchingForOrViewingPages festgelegt ist. Sie können das Kampagnenstandortabsichtskriterium einer Kampagne hinzufügen oder aktualisieren, unabhängig davon, ob die Kampagne über andere Kriterien verfügt oder nicht. Sie können das Kampagnenstandortzielkriterium einer Kampagne nicht löschen, obwohl es ohne Standort- oder Radiuskriterien keinen Zweck hat.

Wenn Radiuskriterien auf Anzeigengruppenebene angegeben werden, werden die Radiuskriterien auf Kampagnenebene für diese Anzeigengruppe ignoriert. Anders ausgedrückt: Die Radiuskriterien der Anzeigengruppe überschreiben die Aktionsradiuskriterien und werden nicht als Union angewendet.

Beachten Sie außerdem, dass Sie die Kriterien Standort, negativer Standort und Radius als eine Reihe von geografischen Kriterien berücksichtigen müssen. Wenn die Anzeigengruppe über geografische Kriterien verfügt, wird keines der geografischen Kriterien der Kampagne geerbt. Wenn die Anzeigengruppe über keine geografischen Kriterien verfügt, werden alle geografischen Kriterien der Kampagne geerbt. Die geografischen Kriterien können von der Kampagne geerbt werden, auch wenn die Anzeigengruppe über ein Standortabsichtskriterium verfügt. Wenn die geografischen Kriterien der Anzeigengruppe verwendet werden, wird das Standortzielkriterium der Anzeigengruppe verwendet. Wenn die geografischen Kriterien der Kampagne geerbt werden, wird das Standortabsichtskriterium der Kampagne verwendet, und das Standortzielkriterium der Anzeigengruppe wird ignoriert. Sie können das Standortzielkriterium einer Kampagne oder Anzeigengruppe nicht löschen, obwohl es ohne Standort- oder Radiuskriterien keinen Zweck hat.

Tipp

Eine Übersicht über die Verwendung von Zielkriterien finden Sie unter Anzeigen von Anzeigen für Ihre Zielgruppe.

Sie können alle Datensätze des Kampagnenradiuskriteriums im Konto herunterladen, indem Sie den DownloadEntity-Wert von CampaignTargetCriterions 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 ein neues Kampagnenradiuskriterium hinzugefügt, wenn ein gültiger Wert für übergeordnete ID angegeben wird.

Type,Status,Id,Parent Id,Sub Type,Campaign,Client Id,Modified Time,Target,Bid Adjustment,Name,Radius,Unit,From Hour,From Minute,To Hour,To Minute,Latitude,Longitude
Format Version,,,,,,,,,,6.0,,,,,,,,
Campaign Radius Criterion,Active,,-111,,,ClientIdGoesHere,,RadiusName,20,,10,Kilometers,,,,,10.5,40.5

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 BulkCampaignRadiusCriterion-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 BulkCampaignRadiusCriterion
var bulkCampaignRadiusCriterion = new BulkCampaignRadiusCriterion
{
    // 'Campaign' column header in the Bulk file is read-only
    CampaignName = null,

    // 'Client Id' column header in the Bulk file
    ClientId = "ClientIdGoesHere",

    // Map properties in the Bulk file to the 
    // BiddableCampaignCriterion object of the Campaign Management service.

    CampaignCriterion = new BiddableCampaignCriterion
    {
        // 'Parent Id' column header in the Bulk file
        CampaignId = campaignIdKey,

        Criterion = new RadiusCriterion
        {
            // 'Latitude' column header in the Bulk file
            LatitudeDegrees = 10.5,

            // 'Longitude' column header in the Bulk file
            LongitudeDegrees = 40.5,

            // 'Name' column header in the Bulk file
            Name = "RadiusName",

            // 'Radius' column header in the Bulk file
            Radius = 10,

            // 'Unit' column header in the Bulk file
            RadiusUnit = DistanceUnit.Kilometers,
        },

        CriterionBid = new BidMultiplier
        {
            // 'Bid Adjustment' column header in the Bulk file
            Multiplier = 20,
        },

        // 'Id' column header in the Bulk file
        Id = null,

        // 'Status' column header in the Bulk file
        Status = CampaignCriterionStatus.Active,
    }
};

uploadEntities.Add(bulkCampaignRadiusCriterion);

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

• Gebotsanpassung
• Kampagnen
• Client-ID
• Id
• Latitude
• Longitude
• Änderungszeit
• Name
• Übergeordnete ID
• RADIUS
• Status
• Unit

Gebotsanpassung

Der Prozentsatz, den Sie das Gebot für das entsprechende Radiuskriterium anpassen möchten.

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

Hinzufügen: Optional. Die Gebotsanpassung wird auf den Standardwert 0 festgelegt, wenn sie nicht enthalten ist.
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt

Kampagne

Der Name der Kampagne, in der dieses Kriterium angewendet oder entfernt wird.

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: Optional

Id

Der eindeutige Microsoft Advertising-Bezeichner des Kriteriums.

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

Breitengrad

Der Breitengrad des Standortkriteriums in Grad.

Der Breitengrad muss größer oder gleich -85,0 und kleiner oder gleich +85,0 sein.

Sie geben den Breiten- und Längengrad als Dezimalwerte an. Beispielsweise beträgt der Breiten- und Längengrad von One Redmond Way, Redmond, WA 47,755367 bzw. -122,091827. Um diese Werte zu erhalten, können Sie die Adresse eines geografischen Standorts in Bing Karten eingeben, und die Koordinaten werden unter der Adresse angezeigt.

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

Längengrad

Der Längengrad des Standortkriteriums in Grad.

Der Längengrad muss größer oder gleich -180,0 und kleiner als oder gleich +180,0 sein.

Sie geben den Breiten- und Längengrad als Dezimalwerte an. Beispielsweise beträgt der Breiten- und Längengrad von One Redmond Way, Redmond, WA 47,755367 bzw. -122,091827. Um diese Werte zu erhalten, können Sie die Adresse eines geografischen Standorts in Bing Karten eingeben, und die Koordinaten werden unter der Adresse angezeigt.

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

Name

Der Name des geografischen Standorts, für den das Ziel verwendet wird.

Der Name darf maximal 50 Zeichen enthalten.

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

Übergeordnete ID

Der Bezeichner der Kampagne, in der dieses Kriterium angewendet oder entfernt wird.

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 einer neuen Kampagne in derselben Massendatei neue Kriterien hinzufügen. Weitere Informationen finden Sie unter Massendateischemareferenzschlüssel.
Aktualisieren: Schreibgeschützt und erforderlich
Löschen: Schreibgeschützt und erforderlich

RADIUS

Der Radius, der den Bereich angibt, der den geografischen Standort umgibt, der als Ziel verwendet werden soll.

Wenn das Feld Radiuseinheit auf Meilen festgelegt ist, werden positive ganzzahlige Werte von 1 bis 500 akzeptiert.

Wenn das Feld Radiuseinheit auf Kilometer festgelegt ist, werden positive ganzzahlige Werte von 1 bis 800 akzeptiert.

Hinweis

Der Datentyp ist double und wird möglicherweise in einer zukünftigen Version unterstützt. Derzeit akzeptiert der Dienst nur ganzzahlige Werte und gibt diese zurück.

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

Status

Stellt die Zuordnung status zwischen der Kampagne und dem Kriterium dar. Wenn das Kriterium auf die Kampagne angewendet wird, ist der Wert dieses Felds Aktiv. Um das Kriterium zu löschen, legen Sie die status auf Gelöscht fest.

Hinzufügen: Schreibgeschützt. Die status wird immer auf Aktiv festgelegt, wenn Sie Kriterien hinzufügen. Wenn Sie z. B. einen anderen Wert hochladen, enthält foo die Ergebnisdatei denselben Wert, obwohl das Kriterium aktiv ist.
Aktualisieren: Optional
Löschen: Erforderlich. Der Status muss auf Gelöscht festgelegt werden. Um ein bestimmtes Standortkriterium zu löschen, müssen Sie den Status, die ID und die übergeordnete ID hochladen.

Unit

Die Maßeinheit für den angegebenen Radius.

Unterstützte Werte sind Meilen (Standard) und Kilometer.

Hinzufügen: Optional. Wenn keine Angabe erfolgt, wird der Standardwert "Meilen " festgelegt.
Aktualisieren: Erforderlich
Löschen: Schreibgeschützt