Toplama anahtarlarının ne olduğu, Attribution Reporting API'de nasıl kullanıldıkları 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:
- Her bir coğrafi bölgedeki kampanyalarım her bir ürün kategorisinden kaç satın alma elde etti?
- Farklı coğrafi bölgelerdeki kampanyalarım 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 etkinlikler için özet sonuçların ayrıntılı ve doğru olmasını sağlamanın iyi bir yoludur.
Bunun için de veri toplanmadan önce hangi soruları cevaplamak istediğinizi düşünmelisiniz.
Boyutlar, anahtarlar ve değerler
Bu soruları yanıtlamak için boyutlara, anahtarlara ve değerlere göz atalım.
Boyutlar
Burada açıklandığı gibi, kampanyalarınızın nasıl gelir sağladığını anlamak için aşağıdaki boyutları izleyebilirsiniz:
- Reklam kampanyası kimliği: Belirli bir kampanyanın tanımlayıcısı.
- Coğrafi kimlik: Reklamın sunulduğu coğrafi bölge.
- Ürün kategorisi: Tanımladığınız ürünün türü.
Reklam sunulduğunda (reklam sunma zamanı) Kampanya Kimliği ve Coğrafi Kimliği boyutları bilinse de, kullanıcı bir dönüşümü tamamladığında (dönüşüm zamanı) Ürün kategorisi bir tetikleyici etkinlikten öğrenilir.
Bu örnek için izlemek istediğiniz boyutlar aşağıdaki resimde gösterildiği gibidir:
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 birleştirilebilir, ö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ıyla birlikte toplanır.
Örneğin, Ürün kategorisi, Coğrafi Konum kimliği ve Kampanya Kimliği boyutlarını izlediğinizi varsayalım.
Coğrafi Kimlik 7'de bulunan bir kullanıcı, Kampanya Kimliği 12 ile ilgili bir reklam görür ve daha sonra Ürün kategorisi 25'te bir ürün satın alarak dönüşüm gerçekleştirirse, aşağıdaki resimde gösterildiği gibi bir toplama anahtarı ayarlayabilirsiniz:
Daha sonra, toplama anahtarının uygulamada tam olarak böyle görünmediğini göreceksiniz. Şimdilik anahtarda yer alan bilgilere odaklanalım.
Toplanabilir değerler nedir?
Ana hatlarıyla belirttiğimiz boyutlarla ilgili sorularınızı yanıtlamak için aşağıdakileri bilmeniz gerekir:
- Satın alma sayısı (satın alma sayısı). Toplanan veriler özet raporunda kullanıma sunulduktan sonra toplam satın alma sayısı (özet değeri) olur.
- Her satın alma işleminden elde edilen gelir (satın alma değeri). Toplandıktan ve özet raporunda kullanıma sunulduktan sonra bu, toplam gelir (özet değer) olacaktır.
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 değerlerdir. Birleştirilebilir değerleri ölçüm hedeflerinizin değerleri olarak düşünebilirsiniz.
| Soru | Toplanabilir değer = Ölçüm hedefi |
|---|---|
| Satın alma işlemi sayısı... | 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 ile ilgili bir reklam görür ve daha sonra Ürün kategorisi 25'te bir ürünü 120 TL'ye satın alarak dönüşüm gerçekleştirirse (para biriminizin ABD doları olduğu varsayılırsa), aşağıdaki gibi bir toplama anahtarı ve toplanabilir değerler ayarlayabilirsiniz:
Toplu analizler oluşturmak için birçok kullanıcı genelinde birleştirilebilir değerler, özet raporlarındaki özet değerler biçiminde toplanır.
Toplanabilir değerler, ölçüm hedeflerinize yönelik toplu analizler oluşturmak için toplanır.
Bu şemada şifre çözme kullanılmadığı ve gürültü uygulanmayan basitleştirilmiş bir örnek gösterildiğine dikkat edin. Bir sonraki bölümde, bu örneği gürültüyle özetleyeceğiz.
Anahtarlar ve değerlerden raporlara
Şimdi toplanabilir anahtarların ve değerlerin raporlarla ilişkisini ele alalım.
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 {aggregation key, aggregatable value} çifti depolama talimatı verirsiniz.
gösterir.Örneğimizde, kullanıcı bir reklamı tıklayıp 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ı için talimat verirsiniz.
Daha sonra {aggregation key, aggregatable value} bir toplanabilir raporun tam olarak böyle görünmediğini 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ı birleştirilebilir bir rapor oluşturur (dönüşümü önceki bir görüntüleme veya tıklamayla eşleştirebiliyorsa).
Toplanabilir bir rapor ş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ı. Tüm alanları toplanabilir bir raporda görün.
Birleştirilebilir raporlar JSON biçimindedir ve diğer özelliklerinin yanı sıra, son özet raporunda veri girişi olarak kullanılacak bir yük alanı içerir.
Yük, her biri bir {aggregation key, aggregatable value} çifti olmak üzere katkıların bir listesini içerir:
- paket: bayt dizesi olarak kodlanan toplama anahtarı.
- value: Söz konusu ölçüm hedefinin bayt dizesi olarak kodlanan toplanabilir değeri.
Aşağıda bir örnek verilmiştir:
{
"data": [
{
"bucket": "111001001",
"value": "11111010000",
}
],
"operation": "histogram"
}
Pratikte, toplanabilir raporlar, paketlerin ve değerlerin önceki örnekten farklı görünmesine neden olacak şekilde kodlanır (yani bir paket \u0000\u0000\x80\u0000 şeklinde görünebilir). Paket ve değer bayt dizeleridir.
Özet raporlar
Toplanabilir raporlar, birçok tarayıcı ve cihaz (kullanıcılar) genelinde şu şekilde toplanır:
- Bir reklam teknolojisi, belirli bir anahtar grubu ve birçok farklı tarayıcıdan (kullanıcılar) gelen bir dizi toplanabilir rapor için özet raporlar ister.
- Birleştirilebilir raporların şifresi toplama hizmeti tarafından çözülür.
- Her anahtar için, birleştirilebilir raporlardaki toplanabilir değerler toplanır.
- Özet değerine gürültü eklenir.
Bunun sonucunda, bir dizi {aggregation key, summary value} çift içeren bir özet rapor elde edersiniz.
Özet rapor, JSON sözlüğü stilinde bir anahtar/değer çifti kümesi içerir. Her çift aşağıdakileri içerir:
- paket: bayt dizesi olarak kodlanan toplama anahtarı.
- değer: belirli bir ölçüm hedefi için, ek gürültü düzeyiyle birlikte mevcut tüm birleştirilmiş raporlardan toplanan ondalık sayıdaki özet değer.
Örnek:
[
{"bucket": "111001001", "value": "2558500"},
{"bucket": "111101001", "value": "3256211"},
{...}
]
Pratikte özet raporlar, paketlerin ve değerlerin örnekte belirtilenden farklı görünmesine neden olacak şekilde kodlanır (yani bir paket \u0000\u0000\x80\u0000 şeklinde görünebilir). Paket ve değer bayt dizeleridir.
Uygulamada toplama anahtarları
Toplama anahtarları (paketler), bir reklam teknolojisi şirketi tarafından genellikle iki adımda tanımlanır: 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 x Coğrafi Kimlik x Ürün kategorisi temel bir yapıdır.
Anahtar türleri
Toplanabilir değerler, birden fazla kullanıcı/tarayıcı genelinde 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çine özet değerin neyi temsil ettiğini (bu anahtarın ifade ettiği ölçüm hedefini) söyleyen bir veri parçası kodlayın. Bunu yapmanın yollarından biri, 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ünde iki farklı olası değer 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 olurdu.
Anahtarların boyutlarını bir metrik olarak düşünebilirsiniz. Örneğin, "coğrafi konum ve 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 sayıdaki sıfır ve bir sayısıdı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 gürültülü değerlere neden olma olasılığı daha yüksektir. Gürültü hakkında daha fazla bilgi
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 sayıda bitle temsil edilmesi gerekir. n bitleriyle 2n farklı seçenek ifade etmek mümkündür.
Ö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 27 =128 farklı seçenek depolar. Bu değer, gerekli olan 200'den azdır.
8 bit, gerekli 200'den fazla olan 28 =256 farklı seçenek depolar. Dolayısıyla, bu boyutu kodlamak için n=8 bitlerini kullanabilirsiniz.
Anahtar kodlama
Tuşları tarayıcıda ayarladığınızda, bunların onaltılık olarak kodlanması gerekir. Özet raporlarında anahtarlar ikili program biçiminde (ve gruplar olarak adlandırılmıştır) görünür.
Tam bir anahtar için iki temel parça belirleyin
Aşağıdaki boyutları izlemek için bir anahtar kullandığınızı varsayalım:
- Kampanya Kimliği
- Coğrafi konum kimliği
- Ürün kategorisi
Reklam sunulduğunda (reklam sunma zamanı) Kampanya Kimliği ve Coğrafya Kimliği boyutları bilinse de kullanıcı bir dönüşümü tamamladığında (dönüşüm zamanı) ürün kategorisi bir tetikleyici etkinlikten öğrenilir.
Pratikte bu, bir anahtarı iki adımda ayarlayacağınız anlamına gelir:
- Tıklama veya görüntüleme sırasında anahtarın bir bölümünü (Kampanya Kimliği x Coğrafi Kimliği) ayarlarsınız.
- Anahtarın ikinci bölümünü (Ürün kategorisi) dönüşüm zamanında ayarlarsınız.
Tuşların bu farklı parçalarına anahtar parçaları denir.
Bir anahtar, anahtar parçalarının ÖZELVEYA (^) değeri alınarak hesaplanır.
Örnek:
- Kaynak tarafı anahtar parçası =
0x159 - Tetikleyici tarafı anahtar parçası =
0x400 - Anahtar =
0x159 ^ 0x400 = 0x559
Anahtar parçaları hizalama
Dikkatli bir şekilde yerleştirilmiş 64 bit dolgular/ofsetler (on altı sıfır) kullanılarak 128 bite genişletilen iki 64 bit anahtar parçasıyla ÖZELVEYA oluşturma anahtar parçaları, bunları birleştirmeye eşdeğerdir. Bu da, akıl yürütme ve doğrulama sürecini kolaylaştırır:
- Kaynak tarafı anahtar parçası =
0xa7e297e7c8c8d0540000000000000000 - Tetikleyici tarafı anahtar parçası =
0x0000000000000000674fbe308a597271 - Anahtar =
- 0x000000000000000674fbe308a597271 =
- 0xa7e297e7c8c8d054674fbe308a597271
Reklam tıklaması veya görüntüleme başına birden fazla anahtar
Pratikte, 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 x Kampanya Kimliği'ni izleyen bir anahtar.
- Reklam Öğesi Türü x Kampanya Kimliği'ni izleyen başka bir anahtar.
Başka bir örnek için B Stratejisine göz atın.
Boyutları anahtarlara kodlama
Özet rapor isteğinde bulunurken, 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} ç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, temsil ettiği boyutların değerlerine dayalı anahtarları güvenilir şekilde ayarlamanız gerekir.
- Özet raporu talep etmek istediğiniz anahtarları tanımlarken, kullanıcı bir reklamı görüntülediğinde veya tıkladığında ve dönüşüm gerçekleştirdiğinde oluşturulan anahtarların aynılarını güvenilir bir şekilde, toplu verileri görmek istediğiniz boyutların değerlerine dayalı olarak oluşturmanız veya bunlara 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 anahtar yapısı haritasını önceden oluşturup koruyabilirsiniz.
Anahtar yapısı haritası, her bir boyutunuzu ve bunların anahtardaki konumunu temsil eder.
Pratikte, temel yapı haritaları oluşturup sürdürmek, kod çözücü mantığını uygulayıp sürdürmeniz gerektiği anlamına gelir. Bunu yapmanızı gerektirmeyen bir yöntem arıyorsanız bunun yerine karma tabanlı bir yaklaşım kullanmayı düşünün.
Aşağıda bir örnek verilmiştir:
Belirli kampanyalar, coğrafi bölgeler ve ürünler için hem satın alma hem de satın alma değerlerini izlemeyi planladığınızı varsayalım.
Ürün kategorisi, coğrafi konum kimliği 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. Bu, özet raporlarında {key, aggregatable value} çiftleri aldıktan sonra toplanabilir değerin gerçekte neyi temsil ettiğini tanımlamanıza olanak tanır.
Bu ölçüm hedefleriyle anahtarınız aşağıdaki boyutlara sahip olur:
- Ürün kategorisi
- Ölçüm hedefi türü
- Coğrafi konum 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.
- 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 bir boyutu kodlamak için ihtiyaç duyacağınız bit sayısını burada bulabilirsiniz:
- Ürün kategorisi: 5 bit (25 = 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ğrafi konum kimliği: 3 bit (23 = 8). Ayrıca, her bir ikili değerin hangi coğrafi bölgeyi temsil ettiğini öğrenmek için Coğrafi Konum Kimliği için bir boyut eşlemesi 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 (24 = 16)
Bu yapıyı izleyen anahtarlar 13 bit uzunluğunda olur (5 + 1 + 3 + 4).
Bu örnekte, bu anahtarların anahtar yapısı eşlemesi aşağıdaki gibi olacaktır:
Anahtardaki boyutların sırası size bağlıdır.
Boyutların bir temel yapıyı nasıl oluşturduğunu göstermek için ikili gösterim kullanacağız. Bu nedenle, Kampanya Kimliği (ilk bitler) en sağdaki ve ürün kategorisi (son bitler) en solda yer alır.
Her boyuttan en önemli bit, yani 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ı eşlemesini nasıl kullanacağınızı görelim.
0b1100100111100 değerini rastgele bir örnek anahtar olarak ele alalım ve bu anahtarın bir önceki resimde bulunan anahtar yapısı haritasını izlediğini bildiğinizi varsayalım.
Anahtar yapısı haritasına göre, bu anahtar aşağıdakilerin kodunu çözer:
11001 0 011 1100
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ısı eşlemesi kullanmak yerine, anahtarları tutarlı ve güvenilir bir şekilde dinamik olarak oluşturmak için bir karma oluşturma işlevi kullanabilirsiniz.
Bu yöntem şu şekilde çalışır:
- Karma oluşturma algoritması seçin.
- Reklam yayınlanırken, 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 haline getirin ve tetikleyici tarafındaki anahtar parçasıyla hizalamak ve XOR işlevinin anlaşılmasını kolaylaştırmak için bu dizeyi sıfırlardan oluşan 64 bitlik bir son ek olarak ekleyebilirsiniz.
- Kaynak tarafı anahtar parçası
= <64 bit onaltılık karma("COUNT, campaignID=12, geoID=7"))><64 bit 00000000...> - COUNT işlevinin, anahtar yapısı eşleme yaklaşımında measurementGoalType=0 ile aynı şeyi kodladığını unutmayın. COUNT biraz daha yalın ve anlaşılır.
- Kaynak tarafı anahtar parçası
- Dönüşüm sırasında, izlemek istediğiniz tüm boyutları ve değerlerini içeren bir dize oluşturun. Tetikleyici tarafında anahtar parçası oluşturmak için bu dizeye karma oluşturma işlemi uygulayın ve 64 bitlik sıfırlardan oluşan bir önek ekleyin:
- Tetikleyici tarafı anahtar parçası = <64 bit 00000000...><64 bit onaltılık karma("productCategory=25")>
- Tarayıcı, bir anahtar oluşturmak için bu anahtar parçaları ÖZELVEYA (XOR) uygular.
- 128 bit toplama anahtarı
= <64 bit onaltılık kaynak tarafı anahtar parçası karması><64 bit onaltılık kaynak tarafı anahtar parçası karması>
- 128 bit toplama anahtarı
- Daha sonra, bu anahtar için özet raporu istemeye hazır olduğunuzda anahtarı hemen oluşturun:
- İlgilendiğiniz boyutlara göre, daha önce yaptığınız gibi kaynak taraf ve tetikleyici taraf için anahtar parçası oluşturun.
- Kaynak tarafı anahtar parçası
= <64 bit onaltılık karma("COUNT, campaignID=12, geoID=7"))><64 bit 00000000...> - Tetikleyici tarafı anahtar parçası
= <64 bit 00000000...><64 bit onaltılık karma("productCategory=25")> - tetikleyici tarafı anahtar parçası = toHex(hash("productCategory=25"))
- Kaynak tarafı anahtar parçası
- Tarayıcıda olduğu gibi, tarayıcının daha önce oluşturduğu anahtarı oluşturmak için bu anahtar parçalarını ÖZELLEŞTİRİN.
- 128 bit toplama anahtarı
= <64 bit kaynak tarafı anahtar parçası karması><64 bit kaynak tarafı anahtar parçası karması>
- 128 bit toplama anahtarı
- İlgilendiğiniz boyutlara göre, daha önce yaptığınız gibi kaynak taraf ve tetikleyici taraf için anahtar parçası oluşturun.
Bu karma tabanlı yaklaşımı kullanıyorsanız birkaç faydalı ipucu:
- Her zaman aynı boyutlar sıralamasını kullanın. Bu, karmalarınızın güvenilir bir şekilde yeniden oluşturulabilmesini sağlar. ("COUNT, CampaignID=12, GeoID=7", "COUNT, GeoID=7, CampaignID=12" ile aynı karmayı oluşturmaz." Bunu sağlamanın kolay bir yolu boyutları alfasayısal olarak sıralamaktır. BAĞ_DEĞ_SAY veya DEĞERİNİ her zaman boyuttaki ilk öğe yapacağımız gerçeği dışında, örnekte bu işlemi yapacağız. COUNT veya VALUE, kavramsal olarak diğer tüm boyutlardan biraz farklı olan bilgileri kodladığından bu, okunabilirlik açısından bir seçimdir.
- Anahtarlarda kullandığınız boyut grubunu takip edin. Daha önce kullanmadığınız bir boyut grubuna dayalı anahtarlar oluşturmaktan kaçınmak istiyorsunuz.
- Uygun bir karma işlevi kullanılırsa karma çakışmaları nadir görülür. Ancak, daha önce kullanılan karmaların (toplama hizmetinden elde edilen sonuçları yorumlamak için saklanması gerekir) kontrol edilmesi, eski anahtarlarla çakışan yeni anahtarların ortaya çıkmasını önleyebilir.
Tıklama veya görüntüleme başına bir dönüşüm örneğini inceleyerek, karma tabanlı anahtarların pratikte nasıl kullanılacağını görebilirsiniz.
Uygulamada toplanabilir değerler
Reklam teknolojisi şirketi, kullanıcı dönüşüm gerçekleştirdiğinde birleştirilebilir değerler belirler.
Kullanıcı gizliliğinin korunması için her kullanıcının katkısı için bir üst sınır uygulanır. Tek bir kaynakla (reklam tıklaması veya görüntüleme) ilişkili tüm toplanabilir değerlerde hiçbir değer belirli bir katkı sınırından daha yüksek olamaz.
Bu sınırı CONTRIBUTION_BUDGET olarak adlandıracağız. Açıklamacıda bu sınıra L1 bütçesi denir ancak CONTRIBUTION_BUDGET ile aynıdır.
Katkı bütçesi hakkında ayrıntılı bilgiyi Özet raporlar için katkı bütçesi başlıklı makalede bulabilirsiniz.
Ö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 bir bölgedeki en değerli ürün kategorileri hangileri?
- Her bir 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.
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 olmasını sağlamanın iyi bir yoludur. Aslında, ne kadar çok metrik ölçerseniz, metrik başına katkı bütçeniz o kadar küçük olur ve dolayısıyla, her bir değerin muhtemelen daha gürültülü olması gerekir. Bu nedenle, neyi ölçeceğinizi dikkatlice seçmeniz gerekir.
Bu örnekte, tıklama veya görüntüleme başına yalnızca tek bir dönüşümü, yani satın alma işlemini ölçen kampanya ayarlarına odaklanacağız.
Hem satın alma sayısını hem de satın alma değerini ölçmeye devam eder ve toplam satın alma değeri ile 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ı sağlar.
Peki ya para birimleri?
Farklı bölgelerde kampanya yayınlamak, para birimlerinin hesaba katılması gerektiği anlamına gelir. Şunları yapabilirsiniz:
- Para birimini, toplama anahtarlarında özel bir boyut haline getirin.
- Alternatif olarak, para birimini kampanya kimliğinden öğrenip tüm para birimlerini referans para birimlerine dönüştürebilirsiniz.
Bu örnekte, para birimini bir kampanya kimliğinden çıkarabildiğinizi varsayacağız. Böylece belirli bir satın alma değerini kullanıcının yerel para biriminden, tercih ettiğiniz bir referans para birimine dönüştürebilirsiniz. Bu dönüşümü anında, kullanıcı bir öğe satın aldığında da gerçekleştirebilirsiniz.
Bu teknikle, birleştirilebilir tüm değerler aynı referans para biriminde olur ve bu nedenle, toplam toplu satın alma değeri (özet satın alma değeri) oluşturmak için toplanabilir.
Hedefleri anahtarlara dönüştürün
Ölçüm hedefleriniz ve metrikleriniz sayesinde, temel stratejiniz için birçok seçeneğiniz vardır. Bu stratejilerden ikisine odaklanalım:
- A Stratejisi: Tek bir ayrıntılı temel yapı.
- B Stratejisi: iki genel anahtar yapı.
Strateji A: bir derin ağaç (ayrıntılı bir 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 temel yapıyı, iki ölçüm hedefini desteklemek için iki anahtar türe bölersiniz.
- 0 anahtar türü: Ölçüm hedefi türü = 0. Bu değeri, satın alma sayısı olarak tanımlayabilirsiniz.
- 1. anahtar türü: Ölçüm hedefi türü = 1. Bu türü, satın alma değeri olarak tanımlayabilirsiniz.
Özet raporlar aşağıdaki gibi görünür:
A stratejisini bir "derin ağaç" stratejisi olarak düşünebilirsiniz:
- Özet raporlarındaki her bir özet değeri, izlediğiniz tüm boyutlarla ilişkilendirilir.
- Bu özet değerleri, bu boyutların her biriyle birlikte toplayabilirsiniz. Böylece söz konusu kapsamlı görünümler, sahip olduğunuz boyut sayısına kadar inebilir.
A stratejisini kullanırken sorularınızı şu şekilde yanıtlarsınız:
| Soru | Yanıtla |
|---|---|
| Her bir bölgedeki en değerli ürün kategorileri hangileri? | Tüm kampanyalar için özet raporlarında yer alan özet satın alma sayılarını ve değerleri toplayın. Bu işlem, Coğrafi Kimlik x Ürün kategorisine göre satın alma sayısı ve değerini verir. Her bölge için satın alma değerini ve farklı ürün kategorilerinin sayısını karşılaştırın. |
| Her bir bölgede en etkili kampanya stratejileri hangileridir? | Tüm ürün kategorileri için özet raporlarında yer alan özet satın alma sayılarını ve değerleri toplayın. Bu sütun, her Kampanya Kimliği x 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 da doğrudan yanıtlayabilirsiniz:
"Her bir coğrafi bölgedeki kampanyalarım her bir ürün için ne kadar gelir sağladı?"
Özet değerler karmaşık olsa bile, her bir kampanya arasında ölçülen değerdeki farklılıkların ne zaman yalnızca gürültüden kaynaklanmadığını belirleyebilirsiniz. Bunu nasıl yapacağınızı Gürültüyü anlama bölümünden öğrenebilirsiniz.
B Stratejisi: iki yüzeysel 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 anahtar türe ayırırsınız.
- Ölçüm hedefi türü = 0. Bunu satın alma sayısı olarak tanımlamaya karar verirsiniz.
- Ölçüm hedefi türü = 1. Bu türü, satın alma değeri olarak tanımlamaya karar verirsiniz.
Böylelikle dört temel türünüz olur:
- 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 bir "iki yüzeysel ağaç" stratejisi olarak düşünebilirsiniz:
- Özet raporlarındaki özet değerler, iki küçük boyut grubundan biriyle eşleşir.
- Bu özet değerleri, bu gruplardaki boyutların her biriyle birlikte toplayabilirsiniz. Yani, birleştirilecek daha az boyut olduğu için bu kapsamlı görünümler, A seçeneğindeki kadar derin değildir.
B stratejisini kullanırken sorularınızı aşağıdaki şekilde yanıtlarsınız:
| Soru | Yanıtla |
|---|---|
| Her bir bölgedeki en değerli ürün kategorileri hangileri? | Özet raporlarındaki özet satın alma sayılarına ve değerlerine doğrudan erişebilirsiniz. |
| Her bir bölgede en etkili kampanya stratejileri hangileridir? | Özet raporlarındaki ö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ı anahtar yapısına uyar. Bu da, sürdürülecek tek bir temel yapınız olduğu anlamına gelir.
Ancak, A stratejisiyle, sorularınızdan bazılarını yanıtlamak için özet raporlarında aldığınız özet değerleri toplamanız gerekir. Bu özet değerlerin her biri gürültülüdür. Bu verileri toplayarak gürültüyü de toplamış olursunuz.
Bu durum, özet raporlarında gösterilen özet değerlerin size zaten ihtiyacınız olan bilgileri sağladığı B stratejisi için geçerli değildir. Diğer bir deyişle, B stratejisinin gürültüden A stratejisinden daha az etki yaratma olasılığı yüksektir.
Hangi stratejiyi kullanacağınıza nasıl karar vermeniz gerekir? Mevcut reklamveren 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 şunları yapabilirsiniz:
- Ayrıntılı anahtarlarla (A Stratejisi) bir aylık verileri toplayın. Veri toplama süresini uzattığınız için özet değerleri daha yüksek ve gürültü 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ının 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 yol açacağı kadar yüksek olduğunu varsayalım.
A stratejisi daha basit olduğu ve karar verme kabiliyetinizi etkilemeyen bir gürültü etkisine yol açtığı 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. MD5 gibi daha basit, daha az güvenli bir algoritma da kullanabilirsiniz.
Tarayıcıda: Anahtarları ve değerleri ayarlama
Artık bir 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 daha sonra dönüşüm gerçekleştirdiğinde anahtarları ve değerleri kaydetmeye hazırsınız.
Sonraki bölümde, tarayıcıda anahtarları ve değerleri kaydetmek için ayarlayacağınız başlıklara genel bir bakış sunulmaktadır:
Kaynak tarafı anahtar parçalarını ayarlama
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 zamanında bilinen anahtarın veya anahtarın bir kısmını ayarlayabilirsiniz.
Temel bileşenleri oluşturalım:
| Anahtar kimliği için kaynak tarafı anahtar parçası... | Ayarlamak istediğiniz boyut değerlerini içeren dize | Bu dizenin on altılı cinsinden karması, ilk 64 bite kırpılır (64/4 = 16 karakter1) | ÖZELVEYA işlevini basitleştirmek için sonuna eklenen sıfırlarla onaltılık karma. Bu, kaynak tarafı temel parçasıdır. |
|---|---|---|---|
| key_purchaseCount | COUNT, Kampanya Kimliği=12, Coğrafi Kimlik=7 | 0x3cf867903fbb73ec | 0x3cf867903fbb73ec0000000000000000 |
| key_purchaseValue | DEĞER, Kampanya Kimliği=12, Coğrafi Kimlik=7 | 0x245265f432f16e73 | 0x245265f432f16e730000000000000000 |
Şimdi önemli parçaları 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ı ayarlarken 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üzeyinde raporlar
Birleştirilebilir raporlarla birlikte etkinlik düzeyinde raporlar 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, en yüksek satın alma sayısını sağlayan reklam türleriyle ilgili modeller çalıştırmak için etkinlik düzeyinde 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 isteği aldıktan sonra:
- Anahtarı tamamlamak için dönüşüm tarafındaki (tetikleyici tarafı) anahtar parçalarını ayarlayın.
Bu temel parçaları
Attribution-Reporting-Register-Aggregatable-Trigger-Databaşlığı aracılığıyla ayarlayacaksınız. Attribution-Reporting-Register-Aggregatable-Valuesbaşlığı aracılığıyla bu dönüşüm için toplanabilir değeri belirleyin.
Anahtarı tamamlamak için tetikleyici taraflı anahtar parçaları belirleyin
Temel bileşenleri oluşturalım:
| Anahtar kimliği için tetikleyici tarafı anahtar parçası... | Ayarlamak istediğiniz boyut değerlerini içeren dize | Bu dizenin on altılık olarak karması, ilk 64 bite kırpılır (64/4 = 16 karakter1) | ÖZELVEYA işlevini simplify için eklenen sıfırlarla onaltılık karma. Bu, kaynak tarafı temel parçasıdır. |
|---|---|---|---|
| key_purchaseCount | Ürün Kategorisi=25 | 0x1c7ce88c4904bbe2 | 0x0000000000000000f9e491fe37e55a0c |
| key_purchaseValue | (aynı) | (aynı) | (aynı) |
Şimdi önemli parçaları 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 çeşitli anahtar kimliklerini listeleyerek aynı anahtar parçasını birkaç anahtara nasıl eklediğinize dikkat edin. Anahtar parçası her iki anahtara da eklenecektir.
Toplanabilir değerler belirleyin
Birleştirilebilir değerleri ayarlamadan önce, gürültüyü azaltmak için bunları ölçeklendirmeniz gerekir.
25 ürün türü için 52 ABD doları karşılığında bir satın alma işlemi yapıldığını varsayalım.
Bunları doğrudan toplanabilir değerler olarak ayarlayamazsınız:
key_purchaseCount: 1 dönüşümkey_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 harcayacağınız iki hedefiniz vardır. Bu nedenle, katkı bütçesini ikiye bölmeye karar verebilirsiniz.
Bu durumda, her bir hedefe maksimum CONTRIBUTION_BUDGET/2 (=65.536/2=32.768) ayrılır.
Sitenin tüm kullanıcıları genelindeki satın alma geçmişine dayalı olarak tek bir kullanıcı için 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 göz ardı etmeye karar verebilirsiniz.
Satın alma değeri için ölçeklendirme faktörünüz şöyle olmalıdır:
((CONTRIBUTION_BUDGET/2) / 1.500) = 32.768/1.500 = 21,8~ 22
Reklam tıklaması veya görüntülemesi (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 şu değerleri ayarlayabilirsiniz:
key_purchaseCount: 1*32.768 = 32.768key_purchaseValue: 52*22 = 1.144
Pratikte, özel Attribution-Reporting-Register-Aggregatable-Values başlığını kullanarak bunları aşağıdaki gibi ayarlayabilirsiniz:
// 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ünüm veya tıklamayla eşleştirir ve rapor meta verilerinin yanında şifrelenmiş yükü içeren bir rapor oluşturabilir.
Aşağıda, düz metin olarak okunabiliyorsa birleştirilebilir 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ıyı görebilirsiniz.
Özet rapor isteme
- Toplu olarak toplanabilir raporlar. Gruplama konusunda sunulan öneriyi uygulayın.
- Verilerini görmek istediğiniz anahtarları oluşturun. Örneğin, Kampanya Kimliği 12 x Coğrafi Kimlik 7 x Ü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 üzere:
- 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.
| İsteyeceğiniz metrik1 | Kaynak tarafı önemli parça | Tetikleyici tarafı anahtar parçası | Toplama hizmetine istekte bulunma 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 |
- Bu anahtarlar için toplama hizmetinden özet veri isteyin.
Özet raporunu işleme
Son olarak, aşağıdaki gibi 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-VALUE) aynı raporda yer alırlar.
Değerleri küçültün
- 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üne göre ölçeklenir. Satın alma sayısı için ölçeklendirme faktörü 32.768'di. 2.558.500'u 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.
Bunun sonucunda, özet raporlar size aşağıdaki bilgileri sağlar:
Within the reporting time period, campaign #12
run in Europe drove about 156 purchases (± noise)
for the product category #25.
Within the reporting time period, campaign #12
run in Europe drove $31,230 of purchases (± noise)
for the product category #25.