نظرة عامة
تعرض هذه الصفحات الموارد التي يمكن طلبها في واجهة برمجة التطبيقات باستخدام 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 سوى المعايير التي تمت إضافتها صراحةً إلى المجموعة الإعلانية. |
| ad_group_criterion_effective_label | علاقة بين معيار مجموعة إعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف موروث أو تم تعيينه مباشرةً لمعيار المجموعة الإعلانية هذا. |
| ad_group_criterion_label | علاقة بين معيار مجموعة إعلانية وتصنيف |
| ad_group_effective_label | علاقة بين مجموعة إعلانية وتصنيف فعّال التصنيف الفعّال هو تصنيف مكتسَب أو تم تعيينه مباشرةً لهذه المجموعة الإعلانية. |
| ad_group_label | علاقة بين مجموعة إعلانية وتصنيف |
| age_range_view | عرض الفئة العمرية تمثّل هذه السمة عرضًا لمقاييس أداء العميل (مثل مرّات الظهور والنقرات) مجمّعة حسب الفئة العمرية. يتم تجميع جميع الإحصاءات على مستوى المجموعة الإعلانية. ملاحظة: على الرغم من أنّه يمكنك تقسيم المقاييس حسب الفئة العمرية باستخدام age_range_view أو حسب الجنس باستخدام gender_view، لا تتيح Search Ads 360 API تقسيم المقاييس حسب الفئة العمرية والجنس في الوقت نفسه في طلب بحث واحد. لا تتيح Search Ads 360 API تحليل الأداء على مستوى كلا السمتَين معًا. |
| 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 | عرض مبيعات بيانات سلة التسوّق توفّر هذه السمة معلومات عن المنتجات التي تم شراؤها في حال تنفيذ ميزة "الإحالات الناجحة استنادًا إلى بيانات سلة التسوّق". تتوفّر مقاييس الأداء، مثل الإيرادات والأرباح الإجمالية ومقاييس بيع المنتجات الإضافية وما إلى ذلك، وسمات Merchant Center، مثل العلامة التجارية والفئة وما إلى ذلك، للمنتجات المحدّدة في خلاصة المخزون والتي تم بيعها نتيجةً لإعلانات Google. بالنسبة إلى عمليات الشراء المنسوبة إلى النقرات على "إعلانات Shopping"، يمكن عرض سمات كلّ من المنتجات التي تم النقر عليها والمنتجات المُباعة معًا. |
| الإحالة الناجحة | إحالة ناجحة |
| 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 | مورد عرض الجنس تمثّل هذه السمة عرض مقاييس أداء العميل مجمّعة حسب الجنس. يتم تجميع جميع الإحصاءات على مستوى المجموعة الإعلانية. ملاحظة: على الرغم من أنّه يمكنك تقسيم المقاييس حسب الفئة العمرية باستخدام age_range_view أو حسب الجنس باستخدام gender_view، لا تتيح Search Ads 360 API تقسيم المقاييس حسب الفئة العمرية والجنس في الوقت نفسه في طلب بحث واحد. لا تتيح Search Ads 360 API تحليل الأداء على مستوى كلا السمتَين معًا. |
| 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 | طريقة عرض الموقع الجغرافي للمستخدم يتضمّن "عرض الموقع الجغرافي للمستخدم" جميع المقاييس المجمّعة على مستوى البلد، صف واحد لكل بلد. ويعرِض هذا العمود مقاييس تتبُّع في الموقع الجغرافي الفعلي للمستخدم حسب الموقع الجغرافي المستهدَف أو غير المستهدَف. في حال استخدام حقول تقسيم أخرى، قد تحصل على أكثر من صف واحد لكل بلد. |
| زيارة | زيارة |
| webpage_view | عرض صفحة ويب |