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

  1. Tetikleyici kaydını başlatın. İstekte bulunmak 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.

    Piksel isteği alındıktan sonra (normal src özelliğinde tanımlanan uç noktaya veya attributionsrc kullanmayı seçip buna bir değer verdiyseniz attributionsrc 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'})

Sonraki adımlar

İlişkilendirme kaynaklarını nasıl kaydedeceğinizi öğrenin.