İ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

Burada açıklandığı gibi, kampanyalarınızın nasıl gelir elde ettiğini anlamak için aşağıdaki boyutları izlemeniz önerilir:

• 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 {aggregate key, aggregatable value} ç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 bununla ilgili 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'in ikisi de bayt dizeleridir.

Ö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'in ikisi de bayt dizeleridir.

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; 19 değil, 25 eder. İkili sayıların başında genellikle 0b öneki bulunur. Örneğin, 0b11001, ikilik biçimde 11001'dir; bu sayı, 11.001 değil,25 değerine eşittir.

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 dokümanda, temel parçaların hatalı bir şekilde " aslında bit tabanlı-VEYA kullanılarak birleştirildiklerinde, bit tabanlı ÖZELVEYA.

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 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ğ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: bu nedenle bir bit depolama alanı 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	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ı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 hizalamak için sıfırlardan oluşan 64 bitlik bir sonek ekleyin. bunu tetik tarafındaki anahtarla devreye sokabilir ve XOR'un daha kolay akıl yürütmesini sağlayabilirsiniz.
   • 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ı içeren bir dize oluşturun ve değerlerini daha iyi anlayacaksınız. 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 raporu 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 açısından 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, ölçüm hedefleriniz için temel bir stratejidir. 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, tüm bileşenleri içeren tek bir ayrıntılı anahtar yapısı kullanırsınız. size en uygun olanlarını seçin:

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

İki ölçümü desteklemek için bu anahtar yapısını iki anahtar türe ayırırsınız hedefler.

• Anahtar türü 0: ölçüm hedefi türü = 0. Bu değeri, purchase sayısı.
• Anahtar türü 1: ölçüm hedefi türü = 1. Bu metriği, satın alma değeri.

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

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

• Özet raporlardaki her özet değer, raporun basit bir araçtır.
• Bu özet değerleri, bu boyutların her biriyle birlikte toplayarak Bu nedenle, toplam boyut sayınız kadar kapsamlı olabilir.

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

Soru	Yanıtla
Her bölgede en değerli ürün kategorileri hangileri?	Özet satın alma sayılarını ve özetteki değerleri toplayın. tüm kampanyalarda kullanabilirsiniz. . Bu, Coğrafi Kimlik × Ürün başına satın alma sayısını ve değerini verir seçin. . Her bölge için satın alma değerini ve farklı öğelerin sayısını karşılaştırın. ürün kategorilerinde kullanılabilir.
Her bölgede en etkili kampanya stratejileri hangileridir?	Özet satın alma sayılarını ve özetteki değerleri toplayın. tüm ürün kategorilerinde raporlar. . Bu size kampanya kimliği × Coğrafi Kimlik başına satın alma sayısını ve değerini verir. . Her bölgede farklı için satın alma değerini ve sayısını karşılaştırın. kampanyaları.

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

Her bir coğrafi bölgede kampanyalarımdaki her bir ürün için oluşturmak için ne gerekir?"

Özet değerleri karışık görünse de, bunları ne zaman kampanyalar arasında ölçülen değerdeki farklar, varyanstan kaynaklanmamaktadır. yaşayabilirsiniz. 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 gereken boyutlar:

İki temel yapıyı desteklemek için bu temel yapıların her birini ölçüm hedeflerini göz önünde bulundurun.

• Ölçüm hedefi türü = 0 (bu, satın alma işlemi olarak tanımlamaya karar verirsiniz) Sayı.
• Ölçüm hedefi türü = 1; bu hedef, satın alma işlemi olarak tanımlar değeri için de doğru olduğundan emin olun.

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ç" olarak düşünebilirsiniz strateji:

• Özet raporlarındaki özet değerler, iki küçük kümeden biriyle eşlenir. seçin.
• Bu özet değerleri, tablodaki boyutların her biriyle birlikte Bu da söz konusu listelerin A seçeneğindeki kadar derin olmadığı anlamına gelir. daha az boyut olduğundan emin olun.

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

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

Karar: A Stratejisi

A stratejisi daha basittir; tüm veriler aynı temel yapıdadır; bu yapı aynı zamanda bakımını yapmanız gereken tek bir temel yapıya sahip olduğunuz anlamına gelir.

Ancak A stratejisi ile, özet raporlarından yararlanabilirsiniz. Bu özet değerlerin her biri gürültülü çıkar. Bu verileri toplayarak gürültüyü toplamak.

Bu durum, özet değerlerinin özette gösterildiği B stratejisi için geçerli değildir. ihtiyaç duyduğunuz bilgileri zaten size sağlar. Bu durumda, B stratejisi muhtemelen gürültünün A stratejisine göre daha az etkisi olur.

Hangi stratejiyi kullanacağınıza nasıl karar vermelisiniz? Mevcut reklamverenler veya kampanyalarınızın hacminin dönüşüm oranı, A stratejisi veya B stratejisi için daha uygundur. Ancak, yeni şuna karar verebilirsiniz:

• 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 ve gürültü nispeten daha düşük olur.
• Haftalık dönüşüm sayısını ve haftalık dönüşüm sayısını makul doğruluk oranıyla satın alma değeri.

ziyaret edin.

Not: Rapor sayılarına veya yalnızca hata ayıklama raporlarından alınan verilere güvenmeyin. bir doğruluk kaynağı olarak kullanabilirsiniz. Gelecekte, veriler hata ayıklama raporlarındaki görünen bilgiler değişecek ve parazitli raporlar gerçek raporlarla birlikte üretildiğinden bu sinyallerden yalnızca uygulamanızı ve test stratejinizi doğrulamak için kullanılır.

Bu örnekte, haftalık satın alma sayısının ve satın alma değerinin olarak düşündüğünüz bir gürültü yüzdesine neden olacak kadar yüksek olduğundan emin olun. kabul edilebilir hale gelecektir.

Çünkü A stratejisi daha basittir ve ve karar verme kabiliyetinizi etkiliyorsa A stratejisini kullanmaya karar verirsiniz.

Karma oluşturma algoritması seçin

Karma tabanlı bir yaklaşım benimsemeye karar verirseniz anahtarlarınızı oluşturun. Bunun için bir karma oluşturma algoritması seçmeniz gerekir. destek olmanız beklenebilir.

SHA-256'yı seçtiğinizi varsayalım. Ayrıca daha basit, daha az güvenli bir algoritmadır.

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 anahtar ve değerleri kaydetmeye hazır olur. gösterir.

Ardından, anahtar ve değerleri kaydetmek için ayarlayacağınız başlıklara tarayıcı:

Kaynak tarafı anahtar parçalarını ayarlama

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

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

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 (64/4) kırpılır = 16 karakter^1)	Basitleştirmek için son olarak sıfır eklenen onaltılık karma ÖZELVEYA-yazma. Bu, kaynak tarafı anahtar parçasıdır.
key_purchaseCount	COUNT, CampaignID=12, GeoID=7	0x3cf867903fbb73ec	0x3cf867903fbb73ec0000000000000000
key_purchaseValue	VALUE, CampaignID=12, GeoID=7	0x245265f432f16e73	0x245265f432f16e730000000000000000

¹Her on altılı 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. Sadece kullanılırlar için en iyi uygulamaları paylaşacağız. Böylece kaynak tarafındaki ve tetikleyici tarafındaki anahtar, bileşenleri 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 verilerin (kaynak etkinlik kimliği ve tetikleyici verileri) ve ile eşleştirilebilir.

Ö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ı başlıktan Attribution-Reporting-Register-Aggregatable-Trigger-Data
• Bu dönüşüm için toplanabilir değeri başlıktan belirleyin. Attribution-Reporting-Register-Aggregatable-Values

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

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

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 (64/4) kırpılır = 16 karakter^1)	ÖZELVEYA işlevini basitleştirmek için sonuna eklenen sıfırlarla onaltılık karma. Bu, kaynak tarafı anahtar parçasıdır.
key_purchaseCount	ProductCategory=25	0x1c7ce88c4904bbe2	0x0000000000000000f9e491fe37e55a0c
key_purchaseValue	(aynı)	(aynı)	(aynı)

¹Her on altılı 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"]
    },
  ])
);

Aynı anahtar parçasını birkaç anahtara nasıl eklediğinize dikkat edin. source_keys içindeki anahtar kimlikleri: Anahtar parçası her iki anahtara da eklenir.

Toplanabilir değerler belirleyin

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

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 ölçek gürültüyü en aza indirmek amacıyla kullanılır.

Katkı bütçenizi aşmak için iki hedefiniz var. Bu nedenle, katkı bütçesini ikiye bölmeye karar verdik.

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

Satın alma işlemine göre, tek bir kullanıcının maksimum satın alma değerini kabul edelim 1.500 ABD dolarıdır. Aykırı görüşler olabilir ama örnek olarak, bu toplamın üzerinde harcama yapan çok az kullanıcı vardır, ancak yine de yardımcı olabilir.

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

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

Artık şu değerleri ayarlayabilirsiniz:

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

Pratikte, özel başlığı kullanarak bunları aşağıdaki gibi ayarlayabilirsiniz: Attribution-Reporting-Register-Aggregatable-Values:

// 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şturulur

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

Aşağıda, toplu hale getirilebilir raporun, şifresiz metin olarak okunabiliyorsa:

[
  {
    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 içerikte iki ayrı katkıyı görebilirsiniz rapordur.

Özet rapor isteme

• Toplu olarak toplanabilir raporlar. Şu yardım makalesinde sunulan tavsiyelere uyun: Toplulama.
• Verilerini görmek istediğiniz anahtarları oluşturun. Örneğin, Arkadaş Bitkiler projesinin özetini görmek için COUNT (toplam satın alma sayısı) ve VALUE (toplam satın alma değeri) verileri Kampanya Kimliği 12 × Coğrafi Kimliği 7 × Ürün kategorisi 25 için:
  • Ayarlarken yaptığınız gibi kaynak tarafı anahtar parçasını oluşturun. tıklayın.
  • 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, VALUE anahtarıdır kullanır. Anahtarlar heterojen olsa da (COUNT-VALUE) aynı aynı raporda yer alır.

Not: Pratikte özet raporlar, Paketler ve değerler, gördüğünüzden farklı görünür (yani bir grup \u0000\u0000\x80\u0000 gibi görünebilir). Paket ve valueların her ikisi de bayt dizesidir. Bir örneği burada bulabilirsiniz.

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

• 2.558.500, bu anahtar için satın alma sayısının önceden hesapladığınız ölçeklendirme faktörüne için ölçeklendirme faktörü satın alma sayısı 32.768'di. 2.558.500'ü hedefin katkısına bölün bütçe: 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öneminde 12 numaralı kampanya Avrupa'da koşmak, yaklaşık 156 satın alma işlemi sağladı (± gürültü) 25 numaralı ürün kategorisi için seçin.
• Raporlama döneminde 12 numaralı kampanya 31.230 dolarlık alışverişler (± gürültü) 25 numaralı ürün kategorisi için seçin.