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

Dönüşüm ilişkilendirme ölçümü; yayıncı, reklamveren, reklam sunan reklam teknolojisi (reklamı yayınlayan öğe), ölçüm sağlayıcı ve daha fazlası gibi birden fazla tarafı içerebilir. Bu belgede, 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, bu belgede açıklanan entegrasyon adımlarının uygulandığından emin olmalıdır.

Örneğin, bir yayıncının reklam yayınlamaktan sorumlu bir veya daha fazla reklam teknolojisi olması yaygındır. Bu, reklam öğesi için biçimlendirme sağlamaktan sorumlu tarafları, reklam öğesinde gösterim veya izleme pikseli sağlamaktan sorumlu tarafları ve yayıncı sayfasındaki reklam alanı için SDK veya etiket sağlamaktan sorumlu 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ğlamak için konumlandırılı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, bu verileri birden fazla benzersiz yayıncı ve kanal genelinde reklam yatırımı getirilerini anlamak için 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ştireceklerini anlamaları önemlidir. Üçüncü taraf kullanmak isteyen reklamverenler, üçüncü taraf ölçüm sağlayıcı kullanarak veya API'den rapor almak ve kaydetmek için şirket içi bir sunucu ayarlayarak 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 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ı raporlamaya izin verebilir. Bir 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ı ayrı 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üyle ilgili iki yaygın senaryoyu inceleyeceğiz.

1. Senaryo: Hem reklam sunan reklam teknolojisi hem de üçüncü taraf ölçüm sağlayıcı, Attribution Reporting API'den rapor almalıdır.

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

Bu durumda, reklam sunan reklam teknolojisi, mevcut kurulumda tıklama ve gösterim etkinliklerini tetiklemekten de sorumludur. Reklam yayınlayan reklam teknolojisi, yeni attributionsrc değerini uygun konumlara ayarlamalı ve yönlendirmelerin doğru şekilde yapılandırıldığını doğrulamalıdır. Ayrıca, hem reklam sunan reklam teknolojisi hem de üçüncü taraf ölçüm sağlayıcı, kayıtlı olduklarını ve sunucularının Attribution Reporting API isteklerini almaya ve yanıtlamaya hazır olduğunu doğrulamalıdır.

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

  1. Reklamveren reklam sunucusu (3PAS), reklam öğesinin biçimlendirmesini, üçüncü taraf ölçüm sağlayıcının gösterim ve tıklama izleme piksellerini içeren DSP'ye sağlar. Reklam sunucusu, attributionsrc öğesinin reklam öğesi işaretlemesine dahil edildiğinden emin olmalıdır.

  2. TTP, ek ölçüm gösterimi ve tıklama izleme pikselleri ekleme özellikleri sunar ve teklif verdiği nihai reklam öğesi işaretlemesine attributionsrc'nın 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ı gerekiyor

Bir reklamveren, üçüncü taraf ölçüm sağlayıcı kullanarak reklam envanterindeki dönüşümleri ilişkilendirmek istiyor ancak reklam öğesini barındıran reklam teknolojisinin ilişkilendirme ölçümüyle ilgili herhangi bir şartı yok. Bu, reklam öğelerini barındıran ve ilişkilendirme raporlamayı kendileri kullanmayı planlamayan ancak Attribution Reporting API'yi TTP iş ortakları veya üçüncü taraf reklam sunucuları, ölçüm ya da 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ındır.

Bu durumda, mevcut kurulumda tıklama ve gösterim etkinliklerini tetiklemekten sorumlu tarafın, yeni attributionsrc özelliğini reklam öğelerine eklemesi ve yönlendirmelerin amaçlandığı gibi çalıştığını doğrulaması gerekir. Bu durum, her yayıncının entegrasyonuna büyük ölçüde bağlıdır ancak tıklama etkinlikleri için bu, SSP, reklam yayınlama 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.

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

Uygulama ayrıntıları

Aşağıdaki tabloda, Attribution Reporting API'nin uygulanmasıyla ilgili adımlar genel olarak açıklanmaktadır:

Adımlar İş 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 yönetmekten sorumlu tüzel kişi attributionsrc özelliğini ekler. Tıklama etkinliklerinde, genellikle reklam öğesini oluşturan bir alıcı (TTP/reklamveren reklam sunucusu) özelliği ekler.

Gösterim etkinliklerinde, talep tarafı platformu (TTP), arz tarafı platformu (STP), yayıncı, reklam sunucusu veya bir ölçüm sağlayıcı 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, özelliği ekler.
2. adım: Üçüncü taraf kaynakları için ilişkilendirme raporlamasını etkinleştirin 302 yönlendirmeleri ile mevcut bir yönlendirme yolu kullanılıyorsa bu özellik kutudan çıktığı gibi ç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ı alı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 TTP ve reklamveren tarafından kullanılan üçüncü taraf ölçüm sağlayıcı

Her adımın ayrıntılarının, reklam öğelerinin yayıncı sayfasında nasıl oluşturulduğuna ve sunulduğuna, ayrıca Attribution Reporting API tarafından gönderilen raporları hangi reklam teknolojisi kuruluşları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 olan taraf, reklam öğelerini attributionsrc özelliğiyle güncellemelidir. attributionsrc, mevcut tıklama ve gösterim etkinliklerine eklenmelidir ve boş veya boş olmayan bir değer içerebilir.

Yönlendirmelerin kullanıldığı tıklama etkinliklerinde attributionsrc özelliği navigasyona eklenmelidir. Gezinmeden sonraki 302 yönlendirmelerinin attributionsrc özelliğini eklemesi gerekmez ve ilk gezinmede attributionsrc özelliği eklendiği sürece ARA için uygun olur.

attributionsrc boş olduğunda ARA istekleri, bağlantı etiketinin href özelliğinde (tıklama URL'si) 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 kaydetmeye uygundur.

Genellikle, tıklama URL'sine 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ş bir 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ğiyle 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 etiketiyle tanımlanan URL'ye gönderilir. Tıklama URL'si de kaynak kaydetmeye uygundur.

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

  • Tıklama etkinlikleri:
    • attributionsrc eklemekten sorumlu taraf genellikle reklam yayınlama teknolojisidir.
    • Tıklama etkinlikleri içeren bağlantı etiketlerine bir attributionsrc özelliği eklenmelidir.
    • window.open kullanılarak yapı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 eklemekten sorumlu taraf genellikle yayın yapan reklam teknolojisi ve ölçüm sağlayıcıdır.
    • <img> etiketi veya <script> etiketi tarafından tetiklenen gösterim etkinlikleri bir attributionsrc özelliği içermelidir.
    • Fetch API'nin kullanıldığı gösterim etkinlikleri, fetch API ç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 kurulumunuz 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ındaki dönüşümleri ölçmek için attributionsrc yerine ilişkilendirme kaynaklarının kaydedilmesini sağlamak üzere registerAdBeacon/registerAdMacro ve setReportEventDataForAutomaticBeacons/reportEvent kullanabilirsiniz.

Protected Audience sinyallerini raporlamak için registerAdBeacon işlevi raporlama işlevletlerinde, registerAdMacro işlevi ise alıcının kazandığı raporlama işlevletinde kullanılabilir. Ardından, reklam çerçevesinin içindeki etkinlik verileri, Fenced Frame Ads Reporting API'nin reportEvent ve setReportEventDataForAutomaticBeacons işlevleriyle kayıtlı işaretçilere ve makrolara eklenebilir. Bu, Protected Audience raporlama işlevletlerinin sinyallerinin ve reklam öğesi çerçevesi etkinlik yükünün birbiriyle ilişkilendirilmesine olanak tanır.

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

Daha ayrıntılı bilgi için Fenced Frame Ad Reporting API açıklayıcısının Attribution Reporting desteği bölümüne bakın.

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

VAST, video reklam envanterinin yayınlanması ve ölçülmesi için kullanılan yaygın bir biçimdir. Bu standartta tanımlanan etkinliklerin çoğu, Attribution Reporting API ile kayda uygun potansiyel kaynak etkinlikler olarak kabul edilmelidir. İlişkilendirme Raporlama Desteği için VAST Ek Belgesi bu konuyu ayrıntılı olarak ele almaktadı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 ekinde, özellikle ilişkilendirme kaydı için ikincil bir URL'nin ayarlanmasına olanak tanımak üzere bu öğeler için yeni özellikler tanımlanır. Bir etkinlik attributiontype="DOUBLE_PING" ve attributionsrc="[URL]" içerdiğinde, bu etkinliği tetikleyen kod, Attribution Reporting API'yi etkinleştirirken attributionsrc özelliğinin değeri olarak [URL] kullanmalıdır. VAST ekinde her senaryo için örnekler bulunur.

Maksimum kapsama için VAST uygulamaları, etkinlik ping'leri tetiklendiğinde varsayılan olarak listelenen tüm etkinlikleri kayda uygun hale getirmelidir. Ö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) attributionsrc özelliği kullanılmalıdır. Bu sayede, alıcı tarafın bu etkinliği Attribution Reporting API ile kaydetmesine her zaman olanak tanınır.

2. adım: Üçüncü taraf kaynakları için iliş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 uygundur.

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

Tipik bir reklam tıklamasında, nihai açılış sayfasına yapılan gezinme kapsamında oluşturulan bir 302 yönlendirme zinciri olarak birçok tıklama izleyici bulunabilir. Yönlendirme zincirindeki her istek, orijinal tıklama hedefi attributionsrc ile açıklama eklenmişse veya Protected Audience API'de registerAdBeacon/registerAdMacro ile kaydedilmişse Attribution Reporting API'ye kaydolmaya 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, reportEvent'ye iletildiyse ve yönlendirme kapsamında setReportEventDataForAutomaticBeacons kullanılması gerekiyorsa bu parametre, 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 ayrı tüzel kişi olarak bir reklam sunma teknolojisi (serving-adtech.example) ve bir üçüncü taraf ölçüm sağlayıcı (3p-measurement.example) kullanacağız. Bu örnekteki yayınlanan reklam teknolojisi, reklam öğesini yayıncı sitesinde oluşturup kendi raporlama ürününe sahip olan bir DSP olabilir. Üçüncü taraf ölçüm sağlayıcı, reklamverenin dönüşüm raporlaması için kullandığı bir tüzel kişi olabilir.

Birinci tarafın kaynağı nasıl kaydettiğini açıklayan bir şema.
Dönüşüm ölçümünün üçüncü taraflarla işleyiş şekliyle ilgili örnek.

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

  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 üstbilgisini kullanır.
    2. serving-adtech.example, 3p-measurement.example adresine yönlendirme eklemek için Location üstbilgisini kullanır. Location üstbilgisinin, 302 yönlendirmelerini üçüncü tarafa 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'dan 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 için de yeni bir istekte bulunur.
  5. 3p-measurement.example, Attribution-Reporting-Register-Source üstbilgisini içeren bir yanıtla karşılık veriyor.
  6. Tarayıcı, bu yanıtı 3p-measurement.example adresinden alır ve Attribution-Reporting-Register-Source değerini 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 raporlayıcı kaynak, bir gezinme etkinliğinde kaynak kaydetmek istiyor ancak herhangi bir nedenle yönlendirme zincirinde görünemiyorsa alternatif çözüm olarak attributionsrc içinde birden fazla 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 adresine gönderilir. Tıklama URL'sine gönderilen gezinme isteği de ilişkilendirme kaynaklarını kaydetmeye uygundur.

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

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

Birden fazla tetikleyici kaydetme

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 listeleyerek tek bir piksel öğesinden birden fazla tetikleyici kaydedebilirsiniz. Aynı kaynaklar tarafından oluşturulan kaynak etkinlikler ve tetikleyici etkinlikler eşleştirilir.