Freigeben über


Ad

Das Basisobjekt, von dem Anzeigen, z. B. erweiterte Textanzeigen, abgeleitet werden.

Dieses Objekt stellt auch Standardtextanzeigen dar. Sie dürfen keine Standardtextanzeigen mehr erstellen, sondern sie abrufen, anhalten, entfernen und aktivieren. Die folgenden Methoden gelten nicht für abgeleitete Objekte und sollten nicht aufgerufen werden.

  • getDestinationUrl()
  • getDisplayUrl()
  • getHeadline()
  • isMobilePreferred()

Hinweis

  • Aktualisieren Sie Ihre erweiterten Textanzeigen bis zum 1. Februar 2023 auf reaktionsfähige Suchanzeigen. Nach diesem Datum können Sie keine neuen erweiterten Textanzeigen mehr erstellen oder bearbeiten. Weitere Informationen finden Sie unter Informationen zu reaktionsfähigen Suchanzeigen.
  • Vorhandene erweiterte Textanzeigen werden weiterhin bereitgestellt, und Sie können Berichte zu deren Leistung anzeigen.
  • Sie können Ihre erweiterten Textanzeigen weiterhin anhalten, aktivieren oder entfernen. Andernfalls führen Versuche, erweiterte Textanzeigen hinzuzufügen oder zu aktualisieren, zu einem CampaignServiceAdTypeInvalid Fehler.
  • Erfahren Sie mehr über diese Änderung.

Methoden

Methodenname Rückgabetyp Beschreibung
applyLabel(string name) void Wendet die Bezeichnung auf diese Anzeige an.
asType AdViewSpace Enthält die Methoden, die zum Umwandeln dieser Anzeige in einen bestimmten Anzeigentyp verwendet werden.
Aktivieren void Aktiviert diese Anzeige.
getAdGroup Anzeigengruppe Ruft die Anzeigengruppe ab, zu der diese Anzeige gehört.
getCampaign Kampagnen Ruft die Kampagne ab, zu der diese Anzeige gehört.
getDescription string Ruft den Kopiertext dieser Anzeige ab.
getDestinationUrl string Ruft die URL der Webseite ab, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt.
getDisplayUrl string Ruft die URL ab, die in der Anzeige angezeigt wird.
getEntityType string Ruft den Typ dieser Entität ab.
getHeadline string Ruft den Titel dieser Anzeige ab.
Getid string Ruft die ID ab, die diese Anzeige eindeutig identifiziert.
getPolicyApprovalStatus string Ruft die redaktionelle Genehmigung dieser Anzeige status ab.
Getstats Statistiken Ruft die Leistungsdaten dieser Anzeige ab.
Gettype string Ruft den abgeleiteten Typ dieser Anzeige ab.
Isenabled Boolescher Wert Ruft einen booleschen Wert ab, der angibt, ob diese Anzeige aktiviert ist.
isMobilePreferred Boolescher Wert Ruft einen booleschen Wert ab, der angibt, ob diese Anzeige auf mobilen Oder allen Geräten angezeigt werden soll.
isPaused Boolesch Ruft einen booleschen Wert ab, der angibt, ob diese Anzeige angehalten ist.
isType AdTypeSpace Enthält die Methoden, die verwendet werden, um zu testen, ob eine Anzeige den angegebenen Typ aufweist.
Etiketten LabelSelector Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen verwendet wird, die dieser Anzeige zugeordnet sind.
anhalten void Hält diese Anzeige an.
remove void Entfernt diese Anzeige.
removeLabel(string name) void Entfernt die Bezeichnung aus dieser Anzeige.
Urls AdUrls Enthält die Methoden, die zum Abrufen der endgültigen URLs, der Nachverfolgungsvorlage und der benutzerdefinierten Parameter dieser Anzeige verwendet werden.

applyLabel(string name)

Wendet die Bezeichnung auf die Anzeige an.

Sie können maximal 50 Bezeichnungen auf eine Anzeige anwenden. Ein Beispiel, in dem einer Entität eine Bezeichnung hinzugefügt wird, finden Sie unter Verwenden von Bezeichnungen.

Argumente

Name Typ Beschreibung
name string Der Name der Bezeichnung, bei dem die Groß-/Kleinschreibung beachtet wird. Eine Liste der Bezeichnungen in diesem Konto, die Sie anwenden können, finden Sie unter AdsApp.labels.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

asType

Enthält die Methoden, die zum Umwandeln dieser Anzeige in einen bestimmten Anzeigentyp verwendet werden.

Rückgabewerte

Typ Beschreibung
AdViewSpace Enthält die Methoden, die zum Umwandeln dieser Anzeige in einen bestimmten Anzeigentyp verwendet werden.

Aktivieren

Aktiviert diese Anzeige.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

getAdGroup

Ruft die Anzeigengruppe ab, zu der diese Anzeige gehört.

Rückgabewerte

Typ Beschreibung
Anzeigengruppe Die Anzeigengruppe, zu der diese Anzeige gehört.

getCampaign

Ruft die Kampagne ab, zu der diese Anzeige gehört.

Rückgabewerte

Typ Beschreibung
Kampagnen Die Kampagne, zu der diese Anzeige gehört.

getDescription

Ruft den Kopiertext dieser Anzeige ab.

Rückgabewerte

Typ Beschreibung
string Der Kopiertext der Anzeige.

getDestinationUrl

Ruft die URL der Webseite ab, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt.

Rückgabewerte

Typ Beschreibung
string Die URL der Webseite, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt. Gibt NULL zurück, wenn es von einem abgeleiteten Objekt aufgerufen wird.

getDisplayUrl

Ruft die URL ab, die in der Anzeige angezeigt wird.

Rückgabewerte

Typ Beschreibung
string Die URL, die in der Anzeige angezeigt wird. Gibt NULL zurück, wenn es von einem abgeleiteten Objekt aufgerufen wird.

getEntityType

Ruft den Typ dieser Entität ab.

Rückgabewerte

Typ Beschreibung
string Der Typ dieser Entität, d. h. Ad.

getHeadline

Ruft den Titel dieser Anzeige ab.

Rückgabewerte

Typ Beschreibung
string Der Titel der Anzeige. Gibt NULL zurück, wenn es von einem abgeleiteten Objekt aufgerufen wird.

Getid

Ruft die ID ab, die diese Anzeige eindeutig identifiziert.

Rückgabewerte

Typ Beschreibung
string Die ID, die diese Anzeige eindeutig identifiziert.

getPolicyApprovalStatus

Ruft die redaktionelle Genehmigung dieser Anzeige status ab.

Rückgabewerte

Typ Beschreibung
string Die redaktionelle Genehmigung der Anzeige status. Im Folgenden sind die möglichen Werte aufgeführt.
  • GENEHMIGT
  • APPROVED_LIMITED
  • UNDER_REVIEW
  • ABGELEHNT

Getstats

Ruft die Leistungsdaten dieser Anzeige ab.

Um diese Methode aufzurufen, müssen Sie eine der forDateRange Methoden in die Kette der Anzeigenauswahl einschließen.

Rückgabewerte

Typ Beschreibung
Statistiken Die Leistungsdaten der Anzeige.

Gettype

Ruft den abgeleiteten Typ dieser Anzeige ab.

Rückgabewerte

Typ Beschreibung
string Der abgeleitete Typ dieser Anzeige. Im Folgenden sind die möglichen Typen aufgeführt.
  • EXPANDED_TEXT_AD
.

isEnabled

Ruft einen booleschen Wert ab, der angibt, ob diese Anzeige aktiviert ist.

Rückgabewerte

Typ Beschreibung
Boolescher Wert Ist true , wenn diese Anzeige aktiviert ist; andernfalls false.

isMobilePreferred

Ruft einen booleschen Wert ab, der angibt, ob diese Anzeige auf mobilen Oder allen Geräten angezeigt werden soll.

Rückgabewerte

Typ Beschreibung
Boolescher Wert Ist true , wenn diese Anzeige bevorzugt auf mobilen Geräten angezeigt wird. Wenn false, ist die Einstellung, dass diese Anzeige auf allen Geräten angezeigt wird.

isPaused

Ruft einen booleschen Wert ab, der angibt, ob diese Anzeige angehalten ist.

Rückgabewerte

Typ Beschreibung
Boolescher Wert Ist true , wenn diese Anzeige angehalten wird; andernfalls false.

isType

Enthält die Methoden, die verwendet werden, um zu testen, ob eine Anzeige den angegebenen Typ aufweist.

Rückgabewerte

Typ Beschreibung
AdTypeSpace Enthält die Methoden, die verwendet werden, um zu testen, ob eine Anzeige den angegebenen Typ aufweist.

Etiketten

Ruft einen Selektor ab, der zum Filtern der Liste der Bezeichnungen verwendet wird, die dieser Anzeige zugeordnet sind.

Rückgabewerte

Typ Beschreibung
LabelSelector Ein Selektor, der zum Filtern der Liste der Bezeichnungen verwendet wird, die dieser Anzeige zugeordnet sind.

anhalten

Hält diese Anzeige an.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

Entfernen

Entfernt diese Anzeige.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

removeLabel(string name)

Entfernt die Bezeichnung aus der Anzeige.

Argumente

Name Typ Beschreibung
name string Der Name der Bezeichnung, bei dem die Groß-/Kleinschreibung beachtet wird. Eine Liste der Bezeichnungen, die dieser Anzeige zugeordnet sind, finden Sie unter Bezeichnungen.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

urls

Enthält die Methoden, die zum Abrufen der endgültigen URLs, der Nachverfolgungsvorlage und der benutzerdefinierten Parameter dieser Anzeige verwendet werden.

Rückgabewerte

Typ Beschreibung
AdUrls Das Objekt, mit dem die endgültigen URLs, die Nachverfolgungsvorlage und die benutzerdefinierten Parameter dieser Anzeige abgerufen werden.

Siehe auch