Aracılığıyla paylaş

TargetedLocationSelector

  • Makale

Hedeflenen konumların listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında bilgi için bkz. Seçiciler.

Örnek kullanım:

    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

    var iterator = shoppingCampaign.targeting().targetedLocations()
        .withLimit(10)
        .withIds("123456789")
        .get();

    while (iterator.hasNext()) {
        var targetedLocation = iterator.next();
    }

Yöntemler

Yöntem Adı Dönüş Türü Açıklama
forDateRange(Object dateFrom, Object dateTo) TargetedLocationSelector Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.
forDateRange(string dateRange) TargetedLocationSelector Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.
Al TargetedLocationIterator Hedeflenen konumlar listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy) TargetedLocationSelector Belirtilen sıralamayı seçilen hedeflenen konumlara uygular.
withCondition(dize koşulu) TargetedLocationSelector Hedeflenen konumlara filtre ölçütleri uygular.
withIds(string[] ids) TargetedLocationSelector Belirtilen kimliklerle hedeflenen konumları alır.
withLimit(int sınırı) TargetedLocationSelector Seçim ölçütlerine uyan ilk n hedeflenen konumu alır.

forDateRange(Object dateFrom, Object dateTo)

Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.

Yalnızca aşağıdakiler için bir tarih aralığı belirtin:

  • Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
  • Seçtiğiniz nesnelerin performans verilerini almak istiyorsunuz. Örneğin, yöntemini çağırmayı getStats() planlıyorsanız.

Dizeleri veya nesneleri kullanarak tarih parametrelerini belirtebilirsiniz. Dizeleri kullanmak için YYYYMMDD biçimindeki tarihi belirtin. Nesneleri kullanıyorsanız, aşağıdaki alanlara sahip bir nesne oluşturun:

  • Yıl
  • Ay
  • Gün

Örneğin:

var date = {year: 2018, month: 5, day: 13};

Ay, 1'in Ocak ve 12'nin Aralık olduğu tek tabanlıdır.

Tarih aralığı kapsayıcıdır. Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.

Bağımsız değişken

Name Tür Açıklama
dateFrom Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının başlangıç tarihi.
dateTo Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının bitiş tarihi.

Döndürür

Tür Açıklama
TargetedLocationSelector Tarih aralığı uygulanmış seçici.

forDateRange(String dateRange)

Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.

Desteklenen tarih aralığı değerleri:

  • BUGÜN
  • DÜN
  • LAST_WEEK
  • LAST_BUSINESS_WEEK
  • LAST_7_DAYS
  • THIS_WEEK_SUN_TODAY
  • LAST_14_DAYS
  • LAST_30_DAYS
  • LAST_WEEK_SUN_SAT
  • THIS_MONTH
  • LAST_MONTH
  • ALL_TIME

Yalnızca aşağıdakiler için bir tarih aralığı belirtin:

  • Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
  • Seçtiğiniz nesnelerin performans verilerini almak istiyorsunuz. Örneğin, yöntemini çağırmayı getStats() planlıyorsanız.

Birden çok tarih aralığı belirtirseniz, yalnızca son tarih aralığı kullanılır.

Bağımsız değişken

Name Tür Açıklama
dateRange Dize Seçiciye eklenecek performans verilerini belirten önceden tanımlanmış tarih aralığı dizesi. Önceden tanımlanmış tarih aralığı dizesi büyük/küçük harfe duyarlıdır.

Döndürür

Tür Açıklama
TargetedLocationSelector Tarih aralığı uygulanmış seçici.

Al

Hedeflenen konumlar listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Döndürür

Tür Açıklama
TargetedLocationIterator Seçilen hedeflenen konumlarda yineleme yapmak için kullanılan bir yineleyici.

orderBy(string orderBy)

Belirtilen sıralamayı seçilen hedeflenen konumlara uygular.

"columnName orderDirection" biçiminde orderBy parametresini belirtin. Burada:

  • columnNamedesteklenen sütunlardan biridir.
  • orderDirection , sonuçları sıralama düzenidir. Sonuçları artan düzende sıralamak için ASC veya azalan düzende sıralamak için DESC olarak ayarlayın. Varsayılan değer ASC'dir.

Örneğin, aşağıdaki çağrı Sonuçları AverageCpc'ye göre artan sırada döndürür.

selector = selector.orderBy("AverageCpc");

Seçiciler varlıkları yalnızca bir alana göre sıralamayı destekler. Varlıkların listesini x alanına göre, x içinde y alanına göre sıralayamayabilirsiniz. Zincirde veya ayrı seçici çağrılarında birden orderBy() fazla çağrı belirtirseniz, Betikler son orderBy() çağrıda belirtilen alanı kullanarak varlık listesini sipariş eder. 

Bağımsız değişken

Name Tür Açıklama
Orderby Dize Uygulanacak sipariş.

Döndürür

Tür Açıklama
TargetedLocationSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Hedeflenen konumlara filtre ölçütleri uygular.

koşul parametresini şu şekilde belirtin: "columnName işleç değeri":

Işleç

Kullandığınız işleç, sütunun türüne bağlıdır. İşleçler büyük/küçük harfe duyarlıdır. Örneğin, starts_with yerine STARTS_WITH kullanın.

Tamsayılar ve uzun değerler içeren sütunların işleçleri:

<
<=
>
>=
=
!=

Çift değer içeren sütunların işleçleri:

<
>

Dize değerleri içeren sütunların işleçleri:

=
!=
STARTS_WITH
STARTS_WITH_IGNORE_CASE
CONTAINS
CONTAINS_IGNORE_CASE
DOES_NOT_CONTAIN
DOES_NOT_CONTAIN_IGNORE_CASE

Numaralandırma değerleri içeren sütunların işleçleri:

=
!=
IN []
NOT_IN []

Dize dizisi içeren sütunların işleçleri:

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Hedeflenen konum filtreleme için desteklenen sütunlar. Sütun adları büyük/küçük harfe duyarlıdır.

Aşağıda, belirteceğiniz performans ölçümleri sütunları yer alır.

Sütun Tür Örnek Microsoft Advertising web kullanıcı arabirimi filtresi
AbsoluteTopImpressionRate Çift withCondition("AbsoluteTopImpressionRate > 0.25") Abs. Üst Impr. Oranı
AverageCpc Çift withCondition("AverageCpc < 2.75") Ort. CPC
AverageCpm Çift withCondition("AverageCpm > 0.65") Ortalama CPM
ClickConversionRate Çift withCondition("ClickConversionRate > 0.25") Dışbükey Oran
Tıklama Uzun withCondition("Clicks >= 33") Tıklama
ConvertedClicks Uzun withCondition("ConvertedClicks >= 10") Dönş.
Ücret Çift withCondition("Cost > 3.25")

Maliyet, hesabın para birimindedir.		 Harcamak
Ctr Çift withCondition("Ctr > 0.05")

CTR 0..1 aralığındadır, bu nedenle %5 CTR için 0,05 kullanın.		 CTR
Gösterim Uzun withCondition("Impressions > 10") Impr.
TopImpressionRate Çift withCondition("TopImpressionRate > 0.25") Üst Impr. Oranı

Bağımsız değişken

Name Tür Açıklama
Durum Dize Seçiciye eklenecek koşul.

Döndürür

Tür Açıklama
TargetedLocationSelector Koşulun uygulandığı seçici.

withIds(string[] ids)

Belirtilen kimliklerle hedeflenen konumları alır.

Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Bir koşul zinciri and işlemi olarak kabul edilir. Örneğin, varlık yalnızca A koşulu doğruysa ve B koşulu doğruysa seçilir. Örneğin, aşağıdaki çağrı yalnızca hedeflenen konum 72'yi seçer.

var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get().next();

var iterator = shoppingCampaign.targeting().targetedLocations()
    .withIds(["32", "72"])
    .withIds(["72", "190"]);

Bağımsız değişken

Name Tür Açıklama
Kimlik string[] Hedeflenen konum kimlikleri dizisi. Sınırlar için bkz. Betik yürütme sınırları.

Döndürür

Tür Açıklama
TargetedLocationSelector Kimliklerin uygulandığı seçici.

withLimit(int sınırı)

Seçim ölçütlerine uyan ilk n hedeflenen konumu alır.

Bağımsız değişken

Name Tür Açıklama
Sınırı Int Döndürülecek hedeflenen konumların sayısı. Gerçek sayı daha az olabilir.

Döndürür

Tür Açıklama
TargetedLocationSelector Sınır uygulanmış seçici.

Ayrıca bkz.