SegmentRequest'i ayrıştırma

Google, Anlık Seçme işleminde bir veya daha fazla gösterimi açıklayan sinyaller sağlamak için seçme 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 kürasyon 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çme 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

Bağlamsal sinyaller, 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 veya SegmentRequest.app 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 veya SegmentRequest.app doldurulabilir.
  • SegmentRequest.pub: Gösterimi oluşturan medyanın yayıncısını (ör. yayıncının kimliği) tanımlar.
  • SegmentRequest.user: Kullanıcıların kişisel verilerinin nasıl işlenebileceğiyle ilgili tercihlerini açıklar. Örneğin, TCF izin dizesiyle.
  • SegmentRequest.device: Cihazla ilgili bilgileri (ör. cihazın metropol düzeyinde kesin coğrafi konumu) açıklar.

SegmentResponse içinde döndürülecek geçerli veri segmentlerini belirleyebilen bir düzenleme mantığı 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şmayı seçtiği verilerdir. Bu bilgiler, reklam isteğinde Google ile paylaşılmadan önce karartılır ve Anlık Seçim'de SegmentRequest.user.eids.uids.id içinde karartılmış biçimde görünür.

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çim uç noktası

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

Sonraki adımlar