İlişkilendirme kaynaklarını kaydedin

Tıklamaları ve gösterimleri uygun etkinliklerle ilişkilendirmek için kaynakları nasıl kaydedeceğinizi öğrenin.

İlişkilendirme kaynağı, reklam teknolojisinin aşağıdaki bilgi türlerini ekleyebildiği reklamla ilgili bir etkinliktir (tıklama veya görüntüleme):

• Reklam öğesi kimliği, kampanyayla ilgili bilgiler veya coğrafi konum gibi bağlamsal raporlama verileri.
• Dönüşüm hedefi (ör. kullanıcının dönüşüm gerçekleştirmesini beklediğiniz site).

Bu dokümandaki adımları uygulayarak, tarayıcının dönüşümleri ilişkilendireceği kaynakları (reklam gösterimleri veya tıklamalar) kaydedebilirsiniz.

Kayıt yöntemleri

İlişkilendirme kaynaklarını kaydetmek için HTML öğelerini veya JavaScript çağrılarını kullanın:

• <a> etiketi
• <img> etiketi
• <script> etiketi
• fetch araması
• XMLHttpRequest
• window.open araması

Bu işlem, daha sonra bir kaynak kaydı HTTP yanıt başlığıyla yanıtladığınız ağ istekleri oluşturur.

Tıklamaların veya görüntülemelerin kaynaklarını kaydetme

Tıklama veya görüntüleme için bir ilişkilendirme kaynağı kaydetmek istiyorsanız burada açıklanan adımları uygulayın. Adımları tamamlayın. Özet şu şekildedir:

1. Kaynak kaydını başlatın. İstek göndermek için bir HTML öğesi veya JavaScript çağrısı kullanın. Aşağıdaki bölümlerde göreceğiniz gibi, bu adım tıklamalar ve görüntülemeler için farklıdır.

2. Kaynak kayıt başlığını ekleyerek kaynak kaydını tamamlayın. Bu isteği aldıktan sonra Attribution-Reporting-Register-Source başlığını kullanarak yanıt verin. Bu üstbilgide, seçilen İlişkilendirme Raporlaması yapılandırmasını belirtin. Bu adım hem tıklamalar hem de görüntülemeler için aynıdır.

   Özet raporları örneği:

   {
     "aggregation_keys": {
       "campaignCounts": "0x159",
       "geoValue": "0x5"
     },
     "aggregatable_report_window": "86400",
     "destination": "https://example.com"
   }
   

   Etkinlik düzeyindeki raporlar için örnek:

   {
     "source_event_id": "12340873456",
     "destination": "[eTLD+1]",
     "expiry": "[64-bit signed integer]",
     "priority": "[64-bit signed integer]",
     "event_report_window": "[64-bit signed integer]"
   }
   

Zorunlu ve isteğe bağlı özellikler

Kaynakları kaydetmek için HTML öğeleri kullanırken veya JavaScript çağrıları yaparken attributionsrc veya attributionReporting kullanmanız gerekebilir. Bu bilgilerin ne zaman gerekli olduğuyla ilgili ayrıntılar için aşağıdaki tabloya bakın.

attributionsrc isteğe bağlı olduğunda, bu özelliğin kullanılması isteğin İlişkilendirme Raporlaması için uygun olduğunu gösterir. attributionsrc kullanıyorsanız tarayıcı Attribution-Reporting-Eligible başlığını gönderir. Uygulamadan web'e ölçüm için de kullanışlıdır: attributionsrc varsa tarayıcı Attribution-Reporting-Support üstbilgisini gönderir.

1. Adım: Kaynak kaydını başlatın

1. adım, tıklamalar ve görüntülemeler için farklıdır.

Bir tıklama için ilişkilendirme kaynağı kaydetmek üzere <a> etiketi veya JavaScriptwindow.open() kullanabilirsiniz.

Sabitleme noktası kullanma

Gösterimleri veya tıklamaları ölçmek istediğiniz mevcut <a> etiketlerine attributionsrc ekleyin:

<a href="https://shoes.example/..." attributionsrc>Click me</a>

Daha fazla bilgi için örnek kodu inceleyin.

Komut dosyası kullanma

attributionsrc ile window.open()'ü arayın:

window.open(
  "https://shoes.example/...",
  "_blank",
  "attributionsrc");

Bu yöntemin dikkate alınması için kullanıcı etkileşiminden sonraki 5 saniye içinde çağrılması gerekir.

attributionsrc öğesini tek başına eklemek yerine, resim veya komut dosyası için tek bir URL değeri belirtebilirsiniz:

<a href=... attributionsrc="https://a.example/register-source">Click me</a>

JavaScript durumunda, attributionsrc için bir değer sağlarsanız = gibi özel karakterler içermesi durumunda parametrenin yanlış ayrıştırılmasına neden olacağı için bu URL'yi kodladığınızdan emin olun.

Aşağıdaki şekilde kodlayın:

const encodedUrl = encodeURIComponent(
  "https://adtech.example/attribution_source?ad_id=...");
window.open(
  "https://shoes.example/landing",
   "_blank",
   `attributionsrc=${encodedUrl}`);

attributionsrc, burada gösterildiği gibi <a> etiketiyle boşlukla ayrılmış bir URL listesi de alabilir:

<a href=... attributionsrc="https://a.example/register-source
  https://b.example/register-source">Click me</a>

veya burada olduğu gibi window.open() kullanarak.

window.open("...", "_blank", `attributionsrc=${encodedUrl1}
  attributionsrc=${encodedUrl2}`)

Bu gibi durumlarda her iki URL de gezinme kaynağına uygun attributionsrc isteklerine (Attribution-Reporting-Eligible başlığını içeren istekler) alır.

attributionsrc değeri olan veya olmayan

Daha önce gördüğünüz gibi, attributionsrc değerini URL olmadan belirtebilirsiniz. Tek bir URL de belirtebilirsiniz. Ayrıca, boşlukla ayrılmış bir URL listesi de kullanabilirsiniz.

URL'lerin kullanılması, tarayıcının Attribution-Reporting-Eligible istek üstbilgisini içeren ayrı bir keepalive getirme isteği (her URL için bir tane) başlatmasına neden olur.

Bu seçenek, öğenin ana isteğinden ayrı bir isteği yanıtlayarak kaynak kaydını yapmak istiyorsanız kullanışlıdır.

Örneğin, bir ana öğedeki tıklamalar için kaynakları kaydetmeniz gerekiyorsa hedefin kontrolünü tam olarak elinde bulundurmayabilirsiniz. Bu durumda, kaynak kayıt başlığını gezinmeden ayrı ve tamamen kontrol edebildiğiniz bir isteğe yanıt olarak gönderdiğiniz bir yapılandırma kullanmanız gerekir. attributionsrc için açık bir değer belirterek tarayıcıya bu ek isteği yapmasını ve hedefini yapılandırmasını talimat vermiş olursunuz.

Bir görüntüleme için ilişkilendirme kaynağı kaydetmek üzere attributionsrc özelliğini ekleyeceğiniz bir resim veya komut dosyası etiketi kullanabilirsiniz.

Alternatif olarak JavaScript fetch() veya XMLHttpRequest() kullanabilirsiniz.

Görselli

<img attributionsrc
src="https://adtech.example/attribution_source?ad_id=...">

Senaryoyla

<script attributionsrc
  src="https://adtech.example/attribution_source?ad_id=..."></script>

İsteğe bağlı olarak, attributionsrc için tıklamalarla aynı şekilde bir URL değeri belirtebilirsiniz. Yani bir resim veya komut dosyası için attributionsrc URL'sini veya URL'lerini şu şekilde ayarlayabilirsiniz:

Tek bir URL ile:

<img attributionsrc="https://adtech.example/attribution_source?ad_id=123">

URL listesi ile:

<img attributionsrc="https://a.example/register-source
  https://b.example/register-source">

fetch() veya XMLHttpRequest() kullanımı

Bu kod, attributionsrc içeren bir HTML isteğinin ne yapacağını etkili bir şekilde simüle eder:

const attributionReporting = {
  eventSourceEligible: true,
  triggerEligible: false,
};

// Optionally set keepalive to make sure the request outlives the page.
window.fetch("https://adtech.example/attribution_source?my_ad_id=123",
  { keepalive: true, attributionReporting });

const attributionReporting = {
  eventSourceEligible: true,
  triggerEligible: false,
};

const req = new XMLHttpRequest();
req.open("GET", url);
req.setAttributionReporting(attributionReporting);
req.send();

2. Adım: Başlıkla yanıt verin (tıklamalar ve görüntülemeler)

Hem tıklamalar hem de görüntülemeler için bir sonraki adım, Attribution-Reporting-Register-Source başlığıyla yanıt vermektir.

Daha fazla bilgi için örnek kodu inceleyin.

Tarayıcı isteğini sunucuda aldıktan sonra yanıt verin ve yanıtınıza Attribution-Reporting-Register-Source üstbilgisini ekleyin.

res.set(
  "Attribution-Reporting-Register-Source",
  JSON.stringify({
    // Use source_event_id to map it to any granular information
    // you need at ad-serving time
    source_event_id: "412444888111012",
    destination: "https://advertiser.example",
    // Optional fields
    expiry: "604800",
    priority: "100",
    debug_key: "122939999"
  })
);

Üstbilginizin dize haline getirilmiş hali şu şekilde görünür:

{"source_event_id":"412444888111012","destination":"https://advertiser.example","expiry":"604800","priority":"100","debug_key":"122939999"}

Sonraki adımlar

İlişkilendirme tetikleyicilerini nasıl kaydedeceğinizi öğrenin.