Rapor İsteği Dosyanın Kendisi Değildir
Amazon Reports API içinde rapor oluşturma isteği, bir rapor kimliği döndürür. Bu kimlik indirilmeye hazır dosyanın içeriği değildir. Operasyon ekranında yalnız numara görülmesi raporun hazır olduğu anlamına gelmez. İşletme hangi rapor türünü, hangi satıcı ve mağaza için istediğini önce belirlemelidir. Aynı adla tekrar oluşturulan raporlar farklı kayıtlar olabilir. İnceleme notu bu yüzden dosya adından önce satıcı, rapor türü ve reportId ilişkisini taşır. Belge indirme aşamasına geçilirken istenen raporun işleme sonucunun tamamlandığı ayrıca doğrulanır.
Belge Kimliğini Doğru Kullanmak
Rapor hazır olduğunda indirme bilgisi reportDocumentId üzerinden alınır. Meta verideki rapor kimliğiyle belge kimliği aynı alana yazılmamalıdır. Amazon belgesi, kimliklerin satıcı kapsamıyla birlikte değerlendirildiğini açıklar. Çok mağazalı bir uygulamada başka satıcının başarılı indirme sonucu bu hesabın raporu için kanıt oluşturmaz. Teknik ekip indirme çağrısında hangi belgeyi istediğini açıklayabilmelidir. Bir kayıt bulunamadığında önce kimlik türü ve satıcı ilişkisi kontrol edilir. Raporu yeniden üretmek, yanlış belge kimliği kullanılan çağrının nedenini tek başına düzeltmez; mevcut kayıt zinciri korunur.
Geçici İndirme Bağlantısı
getReportDocument yanıtında rapor içeriği için önceden imzalanmış bir URL bulunur. Amazon bu bağlantının kısa süreyle geçerli olduğunu belirtir. Uzun süre sonra aynı adresin açılmaması raporun silindiğini veya rapor verisinin boş olduğunu kanıtlamaz. Bu durumda belgeye ait güncel indirme bilgisi yeniden alınır. Bağlantı, herkesin kullanacağı kalıcı rapor adresi gibi saklanıp paylaşılmaz. İşletmenin sonuç kaydı raporun kendisini ve indirme işlemini ayırır. Teknik ekip geçici adres yerine kimlik zinciri üzerinden izleme yaparsa süresi dolan bağlantılar veri kaybı diye raporlanmaz.
Amazon Rapor Belgesini Oluşturma ve İndirme
İsteği Eşleştirin: Satıcı, rapor türü ve reportId kaydını birleştirin. Belgeyi Alın: reportDocumentId üzerinden güncel indirme bilgisi alın. İçeriği Okuyun: Sıkıştırma, biçim ve yetki kapsamıyla doğru raporu açın. İşlem kapsamını açıklayan temsili şemadır; gerçek hesap ekranı veya yapılmış müşteri testi değildir. Şema kavramsal anlatımdır; gerçek panel ekranı, müşteri verisi veya yapılmış test sonucu değildir.
Sıkıştırma ve Dosya Biçimi
Amazon yanıtı compressionAlgorithm bilgisi taşıyabilir. İndirilen içerik bu bilgiye göre açılmalıdır; sıkıştırılmış veriyi doğrudan tablo gibi okumak anlaşılmaz karakterler üretir. Aynı şekilde rapor türünün XML, CSV veya sekmeyle ayrılmış dosya üretmesi okuma yöntemini değiştirir. Bir dosyanın bilgisayara ulaşması, sütunların doğru yorumlandığını göstermez. Özellikle alan adları ve karakter kodlaması incelenmelidir. Belgedeki örnek kod tek bir metin okuma yaklaşımını gösterir; bütün raporların aynı biçimde olduğu varsayılmaz. Hata, indirme aşamasında mı ayrıştırmada mı oluşuyor sorusu açıklaştırılır ve uygun kayıt üzerinden ilerlenir.
Hassas Raporlara Erişim
Bazı rapor türleri kişisel bilgiler nedeniyle kısıtlı erişim gerektirir. Amazon, böyle raporlarda ilgili yetki ve uygun Restricted Data Token kapsamını açıklar. Bütün rapor indirmeleri için aynı erişim şartı varsayılmaz. İlgili rapor türünün koşulu okunur. İçerik saklanırken Amazon'un şifreli saklama gereksinimi korunur; ham müşteri verileri geçici dosyalarla gereksiz yere çoğaltılmaz. Destek notuna tam indirme adresi, erişim jetonu veya müşteri adresleri eklenmez. İnceleme, hata açıklaması ve gizli olmayan rapor kimlikleri üzerinden yeterince izlenebilir tutulabilir; erişim sorumlusu belirlenir.
Tamamlanma Ölçütü
İşin tamamlanması, doğru raporun doğru belge üzerinden okunabildiğini göstermelidir. Oluşturma isteği, işleme sonucu, indirme bilgisi ve dosyanın okunması ayrı kontrollerdir. Bir aşama başarısızsa rapor türü değiştirilmeden önce hatanın yeri belirlenir. Kapanış notu kullanılan satıcı kapsamını, rapor kimliğini ve içerik biçimini belirtir. Dosyanın indirilmesi içindeki bütün ticari alanların doğrulandığı şeklinde sunulmaz; veri kapsamı kendi değerlendirmesini gerektirir. Böylece ekip aynı raporu gereksiz yere yeniden üreterek sorunu gizlemek yerine hangi aşamada müdahale gerektiğini anlayabilir.
Bu Yazıdaki Terimler 1 Kavram
Kısa açıklamaları burada okuyabilir, ayrıntılar için sözlüğe geçebilirsiniz.
- URL
- URL (Uniform Resource Locator), internetteki bir sayfaya, belgeye, görsele ya da başka bir kaynağa denk gelen, standart biçimde oluşturulmuş karakter dizisi, kısaca adrestir. Türkçe karşılığı “Birörnek Kaynak Konumlayıcı” ya da “Tekdüzen Kaynak Bulucu”dur;…
Bu Konuda Nasıl Destek Oluyoruz?
AdPix’in bu alandaki hizmet kapsamını ve çalışma sürecini inceleyin.
Amazon