Conversion

منبع تبدیل روش هایی دارد که به کاربران امکان می دهد تبدیل های Floodlight را به صورت انبوه ایجاد، اصلاح و بازیابی کنند.

برای لیست روش های این منبع، انتهای این صفحه را ببینید.

بازنمایی منابع

لیستی از تبدیل ها

{
  "kind": "doubleclicksearch#conversionList",
  "conversion": [
    {
      "agencyId": long,
      "advertiserId": long,
      "engineAccountId": long,
      "campaignId": long,
      "customerId": string,
      "adGroupId": long,
      "criterionId": long,
      "adId": long,
      "clickId": string,
      "dsConversionId": long,
      "conversionId": string,
      "state": string,
      "type": string,
      "revenueMicros": long,
      "currencyCode": string,
      "quantityMillis": long,
      "segmentationType": string,
      "segmentationId": long,
      "segmentationName": string,
      "conversionTimestamp": unsigned long,
      "conversionModifiedTimestamp": unsigned long,
      "floodlightOrderId": string,
      "customMetric": [
        {
          "name": string,
          "value": double
        }
      ],
      "customDimension": [
        {
          "name": string,
          "value": string
        }
      ],
      "countMillis": long,
      "attributionModel": string,
      "productGroupId": long,
      "inventoryAccountId": long,
      "productId": string,
      "productCountry": string,
      "productLanguage": string,
      "channel": string,
      "storeId": string,
      "deviceType": string,
      "adUserDataConsent": string
    }
  ]
}
نام ملک ارزش توضیحات یادداشت ها
conversion[] list تبدیل های درخواستی
conversion[]. adGroupId long شناسه گروه تبلیغات DS.
conversion[]. adId long شناسه آگهی DS.
conversion[]. adUserDataConsent string نشان دهنده رضایت برای اولویت های خدمات پلت فرم اصلی (CPS) در تنظیمات است. بدون مقدار پیش فرض مقادیر قابل قبول عبارتند از: GRANTED: وضعیت رضایت مورد نظر اعطا است. تنظیمات برگزیده CPS را از تنظیمات GTE بخوانید. رد شده: وضعیت رضایت مورد نظر انکار است. لیست CPS خالی است.
conversion[]. advertiserId long شناسه تبلیغ کننده DS.
conversion[]. agencyId long شناسه نمایندگی DS.
conversion[]. attributionModel string فقط پس از تماس با پشتیبانی مشتری DoubleClick Search برای تبلیغ‌کنندگان در دسترس است.
conversion[]. campaignId long شناسه کمپین DS.
conversion[]. channel string کانال فروش محصول مقادیر قابل قبول عبارتند از:
  • « local »: یک فروشگاه فیزیکی
  • " online ": یک فروشگاه اینترنتی
conversion[]. clickId string شناسه DS برای تبدیل کلیک کنید.
conversion[]. conversionId string برای تبدیل‌های آفلاین، تبلیغ‌کنندگان این شناسه را ارائه می‌کنند. تبلیغ‌کنندگان می‌توانند هر شناسه‌ای را که برایشان معنادار است، مشخص کنند. هر تبدیل در یک درخواست باید یک شناسه منحصر به فرد را مشخص کند و ترکیب شناسه و مهر زمانی باید در بین همه تبدیل‌های موجود در تبلیغ‌کننده منحصر به فرد باشد.
برای تبدیل‌های آنلاین، DS بسته به دستورالعمل‌های Floodlight تبلیغ‌کننده، dsConversionId یا floodlightOrderId را در این ویژگی کپی می‌کند.
conversion[]. conversionModifiedTimestamp unsigned long زمانی که آخرین بار در آن تبدیل تغییر کرده است، در epoch millis UTC.
conversion[]. conversionTimestamp unsigned long زمانی که در آن تبدیل صورت گرفت، در دوره UTC.
conversion[]. countMillis long فقط پس از تماس با پشتیبانی مشتری DoubleClick Search برای تبلیغ‌کنندگان در دسترس است.
conversion[]. criterionId long شناسه معیار DS (کلمه کلیدی).
conversion[]. currencyCode string کد ارز برای درآمد تبدیل. باید در قالب ISO 4217 حروف الفبا (3 کاراکتر) باشد. قابل نوشتن
conversion[]. customDimension[] list ابعاد سفارشی برای تبدیل، که می تواند برای فیلتر کردن داده ها در یک گزارش استفاده شود.
conversion[].customDimension[]. name string نام ابعاد سفارشی
conversion[].customDimension[]. value string ارزش ابعاد سفارشی
conversion[]. customMetric[] list معیارهای سفارشی برای تبدیل
conversion[].customMetric[]. name string نام متریک سفارشی
conversion[].customMetric[]. value double مقدار عددی متریک سفارشی.
conversion[]. customerId string شناسه مشتری جدید Search Ads 360. باید حساب مشتری باشد. وقتی این فیلد تنظیم شد، همه فیلدهای شناسه دیگر باید روی شناسه‌های Search Ads 360 جدید تنظیم شوند.
conversion[]. deviceType string نوع دستگاهی که در آن تبدیل انجام شده است.

مقادیر قابل قبول عبارتند از:
  • " DESKTOP "
  • " HIGH_END_MOBILE "
  • " OTHER_DEVICE "
  • " TABLET "
conversion[]. dsConversionId long شناسه ای که DoubleClick Search برای هر تبدیل ایجاد می کند.
conversion[]. engineAccountId long شناسه حساب موتور DS.
conversion[]. floodlightOrderId string شناسه سفارش Floodlight که توسط تبلیغ کننده برای تبدیل ارائه شده است.
conversion[]. inventoryAccountId long شناسه‌ای که DS تولید می‌کند و برای شناسایی منحصربه‌فرد حساب موجودی حاوی محصول استفاده می‌کند.
conversion[]. productCountry string کشور ثبت شده برای فید Merchant Center که حاوی محصول است. برای تعیین کشور از کد ISO 3166 استفاده کنید.
conversion[]. productGroupId long شناسه گروه محصول DS.
conversion[]. productId string شناسه محصول (SKU).
conversion[]. productLanguage string زبان ثبت شده برای فید Merchant Center که حاوی محصول است. برای تعیین زبان از کد ISO 639 استفاده کنید.
conversion[]. quantityMillis long مقدار این تبدیل، بر حسب میلی. قابل نوشتن
conversion[]. revenueMicros long مقدار درآمد این تبدیل TRANSACTION ، در میکرو (مقدار ضربدر 1000000، بدون اعشار). به عنوان مثال، برای تعیین مقدار درآمد "10" "10000000" (10 میلیون) را در درخواست خود وارد کنید. قابل نوشتن
conversion[]. segmentationId long شناسه تقسیم بندی عددی (به عنوان مثال شناسه فعالیت DoubleClick Search Floodlight).
conversion[]. segmentationName string شناسه تقسیم بندی دوستانه (به عنوان مثال، نام فعالیت DoubleClick Search Floodlight).
conversion[]. segmentationType string نوع تقسیم بندی این تبدیل (به عنوان مثال، FLOODLIGHT ).

مقادیر قابل قبول عبارتند از:
  • " FLOODLIGHT "
conversion[]. state string وضعیت تبدیل، یعنی یا ACTIVE یا REMOVED . توجه: حالت DELETED منسوخ شده است.

مقادیر قابل قبول عبارتند از:
  • " ACTIVE "
  • " DELETED ": (منسوخ شده)
  • " REMOVED "
قابل نوشتن
conversion[]. storeId string شناسه فروشگاه محلی که محصول برای آن تبلیغ شده است. فقط زمانی که کانال " local " باشد قابل اجرا است.
conversion[]. type string نوع تبدیل، یعنی ACTION یا TRANSACTION . تبدیل ACTION کنشی است که توسط کاربر انجام می‌شود که ارزش پولی قابل اندازه‌گیری ندارد، در حالی که تبدیل TRANSACTION عملی است که دارای ارزش پولی قابل سنجش است. به عنوان مثال، ثبت نام در لیست ایمیل ( ACTION ) در مقابل خریدهای تجارت الکترونیک ( TRANSACTION ) است.

مقادیر قابل قبول عبارتند از:
  • " ACTION "
  • " TRANSACTION "
kind string این را به عنوان یک منبع ConversionList شناسایی می کند. مقدار: رشته ثابت doubleclicksearch#conversionList .

روش ها

دریافت کنید
فهرستی از تبدیل‌ها را از حساب موتور جستجوی DoubleClick بازیابی می‌کند.
getByCustomerId
فهرستی از تبدیل‌ها را از حساب موتور جستجوی DoubleClick با استفاده از شناسه مشتری Search Ads 360 جدید بازیابی می‌کند.
درج کنید
دسته ای از تبدیل های جدید را در DoubleClick Search درج می کند.
به روز رسانی کنید
دسته ای از تبدیل ها را در جستجوی DoubleClick به روز می کند.
updateAvailability
در دسترس بودن دسته ای از فعالیت های نورافکن را در جستجوی DoubleClick به روز می کند.