SegmentRequest'i ayrıştırma

Google, anlık seçimde bir veya daha fazla gösterimi açıklayan sinyaller sağlamak için seçim uç noktanıza bir JSON SegmentRequest gönderir. Bu sayede, her biri için geçerli veri segmentlerini belirleyebilirsiniz. Bu kılavuzda, SegmentRequest işleyen bir seçme mantığı geliştirme konusu ele alınmaktadır.

gzip kodlamasını kullanma

Google, uç noktanıza SegmentRequest gönderirken gzip kodlamasını kullanır. Uç noktanızın gzip kodlamasıyla alıp yanıt verebilmesi gerekir.

İçerik sinyali veya güvenli sinyal uç noktalarıyla içerik seçimi

Anlık Seçim uç noktası oluşturduğunuzda, bağlamsal sinyaller mi yoksa güvenli sinyaller mi alacağınızı seçmeniz gerekir. Seçtiğiniz sinyaller; uç noktanıza gönderilen segment isteklerinin nasıl doldurulduğunu, ne kadar envanterin uç noktanıza gönderilen segment istekleri oluşturduğunu ve entegrasyonunuzda kullanılan düzenleme mantığını etkiler.

İçerik sinyallerini kullanma

İçerik sinyalleri, gösterimin kaynağını açıklayan yayıncı, cihaz ve kullanıcı hakkındaki bilgileri içerir. Aşağıdaki listede, kullanılabilir sinyaller açıklanmaktadır:

  • SegmentRequest.site: Gösterimi oluşturan web sitesini (ör. sitenin URL'si) açıklar. SegmentRequest içinde yalnızca SegmentRequest.site ve SegmentRequest.app değerlerinden biri doldurulabilir.
  • SegmentRequest.app: Gösterimi oluşturan uygulamayı (ör. uygulamanın platforma özel uygulama tanımlayıcısı) açıklar. SegmentRequest içinde yalnızca SegmentRequest.site ve SegmentRequest.app değerlerinden biri doldurulabilir.
  • SegmentRequest.pub: Gösterimi oluşturan medyanın yayıncısını tanımlar. Örneğin, yayıncının kimliği.
  • SegmentRequest.user: Kişisel verilerinin nasıl işlenebileceğiyle ilgili kullanıcı tercihlerini açıklar. Örneğin, TCF izin dizesiyle.
  • SegmentRequest.device: Cihazla ilgili bilgileri (ör. metropol düzeyinde hassasiyete sahip coğrafi konum) açıklar.

SegmentResponse içinde döndürülecek geçerli veri segmentlerini belirleyebilen seçim mantığını uygulamak için bağlamsal sinyalleri kullanabilirsiniz.

Güvenli sinyalleri kullanma

Güvenli sinyaller, yayıncı tarafından oluşturulan ve bir veya daha fazla iş ortağıyla paylaşılmak üzere seçilen verilerdir. Reklam isteğinde Google ile paylaşılmadan önce karartılırlar ve Gerçek Zamanlı Seçim'de SegmentRequest.user.eids.uids.id içinde karartılmış biçimde görünürler.

Uç noktanız güvenli sinyalleri kullanacak şekilde yapılandırılmışsa uç noktanız yalnızca güvenli sinyalleri seçim hesabınızla paylaşmayı tercih eden yayıncıların envanteri için segment istekleri alır. Sonuç olarak, bağlamsal sinyal uç noktalarına kıyasla güvenli sinyal uç noktalarına gönderilmeye uygun toplam gösterim sayısı daha azdır.

Uç noktanızın seçim mantığı, güvenli sinyali yorumlamalı ve SegmentResponse içinde döndürülecek geçerli veri segmentlerini belirlemek için güvenli sinyali kullanmalıdır.

SegmentRequest örnekleri

Bağlamsal sinyal Gerçek zamanlı içerik seçme uç noktası

{
  "site":{
    "page":"https://dfpgpt.appspot.com/smd/"
  },
  "pub":{
    "id":"pub-1234567890987654"
  },
  "device":{
    "geo":{
      "country":"US",
        "metro":"501"
      }
    }
  }
}

Güvenli sinyal Gerçek Zamanlı Seçme uç noktası

{
  "user": {
    "eids" : [ {
      "source": "pubcid.org",
      "uids":[
        { "id" :"OMITTED_SECURE_SIGNAL" }
      ]
    }]
  }
}

Sonraki adımlar