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

bookmark_border Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Toplama anahtarları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 kampanya 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 kategorisinde kaç satın alma işlemi sağladı?
2. Her coğrafi bölgedeki kampanyalarımın her biri, her ü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, özet sonuçların bu önemli etkinlikler için ayrıntılı ve doğru olmasını sağlamanı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 burada açıklandığı şekilde nasıl gelir elde ettiğini anlamak için aşağıdaki boyutları izlemeniz gerekir:

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

Kampanya kimliği ve Coğrafi kimlik 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 tetikleyici etkinlikten bilinir.

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

Toplama anahtarları (bucket'lar) 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. Grup terimi, birleştirilebilir ve özet raporlarda ve toplama hizmeti API'lerinde kullanılır.

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

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

7. Coğrafi Kimlik'te bulunan bir kullanıcı, 12. Kampanya Kimliği'ne ait bir reklamı görür ve daha sonra 25. Ürün kategorisindeki bir ürünü satın alarak dönüşüm gerçekleştirdiğinde aşağıdaki resimdekine benzer bir toplama anahtarı ayarlayabilirsiniz:

Bir toplama anahtarının uygulamada tam olarak böyle görünmediğini daha sonra göreceksiniz. Şimdilik anahtarda yer alan bilgilere odaklanalım.

Toplanabilir değerler nedir?

Belirtmiş olduğumuz boyutlarla ilgili sorularınızı yanıtlamak için şunları bilmeniz gerekir:

• Satın alma sayısı (purchase_count). Toplanıp özet raporda kullanıma sunulduktan sonra bu değer, toplam satın alma sayısı (özet değer) olur.
• Her satın alma işleminin geliri (satın alma değeri). Toplanıp özet raporda kullanıma sunulduktan sonra bu değer toplam gelir (özet değer) 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.

7 numaralı coğrafi kimliğe sahip bir kullanıcı, 12 numaralı kampanyanın reklamını görür ve daha sonra 120 ABD doları karşılığında 25 numaralı ürün kategorisindeki bir ürünü satın alarak dönüşüm gerçekleştirir (para biriminiz ABD doları ise). Aşağıdaki gibi bir toplama anahtarı ve toplanabilir değerler belirleyebilirsiniz:

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.

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

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

Anahtar ve değerlerden raporlara

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

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 {aggregation key, aggregatable value} çifti depolamasını talimat 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ı (ölçüm hedefi başına bir tane) oluşturması talimatı verilir.

{aggregation key, aggregatable value} toplu raporunun tam olarak böyle görünmediğini daha sonra göreceksiniz. Ancak şimdilik raporda yer alan bilgilere odaklanalım.

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

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ı. Toplanabilir bir rapordaki tüm alanları görme

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

Yük, her biri {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 bir bayt dizesi olarak kodlanmış, toplanabilir değer.

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 örnekten farklı görünmesini sağlayacak şekilde kodlanır (yani bir grup \u0000\u0000\x80\u0000 gibi görünebilir). Hem grup hem de değer bayt dizesidir.

Özet raporlar

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

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

Sonuç, bir {toplama anahtarı, özet değer} çiftleri grubu içeren bir özet rapordur.

Özet rapor, JSON sözlük stilinde bir anahtar/değer çifti grubu içerir. Her çift şunları içerir:

• bucket: Bayt dizesi olarak kodlanmış toplama anahtarı.
• value: Belirli bir ölçüm hedefi için ondalık olarak gösterilen özet değer. Mevcut tüm birleştirilebilir raporlardan toplanır ve ek bir gürültü düzeyi eklenir.

Ö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). Hem paket hem de değer bayt dizesidir.

Uygulamada toplama anahtarları

Toplama anahtarları (gruplar), bir reklam teknolojisi şirketi tarafından genellikle iki adımda 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ı

Bir anahtara kodlanmış boyut kümesini 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 fazla kullanıcı/tarayıcıda belirli bir anahtar için toplanır. Ancak toplu olarak toplanabilen değerlerin, satın alma değeri veya satın alma sayısı gibi farklı ölçüm hedeflerini izleyebileceğini gördük. Toplama hizmetinin, aynı türde toplanabilir değerleri topladığından emin olmak istiyorsunuz.

Bunu yapmak için her anahtarda, özet değerin neyi temsil ettiğini (bu anahtarın atıfta bulunduğu ölçüm hedefini) 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.

Daha önceki örneğimizi kullanarak bu ölçüm hedefi türünün iki farklı olası değeri olduğunu görebiliriz:

• 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ünde n farklı değer türü olur.

Bir anahtarın boyutlarını metrik olarak düşünebilirsiniz. Örneğin, "coğrafya başına 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 ikili sistemdeki sıfır ve bir sayılarının toplamıdır. API, 128 bit anahtar uzunluğuna izin verir.

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

Daha önce de belirtildiği gibi boyutlar toplama anahtarında kodlanır. Her boyutun belirli bir kardinalitesi (boyutun alabileceği farklı değer sayısı) vardır. Her boyutun, kardinalitesine bağlı olarak belirli sayıda bit ile temsil edilmesi gerekir. n bit ile 2ⁿ farklı seçenek ifade edilebilir.

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

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

8 bit, 2⁸ = 256 farklı seçenek depolar. Bu, gereken 200'den fazladır. Bu nedenle, bu boyutu kodlamak için n=8 bit kullanabilirsiniz.

Anahtar kodlama

Tarayıcıda ayarladığınız anahtarlar on altılık olarak kodlanmalıdır. Anahtarlar, özet raporlarda ikili biçimde görünür (ve adlandırılmış 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ğrafi kimlik
• Ürün kategorisi

Kampanya kimliği ve Coğrafi Bölge 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 tetikleyici etkinlikten bilinir.

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

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

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

Anahtar, anahtar parçalarının VEYA (v) işleminin alınmasıyla hesaplanır.

Örnek:

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

Önemli parçaları uyumlu hale getirme

Dikkatlice yerleştirilmiş 64 bitlik dolgu/ofsetler (on altı sıfır) kullanılarak 128 bit'e genişletilen iki 64 bitlik anahtar parçasının VEYA işlemi, anahtar parçalarını birleştirmeye eşdeğerdir. Bu işlem, mantık yürütmek ve doğrulamak açısından daha kolaydır:

• Kaynak taraflı anahtar parçası = 0xa7e297e7c8c8d0540000000000000000
• Tetikleyici tarafındaki 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ğrafi kimlik × kampanya kimliğini izleyen bir anahtar.
• Reklam Öğesi Türü × Kampanya Kimliği'ni izleyen başka bir anahtar.

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

Boyutları anahtarlara kodlama

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

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

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

Anahtar yapı haritalarını kullanarak boyutları kodlama

Boyutları anahtarlara kodlamak için anahtarlarınızı tanımladıktan sonra (reklam sunma zamanından önce) önceden bir anahtar yapısı haritası oluşturabilir ve bu haritayı koruyabilirsiniz.

Anahtar yapısı haritası, boyutlarınızın her birini ve anahtardaki konumlarını temsil eder.

Uygulamada, anahtar yapı haritaları oluşturmak ve sürdürmek, kod çözücü mantığını uygulamanız ve sürdürmeniz gerektiği anlamına gelir. Bunu yapmanızı gerektirmeyen bir yöntem arıyorsanız bunun yerine karma oluşturmaya dayalı 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ğrafi kimlik ve kampanya kimliğinin, anahtarlarınızda boyut olması gerekir. 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. Bu sayede, özet raporlarda {anahtar, toplanabilir değer} çiftlerini aldıktan sonra toplanabilir değerin aslında 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ğrafi kimlik
• Kampanya Kimliği

Şimdi her boyuta bakarak kullanım alanınızda 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ızda her boyutu kodlamak için gereken bit sayısı şunlardır:

• Ü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 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ğrafi Kimlik için bir boyut haritası da tanımlarsınız. Coğrafi kimlik boyutunuz için boyut haritanız 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ı size bağlıdır.

Boyutların bir anahtar yapısını nasıl 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 boyuttaki 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ın kodunu çözmek için anahtar yapısı haritasını nasıl kullanacağınızı görelim.

İsteğe bağlı bir örnek anahtar olarak 0b1100100111100 değerini alalım ve bu anahtarın önceki görseldeki anahtar yapısı haritasını izlediğini bilmenin bir yolunuz olduğunu varsayalım.

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

`11001 0 011 1100`

Dolayısıyla 0b1100100111100 anahtarı, Avrupa'da başlatılan 12 numaralı kampanya kimliği için 25 numaralı ürün kategorisinin satın alma sayısını temsil eder.

Karma oluşturma 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şlevi kullanabilirsiniz.

İşleyiş şu şekildedir:

1. Karma oluşturma algoritması seçin.
2. Reklam sunma zamanında, izlemek istediğiniz tüm boyutları ve 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 hizalamak ve VEYA'nın daha kolay anlaşılmasını sağlamak için 64 bitlik bir sıfır soneki ekleyebilirsiniz.
   • Kaynak taraflı anahtar parçası
     = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
   • Anahtar yapı haritası yaklaşımında COUNT, measurementGoalType=0 ile aynı şeyi kodlar. COUNT biraz daha basit ve daha açıktır.
3. Dönüşüm sırası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 sıfır ön ek ekleyin:
   • Tetikleyici tarafındaki 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ı VEYA işlemiyle birleştirir.
   • 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 rapor isteğinde bulunmaya hazır olduğunuzda raporu 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 taraflı anahtar parçası
       = <64-bit hex hash("COUNT, campaignID=12, geoID=7"))><64-bit 00000000…>
     • Tetikleyici tarafındaki anahtar parçası
       = <64-bit 00000000…><64-bit hex hash("productCategory=25")>
     • tetikleyici taraflı anahtar parçası = toHex(hash("productCategory=25"))
   • Tıpkı tarayıcı gibi, tarayıcı tarafından daha önce oluşturulan anahtarı oluşturmak için bu anahtar parçalarını VEYA kullanın.
     • 128 bit toplama anahtarı
       = <64-bit source-side key piece hash><64-bit source-side key piece hash>

Karma oluşturmaya dayalı bu yaklaşımı kullanıyorsanız birkaç pratik ipucu:

• Boyutları her zaman aynı sırayla kullanın. Bu sayede karma oluşturma işlemleriniz güvenilir bir şekilde yeniden oluşturulabilir. ("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 de bunu yapacağız. Tek fark, boyuttaki ilk öğeyi her zaman COUNT veya VALUE olarak belirlememizdir. COUNT veya VALUE, diğer tüm boyutlardan kavramsal olarak biraz farklı bilgiler kodladığından bu, okunabilirlik için yapılan bir seçimdir.
• 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 oluşturma işlevi kullanılırsa karma oluşturma çakışmaları nadir görülür. Ancak daha önce kullanılan karma oluşturma işlemleriyle (toplama hizmetinden gelen sonuçları yorumlamak için depolanması gerekir) karşılaştırma yaparak eski anahtarlarla çakışan yeni anahtarların kullanılması önlenebilir.

Karma oluşturmaya dayalı anahtarların pratikte nasıl kullanıldığını öğrenmek için tıklama veya görüntüleme başına bir dönüşüm örneğine bakın.

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ılarının üst sınırı vardır. Tek bir kaynakla (reklam tıklaması veya görüntüleme) ilişkili tüm birleştirilebilir değerlerde hiçbir değer belirli bir katkı sınırından yüksek olamaz.

Bu sınıra CONTRIBUTION_BUDGET diyeceğiz. Açıklama bölümünde 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ı bir tartışma 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 hangileri?

Ayrıca, kullanım alanınızda 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, toplu sonuçların bu önemli dönüşüm etkinlikleri için ayrıntılı ve doğru olmasını sağlamanın iyi bir yoludur. Gerçekten de, ne kadar fazla metrik ölçerseniz metrik başına katkı bütçeniz o kadar küçük olur ve dolayısıyla her bir değerin gürültülü olma olasılığı o kadar 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 işlemi) ölçen kampanya kurulumlarına odaklanacağız.

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

Para birimleri ne olacak?

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 çıkarıp tüm para birimlerini bir referans para birimine dönüştürebilirsiniz.

Bu örnekte, para birimini bir kampanya kimliğinden anlayabileceğinizi varsayacağız. Bu sayede, belirli bir satın alma değerini kullanıcının yerel para biriminden seçtiğiniz bir referans para birimine dönüştürebilirsiniz. Bu dönüşümü, kullanıcı bir öğe satın aldığında da anında gerçekleştirebilirsiniz.

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

Hedefleri anahtarlara çevirme

Ölçüm hedefleriniz ve metriklerinizle, temel stratejiniz için çeşitli seçeneklere sahip olursunuz. Bu stratejilerden ikisine odaklanalım:

• A stratejisi: tek bir ayrıntılı anahtar yapısı.
• B stratejisi: iki kaba anahtar yapısı.

A stratejisi: bir derin ağaç (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.

Bu anahtar yapısını, iki ölçüm hedefini desteklemek için iki anahtar türüne bölersiniz.

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

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

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

• Özet raporlardaki her özet değeri, izlediğiniz tüm boyutlarla ilişkilendirilir.
• Bu özet değerleri, bu boyutların her biri ile birlikte toplayabilirsiniz. Böylece bu toplama işlemleri, sahip olduğunuz boyut sayısı kadar derin olabilir.

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

A stratejisiyle, üçü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ğerlerde gürültü olsa da her kampanya arasında ölçülen değerdeki farklılıkların yalnızca gürültüden kaynaklanmadığını belirleyebilirsiniz. Bunu nasıl yapacağınızı Gürültüyü anlama başlıklı makalede bulabilirsiniz.

B Stratejisi: iki sığ ağaç (iki kaba anahtar yapı)

B stratejisinde, her biri 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ırsınız.

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

Dört anahtar türü elde edersiniz:

• Anahtar türü I-0: Anahtar yapısı 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ı.
• Anahtar türü II-1: Anahtar yapısı 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 raporlardaki özet değerler, iki küçük boyut grubundan biriyle eşlenir.
• Bu özet değerleri, bu gruplardaki boyutların her biri ile birlikte toplanabilir. Bu, toplanacak daha az boyut olduğu için bu toplama işlemlerinin A seçeneğinde olduğu kadar derin olmadığı anlamına gelir.

B stratejisinde sorularınızı şu şekilde yanıtlarsınız:

Karar: A Stratejisi

A stratejisi daha basittir; tüm veriler aynı anahtar yapısını kullanır. Bu da yalnızca bir anahtar yapısını yönetmeniz gerektiği anlamına gelir.

Ancak A stratejisinde, bazı sorularınızı yanıtlamak için özet raporlarda aldığınız özet değerleri toplamanız gerekir. Bu özet değerlerinin her biri gürültülüdür. Bu verileri toplayarak gürültüyü de toplarsınız.

Özet raporlarda sunulan özet değerlerinin zaten ihtiyacınız olan bilgileri sağladığı B stratejisinde durum böyle değildir. Bu, B stratejisinin, A stratejisine kıyasla gürültüden daha az etkileneceği anlamına gelir.

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

• Ayrıntılı anahtarlarla bir aylık veri toplayın (A Stratejisi). Veri toplama süresini uzattığınızda özet değerler daha yüksek olur ve gürültü nispeten daha düşük olur.
• 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 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.

Karma oluşturma algoritması seçme

Anahtarlarınızı oluşturmak için karma oluşturmaya dayalı bir yaklaşım kullanmaya karar verdiniz. Bunun için bu yaklaşımı destekleyen 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 verdiniz. Artık 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.

Aşağıda, tarayıcıya anahtar ve değer kaydetmek için ayarlayacağınız üstbilgilerin özeti verilmiştir:

Kaynak taraflı anahtar parçalarını ayarlama

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

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

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

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

Toplu hale getirilebilir raporların yanı sıra etkinlik düzeyindeki raporları da 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ğinden emin olun.

Örneğin, hangi reklam türlerinin en fazla satın alma işlemine yol açtığına dair 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 reklam teknolojisi sunucusuna genellikle bir piksel isteği gönderilir. Bu isteği aldıktan sonra:

• Anahtarı tamamlamak için dönüşüm tarafı (tetikleyici tarafı) anahtar parçalarını ayarlayın. Bu anahtar parçalarını Attribution-Reporting-Register-Aggregatable-Trigger-Data başlığı aracılığıyla ayarlarsınız.
• Attribution-Reporting-Register-Aggregatable-Values başlığı aracılığıyla ilgili dönüşüm için toplanabilir değeri ayarlayın.

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

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

Şimdi temel 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 içinde birden fazla anahtar kimliği listeleyerek aynı anahtar parçasını birden fazla anahtara nasıl eklediğinizi unutmayın. Anahtar parçası her iki anahtara da eklenir.

Toplanabilir değerler ayarlama

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

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

Aşağıdakileri 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 ölçeklendirmeniz gerekir.

Katkı bütçenizi harcamak için iki hedefiniz olduğundan katkı bütçesini ikiye bölme kararı alabilirsiniz.

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ı için maksimum satın alma değerinin 1.500 TL olduğunu varsayalım. Örneğin, bu tutarın üzerinde harcama yapan çok az sayıda 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 şekilde olmalıdır:

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

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

Artık aşağıdaki değerleri ayarlayabilirsiniz:

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

Pratikte, özel başlığı 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ün yer aldığı toplu bir rapor oluşturur.

Aşağıda, açık metin olarak okunabilir durumda olsaydı birleştirilebilir raporun yükü içinde bulunabilecek verilere örnek verilmiştir:

[
  {
    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 birleştirilebilir raporda iki ayrı katkıyı görebilirsiniz.

Özet rapor isteğinde bulunma

• Toplu olarak toplanabilir raporlar. Gruplandırma bölümündeki önerileri uygulayın.
• Verilerini görmek istediğiniz anahtarları oluşturun. Örneğin, 12 numaralı kampanya kimliği × 7 numaralı coğrafi kimlik × 25 numaralı ürün kategorisi için COUNT (toplam satın alma sayısı) ve VALUE (toplam satın alma değeri) ile ilgili özet verileri görmek istiyorsanız:
  • Tarayıcıda ayarlarken yaptığınız gibi kaynak taraflı anahtar parçasını oluşturun.
  • Tarayıcıda ayarlarken yaptığınız gibi tetikleyici tarafındaki anahtar parçasını oluşturun.

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

Özet raporunu 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, VALUE anahtarının ikili halidir. Anahtarlar heterojen olsa da (COUNT ve VALUE) aynı raporda yer aldıklarını unutmayın.

Değerleri küçültme

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

Sonuç olarak, özet raporlar size aşağıdaki analizleri sunar:

- 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.