استخدام الدالة ALL

تتحقق الدالة ALL(...)‎ مما إذا كان أحد العناصر يحتوي فقط على عناصر تتطابق مع فلتر معيّن. وعند التحقّق، فإنك تحدّد الأنواع التي يجب مطابقة العناصر المتضمّنة بها، وفلتر فرعي للإشارة إلى العناصر المتضمّنة التي يجب مطابقتها.

الدالة ALL هي دالة تيسير تُبسِّط كتابة عمليات التحقّق من كل العناصر المضمّنة. والدالة ALL(types, filter) تعادل الدالة COUNT(types, NOT(filter)) = 0. بعبارة أخرى، تساعد الدالة ALL في العثور على حاويات لا تتضمّن عناصر لا تتطابق مع الفلتر الفرعي.

البنية

ALL(types, [filter])

• types -- نوع العناصر المتضمّنة التي يلزم التحقّق منها.
• filter -- يجب أن تتطابق جميع العناصر المتضمّنة مع هذا الفلتر.

أمثلة

ALL(keywords, labels = ("abc", "xyz") )

تتحقّق هذه الدالة مما إذا كانت جميع الكلمات الرئيسية في الحملة أو المجموعة الإعلانية تحتوي على التصنيفات "abc" أو "xyz". وفي هذا المثال، يكون الجزء "keywords" هو نوع العنصر الذي يلزم التحقّق منه، بينما يكون الجزء "labels = ("abc", "xyz")" هو الفلتر الفرعي الذي يجب أن تتطابق جميعها معه.

ALL(callextensions; sitelinks, approvalstatus = approved)

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

ملاحظات

• إذا كانت هناك عدة شروط في الفلتر الفرعي، يجب أن تتطابق جميعها مع العناصر المتضمّنة. ويمكن تضمينها في دالة OR للتحقّق من تطابق العناصر المتضمّنة مع أيٍّ من الشروط. على سبيل المثال، ستتحقّق الدالة ALL(ads, OR(status = paused approvalstatus = disapproved)) مما إذا كانت كل الإعلانات متوقفة مؤقتًا أو مرفوضة أو كلتيهما.
• يمكن أن يحتوي الفلتر على شروط لا تنطبق إلا على بعض الأنواع، وسيتم تجاهل هذه الشروط للأنواع التي لا تنطبق عليها. على سبيل المثال: ستتحقّق الدالة ALL(keywords; sitelinks, keywordwordcount = 2 linktext : "local") من أنّ كل الكلمات الرئيسية تحتوي على كلمتَين تحديدًا وأنّ كل روابط أقسام الموقع المرتبطة بها تحتوي على "local" في نص الرابط.
• في حال عدم توفُّر عناصر متضمّنة من النوع المحدّد، ستنجح عملية التحقّق باستخدام ALL. على سبيل المثال، ستعرض الدالة ALL(keywords, status = enabled) حملة أو مجموعة إعلانية إذا لم تتضمّن كلمات رئيسية على الإطلاق. ويرجع ذلك إلى أن المثال هو ببساطة دالة تيسير لدالة COUNT(keywords, NOT(status = enabled)) = 0، وعدد الكلمات الرئيسية غير المُفعّلة في الحملة أو المجموعة الإعلانية هو 0 تحديدًا. لحصر النتائج في العناصر فقط التي تحتوي على عنصر واحد على الأقل يتطابق مع الفلتر، يمكنك إضافة دالة EXIST باستخدام الأنواع نفسها والفلتر الفرعي ALL. في هذا المثال، يمكنك استخدام هذا الفلتر: EXIST(keywords, status = enabled) ALL(keywords, status = enabled). وبعبارة أخرى، سيعرض هذا الفلتر الحملات التي تتوفّر فيها كلمة رئيسية مفعَّلة واحدة على الأقل وجميع الكلمات الرئيسية فيها مفعّلة.

استخدام الدالة ALL مع الحملات والمجموعات الإعلانية

بالنسبة إلى العناصر التي لا يمكن تضمينها إلا في مجموعات إعلانية، سيؤدي التحقّق على مستوى الحملة إلى التحقّق من كل العناصر من كل المجموعات الإعلانية لمعرفة ما إذا كانت تتطابق مع الفلتر الفرعي. على سبيل المثال، تعرض الدالة ALL(keywords, status = enabled) على مستوى الحملة ما إذا كانت كل الكلمات الرئيسية في كل المجموعات الإعلانية ضمن الحملة مفعّلة.

أمّا بالنسبة إلى العناصر التي يمكن تضمينها في مجموعات إعلانية أو حملات، سيؤدي التحقّق على مستوى الحملة إلى التحقّق فقط من العناصر ضمن الحملة مباشرةً. على سبيل المثال، الفلتر ALL(audiences, status = enabled) على مستوى الحملة سيعرض الحملة في حال تفعيل كل جماهيرها على مستوى الحملة، حتى إذا كانت الحملة تتضمّن بعض الجماهير غير المفعّلة على مستوى المجموعة الإعلانية. ينطبق الأمر نفسه على مواد العرض: الفلتر ALL(sitelinks, status = enabled) على مستوى الحملة لن يتحقّق سوى من روابط أقسام الموقع على مستوى الحملة، وليس روابط أقسام الموقع على مستوى المجموعة الإعلانية ضمن الحملة.