8 Eylül 2025'ten sonra yapılandırılmış veri dosyalarını yüklemek için v9'a geçmeniz gerekebilir. Daha fazla bilgi için destek sonlandırma sayfamıza, adım adım talimatlar için ise v9 taşıma kılavuzumuza bakın.
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Son güncelleme: 21.08.2025
Bu kılavuzda aşağıdaki işlemler açıklanmaktadır:
Display & Video 360 kullanıcı arayüzünü veya API'yi kullanarak seçtiğiniz yapılandırılmış veri dosyaları sürümünü v9'a güncelleyin.
Entegrasyonunuzu, desteği sonlandırılan Yapılandırılmış Veri Dosyaları sürümlerinden (v7, v7.1, v8 veya v8.1) v9'a taşıyın. Bu araç, mevcut sürümünüz ile v9 arasındaki ve entegrasyonunuzu etkileyebilecek değişikliklerin ayrıntılı olarak açıklandığı sayfalara yönlendirir. Bazı durumlarda, 8 Eylül 2025'ten itibaren SDF'leri yüklemek için v9'u kullanmanız gerekecektir.
Yapılandırılmış Veri Dosyaları sürümünüzü güncelleme
v9'u kullanmak için kaynaklarınızı ve SDF oluşturma işlemlerinizi, yapılandırılmış veri dosyalarını indirirken ve yüklerken v9'u kullanacak şekilde güncellemeniz gerekir.
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
Varsayılan yapılandırılmış veri dosyaları sürümünü iş ortağı ve reklamveren kaynağı düzeyinde ayarlarsınız. Bu sürüm, arayüz veya API aracılığıyla Yapılandırılmış Veri Dosyaları indirilirken varsayılan olarak kullanılır.
Arayüzde ayarlama
İş ortağı düzeyinde:
İlgili iş ortağına gidin.
Sol gezinme menüsündeki İş Ortağı Ayarları menüsünde 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ı v9 olarak güncelleyin.
Reklamveren düzeyinde:
Hedeflenen reklamverene gidin.
Sol gezinme menüsündeki Reklamveren Ayarları menüsünde 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ı v9 olarak güncelleyin. Varsayılan sürüm iş ortağı düzeyinde ayarlanmışsa bu ayar düzenlenemeyebilir.
API'de ayarlama
İş ortağı düzeyinde: API'de varsayılan SDF sürümünü iş ortağı düzeyinde ayarlayamazsınız.
Display & Video 360 API'sini kullanarak sdfdownloadtasks.create isteğinde bulunurken istek gövdesinin version alanını SDF_VERSION_9 olarak ayarlayın.
Mevcut SDF sürümünüzden geçiş yapma
Aşağıdaki sayfalarda, mevcut sürümünüzden v9'a geçerken entegrasyonunuzda yapmanız gereken güncellemeler açıklanmakta ve sürümler arasındaki tüm değişikliklerin kapsamlı bir listesi verilmektedir:
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-21 UTC."],[],[],null,["# Migrate to Structured Data Files v9\n\n*Last update: 2025-08-21*\n\nThis guide leads you through these processes:\n\n- Update your selected Structured Data Files version to v9 using the Display \\& Video 360 UI or API.\n- Migrate your integration from deprecated Structured Data Files versions (v7, v7.1, v8, or v8.1) to v9. It points you to pages detailing the changes between your current version and v9 that may impact your integration. In some cases, you will have to use v9 to upload SDFs starting on September 8, 2025.\n\nSee the [migration pages specific to each version](#migrate_from_your_current_sdf_version) for an\nexhaustive list of differences between your version and v9.\n\nUpdate your Structured Data Files version\n-----------------------------------------\n\nTo use v9, you must update your resources and SDF generation actions to use v9\nwhen downloading and uploading Structured Data Files.\n\n### Update Structured Data Files version\n\nTo use a new Structured Data Files version, update the assigned version in your\nparent Partner and Advertiser resources and use the new version when creating\nindividual download tasks in the [Display \\& Video 360 API](/display-video/api/guides/getting-started/overview).\n\n#### Update parent resource settings\n\nYou set the default Structured Data Files version at the partner and advertiser\nresource level. This version is used as the default when downloading Structured\nData Files through the interface or API.\n\n##### Set in the interface\n\n**At the partner level:**\n\n1. Navigate to the intended partner.\n2. Go to the **Basic Details** page under the **Partner Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the Structured Data Files section to **v9**.\n\n**At the advertiser level:**\n\n1. Navigate to the intended advertiser.\n2. Go to the **Basic Details** page under the **Advertiser Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v9**. If the default version is set at the Partner level, this setting may not be editable.\n\n#### Set in the API\n\n**At the partner level:** You cannot set the default SDF version at the Partner\nlevel in the API.\n\n**At the advertiser level:** Make an [`advertisers.patch`](/display-video/api/reference/rest/current/advertisers/patch) request to\nupdate the\n[`dataAccessConfig.sdfConfig.sdfConfig.version`](/display-video/api/reference/rest/current/SdfConfig#FIELDS.version) to\n`SDF_VERSION_9` and, if needed,\n[`dataAccessConfig.sdfConfig.overridePartnerSdfConfig`](/display-video/api/reference/rest/current/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config)\nto True.\n\n### Update `sdfdownloadtasks.create` requests in the API\n\nWhen making a [`sdfdownloadtasks.create`](/display-video/api/reference/rest/current/sdfdownloadtasks/create) request using the\nDisplay \\& Video 360 API, set the [`version`](/display-video/api/reference/rest/current/sdfdownloadtasks/create#body.request_body.FIELDS.version) field of the request body to\n`SDF_VERSION_9`.\n\nMigrate from your current SDF version\n-------------------------------------\n\n| **Important:** The only new feature in v9 is the ability to declare whether a line item will serve EU political ads. This column will be required starting **September 8, 2025**.\n\nThe following pages walk you through the necessary updates to make to your\nintegration when migrating from your current version to v9 and provide a\ncomprehensive list of all changes between the versions:\n\n- [Migrate from v7](/display-video/api/structured-data-file/v7/migrate-to-v9)\n- [Migrate from v7.1](/display-video/api/structured-data-file/v7-1/migrate-to-v9)\n- [Migrate from v8](/display-video/api/structured-data-file/v8/migrate-to-v9)\n- [Migrate from v8.1](/display-video/api/structured-data-file/v8-1/migrate-to-v9)"]]
