دادههای رویداد خام درباره تبدیلها.
این گزارش فقط با یک درخواست ناهمزمان (یعنی از طریق متد Reports.request() ) قابل بازگشت است.
از آنجایی که رویدادها در تاریخهای خاصی رخ میدهند، درخواست این گزارش باید محدوده زمانی را مشخص کند. می توانید یکی از موارد زیر را مشخص کنید:
- startDate و endDate .
- changeMetricsSinceTimestamp ( chantedAttributesSinceTimestamp برای رویدادها معتبر نیست).
درخواست گزیده
یک بدنه درخواست معمولی Reports.request() ارسال کنید، اما "reportType": "conversion"
.
{ ... "reportType": "conversion", "columns": [ { "columnName": string, "headerText": string, "startDate": string, "endDate": string } ], "filters": [ { "column": { "columnName": string, }, ... }, ... ], ... }
برای هر ستونی که می خواهید در گزارش بازگردانده یا فیلتر شود، columnName
فهرست شده در جدول زیر را مشخص کنید. همچنین می توانید به صورت اختیاری headerText , startDate و endDate را مشخص کنید. توجه داشته باشید که برخی از ستون ها را نمی توان فیلتر کرد. به "قابل فیلتر" در جدول زیر مراجعه کنید.
columnName | شرح | رفتار - اخلاق | تایپ کنید | قابل فیلتر کردن |
---|---|---|---|---|
status | وضعیت تبدیل: Active یا Removed . | صفت | Status | آره |
deviceSegment | بخش دستگاهی که تبدیل به آن نسبت داده میشود: Desktop ، Mobile ، Tablet یا Other . | صفت | Device segment | آره |
floodlightGroup | نام گروه Floodlight. | صفت | String | آره |
floodlightGroupConversionType | نوع تبدیلهای ایجاد شده توسط فعالیتهای Floodlight در این گروه: Action یا Transaction . | صفت | Conversion type | آره |
floodlightGroupId | شناسه گروه DS Floodlight. | صفت | ID | آره |
floodlightGroupTag | تگ گروه Floodlight. | صفت | String | آره |
floodlightActivity | نام فعالیت Floodlight. | صفت | String | آره |
floodlightActivityId | شناسه فعالیت DS Floodlight. | صفت | ID | آره |
floodlightActivityTag | برچسب فعالیت نورافکن. | صفت | String | آره |
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) محصول مربوط به این تبدیل است. | صفت | String | آره |
productStoreId | فروشگاه در آگهی موجودی محلی مرتبط با تبدیل. این باید با شناسههای فروشگاه استفاده شده در فید محصولات محلی شما مطابقت داشته باشد. | صفت | String | آره |
productChannel | کانال فروش محصول مرتبط با تبدیل: Online یا Local . | صفت | Product channel | آره |
conversionId | شناسهای که Search Ads 360 برای هر تبدیل ایجاد میکند. | صفت | ID | آره |
advertiserConversionId | برای تبدیلهای آفلاین، این شناسهای است که توسط تبلیغکنندگان ارائه میشود. اگر تبلیغکنندهای چنین شناسهای را مشخص نکند، Search Ads 360 یک شناسه ایجاد میکند. برای تبدیلهای آنلاین، این برابر با ستون conversionId یا ستون floodlightOrderId بسته به دستورالعملهای Floodlight تبلیغکننده است. | صفت | String | آره |
conversionType | نوع تبدیل: Action یا Transaction . | صفت | Conversion type | آره |
conversionRevenue | کل مبلغ دلار از تبدیل. | صفت | Money | آره |
conversionQuantity | مقدار اقلام ثبت شده توسط تبدیل، همانطور که توسط پارامتر qty تعیین می شود. تبلیغکننده مسئول پر کردن پویا پارامتر (مانند تعداد اقلام فروختهشده در تبدیل) است، در غیر این صورت پیشفرض 1 است. | صفت | Number | آره |
conversionDate | تاریخی، در منطقه زمانی شبکه مدیریت کمپین، زمانی که تبدیل انجام شد. این تاریخ برای انباشت متریک تبدیل استفاده می شود. برای مثال، وقتی DS کنشها را برای 1 مه جمعآوری میکند، تمام تبدیلهای کنشی را که conversionDate آنها 1 مه است، حساب میکند. | صفت | Date | آره |
conversionTimestamp | مهر زمانی UTC زمانی که تبدیل اتفاق افتاد. | صفت | Timestamp | آره |
conversionLastModifiedTimestamp | مهر زمانی UTC آخرین اصلاحات تبدیل. | صفت | Timestamp | آره |
conversionAttributionType | تبدیل به چه چیزی نسبت داده می شود: Visit یا Keyword+Ad . | صفت | Conversion attribution type | آره |
conversionVisitId | شناسه بازدید DS که تبدیل به آن نسبت داده شده است. | صفت | ID | آره |
conversionVisitTimestamp | مهر زمانی UTC بازدیدی که تبدیل به آن نسبت داده شده است. | صفت | Timestamp | آره |
conversionVisitExternalClickId | یک رشته منحصر به فرد، برای بازدیدی که تبدیل به آن نسبت داده می شود، که به عنوان پارامتر URL gclid به صفحه فرود ارسال می شود. فقط برای تبلیغکنندگانی که دارای API تبدیل یا ادغام Google Analytics هستند فعال است. | صفت | String | آره |
conversionSearchTerm | عبارت جستجویی که منجر به تبدیل شد. | صفت | String | آره |
floodlightOriginalRevenue | درآمد اصلی و بدون تغییر مرتبط با رویداد Floodlight (به واحد پول گزارش فعلی)، قبل از اصلاحات دستورالعمل ارز Floodlight. | صفت | Money | آره |
floodlightEventRequestString | رشته درخواست Floodlight تبدیل. | صفت | String | آره |
floodlightReferrer | وب سایت ارجاع دهنده Floodlight تبدیل. | صفت | String | آره |
floodlightOrderId | شناسه سفارش Floodlight که توسط تبلیغ کننده برای تبدیل ارائه شده است. | صفت | String | آره |
feedItemId | شناسه ردیف مورد فید مرتبط با این تبدیل. | صفت | ID | آره |
feedId | شناسه جدول فید مرتبط با این تبدیل. | صفت | ID | آره |
feedType | نوع خوراک مرتبط با این تبدیل. | صفت | Feed type | آره |