İngilizce dilinde oku

Aracılığıyla paylaş


Microsoft Reklam Betikleri için Sürüm Notları

Her sürüme eklenen değişiklikler hakkında bilgi için aşağıdaki bölümlere bakın.

31 Mart 2021

Ortalama konum artık Microsoft Advertising'te kullanılamaz.

getAveragePosition yöntemi Stats nesnesinden kaldırılır.

AveragePosition sütunu, aşağıdaki seçicilere sahip bir koşul olarak kaldırılır.

5 Mart 2021, İstanbul

Toplam gösterimlerinizin yüzdesi olarak mutlak en yüksek gösterim oranı ve en yüksek gösterim oranı desteği eklendi.

İstatistikler nesnesine aşağıdaki yöntemler eklendi.

TopImpressionRate Aşağıdaki seçicilerle belirtebilirsiniz ve mümkün olduğunca sütunlar eklendiAbsoluteTopImpressionRate.

23 Şubat 2021, Saat 2021, İstanbul

Duyarlı arama reklamları için destek eklendi.

  • Duyarlı arama reklamını tanımlayan ResponsiveSearchAd nesnesi eklendi.

  • Reklam grubuna genişletilmiş metin reklamı eklemek için kullandığınız ResponsiveSearchAdBuilder nesnesi eklendi.

  • responsiveSearchAdBuilder Yöntemi AdBuilderSpace nesnesine eklendi. Duyarlı bir arama reklamı oluşturmak istiyorsanız ResponsiveSearchAdBuilder nesnesini almak için yöntemini çağırırsınızresponsiveSearchAdBuilder.

  • Yanıt veren arama reklamı açıklamalarının ve başlıklarının özelliklerini içeren AdTextAsset nesnesi eklendi.

  • Bir reklamın responsiveSearchAd belirtilen türde olup olmadığını test etmek için kullanılan yöntemleri içeren AdTypeSpace nesnesine yöntemini eklendi. Örneğin, reklamın duyarlı bir arama reklamı olup olmadığını test etmek için.

  • responsiveSearchAd Yöntemini, belirli bir türe reklam göndermek için kullanılan AdViewSpace nesnesine eklendi. Örneğin, temel reklam nesnesini duyarlı bir arama reklamına yayınlayın.

21 Ocak 2021, Saat 2021, İstanbul

Hedeflenen ve dışlanan hedef kitleler için destek eklendi.

Bu değişiklik aşağıdaki nesneleri ekledi:

10 Aralık 2020, Cumartesi

Hedeflenen ve dışlanan konumlar için destek eklendi.

Bu değişiklik aşağıdaki nesneleri ekledi:

ExcludedLocationOperation nesnesi eklendi. Betiklerin dışlanan konumu başarıyla ekleyip eklemediğini belirlemek için bunu kullanırsınız.

Betiklerin hedeflenen konumu başarıyla ekleyip eklemediğini belirlemek için kullandığınız TargetedLocationOperation nesnesi eklendi.

31 Mart 2020 Salı

ProductGroup'tan türetilen aşağıdaki nesneler eklendi:

ProductGroup'a aşağıdaki yöntemler eklendi:

  • asChannel()
  • asChannelExclusivity()

Bazı betik örneklerinden Logger.Log() çağrısı kaldırıldı. Günlüğe kaydetme, performans açısından pahalı bir çağrı olduğundan, günlüğe kaydetmeyi tedbirli bir şekilde kullanmak ve büyük olasılıkla sorunların bildirimini sağlamak dışında yüksek hacimli döngülerde kullanmamaktır. Ayrıca, birden çok satır yazmak için birden çok Log() çağrı kullanmak yerine tek bir çağrı kullanın ve yeni satır karakterleri ('\n') ekleyin.

16 Ocak 2020, Saat 2020, İstanbul

Ürün grupları için destek eklendi. Destek, ürün gruplarını listelemek ve tekliflerini güncelleştirmekle sınırlıdır. Örnekler için bkz. betik örnekleri.

Bu değişiklik aşağıdaki nesneleri ekledi:

ProductGroup'tan türetilen aşağıdaki nesneler eklendi:

AdsApp'e aşağıdaki yöntemler eklendi:

AdGroup'a aşağıdaki yöntemler eklendi:

Cammpaign'e aşağıdaki yöntem eklendi:

AdGroupSelector nesnesinin withCondition yöntemine olası bir sütun olarak CampaignType eklendi.

CampaignSelector nesnesinin withCondition yöntemine olası bir sütun olarak Tür eklendi.

18 Ekim 2019, Cumartesi

Id AdSelector ve KeywordSelector nesnelerinin yöntemine sütun withCondition() eklendi. Belirtilen kimlikten büyük kimliklere sahip reklamları veya anahtar sözcükleri denetlemek için bu sütunu kullanabilirsiniz (örneğin, withCondition('Id > 1234')).

Hesaplarınızdaki reklamların veya anahtar sözcüklerin bozuk URL'ler içerip içermediğini denetlemek için kullanabileceğiniz Reklam ve anahtar sözcük URL'lerini denetle betik çözümü eklendi.

7 Ekim 2019, Cumartesi

Anahtar sözcükleri seçerken belirteceğiniz olası bir sütun olarak eklendi CombinedApprovalStatus . Örneğin, editoryal nedenlerle onaylanmamış anahtar sözcükleri seçmek için sütununu kullanabilirsiniz. Bkz . KeywordSelector.withCondition.

13 Eylül 2019, Cumartesi

Betiğin yürütülmekte olduğu ortam hakkında bilgi içeren ExecutionInfo nesnesi eklendi. Örneğin, betik önizleme modunda çalışıyorsa veya betiğin yürütülmeye devam etmesine izin verilen süre.

getExecutionInfo Yöntemi AdsApp nesnesine eklendi. Nesnesini almak ExecutionInfo için bu yöntemi kullanın.

getRemainingDailyQuota UrlFetchApp nesnesine yöntemini eklendi. Kullanıcının bugün gerçekleştirebileceği kalan çağrı sayısını fetch() almak için bu yöntemi kullanın.

20 Ağustos 2019, Ağustos 2019, Ağustos 2019, Ağustos 2019, Ağustos

Aşağıda yalnızca belgelerde yapılan bir değişiklik yer alır.

  • Betiklerin hesabın saat dilimini Microsoft Advertising'in başka bir yerinde olduğu gibi kullandığı netleştirildi. Örneğin, bir seçicinin .forDateRange() yöntemini kullanırsanız, Betikler döndürülecek verileri belirlemek için hesabın saat dilimini kullanır. Daha fazla bilgi edinin
  • Betiklerdeki veri gecikme süresinin Microsoft Advertising'in başka bir yerindekiyle aynı olduğunu açıklığa kavuşturma. Daha fazla bilgi edinin

Aşağıdakiler, destek etiketlerine yapılan hataya neden olmayan API değişiklikleridir.

  • AdsApp nesnesine aşağıdaki yöntemler eklendi.
    • createLabel — bir etiket oluşturur
    • etiketler — bu hesaptaki etiket listesini filtrelemek için kullanılan bir seçici alır
  • Etiketle ilgili aşağıdaki nesneler eklendi.
    • Etiket — bir etiket tanımlar.
    • LabelSelector — hesabın etiket listesini alır.
    • LabelIterator — seçicinin seçim ölçütleriyle eşleşen etiketlerin listesini yineler.
  • Anahtar Sözcük nesnesine aşağıdaki yöntemler eklendi.
    • applyLabel — etiketi anahtar sözcüğüne uygular
    • etiketler — bu anahtar kelimeye uygulanan etiket listesini filtrelemek için kullanılan bir seçici alır
    • removeLabel — etiketi bu anahtar sözcükten kaldırır
  • KeywordSelector nesnesinin withCondition yöntemine LabelNames sütunu eklendi.
  • Ad ve ExpandedTextAd nesnelerine aşağıdaki yöntemler eklendi.
    • applyLabel — etiketi reklama uygular
    • etiketler — bu reklama uygulanan etiket listesini filtrelemek için kullanılan seçiciyi alır
    • removeLabel — etiketi bu reklamdan kaldırır
  • AdSelector nesnesinin withCondition yöntemine LabelNames sütunu eklendi.
  • AdGroup nesnesine aşağıdaki yöntemler eklendi.
    • applyLabel — etiketi reklam grubuna uygular
    • etiketler — bu reklam grubuna uygulanan etiket listesini filtrelemek için kullanılan bir seçici alır
    • removeLabel — etiketi bu reklam grubundan kaldırır
  • AdGroupSelector nesnesinin withCondition yöntemine LabelNames sütunu eklendi.
  • Campaign nesnesine aşağıdaki yöntemler eklendi.
    • applyLabel — etiketi kampanyaya uygular
    • etiketler — bu kampanyaya uygulanan etiket listesini filtrelemek için kullanılan bir seçici alır
    • removeLabel — etiketi bu kampanyadan kaldırır
  • CampaignSelector nesnesinin withCondition yöntemine LabelNames sütunu eklendi.

30 Nisan 2019, Mayıs 2019, Mayıs 2019, Mayıs 2019, Mayıs

Aşağıda yalnızca belgelerde yapılan bir değişiklik yer alır.

  • Bing Ads artık Microsoft Advertising'tir. Yeni adımız, daha fazla müşteriye ulaşmanıza yardımcı olmak için reklam çözümlerimizi nasıl büyüttiğimizi yansıtır. Belgelerde Bing Ads platformuna yapılan tüm başvurular Microsoft Advertising olarak değiştirildi.

Aşağıda, marka güncelleştirmesini desteklemek için hataya neden olmayan API değişiklikleri verilmiştır.

  • AdsApp nesnesi eklendi. Betikler geriye dönük uyumluluk için BingAdsApp nesnesini desteklemeye devam eder; ancak, betiklerinizi en erken kolaylıkta yeni nesneleri kullanacak şekilde güncelleştirmeniz tavsiye edilir.

25 Mart 2019 Pazartesi

Aşağıda yalnızca belgelerde yapılan bir değişiklik yer alır.

11 Şubat 2019, İstanbul

BingAdsAccountStats nesnesine aşağıdaki yöntemler eklendi.

Not

getClickConversionRate() ve getConvertedClicks() yöntemlerini kullanıyorsanız, bunun yerine betiklerinizi getConversionRate() ve getConversions() yöntemlerini kullanacak şekilde güncelleştirmeniz gerekir.

İstatistikler nesnesine aşağıdaki yöntemler eklendi.

Not

getClickConversionRate() ve getConvertedClicks() yöntemlerini kullanıyorsanız, bunun yerine betiklerinizi getConversionRate() ve getConversions() yöntemlerini kullanacak şekilde güncelleştirmeniz gerekir.

27 Kasım 2018, İstanbul

Aşağıda yalnızca belgelerde yapılan bir değişiklik yer alır.

7 Kasım 2018, 2018

Aşağıda yalnızca belgelerde yapılan bir değişiklik yer alır.

  • Önizleme notu, Betiklerin artık açık beta sürümünde olduğunu ve tüm Microsoft Advertising kullanıcılarının kullanımına sunulduğunı gösterecek şekilde değiştirildi.

4 Ekim 2018, Cumartesi

Bu Betiklerin Beta sürümüdür. Programa katılma hakkında bilgi için lütfen hesap yöneticinize başvurun. Betik sınıfları ve belgeleri değiştirilebilir.

URL getirmeyi desteklemek için aşağıdaki nesneler eklendi.

  • Web'den kaynak getirmek için kullandığınız en üst düzey nesne olan UrlFetchApp nesnesi eklendi.

  • Getirilen kaynağın içeriğine erişme yöntemlerini içeren HTTPResponse eklendi.

  • Web'den kaynak getirme sınırlarını listeleyen UrlFetch sınırları konusu eklendi.

Aşağıdaki konuları ekleyin:

2 Ekim 2018, Cumartesi

Birden çok hesabı desteklemek için aşağıdaki nesneler ve yöntemler eklendi.

  • currentAccount yöntemi BingAdsApp'e eklendi. Betiğin işlemekte olduğu hesap hakkında bilgi içeren Account nesnesini almak için bu yöntemi kullanın.

  • AccountsApp nesnesi eklendi. Bu, başkaları için hesapları yönetiyorsanız kullandığınız en üst düzey nesnedir. Erişiminiz olan hesapların listesini almak ve yönetecek hesabı seçmek için bu hesabı kullanın.

  • BingAdsAccount nesnesi eklendi. Ad, müşteri kimliği ve hesap düzeyinde performans verileri gibi yönetilen bir hesabın hesap bilgilerini almak için bunu kullanın.

  • BingAdsAccountIterator nesnesi eklendi. Seçtiğiniz yönetilen hesaplar listesinde yineleme yapmak için bunu kullanın.

  • BingAdsAccountSelector nesnesi eklendi. Almak istediğiniz yönetilen hesapların listesini seçmek için bunu kullanın.

  • BingAdsAccountStats nesnesi eklendi. Yönetilen hesabın performans verilerine erişmek için bunu kullanın.

  • ExecutionResult nesnesi eklendi. Selector yönteminde executeInParallel belirttiğiniz işlevin sonuçlarını almak ve değerini döndürmek için bunu kullanın (bkz . BingAdsAccountSelector).

Paylaşılan bütçeleri desteklemek için Bütçe nesnesine aşağıdaki alanlar eklendi.

  • kampanyalar — Bu bütçeyi paylaşan tüm kampanyaları döndüren bir seçici alır.
  • getEntityType — Nesnenin türünü alır.
  • getId — Paylaşılan bütçeyi benzersiz olarak tanımlayan kimliği alır.
  • getName — Paylaşılan bütçenin adını alır.
  • getStats — Bu bütçeyi paylaşan kampanyaların performans verilerini alır.
  • getType — Bütçenin türünü alın (örneğin, GÜNLÜK).
  • isExplicitlyShared — Bu bütçenin paylaşılan bütçe olup olmadığını gösteren bir Boole değeri alır.

getId, getNameve getStats yöntemleri yalnızca paylaşılan bütçeler için veri döndürür; ve getName yöntemleri paylaşılmayan getId (tek tek kampanya) bütçeler için null döndürür.

BingAdsApp nesnesine aşağıdaki alan eklendi.

  • bütçeler — Hesaptaki tüm paylaşılan bütçeleri alır. Paylaşılan bütçe listesini filtrelemek için seçiciyi kullanın.

Paylaşılan bütçeler listesinde filtrelemek ve döngü yapmak için kullandığınız aşağıdaki nesneleri eklediniz.

  • BudgetSelector — Paylaşılan bütçe listesini filtreleme ve sıralama yöntemlerini içerir.

  • BudgetIterator — Paylaşılan bütçeler listesinde döngüye alma yöntemlerini içerir. Seçicinin get yöntemi yineleyiciyi döndürür.

Seçici yalnızca paylaşılan bütçeleri döndürür; paylaşılmayan (tek tek kampanya) bütçeleri içermez. Bir kampanyanın tek bir bütçe kullanıp kullanmadığını belirlemek için, kampanyanın getBudget yöntemini çağırarak bütçeyi alın. Ardından, bütçenin paylaşılıp paylaşılmadığını isExplicitlyShared belirlemek için bütçenin yöntemini çağırın. True döndürürse isExplicitlyShared bütçe paylaşılır.

1/10/2018

Anahtar Sözcük nesnesine aşağıdaki yöntemi eklendi.

  • getQualityScore — Anahtar sözcüğün kalite puanını alır. Puan 1 ile 10 (en yüksek) aralığındadır. Puan, anahtar sözcüklerinizin ve giriş sayfalarınızın müşterilerin arama terimleriyle ne kadar ilgili olduğunu ölçerek reklamlarınızın markette ne kadar rekabetçi olduğunu gösterir.

12 Eylül 2018, Cumartesi

Bir varlığın üst ve alt varlıklarını almak için aşağıdaki yöntemler eklendi.

  • AdGroup.getCampaign — Reklam grubunun ait olduğu kampanyayı alır.
  • AdGroup.keywords — Reklam grubunun anahtar sözcük listesini filtrelemek için kullanılan bir seçici alır.
  • AdParam.getAdGroup — Bu değiştirme parametresiyle ilişkili anahtar sözcüğün ait olduğu reklam grubunu alır.
  • AdParam.getKeyword — Değiştirme parametresinin uygulandığı anahtar sözcüğü alır.
  • Campaign.adGroups — Kampanyanın reklam grupları listesini filtrelemek için kullanılan bir seçici alır.
  • Campaign.keywords — Kampanyanın anahtar sözcük listesini filtrelemek için kullanılan bir seçici alır.
  • Keyword.getCampaign — Anahtar sözcüğün ait olduğu kampanyayı alır.
  • Keyword.getAdGroup — Anahtar sözcüğün ait olduğu reklam grubunu alır.
  • NegativeKeywordList.campaigns — Negatif anahtar sözcük listesinin ilişkili olduğu kampanyaların listesini filtrelemek için kullanılan bir seçici alır.

9 Eylül 2018, Cumartesi

Reklamlar için destek eklendi.

  • newAd yöntemini AdGroup'a ekledik. yöntemi, reklam oluşturucu almak için kullandığınız bir AdBuilderSpace nesnesi döndürür.

  • AdBuilderSpace nesnesi eklendi. nesnesi, reklam oluşturucuları almak için yöntemler içerir. Örneğin, genişletilmiş bir metin reklamı oluşturmak istiyorsanız, ExpandedTextAdBuilder nesnesini almak için nesnenin expandedTextAdBuilder yöntemini çağırırsınız.

  • Reklam grubuna genişletilmiş metin reklamı eklemek için kullandığınız ExpandedTextAdBuilder nesnesi eklendi.

  • Betiklerin reklamı başarıyla ekleyip eklemediğini belirlemek için kullandığınız AdOperation nesnesi eklendi.

  • Belirli bir türe reklam göndermek için kullanılan yöntemleri içeren AdViewSpace nesnesi eklendi. Örneğin, temel reklam nesnesini genişletilmiş bir metin reklamına yayınlayın.

  • Bir reklamın belirtilen türde olup olmadığını test etmek için kullanılan yöntemleri içeren AdTypeSpace nesnesi eklendi. Örneğin, reklamın genişletilmiş metin reklamı olup olmadığını test etmek için.

  • Temel reklam türü olan Ad nesnesi eklendi. Ayrıca bir metin reklamı tanımlar.

  • Reklamın URL'lerini, izleme şablonunu ve özel parametrelerini alma yöntemlerini içeren AdUrls nesnesi eklendi.

  • Genişletilmiş metin reklamını tanımlayan ExpandedTextAd nesnesi eklendi.

  • Reklam seçmek için filtre ölçütlerini belirtmek için kullandığınız AdSelector nesnesi eklendi.

  • Filtrelenmiş reklam listesinde yinelemek için kullandığınız AdIterator nesnesi eklendi.

  • ads yöntemi BingAdsApp'e eklendi. yöntemi, hesaptaki reklamları seçmek için filtre ölçütlerini belirtmek için kullandığınız AdSelector nesnesini döndürür.

  • ads yöntemini AdGroup'a ekledik. yöntemi, reklam grubundaki reklamları seçmek için filtre ölçütlerini belirtmek için kullandığınız AdSelector nesnesini döndürür.

  • ads yöntemini Campaign'a ekledik. yöntemi, kampanyadaki reklamları seçmek için filtre ölçütlerini belirtmek için kullandığınız AdSelector nesnesini döndürür.

15 Haziran 2018, Ağustos 2018, Ağustos 2018, Ağustos 2018, Ağustos

Kapalı beta sürümü. Microsoft Advertising Script'in bu sürümü yalnızca belirli katılımcılar tarafından kullanılabilir. Önizleme sürümü programına katılma hakkında bilgi için lütfen hesap yöneticinize başvurun. Betik sınıfları ve belgeleri değiştirilebilir.

Bu ilk sürüm aşağıdaki özellikleri içerir:

  • Temel kampanya yönetimi (kampanyalar, reklam grupları, anahtar sözcükler)
  • Varlık düzeyinde performans verileri (kampanyalar, reklam grupları, anahtar sözcükler)
  • Paylaşılan Negatif Anahtar Sözcük Listeleri