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

Dönüşüm ilişkilendirme ölçümü; yayıncı, reklamveren, reklam teknolojisi sunan (reklamı yayınlayan tüzel kişi), ölçüm sağlayıcı ve daha fazlası gibi birden fazla tarafı içerebilir. Bu dokümanda yaygın dönüşüm ölçümü senaryolarını açıklıyoruz ancak genel olarak Attribution Reporting API (ARA)'den ilişkilendirme raporu almak isteyen tüm tarafların bu dokümanda açıklanan entegrasyon adımlarının uygulandığından emin olması gerekir.

Örneğin, bir yayıncının reklamı yayınlamaktan sorumlu bir veya daha fazla reklam teknolojisine sahip olması yaygındır. Bu, reklam öğesi için işaretlemeyi sağlayan taraflar, reklam öğesindeki gösterimi veya izleme pikselini sağlayan taraflar ve yayıncı sayfasındaki reklam alanı için SDK'yı veya etiketi sağlayan tarafları içerebilir. Bu reklam teknolojileri, ARA'dan ilişkilendirme raporları almak isteyebilir veya istemeyebilir ancak aşağı akış reklam teknolojilerinin ilişkilendirme raporları alabilmesini sağlayacak şekilde konumlandırılmıştır.

Ayrıca reklamveren, ağlar arası ilişkilendirme ve diğer raporlama özellikleri için üçüncü taraf dönüşüm ölçüm sağlayıcı da kullanıyor olabilir. Reklamverenler, birden fazla benzersiz yayıncı ve kanalda reklam yatırımından elde edilen geliri anlamak için bu verileri kullanır. Bu nedenle, DSP'lerin veya reklam sunucularının bu kullanım alanlarını desteklemek için Attribution Reporting API'yi nasıl etkinleştireceğini bilmesi önemlidir. Üçüncü taraf kullanmak isteyen reklamverenler, üçüncü taraf ölçüm sağlayıcı kullanarak veya API'den rapor kaydedip almak için şirket içi bir sunucu oluşturarak bunu yapmaya devam edebilir.

Attribution Reporting API, birden fazla reklam teknolojisinin aynı gösterim veya dönüşüm için ilişkilendirme kaynaklarını ve tetikleyicileri kaydettirmesine 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ı raporlamaya izin verebilir. Bir reklam teknolojisinin API'den rapor almak için hem ilişkilendirme kaynaklarını hem de tetikleyicileri kaydettirmesi gerekir. İlişkilendirme, reklam teknolojisinin API'ye tek tek kaydettiği ilişkilendirme kaynakları ve 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 yaygın olan iki senaryoyu inceleyeceğiz.

1. senaryo: Hem reklam teknolojisini sunan hem de üçüncü taraf ölçüm sağlayıcının Attribution Reporting API'den rapor alması gerekir

Reklamveren, üçüncü taraf ölçüm sağlayıcı kullanarak reklam envanterinde dönüşümleri ilişkilendirmek istiyor ve reklam öğesini barındıran reklam teknolojisi, reklam envanterinde dönüşümleri ilişkilendirmek istiyor. Bu durum, reklam öğeleri için işaretlemeyi sağlayan, kendi ilişkilendirme raporlarını oluşturan ve üçüncü taraf ölçüm veya analiz sağlayıcılarla entegre olan reklamverenlerle çalışan DSP'ler ya da reklamveren reklam sunucuları (üçüncü taraf reklam sunucusu - 3PAS) için yaygındır.

Bu durumda, reklam teknolojisi sunan taraf, mevcut kurulumda tıklama ve gösterim etkinliklerini tetiklemekten de sorumludur. Reklam teknolojisi sunma işlemi, 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 teknolojisi sunan hem de üçüncü taraf ölçüm sağlayıcı, kaydoldukları ve sunucularının Attribution Reporting API isteklerini alıp yanıtlamaya hazır olduğundan emin olmalıdır.

Tipik bir kampanya ayarı şöyle görünebilir:

  1. Reklamveren reklam sunucusu (3PAS), reklam öğesinin işaretlemesini DSP'ye sağlar. Bu işaretleme, üçüncü taraf ölçüm sağlayıcının gösterim ve tıklama izleme piksellerini içerir. Reklam sunucusu, attributionsrc değerinin reklam öğesi işaretçisine dahil edildiğinden emin olmalıdır.

  2. TTP, ek ölçüm gösterimi ve tıklama izleme pikseli ekleme olanakları sunar ve teklif verdikleri nihai reklam öğesi işaretçisine attributionsrc öğesinin dahil edildiğinden emin olmalıdır.

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

Bir reklamveren, üçüncü taraf ölçüm sağlayıcı kullanarak reklam envanterinde dönüşümleri ilişkilendirmek istiyor ancak reklam öğesini barındıran reklam teknolojisinde ilişkilendirme ölçümü koşulları bulunmuyor. Bu durum, reklam öğelerini barındıran ve ilişkilendirme raporlamasını kendileri kullanmayı planlamamasına rağmen DSP iş ortakları veya üçü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, SSP'ler veya yayıncı reklam sunucuları için yaygındır.

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

Senaryo 1'deki tipik kampanya kurulumu örneğinde, yayıncı reklam sunucusunun, SSP'nin veya yayıncının, DSP tarafından sağlanan attributionsrc özelliğinin yayıncı sayfasına eklenmesini sağlaması yeterli olabilir.

Uygulama ayrıntıları

Aşağıdaki tabloda, İlişkilendirme Raporlama API'si uygulama adımları üst düzeyde açıklanmaktadır:

Adımlar İşin sorumluluğu Örnekler
1. adım: Mevcut reklam öğeleri ve ölçüm kodu için ilişkilendirme kaynağını etkinleştirin Gösterim etkinliklerini tetiklemekten veya tıklama etkinliklerini işlemekten sorumlu varlık, attributionsrc özelliğini ekler. Tıklama etkinliklerinde, genellikle reklam öğesini oluşturan alıcı (TTP/reklamveren reklam sunucusu) özelliği ekler.

Gösterim etkinliklerinde, talep tarafı platform (TTP), arz tarafı platform (TTP), yayıncı, reklam sunucusu veya ölçüm sağlayıcı özelliği ekler. Bu, yayıncının kurulumuna bağlıdır.

VAST biçimini kullanan video reklamlarda yayıncı ve video SDK'sı özelliği ekler.
2. Adım: Üçüncü taraf kaynakları için İlişkilendirme Raporlamasını etkinleştirin Bu yöntem, 302 yönlendirmeleriyle mevcut bir yönlendirme yolu kullanılıyorsa 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ğinde üçüncü taraf yönlendirmeleri Attribution Reporting API çağrılarını almalıdır.
3. Adım: Attribution Reporting API isteklerine yanıtlar oluşturun 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ı

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 Attribution Reporting API tarafından gönderilen raporları hangi reklam teknolojisi varlıklarının aldığına bağlı olduğunu unutmayın.

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 tetiklemekten sorumlu tüzel kişi, reklam öğelerini attributionsrc özelliğiyle güncellemelidir. attributionsrc, mevcut tıklama ve gösterim etkinliklerine eklenmelidir ve boş veya dolu olabilir.

Yönlendirme kullanan tıklama etkinlikleri için attributionsrc özelliği gezinme bölümüne eklenmelidir. Gezinme işleminden sonraki 302 yönlendirmelerin attributionsrc özelliğini eklemesi gerekmez ve ilk gezinme attributionsrc eklediği sürece ARA için uygun olur.

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

Tıklama URL'sini barındıran sunucu, Attribution Reporting API isteklerini alıp yanıtlayabiliyorsa genellikle 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ş bir attributionsrc özelliği örneği:

Mevcut kurulumunuzda ARA entegrasyonuyla
<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 kurulumunuzda ARA entegrasyonuyla
<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ı kaydetmeye uygundur.

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

  • Tıklama etkinlikleri:
    • attributionsrc değerini eklemekten sorumlu tüzel kişi genellikle reklam teknolojisini yayınlayan taraftır.
    • Tıklama etkinliği içeren ana sayfa etiketlerine bir 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 değerini eklemekten sorumlu tüzel kişi genellikle reklam teknolojisini sunan ve ölçüm sağlayıcılardır.
    • <img> etiketinden veya <script> etiketinden tetiklenen gösterim etkinlikleri bir attributionsrc özelliği içermelidir.
    • Getirme API'sini kullanan gösterim etkinlikleri, getirme API'si çağrısına iletilen options bağımsız değişkeninde bir attributionReporting nesnesi içermelidir.

Tıklama ve gösterim etkinlikleri için gereken değişikliklerin özeti aşağıdaki tabloda verilmiştir:

Etkinlik Etiket Mevcut kurulumunuzda ARA entegrasyonundan sonra
Başlat'ı 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 kullanabilir, böylece ilişkilendirme kaynaklarının kaydedilmesini etkinleştirebilirsiniz.

Protected Audience sinyallerini raporlamak için registerAdBeacon işlevi raporlama iş parçacıklarında, registerAdMacro ise alıcının kazanç raporlama iş parçasında kullanılabilir. Ardından, reklam çerçevesindeki etkinlik verileri, Fenced Frame Ads Reporting API'nin reportEvent ve setReportEventDataForAutomaticBeacons işlevleriyle kayıtlı işaretçilere ve makrolara eklenebilir. Bu sayede, Protected Audience raporlama iş parçacıklarının ve reklam öğesi çerçevesi etkinlik yükü sinyallerinin birbiriyle ilişkilendirilmesi sağlanır.

İşaretçi 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 Attribution-Reporting-Eligible HTTP başlığı isteğe eklenir. İlişkilendirme kaynağı kaydetmek için işaretçinin yanıtını kullanabilirsiniz. İşaretçi istekleri, üçüncü taraf ölçümüne izin vermek için yönlendirilebilir.

Daha ayrıntılı bilgi için Çitli Çerçeve Reklam Raporlama API'si açıklama makalesinin İlişkilendirme Raporlaması 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 yaygın olarak kullanılan bir biçimdir. Bu standartta tanımlanan etkinliklerin çoğu, Attribution Reporting API'ye kaydedilmeye uygun potansiyel kaynak etkinlikler 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 ayarlanmasına olanak tanımak amacıyla bu öğeler için yeni özellikler tanımlar. Bir etkinlik attributiontype="DOUBLE_PING" ve attributionsrc="[URL]" içeriyorsa bu etkinliği tetikleyen kod, Attribution Reporting API'yi etkinleştirirken attributionsrc özelliğinin değeri olarak [URL] değerini kullanmalıdır. VAST eki, her senaryo için örnekler içerir.

Maksimum kapsamı sağlamak için VAST uygulamaları, etkinlik ping'leri tetiklenirken listelenen tüm etkinliklerin varsayılan olarak kayıt için uygun olmasını sağlamalıdır. Örneğin, bir <Impression> etkinlik URL'si tetiklenirken, isteği göndermek için kullanılan <img> öğesinde (veya getirme çağrısındaki eşdeğerinde) (boş) attributionsrc özelliği kullanılmalıdır. Böylece, alıcı tarafın bu etkinliği Attribution Reporting API'ye kaydetmesi her zaman mümkün olur.

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

Üçüncü tarafların İlişkilendirme Raporlama API'sini 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ı olur.

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

Tipik bir reklam tıklamasında, nihai açılış sayfasına gitme işleminin bir parçası olarak oluşturulan 302 yönlendirme zinciri olarak birçok tıklama izleyici bulunabilir. Orijinal tıklama hedefi attributionsrc ile ek açıklama eklenmişse veya Protected Audience API'de registerAdBeacon/registerAdMacro ile kaydedilmişse yönlendirme zincirindeki her istek Attribution Reporting API'ye kaydedilebilir. Yönlendirme zincirindeki reklam teknolojisi de kaydolmalıdır.

İlk isteğinin gövdesinin yönlendirmelerde gönderilmediğini unutmayın. Protected Audience açık artırmaları için eventData, reportEvent'e iletildiyse ve setReportEventDataForAutomaticBeacons'nin 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 teknolojisi sunma aracı (serving-adtech.example) ve üçüncü taraf ölçüm sağlayıcı (3p-measurement.example) kullanacağız. Bu örnekteki reklam yayınlama reklam teknolojisi, reklam öğesini yayıncı sitesinde oluşturan ve kendi raporlama ürününe sahip bir DSP olabilir. Üçüncü taraf ölçüm sağlayıcı, reklamverenin dönüşüm raporlaması için kullandığı bir varlık olabilir.

Birinci tarafın kaynağı nasıl kaydettiğini, ardından üçüncü tarafın kaynağı nasıl kaydettiğini açıklayan bir şema

Kaynak kaydı sırasında aşağıdaki adımlar uygulanır:

  1. serving-adtech.example, reklam öğesinde 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 üst bilgisini kullanır.
    2. serving-adtech.example, 3p-measurement.example adresine yönlendirme eklemek için Location üstbilgisini kullanır. Location üstbilgisinin, üçüncü tarafa 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'ten yanıt alır ve Attribution-Reporting-Register-Source üst bilgisini ayrıştırır. Tarayıcı, raporlama kaynağı olarak serving-adtech.example'ü kullanarak kaynak etkinliği depolar.
  4. Bu istek bir yönlendirme olduğundan tarayıcı 3p-measurement.example adresine de yeni bir istek gönderir.
  5. 3p-measurement.example, Attribution-Reporting-Register-Source üstbilgisini içeren bir yanıtla yanıt verir.
  6. Tarayıcı bu yanıtı 3p-measurement.example'ten alır ve Attribution-Reporting-Register-Source'yi okur. Tarayıcı, raporlama kaynağı olarak 3p-measurement.example'ü kullanarak kaynak etkinliği depolar.

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

Birden fazla raporlama kaynağı bir gezinme etkinliğinde kaynak kaydetmek istiyorsa ancak herhangi bir nedenle yönlendirme zincirinde görünemiyorsa alternatif bir çözüm olarak attributionsrc içinde birden fazla siteyi ilişkilendirme kaynağı olarak listeleyebilirsiniz.

Mevcut kurulumunuzda ARA modifikasyonuyla
<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 adresine gönderilir. Tıklama URL'sine gönderilen gezinme isteği de ilişkilendirme kaynaklarını kaydettirmeye uygundur.

3. Adım: Attribution Reporting API isteklerine yanıtlar oluşturun

Attribution Reporting API isteği alan tüm kaynaklar için sunucunun uygun Attribution-Reporting-Register-Source üstbilgisiyle yanıt verdiğinden emin olun. Yanıtın nasıl oluşturulması gerektiğini öğrenmek için Kaynakları kaydetme kılavuzunu ve açıklamayı inceleyin.

Birden fazla tetikleyici kaydetme

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

Yönlendirme isteklerini kullanarak veya kaynak kaydı için olduğu gibi attributionsrc öğesinde birden fazla URL listeleyerek tek bir piksel öğesinden birden fazla tetikleyici de kaydedebilirsiniz. Aynı kaynaklar tarafından oluşturulan kaynak etkinlikler ve tetikleyici etkinlikler eşleştirilir.