‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

טוענים את קובץ הסודות של הלקוח ויוצרים פרטי הרשאה.

בפעם הראשונה שמבצעים את השלב הזה, מופיעה בקשה לאישור בדפדפן. לפני שמאשרים, צריך לוודא שאתם מחוברים לחשבון 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
```

מציגים רשימה של מקורות מודעות.

כדי לקבל מידע על מקורות מודעות ב-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",
   }
 ]
}

מציינים את המתאמים.

מחליפים את 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"
     }]
  }]
}

יוצרים מיפוי של יחידת המודעות.

מחליפים את 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

רשימה של כל המיפויים של יחידות המודעות.

מחליפים את 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",
     }
   }
}

מיפויים של יחידות מודעות קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

דוגמאות

‫curl (שורת פקודה)

בקשות באמצעות curl

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