Freigeben über

DynamicSearchAd-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine dynamische Suchanzeige.

Bei dynamischen Suchanzeigen werden die Überschrift und die Anzeige-URL automatisch basierend auf der Websitedomäne und sprache generiert, die Sie als Ziel verwenden möchten. Die Kombination der Elemente Path1, Path2 und Text macht die dynamische Suchanzeige eindeutig. Optional können Sie eine statische Überschrift mithilfe von Seitenfeeds bereitstellen.

Hinweis

Dieses Feature ist derzeit in den folgenden Ländern oder Regionen verfügbar: Albanien (AL), Andorra (AD), Argentinien (AR), Aruba, Australien (AU), Österreich (AT), Bahamas (BS), Bangladesch(BD), Belgien (BE), Bolivien(BO), Bosnien und Herzegowina (BA), Brasilien (BR), Brunei(BN), Bulgarien (BG), Kanada (CA), Kaimaninseln (KY), Chile(CL), Kolumbien (CO), Costa Rica(CR), Kroatien (HR), Zypern (CY), Tschechische Republik (CZ), Dänemark (DK), Dominica(DM), Dominikanische Republik(DO), Ecuador(EG), El Salvador(SV), Estland (EE), Fidschi (FJ), Finnland (FI), Frankreich (FR), Französisch-Guaynana(GF), Französisch-Polynesien (PF), Deutschland (DE), Griechenland (GR), Guam (GU), Guatemala (GT), Guyana (GY), Haiti (HT), Honduras (HN), Ungarn (HU), Island (IS), Indien (IN), Indonesien (ID), Irland (IE), Italien (IT), Lettland (LV), Liechtenstein (LI), Litauen (LT), Luxemburg (LU), Malaysia (MY), Malediven (MV), Malta (MT), Martinique (MQ), Mexiko (MX), Monaco (MC), Mongolei (MN), Montenegro (ME), Montserrat (MS), Nepal (NP), Niederlande (NL), Neukaledonien (NC), Neuseeland (NZ), Republik Nordmazedonien (MK), Norwegen (NO), Panama (PA), Paraguay (PY), Papua-Neuguinea (PG), Peru (PE), Philippinen (PH), Polen (PO), Portugal (PT), Puerto Rico, Rumänien (RO), San Marino (SM), Serbien (RS), Singapur (SG), Slowakei (SK), Slowenien (SI), Südafrika (ZA), Spanien (ES), Sri Lanka (LK), Schweden (SE), Schweiz (CH), Thailand (TH), Trinidad und Tobago(TT), Türkei (TR), Vatikanstadt (VA), Vietnam (VN), Vereinigtes Königreich (UK), USA (USA), Uruguay (UY) und Venezuela (VE).

Dynamische Suchanzeigen können nur innerhalb von Suchkampagnen erstellt werden, die über dynamicSearchAdsSetting verfügen. Das ExperimentId-Element der Kampagne kann nicht festgelegt werden, und adGroupType muss auf "SearchDynamic" festgelegt werden.

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.

<xs:complexType name="DynamicSearchAd" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:complexContent mixed="false">
    <xs:extension base="tns:Ad">
      <xs:sequence>
        <xs:element minOccurs="0" name="Path1" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Path2" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="Text" nillable="true" type="xs:string" />
        <xs:element minOccurs="0" name="TextPart2" nillable="true" type="xs:string" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Elemente

Das DynamicSearchAd-Objekt weist die folgenden Elemente auf: Path1, Path2, Text, TextPart2.

Element Beschreibung Datentyp
Pfad 1 Der erste Teil des optionalen Pfads, der an den Domänenteil Ihrer Anzeige-URL angefügt wird. Die Anzeige-URL z.B. www.contoso.com wird aus der Domäne Ihrer Anzeige-URL generiert. Wenn Sie dann einen Wert für Path 1 angegeben haben, wird dieser an die Anzeige-URL angefügt. Wenn Sie auch einen Wert für Pfad 2 angegeben haben, wird dieser auch an die Anzeige-URL nach Pfad 1 angefügt. Wenn Ihre Domäne z. B. contoso.com ist, Pfad 1 auf Unterverzeichnis1 und Pfad 2 auf Unterverzeichnis2 festgelegt ist, wird die angezeigte URL www.contoso.com/subdirectory1/subdirectory2.

Die maximale Eingabelänge des Pfads beträgt 15 Zeichen. Beachten Sie, dass für Sprachen mit Zeichen mit doppelter Breite, z. B. traditionellem Chinesisch, die maximale Eingabelänge des Pfads 7 Zeichen beträgt.

Der Pfad kann IF - und Countdownfunktionen enthalten. Unabhängig von der Gesamtlänge aller nicht substituierten Countdownparameter verwendet der letzte angezeigte Countdown immer 8 Zeichen der insgesamt verfügbaren Zeichen. Weitere Informationen finden Sie unter Countdown Customizer.

Der Pfad darf keinen Schrägstrich (/) oder Zeilenvorschubzeichen (\n) enthalten.

Wenn der Pfad ein Leerzeichen enthält, wird er durch einen Unterstrich (_) ersetzt, wenn die Anzeige angezeigt wird.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei		 Zeichenfolge
Pfad 2 Der zweite Teil des optionalen Pfads, der an den Domänenteil Ihrer Anzeige-URL angefügt wird. Die Anzeige-URL, z. B. www.contoso.com , wird aus der Domäne Ihrer Einstellungen auf Kampagnenebene für dynamische Suchanzeigen generiert. Wenn Sie dann einen Wert für Path 1 angegeben haben, wird dieser an die Anzeige-URL angefügt. Wenn Sie auch einen Wert für Pfad 2 angegeben haben, wird dieser auch an die Anzeige-URL nach Pfad 1 angefügt. Wenn Ihre Domäne z. B. contoso.com ist, Pfad 1 auf Unterverzeichnis1 und Pfad 2 auf Unterverzeichnis2 festgelegt ist, wird die angezeigte URL www.contoso.com/subdirectory1/subdirectory2.

Sie können Path2 nur angeben, wenn Path1 ebenfalls festgelegt ist.

Die maximale Eingabelänge des Pfads beträgt 15 Zeichen. Beachten Sie, dass für Sprachen mit Zeichen mit doppelter Breite, z. B. traditionellem Chinesisch, die maximale Eingabelänge des Pfads 7 Zeichen beträgt.

Der Pfad kann IF - und Countdownfunktionen enthalten. Unabhängig von der Gesamtlänge aller nicht substituierten Countdownparameter verwendet der letzte angezeigte Countdown immer 8 Zeichen der insgesamt verfügbaren Zeichen. Weitere Informationen finden Sie unter Countdown Customizer.

Der Pfad darf keinen Schrägstrich (/) oder Zeilenvorschubzeichen (\n) enthalten.

Wenn der Pfad ein Leerzeichen enthält, wird er durch einen Unterstrich (_) ersetzt, wenn die Anzeige angezeigt wird.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei		 Zeichenfolge
Text Der erste Teil der Anzeigenbeschreibung.

Der Text muss mindestens ein Wort enthalten.

Die maximale Eingabelänge der Kopie beträgt 90 Zeichen. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, die maximale Eingabelänge der Kopie 45 Zeichen beträgt.

Der Text kann IF - und Countdownfunktionen enthalten. Unabhängig von der Gesamtlänge aller nicht substituierten Countdownparameter verwendet der letzte angezeigte Countdown immer 8 Zeichen der insgesamt verfügbaren Zeichen. Weitere Informationen finden Sie unter Countdown Customizer.

Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten.

Hinzufügen: Erforderlich
Aktualisieren: Wahlfrei		 Zeichenfolge
TextPart2 Der zweite Teil der Anzeigenbeschreibung.

Der Text muss mindestens ein Wort enthalten.

Die maximale Eingabelänge der Kopie beträgt 90 Zeichen. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, die maximale Eingabelänge der Kopie 45 Zeichen beträgt.

Der Text kann IF - und Countdownfunktionen enthalten. Unabhängig von der Gesamtlänge aller nicht substituierten Countdownparameter verwendet der letzte angezeigte Countdown immer 8 Zeichen der insgesamt verfügbaren Zeichen. Weitere Informationen finden Sie unter Countdown Customizer.

Der Text darf das Zeilenumbruchzeichen (\n) nicht enthalten.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei		 Zeichenfolge

Das DynamicSearchAd-Objekt verfügt über geerbte Elemente.

Geerbte Elemente

Geerbte Elemente von Ad

Das DynamicSearchAd-Objekt wird vom Ad-Objekt abgeleitet und erbt die folgenden Elemente: AdFormatPreference, DevicePreference, EditorialStatus, FinalAppUrls, FinalMobileUrls, FinalUrls, FinalUrlSuffix, ForwardCompatibilityMap, Id, Status, TrackingUrlTemplate, Type, UrlCustomParameters. Die folgenden Beschreibungen gelten spezifisch für DynamicSearchAd und gelten möglicherweise nicht für andere Objekte, die dieselben Elemente vom Ad-Objekt erben.

Element Beschreibung Datentyp
AdFormatPreference Wird für diesen Anzeigentyp nicht unterstützt. Zeichenfolge
DevicePreference Wird für diesen Anzeigentyp nicht unterstützt. lang
EditorialStatus Die redaktionelle Überprüfung status der Anzeige, die angibt, ob die Anzeige überprüft, genehmigt oder abgelehnt wurde.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 AdEditorialStatus
FinalAppUrls Wird für diesen Anzeigentyp nicht unterstützt. AppUrl-Array
FinalMobileUrls Wird für diesen Anzeigentyp nicht unterstützt. Zeichenfolgenarray
FinalUrls Wird für diesen Anzeigentyp nicht unterstützt. Zeichenfolgenarray
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.

Derzeit werden für dynamische Suchanzeigen keine Schlüssel- und Wertpaare für die Vorwärtskompatibilitätszuordnung unterstützt.		 KeyValuePairOfstring-Array
Id Der eindeutige Microsoft Advertising-Bezeichner der Anzeige.

Hinzufügen: Schreibgeschützt
Aktualisieren: Erforderlich und Read-Only		 lang
Status Die status der Anzeige.

Sie können die Anzeige status auf Aktiv oder Angehalten festlegen.

Hinzufügen: Wahlfrei
Aktualisieren: Wahlfrei		 AdStatus
TrackingUrlTemplate Die Nachverfolgungsvorlage, die als Standard für alle Landing Page-URLs 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
Typ Der Typ der Anzeige. Dieser Wert ist DynamicSearch , wenn Sie eine dynamische Suchanzeige abrufen. Weitere Informationen zu Anzeigentypen finden Sie in den Hinweisen zu Ad Data Object.For more information about ad types, see the Ad Data Object Remarks.

Hinzufügen: Schreibgeschützt
Aktualisieren: Schreibgeschützt		 AdType
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