Yapılandırılmış Veri Dosyaları v8'e taşı

Son güncelleme: 12.11.2024

Bu kılavuzda, Yapılandırılmış Veri Dosyaları v7.1'den v8'e geçiş sürecinde size yol gösterilir ve iki sürüm arasındaki, entegrasyonunuzu etkileyebilecek değişiklikler açıklanır.

7.1 sürümü ile 8 sürümü arasındaki farklılıkların kapsamlı bir listesi için sürüm notlarına bakın.

Yapılandırılmış Veri Dosyaları sürümünüzü taşıma

Önceki bir sürümden Yapılandırılmış Veri Dosyaları (SDF) 8. sürümüne geçmek için:

  1. Kaynaklarınızı ve SDF oluşturma işlemlerinizi v8'i kullanacak şekilde güncelleyin.
  2. Reklam kaynağı mantığını, oluşturulduktan sonra bir türü tanımlayacak şekilde güncelleyin.
  3. Talep Yaratma kaynaklarını okumak, oluşturmak ve güncellemek için yeni mantık ekleyin.

Yapılandırılmış Veri Dosyaları sürümünü güncelleme

Yeni bir yapılandırılmış veri dosyası sürümünü kullanmak için üst iş ortağı ve reklamveren kaynaklarınızda atanan sürümü güncelleyin ve Display & Video 360 API'de ayrı indirme görevleri oluştururken yeni sürümü kullanın.

Üst kaynak ayarlarını güncelleme

İş ortağı ve reklamveren kaynağı düzeyinde varsayılan bir Yapılandırılmış Veri Dosyaları sürümü ayarlanır. Bu sürüm, yapılandırılmış veri dosyaları arayüz veya API üzerinden indirilirken varsayılan olarak kullanılır.

Arayüzde ayarlanmış

İş ortağı seviyesinde

  1. Amaçlanan iş ortağına gidin.
  2. Soldaki gezinme menüsünde İş ortağı ayarları menüsünü genişletin ve Temel ayrıntılar sayfasına gidin.
  3. Yapılandırılmış Veri Dosyaları bölümündeki SDF sürümü yapılandırmasını v8 olarak güncelleyin.

Reklamveren düzeyinde

  1. Amaçlanan reklamverene gidin.
  2. Soldaki gezinme menüsünde Reklamveren ayarları menüsünü genişletin ve Temel ayrıntılar sayfasına gidin.
  3. Yapılandırılmış Veri Dosyaları bölümündeki SDF sürümü yapılandırmasını v8 olarak güncelleyin. Varsayılan sürüm iş ortağı seviyesinde ayarlanmışsa bu ayar düzenlenemeyebilir.
API'de ayarlama
İş ortağı seviyesinde
API'de varsayılan SDF sürümünü iş ortağı düzeyinde ayarlayamazsınız.
Reklamveren düzeyinde
dataAccessConfig.sdfConfig.sdfConfig.version'i SDF_VERSION_8 ve gerekirse dataAccessConfig.sdfConfig.overridePartnerSdfConfig'i True olarak güncellemek için advertisers.patch isteği gönderin.

API'deki sdfdownloadtasks.create isteklerini güncelleme

Display & Video 360 API'sini kullanarak sdfdownloadtasks.create isteği gönderirken istek gövdesinin version alanını SDF_VERSION_8 olarak ayarlayın.

Reklam kaynaklarında türü belirtin

v8, Reklam dosyalarına her satır tarafından temsil edilen reklam türünü gösteren bir Ad Type sütunu ekler. Bu yeni sütun gereklidir ve v8 reklam dosyaları indirilirken mevcut kaynaklar için doldurulur.

Mevcut reklamlar güncellenirken bu sütunun değeri değiştirilmemelidir.

Yeni reklamlar oluştururken bu sütunu, sütun açıklamasında listelenen değerlerden biriyle doldurmanız gerekir.

Talep Yaratma kaynakları için mantığı güncelleme

v8, satır öğesi, reklam grubu ve reklam dosyalarını kullanarak Talep Yaratma kampanyalarının oluşturulmasını, alınmasını ve güncellenmesini destekler. Talep Üretimi kaynakları, zaman damgası doğrulaması için farklı bir mantık kullanır, ek sütunların doldurulmasını gerektirir ve üç dosya türündeki yeni kısıtlamalarla sınırlıdır.

Zaman damgası doğrulaması

Talep Yaratma dışı tüm satır öğeleri için satır öğesi dosyasının Timestamp sütunu, indirme sırasında satır öğesinin en son değiştirildiği zamanla doldurulur. Bu değer, SDF kullanılarak bir satır öğesi güncellenirken, orijinal dosya indirildikten sonra satır öğesinin güncellenmediğini doğrulamak için kullanılır. Bu durumda güncelleme başarısız olur.

Talep Yaratma satır öğeleri için Timestamp sütunu ve eşlik eden doğrulama farklı şekilde çalışır. Talep Yaratma satır öğesi girişlerinde sütun, indirme sırasındaki geçerli saatle doldurulur. Yükleme sırasında Display & Video 360, belirtilen zaman damgasından 24 saatten uzun bir süre geçip geçmediğini kontrol eder. 24 saatten uzun süre geçtiyse orijinal dosya girişi güncel değil olarak kabul edilir ve güncelleme başarısız olur. Bu durumda dosyayı tekrar indirip güncellemelerinizi daha yeni sürüme göre yapın. Bu yeni doğrulama yöntemi, son 24 saat içinde yapılan değişikliklerin üzerine yazmanızı engellemez. Yanlışlıkla verileri üzerine yazmamak için yüklediğiniz dosyalara yalnızca güncellemek istediğiniz Talep Yaratma satır öğelerini ekleyin.

Gerekli sütunlar

Aşağıdaki dosya türlerinde, söz konusu dosya türünün tüm varlıkları için gerekli sütunlara ek olarak belirli Talep Yaratma kaynakları için artık gerekli olan sütunlar vardır.

Satır Öğesi
Aşağıdakiler için gerekli sütunlar Satır Öğesi Type sütun değerleri
Talep Yaratma
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
Aşağıdakiler için gerekli sütunlar: Ad Ad Type sütun değerleri
Talep Yaratma Bandı
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Talep Yaratma Görseli
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
Talep Yaratma Ürünü
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Talep Yaratma Videosu
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

Güncellenen kısıtlamalar

Belirli Talep Yaratma satır öğeleri ve reklamları için zorunlu olan yeni sütunlara ek olarak satır öğesi, reklam grubu ve reklam dosya türlerindeki birden fazla sütunda, Talep Yaratma kaynakları için geçerli olan yeni kullanım kısıtlamaları vardır.

Bu kısıtlamalar çok sayıdadır ve söz konusu sütunlara özeldir. Bu nedenle, bu kılavuzda kısıtlamaların kapsamlı bir listesi yer almaz. SDF yükleme özelliğini kullanarak Talep Yaratma kaynakları oluşturmadan veya güncellemeden önce satır öğesi, reklam grubu ve reklam dosya türleriyle ilgili v8 referans dokümanlarını dikkatlice okumanızı öneririz.