Korumalı Kitle sıklık sınırı

Sıklık sınırı, belirli bir dönem içinde bir kullanıcıya gösterilecek belirli bir kategorideki reklamların sayısını sınırlayan bir reklamcılık uygulamasıdır. Sıklık sınırı, reklam gösterimlerinin güncel ve ilgi çekici kalmasını sağlayarak son kullanıcı deneyimini iyileştirir ve reklamverenlerin reklam harcamalarını yönetmelerine yardımcı olur.

Bu teklifte, Android'de Korunan Kitle'nin sıklık sınırı işlevini doğru ve gizliliği korumaya yönelik bir şekilde uygulamak için nasıl kullanılabileceği açıklanmaktadır.

Korunan Kitle, iki özelliği birleştirerek sıklık sınırı uygular: Reklama özel etkinlikler için sayaçların cihazda depolanması ve reklamları önceden tanımlanmış bir filtre stratejisi grubuna göre filtreleme özelliği. Sıklık sınırı, reklamverenlerin belirli bir dönem için histogram değerlerinin toplamı üzerinden bir karşı eşiği belirtebilmelerini sağlar.

Her cihaz profili, reklam teknolojisi ve sayaç anahtarı kombinasyonu için sayaçlar benzersizdir. Her reklamda, reklamla ilgili bir görüntüleme veya gösterimin kaydedilmesi durumunda kullanılacak bir dizi sayaç anahtarı bulunmalıdır. Korunan Kitle her anahtar için bir sayaç grubu depolar ve her sayaç, belirli bir zaman aralığında gerçekleşen reklama özel tüm etkinlikleri sayar. Bir gösterim veya görüntüleme gerçekleştiğinde cihaz üzerindeki sayaçlar artar ve sayaç verileri cihazda kalır. Tam kalıcılık süresi daha sonra tanımlanacaktır.

Korunan Kitlenin reklam seçimi iş akışındaki reklam filtreleme mantığı, sayaçlara, yeniden pazarlama reklamlarına ve içeriğe dayalı reklamlara erişebilir. Böylece, Korunan Kitle sıklık sınırına bu tür tüm reklam istekleriyle çalışabilirsiniz.

Not: Reklam filtrelemesi yalnızca Android'deki Özel Korumalı Alan'da kullanılabilir. Chrome'un Korunan Kitle uygulaması şu anda, içeriğe dayalı olarak hedeflenen, Korunmayan Kitle reklamlarının filtrelenmesi için bir mekanizma uygulamamaktadır. Bu teklif yalnızca alıcı tarafında desteği kapsar. Talep varsa daha sonraki bir tarihte satış tarafı desteği ekleyeceğiz.

Korunan Kitle sıklık sınırı, aşağıdakiler de dahil olmak üzere çok çeşitli gereksinimleri destekler:

  • Cihazdaki sayaçlar güncellendiğinde sunucu tarafında minimum gecikmeyle gerçek zamanlı filtreleme.
  • Bağımsız reklamlar, kampanyalar veya diğer gruplandırmalar dahil olmak üzere anahtarların esnek hiyerarşisi.
  • Reklam Kimliğine 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ülemeler veya gösterimler gibi reklam etkinliklerinin özel tanımları için destek.
  • Aynı işlev, hem yeniden pazarlama hem de içeriğe dayalı reklamlar için geçerlidir.

Sıklık sınırını ayarlamak için aşağıdaki adımları izleyin:

1. Adım: Reklamlara sıklık sınırı bilgileri ekleme

İçeriğe dayalı ve yeniden pazarlama reklamları, rastgele bir tam sayı listesi içeren ad_counter_keys alanını kullanarak görüntüleme veya gösterim durumunda güncellenecek ilgili histogram sayaçlarını gösterir. Alan, Korunan Kitle tarafından ayrıştırılmayan metadata alanına dahil edilmez.

Aşağıdaki örnekte, AdSelectionConfig içindeki adsData alanının veri biçimi gösterilmektedir. Yeniden pazarlamada, 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: Bir görüntüleme veya gösterimi kaydetme

Reklam teknolojileri, sıklık sınırı için kullanılan etkinliklerin gerçekleşmelerini kaydetmek üzere updateAdCounterHistogram yöntemini çağırabilir. Bir yöntem, kazanan reklamın eventType öğesinde 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çim sürecinin kazanımı olarak sayılıp sayılmadığını tanımlar.
  • adSelectionId: selectAds çağrıları tarafından döndürülen AdSelectionOutcome nesnesindeki kimlik değerleri.

updateAdCounterHistogram çağrısı, CustomAudience tarafından getirilen yeniden pazarlama reklamlarının veya selectAds için AdSelectionConfig parametresine eklenen içeriğe dayalı reklamların parçası olarak tanımlanan anahtar grubuna ait histogramı günceller.

1. adımdaki reklamın id değeri 9999 olan bir AdSelection kazananı olduğunu varsayarsanız updateAdCounterHistogram(FrequencyCapFilters.AD_EVENT_TYPE_VIEW, adSelectionId: 999) çağrısı şu üç birincil anahtara ait sayaçları 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 içeriğe dayalı reklamlardan veya özel kitlelerden alıcı alanından alınır.

Android için Protected Audience, selectAds API çağrısı tarafından döndürülen reklamlar için FrequencyCapFilters.AD_EVENT_TYPE_WIN etkinlik türüyle ilgili olarak yukarıda belirtilen tüm sayaçları otomatik olarak artırır. Bu, işlevsel olarak Chrome'un Korunan Kitle uygulamasında generateBid içindeki browser_signals öğesine prev_wins bağımsız değişkeninin eklenmesine eşdeğerdir.

3. Adım: Sıklık sınırı filtrelemeyi filtrelerle uygulayın

Optimum performans için sıklık sınırı filtreleme işlevi AdServices dahilinde yürütülür. Korunan Kitle, AdsData nesnesindeki filtreler alanını okuyarak mesajın filtrelenmesi gerekip gerekmediğini anlar. Filtre listesi, frequency_cap bölümünde belirtilmiştir. event_type ve interval_in_seconds anahtarının değerleri, filtreleme ve Korunan Kitle için kullanılan etkinliklerin histogramını almak için kullanılır.

Özel bir kitle tarafından sağlanan yeniden pazarlama reklamları ve AdSelectionConfig nesnesinin bir parçası olarak içeriğe dayalı reklamlar için filtreleme bilgileri belirtilebilir.

Sıklık sınırı filtreleri olan içeriğe dayalı reklamlar için reklamlar, AdSelectionConfig nesnesindeki reklamlar alanı kullanılarak geçirilir. Reklamlar filtrelenir ve selectAds çağrısının sonucu, en yüksek teklife sahip reklam döndürülür.

Sıklık sınırı filtreleri olan yeniden pazarlama reklamlarında reklamlar, alıcı tarafından sağlanan generateBid() JavaScript işlevi çağrılmadan önce filtrelenir.

Aşağıdaki örnekte sıklık sınırı filtrelemeli bir ileti 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çim süreci tamamlandıktan sonra, selectAds çağrısı için sayısal bir tanımlayıcı olan renderUri ve adSelectionId öğelerini içeren bir AdSelectionOutcome nesnesi döndürür. Bu kimlik, şu anda etkinlik düzeyinde raporlamayı destekleyen reportImpression API'yi çağırmak için kullanılabilir. Beta 1'de bu yöntem, yeniden pazarlama reklamları için raporlamayı destekler ve sonraki bir sürümde içeriğe dayalı reklamlarla ilgili raporlamayı destekleyecek şekilde genişletilecektir. İçeriğe dayalı reklamlarda, alıcının, yukarıdaki örnekte gösterildiği gibi reklam yapısında reportingJS adlı fazladan bir alan kullanarak reportWin işlevinin bir reportImpression çağrısı sırasında nereden alınabileceğini belirtmesi gerekir.

Reklam adaylarını seçmeyle ilgili en iyi uygulamalar

Korunan Kitle, sıklık sınırının uygulanmasını sunucudan cihaza taşır. Kazanan teklifler Özel Korumalı Alan ile raporlansa da geliştiriciler bir reklamın neden gösterilmediğini bilemezler. Reklamlar, kaybedilen bir teklif veya sıklık sınırı nedeniyle gösterilmeyebilir. Belirli reklamların kazanmamasının nedenleri tam olarak görülemez. Bu nedenle teklif sistemleri, reklamların en iyi şekilde sunulmasını sağlamak için ek çalışmalara ihtiyaç duyar. Bu en iyi uygulamalar, Protected Audience ile en iyi reklam sunumunun sağlanmasına yardımcı olur.

Yeterli sayıda yeniden pazarlama reklamı gönderin

Yeniden pazarlama reklamları kullanıcı başına optimize edilemez. Bir kullanıcı özel bir kitleden ç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. Dolayısıyla, yeniden pazarlama reklamlarının yayınlanmaya devam etmesini sağlamak için yeterli sayıda reklam envanterinin sıklık sınırından geçmesi gerekir. Bu değerin, joinCustomAudience görüşmesi sırasında ve özel kitle günlük güncellemesi sırasında belirtilebilecek reklam boyutu sınırlamalarıyla dengelenmesi gerekir. Alıcılar, teklif verme aşamasında gecikmede bir artış olabileceğini dikkate almalıdır. Bu sorunların etkisini en aza indirmek için sıklık sınırı filtreleme, generateBid çağrısından önce gerçekleştirilir.

Bağlamsal sayaçları sunucuda tutun

Sunucu tarafı tahmin sayesinde, geliştirici, sıklık sınırının ne zaman etkin olabileceğine dair kabaca tahminler elde edebilir. 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 birlikte gönderilmesi ya da tamamen kaldırılması gerektiğini gösterebilir.

İçeriğe dayalı yanıtta birden çok reklam adayı gönderme

Korunan Kitle açık artırmasından önce içeriğe dayalı bir yanıtla birden fazla reklam adayı göndermeniz gerekir. Bu, birkaç reklam filtrelendiğinde diğer reklamların gösterilmeye devam etmesini sağlar. Reklam adaylarına öncelik verilebilir ve böylece bazı reklamlar yedek olarak sağlanır.

Yürütme zaman sınırlamalı olduğundan, reklam adaylarının açık artırmayı kazanma ve filtrelenmeme olasılıklarına göre seçilmelidir.

Sınırlamalar

Korunan Kitle sıklık sınırının bilinen sınırlamaları şunlardır:

  1. Korunan Kitle sıklık sınırı, diğer cihazlarda ve diğer profillerde paylaşılan sayaçlar olmadan cihaz kullanıcı profili düzeyinde çalışır. Diğer cihazlardan gösterilen reklam artışları gerekirse manuel olarak dahil edilmelidir.
  2. Cihaz sayaçları cihazda saklanır ve cihaza erişilir. Sunucu tarafı sayaçlarının ayrı olarak yönetilmesi gerekir.
  3. Sıklık sınırı ve ilgili reklam filtrelemesi bir cihazda işlendiğinden, reklam teknolojisi platformlarının bu işlemler üzerinde doğrudan kontrolü yoktur. Reklam teknolojisi platformları, cihazın sıklık sınırı eşiğini atlamak için farklı filtrelere sahip birden fazla aday reklam gönderebilir.
  4. Kaydedilen sıklığa dayalı teklif ayarlamaları desteklenmez. generateBid işlevleri, sıklık sayaçlarını görüntüleyemez.