تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

تعيينات الوحدات الإعلانية

عمليات ربط الوحدات الإعلانية هي إعدادات ضبط تابعة لجهات خارجية يتم ربطها بوحدة إعلانية في AdMob وتتيح لها تقديم طلب عرض الإعلان إلى شبكة إعلانات تابعة لجهة خارجية.

عند إنشاء مجموعة توسّط، يتم استخدام عمليات ربط الوحدات الإعلانية كمَعلمة لكل سطر في مجموعة التوسّط كإعدادات للوحدة الإعلانية المحدّدة لتقديم طلبات إلى شبكة إعلانية تابعة لجهة خارجية. على عكس واجهة مستخدم AdMob، يجب إنشاء عمليات ربط الوحدات الإعلانية بشكل مستقل خارج مجموعات التوسّط وعناصر مجموعات التوسّط. بعد الإنشاء، يمكنك إدراج جميع عمليات ربط الوحدات الإعلانية واستخدامها كمَعلمة عند إنشاء أو تعديل بنود مجموعة التوسّط باستخدام عمليات ربط جديدة للوحدات الإعلانية.

أمثلة

بعد إنشاء بيانات اعتماد OAuth 2.0، تكون مستعدًا لبدء استخدام AdMob API. لطلب الدخول باستخدام بروتوكول OAuth 2.0، يحتاج التطبيق أيضًا إلى معلومات عن النطاق.

في ما يلي معلومات عن نطاق OAuth 2.0:

النطاق	المعنى
`https://www.googleapis.com/auth/admob.monetization`	الاطّلاع على إعدادات تحقيق الربح المادي في AdMob وإنشاؤها وتعديلها
`https://www.googleapis.com/auth/admob.readonly`	الاطّلاع على جميع بيانات AdMob وقد يشمل ذلك معلومات الحساب وإعدادات المستودع الإعلاني والتوسّط والتقارير والبيانات الأخرى. ولا يتضمّن ذلك البيانات الحسّاسة، مثل الدفعات أو تفاصيل الحملة.

ابدأ بإنشاء عملية ربط الوحدة الإعلانية الأولى باتّباع الخطوات التالية:

curl (سطر الأوامر)

الطلبات التي تستخدم curl

حمِّل ملف أسرار العميل وأنشئ بيانات اعتماد التفويض.

في المرة الأولى التي تنفّذ فيها هذه الخطوة، سيُطلب منك قبول طلب تفويض في المتصفّح. قبل قبول الدعوة، تأكَّد من تسجيل الدخول باستخدام حساب Google لديه إذن الوصول إلى AdMob API. سيتم منح تطبيقك الإذن بالوصول إلى البيانات نيابةً عن أي حساب تم تسجيل الدخول إليه حاليًا.

للمصادقة والتفويض، ننصحك باستخدام oauth2l، وهي أداة بسيطة لسطر الأوامر تتيح استخدام بروتوكول Google OAuth 2.0. ثبِّت oauth2l ونفِّذ الأمر أدناه، مع استبدال path_to_credentials_json بمسار إلى ملف credentials.json تنزّله عند تسجيل تطبيقك على السحابة الإلكترونية. في المرة الأولى التي يتم فيها تنفيذ الأمر، سيوجّهك خلال عملية منح إذن OAuth 2.0. وفي عمليات التشغيل اللاحقة، يتم تجديد الرمز المميز تلقائيًا.
```
oauth2l header --json path_to_credentials_json --scope admob.readonly,admob.monetization
```

عرض قائمة بمصادر الإعلانات

يمكنك الحصول على معلومات مصدر الإعلان في AdMob من خلال استبدال pub-XXXXXXXXXXXXXXXX برقم تعريف الناشر. اطّلِع على التعليمات حول كيفية العثور على الرقم التعريفي للناشر.

curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

نموذج إجابة:

{
 "adSources": [
   {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855",
     "adSourceId": "5450213213286189855",
     "title": "AdMob Network",
   }
 ]
}

أدرِج المحوّلات.

استبدِل SSSSSSSSSSSSSSSSSSSS بمعرّف مصدر الإعلان للمحوّلات التي تهمّك.

استخدِم الأمر التالي للحصول على قائمة بالمحوّلات:

curl --http1.0 -X GET https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adSources/SSSSSSSSSSSSSSSSSSSS/adapters \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

نموذج ردّ لمصدر الإعلان في "شبكة AdMob" مع رقم التعريف 5450213213286189855:

{
 "adapters": [
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/1",
     "adapterId": "1",
     "title": "AdMob Network Android SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "118",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  },
  {
     "name": "accounts/pub-XXXXXXXXXXXXXXXX/adSources/5450213213286189855/adapters/2",
     "adapterId": "2",
     "title": "AdMob Network iOS SDK",
     "platform": "ANDROID",
     "formats": ["BANNER", "INTERSTITIAL",
       "REWARDED", "NATIVE", "REWARDED_INTERSTITIAL", "APP_OPEN"],
     "adapterConfigMetadata": [{
       "adapterConfigMetadataId": "119",
       "adapterConfigMetadataLabel": "Ad unit ID"
     }]
  }]
}

إنشاء عملية ربط لوحدة إعلانية

استبدِل YYYYYYYYYY بجزء رقم تعريف وحدتك الإعلانية. مقتطف رقم تعريف الوحدة الإعلانية هو آخر 10 أرقام من رقم تعريف الوحدة الإعلانية الذي يتبع التنسيق "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". اطّلِع على التعليمات حول العثور على رقم تعريف الوحدة الإعلانية.
```
curl --http1.0 -X POST \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)" \
 -H "Content-Type: application/json" --data @- << EOF
{
   "name": "InMobi ad unit mapping",
   "adapterId": "8",
   "adUnitConfigurations": {
     "174": "inMobiAccountId",
     "176": "inMobiPlacementId"
   }
}
EOF
```

تعرِض هذه السمة جميع عمليات ربط الوحدات الإعلانية.

استبدِل YYYYYYYYYY بجزء رقم تعريف وحدتك الإعلانية. مقتطف رقم تعريف الوحدة الإعلانية هو آخر 10 أرقام من رقم تعريف الوحدة الإعلانية بالتنسيق "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY". اطّلِع على التعليمات حول العثور على رقم تعريف الوحدة الإعلانية.

 curl --http1.0 -X GET \
 https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings \
 -H "$(oauth2l header --json path_to_credentials_json --scope admob.readonly)"

{
 "adUnitMappingName":
 "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/ZZZZZZZZZZ"
   {
     "adapterId": "1",
     "state": "ENABLED",
     "adUnitConfigurations": {
       "adUnitMappingConfigurationKey": "adUnitId",
       "adUnitMappingConfigurationValue": "118",
     }
   }
}

تعيينات الوحدات الإعلانية تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

أمثلة

curl (سطر الأوامر)

الطلبات التي تستخدم curl

تعيينات الوحدات الإعلانية