أرقام التعريف

تعرض معظم كيانات "إعلانات 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]
]);

تنطبق الصيغة نفسها عند جلب الإعلانات.