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

מיפוי של יחידות מודעות הוא הגדרות של צד שלישי שממפות ליחידת מודעות ב-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",
        }
      }
   }