Son güncelleme: 18.10.2023
Bu rehber, önceki bir sürümden Yapılandırılmış Veri Dosyaları (SDF) v7'ye geçiş süreci ve entegrasyonunuzu daha iyi optimize etmek için yapabileceğiniz hem gerekli hem de önerilen değişiklikler konusunda size yol gösterir.
v6 ile v7 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ı 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üncelle
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'deki bağımsız indirme görevlerinizi güncellemeniz gerekir.
Üst kaynak ayarlarını güncelle
Varsayılan bir Yapılandırılmış Veri Dosyaları sürümü, iş ortağı ve reklamveren kaynağı düzeyinde ayarlanır. Yapılandırılmış Veri Dosyaları arayüz veya API üzerinden indirilirken bu sürüm varsayılan olarak kullanılır.
Arayüzde ayarlandı
- İş ortağı düzeyinde
- İstediğiniz iş ortağına gidin. Sol taraftaki gezinme panelinde yer alan İş Ortağı Ayarları menüsünün altında 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 olarak güncelleyin.
- Reklamveren düzeyinde
- Hedef reklamverene gidin. Soldaki gezinme menüsünde yer alan Reklamveren Ayarları menüsünün altındaki 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 olarak 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.versionetiketiniSDF_VERSION_7ve gerekirsedataAccessConfig.sdfConfig.overridePartnerSdfConfigdeğeriniTrueolarak güncellemek içinadvertisers.patchisteğinde bulunun.
API'deki sdfdownloadtasks.create isteklerini güncelleyin
Display & Video 360 API'yi kullanarak bir sdfdownloadtasks.create isteğinde bulunurken istek gövdesinin version alanını SDF_VERSION_7 olarak ayarlayın.
Gerekli 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 hale getirmek için güncellendi.
Bu bölümde, v6'dan farklı kimliklerin kullanıldığı her sütun ve yeni değerlerle ilgili referans bilgilerinin nasıl alınacağıyla ilgili talimatlar listelenmiştir.
Ekleme Talimatı
| v7 Sütunlar için taşıma talimatları | |
|---|---|
|
Uygulama Hedefleme - Hariç Tut Uygulama Hedefleme - Dahil Et |
Bu sütunlar, " Uygulama platformları dize değeriyle tanımlanır. Uygulama kimlikleri, ilgili platform tarafından sağlanan kimliklerdir (ör. Android Play Store'daki paket kimliği veya Apple App Store'daki uygulama kimliği). |
|
Tarayıcı Hedefleme - Hariç Tut 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ürleri altında 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üncellendi. |
Satır Öğesi
| v7 Sütunlar için taşıma talimatları | |
|---|---|
|
Uygulama Hedefleme - Hariç Tut Uygulama Hedefleme - Dahil Et |
Bu sütunlar, " Uygulama platformları dize değeriyle tanımlanır. Uygulama kimlikleri, ilgili platform tarafından sağlanan kimliklerdir (ör. Android Play Store'daki paket kimliği veya Apple App Store'daki uygulama kimliği). |
| Teklif Çarpanları |
Bu sütun, uygulama ve site satır türleri için yeni Ölçüt Kimlikleri kullanacak şekilde güncellendi. app satır türü, ölçüt kimlikleri için iki nokta işaretiyle ayrılmış uygulama platformu ve uygulama platformu kimliğinin birleştirilmiş dize değerlerini kullanacak şekilde güncellendi. Uygulama platformları dize değeriyle tanımlanır. Uygulama kimlikleri, ilgili platform tarafından sağlanan kimliklerdir (ör. Android Play Store'daki paket kimliği veya Apple App Store'daki uygulama kimliği). Site satır türü, URL dizelerini Ölçüt kimliği olarak kullanacak şekilde güncellendi. |
|
Tarayıcı Hedefleme - Hariç Tut 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ürleri altında 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üncellendi. |
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ürleri altında Display & Video 360 API
|
v6'dan itibaren eklenen sütunlarla entegrasyon ekle
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ında 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
v7'de, entegrasyonunuzu basitleştirmenize ve referans olarak kullanımdan kaldırılan Varlık Okuma Dosyalarını kullanmanıza yardımcı olacak bazı yüzeysel değişiklikler de yaptık.
Bir sütun alt kümesi için yeni liste sıralaması
SDF v7, dosya oluşturma işleminden sonra belirli liste sütunlarının sabit bir şekilde sıralanmasını garanti eder. Bu sayede, daha tutarlı davranış ve daha kolay inceleme sağlanır. Bu sıralama, dosya yüklendiğinde 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
Desteği sonlandırılan Varlık Okuma Dosyalarına yapılan referansları kaldırmak ve bunun yerine başka kimlik arama yöntemleri önermek için çok sayıda sütunun tanımlarını güncelledik.
Aşağıdaki sütunların döndürdüğü değerler SDF v6'dakilerden farklı değildir ancak kimlikleri v7 sütun açıklamalarında bulabileceğiniz önerilen yeni yöntemi kullanarak entegrasyonunuzu güncellemenizi öneririz.
| Dosya türleri ve sütunları | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Kampanya |
|
|||||||||||||||||||||
| Kampanya Siparişi |
|
|||||||||||||||||||||
| Satır Öğesi |
|
|||||||||||||||||||||
| Medya Ürünü |
|
|||||||||||||||||||||
| YouTube Reklam Grubu |
|
|||||||||||||||||||||