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 dokümandaki adımları uygulayarak, tarayıcının alakalı kaynak etkinliklerle (yani 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:
<img>
etiketi<script>
etiketifetch
telefonXMLHttpRequest
Böylece ağ istekleri oluşturulur. Daha sonra tetikleyici kaydı HTTP yanıt başlığıyla yanıt verebilirsiniz.
Dönüşümü ilişkilendirmek için tetikleyici kaydedin
Tetikleyici kaydetmek, ilişkilendirme kaynağı etkinliğini kaydetmeye benzer. İlgili tüm adımlar daha sonra açıklanmaktadır. Özeti şöyle:
- Tetikleyici kaydını başlatın. İstekte bulunmak için bir piksel veya
fetch()
çağrısı kullanın. Tetikleyici kayıt başlığıyla yanıt vererek tetikleyici kaydını tamamlayın.
Piksel isteğini aldıktan sonra (normal
src
özelliğinde tanımlanan uç noktaya veyaattributionsrc
kullanmayı seçip buna bir değer verdiysenizattributionsrc
öğesinde tanımlanan uç noktaya)Attribution-Reporting-Register-Trigger
başlığıyla yanıt verir.Bu başlıkta, nihai olarak raporlarda gösterilmesini istediğiniz tetikleyici verilerini belirtin. Herhangi bir yanıt bu başlığı ayarlayabilir.
destination
ile eşleşen bir siteden gelen isteğe yanıt olduğu sürece kaynaklar eşleştirilir. Başlık alındığında, tarayıcı eşleşen kaynakları arır 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]" }] }
Özet rapor örneği:
{ ... // 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 alan adlarıyla ilgilenme
destination
değeri https://advertiser.example
ise hem https://advertiser.example
hem de alt alanlarındaki (ör. https://shop.advertiser.example
) dönüşümler ilişkilendirilebilir.
destination
değeri https://shop.advertiser.example
ise hem https://advertiser.example
hem de https://shop.advertiser.example
dönüşümleri ilişkilendirilebilir.
Zorunlu ve isteğe bağlı özellikler
Tetikleyicileri kaydetmek için HTML öğelerini kullanırken veya 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 | Tetikleyici |
---|---|
<a> etiketi |
Yok: Sabitler bir tetikleyici kaydedemez. |
<img> etiketi |
attributionsrc isteğe bağlıdır. Başlık, tetikleyici kaydetmek için yeterlidir. |
<script> etiketi |
attributionsrc isteğe bağlıdır. Başlık, tetikleyici kaydetmek için yeterlidir. |
fetch telefon |
attributionReporting seçeneği zorunludur. |
XMLHttpRequest |
attributionReporting seçeneği zorunludur. |
window.open() |
Yok: window.open , tetikleyici kaydedemez. |
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
Aşağıdaki örnekte, attributionsrc
özelliği eklenerek mevcut bir resimde ilişkilendirmeyi tetikler.
attributionsrc
öğesinin kaynağı, kaynak kaydını gerçekleştiren kaynakla eşleşmelidir.
<img src="https://advertiser.example/conversionpixel"
attributionsrc="https://adtech.example/attribution_trigger?purchase=13">
Sonraki örnekte, yeni bir dönüşüm pikseli attributionsrc
özelliği eklenerek ilişkilendirmeyi tetikler.
src
öğesinin kaynağı, kaynak kaydını gerçekleştiren kaynakla eşleşmelidir.
<img src="https://adtech.example/conversionpixel"
attributionsrc>
Komut dosyası etiketi kullanma
Tetikleyici kaydını bir komut dosyası etiketiyle gerçekleştirebilirsiniz. Bu etiket, <img>
ile aynı şekilde davranır. Aşağıdaki kod örnekleri, fetch()
ve XMLHttpRequest()
(XHR) kullanımını göstermektedir.
Bu kod, attributionsrc
içeren bir HTML isteğinin yapacaklarını etkili bir şekilde simüle eder:
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 });
const attributionReporting = {
eventSourceEligible: false,
triggerEligible: true,
};
const req = new XMLHttpRequest();
req.open("GET", url);
req.setAttributionReporting(attributionReporting);
req.send();
Değer içeren veya içermeyen attributionsrc
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, boşlukla ayrılmış bir veya daha fazla URL olabilir.
URL 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.
Tetikleyici kaydını, öğenin ana isteğinden ayrı bir isteğe yanıt vererek yapmak istiyorsanız bu işlem yararlı olur.
Örneğin, bir resim öğesine tetikleyici kaydetmeniz gerekiyorsa resim yanıtının kontrolü aslında sizde olmayabilir. Bu durumda, tetikleyici kayıt başlığını resimden ayrı bir isteğe yanıt olarak göndereceğiniz ve tamamen kontrol edebileceğiniz bir yapılandırma kullanmak 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.
2. Adım: Başlıkla yanıt verin
Tarayıcı isteğini aldıktan sonra, Attribution-Reporting-Register-Trigger
başlığını yanıtlayın ve yanıtınıza ekleyin:
JSON.stringify({
event_trigger_data: [{
trigger_data: "412444888111012",
// Optional
priority: "1000000000000",
deduplication_key: "2345698765"
}],
debug_key: "1115698977"
});
Sonraki adımlar
İlişkilendirme kaynaklarını kaydetme hakkında bilgi edinin.