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

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

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