KeywordUrls
Anahtar sözcüğün URL'lerini, izleme şablonunu ve özel parametreleri yönetme yöntemlerini içerir. Bilgi için bkz. Yükseltilen URL'lerle URL İzleme.
Yöntemler
| Yöntem Adı | Dönüş Türü | Açıklama |
|---|---|---|
| clearFinalUrl | Void | Anahtar sözcüğün son URL'sini kaldırır. |
| clearMobileFinalUrl | Void | Anahtar sözcüğün mobil cihazlar için son URL'sini kaldırır. |
| clearTrackingTemplate | Void | Anahtar sözcüğün izleme şablonunu kaldırır. |
| getCustomParameters | Nesne | Anahtar sözcüğün özel parametrelerini alır. |
| getFinalUrl | Dize | Anahtar sözcüğün son URL'sini alır. |
| getMobileFinalUrl | Dize | Anahtar sözcüğün mobil cihazlar için son URL'sini alır. |
| getTrackingTemplate | Dize | Anahtar sözcüğün izleme şablonunu alır. |
| setCustomParameters(Object customParameters) | Void | Anahtar sözcüğün özel parametrelerini ayarlar. |
| setFinalUrl(String finalUrl) | Void | Anahtar sözcüğün son URL'sini ayarlar. |
| setMobileFinalUrl(String finalUrl) | Void | Mobil için anahtar sözcüğün son URL'sini ayarlar. |
| setTrackingTemplate(String trackingTemplate) | Void | Anahtar sözcüğün izleme şablonunu ayarlar. |
clearFinalUrl
Anahtar sözcüğün son URL'sini kaldırır.
Döndürür
| Tür | Açıklama |
|---|---|
| Void | Hiçbir şey döndürmez. |
clearMobileFinalUrl
Anahtar sözcüğün mobil cihazlar için son URL'sini kaldırır.
Döndürür
| Tür | Açıklama |
|---|---|
| Void | Hiçbir şey döndürmez. |
clearTrackingTemplate
Anahtar sözcüğün izleme şablonunu kaldırır.
Döndürür
| Tür | Açıklama |
|---|---|
| Void | Hiçbir şey döndürmez. |
getCustomParameters
Anahtar sözcüğün özel parametrelerini alır.
Özel parametreler, dinamik bilgilerin birden çok URL arasında paylaşılmasında yararlıdır. Kullanımı hakkında daha fazla bilgi için bkz. Özel Parametreler.
Döndürür
| Tür | Açıklama |
|---|---|
| Nesne | Anahtar sözcüğün özel parametrelerinin haritası. Örneğin, {key1: 'value1', key2: 'value2', key3: 'value3'}burada anahtar özel parametrenin adı, değer ise parametrenin değeridir. |
getFinalUrl
Anahtar sözcüğün son URL'sini alır. Bu, kullanıcının reklama tıkladığında çekildiği web sayfasının URL'sidir.
Aynı geçersiz kılma kuralları başka bir yerde olduğu gibi uygulanır. Örneğin, bir anahtar sözcüğün son URL'sini belirtmek, reklamın son URL'sini geçersiz kılar.
Döndürür
| Tür | Açıklama |
|---|---|
| Dize | Anahtar sözcüğün son URL'si. |
getMobileFinalUrl
Anahtar sözcüğün mobil cihazlar için son URL'sini alır. Bu, kullanıcının reklama tıkladığında çekildiği mobil web sayfasının URL'sidir.
Aynı geçersiz kılma kuralları başka bir yerde olduğu gibi uygulanır. Örneğin, bir anahtar sözcüğün mobil son URL'sini belirtmek, reklamın mobil son URL'sini geçersiz kılar.
Döndürür
| Tür | Açıklama |
|---|---|
| Dize | Anahtar sözcüğün mobil cihazlar için son URL'si. |
getTrackingTemplate
Anahtar sözcüğün izleme şablonunu alır.
İzleme şablonları, reklam tarafından kullanılan hedef URL'yi oluşturmak için anahtar sözcüğün FinalUrl ile birlikte kullanılır. Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?
Döndürür
| Tür | Açıklama |
|---|---|
| Dize | Anahtar sözcüğün izleme şablonu. |
setCustomParameters(Object customParameters)
Anahtar sözcüğün özel parametrelerini ayarlar. Son URL veya izleme şablonu özel değiştirme dizeleri içeriyorsa bu yöntemi kullanın.
Son URL'de veya izleme şablonunda bir müşteri parametresi adı kullanmak için adı küme ayracı içine alın ve adın başına bir alt çizgi (_) ekleyin. Örneğin, parametre adı foo ise, izleme şablonunda veya son URL'de {_foo} kullanın. Özel parametreler nesnesini tanımlarken parametre adına önde gelen bir alt çizgi eklemeyin.
Bu yöntemi çağırmak anahtar sözcüğün mevcut özel parametrelerinin yerini alır.
Anahtar sözcüğünden özel parametreleri temizlemek için boş bir nesne geçirin (örneğin, setCustomParameters({})). Anahtar sözcüğün özel parametrelerini temizlerseniz anahtar sözcük URL'leri üst reklam grubundan devralır (reklam grubu URL'leri belirtiyorsa). Özel parametreleri tamamen temizlemek için bunları hiyerarşideki tüm düzeylerde temizleyin.
Özel parametreler, dinamik bilgilerin birden çok URL arasında paylaşılmasında yararlıdır. Kullanımı hakkında daha fazla bilgi için bkz. Özel Parametreler.
Bağımsız değişken
| Name | Tür | Açıklama |
|---|---|---|
| customParameters | Nesne | Anahtar sözcükte kullanılacak en fazla üç özel parametrenin haritası. Örneğin, {key1: 'value1', key2: 'value2', key3: 'value3'}burada anahtar özel parametrenin adı, değer ise parametrenin değeridir. Parametrenin adı yalnızca alfasayısal karakterler içerebilir ve parametrenin değeri boşluk içermeyebilir. Ad en fazla 16 8 bayt karakter ve değer en fazla 200 8 bayt karakter içerebilir. |
Döndürür
| Tür | Açıklama |
|---|---|
| Void | Hiçbir şey döndürmez. |
setFinalUrl(String finalUrl)
Anahtar sözcüğün son URL'sini ayarlar.
Son URL, kullanıcının reklama tıkladığında çekildiği web sayfasını tanımlar. Belirtilmezse, varlık son URL'yi üst varlığından devralır. Örneğin, anahtar sözcük varlığı reklamın son URL'sini devralır. Reklamın son URL'sini geçersiz kılmak için anahtar sözcüğün son URL'sini belirtin.
Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?
Özelliğin değeri geçerli değilse, çağrı sessizce başarısız olur. Özelliğin gerçekten güncelleştirilip güncelleştirilmediğini onaylamak için nesnesini yeniden alın ve özelliğin değerinin yeni değere eşit olup olmadığını test edin. Bilgi için bkz . Hataları ve uyarıları işleme.
Bağımsız değişken
| Name | Tür | Açıklama |
|---|---|---|
| finalUrl | Dize | Anahtar sözcüğün son URL'si. |
Döndürür
| Tür | Açıklama |
|---|---|
| Void | Hiçbir şey döndürmez. |
setMobileFinalUrl(String finalUrl)
Mobil cihazlar için anahtar sözcüğün son URL'sini ayarlar.
Son URL, kullanıcının reklama tıkladığında çekildiği web sayfasını tanımlar. Belirtilmezse, varlık son URL'yi üst varlığından devralır. Örneğin, anahtar sözcük varlığı reklamın son URL'sini devralır. Reklamın son URL'sini geçersiz kılmak için anahtar sözcüğün son URL'sini belirtin.
Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?
Mobil cihazlar için son URL'yi belirtmek için önce mobil olmayan cihazlar için son URL'yi belirtin (bkz setFinalUrl(). ).
Özelliğin değeri geçerli değilse, çağrı sessizce başarısız olur. Özelliğin gerçekten güncelleştirilip güncelleştirilmediğini onaylamak için nesnesini yeniden alın ve özelliğin değerinin yeni değere eşit olup olmadığını test edin. Bilgi için bkz . Hataları ve uyarıları işleme.
Bağımsız değişken
| Name | Tür | Açıklama |
|---|---|---|
| finalUrl | Dize | Anahtar sözcüğün son URL mobil cihazları. |
Döndürür
| Tür | Açıklama |
|---|---|
| Void | Hiçbir şey döndürmez. |
setTrackingTemplate(String trackingTemplate)
Anahtar sözcüğün izleme şablonunu ayarlar.
İzleme şablonları, reklam tarafından kullanılan hedef URL'yi oluşturmak için anahtar sözcüğün FinalUrl ile birlikte kullanılır. Daha fazla bilgi için bkz . Hangi izleme veya URL parametrelerini kullanabilirim?
Özelliğin değeri geçerli değilse, çağrı sessizce başarısız olur. Özelliğin gerçekten güncelleştirilip güncelleştirilmediğini onaylamak için nesnesini yeniden alın ve özelliğin değerinin yeni değere eşit olup olmadığını test edin. Bilgi için bkz . Hataları ve uyarıları işleme.
Bağımsız değişken
| Name | Tür | Açıklama |
|---|---|---|
| trackingTemplate | Dize | Anahtar sözcüğün izleme şablonu. |
Döndürür
| Tür | Açıklama |
|---|---|
| Void | Hiçbir şey döndürmez. |