Genel bakış

Reporting API

Reporting API, satıcıların performans verileriyle etkileşimde bulunmasını sağlar Merchant Center Sorgu Dili aracılığıyla programatik olarak. Şuna benzer: sahip olma özel raporlar oluşturma Merchant Center'da bulabilirsiniz. Reporting API'nin sunduğu avantajlar şunlardır:

• Büyük satıcıların ürün listelemelerine ait performans verilerini Google Ads'e aktarmasına olanak tanır. rapor sistemlerine göz atın.
• Satıcıyı yöneten kullanıcılara, üçüncü taraf iş ortaklarına ve toplayıcılara izin verir Merkezi hesap erişim raporları.

API kullanıcıları, Arama yanıtı, örneğin:

• Döndürülecek metrikler (ör. Tıklamalar, Gösterimler)
• Verilerin segmentlere ayrılacağı boyutlar (ör. OfferId, Tarih)
• Karşılanması gereken koşullar (örneğin: Tıklamalar > 100)

Reporting API sorgu dili, Content API for Shopping'i performans metriklerini (tıklamalar, gösterimler), çeşitli ölçütlere göre segmentlere ayrılmış boyutları (program, tarih ve ürün gibi bildirilen etkinlik özellikleri) marka, kategori vb. gibi özellikleri) kullanarak kampanya düzeyinde Search yöntemini kullanarak Reports hizmeti.

Reports hizmetine yapılan sorgu sonucunda ReportRow listesi oluşturulur örnekleri (her ReportRow, istenen metriklerin değerlerini temsil eder) seçmeniz gerekir. Hiçbir segment belirtilmezse tek bir segment satırı, tüm segmentler genelinde toplanan metriklerle döndürülür. Aksi takdirde Segmentler metriklerle birlikte istenir, ardından yanıtta şunun için bir satır gösterilir: her bir benzersiz segment deleni. Birden fazla segment seçebilir ve tek bir sorguda birden çok metrik olması gerekir.

Metrikler için sorgu

İstediğiniz metrikleri (Tıklamalar, Gösterimler, TO vb.) için sorgulayabilirsiniz geri döndü. Raporları sorgulamak için tarih aralığına bir filtre eklemeniz gerekir. hizmet. Aşağıdaki örnek sorgu tek bir satır döndürür: toplam tutar belirli bir tarih aralığının eklenen koşulu içinde gerçekleşen tıklamaların sayısı.

SELECT metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-21';

Örnek yanıt

Aşağıdaki örnek JSON kodu yanıtı,bu satıcının nasıl 4.440 tıklama aldığını göstermektedir ve tüm ürünleri genelinde toplanmış olması gerekir. 1 Aralık 2020 ve 21 Aralık 2020 tarihleri.

{"results": [
    {
      "metrics": {
        "clicks": "4,440"
      }
    }
]}

Segmentlerle ilgili sorgu

Metriklerin yanı sıra, bildirilen bir ürünün özelliği (offer_id, brand, category vb.) etkinlik (date, program). Raporlanan etkinlik, bir belirler.

Segmentler SQL'deki GROUP BY ile benzer şekilde çalışır. Segmentler seçilenleri böler metrikleri (SELECT ifadesindeki her segmente göre gruplama) yapılır. Aşağıdaki örnek sorgu eklenen koşul dahilinde azalan tıklama sayısına göre sıralanmış şekilde günlük tıklama sayısı döndürür seçmeniz gerekir. Yalnızca istenen metriklerden en az birinin sıfır olmadığı satırlar iade edilir.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY metrics.clicks DESC;

Örnek yanıt

Aşağıdaki örnek JSON kodu yanıtı,bu satıcının nasıl 1.546 tıklama aldığını göstermektedir. 1 Aralık 2020 itibarıyla tüm hedefleri genelinde tüm ürünlerinde geçerli olacak. ve Google'daki tüm hedeflerinde tüm ürünlerinde 829 tıklama 2 Aralık 2020. 3 Aralık 2020 tarihinden bu yana hiçbir nesne döndürülmeyecektir Satıcı o gün hiçbir tıklama almamıştır.

{
  "results": [
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        }
      },
      "metrics": {
        "clicks": "1546"
      }
    },
    {
      "segments": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        }
      },
      "metrics": {
        "clicks": "829"
      }
    }
]}