שילוב של BidMachine עם Mediation

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

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

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

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

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

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

• יעד פריסה 13.0 ומעלה ב-iOS.

• הגרסה העדכנית של Google Mobile Ads SDK.

• הגדרת תהליך בחירת הרשת.

שלב 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 לחברות

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

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

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

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

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

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

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

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

שימוש ב-Swift Package Manager

לפני שממשיכים, צריך לוודא שגרסת המתאם היא לפחות 3.6.0.0.

כדי להוסיף תלות בחבילה לפרויקט:

1. ב-Xcode, עוברים אל File (קובץ) > Add Package Dependencies...‎ (הוספת יחסי תלות בין חבילות...).

2. בפרומפט שמופיע, מחפשים את כתובת ה-URL של החבילה הבאה:

   https://github.com/googleads/googleads-mobile-ios-mediation-bidmachine.git
   

3. בקטע כלל תלות, בוחרים באפשרות הסתעפות.

4. בשדה הטקסט, מזינים main.

שימוש ב-CocoaPods

• מוסיפים את השורה הבאה ל-Podfile של הפרויקט:

  pod 'GoogleMobileAdsMediationBidMachine'
  

• מריצים את הפקודה הבאה משורת הפקודה:

  pod install --repo-update

שילוב ידני

1. מורידים את הגרסה העדכנית של BidMachine SDK ל-iOS ומקשרים את כל הקבצים והחבילות של .xcframework בפרויקט.

2. מורידים את הגרסה העדכנית של מתאם BidMachine מקישור ההורדה ביומן השינויים ומקשרים את BidMachineAdapter.xcframework בפרויקט.

שלב 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: מוסיפים את הקוד הנדרש

הטמעה של SKAdNetwork

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

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

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

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

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

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

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

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

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

עיבוד מודעות

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

קודי שגיאה

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

GADMediationAdapterBidMachine

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

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

גרסה 3.8.2.0

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

פותח ונבדק עם:

• גרסה 13.11.0 של Google Mobile Ads SDK.
• גרסה 3.8.2 של BidMachine SDK.

גרסה 3.8.1.0

• תאימות מאומתת עם גרסה 3.8.1 של BidMachine SDK.

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

• גרסה 13.10.0 של Google Mobile Ads SDK.
• גרסה 3.8.1 של BidMachine SDK.

גרסה 3.8.0.0

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

פותח ונבדק עם:

• גרסה 13.9.0 של Google Mobile Ads SDK.
• גרסה 3.8.0 של BidMachine SDK.

גרסה 3.7.1.1

• הגרסה המינימלית של Google Mobile Ads iOS SDK עודכנה ל-13.3 כדי לאפשר שימוש בגרסאות משניות.
• הגרסה עודכנה כך שתעביר את מזהה מיקום המודעה ל-BidMachine SDK בזמן איסוף האותות וטעינת המודעות.

פותח ונבדק עם:

• גרסה 13.8.0 של Google Mobile Ads SDK.
• גרסת BidMachine SDK‏ 3.7.1.

גרסה 3.7.1.0

• תאימות מאומתת לגרסה 3.7.1 של BidMachine SDK.
• בקשות להצגת מודעות באנר עם בידינג קבוע לא מעבירות את גודל המודעה בצורה תקינה.

פותח ונבדק עם:

• גרסה 13.4.0 של Google Mobile Ads SDK.
• גרסת BidMachine SDK‏ 3.7.1.

גרסה 3.7.0.0

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

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

• גרסה 13.4.0 של Google Mobile Ads SDK.
• גרסה 3.7.0 של BidMachine SDK.

גרסה 3.6.1.1

• המתאם מעביר עכשיו את הדגל ageRestrictedTreatment של Google Mobile Ads SDK אל COPPA API של BidMachine SDK.
• שדרוג המתאם של BidMachine ובדיקות היחידה ל-Swift 6.

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

• גרסה 13.3.0 של Google Mobile Ads SDK.
• ‫BidMachine SDK גרסה 3.6.1.

גרסה 3.6.1.0

• תאימות מאומתת עם BidMachine SDK בגרסה 3.6.1.

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

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

גרסה 3.6.0.0

• תאימות מאומתת לגרסה 3.6.0 של BidMachine SDK.
• בוצע שכתוב של הקוד לטעינת מודעות באנר ולטיפול בתמונות של מודעות מותאמות ב-BidMachine.

פותח ונבדק עם:

• גרסה 13.1.0 של Google Mobile Ads SDK.
• גרסה 3.6.0 של BidMachine SDK.

גרסה 3.5.1.2

• עודכנה התלות ב-Google Mobile Ads SDK לגרסה 13.0.0.

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

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

גרסה 3.5.1.1

• הגרסה המינימלית של iOS ב-CocoaPods עודכנה ל-13.0.
• נוספה תמיכה בהעברת הפרמטר tagForUnderAgeOfConsent של Google Mobile Ads SDK אל BidMachine SDK.
• שינינו את סעיפי התאימות של BidMachineAdDelegate כדי להתאים אותם לאופן הפעולה של הקריאות החוזרות (callback) ב-BidMachine SDK.

פותח ונבדק עם:

• גרסה 13.0.0 של Google Mobile Ads SDK.
• ‫BidMachine SDK בגרסה 3.5.1.

גרסה 3.5.1.0

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

פותח ונבדק עם:

• גרסה 12.14.0 של Google Mobile Ads SDK.
• ‫BidMachine SDK בגרסה 3.5.1.

גרסה 3.5.0.0

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

פותח ונבדק עם:

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

גרסה 3.4.0.2

• נוספה תמיכה ב-Waterfall לפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• המאפיין הסטטי isTestMode הוסר מ-BidMachineAdapterExtras.
• נוספה אימות של גודל מודעת באנר למודעות באנר ב-Waterfall.

פותח ונבדק עם:

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

גרסה 3.4.0.1

• מצב הבדיקה זמין עכשיו ב-Objective-C דרך המאפיין GADMediationAdapterBidMachineExtras.isTestMode.

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

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

גרסה 3.4.0.0

• הגרסה הראשונה.
• נוספה תמיכה בבידינג לפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת לגרסה 3.4.0 של BidMachine SDK.

פותח ונבדק עם:

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