מיפויים של יחידות מודעות

מיפויים של יחידות מודעות הם הגדרות תצורה של צד שלישי שממופות ליחידת מודעות ב-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. בין היתר, ייקראו נתונים כמו פרטי החשבון, ההגדרות של מלאי שטחי הפרסום ושל תהליך בחירת הרשת (Mediation), דוחות ועוד. לא ייקרא מידע אישי רגיש כמו פרטי תשלומים או פרטי קמפיינים.

כך מתחילים ליצור את מיפוי יחידות המודעות הראשון:

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",
        }
      }
   }