مجموعات التوسط

تتيح لك واجهة برمجة تطبيقات AdMob إنشاء مجموعات توسّط وإدراجها وتعديلها، بما في ذلك:

• تحديد استهداف مجموعة التوسط بما في ذلك استهداف المناطق وأشكال الإعلانات والمنصّات ومعرّف المعلِنين (IDFA)
• إضافة خطوط جديدة لمجموعة التوسط إلى مجموعة توسّط حالية
• الاطّلاع على مجموعات التوسّط التي تشكّل جزءًا من تجربة أ/ب للتوسّط وما تنتمي أسطر مجموعة التوسّط إلى كل صيغة: A أو B

أمثلة

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

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

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

إنشاء

لإنشاء مجموعة توسّط، عليك تحديد استهداف مجموعة التوسّط. المعلومات، بما في ذلك الوحدات الإعلانية ذات الصلة ينشئ المثال التالي مخططًا جديدًا مجموعة التوسط لإعلانات Android البينية لوحدتين إعلانيتين. مجموعة توسّط واحدة تتمّ إضافة سطر عند إنشاء مصدر إعلان InMobi لا تحتاج إلى تضمين شبكة AdMob لأنّه ستتم إضافتها تلقائيًا في وقت الإنشاء.

في مقتطف الرمز أدناه، استبدِل pub-XXXXXXXXXXXXXXXX بـ الناشر. المعرّف

بعد ذلك، استبدِل YYYYYYYYYY بآخر 10 أرقام من وحدتك الإعلانية. رقم التعريف: يلتزم إلى التنسيق:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY

نظرًا لوجود وحدتين إعلانيتين في هذا المثال، تشير YYYYY11111 إلى الإعلان الأول. وWWWWW11111 إلى ربط الوحدة الإعلانية الأولى. YYYYY22222 و يشير العمود WWWWW22222 إلى الوحدة الإعلانية الثانية وربط الوحدة الإعلانية.

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

استبدل WWWWWWWWWW برقم تعريف تعيين الوحدة الإعلانية. رقم تعريف ربط الوحدة الإعلانية باستخدام accounts.adUnits.adUnitMappings.list .

 curl --http1.0 -X POST https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
  "displayName": "Test Mediation Group"
  "targeting": {
    "platform": "ANDROID",
    "format": "INTERSTITIAL"
    "adUnitIds":["ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111", "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222"}
  }
  "mediationGroupLines": {
    "-1": {
      "displayName": "test line",
      "adSourceId": "7681903010231960328",
      "cpmMode": "MANUAL",
      "cpmMicros": "150000",
      "state": "ENABLED",
      "adUnitMappings": {
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
        "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
      }
  }
}

قائمة

استبدل pub-XXXXXXXXXXXXXXXX بـ الناشر ID للاطّلاع على مجموعات التوسط.

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

نموذج طلب:

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

نموذج الرد:

{
"mediationGroups": [
  {
    "name": "accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ",
    "mediationGroupId": "ZZZZZZZZZZ",
    "displayName": "Test Mediation Group",
    "state": "ENABLED",
    "state": "NOT_RUNNING",
    "targeting": {
      "platform": "iOS",
      "format": "BANNER",
      "targetedRegionCodes": "[CA]",
      "adUnits": ["YYYYY11111", "YYYYY22222"]
    },
    "mediationGroupLines": {
      "11111111111111111": {
        "id": "11111111111111111",
        "displayName": "AdMob Network",
        "adSourceId": "5450213213286189855",
        "cpmMode": "LIVE",
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      },
      "22222222222222222": {
        "id": "22222222222222222",
        "displayName": "test line",
        "adSourceId": "7681903010231960328",
        "cpmMode": "MANUAL",
        "cpmMicros": "150000",
        "adUnitMappings": {
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY11111": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY11111/adUnitMappings/WWWWW11111",
          "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYY22222": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYY22222/adUnitMappings/WWWWW22222"
        },
        "state": "ENABLED",
        "experimentVariant": "ORIGINAL"
      }
    },
  }]
}

التصحيح

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

يمكن استخدام أقنعة الحقول التالية لتعديلات مجموعة التوسّط:

• targeting.adUnitIds
• mediationGroupLines[mediationGroupLineId]
• mediationGroupLines[mediationGroupLineId].state
• mediationGroupLines[mediationGroupLineId].adUnitMappings[adUnitId]

لتحديث مجموعة توسط من خلال إضافة سطر جديد لمجموعة التوسط، يمكنك استخدام علامة رقم سالب لـ mediationGroupLineId. لتعديل التوسّط الحالي تشير إلى معرّف سطر مجموعة التوسط في كل من update_mask كما هو موضح أدناه.

"updateMask" {
    paths: "mediation_group_lines["123"].ad_unit_mappings["456"]"
}

"mediationGroup" {
  "mediationGroupLines": {
   "123": {
     "id": "123"
     "adUnitMappings": {
      "456": "newAdUnitMappingId"
     }
    }
  }
}

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

يضيف المثال التالي 3 خطوط توسّط جديدة إلى مجموعة توسّط حالية. تحتوي updateMask على أسطر مجموعة التوسط الثلاثة مع عناصر سلبية مختلفة. كعنصر نائب:

updateMask=mediationGroupLines["-1"],mediationGroupLines["-2"],mediationGroupLines["-3"]

تحتاج إلى ترجمة رموز خاصة لأن جميع عناوين URL يجب أن تتوافق مع بناء الجملة المحدد من خلال مواصفات معرف الموارد المنتظم (URI)، بالتالي تصبح قيمة updateMask:

updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D

لتنفيذ المثال التالي، استبدِل pub-XXXXXXXXXXXXXXXX بـ الرقم التعريفي للناشر وZZZZZZZZZZ مع رقم تعريف مجموعة التوسط. التوسّط يمكن العثور على رقم تعريف المجموعة في واجهة مستخدم AdMob أو باستخدام accounts.mediationGroups:list .

استبدِل YYYYYYYYYY بآخر 10 أرقام من وحدتك الإعلانية. المعرّف، بالتنسيق:

ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY`

استبدل WWWWWWWWWW برقم تعريف تعيين الوحدة الإعلانية. رقم تعريف ربط الوحدة الإعلانية باستخدام accounts.adUnits.adUnitMappings.list .

curl --http1.0 -X PATCH https://admob.googleapis.com/v1beta/accounts/pub-XXXXXXXXXXXXXXXX/mediationGroups/ZZZZZZZZZZ?
updateMask=mediationGroupLines%5B%22-1%22%5D,mediationGroupLines%5B%22-2%22%5D,mediationGroupLines%5B%22-3%22%5D
-H "Content-Type:application/json"
-H "$(oauth2l header --json path_to_credentials_json --scope admob.monetization)"
--data @- << EOF
{
"mediationGroupLines": {
  "-1": {
    "displayName": "test line 2",
    "adSourceId": "7681903010231960458",
    "cpmMode": "MANUAL",
    "cpmMicros": "150000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-2": {
    "displayName": "test line 3",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "120000",
    "state": "ENABLED",
    "adUnitMappings": {
      "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
},
"-3": {
    "displayName": "test line 4",
    "adSourceId": "7681903010231960328",
    "cpmMode": "MANUAL",
    "cpmMicros": "130000",
    "state": "ENABLED",
    "adUnitMappings": {
     "ca-app-pub-XXXXXXXXXXXXXXXX/YYYYYYYYYY": "accounts/pub-XXXXXXXXXXXXXXXX/adUnits/YYYYYYYYYY/adUnitMappings/WWWWWWWWWW"
    }
  }
}
}
EOF