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

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

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

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

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

דרישות

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

  • גרסה 3.9.1.0 ומעלה של המתאם של Moloco

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הפעלת שיתוף אותות מאובטח עבור בידינג ב-SDK

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

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

הגדרת בידינג ב-Moloco

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    pod 'GoogleMobileAdsMediationMoloco'

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

    pod install --repo-update

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

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

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

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

Swift 

import MolocoSDK
// ...

MolocoPrivacySettings.hasUserConsent = true;

Objective-C 

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

[MolocoPrivacySettings setHasUserConsent:YES];

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

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

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

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

בדוגמת הקוד הבאה אפשר לראות איך מעבירים מידע על הסכמה ל-SDK של Moloco. אם בוחרים להגדיר את הדגלים האלה, מומלץ לעשות זאת לפני שליחת בקשות להצגת מודעות דרך 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 Ads 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 עד 5000 נשלחה על ידי Moloco SDK ה-SDK של Moloco החזיר שגיאה. פרטים נוספים מופיעים במאמרי העזרה של Moloco.

אימות בצד השרת של מודעות מתגמלות

אם מאמתים קריאות חוזרות של אימות בצד השרת (SSV), מזהה מקור המודעה של Moloco הוא 8267622065755668722.

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

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

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

גרסה 3.13.0.0

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

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

  • גרסה 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.
  • גרסה 3.12.1 של Moloco SDK.

גרסה 3.12.0.0

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

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

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

גרסה 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.
  • גרסה 3.10.1 של Moloco SDK.

גרסה 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

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

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

  • גרסה 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.
  • גרסה 3.7.0 של Moloco SDK.

גרסה 3.6.0.1

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

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

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

גרסה 3.6.0.0

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

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

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

גרסה 3.5.0.0

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

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

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