AdGroupExcludedAudienceSelector

Reklam grubu hariç tutulan kitlelerin bir 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 excluded 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 excluded audiences
        // in the ad group excluded audience.
        var audienceIterator = adGroup.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all ad group excluded audiences in the ad group excluded audience.
        while (audienceIterator.hasNext()) {
            var audience = audienceIterator.next();
        }
    }

Yöntemler

Yöntem Adı İade Türü Açıklama
Almak AdGroupExcludedAudienceIterator Reklam grubu hariç tutulan kitleler listesini yinelemek için kullanılan bir yineleyici alır.
orderBy(dize orderBy) AdGroupExcludedAudienceSelector Belirtilen sıralamayı, seçili reklam grubu hariç tutulan kitlelere uygular.
withCondition(dize koşulu) AdGroupExcludedAudienceSelector Filtre ölçütlerini reklam grubu hariç tutulan kitlelere uygular.
withIds(string[] ids) AdGroupExcludedAudienceSelector Belirtilen kimliklere sahip reklam grubu hariç tutulan kitleleri alır.
withLimit(int limit) AdGroupExcludedAudienceSelector Seçim ölçütleriyle eşleşen, ilk n reklam grubu hariç tutulan kitleleri alır.

Almak

Reklam grubu hariç tutulan kitleler listesini yinelemek için kullanılan bir yineleyici alır.

Geri dönüşler

Tür Açıklama
AdGroupExcludedAudienceIterator Seçili reklam grubunda yineleme yapmak için kullanılan yineleyici, hariç tutulan kitleler.

orderBy(String orderBy)

Belirtilen sıralamayı, seçili reklam grubu hariç tutulan kitlelere 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 hariç tutulan kitleleri AverageCPC'ye göre artan sırayla 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
AdGroupExcludedAudienceSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Filtre ölçütlerini reklam grubu hariç tutulan kitlelere 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 hariç tutulan kitle filtrelemesi için desteklenen sütunlar. Adlar büyük/küçük harfe duyarlıdır.

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 hariç tutulan kitleleri 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 hariç tutulan kitleleri 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 hariç tutulan kitleler 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
AdGroupExcludedAudienceSelector Uygulanan koşulla seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip reklam grubu hariç tutulan kitleleri 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 reklam grubu hariç tutulan hedef kitle 33333'ü 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 hariç tutulan kitle kimlikleri. Sınırlar için bkz: Komut dosyası yürütme sınırları.

Geri dönüşler

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

withLimit(int limit)

Seçim ölçütleriyle eşleşen, ilk n reklam grubu hariç tutulan kitleleri alır.

Bağımsız değişkenler

Name Tür Açıklama
sınırlamak int Hariç tutulan kitlelerin geri dönmesi için reklam grubu sayısı. Gerçek sayı daha az olabilir.

Geri dönüşler

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