API قبلی Search Ads 360 Reporting حذف می‌شود و در 30 ژوئن 2024 از رده خارج می‌شود. توجه داشته باشید که Search Ads 360 Conversion API تحت تأثیر قرار نگرفته و همچنان پشتیبانی می‌شود. همه توسعه گزارش‌های جدید باید از Search Ads 360 Reporting API جدید استفاده کنند.

از آوریل 2024، هنگام درخواست گزارش، یک خطای پشتیبانی‌نشده ApiVersion برگردانده می‌شود. جزئیات را اینجا ببینید.

همچنین اکیداً توصیه می‌کنیم که پیاده‌سازی‌های موجود Search Ads 360 را به API جدید منتقل کنید. برای اطلاعات بیشتر به راهنمای جدید Search Ads 360 Reporting Getting Started and Migration مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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 به روز می کند.