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

Toplama anahtarının ne olduğu, Attribution Reporting API'de nasıl kullanıldığı ve hedefleri anahtarlara nasıl dönüştürebileceğiniz.

Çeşitli ürün kategorileri için birden fazla yerde 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ımdan her biri, her ürün kategorisinden kaç satın alma işlemi sağladı?
2. Her bir coğrafi bölgedeki kampanyalarımdan her bir ürün kategorisi için ne kadar gelir elde etti?

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 olaylarla ilgili özet sonuçların ayrıntılı ve doğru olmasını sağlamak için iyi bir yöntemdir.

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.

Not: Bu belgede açıklanan toplama anahtarları, Attribuion Reporting API'ye özeldir.

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 sunulduğu coğrafi bölge.
• Ürün kategorisi: Tanımladığınız şekliyle ürünün türü.

Kampanya Kimliği ve Coğrafi Konum Kimliği boyutları reklam sunulduğunda (reklam sunma süresi) bilinse de kullanıcı bir dönüşümü tamamladığında Ürün kategorisi, tetikleyici etkinliğinden (dönüşüm zamanı) bilinir.

Not: Bu belgedeki diyagram için boyutları aşağıdaki gibi görüntüleyeceğiz:

• Yeşil arka plan üzerinde reklam sunma zamanında bilinen boyutlar.
• Dönüşüm zamanında bilinen, sarı arka plan üzerinde ve altı çizili olan boyutlar.

Bu örnek için izlemek istediğiniz boyutlar aşağıdaki resimde gösterildiği gibidir:

İzlenecek boyutlar

Toplama anahtarı (paket) nedir?

Toplama anahtarı ve paket terimleri aynı anlama gelir. Toplama anahtarı, raporları yapılandırmak için kullanılan tarayıcı API'lerinde kullanılır. Paket terimi, toplanabilir ve özet raporlarda ve toplama hizmeti API'lerinde kullanılır.

Toplama anahtarı, izlenen boyutların değerlerini temsil eden bir veri parçasıdır. Veriler daha sonra her toplama anahtarında 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'nin reklamını 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 resimdekine benzeyen bir toplama anahtarı ayarlayabilirsiniz:

Daha sonra bir toplama anahtarının pratikte tam olarak böyle görünmediğini göreceksiniz. Şimdi, anahtarda yer alan bilgilere odaklanalım.

Toplanabilir değerler nedir?

Ana hatlarıyla belirttiğimiz boyutlarla ilgili sorularınızı yanıtlamak için şunları bilmeniz gerekiyor:

• Satın alma sayısı (satın alma sayısı). Bu sayı, toplanıp özet raporda kullanılabilir hale getirildikten sonra toplam satın alma sayısı (özet değer) olacaktır.
• Her bir satın alma işleminin geliri (satın alma değeri). Bu sayı toplanıp bir özet raporunda kullanılabilir hâle getirildikten sonra toplam gelir (özet değer) olur.

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

Soru	Toplanabilir değer = Ölçüm hedefi
		Satın alma işlemleri...	Satın alma sayısı
Ne kadar gelir...	Satın alma değeri

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

Toplama anahtarı ve toplanabilir değerler. Toplanabilir değerlerin mavi arka plan üzerinde kalın harflerle gösterildiğini unutmayın.

Toplanabilir değerler, özet raporlarda özet değerler biçiminde toplu analizler oluşturmak için birçok kullanıcıda anahtar başına toplanır.

Toplanabilir değerler toplanarak ölçüm hedefleriniz için toplu analizler oluşturulur.

Bu diyagramda şifre çözmenin yer almadığına ve gürültü uygulanmayan basitleştirilmiş bir örneği temsil ettiğine dikkat edin. Bir sonraki bölümde, bu örneği gürültüyle inceleyeceğiz.

Anahtarlar ve değerlerden raporlara

Şimdi toplanabilir anahtarların ve değerlerin raporlarla ilişkisini inceleyelim.

Birleştirilebilir raporlar

Kullanıcı bir reklamı tıklayıp veya görüntüledikten sonra dönüşüm gerçekleştirdiğinde tarayıcıya bir {toplama anahtarı, aggregatable value} çiftini depolaması için talimat verirsiniz.

Not: Açıklayıcı'da {toplama anahtarı, aggregaable value} çifti, histogram katkısı olarak da adlandırılır: Bu dönüşüm (ve onunla ilişkili boyut ve değerlerin) özet rapora nasıl katkıda bulunduğunu gösterir.

Ö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ıdan iki katkı (ölçüm hedefi başına bir) oluşturması için talimat verirsiniz.

Daha sonra, {toplama anahtarı, aggregatable value} toplanabilir raporun tam olarak böyle olmadığını görürsünüz ancak şimdilik raporda yer alan bilgilere odaklanalım.

Tarayıcıya iki katkı oluşturma talimatı verdiğinizde tarayıcı, toplanabilir bir rapor oluşturur (dönüşümü önceki bir görüntüleme veya tıklamayla eşleştirebiliyorsa).

Toplanabilir raporlar şunları içerir:

• Yapılandırdığınız katkılar.
• Tıklama veya görüntüleme etkinliği ve dönüşüm etkinliğiyle ilgili meta veriler: dönüşümün gerçekleştiği site ve daha fazlası. Birleştirilebilir rapordaki tüm alanları görün.

Toplanabilir raporlar JSON biçimindedir ve diğer özelliklerin yanı sıra nihai özet raporunda 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 bir listesini içerir:

• bucket: Bayt dizesi olarak kodlanmış toplama anahtarı.
• value: Söz konusu ölçüm hedefi için bayt dizesi olarak kodlanmış toplanabilir değer.

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

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

Pratikte, birleştirilebilir raporlar, paketlerin ve değerlerin önceki örnekten farklı görünmesini sağlayacak şekilde kodlanır (yani bir paket \u0000\u0000\x80\u0000 gibi görünebilir). Paket ve değer ise her ikisi de bayt dizesidir.

Özet raporlar

Birleştirilebilir raporlar, birçok tarayıcı ve cihazdan (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 toplu 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ğere gürültü eklenir.

Sonuçta bir grup {toplama anahtarı, özet değeri} çifti içeren bir özet rapor elde edilir.

Özet rapor, JSON sözlük stili anahtar/değer çiftleri kümesi içerir. Her çift aşağıdakileri içerir:

• bucket: Bayt dizesi olarak kodlanmış toplama anahtarı.
• value: Belirli bir ölçüm hedefi için ek bir gürültü düzeyiyle birlikte kullanılabilir tüm toplanabilir raporlardan toplanan, ondalık sayı cinsinden özet değerdir.

Örnek:

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

Pratikte özet raporları, paketlerin ve değerlerin örnekte belirtilenden farklı görünmesini sağlayacak şekilde kodlanır (yani bir paket \u0000\u0000\x80\u0000 gibi görünebilir). Paket ve değer ise birer bayt dizesidir.

Uygulamada toplama anahtarları

Toplama anahtarları (paketler), bir reklam teknolojisi şirketi tarafından genellikle iki adımda tanımlanır: bir reklamın tıklanması veya görüntülenmesi ve kullanıcının dönüşüm gerçekleştirmesi.

Anahtar yapısı

Bir anahtara kodlanmış boyut grubunu belirtmek için anahtar yapısı terimini kullanacağız.

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

Anahtar türleri

Toplanabilir değerler, birden çok kullanıcı/tarayıcıda belirli bir anahtar için 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ğından emin olmak istiyorsunuz.

Bunu yapmak için her bir anahtarın içinde, özet değerin neyi temsil ettiğini (bu anahtarın kastettiği ölçüm hedefini) bildiren 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ğimizi kullanırsak, bu ölçüm hedefi türünün iki farklı olası değeri olur:

• Satın alma sayısı, ilk ölçüm hedefi türüdür.
• Satın alma değeri, ikinci ölçüm hedefi türüdür.

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

Bir anahtarın boyutlarını bir metrik olarak düşünebilirsiniz. Örneğin, "coğrafyaya göre kampanya başına belirli bir ürünün satın alma sayısı".

Anahtar boyutu, boyut boyutu

Maksimum anahtar boyutu, bit cinsinden tanımlanır. Bu, tam anahtarı oluşturmak için kullanılan sıfır ve bir ikili programdaki sıfır sayısıdır. API, 128 bit anahtar uzunluğuna izin verir.

Bu boyut, çok ayrıntılı anahtarlara izin verir ancak daha ayrıntılı anahtarların, daha gürültülü değerlere yol açma olasılığı daha yüksektir. Gürültüyü anlama bölümünde gürültü hakkında daha fazla bilgi edinebilirsiniz.

Daha önce açıklandığı 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. Kardinalitesine bağlı olarak her boyutun belirli bir sayıda bitle temsil edilmesi gerekir. n bit ile 2ⁿ farklı seçenek ifade edilebilir.

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

7 bit yalnızca 2⁷ = 128 farklı seçenek depolar. Bu, gereken 200'den azdır.

8 bit, gerekli olan 200'den fazla olan 2⁸ = 256 farklı seçenek depolar. Dolayısıyla bu boyutu kodlamak için n=8 bit kullanabilirsiniz.

Anahtar kodlama

Tarayıcıda anahtarları ayarladığınızda, bunlar onaltılık olarak kodlanmalıdır. Özet raporlarda anahtarlar ikili programda görünür (ve paketler olarak adlandırılır).

Not: Onaltılık verilerin başında genellikle 0x öneki bulunur. Örneğin, 0x19, onaltılık biçimde 19'dur; bu sayı ondalık olarak 19 değil, 25'tir. İkili sayıların başında genellikle 0b öneki kullanılır. Örneğin, 0b11001 ikilik tabanda 11001'dir. Ondalıkta 11.001 değil, 25'tir.

Tam bir anahtar için iki anahtar parçası ayarlayın

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ğrafi Konum Kimliği boyutları reklam sunulduğunda (reklam sunma süresi) bilinse de kullanıcı bir dönüşümü tamamladığında ürün kategorisi tetikleyici etkinliğinden (dönüşüm zamanı) bilinir.

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

1. Tıklama veya görüntüleme sırasında anahtarın bir parçasını (Kampanya Kimliği × Coğrafi Kimliği) ayarlarsınız.
2. Anahtarın ikinci bölümünü (Ürün kategorisi) dönüşüm zamanında ayarlarsınız.

Anahtarların bu farklı kısımlarına anahtar parçaları denir.

Uyarı: Bu belgede, bit tabanlı-VEYA kullanılarak birleştirildiği halde, temel parçaların bit tabanlı-XOR kullanılarak birleştirildiği yanlış bir şekilde açıklanmaktadır.

Bir anahtar, anahtar parçalarından ÖZELVEYA (^) alınarak hesaplanır.

Örnek:

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

Tuş parçalarını hizalama

Dikkatli bir şekilde yerleştirilmiş 64 bitlik dolgular/ofsetler (on altı sıfır) kullanılarak 128 bite genişletilmiş iki 64 bit anahtar parçasında, XOR YAPMA anahtarı parçaları birleştirmeye eşdeğerdir. Bu şekilde akıl yürütme ve doğrulama daha kolaydır:

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

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

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

• Coğrafi Kimliği × Kampanya Kimliği'ni izleyen bir anahtar.
• Reklam Öğesi Türü × Kampanya Kimliği'ni izleyen bir diğer anahtar.

Başka bir örnek için B Stratejisine bakın.

Boyutları anahtarlarla kodlama

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

Özet raporlar işlenmemiş {anahtar, özet değeri} çiftleri içerir ve anahtar hakkında 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, toplu verilerini görmek istediğiniz boyutların değerlerine bağlı olarak kullanıcı bir reklamı görüntülediğinde veya tıkladığında ve dönüşüm gerçekleştirdiğinde ayarlanan anahtarlarla aynı anahtarları güvenilir bir şekilde oluşturmanız veya bu anahtarlara anında erişmeniz gerekir.

Anahtar yapısı eşlemelerini kullanarak boyutları kodlama

Boyutları anahtarlara kodlamak için anahtarlarınızı tanımladıktan sonra (reklam sunma zamanından önce) bir temel yapı haritası oluşturup bunu önceden yapabilirsiniz.

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

Pratikte, temel yapı eşlemelerini oluşturmak ve sürdürmek için kod çözücü mantığını uygulamanız ve sürdürmeniz gerekir. Bunu yapmanızı gerektirmeyen bir yöntem arıyorsanız bunun yerine karma tabanlı yaklaşımdan yararlanabilirsiniz.

Aşağıda 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ğrafi kimlik ve kampanya kimliği, anahtarlarınızdaki boyutlar olmalıdır. Ayrıca, iki farklı ölçüm hedefini (satın alma sayısı ve satın alma değeri) izlemek istediğiniz için anahtarınıza anahtar türünü izleyen bir boyut eklemeniz gerekir. Böylece, özet raporlarda {key, aggregatable value} çiftlerini aldıktan sonra toplanabilir değerin gerçekte neyi temsil ettiğini tanımlayabilirsiniz.

Bu ölçüm hedeflerinde anahtarınız aşağıdaki boyutlara sahip olur:

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

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

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

Anahtarınızdaki her bir boyutu kodlamak için ihtiyacınız olan bit sayısı aşağıdaki gibidir:

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

• Coğrafi konum kimliği: 3 bit (2³ = 8). Ayrıca her ikili değerin hangi coğrafi bölgeyi temsil ettiğini öğrenmek isterseniz Coğrafya Kimliği için bir boyut haritası tanımlarsınız. Coğrafi Kimlik boyutunuz için boyut haritanız şöyle görünebilir:

  Anahtardaki ikili değer	Konum
  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ıyı takip eden anahtarlar 13 bit uzunluğunda (5 + 1 + 3 + 4) olur.

Bu örnek için, bu anahtarların temel yapısı aşağıdaki gibi olacaktır:

Anahtardaki boyutların sıralaması size bağlıdır.

Boyutların temel bir yapıyı nasıl oluşturduğunu göstermek için ikili gösterimi kullanacağız. Bu yüzden, Kampanya kimliği (ilk bitler) en sağdaki, ürün kategorisi (son parçalar) en soldadır.

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

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

Rastgele bir örnek anahtar olarak 0b1100100111100'ü ele alalım. Bu anahtarın, önceki çizimde yer alan temel yapı haritasını takip ettiğini bildiğiniz bir yöntemi olduğunu varsayalım.

Anahtar yapısı haritasına göre bu anahtarın kodu 11001 0 011 1100 olarak çözülür.

Dolayısıyla 0b1100100111100 anahtarı, Avrupa'da kullanıma sunulan Kampanya Kimliği 12 için Ürün kategorisi 25'in satın alma sayısını temsil eder.

Karma işlevi kullanarak boyutları kodlama

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

İşleyiş şekli:

1. Karma oluşturma algoritması seçin.
2. Reklam sunma 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 dizeye karma oluşturma işlemi uygulayın ve dizeyi tetikleyici tarafı anahtar parçasıyla hizalamak için 64 bitlik bir sonek ekleyin ve XOR'un akıl yürütmesini kolaylaştırın.
   • Kaynak tarafı anahtar parçası
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
   • COUNT işlevinin, temel yapı haritası yaklaşımındaki measurementGoalType=0 ile aynı şeyi kodladığını unutmayın. COUNT biraz daha yalın ve müstehcen.
3. Dönüşüm sırasında, izlemek istediğiniz tüm boyutları ve bunların değerlerini içeren bir dize oluşturun. Tetikleyici tarafı anahtar parçası oluşturmak için bu dizeye karma oluşturma işlemi uygulayın ve 64 bitlik bir ön ek (sıfırlar) ekleyin:
   • Tetikleyici tarafı anahtar parçası = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
4. Tarayıcı, bir anahtar oluşturmak için bu anahtar parçaları XOR belirler.
   • 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 anahtarı anında oluşturun:
   • İlgilendiğiniz boyutlara göre, daha önce yaptığınız gibi bir kaynak tarafı ve tetikleyici tarafı anahtar parçası oluşturun.
     • Kaynak tarafı 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"))
   • Tıpkı tarayıcıda olduğu gibi, tarayıcının daha önce oluşturduğu anahtarı oluşturmak için bu önemli parçaları ÖZELLEŞTİRİN.
     • 128 bit toplama anahtarı
       = <64-bit source-side key piece hash><64-bit source-side key piece hash>

Karma tabanlı yaklaşımı kullanıyorsanız yararlanabileceğiniz bazı ipuçları:

• Her zaman aynı boyut sıralamasını kullanın. Bu sayede karmalarınız güvenilir bir şekilde yeniden oluşturulabilir. ("COUNT, CampaignID=12, GeoID=7", "COUNT, GeoID=7, CampaignID=12" ile aynı karmayı oluşturmaz). Bunu yapmanın basit bir yolu, boyutları alfanümerik olarak sıralamaktır. COUNT veya VALUE her zaman boyuttaki ilk öğe olacak şekilde seçileceğimiz gerçeği, örnekte bunu uygulayacağız. COUNT veya VALUE, kavramsal olarak diğer tüm boyutlardan biraz farklı olan bilgileri kodladığı için bu, okunabilirlik için bir tercihtir.
• Anahtarlarda kullandığınız boyut grubunu takip edin. Daha önce hiç kullanmadığınız bir dizi boyuta göre anahtar oluşturmaktan kaçınmak istiyorsunuz.
• Uygun bir karma işlevi kullanıldığında karma çakışmaları nadir görülür. Ancak daha önce kullanılan karmalarla (toplama hizmetinden alınan sonuçların yorumlanması için saklanması gerekir) kontrol edilmesi, eski anahtarlarla çakışan yeni anahtarlar uygulanmasını önleyebilir.

Tıklama veya görüntüleme başına bir dönüşüm örneğinde karma tabanlı anahtarları pratikte nasıl kullanacağınızı öğrenin.

Uygulamada toplanabilir değerler

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

Kullanıcı gizliliğini korumak için her kullanıcının katkısında bir üst sınır vardır. Tek bir kaynakla (reklam tıklaması veya görüntüleme) ilişkili toplanabilir tüm değerlerde hiçbir değer belirli bir katkı sınırının üzerinde olamaz.

Bu sınır, CONTRIBUTION_BUDGET olarak adlandırılır. Açıklayıcıda, bu sınır L1 bütçesi olarak adlandırılır ancak 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:

• Her bölgede en değerli ürün kategorileri hangileri?
• Her bölgede en etkili kampanya stratejileri hangileridir?

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 takip etmeniz gerekir:

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

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 olmasını sağlamak için iyi bir yöntemdir. Gerçekten de, ne kadar fazla metrik ölçerseniz metrik başına katkı bütçeniz o kadar az olur ve dolayısıyla, her değerin daha karmaşık olma ihtimali artar. Bu nedenle, neyi ölçeceğinizi dikkatli bir şekilde seçmeniz gerekir.

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

Hem satın alma sayısını hem de satın alma değerini ölçmeye devam eder, toplam satın alma değeri ve coğrafi dökümler gibi çeşitli önemli toplu istatistiklere erişebilirsiniz. Bu yöntem, gürültünün makul düzeyde kalmasını sağlar ve katkı bütçeniz için basit bir ölçeklendirme yaklaşımı sunar.

Peki ya para birimleri?

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

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

Bu örnekte, bir kampanya kimliğinden para birimini tahmin edebileceğinizi varsayıyoruz. Bu seçenek, belirli bir satın alma değerini kullanıcının yerel para biriminden seçtiğiniz bir referans para birimine dönüştürmenize olanak tanır. Ayrıca, kullanıcı bir öğe satın aldığında, bu dönüşümü anında gerçekleştirebilirsiniz.

Bu teknikle, tüm toplanabilir değerler aynı referans para biriminde olur ve bu nedenle toplam satın alma değeri (özet satın alma değeri) oluşturmak üzere toplanabilir.

Hedefleri anahtarlara dönüştürün

Ölçüm hedefleriniz ve metrikleriniz sayesinde, temel stratejiniz için bir dizi seçeneğiniz vardır. Bu stratejilerden ikisine odaklanalım:

• A Stratejisi: Tek bir ayrıntılı temel yapısı.
• Strateji B: iki genel anahtar yapısı.

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

A stratejisinde, ihtiyacınız olan tüm boyutları içeren tek bir ayrıntılı 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 temel yapıyı iki ana türe ayırırsınız.

• Satın alma sayısı olarak tanımladığınız anahtar türü 0: ölçüm hedefi türü = 0.
• Satın alma değeri olarak tanımlamaya karar verdiğiniz anahtar türü 1: ölçüm hedefi türü = 1.

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

A stratejisini "derin bir ağaç" stratejisi olarak düşünebilirsiniz:

• Özet raporlarındaki her özet değer, izlediğiniz tüm boyutlarla ilişkilendirilir.
• Bu özet değerleri bu boyutların her biriyle birlikte toplayabilirsiniz. Böylece bu kapsamlı görünümler, sahip olduğunuz boyut sayısı kadar derinlik gösterebilir.

A stratejisi ile sorularınızı şu şekilde yanıtlarsınız:

Soru	Yanıt
Her bölgede en değerli ürün kategorileri hangileri?	Tüm kampanyalar genelinde özet raporlarındaki özet satın alma sayılarını ve değerleri toplayın. Bu, Coğrafi Kimlik × Ürün kategorisi başına satın alma sayısını ve değerini gösterir. Her bölge için farklı ürün kategorilerinin satın alma değerini ve sayısını karşılaştırın.
Her bölgede en etkili kampanya stratejileri hangileridir?	Tüm ürün kategorileri genelinde özet raporlarındaki özet satın alma sayılarını ve değerleri toplayın. Bu, Kampanya Kimliği × Coğrafi Kimlik başına satın alma sayısını ve değerini verir. Her bölge için farklı kampanyaların satın alma değerini ve sayısını karşılaştırın.

A stratejisiyle, şu üçüncü soruyu doğrudan yanıtlayabilirsiniz:

"Her bir coğrafi bölgedeki kampanyalarımdan her biri, her bir ürün için ne kadar gelir sağladı?"

Özet değerleri karışık olsa da her kampanya arasında ölçülen değerdeki farkların ne zaman yalnızca gürültüden kaynaklanmadığını belirleyebilirsiniz. Bu işlemi nasıl yapacağınızı Gürültüyü anlama bölümünden öğrenebilirsiniz.

Strateji B: iki sığ ağaç (iki genel anahtar yapısı)

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

İki ölçüm hedefini desteklemek için bu temel yapıların her birini iki ana türe ayırırsınız.

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

Burada dört tür temel bulunur:

• Anahtar türü I-0: Temel yapı I, satın alma sayısı.
• Anahtar türü I-1: Temel yapı I, satın alma değeri.
• Anahtar türü II-0: Temel yapı II, satın alma sayısı.
• Anahtar türü II-1: Temel yapı II, 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 raporlarındaki özet değerler, iki küçük boyut grubundan biriyle eşlenir.
• Bu özet değerleri, bu gruplardaki boyutların her biriyle birlikte toplayabilirsiniz. Diğer bir deyişle, birleştirilecek daha az boyut olduğundan, bu toplayıcı mülkler A seçeneğindeki kadar derin değildir.

B stratejisi ile sorularınızı şu şekilde yanıtlarsınız:

Soru	Yanıt
Her bölgede en değerli ürün kategorileri hangileri?	Özet raporlardaki özet satın alma sayılarına ve değerlerine doğrudan erişebilirsiniz.
Her bölgede en etkili kampanya stratejileri hangileridir?	Özet raporlardaki özet satın alma sayılarına ve değerlerine doğrudan erişebilirsiniz.

Karar: A Stratejisi

A stratejisi daha basittir. Tüm veriler aynı temel yapıya sahiptir. Bu da, yönetmeniz gereken tek bir temel yapının olduğu anlamına gelir.

Ancak A stratejisi ile bazı sorularınızı yanıtlamak için özet raporlarında aldığınız özet değerleri toplamanız gerekir. Bu özet değerlerin her biri karmaşık değildir. Bu verileri toplayarak gürültüyü de toplamış olursunuz.

Bu durum, özet raporlarında gösterilen özet değerlerinin size ihtiyacınız olan bilgileri sağladığı B stratejisi için geçerli değildir. Bu durumda, B stratejisinin etkisi, A stratejisinden daha az olacaktır.

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

• Ayrıntılı anahtarlarla bir aylık verileri toplayın (Strateji A). Veri toplama süresini uzattığınız için özet değerler 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.

Not: Tasarımlarınızda bir doğruluk kaynağı olarak yalnızca hata ayıklama raporlarından sağlanan rapor sayısına veya verilere güvenmeyin. Gelecekte, hata ayıklama raporlarındaki veriler değişecek ve gürültülü raporlar gerçek raporlarla birlikte oluşturulacaktır. Bu nedenle, bu sinyaller yalnızca uygulama ve test stratejinizi doğrulamak için kullanılmalıdır.

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 bulduğunuz bir gürültü yüzdesine neden olacağı kadar yüksek olduğunu varsayalım.

A stratejisi daha basit olduğu ve karar verme kabiliyetinizi etkilemeyecek bir gürültü etkisine neden olduğu için A stratejisini kullanmaya karar verirsiniz.

Karma oluşturma algoritması seçin

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

SHA-256'yı seçtiğinizi varsayalım. Ayrıca MD5 gibi daha basit, güvenliği düşük bir algoritma da kullanabilirsiniz.

Tarayıcıda: anahtarları ve değerleri ayarlayın

Anahtar yapıya 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ış sunulur:

Kaynak tarafı anahtar parçalarını ayarlama

Uyarı: Bu bölümdeki başlık biçimleri eskidir. Bu bölüm güncellenene kadar güncel talimatlar için Toplanabilir Rapor açıklayıcısını inceleyin.

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

Temel parçaları oluşturalım:

Anahtar kimliği için kaynak tarafı anahtar parçası...	Ayarlamak istediğiniz boyut değerlerini içeren dize	Bu dizenin onaltılık olarak karması, ilk 64 bite kırpılır (64/4 = 16 karakter^1)	ÖZELVEYA işlevini basitleştirmek için eklenen sıfırlarla onaltılık karma. Bu, kaynak tarafındaki anahtar parçadır.
key_purchaseCount	COUNT, CampaignID=12, GeoID=7	0x3cf867903fbb73ec	0x3cf867903fbb73ec0000000000000000
key_purchaseValue	VALUE, CampaignID=12, GeoID=7	0x245265f432f16e73	0x245265f432f16e730000000000000000

¹Her onaltılık basamak, dört biti (ikili basamaklar) temsil eder.

Şimdi temel unsurları belirleyelim:

// 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 kimliklerinin nihai raporlarda görünmeyeceğini unutmayın. Bunlar yalnızca tarayıcıda anahtarlar ayarlanırken kullanılır. Böylece kaynak tarafı ve tetikleyici tarafı anahtar parçaları birbiriyle eşlenebilir ve tam bir anahtarda birleştirilebilir.

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

Birleştirilebilir raporlarla birlikte etkinlik düzeyinde raporları kullanmanız gerekiyorsa belirli bir kaynak için etkinlik düzeyindeki veriler (kaynak etkinlik kimliği ve tetikleyici veriler) ve toplama anahtarının eşleştirilebilmesini sağlar.

Örneğin, en yüksek satın alma sayısını sağlama eğiliminde olan reklam türleriyle ilgili modeller çalıştırmak için etkinlik düzeyinde raporlar kullanmayı planlıyorsanız her iki raporu da kullanabilirsiniz.

Bir kullanıcı dönüşüm gerçekleştirdiğinde

Bir kullanıcı dönüşüm gerçekleştirdiğinde, genellikle reklam teknolojisi sunucusuna bir piksel isteği gönderilir. Bu talebi aldıktan sonra:

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

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

Uyarı: Bu bölümdeki başlık biçimleri eskidir. Bu bölüm güncellenene kadar güncel talimatlar için Toplanabilir Rapor açıklayıcısını inceleyin.

Temel parçaları oluşturalım:

Anahtar kimliği için tetikleyici tarafı anahtar parçası...	Ayarlamak istediğiniz boyut değerlerini içeren dize	Bu dizenin onaltılık olarak karması, ilk 64 bite kırpılır (64/4 = 16 karakter^1)	ÖZELVEYA işlevini simplify için eklenen sıfırlarla onaltılık karma. Bu, kaynak tarafındaki anahtardır.
key_purchaseCount	ProductCategory=25	0x1c7ce88c4904bbe2	0x0000000000000000f9e491fe37e55a0c
key_purchaseValue	(aynı)	(aynı)	(aynı)

¹Her onaltılık basamak, dört biti (ikili basamaklar) temsil eder.

Şimdi temel unsurları belirleyelim:

// 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 içinde birkaç anahtar kimliği listeleyerek aynı anahtar parçasını birkaç anahtara nasıl eklediğinize dikkat edin. Anahtar parçası her iki anahtara da eklenir.

Toplanabilir değerler belirleyin

Toplanabilir değerleri ayarlamadan önce, gürültüyü azaltmak için bunların ölçeğini artırmanız gerekir.

25 numaralı ürün için 52 TL'lik bir satın alma işleminin yapıldığını varsayalım.

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

• key_purchaseCount: 1 dönüşüm
• key_purchaseValue: 52 TL

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

Katkı bütçenizi aşmak için iki hedefiniz olduğundan katkı bütçesini ikiye bölmeye karar verebilirsiniz.

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

Sitenin tüm kullanıcıları arasındaki işlem geçmişine dayalı olarak tek bir kullanıcı için maksimum satın alma değerinin 1.500 ABD doları olduğunu varsayalım. Aykırı değerler olabilir; örneğin, bu toplamın üzerinde harcama yapan çok az sayıda kullanıcı, ancak bu aykırı değerleri göz ardı etmeye karar verebilirsiniz.

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 başına en fazla bir satın alma işlemini (kaynak etkinlik) izlemeye karar verdiğiniz için satın alma sayısındaki ö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 Attribution-Reporting-Register-Aggregatable-Values başlığını 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,
  })
);

Birleştirilebilir rapor oluşturuldu

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

Aşağıda, temiz metin olarak okunabiliyorsa toplanabilir raporun yükü içinde bulunabilecek verilere bir örnek verilmiştir:

[
  {
    key: 0x3cf867903fbb73ecf9e491fe37e55a0c, // = source-side key piece XOR 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 XOR 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 isteme

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

İstemek istediğiniz metrik^1	Kaynak tarafı anahtar parçası	Tetikleyici tarafı anahtar parçası	Toplama hizmeti için istek anahtarı^2
Toplam satın alma sayısı (COUNT)	0x3cf867903fbb73ec 0000000000000000	0x00000000000000 00f9e491fe37e55a0c	0x3cf867903fbb73 ecf9e491fe37e55a0c
Toplam satın alma değeri (VALUE)	0x245265f432f16e73 0000000000000000	0x0000000000000000 f9e491fe37e55a0c	0x245265f432f16e73 f9e491fe37e55a0c

¹İstemek istediğiniz metrik (Kampanya Kimliği 12 × Coğrafi Kimliği 7 × Ürün kategorisi 25 için). ²Toplama hizmetine istek anahtarı = Kaynak tarafı anahtar parçası XVEYA Tetikleyici tarafı anahtar parçası.

• Bu anahtarlar için toplama hizmetine özet veriler isteyin.

Özet raporu yönetme

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

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

İlk paket, ikili programdaki COUNT anahtarıdır. İkinci paket, ikili programdaki VALUE anahtarıdır. Anahtarlar heterojen olsa da (COUNT ve VALUE) aynı raporda yer alır.

Not: Pratikte özet raporları, paketlerin ve değerlerin biraz önce gördüğünüzden farklı görünmesini sağlayacak şekilde kodlanır (yani, bir paket \u0000\u0000\x80\u0000 gibi görünebilir). Paket ve değer ise birer bayt dizesidir. Bir örneği burada bulabilirsiniz.

Değerleri aşağı ölçeklendirme

• 2.558.500, bu anahtar için yapılan satın alma sayısını ifade eder ve önceden hesapladığınız ölçeklendirme faktörüne göre ölçeklendirilir. Satın alma sayısının ö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 TL toplam satın alma değeri.

Sonuç olarak, özet raporları size aşağıdaki bilgileri sağlar:

• Raporlama dönemi içinde, Avrupa'da yayınlanan 12 numaralı kampanya 25 numaralı ürün kategorisi için yaklaşık 156 satın alma (± gürültü) sağladı.
• Raporlama dönemi içinde, Avrupa'da yayınlanan 12 numaralı kampanya,25 numaralı ürün kategorisi için 31.230 ABD doları tutarında satın alma (± gürültü) sağladı.