Yapılandırılmış Veri Dosyaları (SDF'ler), özel olarak biçimlendirilmiş CSV dosyalarıdır. Bu API'ler, Display & Video 360'ta kaynakların toplu olarak alınmasına, oluşturulmasına ve düzenlenmesine olanak tanır. SDF'leri indirip düzenleyerek ve ardından yeniden yükleyerek kaynaklarda toplu olarak güncelleme yapın.
Display & Video 360 kullanıcı arayüzü, SDF indirme ve yükleme işlemlerini destekler. Display & Video 360 API, SDF indirmelerini destekler.
Formatlar
SDF'ler iki temel biçimden birini kullanır: Standart ve Kalite Kontrolü:
- Standart biçimdeki dosyaları indirebilir ve yükleyebilirsiniz. Bu dosyalardaki veriler, yükleme sırasında doğruluğu sağlamak için sayısal kimlikler kullanabilir. Verilerin yorumlanması için referans bilgileri gerekebilir.
- Kalite güvencesi biçimindeki dosyaları indirebilirsiniz. Bu dosyalar, standart biçimli dosyalarla aynı verileri sağlar ancak daha kolay okunabilen değerler kullanır. Örneğin, bazı sütunlarda kimlikler yerine görünen adlar kullanılabilir. Bu biçime özel sütunlar "Qa" sonekini kullanır.
Dosya türleri
SDF, yedi kaynak türünü destekler. Her kaynak türünün kendi sütun yapısına sahip kendi dosya türü vardır. Desteklenen kaynak türleri şunlardır:
- Kampanya
- Kampanya Siparişi
- Satır Öğesi
- Reklam Grubu
- Reklam
- Envanter Kaynağı
- Medya Ürünü
Yalnızca Satır Öğesi ve Reklam Grubu dosya türleri QA biçimini destekler.
Yeni SDF sürümleri düzenli olarak yayınlanır ve önceki sürümlerin desteği sonlandırılır. Yeni sürümlerde dosya türü sütunu yapısı güncellenir. Gerekirse yeni SDF sürümü, kullanıma sunulduğunda taşıma kılavuzu içerecektir.
Hataları indir
SDF indirmeleri iki tür hataya neden olabilir: Dosya oluşturma hataları ve Atlanan kaynaklar.
Dosya oluşturma hataları
SDF oluşturma işlemi hatayla sonlanabilir. Display & Video 360 API kullanılırken oluşturma işlemi başarısız olursa tamamlanan görev, error alanını Status nesnesiyle ayarlar. Status nesnesi, hatanın nedenini açıklayan bir mesaj içerir.
Bu hatalar hakkında daha fazla bilgiyi Hatalar ve uyarılar kılavuzu sayfamızda bulabilirsiniz.
Atlanan hatalar
SDF'ler tüm kaynak alt türlerini desteklemez. Bir kaynak SDF'ye dahil edilemiyorsa indirme işlemine "Atlandı" dosyası (örnek: SDF-LineItems-Skipped.csv) eklenir. Bu dosya iki sütunlu bir yapıya sahiptir. İlk sütun, atlanan kaynağı tanımlar. İkinci sütunda hariç tutulma nedenleri açıklanır.
Dosya yükleme
Yeni kaynaklar oluşturmak veya mevcut kaynakları güncellemek için Display & Video 360 kullanıcı arayüzünü kullanarak SDF'leri yükleyin.
SDF'lerle kaynak güncellerken veya oluştururken hataları en aza indirmek için aşağıdaki adımları uygulayın:
- Display & Video 360 API veya kullanıcı arayüzünü kullanarak SDF'leri indirin.
- Mevcut kaynaklarda güncelleme yapmak için mevcut dosya girişlerini değiştirin.
- Yeni kaynaklar oluşturmak için dosya girişleri ekleyin.
- Yeni veya güncellenmemiş girişleri kaldırın. Bu, dosya boyutunu küçültür ve yanlışlıkla güncelleme yapma ihtimalini ortadan kaldırır.
- Dosyayı Display & Video 360 kullanıcı arayüzüne yükleyin.
Bir SDF yüklendikten ve işlendikten sonra SDF-ResultFile.zip dosyası indirilebilir. Bu ZIP dosyası iki olası dosya içerebilir:
SDF-{ResourceType}-Updated-ResultFile.csv, başarılı bir şekilde güncellenen veya oluşturulan kaynakları listeler.- Başarısız işlemleri ve ilgili hata mesajlarını listeleyen
SDF-{ResourceType}-Failed-ResultFile.csv.
ZIP dosyası, dosyalardan birini veya ikisini birden içerebilir.