İlişkilendirme Raporları için toplama anahtarlarını anlama

Toplama anahtarlarının ne olduğu, Attribution Reporting API'de nasıl kullanıldığı ve hedefleri anahtarlara nasıl çevirebileceğiniz.

Çeşitli ürün kategorileri için birden fazla konumda kampanyalar yayınlayan bir reklam teknolojisi şirketi olarak, reklamverenlerin aşağıdaki soruları yanıtlamasına yardımcı olmak istiyorsunuz:

1. Her coğrafi bölgedeki kampanyalarımın her biri, her ürün kategorisinden kaç satın alma işlemi oluşturdu?
2. Her coğrafi bölgedeki kampanyalarımın her bir ürün kategorisi için ne kadar gelir elde ettiğini nasıl öğrenebilirim?

Birçok reklam teknolojisi şirketi, reklamverenleri çeşitli dönüşüm türlerini yapılandırmaya teşvik etse de satın alma gibi en önemli dönüşümlere odaklanmak, özet sonuçlarının bu önemli etkinlikler için ayrıntılı ve doğru olduğunu doğrulamanın iyi bir yoludur.

Bunu yapmak için veriler toplanmadan önce hangi soruları yanıtlamak istediğinizi düşünmeniz gerekir.

Boyutlar, anahtarlar ve değerler

Bu soruları yanıtlamak için boyutlara, anahtarlara ve değerlere göz atalım.

Boyutlar

Kampanyalarınızın nasıl gelir elde ettiğini anlamak için burada açıklandığı gibi aşağıdaki boyutları izlemeniz gerekir:

• Reklam kampanyası kimliği: Belirli kampanyanın tanımlayıcısı.
• Coğrafya kimliği: Reklamın yayınlandığı coğrafi bölge.
• Ürün kategorisi: Ürünün, sizin tanımladığınız türü.

Kampanya kimliği ve Coğrafya kimliği boyutları reklam yayınlandığında (reklam yayınlama zamanı) bilinirken ürün kategorisi, kullanıcı bir dönüşümü tamamladığında (dönüşüm zamanı) bir tetikleme etkinliğinden öğrenilir.

Bu örnekte izlemek istediğiniz boyutlar aşağıdaki resimde gösterilmiştir:

Toplama anahtarları (gruplar) nedir?

Terimler toplama anahtarı ve paketi aynı şeyi ifade eder. Toplama anahtarı, raporları yapılandırmak için kullanılan tarayıcı API'lerinde kullanılır. Bucket terimi, toplanabilir ve özet raporlarda ve toplama hizmeti API'lerinde kullanılır.

Toplama anahtarı (kısaca anahtar), izlenen boyutların değerlerini temsil eden bir veri parçasıdır. Veriler daha sonra her toplama anahtarı boyunca toplanır.

Örneğin, Ürün kategorisi, Coğrafya kimliği ve Kampanya kimliği boyutlarını izlediğinizi varsayalım.

Coğrafya kimliği 7'de bulunan bir kullanıcı, kampanya kimliği 12 için bir reklam gördüğünde ve daha sonra ürün kategorisi 25'te bir ürün satın alarak dönüşüm gerçekleştirdiğinde aşağıdaki resimde gösterilene benzer bir toplama anahtarı ayarlayabilirsiniz:

Daha sonra, bir toplama anahtarının uygulamada tam olarak bu şekilde görünmediğini göreceksiniz ancak şimdilik anahtarda yer alan bilgilere odaklanalım.

Toplanabilir değerler nedir?

Belirttiğimiz boyutlarla ilgili sorularınızı yanıtlamak için bilmeniz gerekenler:

• Satın alma sayısı (satın alma sayısı). Toplandıktan ve özet raporda kullanıma sunulduktan sonra bu, toplam satın alma sayısı (özet değeri) olur.
• Her satın alma işleminin geliri (satın alma değeri). Toplandıktan ve özet raporda kullanıma sunulduktan sonra bu, toplam gelir (özet değeri) olur.

Bunların her biri (bir dönüşüm için satın alma sayısı ve bir dönüşüm için satın alma değeri) toplanabilir bir değerdir. Toplanabilir değerleri, ölçüm hedeflerinizin değerleri olarak düşünebilirsiniz.

Coğrafya kimliği 7'de bulunan bir kullanıcı, kampanya kimliği 12'nin reklamını gördüğünde ve daha sonra 120 ABD doları tutarında (para biriminizin ABD doları olduğu varsayılır) ürün kategorisi 25'ten bir ürün satın alarak dönüşüm gerçekleştirdiğinde aşağıdaki gibi bir toplama anahtarı ve toplanabilir değerler ayarlayabilirsiniz:

Toplanabilir değerler, özet raporlardaki özet değerleri şeklinde toplu analizler oluşturmak için birçok kullanıcı arasında anahtar başına toplanır.

Toplanabilir değerler, ölçüm hedefleriniz için toplu analizler oluşturmak üzere toplanır.

Bu şemada şifre çözme işleminin atlandığını ve gürültü uygulanmamış basitleştirilmiş bir örneğin gösterildiğini unutmayın. Bir sonraki bölümde, bu örneği gürültüyle özetleyeceğiz.

Anahtarlardan ve değerlerden raporlara

Şimdi de toplanabilir anahtarlar ve değerlerin raporlarla ilişkisini ele alalım.

Toplanabilir raporlar

Bir kullanıcı bir reklamı tıkladığında veya görüntülediğinde ve daha sonra dönüşüm gerçekleştirdiğinde tarayıcıya bir {toplama anahtarı, toplanabilir değer} çiftini saklaması talimatını verirsiniz.

Örneğimizde, bir kullanıcı bir reklamı tıkladığında veya görüntülediğinde ve daha sonra dönüşüm gerçekleştirdiğinde tarayıcıya iki katkı oluşturması (ölçüm hedefi başına bir katkı) talimatını veriyorsunuz.

Daha sonra, {toplama anahtarı, toplanabilir değer} toplanabilir raporunun tam olarak bu şekilde görünmediğini göreceksiniz. Ancak şimdilik raporda yer alan bilgilere odaklanalım.

Tarayıcıya iki katkı oluşturmasını söylediğinizde tarayıcı, dönüşümü önceki bir görüntüleme veya tıklama ile eşleştirebiliyorsa toplanabilir bir rapor oluşturur.

Toplanabilir bir raporda şunlar bulunur:

• Yapılandırdığınız katkılar.
• Tıklama veya görüntüleme etkinliği ile dönüşüm etkinliği hakkındaki meta veriler: dönüşümün gerçekleştiği site vb. Toplanabilir bir rapordaki tüm alanları görün.

Toplanabilir raporlar JSON biçimlidir ve diğer şeylerin yanı sıra nihai özet rapor için veri girişi olarak kullanılacak bir yük alanı içerir.

Yük, her biri bir {toplama anahtarı, toplanabilir değer} çifti olan katkıların listesini içerir:

• bucket: Bayt dizisi olarak kodlanmış toplama anahtarı.
• value: Bu ölçüm hedefi için toplanabilir değer, bayt dizisi olarak kodlanmış.

Aşağıda bununla ilgili bir örnek verilmiştir:

{
  "data": [
    {
      "bucket": "111001001",
      "value": "11111010000",
    }
  ],
  "operation": "histogram"
}

Uygulamada, toplanabilir raporlar, grupların ve değerlerin önceki örnektekinden farklı görünmesini sağlayacak şekilde kodlanır (ör. bir grup \u0000\u0000\x80\u0000 gibi görünebilir). Hem grup hem de değer, bayt dizeleridir.

Özet raporlar

Toplanabilir raporlar, birçok tarayıcı ve cihazda (kullanıcı) aşağıdaki şekilde toplanır:

• Bir reklam teknolojisi, belirli bir anahtar grubu ve birçok farklı tarayıcıdan (kullanıcı) gelen belirli bir toplanabilir rapor grubu için özet raporlar ister.
• Toplanabilir raporların şifresi toplama hizmeti tarafından çözülür.
• Her anahtar için, toplanabilir raporlardaki toplanabilir değerler toplanır.
• Özet değerine gürültü eklenir.

Sonuç, bir dizi {toplama anahtarı, özet değeri} çifti içeren bir özet rapordur.

Özet rapor, anahtar/değer çiftlerinden oluşan bir JSON sözlüğü stili küme içerir. Her çift şunları içerir:

• bucket: Bayt dizisi olarak kodlanmış toplama anahtarı.
• value: Belirli bir ölçüm hedefi için ondalık olarak özet değerdir. Kullanılabilir tüm toplanabilir raporlardan toplanır ve ek bir gürültü düzeyi içerir.

Örnek:

[
  {"bucket": "111001001", "value": "2558500"},
  {"bucket": "111101001", "value": "3256211"},
  {...}
]

Uygulamada, özet raporlar, grupların ve değerlerin örnekte belirtilenden farklı görünmesini sağlayacak şekilde kodlanır (ör. bir grup \u0000\u0000\x80\u0000 gibi görünebilir). Hem grup hem de değer, bayt dizeleridir.

Uygulamada toplama anahtarları

Toplama anahtarları (gruplar), genellikle iki adımda olmak üzere bir reklam teknolojisi şirketi tarafından tanımlanır: reklam tıklandığında veya görüntülendiğinde ve kullanıcı dönüşüm gerçekleştirdiğinde.

Anahtar yapısı

Anahtara kodlanmış boyutlar grubunu belirtmek için anahtar yapısı terimini kullanacağız.

Örneğin, Kampanya Kimliği × Coğrafi Kimlik × Ürün kategorisi önemli bir yapıdır.

Anahtar türleri

Toplanabilir değerler, belirli bir anahtar için birden fazla kullanıcı/tarayıcı arasında toplanır. Ancak toplanabilir değerlerin, satın alma değeri veya satın alma sayısı gibi farklı ölçüm hedeflerini izleyebildiğini gördük. Toplama hizmetinin, aynı türdeki toplanabilir değerleri toplayacağını doğrulamak istiyorsunuz.

Bunu yapmak için her anahtarda, özet değerinin neyi temsil ettiğini (bu anahtarın atıfta bulunduğu ölçüm hedefi) belirten bir veri parçası kodlayın. Bunu yapmanın bir yolu, anahtarınız için ölçüm hedefi türünü temsil eden ek bir boyut oluşturmaktır.

Önceki örneğimizden yola çıkarak bu ölçüm hedefi türünün iki farklı olası değeri vardır:

• Satın alma sayısı, ilk ölçüm hedefi türüdür.
• İkinci ölçüm hedefi türü satın alma değeridir.

n ölçüm hedefiniz varsa ölçüm hedefi türünde n farklı değer türü olur.

Bir anahtarın boyutlarını metrik olarak düşünebilirsiniz. Örneğin, "kampanya başına, coğrafi bölge başına belirli bir ürünün satın alınma sayısı".

Anahtar boyutu, boyut boyutu

Maksimum anahtar boyutu, tam anahtarı oluşturmak için ikili sistemdeki sıfır ve bir sayısını ifade eden bit cinsinden tanımlanır. API, 128 bit anahtar uzunluğuna izin verir.

Bu boyut, çok ayrıntılı anahtarlara olanak tanır ancak daha ayrıntılı anahtarların daha fazla gürültülü değere yol açma olasılığı daha yüksektir. Gürültü hakkında daha fazla bilgiyi Gürültüyü anlama başlıklı makalede bulabilirsiniz.

Daha önce belirtildiği gibi boyutlar, toplama anahtarına kodlanır. Her boyutun belirli bir kardinalitesi vardır. Bu, boyutun alabileceği farklı değerlerin sayısıdır. Her boyut, kardinalitesine bağlı olarak belirli sayıda bit ile temsil edilmelidir. n bit ile 2ⁿ farklı seçenek ifade edilebilir.

Örneğin, dünyada yaklaşık 200 ülke olduğundan Ülke boyutunun kardinalitesi 200 olabilir. Bu boyutun kodlanması için kaç bit gerekir?

7 bit yalnızca 2⁷ = 128 farklı seçeneği saklar. Bu da gerekli olan 200'den daha azdır.

8 bit, 2⁸ = 256 farklı seçeneği saklar. Bu, gerekli olan 200'den fazla olduğu için bu boyutu kodlamak için n=8 bit kullanabilirsiniz.

Anahtar kodlama

Tarayıcıda anahtar ayarladığınızda anahtarlar on altılı biçimde kodlanmalıdır. Özet raporlarda anahtarlar ikili biçimde görünür (ve gruplar olarak adlandırılır).

Tam anahtar için iki anahtar parçası ayarlama

Aşağıdaki boyutları izlemek için bir anahtar kullandığınızı varsayalım:

• Kampanya Kimliği
• Coğrafya kimliği
• Ürün kategorisi

Kampanya kimliği ve coğrafya kimliği boyutları, reklam sunulduğunda (reklam sunma zamanı) bilinirken ürün kategorisi, kullanıcı bir dönüşümü tamamladığında (dönüşüm zamanı) bir tetikleme etkinliğinden öğrenilir.

Pratikte bu, iki adımda anahtar ayarlayacağınız anlamına gelir:

1. Anahtarın bir bölümünü (Kampanya Kimliği × Coğrafya Kimliği) tıklama veya görüntüleme sırasında ayarlarsınız.
2. Anahtarın ikinci bölümü olan ürün kategorisini dönüşüm sırasında ayarlarsınız.

Anahtarların bu farklı bölümlerine anahtar parçaları denir.

Bir anahtar, anahtar parçalarının OR (v) işlemiyle hesaplanır.

Örnek:

• Kaynak tarafı anahtar parçası = 0x159
• Tetikleyici tarafı anahtar parçası = 0x400
• Anahtar = 0x159 v 0x400 = 0x559

Önemli parçaları birleştirme

Özenle yerleştirilmiş 64 bitlik dolgular veya ofsetler (on altı sıfır) kullanılarak 128 bite genişletilmiş iki 64 bitlik anahtar parçasıyla, anahtar parçalarının OR işlemine tabi tutulması, bunları birleştirmeye eşdeğerdir. Bu da akıl yürütmeyi ve doğrulamayı kolaylaştırır:

• Kaynak tarafı anahtar parçası = 0xa7e297e7c8c8d0540000000000000000
• Tetikleyici tarafı anahtar parçası = 0x0000000000000000674fbe308a597271
• Anahtar = 0xa7e297e7c8c8d0540000000000000000 v 0x0000000000000000674fbe308a597271 = 0xa7e297e7c8c8d054674fbe308a597271

Reklam tıklaması veya görüntüleme başına birden fazla anahtar

Uygulamada, ilişkilendirme kaynağı etkinliği (reklam tıklaması veya görüntüleme) başına birden fazla anahtar ayarlayabilirsiniz. Örneğin, şunları ayarlayabilirsiniz:

• Coğrafya kimliği × kampanya kimliğini izleyen bir anahtar.
• Reklam öğesi türü × kampanya kimliğini izleyen başka bir anahtar.

Başka bir örnek için B Stratejisi'ne göz atın.

Boyutları anahtarlara kodlama

Özet rapor isterken belirli bir toplama anahtarı grubu için özet rapor isteyerek toplama hizmetine hangi metriklere erişmek istediğinizi bildirmeniz gerekir.

Özet raporlar, ham {anahtar, özet değeri} çiftlerini içerir ve anahtarla ilgili ek bilgi içermez. Bunun anlamı:

• Kullanıcı bir reklamı görüntülediğinde veya tıkladığında ve daha sonra dönüşüm gerçekleştirdiğinde anahtarları ayarlarken, anahtarları temsil ettikleri boyutların değerlerine göre güvenilir bir şekilde ayarlamanız gerekir.
• Özet raporlarını istemek istediğiniz anahtarları tanımlarken, kullanıcının bir reklamı görüntülediği veya tıkladığı ve dönüşüm gerçekleştirdiği sırada ayarlanan anahtarlarla aynı anahtarları, toplu verilerini görmek istediğiniz boyutların değerlerine göre anında güvenilir bir şekilde oluşturmanız veya bunlara erişmeniz gerekir.

Anahtar yapı eşlemelerini kullanarak boyutları kodlama

Boyutları anahtarlara kodlamak için anahtarlarınızı tanımlarken (reklam yayınlama zamanından önce) önceden bir anahtar yapısı haritası oluşturup bu haritayı koruyabilirsiniz.

Anahtar yapısı haritası, boyutlarınızın her birini ve anahtardaki konumlarını gösterir.

Uygulamada, anahtar yapısı haritaları oluşturmak ve sürdürmek, kod çözücü mantığını uygulamak ve sürdürmek anlamına gelir. Bunu yapmanızı gerektirmeyen bir yöntem arıyorsanız bunun yerine karma tabanlı bir yaklaşım kullanmayı düşünebilirsiniz.

Aşağıda bununla ilgili bir örnek verilmiştir:

Belirli kampanyalar, coğrafi bölgeler ve ürünler için hem satın alma işlemlerini hem de satın alma değerlerini izlemeyi planladığınızı varsayalım.

Ürün kategorisi, coğrafya kimliği ve kampanya kimliği, anahtarlarınızda boyut olmalıdır. Ayrıca, satın alma sayısı ve satın alma değeri olmak üzere iki farklı ölçüm hedefini izlemek istediğiniz için anahtarınıza anahtar türünü takip eden bir boyut eklemeniz gerekir. Bu sayede, özet raporlarda {anahtar, toplanabilir değer} çiftleri alındığında toplanabilir değerin gerçekte neyi temsil ettiğini tanımlayabilirsiniz.

Bu ölçüm hedefleriyle anahtarınız aşağıdaki boyutlara sahiptir:

• Ürün kategorisi
• Ölçüm hedefi türü
• Coğrafya kimliği
• Kampanya Kimliği

Şimdi her boyuta bakarak kullanım alanınız için aşağıdakileri izlemeniz gerektiğini varsayalım:

• 29 farklı ürün kategorisi.
• 8 farklı coğrafi bölge: Kuzey Amerika, Orta Amerika, Güney Amerika, Avrupa, Afrika, Asya, Karayipler ve Okyanusya.
• 16 farklı kampanya.

Anahtarınızdaki her boyutu kodlamak için gereken bit sayısı şöyledir:

• Ürün kategorisi: 5 bit (2⁵ = 32 > 29).
• Ölçüm hedefi türü: 1 bit. Ölçüm hedefi, satın alma sayısı veya satın alma değeridir. Bu da iki farklı olasılık olduğu anlamına gelir. Bu nedenle, bunu depolamak için bir bit yeterlidir.

• Coğrafya kimliği: 3 bit (2³ = 8). Ayrıca, her ikili değerin hangi coğrafi bölgeyi temsil ettiğini bilmek için Coğrafya Kimliği'nin boyut haritasını da tanımlarsınız. Coğrafya kimliği boyutunuzun boyut haritası aşağıdaki gibi görünebilir:

  Anahtardaki ikili değer	Coğrafya
  000	Kuzey Amerika
  001	Orta Amerika
  010	Güney Amerika
  011	Avrupa
  100	Afrika
  101	Asya
  110	Karayip
  111	Okyanusya

• Kampanya kimliği: 4 bit (2⁴ = 16)

Bu yapıya uyan anahtarlar 13 bit uzunluğunda olur (5 + 1 + 3 + 4).

Bu örnekte, bu anahtarların anahtar yapısı haritası şu şekilde görünür:

Anahtardaki boyutların sırasını siz belirlersiniz.

Boyutların nasıl bir anahtar yapısı oluşturduğunu göstermek için ikili gösterim kullanacağız. Bu nedenle, kampanya kimliği (ilk bitler) en sağda, ürün kategorisi (son bitler) ise en solda yer alır.

Her boyutta en önemli bit (en büyük sayısal değeri taşıyan bit) en soldaki bittir. En az anlamlı bit (en küçük sayısal değeri taşıyan bit), en sağdaki bittir.

Bir anahtarı çözmek için anahtar yapısı haritasını nasıl kullanacağınızı görelim.

0b1100100111100'ü rastgele bir örnek anahtar olarak ele alalım ve bu anahtarın, önceki resimdeki anahtar yapısı haritasına uyduğunu bildiğinizi varsayalım.

Anahtar yapısı haritasına göre bu anahtarın kodu şu şekilde çözülür:

`11001 0 011 1100`

Bu nedenle, 0b1100100111100 anahtarı, Avrupa'da başlatılan 12 kimlikli kampanyada 25 numaralı ürün kategorisinin satın alma sayısını temsil eder.

Karma işlevi kullanarak boyutları kodlama

Anahtar yapısı haritası kullanmak yerine, anahtarları tutarlı ve güvenilir bir şekilde dinamik olarak oluşturmak için karma oluşturma işlevini kullanabilirsiniz.

İşleyiş şekli:

1. Bir karma oluşturma algoritması seçin.
2. Reklam yayınlama sırasında, izlemek istediğiniz tüm boyutları ve bunların değerlerini içeren bir dize oluşturun. Kaynak tarafı anahtar parçasını oluşturmak için bu dizeyi karma oluşturma işlemine tabi tutun ve tetikleyici tarafı anahtar parçasıyla uyumlu hale getirmek ve OR hakkında akıl yürütmeyi kolaylaştırmak için 64 bitlik bir sıfır soneki eklemeyi düşünün.
   • Kaynak tarafındaki anahtar parçası
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
   • COUNT işaretinin, anahtar yapısı eşleme yaklaşımında measurementGoalType=0 ile aynı şeyi kodladığını unutmayın. COUNT biraz daha yalın ve açık.
3. Dönüşüm zamanında, izlemek istediğiniz tüm boyutları ve değerlerini içeren bir dize oluşturun. Tetikleyici tarafında bir anahtar parçası oluşturmak için bu dizeyi karma oluşturma işlemine tabi tutun ve 64 bitlik bir sıfır öneki ekleyin:
   • Tetikleyici tarafı anahtar parçası = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. Tarayıcı, anahtar oluşturmak için bu anahtar parçalarını OR'lar.
   • 128 bit toplama anahtarı
     = <64-bit hex source-side key piece hash><64-bit hex source-side key piece hash>
5. Daha sonra, bu anahtar için özet raporu istemeye hazır olduğunuzda anında oluşturun:
   • İlgilendiğiniz boyutlara göre, daha önce yaptığınız gibi kaynak tarafı ve tetikleyici tarafı anahtar parçası oluşturun.
     • Kaynak tarafındaki anahtar parçası
       = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
     • Tetikleyici tarafı anahtar parçası
       = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
     • tetikleyici tarafı anahtar parçası = toHex(hash("productCategory=25"))
   • Tarayıcı gibi, tarayıcının daha önce oluşturduğu anahtarla aynı anahtarı oluşturmak için bu anahtar parçalarını OR'layın.
     • 128 bit toplama anahtarı
       = <64-bit source-side key piece hash><64-bit source-side key piece hash>

Bu karma tabanlı yaklaşımı kullanıyorsanız birkaç pratik ipucu:

• Boyutları her zaman aynı sırada kullanın. Bu sayede karmalarınızın güvenilir bir şekilde yeniden oluşturulması sağlanır. ("COUNT, CampaignID=12, GeoID=7", "COUNT, GeoID=7, CampaignID=12" ile aynı karma oluşturmaz). Bunu yapmanın basit bir yolu, boyutları alfanümerik olarak sıralamaktır. Örnekte yapacağımız işlem budur. Tek fark, COUNT veya VALUE'ü her zaman boyuttaki ilk öğe olarak belirlememizdir. Bu, okunabilirliği artırmak için yapılan bir tercihtir. Çünkü COUNT veya VALUE, kavramsal olarak diğer tüm boyutlardan biraz farklı bilgiler kodlar.
• Anahtarlarda kullandığınız boyut grubunu takip edin. Hiç kullanmadığınız bir boyut grubuna göre anahtar oluşturmaktan kaçınmak istiyorsunuz.
• Uygun bir karma işlevi kullanılıyorsa karma çakışmaları nadir görülür ancak daha önce kullanılan karma değerlere karşı kontrol yapmak (toplama hizmetinden elde edilen sonuçları yorumlamak için depolanması gerekir) eski anahtarlarla çakışan yeni anahtarların eklenmesini önleyebilir.

Karma tabanlı anahtarların pratikte nasıl kullanılacağını tıklama veya görüntüleme başına bir dönüşüm örneğinde görebilirsiniz.

Uygulamada toplanabilir değerler

Reklam teknolojisi şirketi, kullanıcı dönüşüm gerçekleştirdiğinde toplanabilir değerler ayarlar.

Kullanıcı gizliliğini korumak için her kullanıcının katkılarına bir üst sınır uygulanır. Tek bir kaynakla (reklam tıklaması veya görüntüleme) ilişkili tüm toplanabilir değerler arasında hiçbir değer belirli bir katkı sınırından yüksek olamaz.

Bu sınırdan CONTRIBUTION_BUDGET olarak bahsedeceğiz. Açıklayıcı belgede bu sınıra L1 bütçesi adı verilir ancak bu sınır, CONTRIBUTION_BUDGET ile aynıdır.

Katkı bütçesiyle ilgili ayrıntılı bilgi için Özet raporlar için katkı bütçesi başlıklı makaleyi inceleyin.

Örnek: Tıklama veya görüntüleme başına bir dönüşüm

Bu örnekte, aşağıdaki soruları yanıtlamak istediğinizi varsayalım:

• Hangi ürün kategorileri her bölgede en değerli?
• Hangi kampanya stratejileri her bölgede en etkilidir?

Ayrıca, kullanım alanınız için haftalık analizlere ihtiyacınız olduğunu varsayalım.

Ayrıca aşağıdakileri de izlemeniz gerekir:

• 16 farklı kampanya.
• 8 farklı coğrafi bölge: Kuzey Amerika, Orta Amerika, Güney Amerika, Avrupa, Afrika, Asya, Karayipler ve Okyanusya.
• 29 farklı ürün kategorisi.

Neleri ölçmeliyim?

Birçok reklam teknolojisi şirketi, reklamverenleri çeşitli dönüşüm türlerini yapılandırmaya teşvik etse de satın alma işlemleri gibi en önemli dönüşümlere odaklanmak, bu önemli dönüşüm etkinlikleri için toplu sonuçların ayrıntılı ve doğru olduğunu doğrulamanın iyi bir yoludur. Gerçekten de ne kadar çok metrik ölçerseniz metrik başına katkı bütçeniz o kadar küçük olur ve dolayısıyla her değerin gürültülü olma olasılığı artar. Bu nedenle, neyi ölçeceğinizi dikkatlice seçmeniz gerekir.

Bu örnekte, tıklama veya görüntüleme başına yalnızca bir dönüşümü (satın alma) ölçen kampanya ayarlarına odaklanacağız.

Satın alma sayısı ve satın alma değeri ölçülmeye devam eder. Ayrıca toplam satın alma değeri ve coğrafi dökümler gibi çeşitli önemli toplu istatistiklere erişebilirsiniz. Bu, katkı bütçeniz için basit bir ölçeklendirme yöntemi onaylarken gürültüyü etkili bir şekilde yönetir.

Para birimleri

Farklı bölgelerde kampanya yayınlamak, para birimlerinin dikkate alınması gerektiği anlamına gelir. Şunları yapabilirsiniz:

• Para birimini toplama anahtarlarında özel bir boyut haline getirin.
• Alternatif olarak, para birimini bir kampanya kimliğinden çıkarabilir ve tüm para birimlerini referans para birimlerine dönüştürebilirsiniz.

Bu örnekte, para birimini kampanya kimliğinden çıkarabileceğinizi varsayacağız. Bu işlev, kullanıcının yerel para birimindeki herhangi bir satın alma değerini, sizin seçtiğiniz bir referans para birimine dönüştürmenize olanak tanır. Bu dönüşümü, kullanıcı bir öğe satın aldığında anında da gerçekleştirebilirsiniz.

Bu teknikle, toplanabilir tüm değerler aynı referans para birimindedir ve bu nedenle, toplam toplanmış satın alma değeri (özet satın alma değeri) oluşturmak için toplanabilir.

Hedefleri anahtarlara çevirme

Ölçüm hedefleriniz ve metriklerinizle ilgili olarak temel stratejiniz için çeşitli seçenekleriniz vardır. Bu stratejilerden ikisine odaklanalım:

• A Stratejisi: Bir ayrıntılı anahtar yapısı.
• B stratejisi: İki kaba anahtar yapısı.

A stratejisi: Tek derin ağaç (tek ayrıntılı anahtar yapısı)

A stratejisinde, ihtiyacınız olan tüm boyutları içeren ayrıntılı bir anahtar yapısı kullanırsınız:

Tüm anahtarlarınız bu yapıyı kullanır.

İki ölçüm hedefini desteklemek için bu anahtar yapıyı iki anahtar türüne bölüyorsunuz.

• Anahtar türü 0: Ölçüm hedefi türü = 0. Bu türü satın alma sayısı olarak tanımlamaya karar verirsiniz.
• 1. anahtar türü: Ölçüm hedefi türü = 1. Bu türü satın alma değeri olarak tanımlamaya karar verirsiniz.

Özet raporlar aşağıdaki gibi görünür:

A stratejisini "tek derinlikli ağaç" stratejisi olarak düşünebilirsiniz:

• Özet raporlarındaki her özet değeri, izlediğiniz tüm boyutlarla ilişkilendirilir.
• Bu özet değerlerini, bu boyutların her biriyle birlikte toplayabilirsiniz. Böylece bu toplamalar, sahip olduğunuz boyutların sayısı kadar derin olabilir.

A stratejisiyle sorularınızı aşağıdaki gibi yanıtlarsınız:

A stratejisiyle bu üçüncü soruyu da doğrudan yanıtlayabilirsiniz:

"Her coğrafi bölgedeki kampanyalarımın her biri, her ürün için ne kadar gelir elde etti?"

Özet değerleri gürültülü olsa da her kampanya arasında ölçülen değerlerdeki farklılıkların yalnızca gürültüden kaynaklanmadığını belirleyebilirsiniz. Bu işlemi nasıl yapacağınızı Gürültüyü anlama başlıklı makalede öğrenebilirsiniz.

B stratejisi: İki sığ ağaç (iki kaba anahtar yapısı)

B stratejisinde, ihtiyacınız olan boyutların bir alt kümesini içeren iki kaba anahtar yapısı kullanırsınız:

Bu temel yapıların her birini iki ölçüm hedefini desteklemek için iki temel türe ayırıyorsunuz.

• Ölçüm hedefi türü = 0. Bu türü satın alma sayısı olarak tanımlamaya karar veriyorsunuz.
• Ölçüm hedefi türü = 1. Bu türü satın alma değeri olarak tanımlamaya karar verirsiniz.

Sonuç olarak dört anahtar türü elde edersiniz:

• Temel tür I-0: Temel yapı I, satın alma sayısı.
• Anahtar türü I-1: Anahtar yapısı I, satın alma değeri.
• Anahtar türü II-0: Anahtar yapısı II, satın alma sayısı.
• II-1 anahtar türü: II. anahtar yapısı, satın alma değeri.

Özet raporlar aşağıdaki gibi görünür:

B stratejisini "iki sığ ağaç" stratejisi olarak düşünebilirsiniz:

• Özet raporlardaki özet değerleri, iki küçük boyut grubundan biriyle eşlenir.
• Bu özet değerleri, bu kümelerdeki boyutların her biriyle birlikte toplayabilirsiniz. Bu, daha az boyut toplandığı için bu toplamaların A seçeneğindeki kadar ayrıntılı olmadığı anlamına gelir.

B stratejisinde sorularınızı aşağıdaki gibi yanıtlarsınız:

Karar: A Stratejisi

A stratejisi daha basittir. Tüm veriler aynı anahtar yapısını izler. Bu da yalnızca bir anahtar yapısını korumanız gerektiği anlamına gelir.

Ancak A stratejisinde, bazı sorularınızı yanıtlamak için özet raporlarda aldığınız özet değerlerini toplamanız gerekir. Bu özet değerlerinin her biri gürültülüdür. Bu verileri topladığınızda gürültüyü de toplamış olursunuz.

Özet raporlarında gösterilen özet değerlerinin zaten ihtiyacınız olan bilgileri sağladığı B stratejisinde durum böyle değildir. Bu nedenle, B stratejisinin A stratejisine kıyasla gürültüden daha az etkilenmesi beklenir.

Hangi stratejiyi kullanacağınıza nasıl karar vermelisiniz? Mevcut reklamverenler veya kampanyalar için dönüşüm hacminin A stratejisine mi yoksa B stratejisine mi daha uygun olduğunu belirlemek üzere geçmiş verilerden yararlanabilirsiniz. Ancak yeni reklamverenler veya kampanyalar için şunları yapabilirsiniz:

• Ayrıntılı anahtarlarla bir aylık veri toplayın (A Stratejisi). Veri toplama süresini uzattığınız için özet değerleri daha yüksek, gürültü ise nispeten daha düşük olacaktır.
• Haftalık dönüşüm sayısını ve satın alma değerini makul bir doğrulukla değerlendirin.

Bu örnekte, haftalık satın alma sayısı ve satın alma değerinin, A stratejisinin kullanım alanınız için kabul edilebilir olduğunu düşündüğünüz bir gürültü yüzdesine yol açacak kadar yüksek olduğunu varsayalım.

A stratejisi daha basit olduğu ve karar verme yeteneğinizi etkilemeyen bir gürültü etkisine yol açtığı için A stratejisini kullanmaya karar veriyorsunuz.

Bir karma oluşturma algoritması seçin

Anahtarlarınızı oluşturmak için karma tabanlı bir yaklaşım benimsemeye karar verirsiniz. Bunu yapmak için bu yaklaşımı destekleyecek bir karma oluşturma algoritması seçmeniz gerekir.

SHA-256'yı seçtiğinizi varsayalım. MD5 gibi daha basit ve daha az güvenli bir algoritma da kullanabilirsiniz.

Tarayıcıda: Anahtarları ve değerleri ayarlama

Anahtar yapısına ve karma oluşturma algoritmasına karar verdiğinize göre, kullanıcılar reklamları tıkladığında veya görüntülediğinde ve ardından dönüşüm gerçekleştirdiğinde anahtarları ve değerleri kaydetmeye hazırsınız.

Ardından, anahtarları ve değerleri tarayıcıya kaydetmek için ayarlayacağınız başlıklara genel bir bakış sunulmaktadır:

Kaynak tarafında anahtar parçaları ayarlama

Kullanıcı bir reklamı tıkladığında veya görüntülediğinde, toplama anahtarlarını Attribution-Reporting-Register-Aggregatable-Source üstbilgisinde ayarlayın. Bu aşamada, her anahtar için yalnızca reklam yayınlama sırasında bilinen anahtarın bölümünü veya anahtar parçasını ayarlayabilirsiniz.

Önemli parçaları oluşturalım:

Şimdi önemli parçaları ayarlayalım:

// Upon receiving the request from the publisher site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Source",
  JSON.stringify([
    {
      "id": "key_purchaseCount",
      "key_piece": "0x3cf867903fbb73ec0000000000000000"
    },
    {
      "id": "key_purchaseValue",
      "key_piece": "0x245265f432f16e730000000000000000"
    }
  ])
);

Anahtar kimliklerin nihai raporlarda görünmeyeceğini unutmayın. Yalnızca tarayıcıda anahtarlar ayarlanırken kullanılır. Böylece kaynak tarafı ve tetikleyici tarafı anahtar parçaları birbirleriyle eşlenebilir ve tam bir anahtar oluşturmak için birleştirilebilir.

İsteğe bağlı: Etkinlik düzeyindeki raporlar

Etkinlik düzeyindeki raporları toplu hale getirilebilir raporlarla birlikte kullanmanız gerekiyorsa belirli bir kaynak için etkinlik düzeyindeki verilerin (kaynak etkinlik kimliği ve tetikleyici verileri) ve toplama anahtarının eşleştirilebildiğini doğrulayın.

Örneğin, hangi reklam türlerinin en fazla sayıda satın alma işlemine yol açtığıyla ilgili modeller çalıştırmak için etkinlik düzeyindeki raporları kullanmayı planlıyorsanız her iki raporu da kullanabilirsiniz.

Kullanıcı dönüşüm gerçekleştirir

Kullanıcı dönüşüm gerçekleştirdiğinde genellikle reklam teknolojisi sunucusuna bir piksel isteği gönderilir. Bu talep alındıktan sonra:

• Anahtarı tamamlamak için dönüşüm tarafındaki (tetikleyici tarafındaki) anahtar parçalarını ayarlayın. Bu önemli parçaları üstbilgi Attribution-Reporting-Register-Aggregatable-Trigger-Data kullanarak ayarlarsınız.
• Başlığı kullanarak bu dönüşüm için toplanabilir değeri ayarlayın Attribution-Reporting-Register-Aggregatable-Values.

Anahtarı tamamlamak için tetikleyici tarafı anahtar parçalarını ayarlayın.

Önemli parçaları oluşturalım:

Şimdi önemli parçaları ayarlayalım:

// Upon receiving the pixel request from the advertiser site
res.set(
  "Attribution-Reporting-Register-Aggregatable-Trigger-Data",
  JSON.stringify([
    // Each dictionary independently adds pieces to multiple source keys
    {
      "key_piece": "0x0000000000000000f9e491fe37e55a0c",
      "source_keys": ["key_purchaseCount", "key_purchaseValue"]
    },
  ])
);

source_keys bölümünde birden fazla anahtar kimliği listeleyerek aynı anahtar parçasını birden fazla anahtara nasıl eklediğinize dikkat edin. Anahtar parçası her iki anahtara da eklenir.

Toplanabilir değerleri ayarlama

Toplanabilir değerleri ayarlamadan önce gürültüyü azaltmak için bu değerleri ölçeklendirmeniz gerekir.

Ürün türü 25 için 52 TL tutarında bir satın alma işlemi yapıldığını varsayalım.

Bunları doğrudan toplanabilir değerler olarak ayarlamazsınız:

• key_purchaseCount: 1 dönüşüm
• key_purchaseValue: 52 ABD doları

Bunun yerine, bu toplanabilir değerleri kaydetmeden önce gürültüyü en aza indirmek için bu değerleri ölçeklendirmeniz gerekir.

Katkı bütçenizi harcayabileceğiniz iki hedefiniz var. Bu nedenle, katkı bütçesini ikiye bölmeye karar verebilirsiniz.

Bu durumda, her hedefe en fazla CONTRIBUTION_BUDGET/2 (=65.536/2=32.768) ayrılır.

Sitenin tüm kullanıcılarının satın alma geçmişine göre tek bir kullanıcının yapabileceği maksimum satın alma değerinin 1.500 TL olduğunu varsayalım. Bu tutarın üzerinde harcama yapan çok az kullanıcı gibi aykırı değerler olabilir ancak bu aykırı değerleri yoksayabilirsiniz.

Satın alma değeri için ölçeklendirme faktörünüz şu olmalıdır:

((CONTRIBUTION_BUDGET/2) / 1.500) = 32.768/1.500 = 21,8 ≈ 22

Reklam tıklaması veya görüntüleme (kaynak etkinliği) başına en fazla bir satın alma işlemini izlemeye karar verdiğiniz için satın alma sayısı ölçeklendirme faktörünüz 32.768/1 = 32.768'dir.

Artık şu değerleri ayarlayabilirsiniz:

• key_purchaseCount: 1 × 32.768 = 32.768
• key_purchaseValue: 52 × 22 = 1.144

Pratikte, özel üstbilgiyi Attribution-Reporting-Register-Aggregatable-Values kullanarak bunları aşağıdaki gibi ayarlarsınız:

// Instruct the browser to schedule-send a report
res.set(
  "Attribution-Reporting-Register-Aggregatable-Values",
  JSON.stringify({
    "key_purchaseCount": 32768,
    "key_purchaseValue": 1144,
  })
);

Toplanabilir rapor oluşturulur.

Tarayıcı, dönüşümü önceki bir görüntüleme veya tıklamayla eşleştirir ve rapor meta verilerinin yanında şifrelenmiş yükü içeren bir toplu rapor oluşturur.

Aşağıda, toplu raporun yükünde bulunabilecek verilerin bir örneği verilmiştir. Bu veriler, düz metin olarak okunabilir olsaydı:

[
  {
    key: 0x3cf867903fbb73ecf9e491fe37e55a0c, // = source-side key piece OR conversion-side key piece for the key key_purchaseCount
    value: 32768 // the scaled value for 1 conversion, in the context of [CONTRIBUTION_BUDGET/2]
  },
  {
    key: 0x245265f432f16e73f9e491fe37e55a0c, // source-side key piece OR conversion-side key piece for the key key_purchaseValue
    value: 1144 // the scaled value for $52, in the context of [CONTRIBUTION_BUDGET/2]
  },
]

Burada, tek bir toplanabilir raporda iki ayrı katkı görebilirsiniz.

Özet rapor isteğinde bulunma

• Toplu olarak toplanabilir raporlar. Toplu işleme bölümündeki önerileri uygulayın.
• Verilerini görmek istediğiniz anahtarları oluşturun. Örneğin, Kampanya kimliği 12 × Coğrafya kimliği 7 × Ürün kategorisi 25 için COUNT (toplam satın alma sayısı) ve VALUE (toplam satın alma değeri) ile ilgili özet verileri görmek için:
  • Tarayıcıda ayarlarken yaptığınız gibi kaynak tarafı anahtar parçasını oluşturun.
  • Tetikleyici tarafı anahtar parçasını, tarayıcıda ayarlarken yaptığınız gibi oluşturun.

• Bu anahtarlar için toplama hizmetine özet verileri isteğinde bulunun.

Özet raporu işleme

Sonuç olarak, aşağıdaki gibi görünebilecek bir özet rapor alırsınız:

[
  {"bucket": "00111100111110000110011110010000001111111011101101110011111011001111100111100100100100011111111000110111111001010101101000001100",
    "value": "2558500"},
  {"bucket": "00100100010100100110010111110100001100101111000101101110011100111111100111100100100100011111111000110111111001010101101000001100",
    "value": "687060"},
  …
]

İlk paket, ikili sistemdeki COUNT anahtarıdır. İkinci paket, ikili sistemdeki VALUE anahtarıdır. Anahtarların heterojen (COUNT ve VALUE) olmasına rağmen aynı raporda yer aldığını unutmayın.

Değerleri küçültme

• 2.558.500, bu anahtar için satın alma sayısını ifade eder ve daha önce hesapladığınız ölçeklendirme faktörüyle ölçeklendirilir. Satın alma sayısı için ölçeklendirme faktörü 32.768'di. 2.558.500'ü hedefin katkı bütçesine bölün: 2.558.500/32.768 = 156,15 satın alma.
• 687.060 → 687.060/22 = 31.230 ABD doları toplam satın alma değeri.

Bu nedenle, özet raporlar aşağıdaki analizleri sağlar:

- Within the reporting time period, campaign #12
  run in Europe drove about 156 purchases (± noise)
  for the product category #25
  ```

  ```text
- Within the reporting time period, campaign #12
  run in Europe drove $31,230 of purchases (± noise)
  for the product category #25.