Freigeben über

Kampagnendatenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine Kampagne.

Hinweis

Sie können keine Kampagnen mehr hinzufügen, aktualisieren oder abrufen, die nur dynamische Suchanzeigen unterstützen. Der Kampagnentyp Ihrer vorhandenen Kampagnen wurde von "DynamicSearchAds" auf "Suche" aktualisiert. Die Anzeigengruppen werden jetzt als "dynamische" Anzeigengruppen betrachtet, aber es gibt keine strukturellen Änderungen, d. h., sie enthalten die gleichen automatischen Ziele und dynamischen Suchanzeigen wie zuvor.

Hinweis

Ab April 2021 kann die manuelle CPC-Gebotsstrategie nur noch mit Zielgruppenkampagnen und Unterkunftskampagnen (ehemals Hotelkampagnen) verwendet werden. Wenn Sie versuchen, die manuelle CPC für einen anderen Kampagnentyp festzulegen, wird die Anforderung ohne Fehler ignoriert, und die Gebotsstrategie wird auf enhanced CPC festgelegt.

Ab April 2021 können Sie keine Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festlegen. Gebotsstrategien können nur auf Kampagnenebene festgelegt werden. Wenn Sie versuchen, Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festzulegen, wird die Anforderung ohne Fehler ignoriert. Anzeigengruppen und Schlüsselwörter erben die Gebotsstrategie ihrer Kampagne.

<xs:complexType name="Campaign" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:sequence>
    <xs:element minOccurs="0" name="AudienceAdsBidAdjustment" nillable="true" type="xs:int" />
    <xs:element minOccurs="0" name="BiddingScheme" nillable="true" type="tns:BiddingScheme" />
    <xs:element minOccurs="0" name="BudgetType" nillable="true" type="tns:BudgetLimitType" />
    <xs:element minOccurs="0" name="DailyBudget" nillable="true" type="xs:double" />
    <xs:element xmlns:q9="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="DealIds" nillable="true" type="q9:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="ExperimentId" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
    <xs:element xmlns:q10="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q10:ArrayOfKeyValuePairOfstringstring" />
    <xs:element xmlns:q11="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="GoalIds" nillable="true" type="q11:ArrayOflong">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Id" nillable="true" type="xs:long" />
    <xs:element minOccurs="0" name="IsDealCampaign" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="MultimediaAdsBidAdjustment" nillable="true" type="xs:int">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="Name" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="Status" nillable="true" type="tns:CampaignStatus" />
    <xs:element minOccurs="0" name="SubType" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TimeZone" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="TrackingUrlTemplate" nillable="true" type="xs:string" />
    <xs:element minOccurs="0" name="UrlCustomParameters" nillable="true" type="tns:CustomParameters" />
    <xs:element minOccurs="0" name="CampaignType" nillable="true" type="tns:CampaignType" />
    <xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
    <xs:element minOccurs="0" name="BudgetId" nillable="true" type="xs:long" />
    <xs:element xmlns:q12="http://schemas.microsoft.com/2003/10/Serialization/Arrays" minOccurs="0" name="Languages" nillable="true" type="q12:ArrayOfstring" />
    <xs:element minOccurs="0" name="AdScheduleUseSearcherTimeZone" nillable="true" type="xs:boolean">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
    <xs:element minOccurs="0" name="BidStrategyId" nillable="true" type="xs:long">
      <xs:annotation>
        <xs:appinfo>
          <DefaultValue EmitDefaultValue="false" xmlns="http://schemas.microsoft.com/2003/10/Serialization/" />
        </xs:appinfo>
      </xs:annotation>
    </xs:element>
  </xs:sequence>
</xs:complexType>

Elemente

Das Campaign-Objekt verfügt über die folgenden Elemente: AdScheduleUseSearcherTimeZone, AudienceAdsBidAdjustment, BidScheme, BidStrategyId, BudgetId, CampaignType, DailyBudget, DealIds, ExperimentIds, FinalUrlSuffix, ForwardCompatibilityMap, GoalIds, Id, IsDealCampaign, Languages, MultimediaAdsBidAdjustment, Name, Settings, Status, SubType, TimeZone, TrackingUrlTemplate, UrlCustomParameters.

Element Beschreibung Datentyp
AdScheduleUseSearcherTimeZone Bestimmt, ob die Zeitzone des Kontos oder die Zeitzone des Suchbenutzers verwendet werden soll, in der die Anzeigen übermittelt werden könnten.

Legen Sie diese Eigenschaft auf true fest, wenn die Anzeigen in der Zeitzone des Suchbenutzers angezeigt werden sollen, und legen Sie sie andernfalls auf false fest.

Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den Wert AdScheduleUseSearcherTimeZone in das ReturnAdditionalFields-Element ein, wenn Sie die Dienstvorgänge GetCampaignsByAccountId und GetCampaignsByIds aufrufen.

Hinzufügen: Wahlfrei. Wenn Sie dieses Element nicht angeben oder leer lassen, wird der Standardwert false festgelegt, und die Kontozeitzone wird verwendet.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 boolean
AudienceAdsBidAdsAdjustment Der Prozentsatz, um den Ihr Gebot für Zielgruppenanzeigen oberhalb oder unterhalb der Basisanzeigegruppe oder Schlüsselwort (keyword) Gebots angepasst werden soll.

Diese Eigenschaft ist in Suchkampagnen verfügbar, wenn der Kunde für das Microsoft Audience Network aktiviert ist. Diese Eigenschaft ist bei Smart Shopping-Kampagnen nicht verfügbar.

Unterstützte Werte sind negativ einhundert (-100) bis positive neunhundert (900). Wenn Sie die Gebotsanpassung auf -100 festlegen, wird verhindert, dass Zielgruppenanzeigen für diese Kampagne angezeigt werden.

Legen Sie dieses Element auf Null (0) fest, wenn Sie die Basisanzeigegruppe oder Schlüsselwort (keyword) Gebot verwenden möchten, anstatt eine Gebotsanpassung für Zielgruppenanzeigen anzugeben.

Als bewährte Methode sollten Sie immer einen Gebotsanpassungswert angeben. Wenn Sie dieses Element auf NULL festlegen, wird die Standardgebotsanpassung des Systems verwendet. Die Standardgebotsanpassung des Systems ist derzeit null (0) und kann geändert werden.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 int
BiddingScheme Der Gebotsstrategietyp, der bestimmt, wie Sie Ihre Gebote verwalten möchten.

Ausführliche Informationen zu unterstützten Gebotsstrategien pro Kampagnentyp finden Sie unter Budget- und Gebotsstrategien.

WICHTIG: Bei einigen Gebotsstrategietypen werden Ihre Einstellungen für Gebot und Anzeigenrotation ignoriert, und die Konvertierungsnachverfolgung (über das Universal Event Tracking-Tag und ein Konvertierungsziel) ist erforderlich. Weitere Informationen einschließlich unterstützter Standorte finden Sie unter Lassen Sie Ihre Gebote mit Gebotsstrategien von Microsoft Advertising verwalten.

Dieses Element ist standardmäßig null oder leer, wenn die Kampagne die Gebotsstrategie MaxConversionValueBiddingScheme oder TargetImpressionShareBiddingScheme verwendet. Um die Objekte MaxConversionValueBiddingScheme oder TargetImpressionShareBiddingScheme abzurufen, schließen Sie die entsprechenden MaxConversionValueBiddingScheme - und TargetImpressionShareBiddingScheme-Werte in das ReturnAdditionalFields-Element ein, wenn Sie die Dienstvorgänge GetCampaignsByAccountId und GetCampaignsByIds aufrufen.

Hinzufügen: Wahlfrei. Der Standardtyp der Gebotsstrategie für Search- und DynamicSearchAds-Kampagnen ist EnhancedCpcBiddingScheme. Der Standardtyp der Gebotsstrategie für die meisten Shopping-Kampagnen ist EnhancedCpcBiddingScheme; Die einzigen unterstützten Gebotsstrategietypen für Smart Shopping-Kampagnen sind jedoch MaxConversionsBiddingScheme und MaxConversionValueBiddingScheme. Die unterstützten Gebotsstrategietypen für Zielgruppenkampagnen sind EnhancedCpcBiddingScheme, ManualCpcBiddingScheme, ManualCpmBiddingScheme und TargetCpaBiddingScheme. Die unterstützten Gebotsstrategietypen für Beherbergungskampagnen sind CommissionBiddingScheme, ManualCpcBiddingScheme und PercentCpcBiddingScheme. Die unterstützten Gebotsstrategien für Performance Max-Kampagnen sind MaxConversionsBiddingScheme (mit optionalem TCPA) und MaxConversionValueBiddingScheme (mit optionalem TROAS). Die unterstützten Gebotsstrategien für neue Videokampagnen sind ManualCpmBiddingScheme und ManualCpvBiddingScheme. ANMERKUNG: Ab Mai 2024 können Sie die manuelle CPC-Gebotsstrategie nicht mehr für native Zielgruppenkampagnen verwenden. Sie können manuellen CPC nur für Zielgruppenanzeige- und Videokampagnen sowie für Unterkunftskampagnen verwenden. Wir konvertieren alle vorhandenen manuellen nativen Kampagnen der CPC-Zielgruppe automatisch in erweiterte CPC.We will automatically convert any existing manual CPC native campaigns to enhanced CPC. Wenn Sie versuchen, die manuelle CPC für einen anderen Kampagnentyp festzulegen, wird die Anforderung ohne Fehler ignoriert, und die Gebotsstrategie wird auf enhanced CPC festgelegt. Ab April 2021 können Sie keine Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festlegen. Gebotsstrategien können nur auf Kampagnenebene festgelegt werden. Wenn Sie versuchen, Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festzulegen, wird die Anforderung ohne Fehler ignoriert. Anzeigengruppen und Schlüsselwörter erben die Gebotsstrategie ihrer Kampagne.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 BiddingScheme
BidStrategyId Der vom System generierte Bezeichner der BidStrategy , den diese Kampagne mit anderen Kampagnen im Konto teilt.

Wenn das Feld leer ist, verwendet die Kampagne keine Portfolio-Gebotsstrategie. Wenn das Feld nicht leer und der Wert größer als 0 (null) ist, verwendet die Kampagne eine Portfolio-Gebotsstrategie. Wenn die Kampagne eine Portfoliogebotsstrategie verwendet und Sie es bevorzugen, eine eigene Gebotsstrategie zu verwenden, legen Sie dieses Feld auf "0" (Null) fest.

Anmerkung: Portfoliogebotsstrategien werden bei Smart Shopping-Kampagnen oder Performance Max-Kampagnen nicht unterstützt.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 lang
BudgetId Der eindeutige Microsoft Advertising-Bezeichner des Budgets , das diese Kampagne mit anderen Kampagnen im Konto teilt.

Wenn der Wert nicht NULL und größer als 0 (null) ist, verwendet die Kampagne ein gemeinsames Budget. Wenn der Wert NULL ist, verwendet die Kampagne kein gemeinsames Budget. Wenn die Kampagne ein gemeinsames Budget verwendet und Sie es vorziehen, ein eigenes Budget zu verwenden, z. B. "DailyBudget amount", legen Sie dieses Element auf "0" (null) und "DailyBudget " auf einen gültigen Budgetbetrag fest.

Anmerkung: Gemeinsame Budgets werden bei Smart Shopping-Kampagnen oder Performance Max-Kampagnen nicht unterstützt. Bei smarten Shopping-Kampagnen müssen Sie den Tagesbudgetbetrag festlegen.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 lang
BudgetType Der Budgettyp bestimmt, wie das Budget ausgegeben wird.

Die möglichen Werte sind DailyBudgetAccelerated und DailyBudgetStandard. Der Budgettyp DailyBudgetAccelerated ist nur für Zielgruppenkampagnen verfügbar, die nicht freigegebene Budgets auf Kampagnenebene verwenden.

Im Kontext von gemeinsamen Budgets ist der Budgettyp eine schreibgeschützte Eigenschaft, die immer zurückgegeben wird, unabhängig davon, ob die Kampagne ein gemeinsames Budget verwendet oder nicht. Um zu ermitteln, ob die Kampagne ein gemeinsames Budget verwendet, überprüfen Sie den Wert des BudgetId-Elements wie oben beschrieben.

Mit Experimentkampagnen können Sie das Budget, BudgetType oder Status nicht festlegen. Das Budget und die status einer Experimentkampagne werden immer von den Basiskampagneneinstellungen geerbt.

Hinzufügen: Erforderlich, wenn die BudgetId nicht festgelegt ist. Schreibgeschützt, wenn die Kampagne ein gemeinsames Budget verwendet.
Aktualisieren: Optional, wenn die BudgetId nicht festgelegt ist. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Nicht zulässig, wenn die Kampagne ein gemeinsames Budget verwendet. Wenn Sie versuchen, den Budgettyp einer Kampagne mit einem gemeinsamen Budget zu aktualisieren, gibt der Dienst den Fehlercode CampaignServiceCannotUpdateSharedBudget zurück.		 BudgetLimitType
CampaignType Der Kampagnentyp bestimmt, ob es sich bei der Kampagne um eine Zielgruppe, dynamische Suchanzeigen, Suche, Shoppingkampagne, Hotelanzeigen oder Performance Max handelt.

Hinzufügen: Wahlfrei. Wenn nicht angegeben, wird der Standardwert Search verwendet.
Aktualisieren: Unstatthaft.		 CampaignType
DailyBudget Der Betrag, der täglich für die Kampagne ausgegeben werden soll.

Sie müssen den Tagesbudgetbetrag festlegen, wenn BudgetId nicht festgelegt ist.

Ihr Budget ist ein Ziel; Ihre tatsächlichen Ausgaben können höher oder niedriger sein. Abweichungen werden durch eine Reihe von Faktoren verursacht, z. B. unterschiedliche Datenverkehrsvolumen an verschiedenen Tagen der Woche oder die automatische Erkennung und Rückerstattung von Betrugsklicks, die innerhalb weniger Stunden nach dem Klick Geld an eine Kampagne zurückgeben können. Microsoft Advertising antizipiert die Schwankungen und gleicht diese automatisch aus und hält in der Regel Überschreitungen auf weniger als 100 % über Ihrem Tageslimit.

Beachten Sie außerdem, dass Ihr Kampagnenbudget für Microsoft Advertising nicht höher als die Anzeigengruppe und Schlüsselwort (keyword) Gebote sein muss. Anders ausgedrückt: Anzeigengruppe und Schlüsselwort (keyword) Gebote werden unabhängig vom Kampagnenbudget überprüft.

Im Kontext von geteilten Budgets ist der Budgetbetrag eine schreibgeschützte Eigenschaft, die immer zurückgegeben wird, unabhängig davon, ob die Kampagne ein gemeinsames Budget verwendet oder nicht. Wenn eine Kampagne einem gemeinsamen Budget zugeordnet ist, entspricht der zurückgegebene Betrag dem des gemeinsamen Budgets. Um zu ermitteln, ob die Kampagne ein gemeinsames Budget verwendet, überprüfen Sie den Wert des BudgetId-Elements wie oben beschrieben.

Mit Experimentkampagnen können Sie das Budget, BudgetType oder Status nicht festlegen. Das Budget und die status einer Experimentkampagne werden immer von den Basiskampagneneinstellungen geerbt.

Hinzufügen: Erforderlich, wenn die BudgetId nicht festgelegt ist. Schreibgeschützt, wenn die Kampagne ein gemeinsames Budget verwendet.
Aktualisieren: Optional, wenn die BudgetId nicht festgelegt ist. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Nicht zulässig, wenn die Kampagne ein gemeinsames Budget verwendet. Wenn Sie versuchen, den Budgetbetrag einer Kampagne mit einem gemeinsamen Budget zu aktualisieren, gibt der Dienst den Fehlercode CampaignServiceCannotUpdateSharedBudget zurück.		 doppelt
DealIds Eine Liste der eindeutigen Systembezeichner, die den hinzugefügten Deals entsprechen.

Die Liste der Bezeichner entspricht direkt der Liste der Deals in der Anforderung. Elemente der Liste können als NULL zurückgegeben werden. Für jeden Listenindex, in dem kein Deal hinzugefügt wurde, ist das entsprechende Element NULL.		 langes Array
ExperimentId Der vom System generierte Bezeichner des Experiments.

Dieses Element wird nur für Experimentkampagnen festgelegt, d. h. Kampagnen, die für A/B-Tests basierend auf einer anderen Suchkampagne erstellt wurden.

Basiskampagnen enthalten keine Experiment-ID. Ebenso wird dieses Element, nachdem ein Experiment zu einer unabhängigen Kampagne gestuft wurde, leer sein, obwohl die Kampagne zuvor eine Experimentkampagne war.

Mit Experimentkampagnen können Sie das Budget, BudgetType oder Status nicht festlegen. Das Budget und die status einer Experimentkampagne werden immer von den Basiskampagneneinstellungen geerbt. Wenn Sie das Budget eines Experiments ändern möchten, müssen Sie das Budget der Basiskampagne ändern. Die Änderung des Werts wird dann basierend auf Ihrer TrafficSplitPercent-Experimenteinstellung aufgeteilt.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 lang
FinalUrlSuffix Das endgültige URL-Suffix kann Nachverfolgungsparameter enthalten, die an das Ende ihrer Landing Page-URL angefügt werden. Es wird empfohlen, die für Ihre Landing Page benötigten Nachverfolgungsparameter in einem endgültigen URL-Suffix zu platzieren, damit Ihre Kunden immer an Ihre Landing Page gesendet werden. Weitere Informationen und Validierungsregeln finden Sie unter Endgültiges URL-Suffix in den technischen Leitfäden.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.		 Zeichenfolge
ForwardCompatibilityMap Die Liste der Schlüssel- und Wertzeichenfolgen für die Vorwärtskompatibilität, um andere Breaking Changes zu vermeiden, wenn neue Elemente in der aktuellen API-Version hinzugefügt werden.

Änderungen an der Vorwärtskompatibilität werden in zukünftigen Versionen hier notiert. Es gibt derzeit keine Änderungen an der Vorwärtskompatibilität für dieses Objekt.		 KeyValuePairOfstring-Array
GoalIds Eine Liste der Ziel-IDs. langes Array
Id Der eindeutige Microsoft Advertising-Bezeichner der Kampagne.

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich		 lang
IsDealCampaign Die Kampagne ist eine Deal-Kampagne, wenn sie wahr ist. boolean
Sprachen Ihre Einstellung für die Anzeigensprache bestimmt die Sprache, die Sie beim Schreiben Ihrer Anzeigen verwenden, und sollte die Sprache Ihrer Kunden sein.

WICHTIG: Wenn Sprachen sowohl auf Anzeigengruppen- als auch auf Kampagnenebene festgelegt sind, überschreibt die Sprache auf Anzeigengruppenebene die Sprache auf Kampagnenebene.

Sie können mehrere Sprachen einzeln in der Liste angeben oder nur ein Listenelement einschließen, das auf Alle festgelegt ist, wenn Sie alle Sprachen als Ziel verwenden möchten.

Die unterstützten Sprachzeichenfolgen für Such- und Shoppingkampagnen sind: Albanisch, Bulgarisch, Kroatisch, Tschechisch, Dänisch, Niederländisch, Englisch, Estnisch, Finnisch, Französisch, Deutsch, Griechisch, Ungarisch, Italienisch, Japanisch, Lettisch, Litauisch, Maltesisch, Norwegisch, Polnisch, Portugiesisch, Rumänisch, Slowakisch, Slowenisch, Slowenisch, Spanisch, Schwedisch und TraditionellChinesisch.

ANMERKUNG: Die folgenden Sprachen sind noch nicht für jeden verfügbar: Bulgarisch, Kroatisch, Tschechisch, Estnisch, Griechisch, Ungarisch, Japanisch, Lettisch, Litauisch, Maltesisch, Polnisch, Rumänisch, Slowenisch, Slowenisch.

Für Zielgruppenkampagnen müssen Sie alle Sprachen einschließen, d. h. legen Sie dieses Element auf Alle fest.

Bei Kampagnen für dynamische Suchanzeigen werden die Spracheinstellungen auf Kampagnen- und Anzeigengruppenebene zugunsten der Websitedomänensprache ignoriert. Sie sollten Kampagnensprachen auf "Alle" festlegen und die Sprache auf Anzeigengruppenebene leer lassen.

Hinzufügen: Erforderlich für Zielgruppenkampagnen, andernfalls ist dieses Element optional. Wenn keine Kampagnensprache festgelegt ist, ist die Sprache jeder Anzeigengruppe innerhalb der Kampagne erforderlich.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Nachdem Kampagnensprachen festgelegt wurden, können Sie nicht alle löschen. Die Liste der Sprachen, die Sie während des Updates angeben, ersetzt die vorherigen Einstellungen, d. h. wird nicht an den vorhandenen Satz von Sprachen angefügt.		 Zeichenfolgenarray
MultimediaAdsBidAdjustment Der Prozentsatz, um den Ihr Gebot für Multimediaanzeigen oberhalb oder unterhalb der Basisanzeigegruppe oder Schlüsselwort (keyword) Gebots angepasst werden soll int
Name Der Name der Kampagne. Der Name muss für alle aktiven oder angehaltenen Kampagnen innerhalb des Kontos eindeutig sein. Der Name darf maximal 128 Zeichen lang sein.

Der Dienst führt einen Vergleich ohne Berücksichtigung der Groß-/Kleinschreibung durch, wenn er den Namen mit vorhandenen Kampagnennamen vergleicht.

Hinzufügen: Erforderlich
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 Zeichenfolge
Einstellungen Die unterstützten Einstellungen, die je nach Kampagnentyp variieren.

Hinweis: VerifiedTrackingSetting ist derzeit nicht verfügbar.

Sie können maximal ein Objekt pro Einstellungstyp in die Liste der Einstellungen aufnehmen, z. B. ein TargetSetting-Objekt.

Wenn CampaignType auf Search festgelegt ist und das ExperimentId-Element nicht festgelegt ist, kann diese Liste optional ein DynamicSearchAdsSetting-Objekt enthalten. Experimentkampagnen und Basiskampagnen von Experimenten können keine dynamischen Suchanzeigeneinstellungen enthalten. Wenn Sie diese Kampagne für Experimente verwenden möchten, schließen Sie keine dynamischen Suchanzeigeneinstellungen ein. Wenn ein vorhandenes Experiment bereits auf dieser Kampagne basiert, können Sie die Kampagne nicht aktualisieren, um dynamische Suchanzeigeneinstellungen einzuschließen.

Wenn CampaignType auf Shopping festgelegt ist, muss diese Liste ein ShoppingSetting-Objekt enthalten.

Wenn CampaignType auf Audience festgelegt ist, kann diese Liste ein ShoppingSetting-Objekt enthalten, je nachdem, ob die Audience-Kampagne Produktanzeigen unterstützt oder nicht.

Wenn CampaignType auf DynamicSearchAds festgelegt ist, muss diese Liste ein DynamicSearchAdsSetting-Objekt enthalten.

Wenn CampaignType auf Hotel festgelegt ist, muss diese Liste ein HotelSetting-Objekt enthalten.

Wenn CampaignType auf PerformanceMax festgelegt ist, muss diese Liste ein PerformanceMaxSetting-Objekt enthalten. Wenn die Performance Max-Kampagne einem Store zugeordnet ist, unterstützt sie auch shoppingSetting.

TargetSetting kann mit jedem Kampagnentyp mit Ausnahme von Performace Max verwendet werden und bestimmt, ob die Zielgruppenkriterien, die dieser Kampagne zugeordnet sind, die Option "Ziel und Gebot" oder die Option "Nur Gebot" verwenden. Innerhalb von TargetSetting können Sie ein TargetSettingDetail-Objekt haben, d. h. eins pro unterstützter CriterionTypeGroup. Der einzige Kriteriumtypwert, der derzeit für die Zieleinstellung auf Kampagnenebene unterstützt wird, ist "Zielgruppe". Das TargetSetting-Objekt wird standardmäßig nicht zurückgegeben. Um dieses Objekt abzurufen, schließen Sie den TargetSetting-Wert in das ReturnAdditionalFields-Element ein, wenn Sie die GetCampaignsByAccountId - und GetCampaignsByIds-Dienstvorgänge aufrufen.

Hinzufügen: Erforderlich, wenn campaignType auf DynamicSearchAds oder Shopping festgelegt ist, andernfalls ist dieses Element optional. Wenn dieses Element kein TargetSetting-Objekt enthält, ist die Standardgebotsoption für alle Kriterientypgruppen effektiv "nur geboten".
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Die Objekte DynamicSearchAdsSetting und ShoppingSetting können während der Aktualisierung nicht entfernt werden.		 Festlegen des Arrays
Status Die status der Kampagne.

Mögliche Werte sind Aktiv und Angehalten.

Der Dienst hält die Kampagne automatisch an, wenn das Budget erschöpft ist.

Bei Experimentkampagnen können Sie das Budget, budgetType oder Status nicht festlegen Das Budget und status einer Experimentkampagne werden immer von den Basiskampagneneinstellungen geerbt.

Hinzufügen: Wahlfrei. Der Standardwert ist Angehalten.
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert.		 CampaignStatus
SubType Der Kampagnenuntertyp.

Wenn der Untertyp nicht festgelegt ist, wird die Kampagne entsprechend dem Kampagnentyp erstellt.

Wenn der Untertyp auf AudienceVideoAds und der Kampagnentyp Audience festgelegt ist, ist die Kampagne eine Video-Zielgruppenkampagne.

Wenn der Untertyp auf ShoppingSmartAds festgelegt ist, handelt es sich bei der Kampagne um eine Microsoft Smart Shopping-Kampagne.

Wenn der Untertyp auf ShoppingSponsoredProductAd festgelegt ist, handelt es sich bei der Kampagne um eine Microsoft-Shoppingkampagne für Marken.

Hinzufügen: Optional und gilt nicht für die meisten Kampagnentypen. Für Microsoft Smart Shopping-Kampagnen müssen Sie den Untertyp auf ShoppingSmartAds festlegen. Für Microsoft-Shoppingkampagnen für Marken müssen Sie den Untertyp auf ShoppingSponsoredProductAd festlegen.
Aktualisieren: Schreibgeschützt		 Zeichenfolge
Zeitzone Diese Spalte ist veraltet.

Die Zeitzone, in der die Kampagne ausgeführt wird.

Die Zeitzone wird zum Melden und Anwenden des Start- und Enddatums einer Anzeigengruppe verwendet.

Mögliche Werte finden Sie unter Zeitzonen.

Mit Experimentkampagnen können Sie budget, BudgetType, Status oder TimeZone nicht festlegen. Das Budget, die status und die Zeitzone einer Experimentkampagne werden immer von den Basiskampagneneinstellungen geerbt.

Hinzufügen: Erforderlich
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Sie dürfen die Zeitzone nicht aktualisieren, wenn die Kampagne Anzeigengruppen im Status Aktiv oder Angehalten enthält oder enthält.		 Zeichenfolge
TrackingUrlTemplate Die Nachverfolgungsvorlage, die als Standard für alle URLs in Ihrer Kampagne verwendet werden soll.

Die folgenden Validierungsregeln gelten für Nachverfolgungsvorlagen. Weitere Informationen zu unterstützten Vorlagen und Parametern finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?
- Nachverfolgungsvorlagen, die für Entitäten auf niedrigerer Ebene definiert sind, z. B. Anzeigen, überschreiben diejenigen, die für Entitäten höherer Ebene festgelegt wurden, z. B. Kampagnen. Weitere Informationen finden Sie unter Entitätsgrenzwerte.
– Die Länge der Nachverfolgungsvorlage ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
– Die Nachverfolgungsvorlage muss eine wohlgeformte URL sein, die mit einer der folgenden Beginnt: http://, https://, {lpurl} oder {unescapedlpurl}.
– Microsoft Advertising überprüft nicht, ob benutzerdefinierte Parameter vorhanden sind. Wenn Sie benutzerdefinierte Parameter in Ihrer Nachverfolgungsvorlage verwenden und diese nicht vorhanden sind, enthält die URL der Angebotsseite die Schlüssel- und Wertplatzhalter Ihrer benutzerdefinierten Parameter ohne Ersetzung. Wenn Ihre Nachverfolgungsvorlage beispielsweise lautet https://tracker.example.com/?season={_season}&promocode={_promocode}&u={lpurl} und weder {_season} noch {_promocode} auf Kampagnen-, Anzeigengruppen-, Kriterium-, Schlüsselwort (keyword)- oder Anzeigenebene definiert sind, ist die URL der Landing Page identisch.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Wenn Sie dieses Element auf eine leere Zeichenfolge ("") festlegen, wird die vorherige Einstellung gelöscht.		 Zeichenfolge
UrlCustomParameters Ihre benutzerdefinierte Sammlung von Schlüssel- und Wertparametern für die URL-Nachverfolgung.

Microsoft Advertising akzeptiert die ersten 8 CustomParameter-Objekte , die Sie in das CustomParameters-Objekt einschließen, und wenn Sie mehr als 8 benutzerdefinierte Parameter einschließen, wird ein Fehler zurückgegeben. Jeder CustomParameter enthält Key - und Value-Elemente .

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Legen Sie das UrlCustomParameters-Element auf NULL oder leer fest, um alle vorhandenen benutzerdefinierten Parameter beizubehalten. Um alle benutzerdefinierten Parameter zu entfernen, legen Sie das Parameters-Element des CustomParameters-Objekts auf NULL oder leer fest. Um eine Teilmenge benutzerdefinierter Parameter zu entfernen, geben Sie die benutzerdefinierten Parameter an, die Sie im Parameters-Element des CustomParameters-Objekts beibehalten möchten.		 CustomParameters

Anforderungen

Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13

Verwendet von

AddCampaigns
GetCampaignsByAccountId
GetCampaignsByIds
UpdateCampaigns