Aracılığıyla paylaş

AdGroupExcludedAudienceSelector

Dışlanan 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 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ı Dönüş Türü Açıklama
Al AdGroupExcludedAudienceIterator Dışlanan reklam grubu hedef kitleleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy) AdGroupExcludedAudienceSelector Belirtilen sıralamayı seçili reklam grubu hariç tutulan hedef kitlelere uygular.
withCondition(dize koşulu) AdGroupExcludedAudienceSelector Filtre ölçütlerini, hariç tutulan reklam grubu hedef kitlelerine uygular.
withIds(string[] ids) AdGroupExcludedAudienceSelector Belirtilen kimliklerle dışlanan reklam grubu hedef kitlelerini alır.
withLimit(int sınırı) AdGroupExcludedAudienceSelector Seçim ölçütleriyle eşleşen ilk n reklam grubu hariç tutulan hedef kitleyi alır.

Al

Dışlanan reklam grubu hedef kitleleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Döndürür

Tür Açıklama
AdGroupExcludedAudienceIterator Seçilen reklam grubu hariç tutulan hedef kitleleri yinelemek için kullanılan bir yineleyici.

orderBy(String orderBy)

Belirtilen sıralamayı seçili reklam grubu hariç tutulan hedef kitlelere 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ı AverageCpc tarafından artan sırada dışlanan reklam grubu hedef kitlelerini 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
AdGroupExcludedAudienceSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

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

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 hariç tutulan hedef kitleleri 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ış olan reklam grubu hariç tutulan hedef kitleleri 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 etkin olan reklam grubu hariç tutulan hedef kitleleri 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
AdGroupExcludedAudienceSelector Koşulun uygulandığı seçici.

withIds(string[] ids)

Belirtilen kimliklerle dışlanan 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 hariç tutulan 33333 hedef kitlesini 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 kimliklerini dışlar. Sınırlar için bkz. Betik yürütme sınırları.

Döndürür

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

withLimit(int sınırı)

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

Bağımsız değişken

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

Döndürür

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