İ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 araması
• 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 kaydettirmek bir ilişkilendirme kaynağı etkinliği kaydederek. Tüm adımlar daha sonra açıklanmaktadır. Özeti şöyle:

1. Tetikleyici kaydını başlatın. Aşağıdakileri yapmak için piksel veya fetch() çağrısı kullanın: talep ediyor.

2. Tetikleyiciyle yanıt vererek tetikleyici kaydını tamamlayın kayıt başlığı.

   Piksel isteğini aldıktan sonra ( uç nokta (normal src özelliğinde ya da tanımlanan uç nokta) attributionsrc kullanmayı seçtiyseniz ve attributionsrc bir değer—Attribution-Reporting-Register-Trigger başlığıyla yanıt verir.

   Bu üstbilgide, görüntülenmesini istediğiniz tetikleyici verilerini yardımcı olur. Herhangi bir yanıt bu başlığı ayarlayabilir. Bu bir destination ile eşleşen bir siteden gelen isteğe yanıt, kaynak eşleştirilecek. Ü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]"
     }]
   }
   

   Ö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 https://advertiser.example ise her ikisinde de dönüşüm sayısı https://advertiser.example ve bunun https://shop.advertiser.example gibi alt alan adları ilişkilendirilebilir.

destination https://shop.advertiser.example ise hem https://advertiser.example hem de dönüşüm sayısı https://shop.advertiser.example ilişkilendirilebilir.

Zorunlu ve isteğe bağlı özellikler

Tetikleyicileri 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.

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; <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 make sure 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 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 resim öğesinde tetikleyici kaydetmeniz gerekiyorsa Resimdeki yanıtın kontrolü aslında sizde olmayabilir; Bu durumda proje hedefine bir isteğe yanıt olarak tetikleyici kayıt başlığını gönderdiğiniz bir yapılandırma olmasını sağlayabilirsiniz. Ölçüt attributionsrc için açık bir değer belirtirseniz ve hedefini yapılandırın.

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.