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

Dönüşüm ilişkilendirme ölçümünde yayıncı, reklamveren, reklam sunma teknolojisi (reklamı yayınlayan varlık), ölçüm sağlayıcısı ve daha fazlası gibi birçok taraf bulunabilir. Bu belgede, sık karşılaşılan dönüşüm ölçümü senaryoları açıklanmaktadır. Ancak genel olarak, Attribution Reporting API'den (ARA) ilişkilendirme raporu almak isteyen tüm taraflar, bu belgede açıklanan entegrasyon adımlarının uygulanmasını sağlamalıdır.

Örneğin, bir yayıncının reklamı yayınlamaktan sorumlu bir veya daha fazla reklam teknisyeni olması yaygın bir durumdur. Buna, reklam öğesinin işaretlemesini sağlamaktan sorumlu taraflar, reklam öğesinde gösterim veya izleme pikselini sağlayan taraflar ve yayıncı sayfasındaki reklam alanı için SDK veya etiket sağlayan taraflar dahil olabilir. Bu reklam teknolojileri ARA'dan ilişkilendirme raporları almak isteyebilir veya istemeyebilir, ancak satışa dönük reklam tekniklerinin ilişkilendirme raporları alabilmesini sağlayacak şekilde konumlandırılırlar.

Ayrıca reklamveren, diğer raporlama özelliklerinin yanı sıra ağlar arası ilişkilendirme için üçüncü taraf bir dönüşüm ölçümü sağlayıcısı da kullanıyor olabilir. Reklamverenler bu verileri, birden çok benzersiz yayıncı ve kanaldaki reklam yatırımı 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'nin nasıl etkinleştirileceğini anlaması önemlidir. Üçüncü tarafları kullanmak isteyen reklamverenler, üçüncü taraf ölçüm sağlayıcısı kullanarak veya API'den raporları kaydetmek ve almak için şirket içi bir sunucu oluşturarak bunu yapmaya devam edebilirler.

Attribution Reporting API, birden fazla reklam teknisyeninin 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ı almanın yanı sıra, reklamverenin üçüncü taraf ölçüm sağlayıcısı için ayrı raporlamaya da izin verebilir. Reklam teknolojisinin, API'den rapor alabilmesi için hem ilişkilendirme kaynaklarını hem de tetikleyicileri kaydetmesi gerekir. İlişkilendirme, reklam teknolojisinin API'ye ayrı olarak kaydettiği ilişkilendirme kaynakları ve tetikleyicileri arasında yapılır.

Dönüşüm ölçümüyle ilgili sık karşılaşılan 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 sunan hem de üçüncü taraf ölçüm sağlayıcısının Attribution Reporting API'den rapor alması gerekir

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

Bu durumda reklam sunma teknolojisi, geçerli ayarlarda tıklama ve gösterim etkinliklerini tetiklemekten sorumlu olan taraftır. Reklam sunma 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 reklam yayınlama teknolojisinin hem de üçüncü taraf ölçüm sağlayıcısının kaydolduğundan ve sunucularının Attribution Reporting API isteklerini almaya ve yanıtlamaya hazır olduğundan emin olması gerekir.

Tipik bir kampanya kurulumu şöyle görünebilir:

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

2. TTP, ek ölçüm gösterimi ve tıklama izleme pikselleri ekleme özellikleri sunar ve attributionsrc öğesinin teklif vermek için kullandığı nihai reklam öğesi işaretlemesine eklendiğinden emin olmalıdır.

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

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ü gereksinimi yok. Bu durum, reklam öğelerini barındıran ve ilişkilendirme raporlamasını kullanmayı planlamayan, ancak Attribution Reporting API'yi TTP iş ortakları ya da üçüncü taraf reklam sunucuları, ölçüm veya analiz sağlayıcıları gibi ölçüm etiketleme şirketleri için 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 beklendiği 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, sunum yapan reklam teknolojisi veya yayıncının kendisi olabilir. Gösterim etkinlikleri için bu genellikle üçüncü taraf ölçüm sağlayıcısıdır.

1. Senaryodaki tipik kampanya kurulumu örneğinde, yayıncı reklam sunucusu, STP veya yayıncının kendisi, TTP tarafından sağlanan attributionsrc özelliğinin yayıncı sayfasına ulaştığından emin olmalıdır.

Uygulama ayrıntıları

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

Uygulanacak adımlar	Çalışma sorumluluğu	Örnekler
1. Adım: Mevcut reklam öğeleri ve ölçüm kodu için ilişkilendirme kaynağını etkinleştirin	Gösterim etkinliklerini tetiklemek veya tıklama etkinliklerini yönetmekten sorumlu varlık, attributionsrc özelliğini ekler.	Tıklama etkinlikleri için genellikle bu özelliği reklam öğesini oluşturan bir alıcı (TTP/reklamveren reklam sunucusu) ekler. Gösterim etkinliklerinde bu özellik, yayıncının ayarlarına bağlı olarak talep tarafı platformu (TTP), arz tarafı platformu (STP), yayıncı, reklam sunucusu veya ölçüm sağlayıcısı tarafından eklenir. VAST biçimini kullanan video reklamlarda bu özelliği yayıncı ve video SDK'sı ekler.
2. Adım: Üçüncü taraf kaynaklar için İlişkilendirme Raporlama özelliğini etkinleştirin	Bu, 302 yönlendirmeleriyle mevcut bir yönlendirme yolu kullanılıyorsa kullanıma hazır olarak ç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önlendirmelerinin Attribution Reporting API çağrılarını alması gerekir.
3. Adım: Attribution Reporting API istekleri için yanıtları ayarlama	Attribution Reporting API'den rapor almak isteyen herhangi bir tüzel kişi	Reklamveren tarafından kullanılan TTP ve üçüncü taraf ölçüm sağlayıcısı

Her bir adımın ayrıntılarının, reklam öğelerinin yayıncı sayfasında nasıl oluşturulduğuna ve yayınlandığına 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ı, kendisinin kaydolduğundan ve sunucularının Attribution Reporting API isteklerini almaya ve yanıtlamaya hazır olduğundan emin olmalıdır.

1. Adım: Mevcut reklam öğeleri ve ölçüm kodu için ilişkilendirme kaynağını 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 tetiklemeden sorumlu olan varlık, attributionsrc özelliğine sahip reklam öğelerini güncellemelidir. attributionsrc, mevcut tıklama ve gösterim etkinliklerine eklenmelidir ve boş olabilir veya boş olamaz.

Yönlendirme kullanılan tıklama etkinlikleri için attributionsrc özelliği gezinme bölümüne eklenmelidir. Gezinmeden sonraki 302 yönlendirmelerinin attributionsrc özelliğini eklemesine gerek yoktur ve ilk gezinme bölmesinde attributionsrc eklendiği sürece ARA için uygun olur.

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

Genel olarak, tıklama URL'sini barındıran sunucu Attribution Reporting API isteklerini alabiliyor ve 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 entegrasyonu ile
<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ği tarafından tanımlanan URL'ye gönderilir.

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

Mevcut kurulumunuz	ARA entegrasyonu ile
<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 kaynakları 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 kullanılan 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ınlayan reklam teknolojisi ve ölçüm sağlayıcılarıdır.
  • <img> etiketi veya <script> etiketi tarafından tetiklenen gösterim etkinlikleri bir attributionsrc özelliği içermelidir.
  • Fetch API'yi 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 etkinliklerinde gerekli 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

Korunan Kitle açık artırmalarındaki dönüşümleri ölçmek için attributionsrc kullanmak yerine registerAdBeacon/registerAdMacro ve setReportEventDataForAutomaticBeacons/reportEvent araçlarını kullanarak ilişkilendirme kaynaklarını kaydedebilirsiniz.

Korunan Kitle sinyallerini raporlamak için registerAdBeacon işlevi raporlama iş akışlarının içinde, registerAdMacro ise alıcının kazanma raporlama iş akışında yer alır. Ardından 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. Bu işlem, Protected Audience raporlama iş parçalarının sinyallerinin ve reklam öğesi kare etkinlik yükünün birbiriyle ilişkilendirilmesine olanak tanır.

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

Not: Fenced Frame Ads Reporting API hem iframe hem de sınırlı çerçevede kullanılabilir.

Daha ayrıntılı bilgi için Sınırlanmış Çerçeve Reklam Raporlama API'sı açıklayıcısının İlişkilendirme Raporları Desteği 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 yaygın olarak kullanılan bir biçimdir. Bu standartta tanımlanan etkinliklerin birçoğu, Attribution Reporting API'ye kayıt için uygun potansiyel kaynak etkinlikleri olarak kabul edilmelidir. İlişkilendirme Raporlama Desteği için VAST Eki bu konuyu ayrıntılı olarak ele alır. Ancak kısaca tüm <Tracking>, <Impression>, <*ClickThrough> ve <*ClickTracking> etkinlikleri, potansiyel ilişkilendirme kaynağı etkinlikleridir. Tüm VAST uygulamaları, bu etkinlikler için kayıt uygunluğu kapsamı sağlamalıdır.

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

Maksimum kapsam sağlamak için VAST uygulamaları, etkinlik ping'lerini tetiklerken listelenen tüm etkinlikleri varsayılan olarak uygun kayıtlara uygun hale getirmelidir. Örneğin, bir <Impression> etkinlik URL'si etkinleştirilirken, alıcı tarafın bu etkinliği Attribution Reporting API'ye kaydedebilmesine olanak tanımak amacıyla, isteği (veya getirme çağrısındaki eşdeğerini) göndermek için kullanılan <img> öğesinde (boş) attributionsrc özelliği kullanılmalıdır.

2. Adım: Üçüncü taraf kaynaklar için İlişkilendirme Raporlama özelliğini etkinleştirin

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

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

Tipik bir reklam tıklamasında, birçok tıklama izleyici, nihai açılış sayfasına gitme sürecinin parçası olarak yapılan 302 yönlendirmelerinden oluşan bir zincir olarak mevcut olabilir. Orijinal tıklama hedefine attributionsrc ile not eklenmişse veya Protected Audience API'de registerAdBeacon/registerAdMacro ile kaydedilmişse yönlendirme zincirindeki her istek 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. Korunan Kitle açık artırmalarında, reportEvent ağına iletilen eventData ve setReportEventDataForAutomaticBeacons yönlendirmenin bir parçası olarak kullanılması gerekiyorsa 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ı varlık olarak bir reklam sunma teknolojisi (serving-adtech.example) ve üçüncü taraf ölçüm sağlayıcısı (3p-measurement.example) kullanacağız. Bu örnekte reklam sunma teknolojisi, reklam öğesini yayıncı sitesinde oluşturan ve kendi raporlama ürününe sahip 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ştirilir:

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

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

Birden fazla bildiren kaynak, bir gezinme etkinliğine kaynak kaydetmek istiyor ancak herhangi bir nedenle yönlendirme zincirinde görünmüyorsa alternatif çözüm olarak attributionsrc sayfasında birden çok siteyi ilişkilendirme kaynağı olarak listeleyebilirsiniz.

Mevcut kurulumunuz	ARA modifikasyonu ile
<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 adreslerine gönderilecektir. 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 kaybolabilir.

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

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 rehberine ve açıklayıcıya bakın.

Birden fazla tetikleyici kaydetme

Dönüşüm tarafına birden fazla piksel öğesi (tetikleyici başına bir adet) 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 çok URL listeleyerek tek bir piksel öğesinden birden fazla tetikleyici kaydedebilirsiniz. Aynı kaynaklardan oluşturulan kaynak etkinlikleri ve tetikleyici etkinlikleri eşleştirilir.