AdGroup-Datenobjekt – Kampagnenverwaltung
Definiert eine Anzeigengruppe in einer Werbekampagne.
Syntax
<xs:complexType name="AdGroup" xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:sequence>
<xs:element minOccurs="0" name="AdRotation" nillable="true" type="tns:AdRotation" />
<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="CommissionRate" nillable="true" type="tns:RateBid">
<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="CpcBid" nillable="true" type="tns:Bid" />
<xs:element minOccurs="0" name="EndDate" nillable="true" type="tns:Date" />
<xs:element minOccurs="0" name="FinalUrlSuffix" nillable="true" type="xs:string" />
<xs:element xmlns:q20="http://schemas.datacontract.org/2004/07/System.Collections.Generic" minOccurs="0" name="ForwardCompatibilityMap" nillable="true" type="q20:ArrayOfKeyValuePairOfstringstring" />
<xs:element minOccurs="0" name="FrequencyCapSettings" nillable="true" type="tns:ArrayOfFrequencyCapSettings">
<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="Language" nillable="true" type="xs:string" />
<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="Network" nillable="true" type="tns:Network" />
<xs:element minOccurs="0" name="PercentCpcBid" nillable="true" type="tns:RateBid">
<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="PrivacyStatus" nillable="true" type="tns:AdGroupPrivacyStatus" />
<xs:element minOccurs="0" name="Settings" nillable="true" type="tns:ArrayOfSetting" />
<xs:element minOccurs="0" name="StartDate" nillable="true" type="tns:Date" />
<xs:element minOccurs="0" name="Status" nillable="true" type="tns:AdGroupStatus" />
<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="UseOptimizedTargeting" 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="UsePredictiveTargeting" 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="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="AdGroupType" nillable="true" type="xs:string">
<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="CpvBid" nillable="true" type="tns:Bid">
<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="CpmBid" nillable="true" type="tns:Bid">
<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="McpaBid" nillable="true" type="tns:Bid">
<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 AdGroup-Objekt verfügt über die folgenden Elemente: AdGroupType, AdRotation, AdScheduleUseSearcherTimeZone, AudienceAdsBidAdjustment, BiddingScheme, CommissionRate, CpcBid, CpmBid, CpvBid, EndDate, FinalUrlSuffix, ForwardCompatibilityMap, FrequencyCapSettings, Id, Language, McpaBid, MultimediaAdsBidAdjustment, Name, Network, PercentCpcBid, PrivacyStatus, Settings, StartDate, Status, TrackingUrlTemplate, UrlCustomParameters, UseOptimizedTargeting, UsePredictiveTargeting.
| Element | Beschreibung | Datentyp |
|---|---|---|
| AdGroupType | Der Anzeigengruppentyp. In einer gemischten Kampagne , bei der campaignType "Search" ist, die ExperimentId nicht festgelegt ist und die Einstellungen bereits über einen gültigen DynamicSearchAdsSetting verfügen, sind die möglichen Werte "SearchDynamic" und "SearchStandard". Andernfalls kann der Typ der Anzeigengruppen in "Search"-Kampagnen nur auf "SearchStandard" festgelegt werden. Wenn der Anzeigengruppentyp "SearchDynamic" lautet, können Sie innerhalb dieser Anzeigengruppe nur dynamische Suchanzeigen hinzufügen. Wenn der Anzeigengruppentyp "SearchStandard" lautet, können Sie in dieser Anzeigengruppe erweiterte Textanzeigen oder reaktionsfähige Suchanzeigen hinzufügen. Der Typ der Anzeigengruppen in "DynamicSearchAds"-Kampagnen kann nur auf "SearchDynamic" festgelegt werden. Sie müssen den Anzeigengruppentyp für "DynamicSearchAds"-Kampagnen nicht festlegen. Beachten Sie jedoch, dass beim Abrufen von Anzeigengruppen dieses Element auf "SearchDynamic" festgelegt wird. Dieses Feld kann für die Kampagnentypen "Hotel" oder "Suche" auf HotelAds festgelegt werden. Dieses Element kann nicht für die Kampagnentypen "Zielgruppe" oder "Shopping" festgelegt werden. Wenn Sie eine Anzeigengruppe in nicht unterstützten Kampagnen abrufen, wird dieses Element nicht festgelegt. Hinzufügen: Optional. Der Standardwert für "Search"-Kampagnen ist "SearchStandard". Der Standardwert für "DynamicSearchAds"-Kampagnen ist "SearchDynamic". Aktualisieren: Schreibgeschützt. Sie können den Anzeigengruppentyp nicht aktualisieren. |
Zeichenfolge |
| AdRotation | Die Anzeigenrotation legt fest, wie oft Microsoft Advertising auswählt, welche Anzeigen geschaltet werden sollen, wenn sie mehrere Anzeigen innerhalb einer Anzeigengruppe haben. Da nicht mehr als eine Anzeige aus Ihrem Konto gleichzeitig angezeigt werden kann, priorisiert die Anzeigenrotation Anzeigen, die statistisch mit höherer Wahrscheinlichkeit eine bessere Leistung erhalten. Hinweis: Die Anzeigenrotation gilt nicht für Produktanzeigen. Mögliche Werte für den Anzeigenrotationstyp sind OptimizeForClicks und RotateAdsEvenly. Wenn OptimizeForClicks festgelegt ist, priorisiert Microsoft Advertising die Anzeige aus der Anzeigengruppe, die die besten Chancen auf eine gute Leistung zu haben scheint, basierend auf Auktionsmerkmalen oder Faktoren wie Schlüsselwort (keyword), Suchbegriff, Gerät oder Standort. Anzeigen mit höherer Leistung werden häufiger angezeigt, und andere werden seltener oder überhaupt angezeigt. Wenn diese Einstellung auf RotateAdsEvenly festgelegt ist, bietet Microsoft Advertising mehr Gleichgewicht bei der Rotation zwischen Ihren Anzeigen. Das heißt, die Anzeigen in einer bestimmten Anzeigengruppe haben eine ähnliche Wahrscheinlichkeit, als Reaktion auf die Abfrage eines Suchers angezeigt zu werden. Anzeigen werden niedriger priorisiert, wenn sie eine geringere Anzeigenqualität aufweisen und daher möglicherweise seltener oder gar nicht angezeigt werden. – Mit der Einstellung RotateAdsEvenly können Anzeigen mit geringerer Leistung genauso oft wie Anzeigen mit höherer Leistung angezeigt werden. Dies kann sich auf die Leistung von Anzeigengruppen auswirken. – Die Einstellung RotateAdsEvenly wird ignoriert, wenn Sie eine automatisierte Gebotsstrategie verwenden, d. h. MaxClicks, MaxConversions, TargetCpa oder TargetRoas, da diese Gebotsstrategien werbung mit höherer Leistung priorisieren. Hinzufügen: Optional. Der Standardwert ist OptimizeForClicks. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. |
AdRotation |
| 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 GetAdGroupsByCampaignId - und GetAdGroupsByIds-Dienstvorgänge aufrufen. Hinzufügen: Optional. Wenn Sie dieses Element nicht angeben oder leer lassen, wird der Standardwert true festgelegt, und die Zeitzone des Suchbenutzers wird verwendet. Wenn Sie dieses Feld nach dem 30. September 2020 nicht angeben oder leer lassen, wird der Standardwert false festgelegt, und die Kontozeitzone wird verwendet. Aktualisieren: Optional. 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 Prozent festlegen, wird verhindert, dass Zielgruppenanzeigen für diese Anzeigengruppe angezeigt werden. Legen Sie dieses Element auf Null (0) fest, wenn Sie keine Gebotsanpassung für Zielgruppenanzeigen wünschen. Wenn dieses Element NULL ist, erben Sie die Einstellung AudienceAdsBidAdsAdjustment der Kampagne der Anzeigengruppe. Hinzufügen: Optional Aktualisieren: Optional. Diese Eigenschaft wird nur aktualisiert, wenn Sie auch das UpdateAudienceAdsBidAdjustment-Element auf true festlegen, und andernfalls wird diese Eigenschaft ignoriert. Wenn die Anzeigengruppe bereits über eine native Gebotsanpassung verfügt und Sie diese entfernen möchten, um effektiv die Einstellung AudienceAdsBidAdsBidAdjustment der Kampagne der Anzeigengruppe zu erben, legen Sie dieses Element auf NULL fest. |
int |
| BiddingScheme | Der Gebotsstrategietyp, der bestimmt, wie Sie Ihre Gebote verwalten möchten. HINWEIS: Ab April 2021 können Sie keine Gebotsstrategien für Anzeigengruppen oder Schlüsselwörter festlegen. 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. Hinzufügen: Optional. Wenn Sie dieses Element nicht festlegen, wird standardmäßig InheritFromParentBiddingScheme verwendet. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. |
BiddingScheme |
| CommissionRate | Reserviert. | RateBid |
| CpcBid | Das Standardgebot, das verwendet werden soll, wenn die Abfrage des Benutzers und die Schlüsselwörter der Anzeigengruppe übereinstimmen, indem entweder ein allgemeiner, genauer oder ausdrucksgleicher Vergleich verwendet wird. Der minimale und maximale Gebotsbereich hängt von der Währung des Kontos ab. Weitere Informationen finden Sie unter Währungen. Die Angabe eines allgemeinen, exakten oder ausdrucksgenauen Gebots auf Schlüsselwort (keyword) Ebene setzt den Cpc-Gebotswert der Anzeigengruppe für den entsprechenden Übereinstimmungstyp außer Kraft. Hinzufügen: Optional. Wenn Sie kein Gebot festlegen, wird es abhängig von der Währung Ihres Kontos auf das Minimum festgelegt. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. |
Gebot |
| CpmBid | Reserviert. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den CpmBid-Wert in das ReturnAdditionalFields-Element ein, wenn Sie die Dienstvorgänge GetAdGroupsByCampaignId und GetAdGroupsByIds aufrufen. |
Gebot |
| CpvBid | Reserviert. Dieses Element wird standardmäßig nicht zurückgegeben. Um dieses Element abzurufen, schließen Sie den Cpv-Wert in das ReturnAdditionalFields-Element ein, wenn Sie die GetAdGroupsByCampaignId - und GetAdGroupsByIds-Dienstvorgänge aufrufen. |
Gebot |
| EndDate | Das Datum, an dem die Anzeigen in der Anzeigengruppe ablaufen. Wenn Sie kein Enddatum angeben, laufen die Anzeigen nicht ab. Das Enddatum kann verlängert werden, um die Anzeigen einer Anzeigengruppe auch nach Ablauf der Anzeigengruppe zu liefern. Das Enddatum ist inklusive. Wenn Sie z. B . EndDate auf den 31.12.2020 festlegen, laufen die Anzeigen in der Anzeigengruppe am 31.12.2020 um 23:59 Uhr ab. Die Uhrzeit basiert auf der Zeitzone, die Sie auf Kampagnenebene angeben. Hinzufügen: Optional. Um beim Hinzufügen einer Anzeigengruppe kein Enddatum festzulegen, legen Sie dieses Element auf NULL fest. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um die vorhandene Enddatumseinstellung zu löschen und beim Aktualisieren einer Anzeigengruppe effektiv kein Enddatum festzulegen, legen Sie das Enddatum auf den 2. Januar 2050 oder später fest. Wenn Sie die Anzeigengruppe das nächste Mal abrufen, ist dieses Element null, d. h. es wird nicht auf den 2. Januar 2050 festgelegt. |
Date |
| 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: Optional Aktualisieren: Optional. 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 |
| FrequencyCapSettings | Einstellungen für die Häufigkeitsgrenze. | FrequencyCapSettings-Array |
| Id | Der vom System generierte Bezeichner der Anzeigengruppe. Hinzufügen: Nicht zulässig. Aktualisieren: Schreibgeschützt und erforderlich |
Lange |
| Sprache | 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. Die unterstützten Sprachzeichenfolgen für Such- und Shopping-Kampagnen sind: Bulgarisch, Kroatisch, Tschechisch, Dänisch, Niederländisch, Englisch, Estnisch, Finnisch, Französisch, Deutsch, Griechisch, Ungarisch, Italienisch, Lettisch, Litauisch, Maltesisch, Norwegisch, Polnisch, Portugiesisch, Rumänisch, Slowakisch, Slowenisch, Spanisch, Schwedisch und TraditionellChinesisch. HINWEIS: Die folgenden Sprachen sind noch nicht für jeden verfügbar: Bulgarisch, Kroatisch, Tschechisch, Estnisch, Griechisch, Ungarisch, Lettisch, Litauisch, Maltesisch, Polnisch, Rumänisch, Slowenisch, Slowenisch. 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. Für Anzeigengruppen in Zielgruppenkampagnen wird die Sprache auf Anzeigengruppenebene nicht unterstützt, und Sie müssen das Sprachelement der Kampagne der Anzeigengruppe auf "Alle" festlegen. Hinzufügen: Optional, wenn für die Kampagne mindestens eine Sprache festgelegt ist, andernfalls ist die Sprache für die meisten Kampagnentypen erforderlich. Sie dürfen dieses Element nicht für Anzeigengruppen in Zielgruppenkampagnen festlegen. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Um die Sprache zu entfernen und auf die Sprachen auf Kampagnenebene zu verschieben, legen Sie dieses Element auf einen leeren Zeichenfolgenwert (""") fest. |
Zeichenfolge |
| McpaBid | Reserviert. | Gebot |
| MultimediaAdsBidAdjustment | Reserviert. | int |
| Name | Der Name der Anzeigengruppe. Der Name muss für alle aktiven Anzeigengruppen innerhalb der Kampagne eindeutig sein. Der Name darf maximal 256 Zeichen enthalten. Hinzufügen: Erforderlich Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. |
Zeichenfolge |
| Netzwerk | Die Suchnetzwerke, in denen Ihre Anzeigen angezeigt werden sollen. Unterstützte Netzwerkwerte für Anzeigengruppen in den meisten Kampagnentypen sind OwnedAndOperatedAndSyndicatedSearch, OwnedAndOperatedOnly und SyndicatedSearchOnly. Für Anzeigengruppen in Zielgruppenkampagnen wird das Netzwerk auf Anzeigengruppenebene nicht unterstützt. Die Anzeigengruppen befinden sich im Microsoft Audience Network. Für Anzeigengruppen in Smart Shopping-Kampagnen können Sie das Netzwerk nicht festlegen. Der Dienst legt das Netzwerk auf OwnedAndOperatedAndSyndicatedSearch fest. Für Anzeigengruppen in Shoppingkampagnen für Marken wird zusätzlich zu OwnedAndOperatedAndSyndicatedSearch, OwnedAndOperatedOnly und SyndicatedSearchonly das InHousePromotion-Netzwerk (nur Händlernetzwerk) unterstützt. Wenn Sie eine der Syndizierungssuchoptionen auswählen, können Sie den Vorgang SetNegativeSitesToAdGroups oder SetNegativeSitesToCampaigns aufrufen, um zu verhindern, dass die Anzeigen auf bestimmten Syndizierungssuchwebsites angezeigt werden. Weitere Informationen zu Netzwerken und der Anzeigenverteilung finden Sie im Hilfeartikel Informationen zur Anzeigenverteilung . Hinzufügen: Optional. Der Standardwert ist OwnedAndOperatedAndSyndicatedSearch. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. |
Netzwerk |
| PercentCpcBid | Reserviert. | RateBid |
| PrivacyStatus | Gibt an, ob die Zielgruppenkriterien Ihrer Anzeigengruppe (z. B. ProfileCriterion ) für Anzeigengruppen in Zielgruppenkampagnen zu eng sind. Hinzufügen: Schreibgeschützt Aktualisieren: Schreibgeschützt |
AdGroupPrivacyStatus |
| Einstellungen | Die Anzeigengruppeneinstellungen, die in der Regel je nach Kampagnentyp variieren. Sie können maximal ein Objekt pro Einstellungstyp in die Liste der Einstellungen aufnehmen, z. B. ein TargetSetting-Objekt. TargetSetting kann mit jedem Kampagnentyp verwendet werden und bestimmt, ob die Kriterien Age, Audience, CompanyName, Gender, Industry und JobFunction, die dieser Anzeigengruppe zugeordnet sind, die Option "Ziel und Gebot" oder die Option "Nur Gebot" verwenden. Innerhalb von TargetSetting können Mehrere TargetSettingDetail-Objekte vorhanden sein, d. h. eines pro CriterionTypeGroup. Hinzufügen: Optional. Wenn dieses Element kein TargetSetting-Objekt enthält, ist die Standardgebotsoption für alle Kriterientypgruppen effektiv "nur geboten". Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. |
Festlegen des Arrays |
| StartDate | Das Datum, an dem die Anzeigen in der Anzeigengruppe beginnen können; Andernfalls kann der Dienst mit der Bereitstellung der Anzeigen in der Anzeigengruppe beginnen, wenn die Anzeigengruppe aktiv wird. Das Startdatum ist inklusive. Wenn Sie beispielsweise das Startdatum auf den 5.05.2021 festlegen, beginnen die Anzeigen in der Anzeigengruppe am 5.05.2021 um 12:00 Uhr. Die Uhrzeit basiert auf der Zeitzone, die Sie auf Kampagnenebene angeben. Hinzufügen: Optional. Wenn Sie das Startdatum nicht festlegen, wird es standardmäßig auf das heutige Datum festgelegt, und der Dienst kann mit der Bereitstellung der Anzeigen in der Anzeigengruppe beginnen, sobald die Anzeigengruppe status aktiv ist. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. Das Startdatum kann nicht aktualisiert werden, nachdem die Anzeigengruppe übermittelt wurde, d. h., sobald der Starttermin eingetroffen ist. |
Date |
| Status | Die status der Anzeigengruppe. Mögliche Werte sind Aktiv, Abgelaufen und Angehalten. Die abgelaufene status ist schreibgeschützt. Hinzufügen: Optional. Der Standardwert ist Angehalten. Aktualisieren: Optional. Wenn für das Update kein Wert festgelegt ist, wird diese Einstellung nicht geändert. |
AdGroupStatus |
| TrackingUrlTemplate | Die Nachverfolgungsvorlage, die als Standard für alle URLs in Ihrer Anzeigengruppe 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: Optional Aktualisieren: Optional. 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: Optional Aktualisieren: Optional. 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 |
| UseOptimizedTargeting | Dies ist veraltet. Verwenden Sie stattdessen UsePredictiveTargeting . | boolean |
| UsePredictiveTargeting | Gibt an, ob predictive targeting für eine AdGroup aktiviert ist. Hinweis: UsePredictiveTargeting ist nur für Zielgruppenkampagnen verfügbar. Hinzufügen: Optional Aktualisieren: Optional. |
boolean |
Anforderungen
Dienst: CampaignManagementService.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13
Verwendet von
AddAdGroups
GetAdGroupsByCampaignId
GetAdGroupsByIds
UpdateAdGroups