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

تعرض معظم كيانات "إعلانات 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() إلى مصفوفة من عنصرَين للإعلانات والكلمات الرئيسية، ويكون العنصر الأول هو رقم تعريف المجموعة الإعلانية. يسترد المقتطف التالي ثلاث كلمات رئيسية من مجموعة إعلانية:

let adGroupId = 123123;
let keywordSelector = AdsApp.keywords().withIds([
    [adGroupId, 234234],
    [adGroupId, 345345],
    [adGroupId, 456456]
]);

وتنطبق نفس التركيبة عند جلب الإعلانات.