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 araması
XMLHttpRequest
window.open araması

Bu işlem, daha sonra bir kaynakla yanıtlayabileceğiniz ağ istekleri oluşturur kayıt HTTP yanıt başlığı.

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. Bir HTML öğesi veya İstekte bulunmak için JavaScript çağrısı. 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.

Kaynakla yanıt vererek kaynak kaydını tamamlayın kayıt başlığı. Bu isteği aldıktan sonra Attribution-Reporting-Register-Source Bu başlıkta ekleyebilirsiniz. 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

Kaynakları kaydetmek için HTML öğelerini kullanırken veya JavaScript çağrıları yaparken attributionsrc kullanılması gerekebilir veya attributionReporting. Bunların ne zaman geçerli olduğuyla ilgili ayrıntılar için aşağıdaki tabloya bakın gereklidir.

attributionsrc isteğe bağlı olduğunda bu değerin kullanılması isteğin İlişkilendirme Raporları için uygun olduğunu gösterir. Şunu kullanıyorsanız: attributionsrc, tarayıcı Attribution-Reporting-Eligible üstbilgisi. Uygulamadan webe geçiş için de faydalıdır. ölçüm: attributionsrc mevcutsa tarayıcı Attribution-Reporting-Support üstbilgisi.

Kayıt yöntemi	Kaynak
`<a>` etiketi	(gezinme kaynağı) `attributionsrc` zorunludur.
`<img>` etiketi	(etkinlik kaynağı) `attributionsrc` zorunludur.
`<script>` etiketi	(etkinlik kaynağı) `attributionsrc` zorunludur.
`fetch` araması	`attributionReporting` seçeneği zorunludur.
`XMLHttpRequest`	`attributionReporting` seçeneği zorunludur.
`window.open` araması	(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ğını kaydetmek üzere <a> etiketi veya JavaScript kullanabilirsiniz window.open().

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 durumunda, attributionsrc öğesine bir değer verirseniz = parametrenin düzgün şekilde ayrıştırılmamasına neden olur.

Ş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}`)

Bu gibi durumlarda her iki URL de gezinme kaynağına uygun attributionsrc alır. istekler (Attribution-Reporting-Eligible üstbilgisini içeren istekler).

Değer içeren veya içermeyen `attributionsrc`

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

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

Bu, bir öğenin ana isteğinden ayrı bir istektir.

Örneğin, bir sabit öğeye yapılan tıklamaların kaynaklarını kaydetmeniz gerekiyorsa varış noktasının kontrolü sizde olmayabilir; Bu durumda proje hedefine bir isteğe yanıt olarak kaynak kaydı başlığını göndereceğiniz bir yapılandırma kontrol edebileceğiniz bir seçeneğimiz bulunuyor. Ölçüt attributionsrc için açık bir değer belirtirseniz ve hedefini yapılandırın.

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, attributionsrc ile aynı şekilde tıklama sayısı; 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.