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

İlişkilendirme kapsamları, API çağırıcılarını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 sayede, API verimliliğini artırmak ve daha fazla esneklik sağlamak için daha ayrıntılı filtreleme yapılabilir. Örneğin, aynı sitedeki ayrı reklamverenleri ayrı ayrı izlemenize olanak tanır. Ayrıca tek bir reklam banner'ında birden fazla kampanyayı veya ürünü izlemeyi kolaylaştırır.

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

Kaynak kaydı sırasında

Attribution-Reporting-Register-Source başlığına, iki zorunlu parametre (values ve limit) ve bir isteğe bağlı parametre (max_event_states) içeren isteğe bağlı bir parametre attribution_scopes eklenir.

  • limit: Kaynak raporlama kaynağı için hedef başına izin verilen toplam farklı kapsam sayısını temsil eder. Raporlama kaynağı ve hedefi aynı olan ancak daha küçük bir sınıra sahip olan mevcut kayıtlı kaynaklar silinir.
  • values: Belirli bir kaynak için ilişkilendirme kapsamlarının listesini temsil eder. Bu değerler, en fazla 50 karakter uzunluğunda dizeler olmalıdır.
  • max_event_states (isteğe bağlı): Bir API çağıranın sonraki tüm etkinlik kaynağı kayıtlarında kullanmayı planladığı maksimum etkinlik durumu sayısını temsil eder. Aynı raporlama kaynağı ve hedefi ancak farklı bir max_event_states value değerine sahip olan kayıtlı 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 Attribution-Reporting-Register-Trigger başlığına isteğe bağlı bir parametre attribution_scopes eklenir. Parametre değerinin, tetikleyicinin kapsamlarını temsil eden bir dize listesi olduğundan emin olun. Tetikleyici yalnızca attribution_scopes değerleri parametresi, belirtilen tetikleyicinin attribution_scopes parametrelerinden en az birini içeren kaynaklarla eşleşir.

Tetikleyici kayıt ö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 kaynağa ilişkilendirildiği durum gösterilmektedir.

Kaynak kaydı #1

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

Kaynak kaydı #2

  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 ve attribution_scopes değerleri tetikleyici kaydındaki değerlerle kesişen kaynakları seçer. Eşleşen kaynak kayıtları, ilişkilendirme akışının geri kalanıyla devam eder. Bu örnekte, API çağıran, tetikleyici kaydını ilk kaynak kaydıyla ilişkilendiren bir ilişkilendirme raporu alır.

İlişkilendirme kapsamları ve filtreler

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

Aşağıdaki resimde, aynı hedef siteye, raporlama kaynağına sahip ve süresi dolmamış bir grup kaynak ve tetikleyici gösterilmektedir. İlişkilendirme kapsamlarının ve filtrelerinin nasıl kullanıldığı ve mevcut kaynaklara ve tetikleyicilere göre bir rapor oluşturulup oluşturulmayacağı hakkında kısaca konuşacağız.

<img "activewear"="" "attribution="" "casualwear"="" "casualwear",="" "outerwear"="" "outerwear".="" "outerwear"."="" #1".the="" 1.="" 2.="" alt="1 ile 4 arasında numaralandırılmış kaynaklar etiketli 4 kutu ve " and="" attributes="" filter:="" first="" following="" fourth="" has="" priority:="" scope":="" second="" source="" src="/static/assets/images/attribution-scopes-example-1.png" the="" third="" title="İlişkilendirmenin ilişkilendirme kapsamları ve filtrelerle nasıl çalıştığına dair örnek" trigger="" />

İlişkilendirmeden önce

  • İlişkilendirme kapsamı tetikleyicinin casualwear kapsamıyla eşleşmediği için 1. kaynak filtrelenir. Mevcut tüm kaynaklar arasında en yüksek önceliğe sahip olmak, öncelikler kontrol edilmeden önce ilişkilendirme öncesi filtreleme yapıldığı için ilgili kaynağın filtrelenmesini engellemez.
  • 2. kaynak, tetikleyiciyle aynı kapsama sahip olmadığı için de filtrelenir. Bu kaynak da tetikleyiciyle aynı filtreye sahiptir ancak üst düzey filtreler ilişkilendirmeden sonra uygulanır.

İlişkilendirme sırasında

  • 4. kaynaktan daha düşük önceliğe sahip olduğu için 3. kaynak 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üzey filtreler, ilişkilendirme işlemi sırasında dikkate alınmamaları için ilişkilendirme sonrası uygulanır.

Yayın ilişkilendirmesi

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

Önceki örnek, rapor oluşturulmasına neden olmaz. Ancak dördüncü kaynak tamamen kaldırılırsa:

1 ile 4 arasında numaralandırılmış 4 kutu ve

İlişkilendirme sırasında

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

Yayın ilişkilendirmesi

  • 3. kaynak, filtresi tetikleyicideki filtreyle kesiştiği için reddedilmez. İlişkilendirme, 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 kaynak sayısını azaltır. Ardından, kalan ilişkilendirme adımları bu daha küçük kaynak havuzuna uygulanır ve bir rapor oluşturulabilir.

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

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

<img "attribution="" "attribution",="" "deactivation="" "filters="" "report="" "source="" "trigger="" alt="Her adımın bir okla sonraki adıma bağlı bir kare olarak gösterildiği, ilişkilendirme akışının basitleştirilmiş bir sürümünü gösteren resim. Adımlar sırasıyla " and="" check",="" checks"="" generation"."="" matching",="" of="" other="" registration",="" scopes="" source="" sources",="" src="/static/assets/images/attribution-scopes-attribution-flow.png" title="Basitleştirilmiş ilişkilendirme akış şeması" />

İlişkilendirme akışı işlemleri

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

  • Kaynak kaydı: Kullanıcı, reklamverenin sitesindeki bir reklamla etkileşime geçtiğinde 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ık ile yanıt verir.
  • Tetikleyici kaydı: Reklamverenin sitesinde bir dönüşüm gerçekleştiğinde bir tetikleyici etkinliği kaydedilir. Cihaz, raporlama kaynağına başka bir istek gönderir. Bu istek, tetikleyici etkinlik verilerini içeren bir üstbilgeyle yanıtlanır.
  • Kaynak eşleştirme: Cihaz, kaynak ve tetikleyici etkinlikleri hedef site, raporlama kaynağı ve geçerlilik süresi gibi ölçütlere göre eşleştirir.
  • İlişkilendirme kapsamları kontrolü: Kaynaklar, source ve trigger 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 eklenen seçilir.
  • Filtre kontrolü: Cihaz, eşleşip eşleşmediklerini belirlemek için kaynak ve tetikleyici filtreleri karşılaştırır. Filtreler eşleşmezse ilişkilendirme atlanı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şkilendirmeyle ilgili daha fazla kontrol gerçekleştirir. Örneğin, kaynağın sahte raporlarla kirlenip kirlenmediğini, tekilleştirme anahtarları kullanılarak yinelenen ilişkilendirmeleri, tetikleyicinin kaynağın raporlama aralığına düşüp düşmediğini ve ücret sınırlarını kontrol eder.
  • Rapor oluşturma: Tüm kontroller geçerse cihaz, raporlama kaynağının uç noktasına gönderilecek bir ilişkilendirme raporu oluşturur ve planlar.

Sonraki adımlar