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

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