שילוב myTarget עם תהליך בחירת הרשת (Mediation)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-myTarget באמצעות גישור, כולל שילובים של שיטת ה-Waterfall. במדריך מוסבר איך להוסיף את myTarget להגדרת הגישור של יחידת מודעות, ואיך לשלב את myTarget SDK ואת המתאם באפליקציית Flutter.

שילובים נתמכים ופורמטים נתמכים של מודעות

שילוב
בידינג
מפל
פורמטים
מודעת באנר
מעברון
ההטבה הופעלה
מודעות מעברון מתגמלות
מותאם

דרישות

  • הגרסה העדכנית של Google Mobile Ads SDK
  • ‫Flutter 3.7.0 ומעלה
  • כדי לפרוס ב-Android
    • רמת API ‏23 ואילך ב-Android
  • כדי לפרוס ב-iOS
    • יעד הפריסה של iOS הוא 12.0 ומעלה
  • פרויקט Flutter פעיל שמוגדר עם Google Mobile Ads SDK. פרטים נוספים זמינים במאמר תחילת העבודה עם Service Management API.
  • קוראים את המדריך לתחילת העבודה בנושא גישור.

שלב 1: הגדרת תצורות בממשק המשתמש של myTarget

מתחברים לחשבון myTarget. כדי לעבור לדף האפליקציות, לוחצים על אפליקציות בכותרת. לוחצים על הוספת אפליקציה כדי להוסיף את האפליקציה.

אם האפליקציה תומכת בפלטפורמות Android ו-iOS, צריך להגדיר כל אחת מהן בנפרד.

Android

לאחר מכן, מציינים את כתובת ה-URL של האפליקציה ב-Google Play.

iOS

לאחר מכן, מציינים את כתובת ה-URL של האפליקציה ב-iTunes**.

כשמוסיפים אפליקציה, מערכת myTarget דורשת ליצור יחידת מודעות לפני שניתן להשלים את התהליך.

בוחרים באפשרות באנר מתוך פורמטי המודעות הזמינים, ואז לוחצים על הלחצן הוספת יחידת מודעות.

מעברון

בוחרים באפשרות INTERSTITIAL מתוך פורמטי המודעות הזמינים, ואז לוחצים על הלחצן ADD AD UNIT (הוספה של יחידת מודעות).

ההטבה הופעלה

בוחרים באפשרות סרטון מתגמל מתוך פורמטי המודעות הזמינים, ואז לוחצים על הלחצן הוספת יחידת מודעות.

מותאם

בוחרים באפשרות NATIVE מתוך פורמטי המודעות הזמינים, ואז לוחצים על הוספה של יחידת מודעות.

בדף הפרטים של יחידת המודעות, רושמים את מזהה מיקום המודעה שמופיע בהגדרות של יחידת המודעות בתור slot_id. מזהה מיקום המודעה הזה ישמש להגדרת יחידת המודעות ב-AdMob בקטע הבא.

בנוסף ל-slot_id, תצטרכו גם את Permanent Access Token של myTarget כדי להגדיר את המזהה של יחידת המודעות ב-AdMob. עוברים לכרטיסייה פרופיל ובוחרים באפשרות Access Tokens (אסימוני גישה). לוחצים על Create Token (יצירת אסימון) או על Show Token (הצגת אסימון) כדי לראות את אסימון הגישה הקבוע שלכם ב-myTarget.

עדכון של קובץ app-ads.txt

Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt. אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.

כדי להטמיע את app-ads.txt ב-myTarget, אפשר לעיין במאמר איך יוצרים ומפרסמים קובץ.

הפעלת מצב בדיקה

כדי להוסיף ולהגדיר מכשיר בדיקה בממשק המשתמש של myTarget, פועלים לפי ההוראות בתיעוד של myTarget.

שלב 2: הגדרת הביקוש של myTarget בממשק המשתמש של AdMob

הגדרת הגדרות הגישור ליחידת המודעות

Android

הוראות מפורטות מופיעות בשלב 2 במדריך ל-Android.

iOS

הוראות מפורטות מופיעות בשלב 2 במדריך ל-iOS.

הוספת Mail.ru לרשימת שותפי הפרסום שמספקים שירותים שקשורים ל-GDPR ולתקנות במדינות בארה"ב

כדי להוסיף את Mail.ru לרשימת שותפי הפרסום בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב בממשק המשתמש של AdMob, צריך לפעול לפי השלבים שמפורטים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

שלב 3: מייבאים את ה-SDK ואת המתאם של myTarget

שילוב דרך pub.dev

מוסיפים את התלות הבאה עם הגרסאות העדכניות של ה-SDK והמתאם של myTarget בקובץ pubspec.yaml של החבילה:

dependencies:
  gma_mediation_mytarget: ^

שילוב ידני

מורידים את הגרסה העדכנית של פלאגין הגישור של Google Mobile Ads ל-myTarget, מחלצים את הקובץ שהורדתם ומוסיפים את תיקיית הפלאגין שחולצה (ואת התוכן שלה) לפרויקט Flutter. לאחר מכן, מוסיפים את התלות הבאה לקובץ pubspec.yaml כדי להפנות אל הפלאגין:

dependencies:
  gma_mediation_mytarget:
    path: path/to/local/package

שלב 4: הטמעה של הגדרות פרטיות ב-myTarget SDK

הוראות מפורטות זמינות בשלב 4 במדריך ל-Android ול-iOS.

שלב 5: מוסיפים את הקוד הנדרש

Android

לא נדרש קוד נוסף לשילוב עם myTarget.

iOS

שילוב של SKAdNetwork

פועלים לפי התיעוד של myTarget כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.

שלב 6: בדיקת ההטמעה

הפעלת מודעות בדיקה

חשוב לרשום את מכשיר הבדיקה ב-AdMob ולהפעיל את מצב הבדיקה בממשק המשתמש של myTarget.

אימות מודעות בדיקה

כדי לוודא שאתם מקבלים מודעות בדיקה מ-myTarget, אתם צריכים להפעיל בדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות myTarget (Waterfall).

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-myTarget, בעלי תוכן דיגיטלי יכולים לבדוק את השגיאה הבסיסית בתגובה למודעה באמצעות ResponseInfo במחלקות הבאות:

Android

com.google.ads.mediation.mytarget.MyTargetAdapter
com.google.ads.mediation.mytarget.MyTargetNativeAdapter
com.google.ads.mediation.mytarget.MyTargetRewardedAdapter

iOS

GADMAdapterMyTarget
GADMediationAdapterMyTargetNative
GADMediationAdapterMyTargetRewarded

אלה הקודים וההודעות הנלוות שמוצגים על ידי המתאם של myTarget כשלא ניתן לטעון מודעה:

Android

קוד שגיאה סיבה
100 ה-SDK של myTarget החזיר שגיאה.
101 הפרמטרים של השרת myTarget שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
102 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-myTarget.
103 הבקשה להצגת מודעה היא לא בקשה מאוחדת להצגת מודעה מותאמת.
104 המודעה המותאמת שנטענה מ-myTarget שונה מהמודעה המותאמת המבוקשת.
105 במודעה המותאמת שהוטענה מ-myTarget חסרים נכסים נדרשים (למשל תמונה או סמל).

iOS

קוד שגיאה סיבה
100 עדיין אין מודעה זמינה ב-myTarget SDK.
101 הפרמטרים של השרת myTarget שהוגדרו בממשק המשתמש של AdMob חסרים או לא תקינים.
102 המתאם של myTarget לא תומך בפורמט המודעה המבוקש.
103 ניסיון להציג מודעה ב-myTarget שלא נטענה.
104 גודל המודעה המבוקש לא תואם לגודל באנר נתמך ב-myTarget.
105 חסרים נכסים נדרשים של מודעות מותאמות.

יומן השינויים של מתאם הגישור myTarget Flutter

גרסה 1.4.0

גרסה 1.3.0

גרסה 1.2.0

גרסה 1.1.0

גרסה 1.0.0