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

عمليات ربط الوحدات الإعلانية هي إعدادات ضبط تابعة لجهات خارجية يتم ربطها بوحدة إعلانية في 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

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

   عند تنفيذ هذه الخطوة لأول مرة، سيُطلب منك قبول طلب تفويض في المتصفّح. قبل قبول الدعوة، تأكَّد من تسجيل الدخول باستخدام حساب 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
   

2. أدرِج مصادر الإعلانات.

   يمكنك الحصول على معلومات مصدر إعلان 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",
      }
    ]
   }

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

   استبدِل 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"
        }]
     }]
   }

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

   استبدِل 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
   

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

   استبدِل 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",
        }
      }
   }