İlişkilendirme kapsamlarını kullanarak kaynaklara ilişkilendirmeden önce filtre uygulama

İlişkilendirme kapsamları, API çağrısı yapanların kaynak ve tetikleyici kaydı sırasında, ilişkilendirme gerçekleşmeden önce filtreleme için kullanılabilecek bir dize listesi belirtmesine olanak tanır. Bu, API verimliliğini artırmak ve daha fazla esneklik sağlamak için daha ayrıntılı filtrelemeye olanak tanır. Örneğin, aynı sitedeki farklı reklamverenlerin ayrı ayrı izlenmesini sağlar. Ayrıca, tek bir reklam banner'ında birden fazla kampanyanın veya ürünün izlenmesini kolaylaştırır.

İlişkilendirme kapsamları, kaynak ve tetikleyici kaydı sırasında ayarlanabilen isteğe bağlı alanlardır. Atıf sırasında, yalnızca atıf kapsamı değerleri tetikleyicinin atıf kapsamı değerlerinden en az birini içeren kaynaklar atıf için dikkate alınır. Tetikleyicide kapsam belirtilmezse tüm kaynaklar dikkate alınır. Devam etmeden önce ilişkilendirme raporlama API'si ve üst düzey filtreler hakkında bilgi sahibi olmanız gerekir.

Kaynak kaydı sırasında

İki zorunlu parametre (değerler ve sınır) ve bir isteğe bağlı parametre (max_event_states) içeren başlığa Attribution-Reporting-Register-Source isteğe bağlı bir parametre attribution_scopes eklenir.

• limit: Kaynak raporlama kaynağı için hedef başına izin verilen farklı kapsamların toplam sayısını gösterir. Aynı raporlama kaynağına ve hedefe sahip ancak daha küçük bir sınıra sahip olan mevcut tüm kayıtlı kaynaklar silinir.
• values: Belirli bir kaynağın ilişkilendirme kapsamlarının listesini temsil eder. Bu değerler, maksimum uzunluğu 50 olan dizeler olmalıdır.
• max_event_states (isteğe bağlı): Bir API çağırıcının, sonraki tüm etkinlik kaynağı kayıtlarında kullanmayı planladığı maksimum etkinlik durumu sayısını gösterir. Aynı raporlama kaynağına ve hedefine sahip ancak farklı bir max_event_states value ile kaydedilmiş mevcut kaynakların silineceğini unutmayın. Bu isteğe bağlı alanın varsayılan değeri 3'tür.

Kaynak kaydı örneği

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

Tetikleyici kaydı sırasında

Tetikleyici kaydı sırasında üstbilgiye Attribution-Reporting-Register-Trigger isteğe bağlı bir parametre attribution_scopes eklenir. Parametre değerinin, tetikleyicinin kapsamlarını temsil eden bir dizeler listesi olduğundan emin olun. Tetikleyici, yalnızca belirtilmişse tetikleyicinin attribution_scopes değerlerinden en az birini içeren attribution_scopes parametresine sahip kaynaklarla eşleşir.

Tetikleyici kaydı örneği

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

İlişkilendirme kapsamları örneği

Aşağıdaki örnekte, ilişkilendirme kapsamları kullanılırken bir tetikleyicinin bir kaynakla ilişkilendirildiği durum gösterilmektedir.

1. kaynak kaydı

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

2. kaynak kaydı

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

Tetikleyici kaydı

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

Tetikleyici kaydı gerçekleştiğinde API, ilişkilendirme için dikkate alınacak kaynakları seçer. Bu kaynakların attribution_scopes değerleri, tetikleyici kaydındaki değerlerle kesişir. Eşleşen kaynak kayıtları, ilişkilendirme akışının geri kalanıyla devam eder. Bu örnekte, API'yi çağıran kişi, tetikleyici kaydını ilk kaynak kaydına atfeden bir ilişkilendirme raporu alır.

İlişkilendirme kapsamları ve filtreler karşılaştırması

İlişkilendirme kapsamlarının ve filtrelerin işlevleri benzer görünse de ayırt edici faktör, tetikleyici kaydı akışında uygulandıkları yerdir. İlişkilendirme kapsamı filtreleme, ilişkilendirmeden önce gerçekleşir. Bu, tetikleyicide bulunan kapsamlarla kesişen kapsamlara sahip kaynaklara göre, aynı hedef siteye ve raporlama kaynağına sahip, süresi dolmamış aday kaynakların havuzunu azaltır. Ancak üst düzey filtreler, bir tetikleyici tek bir kaynağa atfedildikten sonra uygulanır. Kaynak ve tetikleyici filtreleri kesişmiyorsa rapor oluşturulmaz.

Aşağıdaki resimde, aynı hedef siteye ve raporlama kaynağına sahip olan ve süresi dolmamış bir kaynak grubu ile bir tetikleyici gösterilmektedir. Atıf kapsamlarının ve filtrelerin nasıl kullanıldığı ve mevcut kaynaklara ve tetikleyicilere göre bir raporun oluşturulup oluşturulmayacağı hakkında kısaca bilgi vereceğiz.

İlişkilendirmeden önce

• 1. kaynak, ilişkilendirme kapsamı tetikleyicinin casualwear kapsamıyla eşleşmediği için filtrelenir. Tüm kullanılabilir kaynaklar arasında en yüksek önceliğe sahip olması, öncelikler kontrol edilmeden önce ilişkilendirme öncesi filtreleme gerçekleştiği için filtrelenmesini engellemez.
• 2. kaynak da tetikleyiciyle aynı kapsama sahip olmadığı için filtrelenir. Bu kaynakta tetikleyiciyle aynı filtre de bulunur ancak üst düzey filtreler ilişkilendirmeden sonra uygulanır.

İlişkilendirme sırasında

• Kaynak 3, Kaynak 4'ten daha düşük önceliğe sahip olduğundan ilişkilendirme için seçilmez.
• Tetikleyiciyle eşleşen bir ilişkilendirme kapsamına sahip olduğu ve en yüksek önceliğe sahip olduğu için 4. kaynak seçilir. Yüksek düzeydeki filtreler ilişkilendirmeden sonra uygulandığından ilişkilendirme sürecinde dikkate alınmaz.

Yayın ilişkilendirmesi

• Seçilen kaynak (kaynak #4) ve tetikleyici için üst düzey filtreler kesişmediğinden rapor oluşturulmaz.

Önceki örnekte rapor oluşturulmaz. Ancak dördüncü kaynak tamamen kaldırılırsa:

İlişkilendirme sırasında

• Tetikleyiciyle kesişen bir ilişkilendirme kapsamına sahip olduğu için 3. kaynak seçilir.

Yayın ilişkilendirmesi

• Filtresi tetikleyicideki filtreyle kesiştiği için 3. kaynak reddedilmez. İlişkilendirme daha sonra, ilişkilendirme sonrası kontrollerin geri kalanından geçer ve tüm kontrolleri geçerse bir rapor oluşturulur.

İlişkilendirme kapsamları, ilişkilendirme için dikkate alınan kaynakların sayısını azaltır. Kalan ilişkilendirme adımları daha sonra bu daha küçük kaynak havuzuna uygulanır ve bu da bir raporla sonuçlanabilir.

İlişkilendirme kapsamlarının ilişkilendirme akışındaki yeri

İlişkilendirme kapsamları, ilişkilendirme için bir kaynak seçilmeden önce uygulanır. Bu, üst düzey filtrelerden ve özel rapor penceresi filtrelemeden de önce gelir. Aşağıdaki şemada, ilişkilendirme kapsamının ilişkilendirmeden ve ilişkilendirme kontrollerinin geri kalanından önce gerçekleştiği, genel ilişkilendirme akışının basitleştirilmiş bir versiyonu gösterilmektedir.

İlişkilendirme akışı işlemleri

Aşağıda, ilişkilendirme akışı sırasında gerçekleştirilen çeşitli işlemlerin bir özeti verilmiştir:

• Kaynak kaydı: Kullanıcı, reklamverenin sitesindeki bir reklamla etkileşimde bulunduğunda bir kaynak etkinliği kaydedilir. Ardından cihaz, raporlama kaynağının uç noktasına bir istek gönderir. Bu uç nokta, kaynak etkinlik verilerini içeren bir başlıkla yanıt verir.
• Tetikleyici kaydı: Reklamverenin sitesinde bir dönüşüm gerçekleştiğinde tetikleyici etkinlik kaydedilir. Cihaz tarafından raporlama kaynağına başka bir istek gönderilir. Bu istek, tetikleyici etkinlik verilerini içeren bir üstbilgiyle yanıtlanır.
• Kaynak eşleştirme: Cihaz, hedef site, raporlama kaynağı ve geçerlilik süresi gibi ölçütlere göre kaynak ve tetikleyici etkinlikleri eşleştirir.
• İlişkilendirme kapsamları kontrolü: Kaynaklar, kaynak ve tetikleyici attribution_scopes değerleri arasındaki kesişime göre filtrelenir.
• İlişkilendirme: Birden fazla kaynak eşleşirse cihaz, ilişkilendirme için en yüksek öncelikli kaynağı seçer. Öncelikler eşitse en son olan seçilir.
• Filtre kontrolü: Cihaz, kaynak ve tetikleyici filtrelerin eşleşip eşleşmediğini belirlemek için bunları karşılaştırır. Filtreler eşleşmezse ilişkilendirme bırakılır.
• Diğer kaynakların devre dışı bırakılması: Seçilen kaynağın filtreleri eşleşirse cihaz, Kaynak eşleştirme aşamasında eşleşen kaynakları devre dışı bırakır. Devre dışı bırakılan kaynaklar, ilişkilendirme kapsamları tetikleyici kapsamlarıyla eşleşmeyen kaynakları içerir.
• İlişkilendirme sonrası kontroller: Cihaz, seçilen ilişkilendirme üzerinde daha fazla kontrol gerçekleştirir. Örneğin, kaynağın sahte raporlarla gürültü oluşturup oluşturmadığını, tekilleştirme anahtarlarını kullanarak yinelenen ilişkilendirmeleri, tetikleyicinin kaynağın rapor penceresi içinde olup olmadığını ve sıklık sınırlarını kontrol eder.
• Rapor oluşturma: Tüm kontroller başarılı olursa cihaz, raporlama kaynağının uç noktasına gönderilecek bir ilişkilendirme raporu oluşturur ve planlar.

Sonraki adımlar

• İlişkilendirme kapsamları hakkında daha fazla bilgiyi Ön ilişkilendirme filtreleme GitHub açıklayıcısında bulabilirsiniz.
• Filtreler hakkında daha fazla bilgiyi Filtreleri kullanarak müşteri kurallarını tanımlama başlıklı makalede bulabilirsiniz.