KeywordBuilder

Enthält die Methoden zum Definieren und Erstellen eines Schlüsselworts (Keyword). Informationen zu Buildern finden Sie unter Builder.

Hinweis

Anstelle von Ausdrucksübereinstimmung dienen jetzt alle Schlüsselwörter mit Modifizierern für weite Übereinstimmung als Schlüsselwörter mit weiter Übereinstimmung für Suchanzeigen. Weitere Informationen zu Schlüsselwort (keyword)-Match-Optionen.

Anwendungsbeispiel:

    var operation = adGroup.newKeywordBuilder()
        .withText("KEYWORD TEXT GOES HERE")
        .withCpc(0.5)
        .withFinalUrl("http://www.contoso.com")
        .build();

    // See the Builders topic for performance considerations
    // when using the operation object's methods.
    if (!operation.isSuccessful()) {
        for (var error of operation.getErrors()) {
            Logger.log(`${error}\n`);
        }
    }

Methoden

Methodenname	Rückgabetyp	Beschreibung
build	KeywordOperation	Erstellt das Schlüsselwort (keyword) und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob das Schlüsselwort (keyword) erfolgreich hinzugefügt wurde.
withCpc(double cpc)	KeywordBuilder	Legt das maximale CPC-Gebot für das Schlüsselwort (Keyword) fest.
withCustomParameters(Object customParameters)	KeywordBuilder	Legt die benutzerdefinierten Parameter des Schlüsselworts (keyword) fest.
withFinalUrl(string finalUrl)	KeywordBuilder	Legt die endgültige URL des Schlüsselworts (Keyword) fest.
withMobileFinalUrl(string mobileFinalUrl)	KeywordBuilder	Legt die endgültige URL des Schlüsselworts (Keyword) für Mobilgeräte fest.
withText(string text)	KeywordBuilder	Legt den Text des Schlüsselworts (keyword) fest.
withTrackingTemplate(string trackingTemplate)	KeywordBuilder	Legt die Vorlage für die Nachverfolgung des Schlüsselworts (keyword) fest.

build

Erstellt das Schlüsselwort (keyword) und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob das Schlüsselwort (keyword) erfolgreich hinzugefügt wurde.

Rückgabewerte

Typ	Beschreibung
KeywordOperation	Ein Vorgangsobjekt, das verwendet wird, um zu überprüfen, ob das Schlüsselwort (Keyword) erfolgreich hinzugefügt wurde.

withCpc(double cpc)

Legt das maximale CPC-Gebot für das Schlüsselwort (Keyword) fest.

Gibt den Gebotsbetrag an, der verwendet werden soll, wenn das Schlüsselwort (Keyword) mit dem Suchbegriff des Benutzers übereinstimmt. Gilt nur, wenn die Gebotsstrategie der Anzeigengruppe auf MANUAL_CPC festgelegt ist.

Rufen Sie diese Methode nicht auf, wenn Sie den auf Anzeigengruppenebene angegebenen Gebotsbetrag verwenden möchten.

Weitere Informationen zu Angebotsbeträgen finden Sie unter Bid und BiddingScheme.

Argumente

Name	Typ	Beschreibung
CPC	double	Das maximale CPC-Gebot für das Schlüsselwort (Keyword). Die Währung des Kontos bestimmt die Mindest- und Höchstgebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen.

Rückgabewerte

Typ	Beschreibung
KeywordBuilder	Keyword-Generator mit angewendetem CPC-Gebot.

withCustomParameters(Object customParameters)

Legt die benutzerdefinierten Parameter des Schlüsselworts (keyword) fest.

Benutzerdefinierte Parameter sind hilfreich, um dynamische Informationen über mehrere URLs hinweg freizugeben. Weitere Informationen zu seiner Verwendung finden Sie unter Benutzerdefinierte Parameter.

Argumente

Name	Typ	Beschreibung
customParameters	Objekt	Eine Zuordnung von bis zu benutzerdefinierten Parametern, die auf die endgültige URL des Schlüsselworts (Keyword) angewendet werden können. Beispiel: {key1: 'value1', key2: 'value2', key3: 'value3'}, wobei key der Name des benutzerdefinierten Parameters und der Wert der Wert des Parameters ist. Der Name darf maximal 16 8-Byte-Zeichen enthalten, und der Wert darf maximal 200 8-Byte-Zeichen enthalten.

Rückgabewerte

Typ	Beschreibung
KeywordBuilder	Keyword-Generator mit angewendeten benutzerdefinierten Parametern.

withFinalUrl(string finalUrl)

Legt die endgültige URL des Schlüsselworts (Keyword) fest.

Die endgültige URL identifiziert die Webseite, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt. Wenn nicht angegeben, erbt die Entität die endgültige URL von ihrer übergeordneten Entität. Beispielsweise erbt die Schlüsselwort-Entität) die endgültige URL der Anzeige. Geben Sie die endgültige URL des Schlüsselworts (Keyword) an, um die endgültige URL der Anzeige zu überschreiben.

Weitere Informationen finden Sie unter Welche Verfolgungs- oder URL-Parameter stehen zur Verfügung?

Argumente

Name	Typ	Beschreibung
finalUrl	string	Die endgültige URL, die die Webseite identifiziert, auf die der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt.

Rückgabewerte

Typ	Beschreibung
KeywordBuilder	Keyword-Generator mit angewendeter endgültiger URL.

withMobileFinalUrl(string mobileFinalUrl)

Legt die endgültige URL des Schlüsselworts (Keyword) für Mobilgeräte fest.

Die endgültige URL identifiziert die Webseite, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt. Wenn nicht angegeben, erbt die Entität die endgültige URL von ihrer übergeordneten Entität. Beispielsweise erbt die Schlüsselwort-Entität) die endgültige URL der Anzeige. Geben Sie die endgültige URL des Schlüsselworts (Keyword) an, wenn Sie die endgültige URL der Anzeige außer Kraft setzen möchten.

Weitere Informationen finden Sie unter Welche Verfolgungs- oder URL-Parameter stehen zur Verfügung?

Um eine endgültige URL für mobile Geräte anzugeben, geben Sie zuerst eine endgültige URL für Nicht-Mobilgeräte an (siehe withFinalUrl()).

Argumente

Name	Typ	Beschreibung
mobileFinalUrl	string	Die endgültige URL für mobile Geräte.

Rückgabewerte

Typ	Beschreibung
KeywordBuilder	Keyword-Generator mit angewendeter endgültiger Mobil-URL.

withText(string text)

Legt den Text des Schlüsselworts (keyword) fest.

Verwenden Sie die folgende Syntax, um die Match-Option für das Schlüsselwort (keyword) anzugeben:

• Verwenden Sie für weite Übereinstimmung keine Syntax für den Übereinstimmungstyp (z. B keywordBuilder.withText("books"). ).
• Stellen Sie für den Modifizierer für weite Übereinstimmung dem Text ein Pluszeichen (+) vor (z. keywordBuilder.withText("+books")B. ). Hinweis: Wenn Sie versuchen, neue Modifizierer für weitgehende Übereinstimmungen (Broad Match Modifier, BMM) zu erstellen, werden diese gespeichert und als Schlüsselwörter für Ausdrucksübereinstimmungen bereitgestellt. Ihre vorhandenen BMM-Schlüsselwörter werden weiterhin unter Ausdrucksübereinstimmung angezeigt. Weitere Informationen zu Schlüsselwort (keyword)-Match-Optionen.
• Setzen Sie für die Ausdrucksübereinstimmung Anführungszeichen um den Text herum (z. B keywordBuilder.withText("\"books\""). ).
• Für eine genaue Übereinstimmung setzen Sie eckige Klammern um den Text (z. B keywordBuilder.withText("[hardcover books]"). ).

Argumente

Name	Typ	Beschreibung
text	string	Der Text des Schlüsselworts (keyword). Der Text des Schlüsselworts (keyword) ist erforderlich. Der Text darf maximal 100 Zeichen umfassen. Geben Sie den Text im Gebietsschema des Sprachwerts der Anzeigengruppe an.

Rückgabewerte

Typ	Beschreibung
KeywordBuilder	Keyword-Generator mit angewendetem Schlüsselwortwort (keyword)-Text.

withTrackingTemplate(string trackingTemplate)

Legt die Vorlage für die Nachverfolgung des Schlüsselworts (keyword) fest.

Vorlagen für die Nachverfolgung werden mit der FinalUrl des Schlüsselworts (Keyword) verwendet, um die von der Anzeige verwendete Ziel-URL zu erstellen. Weitere Informationen finden Sie unter Welche Verfolgungs- oder URL-Parameter stehen zur Verfügung?

Argumente

Name	Typ	Beschreibung
trackingTemplate	string	Die Vorlage für die Nachverfolgung, die für dieses Schlüsselwort (Keyword) verwendet werden soll.

Rückgabewerte

Typ	Beschreibung
KeywordBuilder	Keyword-Generator mit angewendeter Vorlage für die Nachverfolgung.