İ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ğı, reklamla ilgili bir etkinliktir (tıklama veya görüntüleme). Bu etkinliğe reklam teknolojisi aşağıdaki bilgileri ekleyebilir: - Reklam öğesi kimliği, kampanya ile ilgili bilgiler veya coğrafya gibi içeriğe dayalı raporlama verileri. - Kullanıcının dönüşüm gerçekleştirmesini beklediğiniz sitede olduğu gibi bir dönüşüm hedefi.

Bu belgedeki adımları uygulayarak tarayıcının dönüşümleri ilişkilendirdiğ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 telefon
  • XMLHttpRequest
  • window.open

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

Tıklama veya görüntüleme için kaynakları kaydetme

Tıklamalar veya görüntülemeler için bir ilişkilendirme kaynağı kaydetmek istiyorsanız burada belirtilen adımları izleyin. İlgili adımların tamamı aşağıda verilmiştir. Özeti aşağıda bulabilirsiniz:

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

  2. Kaynak kayıt başlığıyla yanıt vererek kaynak kaydını tamamlayın. Bu isteği aldıktan sonra, Attribution-Reporting-Register-Source başlığıyla yanıt verin. Bu başlıkta, istediğiniz İ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 için örnek:

    {
  "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]"
}

Gerekli ve isteğe bağlı özellikler

Kaynakları kaydetmek için HTML öğelerini kullanırken veya JavaScript çağrıları yaparken attributionsrc veya attributionReporting kullanmanız gerekebilir. Bunların ne zaman gerekli olduğu hakkındaki ayrıntılar için aşağıdaki tabloya bakın.

attributionsrc isteğe bağlı olduğunda bu değer, isteğin İlişkilendirme raporlaması için uygun olduğunu gösterir. attributionsrc kullanırsanız tarayıcı, Attribution-Reporting-Eligible üst bilgisini gönderir. Uygulamadan web'e ölçüm için de kullanışlıdır: attributionsrc mevcutsa tarayıcı Attribution-Reporting-Support başlığını gönderir.

Kayıt yöntemi Kaynak
<a> etiketi (gezinme kaynağı)
attributionsrc gerekli.
<img> etiketi (etkinlik kaynağı)
attributionsrc zorunludur.
<script> etiketi (etkinlik kaynağı)
attributionsrc zorunludur.
fetch telefon attributionReporting seçeneği zorunludur.
XMLHttpRequest attributionReporting seçeneği zorunludur.
window.open() (gezinme kaynağı)
attributionsrc gerekli.

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

1. adım, tıklamalar ve görüntülemeler için farklıdır. Her birine karşılık gelen sekmeleri açın.

Bir tıklamanın ilişkilendirme kaynağını kaydetmek için <a> etiketi veya JavaScript window.open() kullanabilirsiniz.

Bağlayıcı kullanma

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

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

Daha fazla bilgi için örnek kodu inceleyin.

Komut dosyası kullanma

window.open() adlı kişiyi attributionsrc ile ara:

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

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

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

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

JavaScript örneğinde attributionsrc için bir değer verirseniz parametrenin yanlış ayrıştırılmasına neden olacak "=" gibi özel karakterler içermesi ihtimaline karşı bu URL'yi kodladığınızdan emin olun.

Aşağıdaki gibi kodlayın: 

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

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

<!-- With an anchor tag -->
<a href=... attributionsrc="https://a.example/register-source 
  https://b.example/register-source">

veya şu anki haliyle window.open() kodunu kullanın.

// With window.open()
window.open('...', '_blank', attributionsrc=${encodedUrl1}
  attributionsrc=${encodedUrl2})

Bu gibi durumlarda, her iki URL de navigation-source-eligible attributionsrc isteklerini (Attribution-Reporting-Eligible üst bilgisini içeren istekler) alır.

attributionsrc (değer içeren veya içermeyen)

Daha önce de belirtildiği gibi, attributionsrc URL'sini URL olmadan belirtebilirsiniz. Ayrıca tek bir URL de belirleyebilirsiniz. Ayrıca, yalnızca kaynaklar için (tetikleyiciler için geçerli değildir) boşlukla ayrılmış bir URL listesi kullanabilirsiniz.

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

Bu, öğenin ana isteğinden ayrı bir isteğe yanıt vererek kaynak kaydı yapmak istiyorsanız kullanışlıdır.

Örneğin, bir sabit öğeye yapılan tıklamalar için kaynakları kaydetmeniz gerekiyorsa hedefin kontrolü sizde olmayabilir. Bu durumda, kaynak kaydı başlığını gezinmeden ayrı bir isteğe yanıt olarak gönderdiğiniz ve tamamen kontrol edebileceğiniz bir yapılandırma isteyebilirsiniz. attributionsrc için açık bir değer belirterek tarayıcıya bu ek istekte bulunmasını söyler ve hedefini yapılandırırsınız.

Görünümleri kaydetmenin 1. adımı için sekmelere gidip Görünümler adımını seçin.

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

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

Resimli

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

Komut dosyası kullanarak

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

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

Tek bir URL ile:

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

URL listesiyle:

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

fetch() veya XMLHttpRequest() kullanılıyor

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

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

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

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

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

Tıklamaları kaydetmenin 1. adımı için sekmelere gidip 1. adımı seçin.

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ğini aldıktan sonra, yanıt verin ve yanıtınıza Attribution-Reporting-Register-Source başlığını 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'
    })
 );

Dize haline getirildiğinde başlığınız şöyle 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.