KeywordUrls

Enthält die Methoden zum Verwalten der URLs des Schlüsselworts (Keyword), der Vorlage für die Nachverfolgung und benutzerdefinierter Parameter. Weitere Informationen finden Sie unter URL-Nachverfolgung mit aktualisierten URLs.

Methoden

Methodenname Rückgabetyp Beschreibung
clearFinalUrl void Entfernt die endgültige URL des Schlüsselworts (Keyword).
clearMobileFinalUrl void Entfernt die endgültige URL des Schlüsselworts (Keyword) für mobile Geräte.
clearTrackingTemplate void Entfernt die Vorlage für die Nachverfolgung des Schlüsselworts (keyword).
getCustomParameters Objekt Ruft die benutzerdefinierten Parameter des Schlüsselworts (keyword) ab.
getFinalUrl string Ruft die endgültige URL des Schlüsselworts (Keyword) ab.
getMobileFinalUrl string Ruft die endgültige URL des Schlüsselworts (Keyword) für mobile Geräte ab.
getTrackingTemplate string Ruft die Vorlage für die Nachverfolgung des Schlüsselworts (Keyword) ab.
setCustomParameters(Object customParameters) void Legt die benutzerdefinierten Parameter des Schlüsselworts (keyword) fest.
setFinalUrl(String finalUrl) void Legt die endgültige URL des Schlüsselworts (Keyword) fest.
setMobileFinalUrl(String finalUrl) void Legt die endgültige URL des Schlüsselworts (Keyword) für Mobilgeräte fest.
setTrackingTemplate(String trackingTemplate) void Legt die Vorlage für die Nachverfolgung des Schlüsselworts (keyword) fest.

clearFinalUrl

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

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

clearMobileFinalUrl

Entfernt die endgültige URL des Schlüsselworts (Keyword) für mobile Geräte.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

clearTrackingTemplate

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

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

getCustomParameters

Ruft die benutzerdefinierten Parameter des Schlüsselworts (keyword) ab.

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

Rückgabewerte

Typ Beschreibung
Object Eine Zuordnung der benutzerdefinierten Parameter des Schlüsselworts (keyword).

Beispiel: {key1: 'value1', key2: 'value2', key3: 'value3'}Schlüssel ist der Name des benutzerdefinierten Parameters und Wert der Wert des Parameters.

getFinalUrl

Ruft die endgültige URL des Schlüsselworts (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 anderswo. Wenn Sie beispielsweise die endgültige URL eines Schlüsselworts (Keyword) angeben, wird die endgültige URL der Anzeige überschrieben.

Rückgabewerte

Typ Beschreibung
string Die endgültige URL des Schlüsselworts (Keyword).

getMobileFinalUrl

Ruft die endgültige URL des Schlüsselworts (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 anderswo. Beispielsweise wird durch die Angabe der endgültigen mobilen URL eines Schlüsselworts (keyword) die endgültige mobile URL der Anzeige außer Kraft gesetzt.

Rückgabewerte

Typ Beschreibung
string Die endgültige URL des Schlüsselworts (Keyword) für mobile Geräte.

getTrackingTemplate

Ruft die Vorlage für die Nachverfolgung des Schlüsselworts (Keyword) ab.

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?

Rückgabewerte

Typ Beschreibung
string Die Vorlage für die Nachverfolgung des Schlüsselworts (Keyword).

setCustomParameters(Object customParameters)

Legt die benutzerdefinierten Parameter des Schlüsselworts (keyword) fest. Verwenden Sie diese Methode, wenn die endgültige URL oder die Vorlage für die Nachverfolgung benutzerdefinierte Ersetzungszeichenfolgen enthält.

Um einen Kundenparameternamen in der endgültigen URL oder der Vorlage für die Nachverfolgung 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 Vorlage für die Nachverfolgung oder in der endgültigen URL. Fügen Sie beim Definieren des benutzerdefinierten Parameterobjekts keinen führenden Unterstrich zum Parameternamen hinzu.

Durch den Aufruf dieser Methode werden die vorhandenen benutzerdefinierten Parameter des Schlüsselworts (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üsselworts (Keyword) löschen, erbt das Schlüsselwort (Keyword) die URLs von der übergeordneten Anzeigengruppe (sofern 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, 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 mit bis zu drei benutzerdefinierten Parametern, die im Schlüsselwort (keyword) verwendet werden können. Beispiel: {key1: 'value1', key2: 'value2', key3: 'value3'}Schlüssel ist der Name des benutzerdefinierten Parameters und Wert der Wert des Parameters. 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ü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?

Wenn der Wert der Eigenschaft ungültig ist, schlägt der Aufruf automatisch 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üsselworts (Keyword).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

setMobileFinalUrl(String finalUrl)

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, um die endgültige URL der Anzeige zu überschreiben.

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 setFinalUrl()).

Wenn der Wert der Eigenschaft ungültig ist, schlägt der Aufruf automatisch 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üsselworts (Keyword): mobile Geräte.

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.

setTrackingTemplate(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?

Wenn der Wert der Eigenschaft ungültig ist, schlägt der Aufruf automatisch 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 Vorlage für die Nachverfolgung des Schlüsselworts (Keyword).

Rückgabewerte

Typ Beschreibung
void Gibt Nothing zurück.