Dönüşümlerinizi saymak için ilişkilendirme tetikleyicilerini nasıl kaydedeceğinizi öğrenin.
İlişkilendirme tetikleyicisi, tarayıcıya dönüşümleri yakalamasını bildiren etkinliktir.
Bu belgedeki adımları uygulayarak tarayıcının ilgili kaynak etkinliklerle (ör. reklam gösterimleri veya reklam tıklamaları) ilişkilendirdiği dönüşümleri kaydetmek için tetikleyiciler kaydedebilirsiniz.
Kayıt yöntemleri
Tetikleyicileri kaydetmek için HTML öğelerini veya JavaScript çağrılarını kullanın:
<a>
etiketi<img>
etiketi<script>
etiketifetch
telefonXMLHttpRequest
window.open
Bu işlem, ağ istekleri oluşturur. Siz de bu istekleri tetikleyici kaydı HTTP yanıt başlığıyla yanıtlayabilirsiniz.
Bir dönüşümü ilişkilendirmek için tetikleyici kaydetme
Tetikleyici kaydetmek, ilişkilendirme kaynağı etkinliği kaydetmeye benzer. Adımların tamamı daha sonra açıklanmıştır. Özeti aşağıda bulabilirsiniz:
- Tetikleyici kaydını başlatın. İstekte bulunmak için piksel veya
fetch()
çağrısı kullanın. Tetikleyici kayıt başlığıyla yanıt vererek tetikleyici kaydını tamamlayın.
Piksel isteği alındıktan sonra (normal
src
özelliğinde tanımlanan uç noktaya veyaattributionsrc
kullanmayı seçip buna bir değer verdiysenizattributionsrc
içinde tanımlanan uç noktaya gönderilir)Attribution-Reporting-Register-Trigger
başlığıyla yanıt verin.Bu başlıkta, raporlarda gösterilmesini istediğiniz tetikleyici verilerini belirtin. Bu üstbilgi, herhangi bir yanıt tarafından ayarlanabilir. Bu,
destination
ile eşleşen bir siteden gelen isteğe yanıt olduğu sürece kaynaklar eşleştirilir. Üstbilgi alındığında, tarayıcı eşleşen kaynakları arar ve bir rapor planlar.Etkinlik düzeyindeki raporlar için örnek:
{ "event_trigger_data": [{ "trigger_data": "[unsigned 64-bit integer]", "priority": "[signed 64-bit integer]", "deduplication_key": "[unsigned 64-bit integer]" }] } ``` **Example for summary reports:** ```json { ... // existing fields, such as "event_trigger_data" "aggregatable_trigger_data": [ { "key_piece": "0x400", "source_keys": ["campaignCounts"] }, { "key_piece": "0xA80", "source_keys": ["geoValue", "nonMatchingKeyIdsAreIgnored"] } ], "aggregatable_values": { "campaignCounts": 32768, "geoValue": 1664 } } ```
Alt alanlarla ilgilenme
destination
, https://advertiser.example
ise hem https://advertiser.example
hem de https://shop.advertiser.example
gibi alt alan adlarındaki dönüşümler ilişkilendirilebilir.
destination
değeri https://shop.advertiser.example
ise hem https://advertiser.example
hem de https://shop.advertiser.example
üzerindeki dönüşümler ilişkilendirilebilir.
Gerekli ve isteğe bağlı özellikler
Tetikleyicileri 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 | Tetikleyici |
---|---|
<a> etiketi |
Yok Bağlayıcılar bir tetikleyici kaydedemez. |
<img> etiketi |
attributionsrc isteğe bağlıdır. Başlık, bir tetikleyici kaydetmek için yeterlidir. |
<script> etiketi |
attributionsrc isteğe bağlıdır. Başlık, bir tetikleyiciyi kaydetmek için yeterlidir. |
fetch telefon |
attributionReporting seçeneği zorunludur. |
XMLHttpRequest |
attributionReporting seçeneği zorunludur. |
window.open() |
Yok
window.open , tetikleyici kaydedemiyor. |
1. Adım: Tetikleyici kaydını başlatın
Piksel (<img>
etiketi) veya komut dosyası etiketi kullanarak bir tetikleyici kaydedebilirsiniz.
Yeni veya mevcut bir dönüşüm pikseli kullanma
<img src="https://ad-tech.example/conversionpixel"
attributionsrc="https://adtech.example/attribution_trigger?purchase=13">
Komut dosyası etiketi kullanma
Bir komut dosyası etiketiyle tetikleyici kaydı gerçekleştirebilirsiniz. Etiket, <img>
ile aynı şekilde davranır. Aşağıdaki kod örneklerinde fetch()
ve XMLHttpRequest()
(XHR) kullanımı gösterilmektedir.
Bu kod, attributionsrc
içeren bir HTML isteğinin ne yapacağını etkili bir şekilde simüle eder:
// With fetch
const attributionReporting = {
eventSourceEligible: false,
triggerEligible: true,
};
// 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 XMLHttpRequest:
const attributionReporting = {
eventSourceEligible: false,
triggerEligible: true,
};
const req = new XMLHttpRequest();
req.open('GET', url);
req.setAttributionReporting(
attributionReporting);
req.send();
attributionsrc
(değer içeren veya içermeyen)
attributionsrc
değerini bir değerle veya değer olmadan ekleyebilirsiniz.
<!-- Without a value -->
<img src="..." width="1" height="1" attributionsrc>
<!--With a value (URL) -->
<img src="..." width="1" height="1" attributionsrc="https://...">
attributionsrc
için bir değer ayarlarsanız bu tek bir URL olmalıdır.
URL 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.
2. Adım: Başlıkla yanıt verin
Tarayıcı isteğini aldıktan sonra, yanıt vererek Attribution-Reporting-Register-Trigger
başlığını ekleyin:
JSON.stringify({event_trigger_data: [{
trigger_data: '412444888111012',
// Optional
priority: '1000000000000',
deduplication_key: '2345698765'
}], debug_key: '1115698977'})