Toplu besleme

Veri feed'leriniz, restoranınızı, hizmetlerinizi ve menünüzü Uçtan Uca Sipariş Vermeye hazır hale getirirsiniz.

Bu belgede, korumalı alan ve üretim envanterlerinizi barındırma ve toplu beslemeyi kullanma konuları ele alınmaktadır. güncellemek için Google Ads'e aktarmanızı öneririz.

Veri feed'i ortamları

Entegrasyonu geliştirebileceğiniz üç adet veri feed'i ortamı vardır:

Feed ortamı Açıklama Toplu kullanım
Korumalı Alan Feed geliştirmeniz için test ortamı. Zorunlu
Üretim Başlatmak istediğiniz envanteriniz için üretim ortamı. Zorunlu

Veri feed'lerini barındırma

Uçtan uca sipariş vermenin Korumalı Alan ve Üretim veri feed'lerinizi toplu olarak işleyebilmesi için kullanıyorsanız, veri feed'i dosyalarınızı Google Cloud Storage, Amazon S3 veya HTTPS'de site haritası.

Veri feed'lerini korumalı alan ve üretim ortamlarınız için barındırmanızı öneririz. ayrı olarak düzenleyebilirsiniz. Bu yaklaşım, korumalı alan feed ortamınızda geliştirme ve test yapmanıza olanak tanır. inceleyin.

Örneğin, barındırma seçeneği olarak Google Cloud Storage'ı kullanıyorsanız şunlara sahip olursunuz: yollar:

  • Korumalı Alan Feed'i: gs://foorestaurant-google-feed-sandbox/
  • Üretim feed'i: gs://foorestaurant-google-feed-prod/

Envanterinizi barındırmak için aşağıdakileri yapın:

  1. Veri feed'i dosyalarınızı oluşturma
  2. Bir barındırma çözümü seçin.
  3. Veri feed'lerinizi barındırın.
  4. Veri feed'i dosyalarınızın düzenli olarak güncellendiğinden emin olun. Üretim veri feed'leri güncellenmelidir günlük.

Envanter feed'i oluşturmayla ilgili ayrıntılar için Restaurant Service, ve Menu varlıkların yanı sıra Veri feed'i oluşturun bölümüne bakın.

Veri feed'i dosyalarıyla ilgili yönergeler

Birden fazla varlık içerebilen her bir dosya 200 MB'ı aşmamalıdır. Üst düzey Restaurant, Service ve Menu varlıkları ve alt varlıkların toplamı olarak 4 MB'ı aşmamalıdır.

Barındırma çözümü seçin

Aşağıdaki tabloda veri feed'lerinizi barındırma seçenekleri ve bu ana makinelerin Uçtan uca sıralama:

Amazon S3 Google Cloud Storage Site haritası ile HTTPS
Kimlik bilgileri ve erişim

Google'a aşağıdaki bilgileri sağlayın:

  • Erişim anahtarı kimliği
  • Gizli erişim anahtarı
  • Üretim ve korumalı alan S3 dizinleriniz ile marker.txt dizinlerinizin yolları dosyası olarak kaydedebilirsiniz. Yol, s3:// ile başlamalıdır.

S3 paketinde aşağıdaki bilgiler bulunmalıdır:

  • Envanterinizin feed dosyaları.
  • Getirme için kullanılan bir zaman damgasını içeren marker.txt.

Örnek marker.txt dosyası: 2018-12-03T08:30:42.694Z

Google'a üretim ve korumalı alan paket dizinlerinizin yollarını sağlayın ve marker.txt dosyası yükleyin. Yollar gs:// ile başlamalıdır.

Google danışmanınız tarafından sağlanan hizmet hesabını, Google Cloud Storage paketi.

Google Cloud Storage (GCS) erişimini kontrol etme hakkında daha fazla bilgi için Google Cloud Platform Console: Paket izinlerini ayarlama.

GCS paketinde aşağıdaki bilgiler bulunmalıdır:

  • Envanterinizin feed dosyaları.
  • Getirme için kullanılan bir zaman damgasını içeren marker.txt.

Örnek marker.txt dosyası: 2018-12-03T08:30:42.694Z

Google'a aşağıdaki bilgileri sağlayın:

  • Temel kimlik doğrulamanız için kimlik bilgileri.
  • Üretim ve korumalı alan site haritası yollarınızın yolu. Yol, https:// ile başlamalıdır.
  • Protokol: Feed dosyalarınızı HTTP üzerinden değil, HTTPS üzerinden kullanılabilir hale getirmeniz gerekir.
  • Güvenlik: Google, barındırılan feed dosyalarınızı Temel Kimlik Doğrulaması.
Google hangi dosyaların getirilmesi gerektiğini nasıl bilir? Paketteki tüm dosyaların dizin listesi. Paketteki tüm dosyaların dizin listesi. Site haritasında listelenen dosyaların tek tek URL'leri.
Google, dosyaların getirilmeye hazır olduğunu nasıl anlar? Veri feed'lerinizi oluşturmayı tamamladıktan sonra marker.txt dosyasını güncelleyin . Veri feed'lerinizi oluşturmayı tamamladıktan sonra marker.txt dosyasını güncelleyin . Veri feed'lerinizi oluşturmayı tamamladıktan sonra yanıt başlığını güncelleyin En son zaman damgasına sahip sitemap.xml metriğinizin last-modified kadarı.
Dosya sınırları

Maksimum dosya sayısı: 100.000.

Amazon S3 paketinizde toplam 100.000'den az dosya olmalıdır.

Maksimum dosya sayısı: 100.000.

Google Cloud Storage paketinizde toplam 100.000'den az dosya olmalıdır.

Maksimum dosya sayısı: 100.000.

Site haritası XML dosyanızdaki dosya yollarının sayısı 100.000'den az olmalıdır.

Toplu kullanım için veri feed'lerinizi bağlama

Feed'lerinizi barındırdıktan sonra İşlemler Merkezi'nde projenize bağlamanız gerekir. İlgili içeriği oluşturmak için kullanılan Üretim feed'lerinin ilk yapılandırması İlk Katılım Görevleri sayfasında yapılır. Daha sonra Üretim ve korumalı alan feed'leri yapılandırması, bir sağlayıcıya sahip herhangi bir portal kullanıcısı tarafından herhangi bir zamanda Yapılandırma > Feed'ler sayfasından güncellenebilir. yönetici rolündedir. Korumalı alan ortamı, geliştirme ve test amacıyla kullanılırken Üretim feed'leri kullanıcılara gösteriliyor.

Veri feed'lerinizi Amazon S3 ile barındırıyorsanız

  1. İşlemler Merkezi'nde Yapılandırma>'ya gidin Feed'ler.
  2. Düzenle'yi tıklayın ve Feed Güncelle formunu doldurun:

    • Feed yayınlama yöntemi: Amazon S3 olarak ayarlayın.
    • İşaretçi dosyası: marker.txt dosyasının URL'sini sağlayın.
    • Veri dosyaları: Veri feed'lerini içeren S3 paketinin URL'sini sağlayın.
    • Erişim kimliği: S3'ten okuma izinlerine sahip IAM erişim anahtarı kimliğini girin kaynaklar.
    • Erişim Anahtarı: S3'ten okuma izinlerine sahip IAM gizli erişim anahtarını girin kaynaklar.
  3. Gönder'i tıklayın.
  4. Bir ila iki saat sonra toplu beslemenin feed dosyalarınızı getirip getirmediğini kontrol edin.

Veri feed'lerinizi Google Cloud Storage ile barındırıyorsanız

  1. İşlemler Merkezi'nde Yapılandırma>'ya gidin Feed'ler.
  2. Düzenle'yi tıklayın ve Feed Güncelle formunu doldurun:

    • Feed yayınlama yöntemi: Google Cloud Storage olarak ayarlayın.
    • İşaretçi dosyası: marker.txt dosyasının URL'sini sağlayın.
    • Veri Dosyaları: Veri feed'lerini içeren GCS paketinin URL'sini sağlayın.
  3. Gönder'i tıklayın.
  4. GCS paketinize erişmek için bir hizmet hesabı oluşturulur. Hesap adını bulabileceğiniz yerler: İlk katılım görevlerinden sonra Yapılandırma > Feed'ler tamamlandı. Bu hizmet hesabının "Storage Eski Nesne Okuyucu" rolüne ihtiyacı var. Bu rol Google Cloud Console'un IAM sayfasında hizmet hesabına verilmiş olmalıdır.
  5. Bir ila iki saat sonra toplu beslemenin feed dosyalarınızı getirip getirmediğini kontrol edin.

Veri feed'lerinizi HTTPS ile barındırıyorsanız

  1. İşlemler Merkezi'nde Yapılandırma>'ya gidin Feed'ler.
  2. Düzenle'yi tıklayın ve Feed Güncelle formunu doldurun:

    • Feed yayınlama yöntemi: HTTPS olarak ayarlayın.
    • Site Haritası Dosyası: sitemap.xml dosyasının URL'sini sağlayın.
    • Kullanıcı adı: HTTPS sunucusuna erişmek için kullanıcı adı kimlik bilgilerini girin.
    • Şifre: HTTPS sunucusuna erişmek için şifreyi girin.
  3. Gönder'i tıklayın.
  4. Bir ila iki saat sonra toplu beslemenin feed dosyalarınızı getirip getirmediğini kontrol edin.

Örnek yollar

Aşağıdaki tabloda, barındırma seçeneklerinin her biri için örnek yollar verilmiştir:

Amazon S3 Google Cloud Storage Site haritası ile HTTPS
Path s3://foorestaurant-google-feed-sandbox/ gs://foorestaurant-google-feed-sandbox/ https://sandbox-foorestaurant.com/sitemap.xml
İşaretçi dosyası s3://foorestaurant-google-feed-sandbox/marker.txt gs://foorestaurant-google-feed-sandbox/marker.txt Geçerli değil

HTTPS barındırma için site haritaları

Site haritalarını tanımlarken aşağıdaki yönergeleri kullanın:

  • Site haritanızdaki bağlantılar dosyaların kendisine yönlendirmelidir.
  • Site haritanız kendi alan adınız yerine bir bulut sağlayıcıya referanslar içeriyorsa URL'lerin başlangıcında (ör. https://www.yourcloudprovider.com/your_id) grup işinize özel kararlı ve benzersizdir.
  • Kısmi site haritaları yüklememeye dikkat edin (kısmi veri yüklemesi olması gibi). Yapmak Bu durumda, Google yalnızca site haritasındaki dosyaları alır. Bu da envanterinizin seviyenin düşmesine neden olabilir ve feed beslemenizin engellenmesine neden olabilir.
  • Site haritasında başvurulan dosyaların yollarının değişmediğinden emin olun. Örneğin, site haritasınızın https://www.yourcloudprovider.com/your_id/10000.json referansını sağlamalısınız bugün ancak sonrasında https://www.yourcloudprovider.com/your_id/20000.json referansı yarın.
Örnek site haritası

Aşağıda, veri feed'i dosyaları sunan bir sitemap.xml dosyası örneği verilmiştir:

1. Örnek: Satıcılara göre gruplandırılmış öğeler (Önerilen).

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_1.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_2.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/restaurant_3.ndjson</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

2. Örnek: Türlere göre gruplandırılmış öğeler.

XML

<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 <url>
   <loc>https://your_fulfillment_url.com/restaurant.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/menu.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
 <url>
   <loc>https://your_fulfillment_url.com/service.json</loc>
   <lastmod>2018-06-11T10:46:43+05:30</lastmod>
 </url>
</urlset>

Veri feed'lerinizi güncelleme

Veri feed'leriniz bağlandıktan sonra, Google saatte bir güncelleme olup olmadığını kontrol eder, ancak yalnızca marker.txt veya sitemap.xml dosyaları olduğunda tüm veri feed'leri değiştirildi. Eski envanteri önlemek için veri feed'lerinizi günde bir kez güncellemenizi bekleriz.

Veri feed'lerinin değiştirildiğini ve toplu beslemeye hazır olduğunu belirtmek için marker.txt dosyasının last-modified nesne meta verisi alanı (GCP ve için S3) veya sitemap.xml dosyasının last-modified yanıt başlığı. Google , veri feed'inin ne kadar yeni olduğunu belirlemek için bu değerleri kullanır.

Toplu feed beslenirken

  • Mevcut Uçtan Uca envanterinizde bulunmayan ve hiç içermeyen yeni varlıklar hatası eklenir.
  • Halihazırda envanterde bulunan ve hatasız öğeler daha yakın bir zamanda dateModified verilerini de kullanıyorsanız dateModified olması durumunda, feed besleme başlangıç zamanı, kullanılacak geçerli girişten daha yeni güncellenecektir, aksi takdirde eski olarak işaretlenir.
  • Önceki bir feed'de yer alan ve artık dahil edilmeyen öğeler işlenen toplu feed, dosya olmadığı takdirde silinir seviye hataları.

Zaman damgası veya last-modified yanıt başlığı yalnızca tüm verilerden sonra güncellenmelidir feed dosyaları oluşturulup güncellenir. Veri feed'lerinizi güncelleyen toplu işleri yalnızca çalışacak şekilde sınırlayın günde bir kez. Alternatif olarak, her toplu işler arasında en az üç saatlik bir boşluk olmalıdır. Şunu yapmazsanız: Google eski dosyaları getirebilir.