Sıklık sınırı, belirli bir kategorideki reklamların belirli bir dönem içinde kullanıcıya gösterilme sayısını sınırlayan bir reklamcılık uygulamasıdır. Sıklık sınırı, reklam gösterimlerini yeni ve ilgi çekici tutarak son kullanıcı deneyimini iyileştirir ve reklamverenlerin reklam harcamalarını yönetmelerine yardımcı olur.
Bu teklifte, Android'de Protected Audience'ın sıklık sınırlama işlevini doğru ve gizliliği koruyacak şekilde uygulamak için nasıl kullanılabileceği açıklanmaktadır.
Protected Audience, iki özelliği birleştirerek sıklık sınırını uygular: Reklama özgü etkinlikler için sayaçların cihaz üzerinde depolanması ve reklamların önceden tanımlanmış bir filtre stratejileri grubuna göre filtrelenebilmesi. Sıklık sınırı, reklamverenlerin belirli bir süre için histogram değerleri toplamı üzerinden bir sayaç eşiği belirtmesine olanak tanır.
Sayaçlar, cihaz profili, reklam teknolojisi ve sayaç anahtarı kombinasyonlarının her biri için benzersizdir. Her reklam, reklam için bir görüntüleme veya gösterim kaydedilmesi durumunda kullanılacak bir dizi sayaç anahtarı içermelidir. Protected Audience, her anahtar için bir sayaç grubu depolar ve her sayaç, belirli bir zaman aralığında gerçekleşen tüm reklama özgü etkinlikleri sayar. Cihaz üzerinde sayaçlar, bir gösterim veya görüntüleme gerçekleştiğinde artırılır ve sayaç verileri cihazda kalıcı olarak saklanır. Tam kalıcılık süresi daha sonra tanımlanacaktır.
Protected Audience'ın reklam seçimi iş akışındaki reklam filtreleme mantığı sayaçlara, yeniden pazarlama reklamlarına ve bağlamsal reklamlara erişebilir. Bu sayede Protected Audience sıklık sınırı, bu türdeki tüm reklam istekleriyle çalışabilir.
Not: Reklam filtreleme yalnızca Android'deki Özel Korumalı Alan'da kullanılabilir. Chrome'un Protected Audience uygulaması, bağlamsal olarak hedeflenen Protected Audience dışı reklamları filtrelemek için bir mekanizma uygulamaz. Bu teklif yalnızca satın alma tarafı desteğini kapsar. Talep olursa daha sonra satıcı tarafı desteği ekleyeceğiz.
Protected Audience sıklık sınırı, aşağıdakiler de dahil olmak üzere geniş bir gereksinim aralığını destekler:
- Cihazdaki sayaçlar güncellendiğinde sunucu tarafında minimum gecikmeyle gerçek zamanlı filtreleme.
- Tek tek reklamlar, kampanyalar veya diğer gruplandırmalar dahil olmak üzere esnek anahtar hiyerarşisi.
- AdID'ye bağımlı olmadan diğer sıklık sınırı yöntemleriyle uyumluluk.
- Belirli bir cihaz kullanıcı profilindeki uygulamalarda çalışır.
- Doğru ve eksiksiz sayaçlar.
- Görüntüleme veya gösterim gibi reklam etkinliklerinin özel tanımları için destek.
- Hem yeniden pazarlama hem de bağlamsal reklamlar için tek bir işlev.
Sıklık sınırını ayarlamak için aşağıdaki adımları uygulayın:
1. adım: Reklamlara sıklık sınırlama bilgileri ekleyin
Bağlamsal ve yeniden pazarlama reklamları, ad_counter_keys alanını kullanarak görüntüleme veya gösterim durumunda güncellenecek ilgili histogram sayaçlarını belirtir. Bu alan, rastgele tam sayıların listesini içerir. Alan, Protected Audience tarafından ayrıştırılmayan metadata alanına dahil edilmemiştir.
Aşağıdaki örnekte, AdSelectionConfig içindeki adsData alanının veri biçimi gösterilmektedir. Yeniden pazarlama için, belirli bir özel kitleye yönelik reklam listesinin biçimi, aşağıdaki örnekte gösterilen ads alanının içeriğiyle tutarlıdır:
'adsData': [
{
"buyer": "ads.example.com",
"ads": [
{
'render_url': 'exampleUrl',
'metadata': {...}, /* metadata are opaque to Protected Audience are
required to be in valid JSON format */
'ad_counter_keys': [1234, 5678]
}]
}]
}
2. adım: Görüntüleme veya gösterim kaydetme
Reklam teknolojileri, sıklık sınırlaması için kullanılan etkinliklerin oluşumlarını kaydetmek üzere updateAdCounterHistogram yöntemini çağırabilir. Bir yöntem, kazanan reklamın eventType bölümünde belirtilen anahtarlar için aynı etkinlikte tekrar tekrar çağrılabilir.
void updateAdCounterHistogram(@EventType eventType, long adSelectionId)
Girişler:
eventType: Bir etkinliğin görüntüleme, gösterim, tıklama veya reklam seçimi sürecinin kazanılması olarak sayılıp sayılmadığını tanımlar.adSelectionId:selectAdsçağrıları tarafından döndürülenAdSelectionOutcomenesnesindeki kimlik değerleri.
updateAdCounterHistogram çağrısı, CustomAudience tarafından getirilen yeniden pazarlama reklamları veya selectAds için AdSelectionConfig parametresine dahil edilen bağlamsal reklamlar kapsamında tanımlanan anahtar grubu için histogramı günceller.
1. adımdaki reklamın AdSelection değerine sahip bir id kazandığını varsayarsak 9999 değerine sahip bir updateAdCounterHistogram(FrequencyCapFilters.AD_EVENT_TYPE_VIEW,
adSelectionId: 999) çağrısı, aşağıdaki üç temel anahtarın sayaçlarını artırır:
{'ads.example.com', 1234, VIEW}{'ads.example.com', 5678, VIEW}
Reklam teknolojisi adı, kazanan reklamların nereden geldiğine bağlı olarak bağlamsal reklamlardan veya özel kitlelerden alıcı alanından alınır.
Android için Protected Audience, FrequencyCapFilters.AD_EVENT_TYPE_WIN API çağrısıyla döndürülen reklamlar için selectAds etkinlik türüyle ilgili daha önce bahsedilen tüm sayaçları otomatik olarak artırır. Bu, Chrome'un Protected Audience uygulamasında generateBid içindeki browser_signals işlevine prev_wins bağımsız değişkeninin eklenmesine işlevsel olarak eşdeğerdir.
3. adım: Filtrelerle sıklık sınırı filtrelemeyi uygulayın
Optimum performans için sıklık sınırı filtreleme işlevi AdServices içinde yürütülür. Protected Audience, AdsData nesnesindeki filtreler alanını okuyarak bir mesajın filtrelenmesi gerekip gerekmediğini anlar. frequency_cap içinde bir filtre listesi belirtilir. Anahtar, event_type ve interval_in_seconds değerleri, filtreleme ve Protected Audience için kullanılan etkinliklerin histogramını almak üzere kullanılır.
Filtreleme bilgileri, özel bir kitle tarafından sağlanan yeniden pazarlama reklamları ve AdSelectionConfig nesnesinin bir parçası olarak bağlamsal reklamlar için belirtilebilir.
Sıklık sınırı filtreleri içeren bağlamsal reklamlarda, reklamlar AdSelectionConfig nesnesindeki ads alanı kullanılarak iletilir. Reklamlar filtrelenir ve selectAds çağrısının sonucu olarak en yüksek teklife sahip reklam döndürülür.
Sıklık sınırı filtreleri içeren yeniden pazarlama reklamlarında, alıcı tarafından sağlanan generateBid() JavaScript işlevi çağrılmadan önce reklamlar filtrelenir.
Aşağıdaki örnekte, sıklık sınırı filtrelemesi içeren bir mesaj gösterilmektedir:
{
'render_url': 'url',
'metadata': {...}, /* metadata are opaque to Protected Audience and assumed
to be in valid JSON format */
'ad_counter_keys': [1234, 5678],
"filters": {
"frequency_cap": {
"view": [
{
"ad_counter_key": 1234
"max_count": 10,
"interval_in_seconds": 86400
},
{
"ad_counter_key": 5678
"max_count": 10,
"interval_in_seconds": 86400
},
],
"win": [
{
"ad_counter_key": 1234
"max_count": 5,
"interval_in_seconds": 604800
},
{
"ad_counter_key": 5678
"max_count": 5,
"interval_in_seconds": 345600
},
]
},
// This field is only required in contextual ads and is used in
// reportImpression calls to fetch the reportWin function.
'reportingJS': "https://ads.example.com?reportWin.js"
}
4. adım: Kazanan reklamlarla ilgili rapor oluşturun
Reklam seçme işlemi tamamlandıktan sonra AdSelectionOutcome
renderUri ve adSelectionId içeren bir nesne döndürülür. Bu nesne, selectAds çağrısı için sayısal bir tanımlayıcıdır. Bu kimlik, etkinlik düzeyinde raporlamayı destekleyen reportImpression API'sini çağırmak için kullanılabilir. Beta 1'de bu yöntem, yeniden pazarlama reklamları için raporlamayı destekler ve daha sonraki bir sürümde bağlamsal reklamlar için raporlamayı destekleyecek şekilde genişletilecektir. Bağlamsal reklamlar için alıcının, önceki örnekte gösterildiği gibi reklam yapısında reportingJS adlı ek bir alan kullanarak reportImpression işlevinin bir reportWin çağrısı sırasında nereden alınabileceğini belirtmesi gerekir.
Reklam adaylarını seçmeyle ilgili en iyi uygulamalar
Protected Audience, sıklık sınırının uygulanmasını sunucudan cihaza taşır. Kazanan teklifler Özel Korumalı Alan ile bildirilir ancak geliştiriciler bir reklamın neden gösterilmediğini bilemez. Reklamlar, teklif kaybı veya sıklık sınırı nedeniyle gösterilmeyebilir. Belirli reklamların neden kazanmadığına dair tam görünürlük olmadığından, teklif sistemlerinin en uygun reklamların yayınlandığını doğrulamak için ek çalışma yapması gerekir. Bu en iyi uygulamalar, Protected Audience ile optimum reklam yayınını doğrulamanıza yardımcı olur.
Yeterli sayıda yeniden pazarlama reklamı gönderme
Yeniden pazarlama reklamları kullanıcıya göre optimize edilemez. Bir kullanıcı, özel kitleye ait çok sayıda reklam görürse ve reklam sınırları düşükse tüm reklamlar filtrelenebilir. Yeniden pazarlama reklamları düzenli olarak yenilenir. Bu nedenle, yeniden pazarlama reklamlarının yayınlanmaya devam ettiğini doğrulamak için sıklık sınırlaması aracılığıyla yeterli reklam envanterinin geçmesi gerekir. Bu, joinCustomAudience çağrısı sırasında ve özel kitle günlük güncellemesi sırasında belirtilebilen reklamların boyutuyla ilgili sınırlamalarla dengelenmelidir. Alıcılar, teklif verme aşamasında gecikme olabileceğini göz önünde bulundurmalıdır. Bu sorunların etkisini en aza indirmek için generateBid çağrısından önce sıklık sınırı filtreleme işlemi gerçekleştirilir.
Bağlamsal sayaçları sunucuda tutma
Sunucu tarafı tahmin özelliği sayesinde geliştiriciler, sıklık sınırının ne zaman etkin olabileceğine dair kabaca tahminler yapabilir. Bu tahminler, bir reklamın sıklık sınırı eşiğine ulaşmış olabileceğini ve bu nedenle daha fazla reklam adayıyla gönderilmesi veya tamamen kaldırılması gerektiğini gösterebilir.
Bağlamsal yanıtta birden fazla reklam adayı gönderme
Bir Protected Audience açık artırmasından önce bağlamsal yanıt içeren birden fazla reklam adayı göndermeniz gerekir. Bu, birkaç reklam filtrelendiğinde diğer reklamların gösterilmeye devam ettiğini doğrular. Reklam adaylarına öncelik verilebilir. Böylece bazı reklamlar yedek olarak sağlanır.
Yürütme zamanla sınırlı olduğundan reklam adayları, açık artırmayı kazanma ve filtrelenmeme olasılıklarına göre seçilmelidir.
Sınırlamalar
Protected Audience sıklık sınırıyla ilgili bilinen sınırlamalar şunlardır:
- Protected Audience sıklık sınırı, cihaz kullanıcı profili düzeyinde çalışır. Diğer cihazlarda ve diğer profillerde paylaşılan sayaçlar yoktur. Gerekirse diğer cihazlarda gösterilen reklamların artışları manuel olarak dahil edilmelidir.
- Cihaz sayaçları cihazda depolanır ve cihaza erişilir. Sunucu tarafı sayaçların ayrı ayrı yönetilmesi gerekir.
- Sıklık sınırı ve ilgili reklam filtreleme işlemleri cihazda yapıldığından reklam teknolojisi platformları bu işlemler üzerinde doğrudan kontrole sahip değildir. Reklam teknolojisi platformları, cihazın sıklık sınırlama eşiğini atlamak için farklı filtreler içeren birden fazla aday reklam gönderebilir.
- Kayıtlı sıklığa dayalı teklif ayarlamaları desteklenmez.
generateBidişlevleri, sıklık sayaçlarını görüntüleyemez.
Sizin için önerilenler
- Not: JavaScript kapalıyken bağlantı metni gösterilir.
- Protected Audience: entegrasyon kılavuzu Android'de Protected Audience API geliştirici kılavuzu
- Protected Audience API ile özel kitle hedeflemeyi destekleme