Tag-/Uhrzeit-Kriteriumdatensatz der Kampagne – Massenvorgang

Artikel
12/21/2023

Definiert ein Tag- und Uhrzeitkriterium der Kampagne, das in eine Massendatei hochgeladen und heruntergeladen werden kann.

Wenn Ihre Kampagne voranschreitet, stellen Sie möglicherweise fest, dass Ihre Klickrate und Ihre Konvertierungsrate während bestimmter Zeiten am höchsten sind, z. B. wochentags. Dies könnte eine perfekte Gelegenheit sein, Gebotsanpassungen zu verwenden, um Ihre Chancen für die Anzeige Ihrer Anzeige montags bis freitags von 18:00 bis 23:00 Uhr zu verbessern. Wenn sie nach Zeit ausgerichtet sind, zielen Sie auf die lokale Zeitzone des Suchers ab. Beispiel: Wenn Sie Ihr Gebot um 10 % für 18:00 Bis 23:00 Uhr erhöhen, wird diese Gebotsanpassung von 18:00 uhr bis 23:00 Uhr (Eastern Time) für Sucher in New York wirksam und gilt dann von 18:00 bis 23:00 Uhr Pazifische Zeit für Sucher in Seattle. Jetzt zeigen Sie Ihre Anzeigen an, wenn Ihre potenziellen Kunden online sind!

Das Tag- und Zeitkriterium definiert den Tag, von Der Stunde, der Minute, der Stunde bis zur Stunde und den Minutenanforderungen für die begleitende Gebotsanpassung des Kriteriums.

Hinweis

Sie können die Werte Target, From Hour, From Minute, To Hour oder To Minute für ein vorhandenes Kriterium nicht ändern. Zum Ändern des Tages- und Zeitbereichs müssen Sie das Kriterium löschen und ein neues Kriterium hinzufügen.

Die maximale Anzahl von Tag- und Zeitkriterien, die Sie pro Kampagne oder Anzeigengruppe angeben können, beträgt 49. Sie dürfen keine überlappenden Tag- und Zeitbereiche angeben, z. B. montags von 3:00 bis 5:00 Uhr und Montag von 4:00 bis 6:00 Uhr sind für dieselbe Kampagne oder Anzeigengruppe nicht zulässig. Auch für eine bestimmte Kampagne oder Anzeigengruppe ist die maximale Anzahl von Tag- und Zeitkriterien pro Tag, die Sie angeben können, sieben. Sie können z. B. bis zu 7 Tage und Zeitkriterien angeben, bei denen der Tag auf Montag festgelegt ist.

Wenn Kriterien für Tag und Uhrzeit auf Anzeigengruppenebene angegeben werden, werden die Kriterien für Tag und Uhrzeit der Kampagnenebene für diese Anzeigengruppe ignoriert. Anders ausgedrückt: Die Kriterien für Tag und Uhrzeit der Anzeigengruppe überschreiben die Kriterien für Tag und Uhrzeit der Kampagne und werden nicht als Vereinigung angewendet.

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 Campaign DayTime-Kriteriums 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 Tag- und Zeitkriterium der Kampagne 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 DayTime Criterion,Active,,-111,,,ClientIdGoesHere,,Monday,20,,,,0,0,4,0,,

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

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

    // 'Modified Time' column header in the Bulk file is read-only
    //  LastModifiedTime cannot be set in the Bulk entity

    // 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 DayTimeCriterion
        {
            // 'Target' column header in the Bulk file
            Day = Day.Monday,

            // 'From Hour' column header in the Bulk file
            FromHour = 0,

            // 'To Hour' column header in the Bulk file
            ToHour = 4,

            // 'From Minute' column header in the Bulk file
            FromMinute = Minute.Zero,

            // 'To Minute' column header in the Bulk file
            ToMinute = Minute.Zero
        },

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

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

Gebotsanpassung
Kampagnen
Client-ID
Ab Stunde
Ab Minute
Id
Änderungszeit
Übergeordnete ID
Status
Target
Bis Stunde
In Minute

Gebotsanpassung

Der Prozentsatz, den Sie das Gebot für das entsprechende Ziel anpassen möchten, von Stunde, Von Minute, Zu Stunde und Bis Minute.

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

Ab Stunde

Die Startstunde, die als Ziel festgelegt werden soll.

Unterstützte Werte reichen von 0 bis 23.

Hinzufügen: Erforderlich
Aktualisieren: Erforderlich. Sie können die Werte Target, From Hour, From Minute, To Hour oder To Minute für ein vorhandenes Kriterium nicht ändern. Zum Ändern des Tages- und Zeitbereichs müssen Sie das Kriterium löschen und ein neues Kriterium hinzufügen.
Löschen: Schreibgeschützt

Ab Minute

Die Startminute, die als Ziel verwendet werden soll.

Unterstützte Werte sind 0, 15, 30 und 45.

Id

Der eindeutige Microsoft Advertising-Bezeichner des Kriteriums.

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

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 Tag- und Zeitkriteriumsgebot zu löschen, müssen Sie den Status, die ID und die übergeordnete ID hochladen.

Ziel

Der Tag, den Sie mit der entsprechenden Gebotsanpassung anzielen möchten.

Unterstützte Werte sind Sonntag, Montag, Dienstag, Mittwoch, Donnerstag, Freitag und Samstag.

Bis Stunde

Die zielende Stunde.

Unterstützte Werte reichen von 0 bis 24. Wenn to Hour auf 24 festgelegt ist, muss To Minuteden Wert Null aufweisen.

In Minute

Die zielende Minute.