ایجاد یک پرس و جو
- به برگه «پرسشها» در مرکز دادههای تبلیغات بروید.
- روی + ایجاد پرسوجو کلیک کنید. صفحه الگوهای پرسوجوی تحلیل باز میشود.
- اختیاری: پیشنمایش SQL قالب را با کلیک روی Expand مشاهده کنید.
- با کلیک روی «استفاده از الگو» ، الگویی را که میخواهید استفاده کنید انتخاب کنید، یا برای شروع از ابتدا، روی «خالی» کلیک کنید.
- یک نام برای گزارش خود وارد کنید.
- با استفاده از SQL سازگار با BigQuery، کوئری را بنویسید یا ویرایش کنید. میتوانید جداول و فیلدهای موجود را پیدا کنید و آنها را از تب جداول گوگل در SQL خود وارد کنید.
- اختیاری: پیکربندی پارامترها .
- اختیاری: خلاصه ردیف فیلتر شده را پیکربندی کنید.
- روی ذخیره کلیک کنید.
پارامترها
پارامترها، پرسوجوها را انعطافپذیرتر میکنند. برای مثال، ممکن است بخواهید یک پرسوجوی مشابه را روی کمپینهای مختلف اجرا کنید. به جای ایجاد پرسوجوهای تکراری یا کدگذاری سخت شناسههای کمپین قبل از هر اجرا، میتوانید پارامتری را پیکربندی کنید که یک یا چند شناسه کمپین را برای ورود از کارت اجرا هنگام اجرای یک پرسوجو بپذیرد. استفاده از پارامترها کد شما را تمیز نگه میدارد، احتمال بروز خطا از طریق ویرایش را کاهش میدهد و امکان استفاده مجدد از پرسوجوی شما را بدون ویرایش فراهم میکند. پارامترها به پرسوجویی که در آن ایجاد شدهاند، محدود میشوند، بنابراین میتوانید از نام پارامتر در پرسوجوی دیگری دوباره استفاده کنید.
انواع پارامتر
انواع پارامترهای زیر مجاز هستند:
-
int64 -
float64 -
bool -
string -
date -
timestamp -
array، از هر یک از انواع مجاز
ایجاد یک پارامتر
- یک پرسوجوی ذخیرهشده را باز کنید، یا یک پرسوجوی جدید ایجاد کنید .
- روی ویژگیها > پارامترها > افزودن پارامتر کلیک کنید.
- یک نام در فیلد نام وارد کنید. از این نام برای ارجاع به پارامتر در متن پرسوجو استفاده خواهید کرد.
- برای انتخاب نوع پارامتر از منوی کشویی استفاده کنید.
- اگر آرایه را انتخاب کنید، یک منوی کشویی اضافی ظاهر میشود. نوع آرایه را در منوی کشویی انتخاب کنید.
- اختیاری: مراحل ۲ تا ۴ را تا زمانی که تمام پارامترهای مورد نظر خود را اضافه کرده باشید، تکرار کنید.
- روی ذخیره کلیک کنید
استفاده از پارامتر
در متن پرسوجو، از قالب استاندارد پارامتر SQL استفاده کنید، که به این صورت است که قبل از نام پارامتر، علامت @ قرار دهید. در مثال زیر، پرسوجو شامل پارامتری به نام @campaign_ids است:
/* 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
وقتی پرسوجو را اجرا میکنید ، کادر محاورهای New job حاوی یک فیلد Parameters خواهد بود. برای هر پارامتری که تعریف کردهاید، مقادیری را وارد کنید.
حذف یک پارامتر
- کوئریای را که پارامتر مورد نظر برای حذف در آن قرار دارد، باز کنید.
- برگه «ویژگیها» را باز کنید.
- در کارت پارامترها ، روی حذف (delete) در کنار پارامتری که میخواهید حذف کنید، کلیک کنید.
- روی ذخیره کلیک کنید.
پارامترهای رزرو شده
جدول زیر پارامترهای رزرو شده توسط Ads Data Hub را فهرست میکند. میتوانید از این پارامترها در کوئریهای خود استفاده کنید، اما نمیتوانید پارامتری با نام مشابه پارامتر رزرو شده ایجاد کنید.
start_date | dateتاریخ شروع (شامل) برای کار پرسوجو. پارامتر تعریفشده توسط کاربر با این نام نادیده گرفته میشود و با مقادیر تعیینشده در کادر محاورهای کار جدید جایگزین میشود. |
end_date | dateتاریخ پایان (شامل) برای کار پرسوجو. پارامتر تعریفشده توسط کاربر با این نام نادیده گرفته میشود و با مقادیر تعیینشده در کادر محاورهای کار جدید جایگزین میشود. |
time_zone | stringمنطقه زمانی برای کار پرسوجو. پارامتر تعریفشده توسط کاربر با این نام نادیده گرفته میشود و با مقادیر تعیینشده در کادر محاورهای کار جدید جایگزین میشود. |
params | stringفضای نام برای نامگذاری جداول خروجی. از این فضا برای ایجاد یک نگهدارنده مکان در کوئری خود استفاده کنید، سپس هنگام اجرای گزارش، نام جدول را وارد کنید: params.TABLE_NAME (از @ قبلی که توسط پارامترهای دیگر استفاده میشود استفاده نکنید). برای اطلاعات بیشتر و مثالهایی با استفاده از این پارامتر، به Export multiple tables using a single query مراجعه کنید. |
خلاصه ردیف فیلتر شده
خلاصه ردیفهای فیلتر شده، دادههایی را که به دلیل بررسیهای حریم خصوصی فیلتر شدهاند، جمع میکند. دادههای ردیفهای فیلتر شده جمع شده و به یک ردیف جامع اضافه میشوند. در حالی که دادههای فیلتر شده را نمیتوان بیشتر تجزیه و تحلیل کرد، خلاصهای از میزان دادههای فیلتر شده از نتایج ارائه میدهد.
ویرایش یک پرسوجو
- به برگه «پرسشها» در مرکز دادههای تبلیغات بروید.
- روی نام پرسوجویی که میخواهید ویرایش کنید کلیک کنید.
- پرسوجو را ویرایش کنید.
- روی ذخیره کلیک کنید.
اجرای یک پرسوجو
قبل از اجرای یک پرسوجو، مطمئن شوید که به حساب کاربری سرویس dataEditor اجازه دسترسی به مجموعه دادهای که شامل خروجی اتصالهای شما خواهد بود را دادهاید. درباره کنترل دسترسی در BigQuery بیشتر بدانید .
- به برگه «پرسشها» در مرکز دادههای تبلیغات بروید.
- روی نام کوئری که میخواهید اجرا شود کلیک کنید.
- روی کلیک کنید. اجرا کنید .
- تعداد بایتهای مورد انتظاری که کوئری استفاده خواهد کرد در بالای صفحه نشان داده میشود.
- یک شناسه در فیلد «دادههای تبلیغات از» انتخاب کنید. این باید شناسه حساب مرتبط با دادههای تبلیغاتی باشد که میخواهید پرسوجو کنید. (اگر میخواهید دادههای سندباکس را پرسوجو کنید، ADH Sandbox Customer را انتخاب کنید.)
- اگر از جدول تطبیق استفاده میکنید، جدول تطبیق را در فیلد Match table from انتخاب کنید.
- حالت حریم خصوصی را انتخاب کنید. درباره حالتهای حریم خصوصی بیشتر بدانید .
- در فیلد Destination table مشخص کنید که نتایج کوئری شما کجا ذخیره شود.
- برای تعیین محدوده زمانی درخواست خود، تاریخ شروع و پایان را وارد کنید.
- یک منطقه زمانی وارد کنید. این باید با منطقه زمانی درب خرید مطابقت داشته باشد.
- اختیاری: مقادیر مربوط به هر پارامتر را وارد کنید.
- روی اجرا کلیک کنید.
نتایج خود را مشاهده کنید
پس از اتمام اجرای کوئری، میتوانید نتایج را در صفحه «Jobs» پیشنمایش کنید. همچنین میتوانید دادهها را در BigQuery، Sheets یا Data Studio بررسی کنید.
پیشنمایش
روی پیشنمایش در کار نهایی کلیک کنید. 20 نتیجه اول زیر کار ظاهر میشوند.
بیگکوئری
نتایج شما به طور پیشفرض به BigQuery ارسال میشوند. برای باز کردن BigQuery در یک پنجره جدید، روی «مشاهده جدول» کلیک کنید.
شیتها و دیتا استودیو
منوی کشویی Explore را باز کنید و از بین گزینهها ، Explore with Sheets یا Explore with Data Studio را انتخاب کنید. این کار دادهها را در یک پنجره جدید باز میکند.