Son güncelleme: 18.10.2023
Bu kılavuzda, önceki bir sürümden Yapılandırılmış Veri Dosyaları (SDF) v7 sürümüne geçiş süreci ve entegrasyonunuzu daha iyi optimize etmek için yapabileceğiniz (hem gerekli hem de önerilen) değişiklikler açıklanmaktadır.
v6 ile v7 arasındaki farkları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şıyın
Önceki bir sürümden Yapılandırılmış Veri Dosyaları v7'ye geçiş yapmak için yeni sürümü belirtmeniz, mevcut sütunların bir alt kümesi için kimlik alanlarını güncellemeniz ve yeni sütunlarla entegrasyon eklemeniz gerekir.
Yapılandırılmış Veri Dosyaları sürümünü güncelleyin
Yeni bir Yapılandırılmış Veri Dosyaları sürümüne güncelleme yapmak için üst İş Ortağı ve Reklamveren kaynaklarınıza atadığınız sürümü ve Display & Video 360 API'sinde her bir indirme görevlerinizi güncellemeniz gerekir.
Üst kaynak ayarlarını güncelle
Varsayılan Yapılandırılmış Veri Dosyaları sürümü, iş ortağı ve reklamveren kaynağı düzeyinde ayarlanır. Arayüz veya API üzerinden Yapılandırılmış Veri Dosyaları indirilirken bu sürüm varsayılan olarak kullanılır.
Arayüzde ayarla
- İş ortağı düzeyinde
- İlgili iş ortağına gidin. Sol gezinme menüsündeki İş Ortağı Ayarları menüsünün altında bulunan Temel Ayrıntılar sayfasına gidin. Yapılandırılmış Veri Dosyaları bölümünde SDF sürümü yapılandırmasını v7 olarak güncelleyin.
- Reklamveren düzeyinde
- İlgili reklamverene gidin. Sol taraftaki gezinme çubuğunda yer alan Reklamveren Ayarları menüsünün altında bulunan Temel Ayrıntılar sayfasına gidin. Yapılandırılmış Veri Dosyaları bölümündeki SDF sürümü yapılandırmasını v7'ye güncelleyin. Varsayılan sürüm, İş Ortağı düzeyinde ayarlanırsa bu ayar düzenlenemeyebilir.
API'de ayarlandı
- Reklamveren düzeyinde
dataAccessConfig.sdfConfig.sdfConfig.versionöğesininSDF_VERSION_7olarak güncellenmesi içinadvertisers.patchisteğinde bulunun ve gerekirsedataAccessConfig.sdfConfig.overridePartnerSdfConfigTrueolarak güncelleyin.
API'de sdfdownloadtasks.create isteklerini güncelle
Display & Video 360 API'sini kullanarak bir sdfdownloadtasks.create isteğinde bulunurken istek gövdesinin version alanını SDF_VERSION_7 olarak ayarlayın.
Zorunlu sütunlardaki kimlikleri güncelleyin
v7'de, bir sütun alt kümesi tarafından kullanılan kimlik alanları, Yapılandırılmış Veri Dosyalarını kullanımdan kaldırılan Varlık Okuma Dosyaları ürününden ayırmak ve Display & Video 360 API gibi desteklenen araçlarla daha uyumlu olmasını sağlamak için güncellenmiştir.
Bu bölümde, v6'dan farklı kimlikler kullanan her sütun ve yeni değerlerle ilgili referans bilgilerini alma talimatları listelenir.
Ekleme Talimatı
| v7 Sütunlar için taşıma talimatları | |
|---|---|
|
Uygulama Hedefleme - Hariç Tut Uygulama Hedefleme - Dahil Et |
Bu sütunlar, uygulama tanımlayıcılarını " Uygulama platformları, bir dize değeriyle tanımlanır. Uygulama kimlikleri, Android Play Store'dan paket kimliği veya Apple App Store'dan Uygulama Kimliği gibi ilgili platform tarafından sağlanan kimliklerdir. |
|
Tarayıcı Hedefleme - Hariç Tutma Tarayıcı Hedefleme - Dahil Et |
Bu sütun, hedefleme türü
|
|
Operatör Hedefleme - Hariç Tutma Operatör Hedefleme - Dahil Et |
Bu sütun, hedefleme türü
|
|
Kanal Hedefleme - Hariç Tut Kanal Hedefleme - Dahil Et |
Bu sütun, Display & Video 360 API
|
|
Cihaz Hedefleme - Hariç Tut Cihaz Hedefleme - Dahil Et |
Bu sütun, aşağıdaki hedefleme türlerinin altındaki Display & Video 360 API
|
| DAR Kanalını Ölçme |
Bu sütun, Display & Video 360 API
|
Site Hedefleme - Hariç Tut Site Hedefleme - Dahil Et |
Bu sütun, siteleri URL dizeleri aracılığıyla tanımlayacak şekilde güncellenmiştir. |
Satır Öğesi
| v7 Sütunlar için taşıma talimatları | |
|---|---|
|
Uygulama Hedefleme - Hariç Tut Uygulama Hedefleme - Dahil Et |
Bu sütunlar, uygulama tanımlayıcılarını " Uygulama platformları, bir dize değeriyle tanımlanır. Uygulama kimlikleri, Android Play Store'dan paket kimliği veya Apple App Store'dan Uygulama Kimliği gibi ilgili platform tarafından sağlanan kimliklerdir. |
| Teklif Çarpanları |
Bu sütun, uygulama ve site satır türlerinde yeni Ölçüt Kimlikleri kullanacak şekilde güncellenmiştir. Uygulama satır türü, ölçüt kimlikleri için uygulama platformu ve uygulama platformu kimliğinin iki nokta ile ayrılmış şekilde birleştirilmiş dize değerlerini kullanacak şekilde güncellendi. Uygulama platformları, bir dize değeriyle tanımlanır. Uygulama kimlikleri, Android Play Store'dan paket kimliği veya Apple App Store'dan uygulama kimliği gibi ilgili platform tarafından sağlanan kimliklerdir. site satır türü, Ölçüt kimlikleri olarak URL dizeleri kullanacak şekilde güncellenmiştir. |
|
Tarayıcı Hedefleme - Hariç Tutma Tarayıcı Hedefleme - Dahil Et |
Bu sütun, hedefleme türü
|
|
Operatör Hedefleme - Hariç Tutma Operatör Hedefleme - Dahil Et |
Bu sütun, hedefleme türü
|
|
Kanal Hedefleme - Hariç Tut Kanal Hedefleme - Dahil Et |
Bu sütun, Display & Video 360 API
|
|
Cihaz Hedefleme - Hariç Tut Cihaz Hedefleme - Dahil Et |
Bu sütun, aşağıdaki hedefleme türlerinin altındaki Display & Video 360 API
|
Site Hedefleme - Hariç Tut Site Hedefleme - Dahil Et |
Bu sütun, siteleri URL dizeleri aracılığıyla tanımlayacak şekilde güncellenmiştir. |
Medya Ürünü
| v7 Sütunlar için taşıma talimatları | |
|---|---|
|
Kanal Hedefleme - Hariç Tut Kanal Hedefleme - Dahil Et |
Bu sütun, Display & Video 360 API
|
| Cihaz Hedefleme - Dahil Et |
Bu sütun, aşağıdaki hedefleme türlerinin altındaki Display & Video 360 API
|
Sürüm 6'dan itibaren eklenen sütunlarla entegrasyon ekleme
v6'dan v7'ye geçiş yapıyorsanız ilgili dosyalara aşağıdaki sütunları eklemeniz gerekir:
| Dosya türü | Sütun |
|---|---|
| Satır Öğesi | TrueView Hedef Sıklık Sayısı |
| Satır Öğesi | TrueView Hedef Sıklık Zaman Aralığı |
| YouTube Reklam Grubu | Optimize Hedefleme |
Önceki bir Yapılandırılmış Veri Dosyaları sürümünden veri taşıyorsanız mevcut sürümünüz ile SDF 6 sürümü arasına eklenen ek sütunlar hakkında bilgi için Yapılandırılmış Veri Dosyaları sürüm notlarına bakın.
Ek değişiklikler
7. sürümde, entegrasyonunuzu basitleştirmenize ve referans amacıyla kullanımdan kaldırılan Varlık Okuma Dosyalarını kullanmaktan vazgeçmenize yardımcı olacak bazı yüzeysel değişiklikler de yaptık.
Bazı sütunlar için yeni liste sıralaması
SDF sürüm 7, dosya oluşturulduktan sonra belirli liste sütunlarının sabit bir şekilde sıralanmasını garanti eder. Bu, daha tutarlı davranışlar ve daha kolay inceleme sağlar. Bu sıralama dosya yükleme sırasında zorunlu kılınmaz, ancak daha sonra, güncellenen dosya oluşturulurken uygulanır.
Artık artan sayısal veya alfabetik sırayla oluşturulan sütunların tam listesi için v7 sürüm notlarını inceleyin.
Yeni kimlik referansı önerileri
Kullanımdan kaldırılan Varlık Okuma Dosyalarına yapılan referansı kaldırmak ve bunun yerine diğer kimlik arama yöntemlerini önermek için birkaç sütunun tanımlarını güncelledik.
Aşağıdaki sütunların döndürdüğü değerler SDF 6 sürümünden farklı değildir ancak kimlikleri almak için entegrasyonunuzu, önerilen yeni yöntemi (v7 sütun açıklamalarında bulabilirsiniz) kullanarak güncellemenizi öneririz.
| Dosya türleri ve sütunları | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Kampanya |
|
|||||||||||||||||||||
| Kampanya Siparişi |
|
|||||||||||||||||||||
| Satır Öğesi |
|
|||||||||||||||||||||
| Medya Ürünü |
|
|||||||||||||||||||||
| YouTube Reklam Grubu |
|
|||||||||||||||||||||