ایجاد و اجرای گزارش ها

این راهنما نحوه ایجاد و اجرای گزارش ها و همچنین مشاهده نتایج خود را به شما آموزش می دهد.

یک گزارش ایجاد کنید

تحلیلگران و ابرکاربران می توانند گزارش ایجاد و ویرایش کنند. درباره کنترل دسترسی در Ads Data Hub بیشتر بیاموزید.

  1. در Ads Data Hub ، صفحه گزارش ها را باز کنید.
  2. روی + ایجاد گزارش کلیک کنید. صفحه ایجاد گزارش جدید باز می شود.
    • می‌توانید با جستجو، انتخاب نمادهای محصول و انتخاب گزینه‌های کشویی، قالب‌ها را فیلتر کنید.
  3. یک الگو را انتخاب کنید و روی Use template کلیک کنید، یا برای شروع از ابتدا روی SQL کلیک کنید.
    • پیش نمایش جزئیات قالب و SQL با کلیک روی expand_content Expand .
  4. برای ویرایش گزارش، روی Edit Query کلیک کنید. از ویرایشگر پرس و جو برای موارد زیر استفاده کنید:
    • گزارش را با استفاده از SQL سازگار با BigQuery سفارشی کنید.
    • پارامترها را در تب Properties پیکربندی کنید.
    • فهرستی از جداول و فیلدهای موجود را در تب جداول Google مشاهده کنید.
    • فهرستی از جداول 1P وارد شده و طرحواره های آنها را در برگه جدول 1P مشاهده کنید.
    • پرس و جوی SQL را با کلیک روی Run اجرا کنید. توجه داشته باشید که اجراهایی که از ویرایشگر پرس و جوی SQL آغاز می شوند، به سابقه اجرای گزارش کمک نمی کنند و در بخش فعالیت اخیر صفحه اصلی وجود ندارند.
    • برای تأیید تغییرات درخواست و بازگشت به صفحه تنظیم گزارش، روی Done کلیک کنید.
  5. یک نام برای گزارش خود وارد کنید.
  6. در صورت وجود، مقادیر پارامتر را در کارت راه اندازی تنظیم کنید.
  7. ورودی و خروجی را برای کارهای اجرا شده در این گزارش پیکربندی کنید:
    • یک منبع داده را در قسمت Ads data from انتخاب کنید. این باید شناسه حساب Ads Data Hub مرتبط با داده های تبلیغاتی باشد که می خواهید پرس و جو کنید. (اگر می خواهید داده های جعبه ایمنی را پرس و جو کنید، ADH Sandbox Customer را انتخاب کنید.)
    • اگر از جدول مطابقت استفاده می کنید، جدول مطابقت را در قسمت حساب جدول مطابقت انتخاب کنید.
    • محدوده تاریخ و منطقه زمانی را برای گزارش انتخاب کنید. منطقه زمانی گزارش باید با منطقه زمانی حساب تبلیغات مرتبط، مانند حساب Google Ads مطابقت داشته باشد. توجه: محدوده تاریخ سفارشی برای آزمایش پرس و جو فقط زمانی پشتیبانی می شود که پرس و جو را از صفحه ویرایشگر SQL اجرا کنید.
    • اختیاری: تنظیمات حریم خصوصی خود را تغییر دهید و خلاصه ردیف فیلتر شده را پیکربندی کنید.
    • پروژه BigQuery، مجموعه داده و جدولی را انتخاب کنید که نتایج گزارش شما باید در آن ذخیره شود.
  8. اختیاری: گزارش خود را طوری تنظیم کنید که طبق یک برنامه اجرا شود.
  9. روی ذخیره کلیک کنید.

پارامترها

پارامترها به شما این امکان را می دهند که نحوه اجرای یک گزارش داده شده را مشخص کنید. هنگام استفاده از SQL برای ایجاد یک گزارش (یا هنگام ویرایش SQL از یک الگوی گزارش)، پارامترها به شما امکان می‌دهند از کد SQL یکسان در گزارش‌ها استفاده مجدد کنید و مقادیر پارامترهای مختلفی را در هر کپی از گزارش تنظیم کنید. به عنوان مثال، می‌توانید با پیکربندی یک پارامتر و تنظیم مقدار آن در بخش Setup صفحه جزئیات گزارش، دو گزارش را اجرا کنید که پرس و جو یا الگوی SQL یکسانی را روی مجموعه‌های مختلف شناسه‌های کمپین به اشتراک می‌گذارند. استفاده از پارامترها کد SQL شما را تمیز نگه می دارد، شانس شما را برای ایجاد خطا از طریق ویرایش کاهش می دهد و امکان استفاده مجدد از همان پرس و جوی SQL را در گزارش ها بدون ویرایش مقادیر در خود SQL فراهم می کند.

در مثال زیر، گزارش حاوی پارامتری به نام campaign_ids است که array از شناسه‌های کمپین int64 را می‌پذیرد:

  /* 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

انواع پارامترها

انواع پارامترهای زیر مجاز است:

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array (از هر یک از انواع مجاز)

یک پارامتر به گزارش اضافه کنید

  1. یک گزارش ذخیره شده را باز کنید یا یک گزارش جدید ایجاد کنید .
  2. روی Edit Query کلیک کنید.
  3. در قسمت Properties ، روی افزودن پارامتر کلیک کنید.
  4. در قسمت Name یک نام وارد کنید. شما از این نام برای ارجاع به پارامتر در متن گزارش استفاده خواهید کرد.
  5. از منوی کشویی برای انتخاب نوع پارامتر استفاده کنید.
    • اگر نوع آرایه را انتخاب کنید، یک منوی کشویی اضافی ظاهر می شود. نوع آرایه را در این منوی کشویی انتخاب کنید.
  6. در جستار SQL، پارامتر را با استفاده از قالب پارامتر استاندارد SQL اضافه کنید: @PARAMETER_NAME . مثالی را که این مراحل را دنبال می کند، ببینید.
  7. روی Done کلیک کنید، سپس روی Save کلیک کنید.

از یک پارامتر استفاده کنید

  1. گزارشی را باز کنید که پارامترهای آن پیکربندی شده است.
  2. در قسمت Setup مقادیری را برای هر پارامتری که تعریف کرده اید وارد کنید
  3. برای حفظ مقادیر پارامتر روی ذخیره کلیک کنید.

یک پارامتر را حذف کنید

  1. گزارشی را باز کنید که پارامترهای آن پیکربندی شده است.
  2. روی Edit query کلیک کنید تا ویرایشگر SQL باز شود.
  3. در قسمت Properties ، روی delete Delete در کنار پارامتری که می خواهید حذف کنید کلیک کنید.
  4. روی Done کلیک کنید، سپس روی Save کلیک کنید.

پارامترهای رزرو شده

جدول زیر پارامترهای رزرو شده توسط Ads Data Hub را فهرست می کند. شما می توانید از این پارامترها در گزارش های خود استفاده کنید، اما نمی توانید پارامتری با نام یک پارامتر رزرو شده ایجاد کنید.

start_date date

تاریخ شروع (شامل) برای کار گزارش. یک پارامتر تعریف شده توسط کاربر با این نام نادیده گرفته می شود و با مقادیر تنظیم شده در گفتگوی کار جدید جایگزین می شود.

end_date date

تاریخ پایان (شامل) برای کار گزارش. یک پارامتر تعریف شده توسط کاربر با این نام نادیده گرفته می شود و با مقادیر تنظیم شده در گفتگوی کار جدید جایگزین می شود.

time_zone string

منطقه زمانی برای کار گزارش. یک پارامتر تعریف شده توسط کاربر با این نام نادیده گرفته می شود و با مقادیر تنظیم شده در گفتگوی کار جدید جایگزین می شود.

خلاصه ردیف فیلتر شده

ردیف‌های فیلتر شده، داده‌های جمع‌آوری‌شده را که به دلیل بررسی‌های تفاوت فیلتر شده‌اند، خلاصه می‌کند. داده‌های ردیف‌های فیلتر شده جمع‌بندی می‌شوند و به یک ردیف جامع اضافه می‌شوند. در حالی که داده های فیلتر شده را نمی توان بیشتر تجزیه و تحلیل کرد، خلاصه ای از مقدار داده های فیلتر شده از نتایج را ارائه می دهد. برای جستارهایی که از حالت حریم خصوصی بررسی تفاوت استفاده می کنند، Ads Data Hub به طور خودکار خلاصه ردیف فیلتر شده را فعال و پیکربندی می کند. همانطور که درخواست را ویرایش می کنید، Ads Data Hub به طور خودکار پیکربندی را بر اساس ستون های انتخاب شده تنظیم می کند. برای کسب اطلاعات بیشتر درباره خلاصه‌های ردیف فیلتر شده یا پیکربندی دستی، به خلاصه ردیف فیلتر شده مراجعه کنید.

ویرایش یک گزارش

  1. در Ads Data Hub ، صفحه گزارش ها را باز کنید.
  2. روی نام گزارشی که می خواهید ویرایش کنید کلیک کنید.
  3. تغییراتی در گزارش ایجاد کنید. به عنوان مثال، SQL را ویرایش کنید، مقادیر پارامترها را مدیریت کنید یا یک زمان بندی تنظیم کنید.
  4. روی ذخیره کلیک کنید.

یک گزارش اجرا کنید

قبل از اجرای یک گزارش، مطمئن شوید که به dataEditor حساب سرویس مجوز داده‌اید که حاوی خروجی اتصال‌های شما باشد. درباره کنترل دسترسی در BigQuery بیشتر بیاموزید .

  1. در Ads Data Hub ، صفحه گزارش ها را باز کنید.
  2. روی نام گزارشی که می خواهید اجرا شود کلیک کنید.
  3. روی Run کلیک کنید.

گزارشی را بر اساس برنامه اجرا کنید

  1. در ADS Data Hub ، صفحه گزارش ها را باز کنید.
  2. روی نام گزارشی که می‌خواهید برای آن زمان‌بندی تنظیم کنید، کلیک کنید.
    • برای تنظیم زمان‌بندی برای گزارش جدید، گزارش را ایجاد کنید و سپس روی ذخیره کلیک کنید.
  3. روی + تنظیم برنامه کلیک کنید.
  4. در پنجره زمان‌بندی ، روی زمان‌بندی این گزارش کلیک کنید تا با جزئیات زیر اجرا شود و به موقعیت روشن تغییر دهید.
  5. در قسمت فرکانس ، یک بازه زمانی و زمانی از روز را انتخاب کنید و سپس یک منطقه زمانی را وارد کنید.
    • برای استفاده از عبارت cron به جای آن، روی تنظیم برنامه با استفاده از یک عبارت cron در موقعیت روشن کلیک کنید و سپس عبارت را در کادر وارد کنید.
  6. روی Done کلیک کنید.
  7. روی ذخیره کلیک کنید تا تغییرات خود را در گزارش انجام دهید.

برای نمایش کارهای برنامه ریزی شده در صفحه اصلی ، هر کسی را از لیست فیلتر مالک انتخاب کنید.

نتایج خود را مشاهده کنید

پس از اتمام اجرای گزارش، می‌توانید نتایج را در صفحه جزئیات گزارش پیش‌نمایش کنید. برای مشاهده نتایج در زمان بعدی، گزارش را از صفحه اصلی باز کنید. همچنین می‌توانید داده‌ها را در BigQuery، Sheets یا Data Studio کاوش کنید.

پیش نمایش

روی پیش نمایش در کار تمام شده کلیک کنید. 20 نتیجه اول در زیر کار ظاهر می شود.

BigQuery

نتایج شما به طور پیش فرض به BigQuery صادر می شود. روی View table کلیک کنید تا BigQuery در پنجره جدیدی باز شود.

Sheets و Data Studio

منوی کشویی Explore را باز کنید و از میان گزینه ها Explore with Sheets یا Explore with Data Studio را انتخاب کنید. این داده ها را در یک پنجره جدید باز می کند.