במדריך הזה מוסבר איך להשתמש ב-Google Mobile Ads SDK כדי לטעון ולהציג מודעות מ-BIGO Ads SDK להצגת מודעות באמצעות תהליך בחירת הרשת (Mediation) ב-AdMob, כולל שילובים של בידינג. המדריך כולל הסבר על הוספת BIGO Ads SDK להגדרת תהליך הבחירה של יחידת מודעות, ועל שילוב של BIGO Ads SDK ומתאם באפליקציה ל-iOS.
שילובים ופורמטים נתמכים של מודעות
מתאם תהליך בחירת הרשת של BIGO Ads SDK כולל את היכולות הבאות:
| שילוב | |
|---|---|
| בידינג | |
| Waterfall | |
| פורמטים | |
| מודעה בפתיחת אפליקציה | |
| מודעת באנר | |
| מעברון | |
| מודעה מתגמלת | |
| מודעות מעברון מתגמלות | |
| מותאמת | |
דרישות מוקדמות
לפני שממשיכים, צריך לוודא את הפרטים הבאים:
- יעד פריסה 13.0 ומעלה ב-iOS.
הגרסה העדכנית של Google Mobile Ads SDK.
שלב 1: קובעים את ההגדרות בממשק המשתמש של BIGO Ads SDK
נכנסים למרכז הבקרה של BIGO Ads.
יצירת אפליקציה
עוברים לכרטיסייה מלאי שטחי פרסום, ובטבלה אפליקציות ואתרים לוחצים על הכפתור + הוספה.
ממלאים את שאר הטופס ולוחצים על שליחה.
רושמים את מזהה האפליקציה.
יצירת מיקום מודעה בדף
אחרי שהאפליקציה תיבדק, עוברים לטבלה מיקומי מודעות בדף ולוחצים על הכפתור + הוספה.
בוחרים באפשרות בידינג בצד השרת בתור סוג המכרז, ממלאים את שאר הטופס ולוחצים על שליחה.
שימו לב ל-Slot ID (מזהה המשבצת)
עדכון של הקובץ app-ads.txt
Authorized Sellers for Apps (או app-ads.txt) היא יוזמה של IAB Tech Lab שעוזרת להבטיח שמלאי שטחי הפרסום באפליקציה שלכם יימכר רק דרך ערוצים שציינתם שהם מורשים. כדי למנוע אובדן משמעותי בהכנסות מפרסום, מומלץ להטמיע קובץ app-ads.txt.
אם עדיין לא עשיתם זאת, הגדירו קובץ app-ads.txt לאפליקציה.
כדי להטמיע את app-ads.txt ב-SDK להצגת מודעות של BIGO, עוברים לכרטיסייה APP-ads.txt ממרכז הבקרה ופועלים לפי ההוראות שבכרטיסייה.
שלב 2: מגדירים את הביקוש של BIGO Ads SDK להצגת מודעות בממשק המשתמש של AdMob
קביעת ההגדרות של תהליך בחירת הרשת ליחידת המודעות
צריך להוסיף את BIGO Ads SDK להגדרות של תהליך בחירת הרשת (Mediation) ביחידת המודעות.
קודם כול, נכנסים לחשבון AdMob. עוברים לכרטיסייה תהליך בחירת הרשת (Mediation). אם יש לכם קבוצה קיימת לבחירת רשת שאתם רוצים לשנות, לחצו על השם של הקבוצה כדי לערוך אותה ודלגו לשלב הוספת BIGO Ads SDK להצגת מודעות כמקור מודעות.
כדי ליצור קבוצה חדשה לבחירת רשת, לוחצים על יצירת קבוצה לבחירת רשת (Mediation).
מזינים את פורמט המודעה ואת הפלטפורמה ולוחצים על המשך.
נותנים שם לקבוצה לבחירת רשת ובוחרים את המיקומים לטירגוט. אחר כך מגדירים את הסטטוס של קבוצה לבחירת רשת (Mediation) ל-מופעל ולוחצים על הוספת יחידות מודעות.
משייכים את הקבוצה הזו לבחירת רשת לאחת או יותר מיחידות המודעות הקיימות ב-AdMob. אחר כך לוחצים על סיום.
עכשיו אמור להופיע כרטיס יחידות המודעות עם יחידות המודעות שבחרתם:
הוספת BIGO Ads SDK כמקור מודעות
בקטע מקורות מודעות, מאתרים את הכרטיס בידינג ולוחצים על הוספת מקור מודעות. לאחר מכן בוחרים באפשרות BIGO Ads SDK.
לוחצים על איך חותמים על הסכם שותפות ומגדירים שותפות לבידינג עם BIGO Ads SDK.
לוחצים על אישור והסכמה ואז על המשך.
אם כבר יש לך מיפוי ל-BIGO SDK להצגת מודעות, אפשר לבחור אותו. אחרת, לוחצים על הוספת מיפוי.
בשלב הבא, מזינים את מזהה המשבצת שקיבלתם בקטע הקודם. אחר כך לוחצים על סיום.
הוספת BIGO TECHNOLOGY PTE LTD לרשימת שותפי הפרסום שפועלים בהתאם ל-GDPR ולתקנות במדינות בארה"ב
כדי להוסיף בממשק המשתמש של AdMob את Empathy Technology Pte.Ltd. (BIGO Ads) לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ואת BIGOAds לרשימת שותפי הפרסום שפועלים בהתאם לתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.
שלב 3: מייבאים את ה-SDK להצגת מודעות ואת המתאם של BIGO Ads
CocoaPods
מוסיפים את השורה הבאה לקובץ Podfile של הפרויקט:
pod 'GoogleMobileAdsMediationBigo'מריצים את הפקודה הבאה משורת הפקודה:
pod install --repo-update
שלב 4: מטמיעים את הגדרות הפרטיות ב-BIGO Ads SDK
GDPR והסכמה בהתאם ולתקנות האירופאיות
כדי לעמוד בדרישות של מדיניות Google בנושא הסכמת משתמשים באיחוד האירופי, עליכם להציג הודעות גילוי נאות מסוימות למשתמשים שנמצאים באזור הכלכלי האירופי (EEA), בבריטניה ובשוויץ. במקומות שבהם זה נדרש על פי חוק, אתם צריכים גם לקבל את הסכמתם לשימוש בקובצי cookie או באמצעים אחרים לאחסון מקומי. נוסף לכך אתם צריכים לקבל את ההסכמה שלהם לאיסוף ולשיתוף של המידע האישי שלהם ולשימוש בו לצורך התאמה אישית של מודעות. המדיניות הזו משקפת את הדרישות שמפורטות ב-ePrivacy Directive (הדירקטיבה בנושא פרטיות ותקשורת אלקטרונית) וב-General Data Protection Regulation (התקנות הכלליות להגנה על מידע, GDPR) של האיחוד האירופי. באחריותכם לוודא שההסכמה מועברת לכל מקור מודעות בשרשרת לבחירת רשת.
גרסה 5.0.6.0 ומעלה של מתאם iOS ל-BIGO Ads SDK תומכת בהעברת אותות הסכמה בהתאם ל-GDPR מפלטפורמות לניהול הסכמה (CMP) שמשולבות ב-Transparency and Consent Framework (TCF) של IAB אל BIGO Ads SDK. מידע נוסף זמין במדריך לשילוב של BIGO Ads SDK להצגת מודעות בנושא GDPR.
דיני פרטיות במדינות בארה"ב
דיני הפרטיות במדינות בארה"ב מחייבים אתכם לתת למשתמשים את הזכות לבטל את ההסכמה ל"מכירה" של "המידע האישי" שלהם (כפי שהמונחים האלה מוגדרים בחוק). האפשרות לביטול ההסכמה חייבת להיות מוצעת בקישור בולט בדף הבית של הצד המוֹכֵר. בקישור צריך להיות כתוב "אין למכור את המידע האישי שלי". במדריך בנושא עמידה בדרישות של דיני הפרטיות במדינות בארה"ב יש אפשרות להפעיל עיבוד נתונים מוגבל בהצגת מודעות Google, אבל Google לא יכולה להחיל את ההגדרה הזו על כל רשת מודעות בשרשרת לבחירת רשת. לכן, עליכם לזהות כל רשת מודעות בשרשרת בחירת הרשת שעשויה להשתתף במכירת מידע אישי, ולפעול בהתאם להנחיות של כל אחת מהרשתות האלה כדי לוודא שאתם עומדים בדרישות.
קוד לדוגמה הבא מראה איך להעביר את דגל ההסכמה אל BIGO Ads SDK להצגת מודעות. צריך להפעיל את ה-method הזו לפני ששולחים בקשות להצגת מודעות דרך Google Mobile Ads SDK.
Swift
BigoAdSdk.setUserConsentWithOption(BigoConsentOptionsCCPA, consent: true)
Objective-C
[BigoAdSdk setUserConsentWithOption:BigoConsentOptionsCCPA consent:YES];
מידע נוסף זמין במדריך השילוב של BIGO Ads SDK להצגת מודעות בנושא CCPA.
שלב 5: מוסיפים את הקוד הנדרש
הטמעה של SKAdNetwork
פועלים לפי מאמרי העזרה של BIGO Ads SDK כדי להוסיף את מזהי SKAdNetwork לקובץ Info.plist של הפרויקט.
שלב 6: בודקים את ההטמעה
הפעלת מודעות בדיקה
חשוב לוודא שרשמתם את מכשיר הבדיקה ב-AdMob.
כדי לעזור לכם בתהליך הבדיקה והשילוב, BIGO Ads מספקת מזהי אפליקציות ומזהי מיקומי מודעות בדף לבדיקה ב-iOS.
אימות מודעות בדיקה
כדי לוודא שאתם מקבלים מודעות לבדיקה מ-BIGO Ads SDK, צריך להפעיל את בדיקת מקור המודעות היחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות של BIGO Ads SDK (בידינג).
שלבים אופציונליים
מודעות מותאמות
רינדור מודעות
המתאם של BIGO Ads SDK מחזיר את המודעות המותאמות שלו כאובייקטים של GADNativeAd. הוא מאכלס את השדות הבאים של GADNativeAd.
| שדה | נכסים שתמיד נכללים במתאם של BIGO Ads SDK |
|---|---|
| כותרת | |
| תמונה | |
| גוף | |
| סמל | |
| קריאה לפעולה | |
| דירוג כוכבים | |
| חנות | |
| מחיר | |
| מפרסם |
קודי שגיאה
אם המתאם לא מצליח לקבל מודעה מ-BIGO Ads SDK, אפשר לבדוק את השגיאה הבסיסית בתגובה לבקשה להצגת מודעה באמצעות GADResponseInfo.adNetworkInfoArray במחלקות הבאות:
GADMediationAdapterBigo
אלה הקודים וההודעות הנלוות שמוחזרים על ידי המתאם של BIGO Ads SDK כשהטעינה של מודעה נכשלת:
| קוד שגיאה | דומיין | סיבה |
|---|---|---|
| 101 | com.google.mediation.bigoadapter | בהגדרות השרת חסר מזהה אפליקציה נדרש. |
| 102 | com.google.mediation.bigoadapter | הגדרת המודעה לא תקינה. |
| 103 | com.google.mediation.bigoadapter | המודעה לא הוצגה. |
| 104 | com.google.mediation.bigoadapter | גודל הבאנר לא נתמך. |
| 105 | com.google.mediation.bigoadapter | Bigo טענה מודעת באנר, אבל חסרה תצוגת מודעה. |
| 1000-1100 | נשלח על ידי BIGO Ads SDK | BIGO Ads SDK החזיר שגיאה. פרטים נוספים מופיעים במאמרי העזרה של BIGO Ads SDK. |
יומן השינויים של מתאם תהליך בחירת הרשת של BIGO Ads ל-iOS
גרסה 6.1.0.0
- תאימות מאומתת לגרסה 6.1.0 של BIGO Ads SDK.
נבנה ונבדק עם:
- גרסה 13.10.0 של Google Mobile Ads SDK.
- גרסה 6.1.0 של BIGO Ads SDK.
גרסה 6.0.0.1
- המתאם ממפה עכשיו בקשות למודעות באנר מותאמות לגודל הנתמך הקרוב ביותר של מודעת באנר רגילה.
נבנה ונבדק עם:
- גרסה 13.10.0 של Google Mobile Ads SDK.
- גרסה 6.0.0 של BIGO Ads SDK.
גרסה 6.0.0.0
- תאימות מאומתת עם גרסה 6.0.0 של BIGO Ads SDK.
נבנה ונבדק עם:
- גרסה 13.9.0 של Google Mobile Ads SDK.
- גרסה 6.0.0 של BIGO Ads SDK.
גרסה 5.3.0.0
- תאימות מאומתת לגרסה 5.3.0 של BIGO Ads SDK.
נבנה ונבדק עם:
- גרסה 13.6.0 של Google Mobile Ads SDK.
- גרסה 5.3.0 של BIGO Ads SDK.
גרסה 5.2.1.0
- תאימות מאומתת עם גרסה 5.2.1 של BIGO Ads SDK.
- כדי להשתמש בממשקי ה-API החדשים לפרטיות, צריך לעדכן את התלות המינימלית ב-Google Mobile Ads SDK לגרסה 13.3.0.
נבנה ונבדק עם:
- גרסה 13.4.0 של Google Mobile Ads SDK.
- גרסה 5.2.1 של BIGO Ads SDK.
גרסה 5.2.0.0
- תאימות מאומתת עם גרסה 5.2.0 של BIGO SDK להצגת מודעות.
נבנה ונבדק עם:
- גרסה 13.4.0 של Google Mobile Ads SDK.
- גרסה 5.2.0 של BIGO Ads SDK.
גרסה 5.1.2.1
- המתאם מעביר עכשיו את הדגל
ageRestrictedTreatmentשל Google Mobile Ads SDK אל ה-API של BIGO Ads SDK בנושא COPPA.
נבנה ונבדק עם:
- גרסה 13.3.0 של Google Mobile Ads SDK.
- גרסה 5.1.2 של BIGO Ads SDK.
גרסה 5.1.2.0
- תאימות מאומתת לגרסה 5.1.2 של BIGO Ads SDK.
נבנה ונבדק עם:
- גרסה 13.2.0 של Google Mobile Ads SDK.
- גרסה 5.1.2 של BIGO Ads SDK.
גרסה 5.1.1.0
- תאימות מאומתת עם גרסה 5.1.1 של BIGO Ads SDK להצגת מודעות.
נבנה ונבדק עם:
- גרסה 13.2.0 של Google Mobile Ads SDK.
- גרסה 5.1.1 של BIGO Ads SDK.
גרסה 5.1.0.1
- עדכנו את המתאם כדי למנוע כשלים בבקשות להצגת מודעות כשמודעת באנר נטענת עם גודל מודעה שלא נתמך.
נבנה ונבדק עם:
- גרסה 13.1.0 של Google Mobile Ads SDK.
- גרסה 5.1.0 של BIGO Ads SDK.
גרסה 5.1.0.0
- תאימות מאומתת עם גרסה 5.1.0 של BIGO Ads SDK.
נבנה ונבדק עם:
- גרסה 13.1.0 של Google Mobile Ads SDK.
- גרסה 5.1.0 של BIGO Ads SDK.
גרסה 5.0.6.2
- עודכנה התלות ב-Google Mobile Ads SDK לגרסה 13.0.0.
נבנה ונבדק עם:
- גרסה 13.0.0 של Google Mobile Ads SDK.
- גרסה 5.0.6 של BIGO Ads SDK.
גרסה 5.0.6.1
- גרסת iOS המינימלית של CocoaPods עודכנה ל-
13.0.
נבנה ונבדק עם:
- גרסה 13.0.0 של Google Mobile Ads SDK.
- גרסה 5.0.6 של BIGO Ads SDK.
גרסה 5.0.6.0
- זו הגרסה הראשונה
- נוספה תמיכה בבידינג לפורמטים של מודעות בפתיחת אפליקציה, מודעות באנר (כולל MREC), מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
- תאימות מאומתת לגרסה 5.0.6 של BIGO Ads SDK.
נבנה ונבדק עם:
- גרסה 12.14.0 של Google Mobile Ads SDK.
- גרסה 5.0.6 של BIGO Ads SDK.