שילוב של BidMachine עם Mediation

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK (Legacy) כדי לטעון ולהציג מודעות מ-BidMachine באמצעות תהליך בחירה של רשת מודעות (Mediation). המדריך כולל הסברים על שילובים של בידינג. המאמר מסביר איך להוסיף את BidMachine להגדרה של תהליך בחירת הרשת של יחידת מודעות, ואיך לשלב את ה-SDK והמתאם של BidMachine באפליקציית Android.

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

מתאם תהליך בחירת הרשת של BidMachine כולל את היכולות הבאות:

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

1 שילוב Waterfall נמצא בגרסת בטא סגורה. כדי לבקש גישה, צריך לפנות למנהל החשבון.

דרישות מוקדמות

לפני שממשיכים, חשוב לוודא את הפרטים הבאים:

  • רמת API ב-Android‏ 24 ואילך.

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

מתחברים למרכז הבקרה של חשבון BidMachine.

יצירת מיקומי מודעות חדשים

עוברים לכרטיסייה מקור ובטבלה מקורות לוחצים על הלחצן עריכה.

לוח הבקרה של המקורות

תוצג רשימה של כל מיקומי המודעות שיש לכם. כדי ליצור מיקום מודעה חדש, לוחצים על הלחצן Add Placement (הוספת מיקום מודעה) בתיבת הדו-שיח.

תיבת הדו-שיח 'עריכת המקור'

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

יצירת מיקום מודעה

לבסוף, רושמים את מזהה מיקום המודעה.

פרטי מיקום

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

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

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

שלב 2: הגדרת הביקוש של BidMachine בממשק המשתמש של Ad Manager

נכנסים לחשבון Ad Manager.

הוספת BidMachine בקטע Companies (חברות)

בידינג

השלב הזה לא נדרש לשילובים של בידינג.

Waterfall

עוברים אל Admin > Companies ולוחצים על הכפתור New company בכרטיסייה All companies. בוחרים באפשרות רשת מודעות.

בוחרים באפשרות BidMachine בתור רשת המודעות, מזינים שם ייחודי ומפעילים את האפשרות Mediation (תהליך בחירת הרשת).

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

הפעלת שיתוף אותות מאובטחים

בידינג

עוברים אל Admin > Global settings. עוברים לכרטיסייה הגדרות החשבון ב-Ad Exchange, בודקים את ההגדרה שיתוף אותות מאובטח ומפעילים אותה. לוחצים על שמירה.

Waterfall

השלב הזה לא נדרש לשילובים של שיטת ה-Waterfall.

שיתוף אותות מאובטחים בבקשות להצעות מחיר

בידינג

עוברים אל Inventory > Secure Signals. בקטע אותות מאובטחים, מחפשים את BidMachine ומפעילים את המתג הפעלת שילוב אפליקציות.

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

Waterfall

השלב הזה לא נדרש לשילובים של שיטת ה-Waterfall.

איך מאפשרים שיתוף אותות מאובטחים בבידינג מבוסס SDK חיצוני

בידינג

עוברים אל Delivery (הצגת מודעות) > Demand channel settings (ההגדרות של ערוץ הביקוש). בכרטיסייה הגדרות ברירת המחדל, מפעילים את האפשרות שיתוף אותות מאובטחים עבור SDK Bidding.

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

Waterfall

השלב הזה לא נדרש לשילובים של שיטת ה-Waterfall.

הגדרת בידינג ב-BidMachine

בידינג

עוברים אל הצגת מודעות > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

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

בוחרים באפשרות BidMachine כמגיש הצעות המחיר.

לוחצים על המשך כדי להפעיל בידינג מבוסס SDK חיצוני עבור מגיש הצעות המחיר הזה.

לוחצים על סיום.

Waterfall

השלב הזה לא נדרש לשילובים של שיטת ה-Waterfall.

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

בידינג

עוברים אל הצגת מודעות > מגישי הצעות מחיר ולוחצים על מעבר לבידינג מבוסס SDK חיצוני.

בוחרים את החברה של BidMachine.

עוברים לכרטיסייה מיפוי יחידות של מודעות ולוחצים על מיפוי חדש של יחידת מודעות.

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

לבסוף, לוחצים על שמירה.

מפל

עוברים אל Delivery > Yield groups ולוחצים על הכפתור New yield group. בוחרים את המלאי ואת האפליקציה.

גוללים אל Yield partners (שותפים להגדלת נפח התנועה) ולוחצים על Add mediation partner (הוספת שותף בתהליך בחירת הרשת).

בוחרים את החברה שיצרתם עבור BidMachine בקטע הקודם. בוחרים באפשרות Mobile SDK mediation בתור סוג השילוב, באפשרות Android בתור פלטפורמה ובאפשרות פעיל בתור סטטוס.

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

הוספת BidMachine לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב

כדי להוסיף את BidMachine לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב בממשק המשתמש של Ad Manager, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

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

בקובץ settings.gradle (או settings.gradle.kts) ברמת הפרויקט, מוסיפים את המאגרים הבאים:

dependencyResolutionManagement {
  repositories {
    google()
    mavenCentral()
    maven {
      url = uri("https://artifactory.bidmachine.io/bidmachine")
    }
  }
}

בקובץ gradle ברמת האפליקציה, מוסיפים את יחסי התלות הבאים של ההטמעה:

Kotlin

dependencies {
    implementation("com.google.android.gms:play-services-ads:25.5.0")
    implementation("com.google.ads.mediation:bidmachine:3.8.0.1")
}

Groovy

dependencies {
    implementation 'com.google.android.gms:play-services-ads:25.5.0'
    implementation 'com.google.ads.mediation:bidmachine:3.8.0.1'
}

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

כדי לפעול בהתאם למדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, אתם צריכים לספק גילוי נאות מסוים למשתמשים באזור הכלכלי האירופי (EEA), בבריטניה ובשוויץ, ולקבל את הסכמתם לשימוש בקובצי Cookie או באמצעי אחסון מקומיים אחרים במקרים שבהם נדרשת הסכמה על פי חוק, וכן לאיסוף, לשיתוף ולשימוש במידע אישי לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת.

המערכת של BidMachine קוראת באופן אוטומטי את ההסכמה בהתאם ל-GDPR שהוגדרה בפלטפורמות לניהול הסכמה, כולל UMP SDK. מידע נוסף זמין במאמר בנושא GDPR.

דיני פרטיות במדינות בארה"ב

דיני הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהמונחים האלה מוגדרים בחוק). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אין למכור את המידע האישי שלי". במדריך בנושא עמידה בדרישות של דיני הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל בהצגת מודעות של Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת בחירת הרשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.

‫BidMachine קורא באופן אוטומטי את ההסכמה שמוגדרת על ידי GPP בפלטפורמות לניהול הסכמה, כולל UMP SDK. מידע נוסף זמין במאמר בנושא GPP.

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

לא צריך להוסיף קוד כדי לשלב את BidMachine.

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

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

חשוב לוודא שרשמתם את מכשיר הבדיקה ב-Ad Manager.

כדי להפעיל את מצב הבדיקה של BidMachine, פועלים לפי ההוראות במסמכי התיעוד של BidMachine בנושא Android.

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

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

שלבים אופציונליים

מודעות מותאמות

רינדור מודעות

המתאם של BidMachine מחזיר את המודעות המותאמות שלו כאובייקטים של NativeAd. הוא מאכלס את השדות הבאים של NativeAd.

שדה נכסים שתמיד נכללים על ידי מתאם BidMachine
כותרת
תמונה
גוף
סמל
קריאה לפעולה
דירוג כוכבים
חנות
מחיר
מפרסם

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-BidMachine, אפשר לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות ResponseInfo.getAdapterResponses() במחלקות הבאות:

io.bidmachine
com.google.ads.mediation.bidmachine

אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של BidMachine כשהטעינה של מודעה נכשלת:

קוד שגיאה דומיין סיבה
100 com.google.ads.mediation.bidmachine התקבל מזהה מיקום ריק או לא תקין.
101 com.google.ads.mediation.bidmachine שגיאה במהלך איסוף האותות: לא נמצאה הגדרה של נתוני אותות.
102 com.google.ads.mediation.bidmachine התקבל פורמט מודעה לא תקין במהלך איסוף האותות.
103 com.google.ads.mediation.bidmachine לא ניתן למפות את גודל המודעה המבוקש אל bidmachine.BannerSize
104 com.google.ads.mediation.bidmachine פג התוקף של בקשה להצגת מודעה ב-BidMachine שנשלחה לאחר טעינה.
105 com.google.ads.mediation.bidmachine לא הייתה אפשרות להציג את המודעה במסך מלא.
106 com.google.ads.mediation.bidmachine ‫BidMachine SDK החזיר קריאה חוזרת (callback) של onAdLoaded() עם נתוני מודעה של null.

יומן השינויים של מתאם מנגנון בחירת הרשת BidMachine ל-Android

גרסה 3.8.0.1

  • מצמידים את התלות של המתאם ב-Kotlin לגרסה 1.9.0 (גרסת ה-Kotlin המינימלית שנתמכת על ידי GMA NextGen SDK).

נבנה ונבדק באמצעות:

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
  • גרסה 3.8.0 של BidMachine SDK.

גרסה 3.8.0.0

  • תאימות מאומתת לגרסה 3.8.0 של BidMachine SDK.

נבנה ונבדק באמצעות:

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
  • גרסה 3.8.0 של BidMachine SDK.

גרסה 3.7.1.1

  • ‫Maps AgeRestrictedTreatment אל COPPA API של BidMachine.

נבנה ונבדק באמצעות:

  • גרסה 25.4.0 של Google Mobile Ads SDK.
  • גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
  • גרסת BidMachine SDK‏ 3.7.1.

גרסה 3.7.0.0

  • תאימות מאומתת לגרסה 3.7.0 של BidMachine SDK.

נבנה ונבדק באמצעות:

  • גרסה 25.1.0 של Google Mobile Ads SDK.
  • גרסה 1.1.0 של Google Mobile Ads Next-Gen SDK.
  • גרסה 3.7.0 של BidMachine SDK.

גרסה 3.6.1.0

  • נוסף מאפיין ליצירת המתאם עם תלות ב-GMA Next-Gen SDK.
  • תאימות מאומתת לגרסה 3.6.1 של BidMachine SDK.

נבנה ונבדק באמצעות:

  • גרסה 25.1.0 של Google Mobile Ads SDK.
  • גרסת SDK של BidMachine‏ 3.6.1.

גרסה 3.5.1.2

  • עדכון של BidMachine Adapter לשימוש ב-AdPlacementConfig.

נבנה ונבדק באמצעות:

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסת SDK‏ BidMachine‏ 3.5.1.

גרסה 3.5.1.1

  • נוספה תמיכה בהעברת הפרמטר tagForUnderAgeOfConsent Google Mobile Ads SDK אל BidMachine SDK.

נבנה ונבדק באמצעות:

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסת SDK‏ BidMachine‏ 3.5.1.

גרסה 3.5.1.0

  • תאימות מאומתת לגרסה 3.5.1 של BidMachine SDK.

נבנה ונבדק באמצעות:

  • גרסה 24.9.0 של Google Mobile Ads SDK.
  • גרסת SDK‏ BidMachine‏ 3.5.1.

גרסה 3.5.0.0

  • תאימות מאומתת לגרסה 3.5.0 של BidMachine SDK.

נבנה ונבדק באמצעות:

  • גרסה 24.7.0 של Google Mobile Ads SDK.
  • גרסה 3.5.0 של BidMachine SDK.

גרסה 3.4.0.1

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

נבנה ונבדק באמצעות:

  • גרסה 24.7.0 של Google Mobile Ads SDK.
  • גרסה 3.4.0 של BidMachine SDK

גרסה 3.4.0.0

  • נוספה תמיכה ב-Waterfall לפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
  • המתאם מעביר עכשיו את onAdOpened() עם onAdImpression() למודעות במסך מלא.
  • תאימות מאומתת לגרסה 3.4.0 של BidMachine SDK.

נבנה ונבדק באמצעות:

  • גרסה 24.6.0 של Google Mobile Ads SDK.
  • גרסת SDK של BidMachine‏: 3.4.0.

גרסה 3.3.0.0

  • הגרסה הראשונה.

נבנה ונבדק באמצעות:

  • גרסה 24.5.0 של Google Mobile Ads SDK.
  • גרסה 3.3.0 של BidMachine SDK.