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

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

اصطلاح کلیدی: یک پرس‌وجو متن SQL است که اساس یک گزارش را تشکیل می‌دهد. یک گزارش از اجزای مختلفی از جمله پرس‌وجو، تنظیمات ورودی و خروجی، زمان‌بندی و جزئیات اجرا تشکیل شده است.

ایجاد گزارش

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

مهم: برای جلوگیری از از دست رفتن تغییرات، پس از انجام هرگونه به‌روزرسانی در گزارش، از جمله برنامه‌ها، روی ذخیره کلیک کنید.

1. در مرکز داده‌های تبلیغات ، صفحه گزارش‌ها را باز کنید.
2. روی + ایجاد گزارش کلیک کنید. صفحه ایجاد گزارش جدید باز می‌شود.
   • شما می‌توانید با جستجو، انتخاب آیکون‌های محصول و انتخاب گزینه‌های کشویی، قالب‌ها را فیلتر کنید.
3. یک الگو انتخاب کنید و روی «استفاده از الگو» کلیک کنید، یا برای شروع از ابتدا روی SQL کلیک کنید.
   • با کلیک روی expand_content، جزئیات قالب و SQL را پیش‌نمایش کنید.
4. برای ویرایش گزارش، روی ویرایش پرس‌وجو کلیک کنید. از ویرایشگر پرس‌وجو برای موارد زیر استفاده کنید:
   • گزارش را با استفاده از SQL سازگار با BigQuery سفارشی کنید.
   • پارامترها را در برگه Properties پیکربندی کنید.
   • فهرستی از جداول و فیلدهای موجود را در برگه جداول گوگل مشاهده کنید.
   • فهرستی از جداول 1P وارد شده و طرحواره‌های آنها را در برگه جدول 1P مشاهده کنید.
   • با کلیک روی «اجرا»، کوئری SQL را اجرا کنید. توجه داشته باشید که اجراهای آغاز شده از ویرایشگر کوئری SQL در سابقه اجرای گزارش نقشی ندارند و در بخش «فعالیت‌های اخیر» در صفحه اصلی نمایش داده نمی‌شوند.
   • برای تأیید تغییرات در پرس‌وجو و بازگشت به صفحه تنظیم گزارش، روی «انجام شد» کلیک کنید.
5. یک نام برای گزارش خود وارد کنید.
6. در صورت لزوم، مقادیر پارامترها را در کارت تنظیمات تنظیم کنید.
7. ورودی و خروجی را برای کارهای اجرا شده روی این گزارش پیکربندی کنید:
   • یک منبع داده را در فیلد «داده‌های تبلیغاتی از» انتخاب کنید. این باید شناسه حساب «مرکز داده‌های تبلیغاتی» مرتبط با داده‌های تبلیغاتی باشد که می‌خواهید پرس‌وجو کنید. (اگر می‌خواهید داده‌های سندباکس را پرس‌وجو کنید، «مشتری سندباکس ADH» را انتخاب کنید.)
   • در صورت استفاده از جدول تطبیق، جدول تطبیق را در فیلد حساب جدول تطبیق انتخاب کنید.
   • یک محدوده تاریخ و منطقه زمانی برای گزارش انتخاب کنید. منطقه زمانی گزارش باید با منطقه زمانی حساب تبلیغات لینک‌شده، مانند حساب Google Ads، مطابقت داشته باشد. توجه: محدوده تاریخ سفارشی برای آزمایش پرس‌وجو فقط زمانی پشتیبانی می‌شود که پرس‌وجو را از صفحه ویرایشگر SQL اجرا کنید.
   • اختیاری: تنظیمات حریم خصوصی خود را تغییر دهید و خلاصه ردیف فیلتر شده را پیکربندی کنید.
   • پروژه، مجموعه داده و جدول BigQuery را که نتایج گزارش شما باید در آن ذخیره شود، انتخاب کنید.
8. اختیاری: گزارش خود را طوری تنظیم کنید که طبق یک برنامه اجرا شود.
9. روی ذخیره کلیک کنید.

---

پارامترها

پارامترها به شما امکان می‌دهند نحوه اجرای یک گزارش مشخص را مشخص کنید. هنگام استفاده از SQL برای ایجاد یک گزارش (یا هنگام ویرایش SQL از یک الگوی گزارش)، پارامترها به شما امکان می‌دهند از کد SQL یکسان در گزارش‌ها استفاده مجدد کنید و مقادیر پارامتر متفاوتی را در هر نسخه از گزارش تنظیم کنید. به عنوان مثال، می‌توانید با پیکربندی یک پارامتر و تنظیم مقدار آن در بخش تنظیمات صفحه جزئیات گزارش، دو گزارش را که کوئری یا الگوی 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. روی ویرایش پرس‌وجو کلیک کنید.
3. در قسمت Properties ، روی Add parameter کلیک کنید.
4. یک نام در فیلد نام وارد کنید. از این نام برای ارجاع به پارامتر در متن گزارش استفاده خواهید کرد.
5. برای انتخاب نوع پارامتر از منوی کشویی استفاده کنید.
   • اگر نوع آرایه را انتخاب کنید، یک منوی کشویی دیگر ظاهر می‌شود. نوع آرایه را در این منوی کشویی انتخاب کنید.
6. در کوئری SQL، پارامتر را با استفاده از قالب استاندارد پارامتر SQL اضافه کنید: @PARAMETER_NAME . به مثالی که این مراحل را دنبال می‌کند، توجه کنید.
7. روی «انجام شد» کلیک کنید، سپس روی «ذخیره» کلیک کنید.

استفاده از پارامتر

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

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

1. گزارشی را که پارامترهای آن پیکربندی شده است، باز کنید.
2. برای باز کردن ویرایشگر SQL، روی ویرایش پرس‌وجو کلیک کنید.
3. در قسمت Properties ، روی حذف (delete) در کنار پارامتری که می‌خواهید حذف کنید، کلیک کنید.
4. روی «انجام شد» کلیک کنید، سپس روی «ذخیره» کلیک کنید.

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

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

start_date	date تاریخ شروع (شامل) برای کار گزارش. پارامتر تعریف‌شده توسط کاربر با این نام نادیده گرفته می‌شود و با مقادیر تعیین‌شده در کادر محاوره‌ای کار جدید جایگزین می‌شود.
end_date	date تاریخ پایان (شامل) برای کار گزارش. پارامتر تعریف‌شده توسط کاربر با این نام نادیده گرفته می‌شود و با مقادیر تعیین‌شده در کادر محاوره‌ای کار جدید جایگزین می‌شود.
time_zone	string منطقه زمانی برای گزارش کار. پارامتر تعریف‌شده توسط کاربر با این نام نادیده گرفته می‌شود و با مقادیر تعیین‌شده در کادر محاوره‌ای کار جدید جایگزین می‌شود. نکته: برای جلوگیری از اختلاف هنگام استفاده از مناطق زمانی در گزارش خود، مانند بندهای WHERE ، می‌توانید time_zone برای مطابقت با منطقه زمانی تنظیم شده در New job استفاده کنید. همچنین استفاده از همان منطقه زمانی به عنوان منبع داده مهم است.
params	string فضای نام برای نامگذاری جداول خروجی. از این فضا برای ایجاد یک نگهدارنده مکان در کوئری خود استفاده کنید، سپس هنگام اجرای گزارش، نام جدول را وارد کنید: params.TABLE_NAME (از @ قبلی که توسط پارامترهای دیگر استفاده می‌شود استفاده نکنید). برای اطلاعات بیشتر و مثال‌هایی با استفاده از این پارامتر، به Export multiple tables using a single query مراجعه کنید.

---

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

توجه: خلاصه ردیف‌های فیلتر شده هنگام استفاده از حالت نویز غیرضروری هستند. در مورد مزایای استفاده از نویز به جای بررسی تفاوت‌ها اطلاعات کسب کنید.

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

---

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

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

---

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

نکته کلیدی: می‌توانید کوئری‌های SQL را قبل از اجرای آنها روی داده‌های واقعی، با استفاده از sandbox آزمایش کنید. برای کسب اطلاعات بیشتر در مورد بهترین شیوه‌های نوشتن کوئری‌ها به Ads Data Hub مراجعه کنید.

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

1. در مرکز داده‌های تبلیغات ، صفحه گزارش‌ها را باز کنید.
2. روی نام گزارشی که می‌خواهید اجرا شود کلیک کنید.
3. روی اجرا کلیک کنید.

اجرای گزارش طبق برنامه

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

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

---

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

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

پیش‌نمایش

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

بیگ‌کوئری

نتایج شما به طور پیش‌فرض به BigQuery ارسال می‌شوند. برای باز کردن BigQuery در یک پنجره جدید، روی «مشاهده جدول» کلیک کنید.

شیت‌ها و دیتا استودیو

منوی کشویی «کاوش» را باز کنید و از بین گزینه‌ها ، «کاوش با برگه‌ها» یا «کاوش با داده استودیو» را انتخاب کنید. این کار داده‌ها را در یک پنجره جدید باز می‌کند.