שילוב של BIGO Ads SDK עם תהליך בחירת הרשת

בחירת פלטפורמה: Android iOS Unity Android (גרסה קודמת)

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

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

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

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

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

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

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

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

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

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

שלב 1: קובעים את ההגדרות בממשק המשתמש של BIGO Ads SDK

מתחברים ללוח הבקרה של BIGO Ads.

יצירת אפליקציה

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

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

רושמים את מזהה האפליקציה.

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

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

אחרי שהבקשה נבדקת, עוברים לטבלה מיקומי מודעות בדף ולוחצים על הכפתור + Add.

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

שימו לב למזהה המשבצת.

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

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

כדי להטמיע את app-ads.txt ב-SDK להצגת מודעות של BIGO, עוברים לכרטיסייה APP-ads.txt מלוח הבקרה ופועלים לפי ההוראות שמופיעות בכרטיסייה.

שלב 2: הגדרת הביקוש של BIGO Ads SDK להצגת מודעות בממשק המשתמש של Ad Manager

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

הוספת BIGO Ads SDK לחברות

בידינג

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

Waterfall

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

בוחרים באפשרות BIGO Ads SDK בתור רשת המודעות, מזינים שם ייחודי ומפעילים את האפשרות בחירת רשת.

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

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

בידינג

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

Waterfall

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

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

בידינג

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

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

Waterfall

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

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

בידינג

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

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

Waterfall

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

הגדרת בידינג ב-BIGO Ads SDK

בידינג

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

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

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

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

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

Waterfall

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

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

בידינג

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

בוחרים את החברה עבור BIGO Ads SDK.

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

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

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

חשוב: צריך לטרגט את יחידת המודעות שנבחרה באמצעות קבוצת תפוקה אחת לפחות, ומזהה האפליקציה צריך להיות משויך לאפליקציה המטורגטת כמו בממשק המשתמש של BIGO Ads SDK להצגת מודעות.

מפל

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

גוללים אל שותפי תפוקה ולוחצים על הוספת שותף בתהליך בחירת הרשת.

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

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

חשוב: מזהה האפליקציה צריך להיות משויך לאפליקציה המטורגטת כמו בממשק המשתמש של BIGO Ads SDK.

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

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

כדי להוסיף בממשק המשתמש של Ad Manager את Empathy Technology Pte.Ltd. (BIGO Ads) לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ואת **BIGOAds** לרשימת שותפי הפרסום שפועלים בהתאם לתקנות במדינות בארה"ב, צריך לפעול לפי השלבים שמתוארים במאמרים בנושא הגדרות בנושא תקנות אירופאיות והגדרות בנושא תקנות במדינות בארה"ב.

שלב 3: מייבאים את ה-SDK להצגת מודעות והמתאם של BIGO Ads

הערה: אם לא תשלבו את הגרסאות התואמות של BIGO Ads SDK ו-Google Mobile Ads SDK, יכול להיות שיהיו בעיות ב-build.

CocoaPods

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

  pod 'GoogleMobileAdsMediationBigo'
  

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

  pod install --repo-update

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

‫GDPR והסכמה בהתאם ולתקנות האירופאיות

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

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

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

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

בדוגמת קוד לדוגמה הבאה אפשר לראות איך מעבירים את דגל ההסכמה ל-SDK להצגת מודעות של BIGO Ads. צריך להפעיל את ה-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: בדיקת ההטמעה

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

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

כדי לעזור לכם בתהליך הבדיקה והשילוב, BIGO Ads מספקת מזהי אפליקציות ומזהי מיקומי מודעות בדף לבדיקה ב-iOS.

חשוב: לפני שמפרסמים את האפליקציה, צריך להשבית את מצב הבדיקה ב-Ad Manager וב-SDK להצגת מודעות של BIGO.

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

כדי לוודא שאתם מקבלים מודעות לבדיקה מ-BIGO Ads SDK, צריך להפעיל את הבדיקה של מקור מודעות יחיד בכלי לבדיקת מודעות באמצעות מקורות המודעות של BIGO Ads SDK (בידינג).

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

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

עיבוד מודעות

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

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

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מ-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 Ads 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 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.