KeywordUrls
Enthält die Methoden zum Verwalten der URLs, der Nachverfolgungsvorlage und der benutzerdefinierten Parameter des Schlüsselwort (keyword). Weitere Informationen finden Sie unter URL-Nachverfolgung mit aktualisierten URLs.
Methoden
| Methodenname | Rückgabetyp | Beschreibung |
|---|---|---|
| clearFinalUrl | void | Entfernt die endgültige URL des Schlüsselwort (keyword). |
| clearMobileFinalUrl | void | Entfernt die endgültige URL des Schlüsselwort (keyword) für mobile Geräte. |
| clearTrackingTemplate | void | Entfernt die Nachverfolgungsvorlage des Schlüsselwort (keyword). |
| getCustomParameters | Objekt | Ruft die benutzerdefinierten Parameter des Schlüsselwort (keyword) ab. |
| getFinalUrl | string | Ruft die endgültige URL des Schlüsselwort (keyword) ab. |
| getMobileFinalUrl | string | Ruft die endgültige URL des Schlüsselwort (keyword) für mobile Geräte ab. |
| getTrackingTemplate | string | Ruft die Nachverfolgungsvorlage der Schlüsselwort (keyword) ab. |
| setCustomParameters(Object customParameters) | void | Legt die benutzerdefinierten Parameter des Schlüsselwort (keyword) fest. |
| setFinalUrl(String finalUrl) | void | Legt die endgültige URL des Schlüsselwort (keyword) fest. |
| setMobileFinalUrl(String finalUrl) | void | Legt die endgültige URL des Schlüsselwort (keyword) für Mobilgeräte fest. |
| setTrackingTemplate(String trackingTemplate) | void | Legt die Nachverfolgungsvorlage des Schlüsselwort (keyword) fest. |
clearFinalUrl
Entfernt die endgültige URL des Schlüsselwort (keyword).
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| void | Gibt Nothing zurück. |
clearMobileFinalUrl
Entfernt die endgültige URL des Schlüsselwort (keyword) für mobile Geräte.
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| void | Gibt Nothing zurück. |
clearTrackingTemplate
Entfernt die Nachverfolgungsvorlage des Schlüsselwort (keyword).
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| void | Gibt Nothing zurück. |
getCustomParameters
Ruft die benutzerdefinierten Parameter des Schlüsselwort (keyword) ab.
Benutzerdefinierte Parameter sind hilfreich beim Freigeben dynamischer Informationen über mehrere URLs hinweg. Weitere Informationen zur Verwendung finden Sie unter Benutzerdefinierte Parameter.
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| Object | Eine Zuordnung der benutzerdefinierten Parameter des Schlüsselwort (keyword). Beispiel: {key1: 'value1', key2: 'value2', key3: 'value3'}, wobei key der Name des benutzerdefinierten Parameters und wert der Wert des Parameters ist. |
getFinalUrl
Ruft die endgültige URL des Schlüsselwort (keyword) ab. Dies ist die URL der Webseite, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt.
Es gelten die gleichen Außerkraftsetzungsregeln wie an anderen Stellen. Wenn Sie beispielsweise die endgültige URL eines Schlüsselwort (keyword) angeben, wird die endgültige URL der Anzeige überschrieben.
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| string | Die endgültige URL des Schlüsselwort (keyword). |
getMobileFinalUrl
Ruft die endgültige URL des Schlüsselwort (keyword) für mobile Geräte ab. Dies ist die URL der mobilen Webseite, zu der der Benutzer weitergeleitet wird, wenn er auf die Anzeige klickt.
Es gelten die gleichen Außerkraftsetzungsregeln wie an anderen Stellen. Wenn Sie z. B. die endgültige mobile URL einer Schlüsselwort (keyword) angeben, wird die endgültige mobile URL der Anzeige überschrieben.
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| string | Die endgültige URL des Schlüsselwort (keyword) für mobile Geräte. |
getTrackingTemplate
Ruft die Nachverfolgungsvorlage der Schlüsselwort (keyword) ab.
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?
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| string | Die Nachverfolgungsvorlage des Schlüsselwort (keyword). |
setCustomParameters(Object customParameters)
Legt die benutzerdefinierten Parameter des Schlüsselwort (keyword) fest. Verwenden Sie diese Methode, wenn die endgültige URL oder Nachverfolgungsvorlage benutzerdefinierte Ersetzungszeichenfolgen enthält.
Um einen Kundenparameternamen in der endgültigen URL oder der Nachverfolgungsvorlage zu verwenden, schließen Sie den Namen in geschweifte Klammern ein, und stellen Sie dem Namen einen Unterstrich (_) voran. Wenn der Parametername z. B. foo lautet, verwenden Sie {_foo} in der Nachverfolgungsvorlage oder der endgültigen URL. Fügen Sie dem Parameternamen beim Definieren des benutzerdefinierten Parameterobjekts keinen führenden Unterstrich hinzu.
Durch Aufrufen dieser Methode werden die vorhandenen benutzerdefinierten Parameter des Schlüsselwort (keyword) ersetzt.
Um die benutzerdefinierten Parameter aus dem Schlüsselwort (keyword) zu löschen, übergeben Sie ein leeres -Objekt (z. BsetCustomParameters({}). ). Wenn Sie die benutzerdefinierten Parameter des Schlüsselwort (keyword) löschen, erbt der Schlüsselwort (keyword) die URLs von seiner übergeordneten Anzeigengruppe (wenn die Anzeigengruppe URLs angibt). Um benutzerdefinierte Parameter vollständig zu löschen, löschen Sie sie auf allen Ebenen in der Hierarchie.
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 drei benutzerdefinierten Parametern, die im Schlüsselwort (keyword) verwendet 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 des Parameters darf nur alphanumerische Zeichen enthalten, und der Wert des Parameters darf keine Leerzeichen enthalten. Der Name darf maximal 16 8-Byte-Zeichen enthalten, und der Wert darf maximal 200 8-Byte-Zeichen enthalten. |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| void | Gibt Nothing zurück. |
setFinalUrl(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?
Wenn der Wert der Eigenschaft ungültig ist, schlägt der Aufruf im Hintergrund fehl. Um zu überprüfen, ob die Eigenschaft tatsächlich aktualisiert wurde, rufen Sie das Objekt erneut ab, und testen Sie, ob der Wert der Eigenschaft dem neuen Wert entspricht. Weitere Informationen finden Sie unter Behandeln von Fehlern und Warnungen.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| finalUrl | string | Die endgültige URL des Schlüsselwort (keyword). |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| void | Gibt Nothing zurück. |
setMobileFinalUrl(String finalUrl)
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, um die endgültige URL der Anzeige zu überschreiben.
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 setFinalUrl()).
Wenn der Wert der Eigenschaft ungültig ist, schlägt der Aufruf im Hintergrund fehl. Um zu überprüfen, ob die Eigenschaft tatsächlich aktualisiert wurde, rufen Sie das Objekt erneut ab, und testen Sie, ob der Wert der Eigenschaft dem neuen Wert entspricht. Weitere Informationen finden Sie unter Behandeln von Fehlern und Warnungen.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| finalUrl | string | Die endgültige URL der mobilen Geräte des Schlüsselwort (keyword). |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| void | Gibt Nothing zurück. |
setTrackingTemplate(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?
Wenn der ungültige Wert der Eigenschaft ungültig ist, schlägt der Aufruf im Hintergrund fehl. Um zu überprüfen, ob die Eigenschaft tatsächlich aktualisiert wurde, rufen Sie das Objekt erneut ab, und testen Sie, ob der Wert der Eigenschaft dem neuen Wert entspricht. Weitere Informationen finden Sie unter Behandeln von Fehlern und Warnungen.
Argumente
| Name | Typ | Beschreibung |
|---|---|---|
| trackingTemplate | string | Die Nachverfolgungsvorlage des Schlüsselwort (keyword). |
Rückgabewerte
| Typ | Beschreibung |
|---|---|
| void | Gibt Nothing zurück. |