Bu sayfa, Cloud Translation API ile çevrilmiştir.

İ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ğı, 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, kampanyayla 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 öğeleri veya JavaScript çağrıları kullanın:

<a> etiketi
<img> etiketi
<script> etiketi
fetch telefon
XMLHttpRequest
window.open telefon

Böylece, kaynak kaydı HTTP yanıt başlığıyla yanıt verdiğiniz ağ istekleri oluşturulur.

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. Ardından adımların tamamı uygulanır. Özeti şöyle:

Kaynak kaydını başlatın. İstekte bulunmak için bir HTML öğesi veya JavaScript çağrısı kullanın. Bu adım, aşağıdaki bölümlerde göreceğiniz gibi, tıklamalar ve görüntülemeler için farklıdır.
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ığını kullanarak 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 rapor ö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

HTML öğelerini kullanırken veya kaynakları kaydetmek için 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 değerin kullanılması isteğin İlişkilendirme Raporları 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 yararlıdır: attributionsrc varsa tarayıcı, Attribution-Reporting-Support üst bilgisini gönderir.

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

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

Bağlayıcı 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 numaralı telefonu kullanarak window.open() adlı iş ortağını ara:

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

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

attributionsrc değerini 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'te attributionsrc öğesine bir değer verirseniz bu URL'yi, parametrenin düzgün şekilde ayrıştırılmamasına neden olabilecek = gibi özel karakterler içermesi halinde kodladığınızdan emin olun.

Şu şekilde kodlayın:

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

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

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

veya window.open() kullanılarak burada olduğu gibi.

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

Böyle bir durumda her iki URL de gezinme kaynağına uygun attributionsrc istekleri (Attribution-Reporting-Eligible üstbilgisini 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ış listesini kullanabilirsiniz.

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

Öğenin ana isteğinden ayrı bir isteğe yanıt vererek kaynak kaydını yapmak istiyorsanız bu yöntem yararlıdır.

Örneğin, bir sabit öğeye yapılan tıklamalara ilişkin kaynakları kaydetmeniz gerekiyorsa hedefin kontrolü sizde olmayabilir. Bu durumda, kaynak kayıt başlığını gezinmeden ayrı bir isteğe yanıt olarak göndereceğiniz ve tamamen kontrol edebileceğiniz bir yapılandırma istersiniz. attributionsrc için açık bir değer belirterek tarayıcıya bu ek istekte bulunmasını ve hedefini yapılandırmasını sağlarsınız.

Bir görünüm 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.

Resimli

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

Komut dosyasıyla

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

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

Tek bir URL ile:

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

Bir URL listesiyle:

<img 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 yapacaklarını etkili bir şekilde simüle eder:

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 });

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

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

2. Adım: Başlık ile 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.