Freigeben über

TextAd-Datenobjekt – Kampagnenverwaltung

  • Artikel

Definiert eine Textanzeige.

Wichtig

Ab April 2020 wird die Übermittlung von Standart-Textanzeigen (STA) nicht mehr unterstützt.

Standard Textanzeigen wurden zugunsten von erweiterten Textanzeigen (EXTAs) als veraltet gekennzeichnet. Die Unterstützung für das Hinzufügen und Aktualisieren von Standardtextanzeigen (STAs) endete am 31. Juli 2017. Jetzt können Werbetreibende abrufen und löschen, aber keine neuen STAs mehr hinzufügen oder vorhandene Standardtextanzeigen aktualisieren. Eine Ausnahme von der Regel besteht darin, dass Sie die STA-status z. B. von Aktiv auf Angehalten aktualisieren können. Andernfalls führt das Hinzufügen oder Aktualisieren von STAs zum CampaignServiceAdTypeInvalid-Fehler .

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

Elemente

Das TextAd-Objekt verfügt über die folgenden Elemente: DestinationUrl, DisplayUrl, Text, Title.

Element Beschreibung Datentyp
DestinationUrl Die URL der Webseite, zu der der Benutzer gelangen soll, wenn er auf die Anzeige klickt.

Die URL kann dynamische Parameter wie {MatchType} enthalten.

Eine Liste der unterstützten Parameter finden Sie im Microsoft Advertising-Hilfeartikel Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?.

Die URL darf maximal 1.024 Zeichen enthalten. Wenn die URL kein Protokoll angibt, verwendet das System das HTTP-Protokoll, wenn ein Benutzer auf die Anzeige klickt. Wenn die URL das HTTP-Protokoll angibt, wenn Sie eine Anzeige hinzufügen, entfernt der Dienst die http:// Protokollzeichenfolge (die HTTP-Protokollzeichenfolge zählt nicht auf den Grenzwert von 1.024 Zeichen); Der Dienst entfernt jedoch keine HTTPS-Protokollzeichenfolge (https://) aus der URL.

Wichtig: Wenn Sie derzeit Ziel-URLs verwenden, müssen Sie diese durch endgültige URLs ersetzen. Weitere Informationen finden Sie unter URL-Nachverfolgung mit aktualisierten URLs.

Diese URL wird nur verwendet, wenn die Schlüsselwort (keyword) keine Ziel-URL angibt.

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolge
DisplayUrl Die URL, die in der Anzeige angezeigt werden soll.

Das Unterverzeichnis der Anzeige-URL kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Der URL-Hostname darf jedoch keinen dynamischen Text enthalten. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.

Die maximale Eingabelänge der URL beträgt 200 Zeichen und kann dynamische Textzeichenfolgen enthalten. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 35 Zeichen überschreitet, nachdem der dynamische Text ersetzt wurde.

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolge
Text Die Anzeigenkopie. Die Kopie muss mindestens ein Wort enthalten. Die Kopie und der Titel der Anzeige müssen zusammen mindestens drei Wörter enthalten.

Der Text kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.

Die maximale Eingabelänge der Kopie beträgt 300 Zeichen und kann dynamische Textzeichenfolgen enthalten. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 71 Zeichen nach der dynamischen Textersetzung überschreitet. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, der Text nach der Ersetzung auf 38 Zeichen beschränkt ist.

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

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolge
Title Der Titel der Anzeige. Der Titel muss mindestens ein Wort enthalten. Die Kopie und der Titel der Anzeige müssen zusammen mindestens drei Wörter enthalten.

Der Titel kann dynamische Textzeichenfolgen wie {Schlüsselwort (keyword)} enthalten. Weitere Informationen finden Sie im Microsoft Advertising-Hilfeartikel Automatisches Anpassen Ihrer Anzeigen mit dynamischen Textparametern.

Die maximale Eingabelänge des Titels beträgt 80 Zeichen und kann dynamische Textzeichenfolgen enthalten. Die Anzeige kann nicht angezeigt werden, oder Standardtext wird verwendet, wenn die Länge 25 Zeichen nach der dynamischen Textersetzung überschreitet. Beachten Sie, dass für Anzeigengruppen, die traditionelles Chinesisch verwenden, der Titel nach der Ersetzung auf 15 Zeichen beschränkt ist.

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

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolge

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

Geerbte Elemente

Geerbte Elemente von Ad

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

Element Beschreibung Datentyp
AdFormatPreference Die Anzeigenformateinstellung wird verwendet, um anzugeben, ob Sie die Anzeigenkopie den Benutzern als Such- oder Zielgruppenanzeige anzeigen möchten oder nicht. Suchanzeigen werden in der Regel als Handlungsaufforderung geschrieben, während Zielgruppenanzeigen eher informativ geschrieben werden sollten. Während Sie die Möglichkeit haben, Suchtextanzeigen als Zielgruppenanzeigen zu verwenden, können Sie eine Anzeige als bevorzugtes Format für Zielgruppenanzeigen festlegen, um deren Messaging für die native Übermittlung zu optimieren.

WICHTIG: Sie müssen mindestens eine Textanzeige pro Anzeigengruppe definieren, die keine Zielgruppenanzeigen bevorzugt. Andernfalls ist die Anzeigenkopie aller Textanzeigen sowohl für Such- als auch für Zielgruppenanzeigen geeignet.

Mögliche Werte sind AudienceAd und All. Wenn diese Option auf Alle festgelegt ist, ist die Anzeige sowohl für such- als auch für Zielgruppenanzeigenformate geeignet. Bei Festlegung auf AudienceAd ist die Anzeige nur für das Zielgruppenanzeigenformat geeignet.

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolge
DevicePreference Dieses Element bestimmt, ob Textanzeigen auf mobilen Geräten oder auf allen Geräten angezeigt werden sollen.

Um eine Einstellung für mobile Geräte anzugeben, legen Sie dieses Element auf 30001 fest.

Um alle Geräte anzugeben, legen Sie dieses Element auf 0 (null) fest, oder lassen Sie das Element null. Standardmäßig ist dieses Element null. Sie müssen mindestens eine Textanzeige pro Anzeigengruppe definieren, die nicht für mobilgeräte bevorzugt ist. Andernfalls ist die Anzeige für alle Geräte geeignet.

Hinzufügen: Nicht unterstützt
Aktualisieren: 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: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 AdEditorialStatus
FinalAppUrls Wird für Textanzeigen nicht unterstützt. AppUrl-Array
FinalMobileUrls Die URL der mobilen Landing Page.

Diese URL wird nur verwendet, wenn die Schlüsselwort (keyword) keine endgültige mobile URL angibt.

Die folgenden Überprüfungsregeln gelten für endgültige URLs und endgültige mobile URLs.
– Die Länge der URL ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
– Sie können bis zu 10 Elemente für FinalUrls und FinalMobileUrls angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10, um potenzielle Vorwärtskompatibilität zu erzielen.
- Die Verwendung von "{" und "}" ist nur zum Abgrenzen von Tags zulässig, z. B. {lpurl}.
- Endgültige URLs müssen jeweils eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
– Wenn Sie FinalMobileUrls angeben, müssen Sie auch FinalUrls angeben.
– Sie dürfen FinalMobileUrls nicht angeben, wenn die Geräteeinstellung auf "Mobil" festgelegt ist. Beachten Sie außerdem, dass Sie für TextAd-Objekte nicht FinalMobileUrls angeben dürfen, wenn DevicePreference auf 30001 (mobil) festgelegt ist.

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolgenarray
FinalUrls Die URL der Landing Page.

Diese URL wird nur verwendet, wenn die Schlüsselwort (keyword) keine endgültige URL angibt.

Die folgenden Überprüfungsregeln gelten für endgültige URLs und endgültige mobile URLs.
– Die Länge der URL ist auf 2.048 Zeichen beschränkt. Die HTTP- oder HTTPS-Protokollzeichenfolge wird auf den Grenzwert von 2.048 Zeichen angerechnet.
– Sie können bis zu 10 Elemente für FinalUrls und FinalMobileUrls angeben. für die Lieferung wird jedoch nur der erste Artikel in jeder Liste verwendet. Der Dienst ermöglicht bis zu 10, um potenzielle Vorwärtskompatibilität zu erzielen.
- Die Verwendung von "{" und "}" ist nur zum Abgrenzen von Tags zulässig, z. B. {lpurl}.
- Endgültige URLs müssen jeweils eine wohlgeformte URL sein, die entweder mit http:// oder https:// beginnt.
– Wenn Sie FinalMobileUrls angeben, müssen Sie auch FinalUrls angeben.
– Sie dürfen FinalMobileUrls nicht angeben, wenn die Geräteeinstellung auf "Mobil" festgelegt ist. Beachten Sie außerdem, dass, wenn das TrackingUrlTemplate - oder UrlCustomParameters-Element dieser Anzeige festgelegt ist, mindestens eine endgültige URL erforderlich ist.

Hinzufügen: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolgenarray
FinalUrlSuffix Wird für Textanzeigen nicht unterstützt. 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
Id Der eindeutige Microsoft Advertising-Bezeichner für die Anzeige.

Hinzufügen: Nicht unterstützt
Aktualisieren: Erforderlich und schreibgeschützt		 lang
Status Die status der Anzeige.

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

Hinzufügen: Nicht unterstützt
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: Nicht unterstützt
Aktualisieren: Nicht unterstützt		 Zeichenfolge
Typ Der Typ der Anzeige. Dieser Wert ist Text , wenn Sie eine Textanzeige 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: Nicht unterstützt
Aktualisieren: Nicht unterstü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