تتمثل المكوّنات الأساسية لواجهة Search Ads 360 Reporting API في الموارد والخدمات. يمثّل المورد كيانًا في "إعلانات شبكة البحث 360" وأنت تستخدم خدمة لاسترداد كيانات "إعلانات شبكة البحث 360".
التدرّج الهرمي للكائنات
حساب "إعلانات شبكة البحث 360" هو تدرج هرمي للعناصر.
المورد ذو المستوى الأعلى للحساب هو العميل.
يحتوي كل حساب على حملة نشطة واحدة أو أكثر.
يحتوي كل
Campaignعلى مجموعة إعلانية واحدة أو أكثر تجمع إعلاناتك في مجموعات منطقية.تحتوي كل
AdGroupعلى واحد أو أكثر من إعلانات المجموعة الإعلانية.يمكنك إرفاق واحد أو أكثر من
AdGroupCriterionأوCampaignCriterionبمجموعة إعلانية أو حملة. تحدِّد المعايير كيفية عرض الإعلانات.- وتتوفّر العديد من أنواع المعايير، مثل الكلمات الرئيسية والفئات العمرية والمواقع الجغرافية. تؤثر المعايير المحددة على مستوى الحملة في جميع الموارد الأخرى ضمن الحملة. يمكنك أيضًا تحديد ميزانيات وتواريخ على مستوى الحملة بالكامل.
المراجِع
تمثّل الموارد العناصر في حسابك على "إعلانات شبكة البحث 360". وتشمل أمثلة
الموارد Customer وCampaign وAdGroup.
أرقام تعريف العناصر
يتم تحديد كل عنصر في "إعلانات شبكة البحث 360" من خلال رقم تعريفه. وتكون بعض أرقام التعريف فريدة على الصعيد العالمي، أي في جميع حسابات "إعلانات شبكة البحث 360"، في حين تكون أرقام تعريف أخرى فريدة فقط ضمن نطاق محدود.
| نطاق فريد لرقم تعريف العنصر | |
|---|---|
| معرِّف الميزانية | البلدان المتحدثة |
| معرّف الحملة | البلدان المتحدثة |
| معرف المجموعة الإعلانية | البلدان المتحدثة |
| الرقم التعريفي للإعلان | المجموعة الإعلانيةويختلف كل زوج من AdGroupId / AdId عن غيره من الأجهزة. |
| الرقم التعريفي لمعيار المجموعة الإعلانية | المجموعة الإعلانيةويختلف كل زوج من AdGroupId / CriterionId عن غيره من الأجهزة. |
| الرقم التعريفي لمعيار الحملة | الحملةويختلف كل زوج من CampaignId / CriterionId عن غيره من الأجهزة. |
| معلومات الإعلان الإضافية | الحملةويختلف كل زوج من CampaignId / AdExtensionId عن غيره من الأجهزة. |
| الرقم التعريفي للخلاصة | البلدان المتحدثة |
| الرقم التعريفي لعنصر الخلاصة | البلدان المتحدثة |
| الرقم التعريفي لسمة الخلاصة | الخلاصة |
| رقم تعريف تخطيط الخلاصة | البلدان المتحدثة |
| الرقم التعريفي للتصنيف | البلدان المتحدثة |
| رقم تعريف UserList | البلدان المتحدثة |
ويمكن أن تكون قواعد المعرّفات مفيدة عند تصميم مساحة تخزين محلية لعناصر "إعلانات شبكة البحث 360".
أنواع الكائنات
ويمكن استخدام بعض الكائنات لأنواع متعددة من الكيانات. في هذه الحالة، يحتوي الكائن على حقل type يصف محتواه. على سبيل المثال، يمكن أن تشير السمة AdGroupAd إلى إعلان نصي أو إعلان فندق أو إعلان محلي.
ويمكنك الوصول إلى قيمة النوع من خلال الحقل AdGroupAd.ad.type. ويتم عرض قيمتها في التعداد AdType.
أسماء الموارد
ويتم تعريف كل مورد بشكل فريد عن طريق سلسلة resource_name تربط المورد ومصدره الرئيسيَين في مسار.
تكون أسماء موارد الحملات، على سبيل المثال، على النحو التالي:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
تحتوي الحملة ذات رقم التعريف 987654 في حساب "إعلانات شبكة البحث 360" والتي تحتوي على الرقم التعريفي للعميل
1234567 على resource_name:
customers/1234567/campaigns/987654
الخدمات
تتيح لك الخدمات استرداد الكيانات والبيانات الوصفية في "إعلانات شبكة البحث 360". هناك ثلاثة أنواع من الخدمات:
- خدمة البحث
SearchAds360Serviceهي الخدمة الوحيدة والموحّدة لاسترداد جميع عناصر الموارد وإحصاءات الأداء. وهي توفّر طريقتَين:SearchوSearchStream. تتطلب كلتا الطريقتين استعلامًا يحدد المورد الذي سيتم الاستعلام عنه، وسمات الموارد ومقاييس الأداء المطلوب استردادها، والمراجع المستخدمة في تصفية الطلب، والمقاطع المستخدمة لتقسيم إحصاءات الأداء بشكلٍ أكبر. ويمكنك الاطّلاع على إنشاء تقارير البحث ولغة طلب البحث في "إعلانات شبكة البحث 360" للحصول على مزيد من المعلومات.- الخدمة الميدانية
- تسترد
SearchAds360FieldServiceالبيانات الوصفية حول الموارد، مثل السمات المتاحة لمورد ونوع بياناته. يمكنك طلب كتالوج الموارد وحقول الموارد ومفاتيح التقسيم والمقاييس المتاحة في طرق البحثSearchAds360Service. يُرجى الاطّلاع على استرداد البيانات الوصفية للموارد لمعرفة المزيد من المعلومات. - الخدمات الخاصة بالكيانات
توفّر هذه الخدمات طريقة طلب
GETتسترد مثيلاً واحدًا للموارد. وهذا مفيد لفحص بنية المورد.تتضمن أمثلة الخدمات الخاصة بالكيان ما يلي:
- CustomColumnService التي تعرض العمود المخصّص المطلوب بالتفاصيل الكاملة.