Rapor yazma ve çalıştırma

Rapor oluşturma

  1. Ads Data Hub'da Sorgular sekmesine gidin.
  2. + Sorgu oluştur'u tıklayın. Yeni rapor oluştur sayfası açılır.
  3. İsteğe bağlı: Arama yaparak, simge seçerek ve açılır listedeki seçenekleri belirleyerek şablonları filtreleyebilirsiniz:
    • Veri kaynağı
    • Kullanım alanı
    • Envanter
    • MRC akreditasyonu
  4. İsteğe bağlı: expand_content Genişlet'i tıklayarak şablon ayrıntıları ve SQL'in önizlemesini yapabilirsiniz.
  5. Şablonu kullan'ı tıklayarak kullanmak istediğiniz şablonu seçin veya baştan başlamak için add_circle Ekle'yi tıklayın.
  6. Raporunuz için bir ad girin.
  7. BigQuery uyumlu SQL kullanarak raporu yazın veya düzenleyin. Mevcut tabloları ve alanları bulup Google tabloları sekmesinden SQL'inize ekleyebilirsiniz.
  8. İsteğe bağlı: Parametreleri yapılandırın.
  9. İsteğe bağlı: Filtrelenmiş satır özetini yapılandırın.
  10. Kaydet'i tıklayın.

Parametreler

Parametreler, raporları daha esnek hale getirir. Örneğin, aynı raporu farklı kampanyalar üzerinde çalıştırmak isteyebilirsiniz. Her çalıştırma işleminden önce yinelenen raporlar oluşturmak veya kampanya kimliklerini sabitleştirmek yerine, rapor çalıştırırken Çalıştır kartından bir veya daha fazla kampanya kimliği girilmesini kabul eden bir parametre yapılandırabilirsiniz. Parametreleri kullanmak, kodunuzun sade kalmasını sağlar, düzenleme sırasında hata oluşması olasılığını azaltır ve raporun düzenleme olmadan yeniden kullanılmasına olanak tanır. Parametreler, oluşturuldukları raporun kapsamına alınır. Böylece, parametre adını başka bir raporda tekrar kullanabilirsiniz.

Parametre türleri

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

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

Parametre oluşturma

  1. Kayıtlı bir raporu açın veya yeni rapor oluşturun.
  2. Özellikler > Parametreler > Parametre ekle'yi tıklayın.
  3. Ad alanına bir ad girin. Rapor metninde parametreye referans vermek için bu adı kullanmanız gerekir.
  4. Parametre türünü seçmek için açılır menüyü kullanın.
    • Dizi'yi seçerseniz başka bir açılır menü görüntülenir. Açılır menüden dizi türünü seçin.
  5. İsteğe bağlı: İstediğiniz tüm parametreleri ekleyene kadar 2-4 arasındaki adımları tekrarlayın.
  6. Kaydet'i tıklayın.

Parametreleri kullanma

Rapor metninde, parametre adının önüne @ gelecek şekilde standart SQL parametre biçimini kullanın. Aşağıdaki örnekte, rapor @campaign_ids adlı bir parametre içeriyor:

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

  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

Sorguyu çalıştırdığınızda, Yeni iş iletişim kutusu bir Parametre alanı içerir. Tanımladığınız her parametre için değer girin.

Parametreleri kaldırma

  1. Silmek istediğiniz parametrenin yer aldığı raporu açın.
  2. Özellikler sekmesini açın.
  3. Parametreler kartında, silmek istediğiniz parametrenin yanındaki Sil'i tıklayın.
  4. 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.

Filtrelenmiş satır özeti

Filtrelenmiş satır özetleri, gizlilik 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.

Raporu düzenleme

  1. Ads Data Hub'da Sorgular sekmesine gidin.
  2. Düzenlemek istediğiniz raporun adını tıklayın.
  3. Raporu düzenleyin.
  4. Kaydet'i tıklayın.

Rapor çalıştırma

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 Sorgular sekmesine gidin.
  2. Çalıştırmak istediğiniz raporun adını tıklayın.
  3. Çalıştır'ı tıklayın.
    • Raporun kullanması beklenen bayt sayısı sayfanın üst kısmında gösterilir.
  4. Ads verilerinin kaynağı açılır listesinden bir kimlik seçin. Bu kimlik, sorgulamak istediğiniz reklam verileriyle ilişkili "Ads verilerinin kaynağı" kimliği olmalıdır. (Korumalı alan verilerini sorgulamak isterseniz ADH Korumalı Alan Müşterisi'ni seçin.)
  5. Eşleşme tablosu kullanıyorsanız Eşleşme tablosu kaynağı açılır listesinden eşleşme tablosunu seçin.
  6. Hedef tablo alanında, rapor sonuçlarının nereye kaydedileceğini belirtin.
  7. Raporun tarih aralığını belirlemek için başlangıç ve bitiş tarihlerini girin.
  8. Bir saat dilimi girin. Satın alma kapısının saat dilimiyle aynı olmalıdır.
  9. İsteğe bağlı: Parametreler için değerler girin.
  10. Çalıştır'ı tıklayın.

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

Rapor çalıştırıldıktan sonra, "İşler" sayfasında sonuçların önizlemesini görebilirsiniz. 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.