Dönüşüm ölçümünü etkinleştir

Dönüşüm ilişkilendirme ölçümünde yayıncı, reklamveren, reklam teknolojisinin (reklamı yayınlayan varlık) yayınlanması ve ölçüm sağlayıcısı gibi birçok taraf yer alabilir. Bu belgede, sık karşılaşılan dönüşüm ölçümü senaryoları gösterilmiştir. Ancak genel olarak, Attribution Reporting API (ARA)'dan ilişkilendirme raporu almak isteyen taraflar, bu belgede açıklanan entegrasyon adımlarının uygulandığından emin olmalıdır.

Örneğin, bir yayıncının reklamı sunmaktan bir veya daha fazla reklam teknisyeni sorumlu olması yaygın bir durumdur. Buna, reklam öğesinin işaretlemesini sağlamaktan sorumlu taraflar, reklam öğesi üzerindeki gösterimi veya izleme pikselini sağlayan taraflar ve yayıncı sayfasındaki reklam alanı için SDK'yı veya etiketi sağlayan taraflar dahil olabilir. Bu reklam teknolojileri, ARA'dan ilişkilendirme raporları almak isteyebilir veya istemeyebilir, ancak aşağı akış reklam teknolojilerinin ilişkilendirme raporlarını alabilmesini sağlayacak konumdadır.

Ayrıca reklamveren, diğer raporlama özelliklerinin yanı sıra ağlar arası ilişkilendirme için üçüncü taraf dönüşüm ölçümü sağlayıcısı kullanıyor olabilir. Reklamverenler bu verileri, birden fazla benzersiz yayıncı ve kanalda reklam yatırımlarının getirisini anlamak için kullanır. Bu nedenle, TTP'lerin veya reklam sunucularının, bu kullanım alanlarını desteklemek için Attribution Reporting API'yi nasıl etkinleştireceklerini anlaması önemlidir. Üçüncü taraf reklam kullanmak isteyen reklamverenler, üçüncü taraf ölçüm sağlayıcısı kullanarak veya API'den rapor kaydedip almak için şirket içi bir sunucu oluşturarak bu işlemi yapmaya devam edebilir.

Attribution Reporting API, birden fazla reklam teknolojisinin aynı gösterim veya dönüşüm için ilişkilendirme kaynaklarını ve tetikleyicilerini kaydetmesine ve API'den ayrı raporlar almasına olanak tanır. Örneğin, bir TTP, Attribution Reporting API'den kendi ilişkilendirme raporlarını alabilir ve reklamverenin üçüncü taraf ölçüm sağlayıcısı için ayrı bir raporlamaya olanak tanıyabilir. Bir reklam teknolojisinin, API'den rapor alabilmesi için hem ilişkilendirme kaynaklarını hem tetikleyicileri kaydetmesi gerekir. İlişkilendirme, ilişkilendirme kaynakları ve reklam teknolojisinin API'ye ayrı ayrı kaydettirdiği tetikleyiciler arasında yapılır.

Sık karşılaşılan dönüşüm ölçümü senaryoları

Bu bölümde, dönüşüm ölçümü için sık karşılaşılan iki senaryoyu inceleyeceğiz.

1. Senaryo: Hem reklam teknolojisi yayınlama hem de üçüncü taraf ölçüm sağlayıcısının Attribution Reporting API'den rapor alması gerekir

Bir reklamveren, üçüncü taraf bir ölçüm sağlayıcısı kullanarak reklam envanterindeki dönüşümleri ilişkilendirmek istiyor. Reklam öğesini barındıran reklam teknolojisi, dönüşümleri reklam envanterindeki dönüşümleri ilişkilendirmek istiyor. Bu, reklam öğeleri için işaretleme sağlayan, kendi ilişkilendirme raporlarını gerçekleştiren ve üçüncü taraf ölçüm veya analiz sağlayıcılarıyla entegrasyon yapan reklamverenlerle çalışan TTP'ler veya reklamveren reklam sunucuları (üçüncü taraf reklam sunucusu — 3PAS) için yaygındır.

Bu durumda, reklam yayınlama teknolojisi, aynı zamanda geçerli kurulumda tıklama ve gösterim etkinliklerini tetiklemekten sorumlu olan taraftır. Yayınlanan reklam teknolojisi, yeni attributionsrc öğesini uygun konumlara ayarlamalı ve yönlendirmelerin doğru şekilde yapılandırıldığından emin olmalıdır. Ayrıca hem yayınlanan reklam teknolojisi hem de üçüncü taraf ölçüm sağlayıcısı, bu kişilerin kayıtlı ve sunucularının Attribution Reporting API isteklerini alıp yanıtlamaya hazır olduğundan emin olmalıdır.

Tipik bir kampanya kurulumu aşağıdaki gibi görünebilir:

1. Reklamveren reklam sunucusu (3PAS), reklam öğesi için işaretlemeyi TTP'ye sağlar. Bu işaretleme, üçüncü taraf ölçüm sağlayıcısının gösterim ve tıklama izleme piksellerini içerir. Reklam sunucusu, attributionsrc öğesinin reklam öğesi işaretlemesine dahil edilmesini sağlamalıdır.

2. TTP, ek ölçüm gösterimi ve tıklama izleme pikselleri ekleme özellikleri sunar. Ayrıca, attributionsrc ürününün teklif verdiği nihai reklam öğesi işaretlemesine dahil edildiğinden emin olmalıdır.

2. Senaryo: Attribution Reporting API'den yalnızca üçüncü taraf ölçüm sağlayıcısının rapor alması gerekir.

Bir reklamveren, üçüncü taraf ölçüm sağlayıcısı kullanarak reklam envanterindeki dönüşümleri ilişkilendirmek istiyor ancak reklam öğesini barındıran reklam teknolojisinin ilişkilendirme ölçümü şartı yok. Bu durum, reklam öğelerini barındıran ve ilişkilendirme raporlamasını kendileri kullanmayı planlamayan ancak TTP iş ortakları ya da üçüncü taraf reklam sunucuları, ölçüm veya analiz sağlayıcıları gibi ölçüm etiketleme şirketleri için Attribution Reporting API'yi etkinleştirmek isteyen yayıncılar, STP'ler veya yayıncı reklam sunucuları için yaygın bir durumdur.

Bu durumda, mevcut kurulumda tıklama ve gösterim etkinliklerini tetiklemekten sorumlu olan tarafın, reklam öğelerine yeni attributionsrc özelliğini eklemesi ve yönlendirmelerin amaçlandığı gibi çalıştığından emin olması gerekir. Bu büyük ölçüde her yayıncının entegrasyonuna bağlıdır ancak tıklama etkinlikleri için bu STP, reklam teknolojisi sunan veya yayıncının kendisi olabilir. Bu, daha çok gösterim etkinlikleri için üçüncü taraf ölçüm sağlayıcısıdır.

1. Senaryo'daki tipik kampanya kurulumu örneğinde yayıncı reklam sunucusunun, STP'nin veya yayıncının, TTP tarafından sağlanan attributionsrc özelliğinin yayıncı sayfasına ulaştığından emin olması gerekebilir.

Uygulama ayrıntıları

Aşağıdaki tabloda, Attribution Reporting API uygulama adımları genel olarak açıklanmaktadır:

Uygulanacak adımlar	İşin sorumluluğu	Örnekler
1. adım: İlişkilendirme kaynağını mevcut reklam öğeleri ve ölçüm kodu için etkinleştirin	Gösterim etkinliklerini tetiklemekten veya tıklama etkinliklerini yönetmekten sorumlu varlık attributionsrc özelliğini ekler.	Tıklama etkinliklerinde, genellikle reklam öğesini oluşturan bir alıcı (TTP/reklamveren reklam sunucusu) bu özelliği ekler. Gösterim etkinlikleri için talep tarafı platformu (TTP), arz tarafı platformu (STP), yayıncı, reklam sunucusu veya ölçüm sağlayıcısı bu özelliği ekler ve bu, yayıncının kurulumuna bağlıdır. VAST biçimini kullanan video reklamlar için yayıncı ve video SDK'sı özelliği ekler.
2. Adım: Üçüncü taraf kaynaklar için İlişkilendirme raporlamasını etkinleştirin	Bu, 302 yönlendirmeleri içeren mevcut bir yönlendirme yolu kullanılıyorsa anında çalışır. 302 yönlendirmeleri kullanılamıyorsa birden fazla reklam teknolojisi sunucusunu listelemek için attributionsrc özelliği kullanılabilir.	Genel olarak, attributionsrc özelliği reklam öğesine eklendiği sürece üçüncü taraf yönlendirmeleri, Attribution Reporting API çağrılarını almalıdır.
3. Adım: Attribution Reporting API istekleri için yanıtları ayarlayın	Attribution Reporting API'den rapor almak isteyen tüm tüzel kişiler	Reklamveren tarafından kullanılan TTP ve üçüncü taraf ölçüm sağlayıcısı

Her adımla ilgili ayrıntıların, reklam öğelerinin nasıl oluşturulduğu ve yayıncı sayfasında nasıl sunulduğuna ve hangi reklam teknolojisi varlıklarının Attribution Reporting API tarafından gönderilen raporları aldığına bağlı olduğunu unutmayın.

Önemli: Üçüncü taraf ölçüm sağlayıcısı, kayıtlı ve sunucularının Attribution Reporting API isteklerini alıp yanıtlamaya hazır olduğundan emin olmalıdır.

1. adım: İlişkilendirme kaynağını mevcut reklam öğeleri ve ölçüm kodu için etkinleştirin

İlk adımda ilişkilendirme kaynakları etkinleştirilir.

attributionsrc özelliğinin işleyiş şekli

Yeni attributionsrc özelliği, Attribution Reporting API isteklerinin nereye gönderileceğini belirtir. Gösterim ve tıklama etkinliklerini tetiklemekten sorumlu olan öğe, reklam öğelerini attributionsrc özelliğiyle güncellemelidir. attributionsrc, mevcut tıklama ve gösterim etkinliklerine eklenmelidir ve boş olamaz.

Yönlendirmelerin kullanıldığı tıklama etkinlikleri için gezinmeye attributionsrc özelliği eklenmelidir. Gezinmeden sonraki 302 yönlendirmelerinin attributionsrc özelliğini eklemesi gerekmez ve ilk gezinmeye attributionsrc eklendiği sürece ARA için uygundur.

attributionsrc boş olduğunda ARA istekleri, bağlantı etiketinin (tıklama URL'si) href özelliğinde tanımlanan URL'ye gönderilir. attributionsrc özelliği tanımlandığında ARA istekleri, attributionsrc özelliğinde tanımlanan URL'ye gönderilir. Tıklama URL'si de kaynak kaydetmek için uygundur.

Genellikle, tıklama URL'sini barındıran sunucu Attribution Reporting API isteklerini alıp yanıtlayabiliyorsa boş bir attributionsrc özelliği kullanın. Attribution Reporting API isteklerinin farklı bir sunucuya gitmesini istiyorsanız kendi attributionsrc URL'nizi tanımlayın.

Boş attributionsrc özelliği örneği:

Mevcut kurulumunuz	ARA entegrasyonlu
<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

attributionsrc özelliği boş olduğunda, Attribution Reporting API istekleri bağlantı etiketinin href özelliğiyle tanımlanan URL'ye gönderilir.

Boş olmayan bir attributionsrc özelliği örneği:

Mevcut kurulumunuz	ARA entegrasyonlu
<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

attributionsrc boş olmadığında Attribution Reporting API istekleri attributionsrc etiketi tarafından tanımlanan URL'ye gönderilir. Tıklama URL'si de kaynak kaydetmek için uygundur.

Tıklama ve gösterim etkinlikleri için attributionsrc ekleyin

• Tıklama etkinlikleri:
  • attributionsrc öğesinin eklenmesinden sorumlu tüzel kişi genellikle reklam yayınlama teknolojisidir.
  • Tıklama etkinlikleri olan bağlantı etiketlerine attributionsrc özelliği eklenmelidir.
  • window.open kullanan tıklamalar, ilişkilendirme kaynağını belirtmek için window.open çağrısının windowFeatures bağımsız değişkenini kullanmalıdır.
• Gösterim etkinlikleri:
  • attributionsrc öğesinin eklenmesinden sorumlu tüzel kişi genellikle reklam yayınlama teknolojisi ve ölçüm sağlayıcılarıdır.
  • <img> etiketi veya <script> etiketinden tetiklenen gösterim etkinlikleri attributionsrc özelliği içermelidir.
  • Getirme API'sini kullanan gösterim etkinlikleri, getirme API çağrısına iletilen options bağımsız değişkenine bir attributionReporting nesnesi içermelidir.

Tıklama ve gösterim etkinlikleri için gereken değişikliklerin özeti için aşağıdaki tabloya bakın:

Etkinlik	Etiket	Mevcut kurulumunuz	ARA entegrasyonundan sonra
Sonraki slayta geçin	HTML	<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
	JavaScript	window.open("[CLICKTHROUGH_URL]", "_blank");	window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Gösterim	HTML <img> etiketi	<img src="[IMPRESSION_URL]">	<img src="[IMPRESSION_URL]" attributionsrc>
	HTML <script> etiketi	<script src="[IMPRESSION_URL]"></script>	<script src="[IMPRESSION_URL]" attributionsrc></script>
	JavaScript	const options = {...} window.fetch("[IMPRESSION_URL]", options);	const options = {   attributionReporting: {     eventSourceEligible: true,     triggerEligible: false,   },   ... }; window.fetch("[IMPRESSION_URL]", options);

Protected Audience açık artırmasında ilişkilendirme kaynağı kaydını etkinleştirme

Protected Audience açık artırmalarında dönüşümleri ölçmek için attributionsrc yerine registerAdBeacon/registerAdMacro ve setReportEventDataForAutomaticBeacons/reportEvent seçeneklerini kullanarak ilişkilendirme kaynaklarını kaydetmeyi etkinleştirebilirsiniz.

Korunan Kitle sinyallerini raporlamak için registerAdBeacon işlevi, raporlama iş akışlarında bulunur. registerAdMacro ise alıcının kazanma raporlama iş akışında kullanılabilir. Daha sonra, reklam çerçevesi içindeki etkinlik verileri Fenced Frame Ads Reporting API'nin reportEvent ve setReportEventDataForAutomaticBeacons işlevleriyle kayıtlı işaretçilere ve makrolara eklenebilir. Böylece, Protected Audience raporlama iş akışlarına ait sinyaller ve reklam öğesi çerçevesi etkinlik yükü birbiriyle ilişkilendirilebilir.

Attribution-Reporting-Eligible HTTP üstbilgisi, işaretçiler ve makrolar bir çerçeveden reportEvent çağrısı ile tetiklendiğinde veya otomatik işaretçiler tarayıcı tarafından tetiklendiğinde isteğe eklenir. Bir ilişkilendirme kaynağı kaydetmek için işaretçinin yanıtını kullanabilirsiniz. İşaretçi istekleri, üçüncü taraf ölçüme izin verecek şekilde yönlendirilebilir.

Not: Fenced Frame Ads Reporting API hem iFrame hem de sınırlanmış çerçevede kullanılabilir.

Daha ayrıntılı bilgi için Fenced Frame Ad Reporting API açıklayıcısının Support for Attribution Reporting (İlişkilendirme Raporları için Destek) bölümüne bakın.

VAST biçimleri için ilişkilendirme raporlamasını etkinleştirme

VAST, video reklam envanterini yayınlamak ve ölçmek için kullanılan yaygın bir biçimdir. Bu standartta tanımlanan etkinliklerin çoğu, Attribution Reporting API'ye kaydedilmeye uygun potansiyel kaynak etkinlikleri olarak kabul edilmelidir. İlişkilendirme Raporlama Desteği için VAST Eki bu durumu ayrıntılı olarak ele alır. Ancak kısaca <Tracking>, <Impression>, <*ClickThrough> ve <*ClickTracking> etkinliklerinin tümü potansiyel ilişkilendirme kaynağı etkinlikleridir. Tüm VAST uygulamaları, bu etkinlikler için kayıt uygunluk kapsamını sağlamalıdır.

VAST eki, özellikle ilişkilendirme kaydı için ikincil bir URL ayarlanmasına olanak tanımak amacıyla bu öğeler için yeni özellikler tanımlar. Bir etkinlik attributiontype="DOUBLE_PING" ve attributionsrc="[URL]" içerdiğinde, bu etkinliği tetikleyen kod Attribution Reporting API etkinleştirilirken attributionsrc özelliğinin değeri olarak [URL]'yi kullanmalıdır. VAST eki her senaryo için örnekler içerir.

Maksimum kapsam sağlamak için, VAST uygulamaları, etkinlik ping'leri etkinleştirilirken listelenen tüm etkinliklerin varsayılan olarak kayda uygun olmasını sağlamalıdır. Örneğin, bir <Impression> etkinlik URL'si etkinleştirilirken alıcı tarafın etkinliği Attribution Reporting API'ye kaydetmesine her zaman izin vermek amacıyla isteği (veya getirme çağrısındaki eşdeğerini) göndermek amacıyla kullanılan <img> öğesinde (boş) attributionsrc özelliği kullanılmalıdır.

2. Adım: Üçüncü taraf kaynaklar için İlişkilendirme raporlamasını etkinleştirin

Üçüncü tarafların Attribution Reporting API'yi kullanmasına izin vermek için mevcut yönlendirmeleri kullanabilir veya attributionsrc özelliğine üçüncü tarafların listesini ekleyebilirsiniz. Çoğu durumda, her reklam teknolojisinin kendi bağımsız gösterim izleyicisi vardır. Bu nedenle, yönlendirmeler tıklama izleyiciler için daha alakalıdır.

Mevcut bir yönlendirme zincirindeki üçüncü taraf kaynakları işleyin

Tipik bir reklam tıklamasında çok sayıda tıklama izleyici, nihai açılış sayfasına yapılan gezinmenin parçası olarak yapılan 302 yönlendirmelerinden oluşan bir zincir olarak bulunabilir. Yönlendirme zincirindeki her istek, orijinal tıklama hedefine attributionsrc ile ek açıklama eklenmişse veya Protected Audience API'de registerAdBeacon/registerAdMacro ile kaydedilmişse Attribution Reporting API'ye kaydedilmeye uygundur. Yönlendirme zincirindeki reklam teknolojisi de kayıtlı olmalıdır.

İlk isteğin gövdesinin yönlendirmelerde gönderilmediğini unutmayın. Protected Audience açık artırmalarında, eventData parametresi reportEvent bölümüne iletildiyse ve setReportEventDataForAutomaticBeacons yönlendirmenin yönlendirmenin bir parçası olarak kullanılması gerekiyorsa bu değer, yönlendirme URL'sinin bir parçası olarak açıkça iletilmelidir.

Aşağıdaki örnekte, ilişkilendirme raporları oluşturmak ve almak isteyen iki farklı tüzel kişi olarak bir reklam sunma reklam teknolojisi (serving-adtech.example) ve bir üçüncü taraf ölçüm sağlayıcısı (3p-measurement.example) kullanılacaktır. Bu örnekte, reklam yayınlama teknolojisi, reklam öğesini yayıncı sitesinde oluşturan ve kendi raporlama ürününe sahip olan bir TTP olabilir. Üçüncü taraf ölçüm sağlayıcısı, reklamverenin dönüşüm raporlaması için kullandığı bir tüzel kişi olabilir.

Kaynak kayıt sırasında aşağıdaki adımlar gerçekleşir:

1. serving-adtech.example, reklam öğesindeki attributionsrc özelliğini ayarlar. Kullanıcı, yayıncı sayfasını ziyaret eder ve tarayıcı, serving-adtech.example. adresine bir istek gönderir.
2. serving-adtech.example, Attribution-Reporting-Register-Source başlığı ve Location başlığıyla yanıt verir.
   1. serving-adtech.example, kaydedilecek kaynakla ilgili meta verilerle yanıt vermek için Attribution-Reporting-Register-Source başlığını kullanır.
   2. serving-adtech.example, 3p-measurement.example öğesine yönlendirme eklemek için Location üstbilgisini kullanır. Bir üçüncü tarafa yapılan 302 yönlendirmelerini desteklemek için Location başlığının mevcut tıklama izleme akışlarınızda zaten kullanılıyor olabileceğini unutmayın.
3. Tarayıcı, serving-adtech.example kaynağından yanıtı alır ve Attribution-Reporting-Register-Source üstbilgisini ayrıştırır. Tarayıcı, kaynak etkinliği depolar ve raporlama kaynağı olarak serving-adtech.example kullanılır.
4. Bu istek bir yönlendirme olduğundan tarayıcı 3p-measurement.example alanına yeni bir istekte de bulunur.
5. 3p-measurement.example, Attribution-Reporting-Register-Source başlığını içeren bir yanıtla yanıt verir.
6. Tarayıcı, bu yanıtı 3p-measurement.example ürününden alır ve Attribution-Reporting-Register-Source metnini okur. Tarayıcı, kaynak etkinliği depolar ve raporlama kaynağı olarak 3p-measurement.example kullanılır.

Yönlendirme zincirinde bulunmayan üçüncü taraf kaynaklar için attributionsrc kullanın

Birden fazla raporlayıcı kaynak, bir gezinme etkinliğine kaynak kaydetmek istiyor ancak herhangi bir nedenle bir yönlendirme zincirinde gösterilemiyorsa alternatif çözüm olarak attributionsrc içinde birden çok siteyi ilişkilendirme kaynağı olarak listeleyebilirsiniz.

Mevcut kurulumunuz	ARA değişikliğiyle
<a href="[CLICKTHROUGH_URL]">...</a>	<a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

Bu örnekte, Attribution Reporting API'ye uygun istekler hem REPORTING_URL_1 hem de REPORTING_URL_2. Tıklama URL'sine gönderilen gezinme isteği, ilişkilendirme kaynaklarını kaydetmek için de uygundur.

Uyarı: Bu istekler yalnızca Attribution Reporting API'yi destekleyen tarayıcılarda gönderilir ve desteklenmeyen ortamlarda istekler kaybolabilir.

3. Adım: Attribution Reporting API istekleri için yanıtları ayarlayın

Attribution Reporting API isteği alan tüm kaynaklar için sunucunun uygun Attribution-Reporting-Register-Source başlığıyla yanıt verdiğinden emin olun. Yanıtın nasıl oluşturulması gerektiğini öğrenmek için Kaynakları kaydetme kılavuzuna ve açıklayıcıya bakın.

Birden çok tetikleyici kaydedin

Dönüşüm tarafına birden fazla piksel öğesi (tetikleyici başına bir tane) ekleyerek birden fazla ilişkilendirme tetikleyicisi kaydedebilirsiniz. attributionsrc öğesi, tetikleyici kaydı için isteğe bağlıdır.

Ayrıca, yönlendirme isteklerini kullanarak veya kaynak kaydında olduğu gibi attributionsrc öğesinde birden fazla URL'yi listeleyerek tek bir piksel öğesinden birden fazla tetikleyici kaydedebilirsiniz. Aynı kaynaklar tarafından oluşturulan kaynak etkinlikler ve tetikleyici etkinlikler eşleştirilir.