تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على مقدمة عن REST للحصول على التفاصيل.

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

BiddingSeasonalityAdjustment

تمثيل JSON

يمثّل تسوية موسمية لعروض الأسعار.

الاطّلاع على صفحة "لمحة عن التسويات الموسمية" على https://support.google.com/google-ads/answer/10369906.

تمثيل JSON

تمثيل JSON
{ "resourceName": string, "seasonalityAdjustmentId": string, "scope": enum (`SeasonalityEventScope`), "status": enum (`SeasonalityEventStatus`), "startDateTime": string, "endDateTime": string, "name": string, "description": string, "devices": [ enum (`Device`) ], "conversionRateModifier": number, "campaigns": [ string ], "advertisingChannelTypes": [ enum (`AdvertisingChannelType`) ] }

{
  "resourceName": string,
  "seasonalityAdjustmentId": string,
  "scope": enum (SeasonalityEventScope),
  "status": enum (SeasonalityEventStatus),
  "startDateTime": string,
  "endDateTime": string,
  "name": string,
  "description": string,
  "devices": [
    enum (Device)
  ],
  "conversionRateModifier": number,
  "campaigns": [
    string
  ],
  "advertisingChannelTypes": [
    enum (AdvertisingChannelType)
  ]
}

الحقول
`resourceName`	`string` غير قابل للتغيير اسم المورد للتسوية الموسمية. تكون أسماء موارد التسويات الموسمية على النحو التالي: `customers/{customerId}/biddingSeasonalityAdjustments/{seasonalityAdjustmentId}`
`seasonalityAdjustmentId`	`string (int64 format)` النتائج فقط. رقم تعريف التسوية الموسمية.
`scope`	`enum (SeasonalityEventScope)` نطاق التسوية الموسمية
`status`	`enum (SeasonalityEventStatus)` النتائج فقط. حالة التسوية الموسمية.
`startDateTime`	`string` مطلوب. وقت البدء الشامل للتسوية الموسمية بالتنسيق yyyy-MM-dd HH:mm:ss يمكن الاستفادة من التسوية الموسمية في المستقبل ويجب استخدامها للأحداث التي تبدأ وتنتهي في المستقبل.
`endDateTime`	`string` مطلوب. وقت الانتهاء الحصري للتعديل الموسمي بالتنسيق yyyy-MM-dd HH:mm:ss يجب أن تكون مدة الفاصل الزمني [startDateTime, endDateTime) خلال (0 أو 14 يومًا].
`name`	`string` اسم التسوية الموسمية. يجب ألا يزيد عدد أحرف الاسم عن 255 حرفًا.
`description`	`string` وصف التسوية الموسمية. يجب ألا يزيد عدد أحرف الوصف عن 2,048 حرفًا.
`devices[]`	`enum (Device)` وإذا لم يتم تحديده، سيتم تضمين جميع الأجهزة في هذه التسوية. وبخلاف ذلك، لن يتم تضمين سوى الأجهزة المستهدفة المحددة في هذا التعديل.
`conversionRateModifier`	`number` يتم تقدير معدِّل معدل الإحالات الناجحة استنادًا إلى تغييرات معدّل الإحالات الناجحة المتوقّع. في حال ترك هذا الحقل بدون ضبط أو ضبطه على 1.0، لن يتم تطبيق أي تعديل على الزيارات. النطاق المسموح به هو من 0.1 إلى 10.0.
`campaigns[]`	`string` ستسري التسوية الموسمية على الحملات المدرَجة عندما يكون نطاق هذه التسوية هو "الحملة". الحدّ الأقصى لعدد الحملات لكلّ حدث هو 2000. ملاحظة: لا تتوفّر تسوية موسمية تتضمّن كلاً من AdvertisingChannelTypes وcampaign_ids.
`advertisingChannelTypes[]`	`enum (AdvertisingChannelType)` سيتم تطبيق تعديل العوامل الموسمية على جميع الحملات ضمن القنوات المدرَجة بأثر رجعي، وكذلك من الآن فصاعدًا عندما يكون نطاق هذا التعديل هو CHANNEL. أنواع القنوات الإعلانية المتوافقة هي "الشبكة الإعلانية" و"شبكة البحث" و"Shopping". ملاحظة: لا تتوفّر تسوية موسمية باستخدام كلّ من advertisingChannelTypes وcampaign_ids.