Aracılığıyla paylaş

AdGroupAudienceSelector

Reklam grubu hedef kitlelerinin listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında bilgi için bkz. Seçiciler.

Örnek kullanım:

    // Gets the iterator that iterates all ad group audiences
    // in the account.
    var iterator = AdsApp.adGroups().get();

    // Loops through all ad groups in the account.
    while (iterator.hasNext()) {
        var adGroup = iterator.next();

        // Gets the iterator that iterates all ad group audiences
        // in the ad group audience.
        var audienceIterator = adGroup.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all ad group audiences in the ad group audience.
        while (audienceIterator.hasNext()) {
            var audience = iterator.next();
        }
    }

Yöntemler

Yöntem Adı Dönüş Türü Açıklama
forDateRange(Object dateFrom, Object dateTo) AdGroupAudienceSelector Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.
forDateRange(string dateRange) AdGroupAudienceSelector Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.
Al AdGroupAudienceIterator Reklam grubu hedef kitleleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy) AdGroupAudienceSelector Belirtilen sıralamayı seçili reklam grubu hedef kitlelerine uygular.
withCondition(dize koşulu) AdGroupAudienceSelector Reklam grubu hedef kitlelerine filtre ölçütleri uygular.
withIds(string[] ids) AdGroupAudienceSelector Belirtilen kimliklerle reklam grubu hedef kitlelerini alır.
withLimit(int sınırı) AdGroupAudienceSelector Seçim ölçütleriyle eşleşen ilk n reklam grubu hedef kitlesini 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. Formda bir dize, YYYYMMDD veya formdaki bir nesne kullanarak tarihi belirtin, {year: 2020, ay: 12, gün: 31}.
dateTo Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının bitiş tarihi. Formda bir dize, YYYYMMDD veya formdaki bir nesne kullanarak tarihi belirtin, {year: 2020, month: 12, day: 1}.

Döndürür

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

forDateRange(String dateRange)

Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını 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.

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

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

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. Büyük/küçük harfe duyarlı olası değerler şunlardır: TODAY, YESTERDAY, 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.

Döndürür

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

Al

Reklam grubu hedef kitleleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Döndürür

Tür Açıklama
AdGroupAudienceIterator Seçilen reklam grubu hedef kitlelerinde yineleme yapmak için kullanılan bir yineleyici.

orderBy(String orderBy)

Belirtilen sıralamayı seçili reklam grubu hedef kitlelerine 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ı, ad grubu hedef kitlelerini 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
AdGroupAudienceSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Reklam grubu hedef kitlelerine 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

Desteklenen Sütunlar

Reklam grubu hedef kitle filtrelemesi için desteklenen sütunlar. 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
AbsoluteTopImpressionRate Çift withCondition("AbsoluteTopImpressionRate > 0.25")
AverageCpc Çift withCondition("AverageCpc < 2.75")
AverageCpm Çift withCondition("AverageCpm > 0.65")
ClickConversionRate Çift withCondition("ClickConversionRate > 0.25")
Tıklama Uzun withCondition("Clicks >= 33")
ConvertedClicks Uzun withCondition("ConvertedClicks >= 10")
Ücret Çift withCondition("Cost > 3.25")

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

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

Aşağıda, belirteceğiniz varlık özellikleri yer alır.

Sütun Tür Örnek
AdGroupName Dize İlişkilendirmenin reklam grubunun adı.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus Numaralandırma İlişkilendirmenin reklam grubunun durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİN
  • DURAKLATILDI
  • KALDIRILDI
Bu örnek yalnızca ana reklam grubu duraklatılmış olan reklam grubu hedef kitlelerini döndürür.

withCondition("AdGroupStatus = PAUSED")
AudienceId Uzun İlişkili hedef kitlenin kimliği.

withCondition("AudienceId = 123456789")
CampaignName Dize İlişkilendirmenin reklam grubunu içeren kampanyanın adı.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Numaralandırma İlişkilendirmenin reklam grubunu içeren kampanyanın durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİN
  • DURAKLATILDI
  • KALDIRILDI
Bu örnek yalnızca ana kampanyası duraklatılmış reklam grubu hedef kitlelerini döndürür.

withCondition("CampaignStatus = PAUSED")
Durum Numaralandırma İlişkilendirmenin durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİN
  • DURAKLATILDI
  • KALDIRILDI
Bu örnek yalnızca etkinleştirilmiş reklam grubu hedef kitlelerini döndürür.

withCondition("Status = ENABLED")
UserListName Dize İlişkili hedef kitlenin adı.

withCondition("UserListName = 'foo'")

Bağımsız değişken

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

Döndürür

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

withIds(string[] ids)

Belirtilen kimliklerle reklam grubu hedef kitlelerini 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 arama yalnızca reklam grubu hedef kitlesi 33333'i seçer.

var selector = AdsApp.adGroups()
    .withIds(['11111', '22222', '33333'])
    .withIds(['33333', '44444', '55555']);

Bağımsız değişken

Name Tür Açıklama
Kimlik string[] Bir dizi reklam grubu hedef kitle kimliği. Sınırlar için bkz. Betik yürütme sınırları.

Döndürür

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

withLimit(int sınırı)

Seçim ölçütleriyle eşleşen ilk n reklam grubu hedef kitlesini alır.

Bağımsız değişken

Name Tür Açıklama
Sınırı Int Döndürülecek reklam grubu hedef kitlelerinin sayısı. Gerçek sayı daha az olabilir.

Döndürür

Tür Açıklama
AdGroupAudienceSelector Sınır uygulanmış seçici.
  • Last updated on