ما اسناد خود را با جدیدترین ویژگی‌ها و به‌روزرسانی‌های معرفی شده توسط دو تجربه جدید Ads Data Hub به‌روزرسانی کرده‌ایم. تبلیغ‌کنندگان، آژانس‌ها و ناشران به سایت بازاریابان مراجعه کنند. فروشندگان و شرکا به سایت Measurement Partners مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

کوئری ها را بنویسید و اجرا کنید

یک پرس و جو ایجاد کنید

به برگه Queries در Ads Data Hub بروید.
روی + ایجاد پرس و جو کلیک کنید. صفحه قالب های پرس و جو تجزیه و تحلیل باز می شود.
اختیاری: پیش نمایش الگوی SQL با کلیک بر روی Expand .
با کلیک روی استفاده از الگو ، الگوی مورد نظر خود را برای استفاده انتخاب کنید، یا برای شروع از ابتدا روی خالی کلیک کنید.
یک نام برای گزارش خود وارد کنید.
پرس و جو را با استفاده از SQL سازگار BigQuery بنویسید یا ویرایش کنید. می توانید جداول و فیلدهای موجود را پیدا کرده و از تب جداول Google در SQL خود وارد کنید.
اختیاری: پارامترها را پیکربندی کنید.
اختیاری: خلاصه ردیف فیلتر شده را پیکربندی کنید.
روی ذخیره کلیک کنید.

پارامترها

پارامترها پرس و جوها را انعطاف پذیرتر می کنند. به عنوان مثال، ممکن است بخواهید یک پرس و جو را در کمپین های مختلف اجرا کنید. به جای ایجاد پرس و جوهای تکراری یا کدگذاری سخت شناسه های کمپین قبل از هر اجرا، می توانید پارامتری را پیکربندی کنید که یک یا چند شناسه کمپین را می پذیرد تا هنگام اجرای یک پرس و جو از کارت Run وارد شود. استفاده از پارامترها کد شما را تمیز نگه می دارد، شانس شما را برای ایجاد خطا از طریق ویرایش کاهش می دهد و امکان استفاده مجدد از پرس و جو را بدون ویرایش فراهم می کند. پارامترها در محدوده پرس و جوی که در آن ایجاد می شوند، قرار می گیرند، بنابراین می توانید نام پارامتر را در پرس و جوی دیگر دوباره استفاده کنید.

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

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

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

یک پارامتر ایجاد کنید

یک عبارت جستجوی ذخیره شده را باز کنید یا یک پرسش جدید ایجاد کنید .
روی Properties > Parameters > Add parameter کلیک کنید.
در قسمت Name یک نام وارد کنید. شما از این نام برای ارجاع به پارامتر در متن پرس و جو استفاده خواهید کرد.
از منوی کشویی برای انتخاب نوع پارامتر استفاده کنید.
- اگر آرایه را انتخاب کنید، یک منوی کشویی اضافی ظاهر می شود. نوع آرایه را در منوی کشویی انتخاب کنید.
اختیاری: مراحل 2-4 را تکرار کنید تا زمانی که تمام پارامترهای مورد نظر خود را اضافه کنید.
روی ذخیره کلیک کنید

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

در متن پرس و جو، از فرمت پارامتر استاندارد 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

هنگامی که پرس و جو را اجرا می کنید ، کادر گفتگوی کار جدید حاوی یک فیلد پارامترها خواهد بود. مقادیری را برای هر پارامتری که تعریف کرده اید وارد کنید.

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

درخواستی را که دارای پارامتری است که می خواهید حذف کنید باز کنید.
تب Properties را باز کنید.
در کارت پارامترها ، روی delete Delete در کنار پارامتری که می خواهید حذف کنید کلیک کنید.
روی ذخیره کلیک کنید.

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

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

`start_date`	`date` تاریخ شروع (شامل) برای کار پرس و جو. یک پارامتر تعریف شده توسط کاربر با این نام نادیده گرفته می شود و با مقادیر تنظیم شده در گفتگوی کار جدید جایگزین می شود.
`end_date`	`date` تاریخ پایان (شامل) برای کار پرس و جو. یک پارامتر تعریف شده توسط کاربر با این نام نادیده گرفته می شود و با مقادیر تنظیم شده در گفتگوی کار جدید جایگزین می شود.
`time_zone`	`string` منطقه زمانی برای کار پرس و جو. یک پارامتر تعریف شده توسط کاربر با این نام نادیده گرفته می شود و با مقادیر تنظیم شده در گفتگوی کار جدید جایگزین می شود. نکته: برای جلوگیری از مغایرت هنگام استفاده از مناطق زمانی در جستار خود، مانند بندهای `WHERE` ، می توانید `time_zone` برای مطابقت با منطقه زمانی تنظیم شده در New job استفاده کنید. همچنین مهم است که از همان منطقه زمانی منبع داده استفاده کنید.

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

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

یک پرس و جو را ویرایش کنید

به برگه Queries در Ads Data Hub بروید.
روی نام درخواستی که می خواهید ویرایش کنید کلیک کنید.
پرس و جو را ویرایش کنید.
روی ذخیره کلیک کنید.

یک پرس و جو را اجرا کنید

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

به تب Queries در Ads Data Hub بروید.
روی نام کوئری که می خواهید اجرا شود کلیک کنید.
روی play_arrow Run کلیک کنید.
- تعداد مورد انتظار بایت هایی که پرس و جو استفاده خواهد کرد در بالای صفحه نشان داده می شود.
در قسمت Ads data from یک شناسه انتخاب کنید. این باید شناسه حساب مرتبط با داده های تبلیغاتی باشد که می خواهید پرس و جو کنید. (اگر می خواهید داده های جعبه ایمنی را پرس و جو کنید، مشتری ADH Sandbox را انتخاب کنید.)
اگر از جدول مسابقه استفاده می کنید، جدول مطابقت را در قسمت Match table from انتخاب کنید.
حالت حریم خصوصی را انتخاب کنید. درباره حالت های حریم خصوصی بیشتر بیاموزید .
محل ذخیره نتایج پرس و جو در قسمت جدول مقصد را مشخص کنید.
تاریخ شروع و پایان را برای تعیین محدوده تاریخ درخواست خود وارد کنید.
یک منطقه زمانی را وارد کنید. این باید با منطقه زمانی درب خرید مطابقت داشته باشد.
اختیاری: مقادیر هر پارامتری را وارد کنید.
روی Run کلیک کنید.

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

پس از پایان یافتن درخواست شما، می توانید نتایج را در صفحه "Jobs" پیش نمایش کنید. همچنین می‌توانید داده‌ها را در BigQuery، Sheets یا Data Studio کاوش کنید.

پیش نمایش

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

BigQuery

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

Sheets و Data Studio

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