Son güncelleme: 18.10.2023
Bu kılavuzda, önceki bir sürümden Yapılandırılmış Veri Dosyaları (SDF) sürüm 7'ye geçiş süreci ve entegrasyonunuzu daha da optimize etmek için yapabileceğiniz zorunlu ve önerilen değişiklikler ele alınmaktadır.
6. sürüm ile 7. 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ı sürüm 7'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üncelleme
Yeni bir yapılandırılmış veri dosyası sürümüne güncellemek için üst iş ortağınıza ve reklamveren kaynaklarınıza atadığınız sürümü ve Display & Video 360 API'deki bağımsız indirme görevlerini güncellemeniz gerekir.
Ü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ğı düzeyinde
- İstenen iş ortağına gidin. Sol gezinme menüsündeki İş Ortağı Ayarları'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.
- Reklamveren düzeyinde
- İstenen reklamverene gidin. Soldaki gezinme menüsünde Reklamveren Ayarları'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 iş ortağı seviyesinde ayarlanmışsa bu ayar düzenlenemeyebilir.
API'de ayarlanır.
- Reklamveren düzeyinde
dataAccessConfig.sdfConfig.sdfConfig.versionöğesiniSDF_VERSION_7ve gerekirsedataAccessConfig.sdfConfig.overridePartnerSdfConfigöğesiniTrueolarak güncellemek içinadvertisers.patchisteğ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_7 olarak ayarlayın.
Gerekli sütunlardaki kimlikleri güncelleme
7. sürümde, 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ı kimlikler kullanan her sütun ve yeni değerlerle ilgili referans bilgilerinin nasıl alınacağına dair talimatlar listelenmektedir.
Ekleme Talimatı
| Sütunlar için v7 taşıma talimatları | |
|---|---|
|
Uygulama Hedefleme - Hariç Tutma Uygulama Hedefleme - Dahil Et |
Bu sütunlar, " Uygulama platformları bir dize değeriyle tanımlanır. Uygulama kimlikleri, ilgili platform tarafından sağlanan kimliklerdir (ör. Android'in Play Store'undaki paket kimliği veya Apple'ın App Store'undaki uygulama kimliği). |
|
Tarayıcı Hedefleme - Hariç Tutma Tarayıcı Hedefleme - Dahil et |
Bu sütun, hedefleme türü
|
|
Telefon Operatörüne Göre Hedefleme - Hariç Tutma Operatör Hedefleme - Dahil et |
Bu sütun, hedefleme türü
|
|
Kanal Hedefleme - Hariç Tutma Kanal Hedefleme - Dahil et |
Bu sütun, Display & Video 360 API
|
|
Cihaz Hedefleme - Hariç Tutma 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ç Tutma Site Hedefleme - Dahil Et |
Bu sütun, siteleri URL dizeleri aracılığıyla tanımlayacak şekilde güncellendi. |
Satır Öğesi
| Sütunlar için v7 taşıma talimatları | |
|---|---|
|
Uygulama Hedefleme - Hariç Tutma Uygulama Hedefleme - Dahil Et |
Bu sütunlar, " Uygulama platformları bir dize değeriyle tanımlanır. Uygulama kimlikleri, ilgili platform tarafından sağlanan kimliklerdir (ör. Android'in Play Store'undaki paket kimliği veya Apple'ın App Store'undaki 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. uygulama satır türü, ölçüt kimlikleri için uygulama platformu ve uygulama platformu kimliğinin birleşik dize değerlerini iki nokta işaretiyle ayrılmış şekilde kullanacak şekilde güncellendi. Uygulama platformları bir dize değeriyle tanımlanır. Uygulama kimlikleri, ilgili platform tarafından sağlanan kimliklerdir (ör. Android'in Play Store'undaki paket kimliği veya Apple'ın App Store'undaki uygulama kimliği). site satır türü, ölçüt kimlikleri olarak URL dizelerini kullanacak şekilde güncellendi. |
|
Tarayıcı Hedefleme - Hariç Tutma Tarayıcı Hedefleme - Dahil et |
Bu sütun, hedefleme türü
|
|
Telefon Operatörüne Göre Hedefleme - Hariç Tutma Operatör Hedefleme - Dahil et |
Bu sütun, hedefleme türü
|
|
Kanal Hedefleme - Hariç Tutma Kanal Hedefleme - Dahil et |
Bu sütun, Display & Video 360 API
|
|
Cihaz Hedefleme - Hariç Tutma Cihaz Hedefleme - Dahil et |
Bu sütun, aşağıdaki hedefleme türleri altında Display & Video 360 API
|
Site Hedefleme - Hariç Tutma Site Hedefleme - Dahil Et |
Bu sütun, siteleri URL dizeleri aracılığıyla tanımlayacak şekilde güncellendi. |
Medya Ürünü
| Sütunlar için v7 taşıma talimatları | |
|---|---|
|
Kanal Hedefleme - Hariç Tutma 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
|
6. sürümden sonra eklenen sütunlarla entegrasyon ekleme
6. sürümden 7. sürüme geçiyorsanı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ığı Zaman Aralığı |
| YouTube Reklam Grubu | Optimize Hedefleme |
Önceki bir Yapılandırılmış Veri Dosyaları sürümünden geçiş yapıyorsanız mevcut sürümünüz ile SDF 6 sürümü arasına eklenen ek sütunlar hakkında bilgi edinmek 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 olarak desteği sonlandırılmış varlık okuma dosyalarını kullanmayı bırakmanıza yardımcı olacak bazı yüzeysel değişiklikler de yaptık.
Sütunların alt kümesi için yeni liste sıralaması
SDF v7, dosya oluşturulduktan sonra belirli liste sütunlarının sabit bir şekilde sıralanmasını sağlar. Bu sayede daha tutarlı bir davranış ve daha kolay bir inceleme elde edilir. Bu sıralama, dosya yüklenirken zorunlu kılınmaz ancak 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 kimlik aramanın diğer yollarını önermek için bazı sütunların tanımlarını güncelledik.
Aşağıdaki sütunlar tarafından döndürülen değerler SDF sürüm 6'dan farklı değildir ancak entegrasyonunuzu, kimlikleri almak için önerilen yeni yöntemi kullanarak güncellemenizi öneririz. Bu yöntem, sürüm 7 sütun açıklamalarında bulunabilir.
| Dosya türleri ve sütunları | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Kampanya |
|
|||||||||||||||||||||
| Kampanya Siparişi |
|
|||||||||||||||||||||
| Satır Öğesi |
|
|||||||||||||||||||||
| Medya Ürünü |
|
|||||||||||||||||||||
| YouTube reklam grubu |
|
|||||||||||||||||||||