İlişkilendirme kaynaklarını kaydedin

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

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

• Reklam öğesi kimliği, kampanya hakkında 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 belgedeki adımları uygulayarak, tarayıcının daha sonra 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, daha sonra bir kaynak kaydı HTTP yanıt başlığıyla yanıtladığınız ağ istekleri oluşturur.

Tıklamalar veya görüntülemeler için kaynakları kaydetme

Tıklamalar veya görüntülemeler için bir ilişkilendirme kaynağı kaydetmek üzere burada belirtilen adımları uygulayın. Tüm adımlar aşağıda verilmiştir. Özet:

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

2. Kaynak kayıt başlığıyla yanıt vererek kaynak kaydını tamamlayın. Bu isteği aldığınızda Attribution-Reporting-Register-Source başlığıyla yanıt verin. Bu üstbilgide, seçilen İlişkilendirme Raporlama 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 raporlara ö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 öğelerini kullanırken veya JavaScript çağrıları yaparken attributionsrc ya da attributionReporting kullanmanız gerekebilir. Bunların 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 parametrenin kullanılması isteğin İlişkilendirme Raporları için uygun olduğunu gösterir. attributionsrc kullanıyorsanız tarayıcı, attributionsrc başlığını gönderir.Attribution-Reporting-Eligible Ayrıca uygulamadan web'e ölçüm için de kullanışlıdır: attributionsrc mevcutsa 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 atıf kaynağı kaydetmek üzere <a>etiket veya JavaScriptwindow.open() kullanabilirsiniz.

Çapa 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() numaralı telefonu 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, bir 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 verirseniz parametrenin yanlış ayrıştırılmasına neden olacak = gibi özel karakterler içermesi durumunda 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 <a> etiketiyle gösterildiği gibi, boşlukla ayrılmış bir URL listesini de alabilir:

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

veya burada window.open() kullanılarak gösterildiği gibi.

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

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

Değer içeren veya içermeyen attributionsrc

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

URL'lerin kullanılması, tarayıcının Attribution-Reporting-Eligible isteği başlığını içeren, her URL için ayrı bir etkin tutma getirme isteği başlatmasına neden olur.

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

Örneğin, bir sabitleme öğesindeki tıklamalar için kaynakları kaydetmeniz gerekiyorsa hedef üzerinde kontrolünüz olmayabilir. Bu durumda, kaynak kaydı üstbilgisini gezinmeden ayrı bir isteğe yanıt olarak göndereceğiniz ve tamamen kontrol edebileceğ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 hedefi yapılandırmasını söylersiniz.

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.

Resimle

<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. Örneğin, bir resim veya komut dosyası için attributionsrc URL'sini ya da URL'lerini şu şekilde ayarlayabilirsiniz:

Tek bir URL ile:

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

URL listesiyle:

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

fetch() veya XMLHttpRequest() kullanma

Bu kod, attributionsrc içeren bir HTML isteğinin yapacağı işlemi 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.

Sunucuda tarayıcı isteği alındığında 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"
  })
);

Dizeleştirildikten sonra üstbilginiz ş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.