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