שילוב של Moloco עם בידינג

בחירת פלטפורמה: Android iOS Unity Flutter Android (Legacy)

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

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

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

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

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

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

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

  • מתאם Moloco בגרסה 3.9.1.0 ואילך.

שלב 1: הגדרת ההגדרות בממשק המשתמש של Moloco

מתחברים ל-Moloco Publisher Portal.

עוברים אל הכרטיסייה Overview > Apps ולוחצים על הכפתור Add App כדי ליצור אפליקציה חדשה.

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

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

עוברים לכרטיסייה Overview (סקירה כללית) > Ad Units (יחידות מודעות), בוחרים את האפליקציה מהתפריט הנפתח ולוחצים על New Ad Unit (יחידה חדשה של מודעות).

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

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

שלב 2: מגדירים את הביקוש של Moloco בממשק המשתמש של Ad Manager

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

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

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

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

עוברים אל Inventory > Secure Signals. בקטע אותות מאובטחים, מחפשים את Moloco Ads SDK להצגת מודעות ומפעילים את המתג הפעלת שילוב אפליקציות.

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

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

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

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

הגדרת הבידינג של Moloco

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

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

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

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

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

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

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

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

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

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

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

הוספת Moloco Ads לרשימת שותפי הפרסום שפועלים בהתאם לתקנות האירופאיות ולתקנות במדינות בארה"ב

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

שלב 3: ייבוא של Moloco SDK ומתאם

שימוש ב-Swift Package Manager

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

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

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

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

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

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

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

שימוש ב-CocoaPods

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

    pod 'GoogleMobileAdsMediationMoloco'

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

    pod install --repo-update

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

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

גרסה 3.5.0.0 ואילך של המתאם ל-iOS של Moloco Ads SDK תומכת בהעברת אותות הסכמה בהתאם ל-GDPR מפלטפורמות לניהול הסכמה (CMP) שמשולבות עם Transparency and Consent Framework (TCF, מסגרת השקיפות וההסכמה) של IAB אל Moloco Ads SDK. מידע נוסף זמין במאמר מחרוזת ההסכמה של TCF.

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

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

‫Moloco SDK כולל את הדגל isDoNotSell להעברת פרטי ההסכמה אל Moloco SDK.

בדוגמת הקוד הבאה אפשר לראות איך מעבירים את פרטי ההסכמה אל Moloco SDK. אם בוחרים להגדיר את הדגלים האלה, מומלץ לעשות זאת לפני שליחת בקשות להצגת מודעות דרך Google Mobile Ads SDK.

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.isDoNotSell = true;

Objective-C 

#import <MolocoSDK/MolocoSDK-Swift.h>
// ...

[MolocoPrivacySettings setIsDoNotSell:YES];

מידע נוסף מופיע במאמרי העזרה בנושא פרטיות של Moloco.

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

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

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

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

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

קודי שגיאה

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

MolocoSDK.MolocoError
GADMediationAdapterMoloco

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

קוד שגיאה דומיין סיבה
101 com.google.ads.mediation.moloco ‫Moloco SDK לא תומך בהצגת מודעות ב-iOS 12 ובגרסאות קודמות.
102 com.google.ads.mediation.moloco מפתח האפליקציה של Moloco חסר או לא תקין.
103 com.google.ads.mediation.moloco מזהה יחידת המודעות של Moloco חסר או לא תקין.
104 com.google.ads.mediation.moloco המודעה לא מוכנה להצגה.
105 com.google.ads.mediation.moloco המודעה לא הוצגה.
106 com.google.ads.mediation.moloco אין נתוני רינדור זמינים כדי לרנדר את המודעה.
‫‎-1 עד 5,000 נשלחה על ידי Moloco SDK ה-SDK של Moloco החזיר שגיאה. פרטים נוספים זמינים במאמרי העזרה של Moloco.

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

גרסה 4.11.1.0 (בפיתוח)

גרסה 4.11.0.0

  • תאימות מאומתת לגרסה 4.11.0 של Moloco SDK.

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

  • גרסה 13.11.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.11.0.

גרסה 4.10.0.0

  • תאימות מאומתת לגרסה 4.10.0 של Moloco SDK.
  • העדכון מציין ש-Moloco SDK יכול לעקוב אחרי חשיפות של מודעות מותאמות.

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

  • גרסה 13.9.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.10.0.

גרסה 4.9.1.0

  • תאימות מאומתת לגרסה 4.9.1 של Moloco SDK.

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

  • גרסה 13.8.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.9.1.

גרסה 4.9.0.0

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

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

  • גרסה 13.7.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.9.0.

גרסה 4.8.1.1

  • נוספה תמיכה בגדלים של מודעות באנר מותאמות.

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

  • גרסה 13.6.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.8.1.

גרסה 4.8.1.0

  • תאימות מאומתת לגרסה 4.8.1 של Moloco SDK.

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

  • גרסה 13.6.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.8.1.

גרסה 4.8.0.0

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

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

  • גרסה 13.6.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.8.0.

גרסה 4.7.0.0

  • תאימות מאומתת עם גרסה 4.7.0 של Moloco SDK.
  • מעדכנים את גרסת iOS המינימלית כדי להקל על התלות ב-Google Mobile Ads SDK ולאפשר גרסאות משניות.

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

  • גרסה 13.5.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.7.0.

גרסה 4.6.1.1

  • המתאם מעביר עכשיו את הדגל ageRestrictedTreatment של Google Mobile Ads SDK אל ה-API של Moloco SDK בנושא COPPA.

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

  • גרסה 13.3.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.6.1.

גרסה 4.6.1.0

  • תאימות מאומתת עם Moloco SDK בגרסה 4.6.1.

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

  • גרסה 13.3.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.6.1.

גרסה 4.6.0.0

  • תאימות מאומתת לגרסה 4.6.0 של Moloco SDK.

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

  • גרסה 13.2.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.6.0.

גרסה 4.5.1.0

  • תאימות מאומתת לגרסה 4.5.1 של Moloco SDK.

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

  • גרסה 13.2.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.5.1.

גרסה 4.5.0.0

  • תאימות מאומתת עם Moloco SDK בגרסה 4.5.0.

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

  • גרסה 13.1.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.5.0.

גרסה 4.4.1.0

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

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

  • גרסה 13.1.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.4.1.

גרסה 4.4.0.0

  • תאימות מאומתת לגרסה 4.4.0 של Moloco SDK.

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

  • גרסה 13.1.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.4.0.

גרסה 4.3.0.2

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

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

  • גרסה 13.0.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.3.0.

גרסה 4.3.0.1

  • הגרסה המינימלית של iOS ב-CocoaPods עודכנה ל-13.0.

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

  • גרסה 13.0.0 של Google Mobile Ads SDK.
  • גרסה 4.3.0 של Moloco SDK.

גרסה 4.3.0.0

  • תאימות מאומתת לגרסה 4.3.0 של Moloco SDK.

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

  • גרסה 12.14.0 של Google Mobile Ads SDK.
  • גרסה 4.3.0 של Moloco SDK.

גרסה 4.2.0.0

  • תאימות מאומתת לגרסה 4.2.0 של Moloco SDK.

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

  • גרסה 12.14.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.2.0.

גרסה 4.1.2.0

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

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

  • גרסה 12.14.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.1.2.

גרסה 4.1.0.0

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

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

  • גרסה 12.14.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 4.1.0.

גרסה 3.13.0.0

  • כולל Info.plist בתוך המסגרות.
  • תאימות מאומתת עם Moloco SDK בגרסה 3.13.0.

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

  • גרסה 12.9.0 של Google Mobile Ads SDK.
  • גרסה 3.13.0 של Moloco SDK.

גרסה 3.12.1.0

  • תאימות מאומתת לגרסה 3.12.1 של Moloco SDK.

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

  • גרסה 12.8.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.12.1.

גרסה 3.12.0.0

  • תאימות מאומתת לגרסה 3.12.0 של Moloco SDK.

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

  • גרסה 12.8.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.12.0.

גרסה 3.11.0.0

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

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

  • גרסה 12.6.0 של Google Mobile Ads SDK.
  • גרסה 3.11.0 של Moloco SDK.

גרסה 3.10.1.0

  • תאימות מאומתת לגרסה 3.10.1 של Moloco SDK.

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

  • גרסה 12.6.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.10.1.

גרסה 3.10.0.0

  • תאימות מאומתת לגרסה 3.10.0 של Moloco SDK.

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

  • גרסה 12.5.0 של Google Mobile Ads SDK.
  • גרסה 3.10.0 של Moloco SDK.

גרסה 3.9.1.0

  • נוספה תמיכה בסימני מים לפורמטים של מודעות לבידינג.
  • תוקנה בעיה בטעינת מודעות באנר MREC.
  • תאימות מאומתת עם גרסה 3.9.1 של Moloco SDK.

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

  • גרסה 12.3.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.9.1.

גרסה 3.9.0.0

  • השם של הפלטפורמה שבה נערך תהליך בחירת הרשת (Mediation) מוגדר עכשיו כשמפעילים את Moloco SDK.
  • תאימות מאומתת לגרסה 3.9.0 של Moloco SDK.

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

  • גרסה 12.3.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.9.0.

גרסה 3.8.0.0

  • הפעלת הדגלים -fobjc-arc ו--fstack-protector-all.
  • תוקנה בעיה בקבלת דירוג הכוכבים של מודעות מותאמות.
  • תאימות מאומתת עם גרסה 3.8.0 של Moloco SDK.

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

  • גרסה 12.2.0 של Google Mobile Ads SDK.
  • גרסה 3.8.0 של Moloco SDK.

גרסה 3.7.2.0

  • תאימות מאומתת לגרסה 3.7.2 של Moloco SDK.
  • נוספה תמיכה בבידינג לפורמט מודעה מותאמת.

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

  • גרסה 12.1.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.7.2.

גרסה 3.7.1.0

  • תאימות מאומתת עם Moloco SDK בגרסה 3.7.1.

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

  • גרסה 12.1.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.7.1.

גרסה 3.7.0.0

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

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

  • גרסה 12.0.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.7.0.

גרסה 3.6.0.1

  • המתאם עודכן כדי לאחזר את גרסת Moloco SDK מה-thread הראשי.
  • עכשיו נדרשת גרסה 12.0.0 ומעלה של Google Mobile Ads SDK.

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

  • גרסה 12.0.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.6.0.

גרסה 3.6.0.0

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

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

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסת Moloco SDK‏ 3.6.0.

גרסה 3.5.0.0

  • הגרסה הראשונה.
  • נוספה תמיכה בבידינג לפורמטים של מודעות באנר (כולל MREC), מודעות מעברון ומודעות מתגמלות.
  • תאימות מאומתת לגרסה 3.5.0 של Moloco SDK.

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

  • גרסה 11.13.0 של Google Mobile Ads SDK.
  • גרסה 3.5.0 של Moloco SDK.