العنصران الأساسيان في Search Ads 360 Reporting API هما المراجع والخدمات. يمثّل المرجع كيانًا في "إعلانات شبكة البحث 360"، وتستخدِم خدمة لاسترداد كيانات "إعلانات شبكة البحث 360".
التسلسل الهرمي للعناصر
حساب "إعلانات شبكة البحث 360" هو تدرّج هرمي للكائنات.
المورد الأعلى مستوى في الحساب هو العميل.
يحتوي كل حساب على حملة نشطة واحدة أو أكثر.
تحتوي كل
Campaignعلى مجموعة إعلانية واحدة أو أكثر مجموعات إعلانية تجمع إعلاناتك في مجموعات منطقية.تحتوي كل
AdGroupعلى إعلان مجموعة إعلانية واحد أو أكثر.يمكنك إرفاق
AdGroupCriterionأوCampaignCriterionواحد أو أكثر بمجموعة إعلانية أو حملة. تحدّد المعايير كيفية عرض الإعلانات.- هناك العديد من أنواع معايير الاستهداف، مثل الكلمات الرئيسية والفئات العمرية والمواقع الجغرافية. تؤثّر المعايير المحدّدة على مستوى الحملة في جميع المراجع الأخرى ضِمن الحملة. يمكنك أيضًا تحديد ميزانيات وتواريخ على مستوى الحملة.
الموارد
تمثّل المراجع الكيانات في حسابك على "إعلانات شبكة البحث 360". تشمل المراجع
الأمثلة Customer وCampaign وAdGroup.
معرّفات العناصر
يتم تحديد كل عنصر في "إعلانات شبكة البحث 360" من خلال رقم تعريفه الخاص. بعض المعرّفات فريدة على مستوى العالم، أي في جميع حسابات "إعلانات شبكة البحث 360"، بينما تكون المعرّفات الأخرى فريدة ضمن نطاق محدود فقط.
| نطاق تفرد رقم تعريف العنصر | |
|---|---|
| معرِّف الميزانية | جميع أنحاء العالم |
| الرقم التعريفي للحملة | جميع أنحاء العالم |
| معرف المجموعة الإعلانية | جميع أنحاء العالم |
| معرّف الإعلان | المجموعة الإعلانيةكل زوج AdGroupId / AdId
فريد على مستوى العالم. |
| رقم تعريف معيار المجموعة الإعلانية | المجموعة الإعلانيةيجب أن يكون كل زوج AdGroupId /
CriterionId فريدًا على مستوى العالم. |
| رقم تعريف CampaignCriterion | الحملةيجب أن يكون كل زوج 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 الذي يعرض العمود المخصّص المطلوب بتفاصيله الكاملة.