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>
etiketifetch
telefonXMLHttpRequest
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.
Daha fazla bilgi için örnek kodu inceleyin.
Sunucuda tarayıcı isteğini aldıktan sonra, yanıtlayın 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 getirildikten sonra başlığınız ş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 tetikleyicilerinin nasıl kaydedileceğini öğrenin.