CampaignAudienceSelector

Makale
12/21/2023

Kampanya 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 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 audiences
        // in the campaign audience.
        var audienceIterator = campaign.targeting().audiences()
            .withLimit(10)
            .withIds("123456789")
            .get();
    
        // Loops through all campaign audiences in the campaign audience.
        while (audienceIterator.hasNext()) {
            var audience = audienceIterator.next();
        }
    }

Yöntemler

Yöntem Adı	Dönüş Türü	Açıklama
forDateRange(Object dateFrom, Object dateTo)	CampaignAudienceSelector	Performans ölçümlerini seçmek için başlangıç ve bitiş tarihlerini uygular.
forDateRange(string dateRange)	CampaignAudienceSelector	Performans ölçümlerini seçmek için önceden tanımlanmış tarih aralığını uygular.
Al	CampaignAudienceIterator	Kampanya hedef kitleleri listesinde yineleme yapmak için kullanılan bir yineleyici alır.
orderBy(string orderBy)	CampaignAudienceSelector	Belirtilen siparişi seçilen kampanya hedef kitlelerine uygular.
withCondition(dize koşulu)	CampaignAudienceSelector	Filtre ölçütlerini kampanya hedef kitlelerine uygular.
withIds(string[] ids)	CampaignAudienceSelector	Belirtilen kimliklere sahip kampanya hedef kitlelerini alır.
withLimit(int sınırı)	CampaignAudienceSelector	Seçim ölçütleriyle eşleşen ilk n kampanya 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
CampaignAudienceSelector	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
CampaignAudienceSelector	Tarih aralığı uygulanmış seçici.

Al

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

Döndürür

Tür	Açıklama
CampaignAudienceIterator	Seçilen kampanya hedef kitleleri arasında yineleme yapmak için kullanılan bir yineleyici.

orderBy(String orderBy)

Belirtilen siparişi seçilen kampanya 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ı, kampanya hedef kitlelerini AverageCpc'ye göre artan düzende 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
CampaignAudienceSelector	Sıralama uygulanmış seçici.

withCondition(Dize koşulu)

Filtre ölçütlerini kampanya hedef kitlelerine uygular.

koşul parametresini şu şekilde belirtin: "columnName işleç değeri":

columnNamedesteklenen Sütunlardan biridir. columName bir performans ölçümü sütun adına ayarlandıysa, forDateRange(String dateRange) veya forDateRange(Object dateFrom, Object dateTo) kullanarak bir tarih aralığı belirtmeniz gerekir.
işleç desteklenen işleçlerden biridir.

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 hedef kitlesi 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
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 kampanya duraklatılmış olan kampanya 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 etkin kampanya 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
CampaignAudienceSelector	Koşulun uygulandığı seçici.

withIds(string[] ids)

Belirtilen kimliklere sahip kampanya 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 kampanya 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 kampanya hedef kitlesi kimliği. Sınırlar için bkz. Betik yürütme sınırları.

Döndürür

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

withLimit(int sınırı)

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

Bağımsız değişken

Name	Tür	Açıklama
Sınırı	Int	Geri dönecek kampanya hedef kitlelerinin sayısı. Gerçek sayı daha az olabilir.

Döndürür

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

Aracılığıyla paylaş

CampaignAudienceSelector

Yöntemler

forDateRange(Object dateFrom, Object dateTo)

Bağımsız değişken

Döndürür

forDateRange(String dateRange)

Bağımsız değişken

Döndürür

Al

Döndürür

orderBy(String orderBy)

Bağımsız değişken

Döndürür

withCondition(Dize koşulu)

Işleç

Desteklenen Sütunlar

Bağımsız değişken

Döndürür

withIds(string[] ids)

Bağımsız değişken

Döndürür

withLimit(int sınırı)

Bağımsız değişken

Döndürür

Geri Bildirim

Ek kaynaklar