Sorgu yapısı

Metrik ve segment alanlarıyla ilgili sorgular reports.search yöntemidir. Merchant Center Sorgu Dili'nde sorgu oluşturmak için önce dil dil bilgisini kullanarak sorgu oluşturun. Bir sorgu, bir dizi ifadeden oluşur:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

Maddeler; alan adlarını, tablo adlarını, operatörleri, koşulları ve siparişleri inceleyin. Tek bir öğede birleştirildiğinde Google Content API for Shopping kullanılarak istek yapılabilir. Her birinin ifadesi kullanılabilir.

Maddeler

SEÇ

SELECT ifadesi, istekte getirilecek alanları belirtir. SELECT. segment alanlarının ve metriklerinin virgülle ayrılmış bir listesini alıp değerleri döndürerek kullanıcı olabilir. Bir sorguda SELECT ifadesi zorunludur.

Belirli bir tablodan tıklama metriklerini seçen örnek bir sorgu aşağıda verilmiştir:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Tek bir istekte farklı alan türlerini de sorgulayabilirsiniz:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
  • Segment alanları

    • segments.date
    • segments.program
  • Metrikler

    • metrics.impressions
    • metrics.clicks

Aşağıdaki nedenden dolayı SELECT yan tümcesinde bazı alanlara izin verilmez kısıtlama:

  • En az bir metrik alanı olmayan segment alanları sorgulanıyor.

Yukarıdaki koşulla ilgili bilgileri referans belgelerimizde bulabilirsiniz.

FROM

FROM ifadesi, istekte verilerin alınacağı tabloyu belirtir. İlgili içeriği oluşturmak için kullanılan FROM yan tümcesindeki tablo, diğer tüm reklamverenler tarafından hangi alanların kullanılabileceğini tanımlar. ifadelerini ifade eder. Yalnızca tek bir tablo belirtilebilir FROM ifadesi Şu anda yalnızca MerchantPerformanceView tablosu desteklenmektedir. FROM ifadesi,search reports hizmet.

WHERE

WHERE ifadesi, isteğinde bulunabilirsiniz. WHERE koşulunu kullanırken bir veya daha fazla koşul belirtilebilir AND kullanarak ayırın. Her koşul kalıbına uymalıdır field_name Operator value WHERE içinde herhangi bir segment alanı kullanılabilir ifadesini kullanabilirsiniz, ancak SELECT yan tümcesinde metrik alanlarının WHERE ifadesinde kullanılır. Bir sorguda WHERE ifadesi zorunludur, her zaman anahtar verilerinizi istediğiniz zaman performans verileri döndürüyor.

Aşağıda, belirli bir zamandaki metrikleri döndürmek için WHERE kullanımıyla ilgili bir örnek verilmiştir dönem:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Verileri filtrelemek için birden fazla koşulu birleştirebilirsiniz. Bu örnek, SHOPPING_ADS programı için teklif başına tıklama sayısı > belirtilen 30 günlük dönemde 100.

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN 2020-08-01 AND 2020-08-31;

Aşağıdaki sorguda segments.date öğesinin seçildiğini göreceksiniz. segments.date'i seçip seçmediğinize bakılmaksızın, Performans verilerini almak için her zaman WHERE koşulunun sağlanması gerekir.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31

Filtreleme sırasında, operatörünüzün büyük/küçük harfe duyarlılığını zihin.

Operatörlerin tam listesi için şuraya bakın: dil dilbilgisi.

ORDER BY

ORDER BY ifadesi, sonuçların hangi sırada gösterileceğini belirtir. geri döndü. Bu sayede verileri artan veya azalan düzende sıralayabilirsiniz bir alan adına göre. Her sıralama field_name ve ardından gelen değer olarak belirtilir ASC veya DESC. ASC veya DESC belirtilmezse sipariş varsayılanları ASC numaralı telefona. Yalnızca SELECT yan tümcesinde belirtilen alanlar kullanılabilir ORDER BY ifadesi. ORDER BY yan tümcesi sorgularda isteğe bağlıdır.

Aşağıdaki sorgu, döndürülen satırları tıklama sayısına göre en yüksekten ile en düşük:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.clicks DESC

Virgülle ayrılmış değer kullanarak ORDER BY yan tümcesinde birden çok alan belirtebilirsiniz liste'ye dokunun. Sıralama, sorguda belirtilen sırayla gerçekleşir. Örneğin, bu sorguda sonuçlar şu ölçüte göre artan düzende sıralanır: offer_id, ardından gösterim sayısına göre azalan sırada, ardından tıklama sayısına göre azalan sırada:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

LIMIT yan tümcesi, döndürülecek sonuç sayısını belirtmenize olanak tanır. Bu, yalnızca özetle ilgileniyorsanız yararlı olur.

Örneğin, LIMIT sorgusu için toplam sonuç sayısını kısıtlamak amacıyla kullanılabilir. şu sorgu:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN 2020-08-01 AND 2020-08-31
ORDER BY metrics.impressions DESC
LIMIT 50