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

Bu kılavuzda, raporları nasıl oluşturacağınız ve çalıştıracağınızın yanı sıra sonuçlarınızı nasıl görüntüleyeceğiniz açıklanmaktadır.

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

Rapor oluşturun

Analistler ve süper kullanıcılar rapor oluşturabilir ve 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çin ve Ş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ı 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 mevcut 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 tablo 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ütme işlemlerinin, bir raporun yürütme geçmişine dahil edilmediğini ve Ana Sayfa sayfasının Son etkinlik bölümünde yer almadığını unutmayın.
   • Sorgudaki değişiklikleri onaylamak ve rapor oluşturma sayfasına dönmek için Bitti'yi tıklayın.
5. Raporunuz için bir ad girin.
6. Varsa Kurulum kartında parametre değerlerini ayarlayın.
7. Bu raporda çalıştırılan işlerin girişini 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. Rapor saat dilimi, bağlı reklam hesabının (ör. Google Ads hesabı) saat dilimine uygun olmalıdır. 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'i kullanırken (veya bir rapor şablonundaki SQL'i 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 parametreyi yapılandırıp rapor ayrıntıları sayfasının Kurulum bölümünde değerini ayarlayarak farklı kampanya kimliği gruplarında aynı SQL sorgusunu veya şablonunu paylaşan iki rapor ç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 sorgusunun raporlarda yeniden kullanılmasını sağlar.

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

  /* 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ı izleyen örneğe bakın.
7. Bitti'yi ve ardından Kaydet'i tıklayın.

Parametreleri kullanma

1. Parametreleri yapılandırılmış 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. Parametreleri yapılandırılmış 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 simgesini 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.

---

Filtrelenmiş satır özeti

Not: Gürültü modunu kullandığınızda filtrelenmiş satır özetleri gerekmez. Fark 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 satır özetini 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.

Raporları planlı olarak çalıştırma

1. Ads Data Hub'da Raporlar sayfasını açın.
2. Planlama yapmak istediğiniz raporun adını tıklayın.
   • Yeni bir rapor için planlama yapmak istiyorsanız raporu oluşturun ve Kaydet'i tıklayın.
3. + Program ayarla'yı tıklayın.
4. Planla bölmesinde, Bu raporu aşağıdaki ayrıntılarla çalışacak şekilde planla açma/kapatma düğmesini etkin konuma getirin.
5. Sıklık bölümünde bir aralık ve saat seçin, ardından bir saat dilimi girin.
   • Bunun yerine 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 kaydetmek için Kaydet'i tıklayın.

Planlanmış işleri Ana Sayfa sayfasında 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, sonuçları rapor ayrıntıları sayfasında önizleyebilirsiniz. Sonuçları daha sonra görüntülemek için Ana Sayfa'dan raporu 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.