KeywordBuilder
Enthält die Methoden zum Definieren und Erstellen eines Schlüsselwort (keyword). Informationen zu Generatoren finden Sie unter Generatoren.
Hinweis
Alle Schlüsselwörter für den Breiteneinstimmungsmodifizierer für Suchanzeigen dienen jetzt als Allgemeine Übereinstimmungs-Schlüsselwörter anstelle von Phrase Match. Erfahren Sie mehr über Schlüsselwort (keyword) Übereinstimmungstypen.
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 |
|---|---|---|
| Bauen | KeywordOperation | Erstellt die Schlüsselwort (keyword) und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob die Schlüsselwort (keyword) erfolgreich hinzugefügt wurde. |
| withCpc(double cpc) | KeywordBuilder | Legt das maximale CPC-Gebot des Schlüsselwort (keyword) fest. |
| withCustomParameters(Object customParameters) | KeywordBuilder | Legt die benutzerdefinierten Parameter des Schlüsselwort (keyword) fest. |
| withFinalUrl(string finalUrl) | KeywordBuilder | Legt die endgültige URL des Schlüsselwort (keyword) fest. |
| withMobileFinalUrl(string mobileFinalUrl) | KeywordBuilder | Legt die endgültige URL des Schlüsselwort (keyword) für mobile Geräte fest. |
| withText(string text) | KeywordBuilder | Legt den Text des Schlüsselwort (keyword) fest. |
| withTrackingTemplate(string trackingTemplate) | KeywordBuilder | Legt die Nachverfolgungsvorlage des Schlüsselwort (keyword) fest. |
build
Erstellt die Schlüsselwort (keyword) und gibt ein Vorgangsobjekt zurück, mit dem überprüft wird, ob die Schlüsselwort (keyword) erfolgreich hinzugefügt wurde.
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| KeywordOperation | Ein Vorgangsobjekt, mit dem überprüft wird, ob die Schlüsselwort (keyword) erfolgreich hinzugefügt wurde. |
withCpc(double cpc)
Legt das maximale CPC-Gebot des 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.
Um den auf Anzeigengruppenebene angegebenen Gebotsbetrag zu verwenden, rufen Sie diese Methode nicht auf.
Weitere Informationen zu Gebotsbeträgen finden Sie unter Bid und BidScheme.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| Cpc | double | Das maximale CPC-Gebot, das für den Schlüsselwort (keyword) gelten soll. Die Währung des Kontos bestimmt die minimalen und maximalen Gebotswerte. Weitere Informationen finden Sie unter Gebots- und Budgetwährungen. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| KeywordBuilder | Schlüsselwort-Generator mit angewendetem CPC-Gebot. |
withCustomParameters(Object customParameters)
Legt die benutzerdefinierten Parameter des Schlüsselwort (keyword) fest.
Benutzerdefinierte Parameter sind hilfreich beim Freigeben dynamischer Informationen über mehrere URLs hinweg. Weitere Informationen zur 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üsselwort (keyword) angewendet werden sollen. Beispiel: {key1: 'value1', key2: 'value2', key3: 'value3'}, wobei key der Name des benutzerdefinierten Parameters und 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 | Schlüsselwort-Generator mit den angewendeten benutzerdefinierten Parametern. |
withFinalUrl(string finalUrl)
Legt die endgültige URL des Schlüsselwort (keyword) fest.
Die endgültige URL identifiziert die Webseite, auf die 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 (keyword) Entität die endgültige URL der Anzeige. Geben Sie die endgültige URL des Schlüsselwort (keyword) an, um die endgültige URL der Anzeige zu überschreiben.
Weitere Informationen finden Sie unter Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| finalUrl | string | Die endgültige URL, die die Webseite identifiziert, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| KeywordBuilder | Schlüsselwort-Generator mit angewendeter endgültiger URL. |
withMobileFinalUrl(string mobileFinalUrl)
Legt die endgültige URL des Schlüsselwort (keyword) für mobile Geräte fest.
Die endgültige URL identifiziert die Webseite, auf die 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 (keyword) Entität die endgültige URL der Anzeige. Geben Sie die endgültige URL des Schlüsselwort (keyword) an, wenn Sie die endgültige URL der Anzeige überschreiben möchten.
Weitere Informationen finden Sie unter Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?
Um eine endgültige URL für mobile Geräte anzugeben, geben Sie zunächst eine endgültige URL für nicht mobile Geräte an (siehe withFinalUrl()).
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| mobileFinalUrl | string | Die endgültige URL für mobile Geräte. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| KeywordBuilder | Schlüsselwort-Generator mit angewendeter mobiler endgültiger URL. |
withText(string text)
Legt den Text des Schlüsselwort (keyword) fest.
Verwenden Sie die folgende Syntax, um den Übereinstimmungstyp des Schlüsselwort (keyword) anzugeben:
- Verwenden Sie für allgemeine Übereinstimmungen keine Übereinstimmungstypsyntax (z. B
keywordBuilder.withText("books"). ). - Stellen Sie für den Modifizierer für allgemeine Übereinstimmungen dem Text ein Pluszeichen (+) voran (z. B
keywordBuilder.withText("+books"). ). Hinweis: Wenn Sie versuchen, neue BMM-Schlüsselwörter (Broad Match Modiifier) zu erstellen, werden sie gespeichert und als Schlüsselwörter für die Übereinstimmung von Ausdrücken bereitgestellt. Ihre vorhandenen BMM-Schlüsselwörter werden weiterhin im Ausdrucksgleichverhalten verwendet. Erfahren Sie mehr über Schlüsselwort (keyword) Übereinstimmungstypen. - Platzieren Sie für ausdrucksgleiche Anführungszeichen um den Text (z. B
keywordBuilder.withText("\"books\""). ). - Platzieren Sie für eine genaue Übereinstimmung eckige Klammern um den Text (z. B
keywordBuilder.withText("[hardcover books]"). ).
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| text | string | Der Text des Schlüsselwort (keyword). Der Text des Schlüsselwort (keyword) ist erforderlich. Der Text darf maximal 100 Zeichen enthalten. Geben Sie den Text im Gebietsschema des Sprachwerts der Anzeigengruppe an. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| KeywordBuilder | Schlüsselwort-Generator mit angewendetem Schlüsselwort (keyword) Text. |
withTrackingTemplate(string trackingTemplate)
Legt die Nachverfolgungsvorlage des Schlüsselwort (keyword) fest.
Nachverfolgungsvorlagen werden zusammen mit finalUrl des Schlüsselwort (keyword) verwendet, um die ziel-URL zu erstellen, die von der Anzeige verwendet wird. Weitere Informationen finden Sie unter Welche Nachverfolgungs- oder URL-Parameter kann ich verwenden?
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| trackingTemplate | string | Die Mit diesem Schlüsselwort (keyword) zu verwendende Nachverfolgungsvorlage. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| KeywordBuilder | Schlüsselwort-Generator mit angewendeter Nachverfolgungsvorlage. |