دادههای رویداد خام درباره بازدیدها. هر بار که مصرف کننده روی تبلیغ کلیک می کند و به صفحه فرود هدایت می شود، یک بازدید اتفاق می افتد.
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.
از آنجایی که رویدادها در تاریخهای خاصی رخ میدهند، درخواست این گزارش باید محدوده زمانی را مشخص کند. می توانید یکی از موارد زیر را مشخص کنید:
- startDate و endDate .
- changeMetricsSinceTimestamp ( chantedAttributesSinceTimestamp برای رویدادها معتبر نیست).
درخواست گزیده
یک بدنه درخواست عادی 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 | بله |