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

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

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

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

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

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

• ‫Android API ברמה 24 ואילך.

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

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

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

נכנסים למרכז הבקרה של BIGO Ads.

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

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

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

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

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

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

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

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

עדכון של הקובץ 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 לחברות

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

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

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

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

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

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

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

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

שילוב עם Android Studio (מומלץ)

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

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

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

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

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

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

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

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

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

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

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true);
BigoMediationSnippets.java

BigoAdSdk.setUserConsent(context, ConsentOptions.CCPA, true)
BigoMediationSnippets.kt

מידע נוסף זמין במדריך לשילוב של BIGO Ads SDK להצגת מודעות בנושא CCPA.

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

אין צורך בקוד נוסף כדי לשלב את BIGO Ads SDK.

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

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

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

‫BIGO Ads מספקת מזהי אפליקציות ומזהי מיקומי מודעות בדף לבדיקה ואינטגרציה ב-Android.

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

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

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

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

עיבוד מודעות

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

קודי שגיאה

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

sg.bigo.ads
com.google.ads.mediation.bigo.BigoMediationAdapter

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

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

גרסה 6.1.0.0

• תאימות מאומתת לגרסה 6.1.0 של Bigo Ads SDK.

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

• גרסה 25.5.0 של Google Mobile Ads SDK.
• גרסה 1.4.0 של Google Mobile Ads Next-Gen SDK.
• גרסה 6.1.0 של Bigo Ads SDK.

גרסה 6.0.1.0

• תאימות מאומתת ל-Bigo Ads SDK 6.0.1.

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

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

גרסה 6.0.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.
• גרסה 6.0.0 של Bigo Ads SDK.

גרסה 6.0.0.0

• תאימות מאומתת ל-Bigo Ads SDK בגרסה 6.0.0.

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

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.3.1 של Google Mobile Ads Next-Gen SDK.
• גרסה 6.0.0 של Bigo Ads SDK.

גרסה 5.10.1.0

• תאימות מאומתת עם Bigo Ads SDK בגרסה 5.10.1.

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

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
• גרסה 5.10.1 של Bigo Ads SDK.

גרסה 5.9.0.1

• ממפה את AgeRestrictedTreatment ל-COPPA API של Bigo.

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

• גרסה 25.4.0 של Google Mobile Ads SDK.
• גרסה 1.2.1 של Google Mobile Ads Next-Gen SDK.
• גרסה 5.9.0 של Bigo Ads SDK.

גרסה 5.9.0.0

• תאימות מאומתת עם גרסה 5.9.0 של Bigo Ads SDK.

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

• גרסה 25.2.0 של Google Mobile Ads SDK.
• גרסה 1.0.1 של Google Mobile Ads Next-Gen SDK.
• גרסה 5.9.0 של Bigo Ads SDK.

גרסה 5.8.0.0

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

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

• גרסה 25.1.0 של Google Mobile Ads SDK.
• גרסה 5.8.0 של Bigo Ads SDK.

גרסה 5.7.1.0

• תאימות מאומתת עם Bigo Ads SDK בגרסה 5.7.1.

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

• גרסה 25.0.0 של Google Mobile Ads SDK.
• גרסה 5.7.1 של Bigo Ads SDK.

גרסה 5.7.0.0

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

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

• גרסה 24.9.0 של Google Mobile Ads SDK.
• גרסה 5.7.0 של Bigo Ads SDK.

גרסה 5.5.2.0

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

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

• גרסה 24.9.0 של Google Mobile Ads SDK.
• גרסה 5.5.2 של Bigo Ads SDK.