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

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

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

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

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

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

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

• הגרסה העדכנית של GMA Next-Gen SDK.

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

שלב 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 ב-BIGO Ads SDK להצגת מודעות, עוברים לכרטיסייה 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.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0")
    implementation("com.google.ads.mediation:bigo:6.1.0.0")
}

configurations.configureEach {
    exclude(group = "com.google.android.gms", module = "play-services-ads")
    exclude(group = "com.google.android.gms", module = "play-services-ads-lite")
}

dependencies {
    implementation 'com.google.android.libraries.ads.mobile.sdk:ads-mobile-sdk:1.5.0'
    implementation 'com.google.ads.mediation:bigo:6.1.0.0'
}

configurations.configureEach {
    exclude group: 'com.google.android.gms', module: 'play-services-ads'
    exclude group: 'com.google.android.gms', module: 'play-services-ads-lite'
}

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

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

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

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

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

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

בדוגמת קוד לדוגמה הבאה אפשר לראות איך מעבירים את דגל ההסכמה ל-SDK להצגת מודעות של BIGO Ads. צריך להפעיל את ה-method הזו לפני ששולחים בקשות להצגת מודעות דרך GMA Next-Gen SDK.

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.getAdSourceResponses() במחלקות הבאות:

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.