Aracılığıyla paylaş

CampaignExcludedAudienceSelector

  • Makale

Kampanya hariç tutulan hedef kitlelerin 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 campaigns
    // in the account.
    var shoppingCampaign = AdsApp.shoppingCampaigns().withIds(["123456789"]).get();

    // Loops through all campaigns in the account.
    while (iterator.hasNext()) {
        var campaign = iterator.next();

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

Yöntemler

Yöntem Adı Dönüş Türü Açıklama
Al CampaignExcludedAudienceIterator Kampanya hariç tutulan hedef kitleler listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy) CampaignExcludedAudienceSelector Belirtilen siparişi seçilen kampanya hariç tutulan hedef kitlelere uygular.
withCondition(dize koşulu) CampaignExcludedAudienceSelector Kampanya hariç tutulan hedef kitlelere filtre ölçütleri uygular.
withIds(string[] ids) CampaignExcludedAudienceSelector Belirtilen kimliklere sahip kampanya hariç tutulan hedef kitleleri alır.
withLimit(int sınırı) CampaignExcludedAudienceSelector Seçim ölçütleriyle eşleşen ilk n kampanya hariç tutulan hedef kitleyi alır.

Al

Kampanya hariç tutulan hedef kitleler listesinde yineleme yapmak için kullanılan bir yineleyici alır.

Döndürür

Tür Açıklama
CampaignExcludedAudienceIterator Seçilen kampanyada yineleme yapmak için kullanılan bir yineleyici hariç tutulan hedef kitleler.

orderBy(String orderBy)

Belirtilen siparişi seçilen kampanya 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ı, kampanya hariç tutulan hedef kitleleri 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
CampaignExcludedAudienceSelector Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Kampanya hariç tutulan hedef kitlelere 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

Kampanya 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
AudienceId Uzun İlişkili hedef kitlenin kimliği.

withCondition("AudienceId = 123456789")
CampaignName Dize Derneğin kampanyasının adı.

withCondition("CampaignName CONTAINS_IGNORE_CASE 'truck'")
CampaignStatus Numaralandırma İlişkilendirme kampanyasını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ış kampanya 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 kampanya 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
CampaignExcludedAudienceSelector Koşulun uygulandığı seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip kampanya hariç tutulan hedef kitleleri 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 kampanya hariç 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[] Kampanyadan dışlanan hedef kitle kimlikleri dizisi. Sınırlar için bkz. Betik yürütme sınırları.

Döndürür

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

withLimit(int sınırı)

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

Bağımsız değişken

Name Tür Açıklama
Sınırı Int Kampanyanın geri dönüş için dışlanan hedef kitle sayısı. Gerçek sayı daha az olabilir.

Döndürür

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