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

داده‌های رویداد خام درباره تبدیل‌ها.

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

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

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

یک بدنه درخواست معمولی 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 آره