Rapor oluşturma ve çalıştırma

Bu kılavuzda, rapor oluşturma ve çalıştırmanın yanı sıra sonuçlarınızı görüntüleme hakkında bilgi verilmektedir.

Önemli Terim: Sorgu, bir raporun temelini oluşturan SQL metnidir. Bir rapor; sorgu, giriş ve çıkış ayarları, plan ve yürütme ayrıntıları gibi birden çok bileşenden oluşur.

Rapor oluşturun

Analistler ve süper kullanıcılar rapor oluşturup düzenleyebilir. Ads Data Hub'daki erişim denetimi hakkında daha fazla bilgi edinin.

Önemli: Değişikliklerin kaybolmasını önlemek için programlar da dahil olmak üzere bir raporda güncelleme yaptıktan sonra Kaydet'i tıklayın.

1. Ads Data Hub'da Raporlar sayfasını açın.
2. + Rapor oluştur'u tıklayın. Yeni rapor oluştur sayfası açılır.
   • Arama yaparak, ürün simgelerini seçerek ve açılır listedeki seçenekleri belirleyerek şablonları filtreleyebilirsiniz.
3. Bir şablon seçip Şablonu kullan'ı tıklayın veya baştan başlamak için SQL'i tıklayın.
   • expand_content Genişlet'i tıklayarak şablon ayrıntılarının ve SQL'in önizlemesini yapabilirsiniz.
4. Raporu düzenlemek için Sorguyu düzenle'yi tıklayın. Sorgu düzenleyiciyi kullanarak:
   • BigQuery ile uyumlu SQL kullanarak raporu özelleştirin.
   • Özellikler sekmesinde parametreleri yapılandırın.
   • Google tabloları sekmesinde kullanılabilir tabloların ve alanların listesini görüntüleyin.
   • İçe aktarılan birinci taraf tablolarının ve şemalarının listesini birinci taraf tablosu sekmesinde görüntüleyin.
   • Çalıştır'ı tıklayarak SQL sorgusunu çalıştırın. SQL sorgu düzenleyicisinden başlatılan yürütmelerin, raporun yürütme geçmişine katkıda bulunmadığını ve Ana Sayfa sayfasının Son etkinlik bölümünde yer almayacağını unutmayın.
   • Sorgudaki değişiklikleri onaylamak ve rapor kurulumu sayfasına dönmek için Bitti'yi tıklayın.
5. Raporunuz için bir ad girin.
6. Gerekirse parametre değerlerini Kurulum kartında ayarlayın.
7. Bu raporda çalıştırılan işlerin giriş ve çıkışını yapılandırın:
   • Ads verilerinin kaynağı alanında bir veri kaynağı seçin. Bu kimlik, sorgulamak istediğiniz reklam verileriyle ilişkili Ads Data Hub hesap kimliği olmalıdır. (Korumalı alan verilerini sorgulamak isterseniz ADH Korumalı Alan Müşterisi'ni seçin.)
   • Eşleşme tablosu kullanıyorsanız Eşleşme tablosu hesabı alanında eşleşme tablosunu seçin.
   • Rapor için bir tarih aralığı ve saat dilimi seçin. Raporun saat dilimi, bağlı reklam hesabının (ör. Google Ads hesabı) saat dilimiyle eşleşmelidir. Not: Sorgu testi için özel tarih aralığı yalnızca sorguyu SQL düzenleyici ekranından çalıştırdığınızda desteklenir.
   • İsteğe bağlı: Gizlilik ayarlarınızı değiştirin ve filtrelenmiş satır özetini yapılandırın.
   • Rapor sonuçlarınızın kaydedileceği BigQuery projesini, veri kümesini ve tabloyu seçin.
8. İsteğe bağlı: Raporunuzu belirli bir plana göre çalışacak şekilde ayarlayın.
9. Kaydet'i tıklayın.

---

Parametreler

Parametreler, belirli bir raporun nasıl çalıştırılacağını belirtmenize olanak tanır. Rapor oluşturmak için SQL kullanırken (veya bir rapor şablonundaki SQL'yi düzenlerken) parametreler, aynı SQL kodunu raporlarda yeniden kullanmanıza ve raporun her kopyasında farklı parametre değerleri ayarlamanıza olanak tanır. Örneğin, bir parametre yapılandırıp değerini rapor ayrıntıları sayfasının Kurulum bölümünde ayarlayarak aynı SQL sorgusunu veya şablonunu paylaşan iki raporu farklı kampanya kimliği gruplarında çalıştırabilirsiniz. Parametreleri kullanmak, SQL kodunuzun sade kalmasını sağlar, düzenleme sırasında hata oluşması olasılığını azaltır ve SQL'deki değerleri düzenlemeden aynı SQL sorgusunu raporlarda yeniden kullanmanıza olanak tanır.

Aşağıdaki örnekte, rapor campaign_ids adlı bir parametre içeriyor. Bu parametre, int64 kampanya kimliklerinin array değerini kabul ediyor:

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

Parametre türleri

Aşağıdaki parametre türlerine izin verilir:

• int64
• float64
• bool
• string
• date
• timestamp
• array (izin verilen türlerden herhangi biri)

Rapora parametre ekleme

1. Kayıtlı bir raporu açın veya yeni rapor oluşturun.
2. Sorguyu düzenle'yi tıklayın.
3. Özellikler bölümünde Parametre ekle'yi tıklayın.
4. Ad alanına bir ad girin. Rapor metninde parametreye referans vermek için bu adı kullanmanız gerekir.
5. Parametre türünü seçmek için açılır menüyü kullanın.
   • Dizi türünü seçerseniz başka bir açılır menü görüntülenir. Bu açılır menüden dizi türünü seçin.
6. SQL sorgusunda, parametreyi standart SQL parametre biçimini kullanarak ekleyin: @PARAMETER_NAME. Bu adımları izleyerek örneğe bakın.
7. Bitti'yi ve ardından Kaydet'i tıklayın.

Parametreleri kullanma

1. Yapılandırılmış parametrelerin bulunduğu bir raporu açın.
2. Kurulum bölmesinde, tanımladığınız her parametre için değer girin.
3. Parametre değerlerini korumak için Kaydet'i tıklayın.

Parametreleri kaldırma

1. Yapılandırılmış parametrelerin bulunduğu bir raporu açın.
2. SQL düzenleyiciyi açmak için Sorguyu düzenle'yi tıklayın.
3. Özellikler bölümünde, silmek istediğiniz parametrenin yanındaki sil Sil'i tıklayın.
4. Bitti'yi ve ardından Kaydet'i tıklayın.

Ayrılmış parametreler

Aşağıdaki tabloda, Ads Data Hub tarafından ayrılmış parametreler listelenmiştir. Bu parametreleri raporlarınızda kullanabilirsiniz, ancak ayrılmış bir parametreyle aynı ada sahip bir parametre oluşturamazsınız.

start_date	date Rapor işinin başlangıç tarihi (dahil). Bu ada sahip kullanıcı tanımlı parametreler yok sayılır ve Yeni iş iletişim kutusunda ayarlanan değerlerle değiştirilir.
end_date	date Rapor işinin bitiş tarihi (dahil). Bu ada sahip kullanıcı tanımlı parametreler yok sayılır ve Yeni iş iletişim kutusunda ayarlanan değerlerle değiştirilir.
time_zone	string Rapor işinin saat dilimi. Bu ada sahip kullanıcı tanımlı parametreler yok sayılır ve Yeni iş iletişim kutusunda ayarlanan değerlerle değiştirilir. İpucu: Raporunuzda saat dilimleri kullanırken (ör. WHERE yan tümcelerinde) tutarsızlıkları önlemek için time_zone öğesini kullanarak Yeni iş bölümünde ayarlanan saat dilimini seçebilirsiniz. Veri kaynağıyla aynı saat dilimini kullanmak da önemlidir.
params	string Dışa aktarılan tabloları adlandırmak için kullanılan ad alanı. Sorgunuzda yer tutucu oluşturmak için aşağıdaki biçimi kullanın, ardından raporu çalıştırdığınızda tablo adını girin: params.TABLE_NAME (diğer parametreler tarafından kullanılan önceden eklenmiş @ işaretini kullanmayın). Bu parametrenin kullanıldığı daha fazla bilgi ve örnek için Aynı sorguyu kullanarak birden çok tabloyu dışa aktarma başlıklı makaleyi inceleyin.

---

Filtrelenmiş satır özeti

Not: Gürültü modunu kullandığınızda filtrelenmiş satır özetleri gereksizdir. Farklılık kontrolleri yerine gürültü kullanmanın avantajları hakkında bilgi edinin.

Filtrelenmiş satır özetleri, farklılık kontrolleri nedeniyle filtrelenen verileri bir araya getirir. Filtrelenmiş satırlardaki veriler toplanır ve her şeyi içeren bir satıra eklenir. Filtrelenmiş verilerin daha fazla analiz edilememesine rağmen sonuçlardan ne kadar verinin filtrelendiğine dair bir özet sağlanır. Farklılık kontrolleri gizlilik modunu kullanan sorgular için Ads Data Hub, filtrelenmiş bir satır özetini otomatik olarak etkinleştirir ve yapılandırır. Sorguyu düzenlerken Ads Data Hub, seçilen sütunlara göre yapılandırmayı otomatik olarak ayarlar. Filtrelenmiş satır özetleri hakkında daha fazla bilgi edinmek veya bir özeti manuel olarak yapılandırmak için Filtrelenmiş satır özeti başlıklı makaleyi inceleyin.

---

Raporu düzenleme

1. Ads Data Hub'da Raporlar sayfasını açın.
2. Düzenlemek istediğiniz raporun adını tıklayın.
3. Raporda değişiklik yapın. Örneğin, SQL'i düzenleyebilir, parametre değerlerini yönetebilir veya bir program ayarlayabilirsiniz.
4. Kaydet'i tıklayın.

---

Rapor çalıştırma

Önemli Bilgi: SQL sorgularını gerçek veriler üzerinde çalıştırmadan önce korumalı alanı kullanarak test edebilirsiniz. Ads Data Hub'da sorgu yazmaya yönelik en iyi uygulamalar hakkında daha fazla bilgi edinin.

Bir rapor çalıştırmadan önce, hizmet hesabına birleştirme işlemlerinizin çıkışını içerecek veri kümesi için dataEditor izni verdiğinizden emin olun. BigQuery'deki erişim denetimi hakkında daha fazla bilgi edinin.

1. Ads Data Hub'da Raporlar sayfasını açın.
2. Çalıştırmak istediğiniz raporun adını tıklayın.
3. Çalıştır'ı tıklayın.

Raporu belirli bir plana göre çalıştırma

1. Ads Data Hub'da Raporlar sayfasını açın.
2. Planlamak istediğiniz raporun adını tıklayın.
   • Yeni bir rapor için plan ayarlamak üzere raporu oluşturun ve Kaydet'i tıklayın.
3. + Program ayarla'yı tıklayın.
4. Zamanlama bölmesinde, Bu raporu aşağıdaki ayrıntılarla çalışacak şekilde planlayın açma/kapatma düğmesini açık konumuna getirin.
5. Sıklık bölümünde bir aralık ve günün bir saatini seçin, ardından bir saat dilimi girin.
   • Bunun yerine bir cron ifadesi kullanmak için Cron ifadesi kullanarak zamanlamayı ayarla açma/kapatma düğmesini açık konuma getirin ve ifadeyi kutuya girin.
6. Bitti'yi tıklayın.
7. Değişikliklerinizi rapora uygulamak için Kaydet'i tıklayın.

Planlanmış işleri Ana Sayfa'da göstermek için Sahip filtre listesinden Herkes'i seçin.

---

Sonuçlarınızı görüntüleme

Raporunuz çalıştırıldıktan sonra, rapor ayrıntıları sayfasında sonuçların önizlemesini görebilirsiniz. Sonuçları daha sonra görüntülemek için raporu Ana Sayfa'dan açın. Verileri BigQuery, E-Tablolar veya Data Studio'da da inceleyebilirsiniz.

Önizleme

Tamamlanmış işin içinden Önizleme'yi tıklayın. İşin altında ilk 20 sonuç gösterilir.

BigQuery

Sonuçlarınız varsayılan olarak BigQuery'ye aktarılır. BigQuery'yi yeni bir pencerede açmak için Tabloyu görüntüle'yi tıklayın.

E-Tablolar ve Data Studio

Keşfet açılır menüsünü açın ve seçenekler arasından E-Tablolar ile keşfet veya Data Studio ile keşfet'i seçin. Bu işlemi yaptığınızda veriler yeni bir pencerede açılır.