AdGroupAudienceSelector

Reklam grubu kitlelerinin listesini filtreleme ve sıralama yöntemlerini içerir. Seçiciler hakkında daha fazla 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ı İade Türü Açıklama
forDateRange(Object dateFrom, Object dateTo) AdGroupAudienceSelector Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.
forDateRange(dize dateRange) AdGroupAudienceSelector Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.
Almak AdGroupAudienceIterator Reklam grubu kitleleri listesini yinelemek için kullanılan bir yineleyici alır.
orderBy(dize orderBy) AdGroupAudienceSelector Belirtilen sıralamayı seçili reklam grubu kitlelerine uygular.
withCondition(dize koşulu) AdGroupAudienceSelector Filtre ölçütlerini reklam grubu kitlelerine uygular.
withIds(string[] ids) AdGroupAudienceSelector Belirtilen kimliklere sahip reklam grubu kitlelerini alır.
withLimit(int limit) AdGroupAudienceSelector Seçim ölçütleriyle eşleşen ilk n reklam grubu kitlesini alır.

forDateRange(Object dateFrom, Object dateTo)

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

Tarih aralığını yalnızca aşağıdaki koşullarda belirtin:

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

Dizeleri veya nesneleri kullanarak tarih parametrelerini belirtebilirsiniz. Dizeleri kullanmak için, YYYYAAGG biçiminde tarihi belirtin. Nesneler kullanıyorsanız, aşağıdaki alanlarla 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şkenler

Name Tür Açıklama
dateFrom Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının başlangıç tarihi. YYYYAAGG formdaki bir dizeyi veya {year: 2020, month: 12, day: 31} nesnesini kullanarak tarihi belirtin.
dateEnd Nesne Seçiciye eklenecek performans verilerini belirten tarih aralığının bitiş tarihi. YYYYAAGG formundaki bir dizeyi veya {yıl: 2020, ay: 12, gün: 1} nesnesini kullanarak tarihi belirtin.

Geri dönüşler

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

forDateRange(Dize dateRange)

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

Tarih aralığını yalnızca aşağıdaki koşullarda belirtin:

  • Performans ölçümü alanlarına başvuran koşullar veya sıralama uygularsınız.
  • Seçtiğiniz nesneler için performans verilerini almak istiyorsunuz. Örneğin, yöntemi ç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şkenler

Name Tür Açıklama
tarih aralığı 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: 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.

Geri dönüşler

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

Almak

Reklam grubu kitleleri listesini yinelemek için kullanılan bir yineleyici alır.

Geri dönüşler

Tür Açıklama
AdGroupAudienceIterator Seçili reklam grubu kitleleri arasında yineleme yapmak için kullanılan bir yineleyici.

orderBy(String orderBy)

Belirtilen sıralamayı seçili reklam grubu kitlelerine uygular.

orderBy parametresini "columnName orderDirection" biçiminde belirtin; burada:

  • columnNamedesteklenen sütunlardan biridir.
  • orderDirection , sonuçların sıralandığı sıradır. Sonuçları azalan sırada sıralamak için ASC olarak veya sonuçları azalan sırada sıralamak için DESC olarak ayarlayın. Varsayılan değer ASC'dir.

Örneğin, aşağıdaki çağrı, reklam grubu 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 ve x içinde y alanına göre sıralayamazsınız. Bir zincirde veya ayrı seçici çağrılarında birden fazla orderBy() çağrı belirtirseniz, Betikler son orderBy() çağrıda belirtilen alanı kullanarak varlıkların listesini sıralar. 

Bağımsız değişkenler

Name Tür Açıklama
orderBy dize Uygulanacak sipariş.

Geri dönüşler

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

withCondition(Dize koşulu)

Filtre ölçütlerini reklam grubu kitlelerine uygular.

"columnName işleç değeri" biçiminde koşul parametresini belirtin, burada:

Operatörler

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

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

<
<=
>
>=
=
!=

Ç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 []

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

CONTAINS_ALL
CONTAINS_ANY
CONTAINS_NONE

Desteklenen Sütunlar

Reklam grubu kitle filtrelemesi için desteklenen sütunlar. Adlar büyük/küçük harfe duyarlıdır.

Aşağıdakiler, belirtebileceğiniz performans ölçümleri sütunlarıdır.

Sütun Tür Örnek
AbsoluteTopImpressionRate çift kişilik withCondition("AbsoluteTopImpressionRate > 0.25")
Ortalama Cpc çift kişilik withCondition("AverageCpc < 2.75")
Ortalama Cpm çift kişilik withCondition("AverageCpm > 0.65")
Tıklama Dönüşüm Oranı çift kişilik withCondition("ClickConversionRate > 0.25")
Tıklamalar uzun withCondition("Clicks >= 33")
Dönüştürülen Tıklamalar uzun withCondition("ConvertedClicks >= 10")
Ücret çift kişilik withCondition("Cost > 3.25")

Maliyet, hesabın para birimi cinsindendir.
CTR çift kişilik withCondition("Ctr > 0.05")

TO 0..1 aralığındadır, bu nedenle %5'lik bir TO için 0,05'i kullanın.
İzlenimler uzun withCondition("Impressions > 10")
En İyi Gösterim Oranı çift kişilik withCondition("TopImpressionRate > 0.25")

Aşağıdakiler, belirtebileceğiniz varlık özellikleridir.

Sütun Tür Örnek
AdGroupName dize Derneğin reklam grubunun adı.

withCondition("AdGroupName CONTAINS_IGNORE_CASE 'truck'")
AdGroupStatus numaralandırma İlişkinin reklam grubunun durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
Bu örnek, yalnızca üst reklam grubu duraklatılmış olan reklam grubu kitlelerini döndürür.

withCondition("AdGroupStatus = PAUSED")
İzleyici Kimliği uzun İlişkili hedef kitlenin kimliği.

withCondition("AudienceId = 123456789")
Kampanya Adı dize Derneğin reklam grubunu içeren kampanyanın adı.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
Kampanya Durumu numaralandırma İlişkinin reklam grubunu içeren kampanyanın durumu. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
Bu örnek, yalnızca üst kampanyası duraklatılmış olan reklam grubu kitlelerini döndürür.

withCondition("CampaignStatus = PAUSED")
Durum numaralandırma Derneğin statüsü. Büyük/küçük harfe duyarlı olası değerler şunlardır:
  • ETKİNLEŞTİRİLDİ
  • DURAKLATILDI
  • KALDIRILDI
Bu örnekte yalnızca etkin reklam grubu kitleleri döndürülür.

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

withCondition("UserListName = 'foo'")

Bağımsız değişkenler

Name Tür Açıklama
Şart dize Seçiciye uygulanacak koşul.

Geri dönüşler

Tür Açıklama
AdGroupAudienceSelector Uygulanan koşulla seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip reklam grubu kitlelerini alır.

Bir seçiciye bir veya daha fazla koşul uygulayabilirsiniz. Koşullar 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 33333 reklam grubu kitlesini seçer.

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

Bağımsız değişkenler

Name Tür Açıklama
kimlikler dize[] Bir dizi reklam grubu kitle kimliği. Sınırlar için bkz: Komut dosyası yürütme sınırları.

Geri dönüşler

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

withLimit(int limit)

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

Bağımsız değişkenler

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

Geri dönüşler

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