İlişkilendirme tetikleyicilerini kaydedin

Dönüşümlerinizi saymak için ilişkilendirme tetikleyicilerini nasıl kaydedeceğinizi öğrenin.

İlişkilendirme tetikleyici, tarayıcıya dönüşümleri yakalamasını söyleyen etkinliktir.

Bu belgedeki adımları uygulayarak tetikleyicileri kaydedebilir ve böylece tarayıcı, dönüşümleri ilgili kaynak etkinliklerle (yani reklam gösterimleri veya reklam tıklamaları) ilişkilendirebilir.

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

Bu, ağ istekleri oluşturur. Ardından, tetikleyici kaydı HTTP yanıt başlığıyla bu isteklere yanıt verirsiniz.

Dönüşüm ilişkilendirmek için tetikleyici kaydetme

Tetikleyici kaydetme işlemi, ilişkilendirme kaynağı etkinliği kaydetme işlemine benzer. Tüm adımlar daha sonra açıklanmaktadır. Özet:

1. Tetikleyici kaydını başlatın. İstek göndermek için piksel veya fetch() çağrısı kullanın.

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

   Normal src özelliğinde tanımlanan uç noktaya veya attributionsrc özelliğini kullanmayı seçtiyseniz ve bu özelliğe bir değer verdiyseniz attributionsrc içinde tanımlanan uç noktaya gönderilen piksel isteğini aldıktan sonra Attribution-Reporting-Register-Trigger üstbilgisiyle yanıt verin.

   Bu başlıkta, raporlarda gösterilmesini istediğiniz tetikleyici verileri belirtin. Bu başlığı herhangi bir yanıt ayarlayabilir. destination ile eşleşen bir siteden yapılan isteğe yanıt verildiği sürece kaynaklar eşleştirilir. Üstbilgi alındığında tarayıcı, eşleşen kaynakları arar ve bir rapor planlar.

   Etkinlik düzeyindeki raporlara örnek:

   {
     "event_trigger_data": [{
       "trigger_data": "[unsigned 64-bit integer]",
       "priority": "[signed 64-bit integer]",
       "deduplication_key": "[unsigned 64-bit integer]"
     }]
   }
   

   Özet raporları ö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 çalışma

destination, https://advertiser.example ise hem https://advertiser.example hem de alt alan adlarındaki (ör. https://shop.advertiser.example) dönüşümler ilişkilendirilebilir.

destination, https://shop.advertiser.example ise hem https://advertiser.example hem de https://shop.advertiser.example üzerindeki dönüşümler ilişkilendirilebilir.

Zorunlu ve isteğe bağlı özellikler

HTML öğelerini kullanırken veya tetikleyicileri 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 parametrenin kullanılması isteğin İlişkilendirme Raporları için uygun olduğunu gösterir. attributionsrc kullanıyorsanız tarayıcı, attributionsrc başlığını gönderir.Attribution-Reporting-Eligible Ayrıca uygulamadan web'e ölçüm için de kullanışlıdır: attributionsrc mevcutsa tarayıcı Attribution-Reporting-Support üstbilgisini gönderir.

1. adım: Tetikleyici kaydını başlatın

Piksel (<img> etiketi) veya komut dosyası etiketi kullanarak tetikleyici kaydedebilirsiniz.

Yeni veya mevcut bir dönüşüm pikseli kullanma

Aşağıdaki örnekte, attributionsrc özelliği eklenerek mevcut bir resimde ilişkilendirme tetiklenir.

attributionsrc için kaynak, 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şkilendirme tetiklenir.

src için kaynak, kaynak kaydını gerçekleştiren kaynakla eşleşmelidir.

<img src="https://adtech.example/conversionpixel"
     attributionsrc>

Komut dosyası etiketi kullanma

Bir komut dosyası etiketiyle tetikleyici kaydı gerçekleştirebilirsiniz. Bu etiket, <img> ile aynı şekilde çalışır. Aşağıdaki kod örnekleri, fetch() ve XMLHttpRequest() (XHR) kullanımını göstermektedir.

Bu kod, attributionsrc içeren bir HTML isteğinin yapacağı işlemi 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 değerle veya değersiz olarak 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 değer, boşlukla ayrılmış bir veya daha fazla URL olabilir.

URL kullanıldığında tarayıcı, Attribution-Reporting-Eligible isteği üstbilgisini içeren ayrı bir etkin tutma getirme isteği başlatır (her URL için bir tane).

Tetikleyici kaydını, öğenin ana isteğinden ayrı bir isteğe yanıt vererek yapmak istiyorsanız bu seçenek kullanışlıdır.

Örneğin, bir resim öğesinde tetikleyicileri kaydetmeniz gerekiyorsa resim yanıtını kontrol etmiyor olabilirsiniz. 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 isteyebilirsiniz. attributionsrc için açık bir değer belirterek tarayıcıya bu ek isteği yapmasını ve hedefi yapılandırmasını söylersiniz.

2. adım: Başlık içeren bir yanıt gönderin

Tarayıcı isteğini aldıktan sonra yanıt verin ve yanıtınıza Attribution-Reporting-Register-Trigger üstbilgisini 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ı kaydetmeyi öğrenin.