نقل النصوص البرمجية لمعلومات الإعلان الإضافية

ملاحظة مهمة: يمكنك مواصلة العمل باستخدام الإضافات الحالية المستندة إلى الخلاصات من خلال تجربة نصوص "إعلانات Google" البرمجية القديمة. ومع ذلك، ستصبح الإضافات المستندة إلى الخلاصات غير متوفّرة قريبًا، ولن تتوفّر الإضافات المستندة إلى مواد العرض فقط في تجربة نصوص "إعلانات Google" البرمجية الجديدة. ننصحك بنقل نصوص "إعلانات Google" البرمجية القديمة إلى التجربة الجديدة من نصوص "إعلانات Google" البرمجية في أقرب وقت ممكن.

يصف هذا المستند عملية نقل النصوص البرمجية التي يمكنها الوصول إلى معلومات الإعلان الإضافية أو إدارتها. اعتبارًا من 28 آذار (مارس) 2022، سيتم نقل الإضافات المستندة إلى الخلاصات إلى الإضافات الجديدة المستندة إلى مواد العرض للعملاء الذين يعدِّلون نصوصًا برمجية. اعتبارًا من 13 أيار (مايو) 2022، سيتم نقل الإضافات المستندة إلى الخلاصات إلى الإضافات الجديدة المستندة إلى مواد العرض للعملاء الذين لديهم نصوص برمجية تجلب معلومات الإعلان الإضافية (ولا نصوص برمجية تعدّل معلومات الإعلان الإضافية).

نظرة عامة

ملاحظة: إذا لم تتوفّر لديك أي نصوص برمجية يمكنها الوصول إلى معلومات الإعلان الإضافية أو تعديلها، ليس عليك اتّخاذ أيّ إجراء ويمكنك بدلاً من ذلك الرجوع إلى دليل معلومات الإعلان الإضافية.

تم إيقاف نموذج الإضافات الحالية المستندة إلى الخلاصات بدلاً من الإضافات المستندة إلى مواد العرض. يُشار إلى الإضافات المستندة إلى الخلاصات باسم الإضافات "القديمة" في واجهة مستخدم "إعلانات Google"، بينما يُشار إلى الإضافات المستندة إلى مواد العرض باسم الإضافات "التي تمّت ترقيتها" في واجهة مستخدِم "إعلانات Google".

اعتبارًا من 28 آذار (مارس) 2022، سيتم نقل الإضافات المستندة إلى الخلاصات إلى الإضافات الجديدة المستندة إلى مواد العرض. وبعد نقل البيانات، سيتوقّف عرض الإضافات المستندة إلى الخلاصات. سيوضّح هذا الدليل عملية النقل سواء كان حسابك يتضمّن معلومات إعلان إضافية مستندة إلى الخلاصات وأخرى مستندة إلى مواد العرض في حسابك على "إعلانات Google"، أو إذا كان حسابك يتضمن معلومات إعلان إضافية مستندة إلى الخلاصات فقط.

تفاصيل نقل البيانات

لبدء الوصول إلى معلومات الإعلان الإضافية المستندة إلى مواد العرض أو تعديلها، يجب استخدام تجربة نصوص "إعلانات Google" البرمجية الجديدة. للحصول على معلومات حول تجربة نصوص "إعلانات Google" البرمجية الجديدة، اطّلع على دليل البدء.

جارٍ استرجاع معلومات الإعلان الإضافية

المجموعة الحالية من أدوات اختيار معلومات الإعلان الإضافية (على سبيل المثال، SitelinkSelector يمكنها جلب معلومات الإعلان الإضافية المستندة إلى الخلاصة أو معلومات الإعلان الإضافية المستندة إلى مواد العرض. وبشكلٍ افتراضي، ستعرض أدوات الاختيار هذه أي نوع من معلومات الإعلان الإضافية المعروضة حاليًا. يلخص الجدول التالي نوع معلومات الإعلان الإضافية التي يتم عرضها حاليًا (وبالتالي سيتم عرضها بشكل افتراضي):

نوع معلومات الإعلان الإضافية في الحساب
معلومات الإعلان الإضافية المستندة إلى الخلاصات فقط	سيتم تلقائيًا عرض معلومات الإعلان الإضافية المستندة إلى الخلاصات.
معلومات الإعلان الإضافية المستندة إلى مواد العرض فقط	ستُعرض بشكلٍ تلقائي معلومات الإعلان الإضافية المستندة إلى مواد العرض.
معلومات الإعلان الإضافية المستندة إلى الخلاصات وتلك المستندة إلى مواد العرض	ستُعرض بشكلٍ تلقائي معلومات الإعلان الإضافية المستندة إلى مواد العرض.

بعد نقل كل معلومات الإعلان الإضافية المستندة إلى الخلاصات، ستعرض جميع أدوات اختيار معلومات الإعلان الإضافية بشكلٍ تلقائي معلومات الإعلان الإضافية المستندة إلى مواد العرض. سيظل من الممكن استرجاع معلومات الإعلان الإضافية المستندة إلى الخلاصة من خلال طريقة withOnlyLegacy. هذا مفيد لجمع المقاييس التاريخية.

// This will return feed-based sitelink extensions before and after
// March 28, 2022.
const sitelinks = AdsApp.extensions().sitelinks().withOnlyLegacy().get();

في معظم الحالات، من المفترض ألا تكون هناك حاجة إلى إجراء تغييرات على الرمز قبل أو بعد نقل إضافات الإعلانات المستندة إلى الخلاصة. ومع ذلك، هناك بعض السيناريوهات التي قد يلزم فيها إجراء تغييرات على التعليمات البرمجية.

فلترة معلومات الإعلان الإضافية حسب رقم التعريف

عند نقل معلومات إعلان إضافية مستندة إلى خلاصة، سيكون لإضافة الإعلان المقابلة المستندة إلى مواد العرض رقم تعريف مختلف. وهذا يعني أنّه في حال كان النص البرمجي يفلتر حاليًا معلومات الإعلان الإضافية حسب رقم التعريف، لن يتمكّن من جلب معلومات الإعلان الإضافية المستندة إلى مواد العرض.

// If these IDs belong to feed-based sitelink extensions, this code will return
// an empty iterator on or after March 28, 2022 (once the extensions have been
// migrated).
const ids = [123, 456, 789];
const sitelinks = AdsApp.extensions().sitelinks().withIds(ids).get();

لحل هذه المشكلة، يجب عليك الفلترة حسب سمة مختلفة أو تحديث الرمز لاستخدام أرقام تعريف معلومات الإعلان الإضافية المستندة إلى مواد العرض بدلاً من ذلك.

فلترة معلومات الإعلان الإضافية حسب الإحصاءات

عند نقل إضافة إعلان مستندة إلى خلاصة، ستتم إعادة ضبط إحصاءات إضافة الإعلان المقابلة المستندة إلى مواد العرض. يجب مراعاة ذلك عند فلترة معلومات الإعلان الإضافية حسب الإحصاءات. على سبيل المثال، إذا طلبت إضافات روابط أقسام موقع باستخدام Clicks > 100 في LAST_MONTH، يمكنك رؤية إضافات إعلانات أقل من المعتاد في حال نقل معلومات الإعلان الإضافية المستندة إلى الخلاصات مؤخرًا.

وينبغي لك أيضًا مراعاة ذلك عند إنشاء تقارير الأداء لمعلومات الإعلان الإضافية. يمكن أن تشهد تقاريرك تحولات أو انخفاضات كبيرة عند نقل معلومات الإعلان الإضافية المستندة إلى الخلاصة.

الطرق التي تم إيقافها نهائيًا

كجزء من عملية نقل البيانات، لم تعُد عدة حقول متاحة. على سبيل المثال، تم إيقاف تاريخ البدء وتاريخ الانتهاء من إضافات المقتطفات. عند الاتصال بـ getStartDate()، سيتم عرض "null". بالإضافة إلى ذلك، سيتم تسجيل رسالة تحذير. اطّلِع على الجدول التالي لمعرفة الطرق التي تم إيقافها نهائيًا:

دورات تدريبية	الطرق التي تم إيقافها نهائيًا
وسيلة شرح	ما مِن طرق متوقّفة نهائيًا.
MobileApp	getSchedules
PhoneNumber	getEndDate getStartDate
السعر	getEndDate getSchedules getStartDate
رابط أقسام الموقع	ما مِن طرق متوقّفة نهائيًا.
المقتطف	getEndDate getSchedules getStartDate

جارٍ تعديل معلومات الإعلان الإضافية

كجزء من عملية نقل البيانات، لم تعُد عدة حقول متاحة. على سبيل المثال، تم إيقاف تاريخ البدء وتاريخ الانتهاء من إضافات المقتطفات. ولن تؤثّر المكالمات التي يتم إجراؤها إلى setStartDate في معلومات الإعلان الإضافية. بالإضافة إلى ذلك، سيتم تسجيل رسالة تحذير. اطّلِع على الجدول التالي لمعرفة الطرق التي تم إيقافها:

دورات تدريبية	الطرق التي تم إيقافها نهائيًا
وسيلة شرح	ما مِن طرق متوقّفة نهائيًا.
MobileApp	setSchedules
PhoneNumber	clearEndDate clearStartDatesetEndDate setStartDate
السعر	clearEndDate clearStartDatesetEndDate setSchedules setStartDate
رابط أقسام الموقع	ما مِن طرق متوقّفة نهائيًا.
المقتطف	clearEndDate clearStartDatesetEndDate setSchedules setStartDate

إنشاء معلومات إعلان إضافية

المجموعة الحالية من أدوات إنشاء معلومات الإعلان الإضافية (على سبيل المثال، SitelinkBuilder يمكنها إنشاء معلومات الإعلان الإضافية المستندة إلى الخلاصة أو إضافات الإعلانات المستندة إلى مواد العرض. بشكلٍ افتراضي، ستنشئ أدوات الإنشاء هذه أي نوع من معلومات الإعلان الإضافية التي يتم عرضها حاليًا. يلخّص الجدول التالي نوع معلومات الإعلان الإضافية التي يتم عرضها حاليًا (وبالتالي سيتم إنشاؤها بشكلٍ تلقائي):

نوع معلومات الإعلان الإضافية في الحساب
معلومات الإعلان الإضافية المستندة إلى الخلاصات فقط	سيتم إنشاء معلومات الإعلان الإضافية المستندة إلى الخلاصات تلقائيًا
معلومات الإعلان الإضافية المستندة إلى مواد العرض فقط	سيتم إنشاء معلومات الإعلان الإضافية المستندة إلى مواد العرض تلقائيًا
معلومات الإعلان الإضافية المستندة إلى الخلاصات وتلك المستندة إلى مواد العرض	سيتم إنشاء معلومات الإعلان الإضافية المستندة إلى مواد العرض تلقائيًا

وبعد نقل إضافات العميل، ستعمل جميع أدوات إنشاء معلومات الإعلان الإضافية على إنشاء معلومات إعلان إضافية مستندة إلى مواد العرض تلقائيًا. لن يعود إنشاء معلومات الإعلان الإضافية المستندة إلى الخلاصات متاحًا لأنّنا لن تُعرَض معلومات الإعلان الإضافية المستندة إلى الخلاصات بعد الآن.

إذا أردت إنشاء إضافة مستندة إلى الخلاصة بدلاً من الاعتماد على السلوك التلقائي، يمكنك إجراء ذلك من خلال طلب build(true) بدلاً من build()، على سبيل المثال:

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(true) means this will create a legacy phone number extension.
  .build(true)
  .getResult();

إذا كنت تريد إنشاء إضافة مستندة إلى مواد العرض وكان حسابك لا يتضمّن حاليًا سوى إضافات مستندة إلى الخلاصات، يمكنك إما الانتظار حتى 28 آذار (مارس) أو الاتصال بـ build(false).

const phoneNumberBuilder = AdsApp.extensions().newPhoneNumberBuilder();
const newPhoneNumber = phoneNumberBuilder
  .withCountry("US")
  .withPhoneNumber("4085550000")
  .withCallOnly(false)
  // Calling build(false) means this will create an asset-based phone number extension
  // even if the account currently only has feed-based extensions.
  .build(false)
  .getResult();

حقول غير متوافقة

تم إيقاف بعض الحقول نهائيًا كجزء من عملية نقل معلومات الإعلان الإضافية. على سبيل المثال، تم إيقاف تاريخ البدء وتاريخ الانتهاء نهائيًا في إضافات المقتطفات. ولن يكون للاستدعاءات الموجّهة إلى withEndDate أو withStartDate أي تأثير في الإضافة، بل سيتم تسجيل رسالة تحذير. انظر الجدول التالي لفهم الطرق التي تم إيقافها لكل فئة:

دورات تدريبية	الطرق التي تم إيقافها نهائيًا
CalloutBuilder	withMobilePreferred
MobileAppBuilder	withMobilePreferred withSchedules
PhoneNumberBuilder	withEndDate withMobilePreferred withStartDate
PriceBuilder	withEndDate withMobilePreferred withSchedules withStartDate
SitelinkBuilder	withMobilePreferred
SnippetBuilder	withEndDate withMobilePreferred withSchedules withStartDate