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

ملاحظة مهمّة: يمكنك مواصلة العمل مع الإضافات الحالية المستندة إلى الخلاصات من خلال تجربة نصوص "إعلانات 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();

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

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

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

// 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
رقم الهاتف	getEndDate getStartDate
السعر	getEndDate getSchedules getStartDate
رابط أقسام موقع	ما مِن طُرق متوقّفة نهائيًا
المقتطف	getEndDate getSchedules getStartDate

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

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

دورات تدريبية	الطرق المتوقّفة
وسيلة شرح	ما مِن طُرق متوقّفة نهائيًا
MobileApp	setSchedules
رقم الهاتف	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