نوع گزارش: بازدید

داده‌های رویداد خام درباره بازدیدها. هر بار که مصرف کننده روی تبلیغ کلیک می کند و به صفحه فرود هدایت می شود، یک بازدید اتفاق می افتد.

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

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

درخواست گزیده

یک بدنه درخواست عادی Reports.request() ارسال کنید، اما "reportType": "visit" .

{
...
  "reportType": "visit",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.

columnName توضیحات رفتار تایپ کنید قابل فیلتر کردن
status وضعیت بازدید. بازدیدها تغییر ناپذیر هستند، بنابراین همیشه Active است. ویژگی Status بله
deviceSegment بخش دستگاهی که بازدید به آن نسبت داده می‌شود: Desktop ، Mobile ، Tablet یا Other . ویژگی Device segment بله
agency نام آژانس ویژگی String بله
agencyId شناسه نمایندگی DS. ویژگی ID بله
advertiser نام تبلیغ کننده ویژگی String بله
advertiserId شناسه تبلیغ کننده DS. ویژگی ID بله
account نام حساب موتور ویژگی String بله
accountId شناسه حساب موتور DS. ویژگی ID بله
accountEngineId شناسه حساب در حساب موتور خارجی. ویژگی String بله
accountType نوع حساب موتور: Google AdWords ، Bing Ads ، Yahoo Japan Listing Ads ، Yahoo Search Marketing ، Yahoo Gemini ، Baidu ، یا Comparison Shopping . ویژگی Engine type بله
campaign نام کمپین. ویژگی String بله
campaignId شناسه کمپین DS. ویژگی ID بله
campaignStatus وضعیت کمپین حاوی این مورد. ویژگی Status بله
adGroup نام گروه تبلیغاتی ویژگی String بله
adGroupId شناسه گروه تبلیغات DS. ویژگی ID بله
adGroupStatus وضعیت گروه تبلیغاتی حاوی این مورد. ویژگی Status بله
keywordId شناسه کلمه کلیدی DS. مقدار 0 نشان می دهد که کلمه کلیدی نسبت داده نشده است. ویژگی ID بله
keywordMatchType نوع تطابق کلمه کلیدی: Broad ، Exact ، Phrase یا Content . ویژگی Match type بله
keywordText متن کلمه کلیدی ویژگی String بله
productTargetId شناسه هدف محصول DS. ویژگی ID بله
productGroupId شناسه گروه محصول مرتبط با این بازدید. فقط بازدیدهای کمپین های خرید دارای شناسه گروه محصول هستند. شناسه گروه محصول نباید برای پیوستن استفاده شود. ویژگی ID بله
ad نام آگهی ویژگی String بله
adId شناسه آگهی DS. مقدار 0 نشان می دهد که تبلیغ بدون نسبت است. ویژگی ID بله
isUnattributedAd نشان می دهد که آیا معیارهای موجود در این ردیف به یک آگهی خاص قابل انتساب نیستند یا خیر. به عنوان مثال، یک تبلیغ با فرمت پشتیبانی نشده یا URL سرور کلیک اشتباه می‌تواند مانع از نسبت دادن معیارهای DS به یک آگهی شود. ویژگی Boolean بله
inventoryAccountId شناسه حساب موجودی DS حاوی محصولی که روی آن کلیک شده است. هنگامی که یک حساب موجودی را در DS پیوند می دهید، DS این شناسه را ایجاد می کند. ویژگی ID بله
productId شناسه محصول روی آن کلیک کرد. ویژگی String بله
productCountry کشور (فرمت ISO 3166) ثبت شده برای فید موجودی که شامل محصول کلیک شده است. ویژگی String بله
productLanguage زبان (ISO 639-1) که برای فید Merchant Center حاوی داده‌های مربوط به محصول تنظیم شده است. ویژگی String بله
productStoreId فروشگاه موجود در آگهی موجودی محلی که روی آن کلیک شد. این باید با شناسه‌های فروشگاه استفاده شده در فید محصولات محلی شما مطابقت داشته باشد. ویژگی String بله
productChannel کانال فروش محصولی که روی آن کلیک شده است: Online یا Local . ویژگی Product channel بله
visitId شناسه بازدید DS. ویژگی ID بله
visitSearchQuery عبارت جستجویی که این بازدید را ایجاد کرد. ویژگی String بله
visitDate تاریخ، در منطقه زمانی حساب موتور، زمانی که بازدید رخ داده است. این تاریخ برای جمع آوری بازدیدها استفاده می شود. به عنوان مثال، هنگامی که DS بازدیدها را برای 1 مه جمع آوری می کند، تمام بازدیدهایی را که visitDate آنها 1 می است را می شمارد. ویژگی Date بله
visitTimestamp مهر زمانی UTC زمانی که بازدید انجام شد. ویژگی Timestamp بله
visitNetworkType شبکه تبلیغاتی که این بازدید را ایجاد کرد: Content ، Search یا Other . ویژگی Network type بله
visitReferrer آدرس ارجاع دهنده بازدید. ویژگی String بله
visitExternalClickId یک رشته منحصر به فرد برای هر بازدید که به عنوان پارامتر URL gclid به صفحه فرود ارسال می شود. فقط برای تبلیغ‌کنندگانی که دارای API تبدیل یا ادغام Google Analytics هستند فعال است. ویژگی String بله
feedItemId شناسه ردیف مورد فید مرتبط با این بازدید. ویژگی ID بله
feedId شناسه جدول فید مرتبط با این بازدید. ویژگی ID بله
feedType نوع خوراک مرتبط با این بازدید. ویژگی Feed type بله