İlişkilendirme tetikleyicilerini kaydedin

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> etiketi
  • fetch telefon
  • XMLHttpRequest

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:

  1. Tetikleyici kaydını başlatın. İstekte bulunmak için bir piksel veya fetch() çağrısı kullanın.

  2. 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 veya attributionsrc kullanmayı seçip buna bir değer verdiyseniz attributionsrc öğ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.