تعرض معظم كيانات "إعلانات Google" طريقة getId() تعرض
معرّفها. على الرغم من أنّ أرقام التعريف ليست ضرورية في معظم الحالات، إلا أنّها قد تكون مفيدة
في الحالات التالية:
- العمل مع التقارير
- توفّر الأرقام التعريفية طريقة جيدة لربط صفّ تقرير بعنصر "إعلانات Google" الفعلي.
- الحفاظ على عملية الربط مع مستودع بيانات خارجي
- قد تكون لديك معلومات مستندة إلى مستند تعريف محفوظة في قاعدة بياناتك.
- أريد تحسين الأداء قليلاً
غالبًا ما يكون الجلب حسب المعرّفات أسرع من البدائل الأخرى. إنّ رمز جلب ملف شخصي واحد أسهل قليلاً أيضًا:
let campaigns = AdsApp.campaigns() .withIds([678678]) .get(); // vs. let campaigns = AdsApp.campaigns() .withCondition("Name='My Campaign'") .get();
التميز
تكون أرقام تعريف الحملات والمجموعات الإعلانية فريدة: لن تشترك أيّ حملتَين أو مجموعتَين إعلانيتَين في الرقم التعريفي نفسه. أمّا الإعلانات والكلمات الرئيسية، فلديها أرقام تعريف مركبة: فمعرّف فريد لكلمة رئيسية هو عبارة عن تركيبة من رقم تعريف المجموعة الإعلانية ورقم تعريف الكلمة الرئيسية.
وبالمثل، فإنّ المعرّف الفريد للإعلان هو عبارة عن تركيبة من رقم تعريف مجموعته الإعلانية و
رقم تعريف الإعلان. ويؤدّي ذلك إلى تأثيرات في طريقة استدعاء selector.withIds().
بالنسبة إلى الحملات والمجموعات الإعلانية، تتوقّع دالة selector.withIds() صفيفًا من الأرقام:
let ids = [123123, 234234, 345345];
let campaignSelector = AdsApp.campaigns().withIds(ids);
بالنسبة إلى الإعلانات والكلمات الرئيسية، يحتاج selector.withIds() إلى صفيف من
صفائف ذات عنصرَين، ويكون العنصر الأول هو رقم تعريف المجموعة الإعلانية. يسترجع ال snippet التالي
ثلاث كلمات رئيسية من مجموعة إعلانية:
let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
[adGroupId, 234234],
[adGroupId, 345345],
[adGroupId, 456456]
]);
وينطبق الأسلوب نفسه عند جلب الإعلانات.