المكونات الأساسية لواجهة 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 فريد على مستوى العالم. |
| الرقم التعريفي للخلاصة | عالمي |
| الرقم التعريفي لعنصر الخلاصة | عالمي |
| رقم تعريف سمة الخلاصة | الخلاصة |
| الرقم التعريفي لتخطيط الخلاصة | عالمي |
| الرقم التعريفي للتصنيف | عالمي |
| رقم تعريف قائمة المستخدمين | عالمي |
يمكن أن تكون قواعد الأرقام التعريفية هذه مفيدة عند تصميم مساحة تخزين محلية لعناصر "إعلانات شبكة البحث 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 التي تعرض العمود المخصّص المطلوب بالكامل بالتفصيل