نظرة عامة
تسرد هذه الصفحات الموارد التي يمكن الاستعلام عنها في واجهة برمجة التطبيقات
باستخدام SearchAds360Service.SearchStream أو
SearchAds360Service.Search. وترتبط أسماء الموارد بصفحاتها الخاصة. في كل صفحة، تظهر القوائم التالية:
- العناصر (الموارد أو الشرائح أو المقاييس) التي يمكن استخدامها في عبارة SELECT نفسها مع المورد
- الموارد المنسوبة التي لن تقسّم حقولها المقاييس، عند تضمينها في عبارتَي SELECT وWHERE نفسيهما لحقول هذه الموارد
بعد هذه القوائم، تظهر الجداول التي تتألف من أسماء حقول الموارد والشرائح والمقاييس التي يمكن تضمينها في طلب بحث، عند تحديد هذا المورد في عبارة FROM. يرتبط كل اسم بالجدول الذي يحتوي على بياناته الوصفية:
categorydata typetype URLfilterableselectablesortablerepeated
- قابل للفلترة
- يشير هذا الصف إلى ما إذا كان يمكن استخدام الحقل في شروط عبارة
WHEREفي طلب البحث. - قابل للاختيار
- يشير هذا الصف إلى ما إذا كان يمكن تحديد الحقل في عبارة
SELECTفي طلب البحث. - Sortable
- يشير هذا الصف إلى ما إذا كان يمكن ترتيب الحقل واستخدامه في
ORDER BYعبارة طلب البحث. - حقل
- يشير هذا الصف إلى ما إذا كان الحقل متكرّرًا، ويجب التعامل معه كقائمة.
قائمة بجميع الموارد
| أنواع الموارد | |
|---|---|
| accessible_bidding_strategy | يمثّل هذا المورد طريقة عرض لاستراتيجيات عروض الأسعار التي يملكها العميل ويشاركها معه. وعلى عكس BiddingStrategy، يتضمّن هذا المورد الاستراتيجيات التي يملكها مديرو حسابات العميل ويشاركونها مع هذا العميل، بالإضافة إلى الاستراتيجيات التي يملكها هذا العميل. لا يقدّم هذا المورد مقاييس ولا يعرض سوى مجموعة فرعية محدودة من سمات BiddingStrategy. |
| ad_group | مجموعة إعلانية |
| ad_group_ad | إعلان في مجموعة إعلانية |
| ad_group_ad_effective_label | علاقة بين إعلان في مجموعة إعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف موروث أو تم تعيينه مباشرةً لهذا الإعلان في المجموعة الإعلانية. |
| ad_group_ad_label | علاقة بين إعلان في مجموعة إعلانية وتصنيف |
| ad_group_asset | رابط بين مجموعة إعلانية ومادة عرض |
| ad_group_asset_set | AdGroupAssetSet هو الرابط بين مجموعة إعلانية ومجموعة مواد عرض. يؤدي إنشاء AdGroupAssetSet إلى ربط مجموعة مواد عرض بمجموعة إعلانية. |
| ad_group_audience_view | طريقة عرض لجمهور مجموعة إعلانية تتضمّن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، التي يتم تجميعها على مستوى الجمهور. |
| ad_group_bid_modifier | يمثّل هذا المورد معدِّلاً لعروض أسعار مجموعة إعلانية. |
| ad_group_criterion | معيار مجموعة إعلانية لا يعرض تقرير معايير المجموعة الإعلانية سوى المعايير التي تمت إضافتها بشكلٍ صريح إلى المجموعة الإعلانية. |
| ad_group_criterion_effective_label | علاقة بين معيار مجموعة إعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف موروث أو تم تعيينه مباشرةً لمعيار المجموعة الإعلانية هذا. |
| ad_group_criterion_label | علاقة بين معيار مجموعة إعلانية وتصنيف |
| ad_group_effective_label | علاقة بين مجموعة إعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف موروث أو تم تعيينه مباشرةً لهذه المجموعة الإعلانية. |
| ad_group_label | علاقة بين مجموعة إعلانية وتصنيف |
| age_range_view | طريقة عرض النطاق العمري |
| asset | مادة العرض هي جزء من إعلان يمكن مشاركته بين إعلانات متعدّدة. ويمكن أن تكون صورة (ImageAsset) أو فيديو (YoutubeVideoAsset) أو غير ذلك. مواد العرض غير قابلة للتغيير ولا يمكن إزالتها. لإيقاف عرض مادة عرض، عليك إزالتها من الكيان الذي يستخدمها. |
| asset_group | مجموعة مواد عرض يتم استخدام AssetGroupAsset لربط مادة عرض بمجموعة مواد العرض. يتم استخدام AssetGroupSignal لربط إشارة بمجموعة مواد عرض. |
| asset_group_asset | AssetGroupAsset هو الرابط بين مادة عرض ومجموعة مواد عرض. يؤدي إضافة AssetGroupAsset إلى ربط مادة عرض بمجموعة مواد عرض. |
| asset_group_listing_group_filter | يمثّل AssetGroupListingGroupFilter عقدة شجرة فلتر مجموعة بيانات في مجموعة مواد عرض. |
| asset_group_signal | يمثّل AssetGroupSignal إشارة في مجموعة مواد عرض. يشير وجود إشارة إلى حملة الأداء الأفضل بالمستخدمين الذين يُرجّح إجراؤهم لإحالة ناجحة. وتستخدِم "حملة الأداء الأفضل" الإشارة للبحث عن مستخدِمين جدد لديهم نيّة شراء مشابهة أو أقوى حتى تتمكّن من العثور على إحالات ناجحة على مستوى "الحملات على شبكة البحث" و"الشبكة الإعلانية" و"حملات الفيديو" وغير ذلك. |
| asset_group_top_combination_view | طريقة عرض لاستخدام أفضل تركيبات مواد عرض مجموعة مواد العرض |
| asset_set | مجموعة مواد عرض تمثّل مجموعة من مواد العرض استخدِم AssetSetAsset لربط مادة عرض بمجموعة مواد العرض. |
| asset_set_asset | AssetSetAsset هو الرابط بين مادة عرض ومجموعة مواد العرض. يؤدي إضافة AssetSetAsset إلى ربط مادة عرض بمجموعة مواد العرض. |
| audience | الجمهور هو خيار استهداف فعّال يسمح لك بإجراء تقاطع على مستوى سمات الشرائح المختلفة، مثل الخصائص الديمغرافية التفصيلية والجماهير ذات الاهتمامات المشتركة، وذلك لإنشاء شرائح جمهور تمثّل أقسام شرائحك المستهدَفة. |
| bidding_strategy | استراتيجية عروض أسعار |
| campaign | حملة |
| campaign_asset | رابط بين حملة ومادة عرض |
| campaign_asset_set | CampaignAssetSet هو الرابط بين حملة ومجموعة مواد عرض. يؤدي إضافة CampaignAssetSet إلى ربط مجموعة مواد عرض بحملة. |
| campaign_audience_view | طريقة عرض لجمهور حملة تتضمّن بيانات الأداء من الاهتمامات وقوائم تجديد النشاط التسويقي للإعلانات على "الشبكة الإعلانية" و"شبكة YouTube"، وقوائم تجديد النشاط التسويقي للإعلانات على شبكة البحث (RLSA)، التي يتم تجميعها حسب الحملة ومعيار الجمهور. لا تتضمّن طريقة العرض هذه سوى شرائح الجمهور المرفقة على مستوى الحملة. |
| campaign_budget | ميزانية حملة |
| campaign_criterion | معيار حملة |
| campaign_effective_label | يمثّل هذا المورد علاقة بين حملة وتصنيف فعّال. التصنيف الفعّال هو تصنيف موروث أو تم تعيينه مباشرةً لهذه الحملة. |
| campaign_label | يمثّل هذا المورد علاقة بين حملة وتصنيف. |
| cart_data_sales_view | طريقة عرض مبيعات بيانات سلة التسوّق تقدّم هذه الطريقة معلومات عن المنتجات التي تم شراؤها في حال تنفيذ الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق. تتوفّر للمنتجات المحدّدة في خلاصة المستودع والتي يتم بيعها نتيجةً للإعلانات على Google مقاييس الأداء، مثل الإيرادات والأرباح الإجمالية ومقاييس العملاء المحتملين/البيع المكمّل وما إلى ذلك، وسمات Merchant Center، مثل العلامة التجارية والفئة وما إلى ذلك. بالنسبة إلى عمليات الشراء المنسوبة إلى النقرات على "إعلانات Shopping"، يمكن الاطّلاع على سمات المنتجات التي تم النقر عليها والمنتجات التي تم بيعها معًا. |
| conversion | إحالة ناجحة |
| conversion_action | إجراء إحالة ناجحة |
| conversion_custom_variable | متغيّر مخصَّص للإحالة الناجحة راجِع مقالة لمحة عن مقاييس Floodlight وسماته المخصّصة في التجربة الجديدة من "إعلانات شبكة البحث 360" على الرابط https://support.google.com/sa360/answer/13567857. |
| customer | عميل |
| customer_asset | رابط بين عميل ومادة عرض |
| customer_asset_set | CustomerAssetSet هو الرابط بين عميل ومجموعة مواد عرض. يؤدي إضافة CustomerAssetSet إلى ربط مجموعة مواد عرض بعميل. |
| customer_client | رابط بين العميل المحدّد وعميل آخر لا تتوفّر CustomerClients إلا للعملاء المديرين. يتم تضمين جميع حسابات العملاء المباشرة وغير المباشرة، بالإضافة إلى حساب المدير نفسه. |
| customer_manager_link | يمثّل هذا المورد علاقة رابط بين عميل ومدير. |
| dynamic_search_ads_search_term_view | طريقة عرض لعبارة بحث في "الإعلانات الديناميكية على شبكة البحث" |
| gender_view | طريقة عرض النوع تعكس طريقة عرض النوع حالة العرض الفعّالة، بدلاً من المعايير التي تمت إضافتها. تظهر المجموعة الإعلانية التي لا تتضمّن معايير النوع تلقائيًا لجميع الأنواع، لذا تظهر جميع الأنواع في طريقة عرض النوع مع الإحصاءات. |
| geo_target_constant | ثابت الموقع الجغرافي المستهدَف |
| keyword_view | طريقة عرض الكلمات الرئيسية |
| label | تصنيف |
| language_constant | لغة |
| location_view | تُلخّص طريقة عرض الموقع الجغرافي أداء الحملات حسب معيار الموقع الجغرافي. |
| product_bidding_category_constant | فئة عروض أسعار المنتجات |
| product_group_view | طريقة عرض مجموعة المنتجات |
| shopping_performance_view | طريقة عرض أداء Shopping تقدّم هذه الطريقة إحصاءات "حملات تسوّق" و"حملات الأداء الأفضل" التي يتم تجميعها على مستوى عدّة مستويات لسمات المنتجات. ستعكس قيم سمات المنتجات من Merchant Center، مثل العلامة التجارية والفئة والسمات المخصّصة وحالة المنتج ونوع المنتج، حالة كل سمة اعتبارًا من التاريخ والوقت اللذين تم فيهما تسجيل الحدث المقابل. قد يختلف عدد مرّات الظهور والنقرات التي تعرض shopping_performance_view إحصاءاتها عن تقارير الحملات. تعرض shopping_performance_view مرّات الظهور والنقرات على المنتجات التي تظهر في الإعلانات، بينما تعرض تقارير الحملات مرّات الظهور والنقرات على الإعلانات نفسها. اعتمادًا على التنسيق، يمكن أن يعرض الإعلان عددًا من المنتجات يتراوح بين صفر وعدّة منتجات، لذا قد لا تتطابق الأرقام. في واجهة مستخدم "إعلانات شبكة البحث 360"، يمكنك الاستعلام عن مرّات ظهور المنتجات التي تظهر في الإعلانات والنقرات عليها من خلال اختيار عمود من "سمات المنتج" في أداة تعديل التقارير. على سبيل المثال، إنّ اختيار عمود "العلامة التجارية" يعادل اختيار segments.product_brand. |
| user_list | قائمة مستخدمين هذه قائمة بالمستخدمين الذين يمكن للعميل استهدافهم. يتألّف المفتاح الفريد لقائمة المستخدمين من الحقل التالي: id. يُرجى العِلم أنّ name يجب أن يكون فريدًا أيضًا لقوائم المستخدمين التي يملكها عميل معيّن، باستثناء بعض الحالات التي يتم فيها ضبط access_reason على SHARED. يؤدي انتهاك قيد الاسم الفريد إلى ظهور الخطأ: UserListError.INVALID_NAME. |
| user_location_view | طريقة عرض موقع المستخدم تتضمّن طريقة عرض موقع المستخدم جميع المقاييس التي يتم تجميعها على مستوى البلد، مع صف واحد لكل بلد. تعرض هذه الطريقة المقاييس في الموقع الجغرافي الفعلي للمستخدم حسب الموقع الجغرافي المستهدَف أو غير المستهدَف. في حال استخدام حقول شرائح أخرى، قد تحصل على أكثر من صف واحد لكل بلد. |
| visit | زيارة واحدة |
| webpage_view | طريقة عرض صفحة ويب |