שילוב שורה עם תהליך בחירת הרשת (Mediation) (בטא)

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

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

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

למתאם התהליך של Line יש את היכולות הבאות:

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

¹ Integration of Waterfall is in closed beta. You can contact your account manager to request access.

דרישות

• יעד הפריסה של iOS מגרסה 12.0 ואילך

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

• מדריך לתחילת העבודה בנושא בחירת הרשת

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

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

הוספת אפליקציה חדשה

לוחצים על 広告枠管理 (ניהול מיקומי מודעות) > メディア (מדיה). לאחר מכן לוחצים על 新規作成 (יצירת חדש).

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

שימו לב למזהה האפליקציה.

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

פועלים לפי אותם השלבים כדי ליצור מיקומי מודעות גם בשילובים של בידינג וגם בשילובים של Waterfall. אפשר להשתמש בכל מיקום מודעה בשני היעדים האלה.

לוחצים על המזהה של האפליקציה שרוצים להוסיף לה מיקום מודעה. לאחר מכן, בוחרים באפשרות 詳細 (פרטים).

לוחצים על スロット 追加 (הוספת מיקום מודעה).

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

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

חשוב לשים לב למזהה המיקום.

שלב 2: הגדרת ביקוש לקו ב- Ad Manager UI

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

הוספה Line ב'חברות'

בידינג

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

מפל

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

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

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

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

בידינג

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

מפל

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

הגדרת Line בידינג

בידינג

עוברים אל Delivery‏ > Bidders ולוחצים על New bidder בכרטיסייה SDK Bidding.

בוחרים ב-Line כמגיש הצעות המחיר.

מפעילים את המתגים הוספת ספריית האותות של מגיש הצעות המחיר הזה לרשימת האותות המותרים ואישור שיתוף האותות עם מגיש הצעות המחיר הזה. לאחר מכן, לוחצים על המשך.

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

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

מפל

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

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

בידינג

עוברים אל Delivery‏ > Bidders ובוחרים את החברה שלLine בכרטיסייה SDK Bidding.

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

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

חשוב: צריך לטרגט את יחידת המודעות שנבחרה באמצעות לפחות קבוצת תשואה אחת, ו-Application ID צריך להיות משויך לאפליקציה המטורגטת כמו בממשק המשתמש שלLine .

מפל

עוברים אל Delivery (הצגה) > Yield groups (קבוצות תשואה) ולוחצים על הלחצן New yield group (קבוצת תשואה חדשה). בוחרים את האפליקציה לנייד.

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

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

מזינים את הערך של Application ID and Slot ID שקיבלתם בקטע הקודם ואת הערך של Default CPM. לוחצים על שמירה.

חשוב: יש לשייך את Application ID לאפליקציה המטורגטת, כמו בLine ממשק המשתמש.

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

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

שימוש ב-CocoaPods (מומלץ)

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

שילוב ידני

• מורידים את הגרסה האחרונה של Line SDK ומקשרים את FiveAd.framework בפרויקט.
• מורידים את הגרסה האחרונה של Line adapter מהקישור להורדה ביומן השינויים ומקשרים את LineAdapter.framework בפרויקט.

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

שילוב עם SKAdNetwork

פועלים לפי המסמכים של Line כדי להוסיף את המזהים של SKAdNetwork לקובץ Info.plist של הפרויקט.

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

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

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

פועלים לפי ההוראות המפורטות במסמכי התיעוד של Line כדי להפעיל מודעות בדיקה ב-Line.

חשוב: לפני השקת האפליקציה, צריך להשבית את מצב הבדיקה ב-Ad Manager וב-Line.

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

כדי לוודא שאתם מקבלים מודעות בדיקה מ-Line, מפעילים את הבדיקה של מקור מודעות יחיד בכלי לבדיקת המודעות באמצעות מקורות המודעות Line (Waterfall).

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

פרמטרים ספציפיים לרשת

מתאם הקו תומך בפרמטר בקשה נוסף שאפשר להעביר למתאם באמצעות הכיתה GADMediationAdapterLineExtras. הכיתה הזו כוללת את המאפיינים הבאים:

adAudio

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

דוגמה לקוד ליצירת בקשה להצגת מודעה שמגדירה את הפרמטרים האלה:

Swift

import LineAdapter
// ...

let request = GAMRequest()
let extras = GADMediationAdapterLineExtras()
extras.adAudio = GADMediationAdapterLineAdAudio.unmuted
// ...
request.register(extras)

Objective-C

#import <LineAdapter/LineAdapter.h>
// ...

GAMRequest *request = [GAMRequest request];
GADMediationAdapterLineExtras *extras = [[GADMediationAdapterLineExtras alloc] init];
extras.adAudio = GADMediationAdapterLineAdAudioUnmuted;
// ...
[request registerAdNetworkExtras:extras];

שימוש במודעות מותאמות

עיבוד מודעות

מתאם השורות מאכלס את עבור GADNativeAd.

שדה	נכסים שתמיד נכללים על ידי מתאם שורה
כותרת
תמונה
גוף
סמל האפליקציה	^1
קריאה לפעולה
Star rating
חנות
מחיר

¹ במודעות מותאמות, ערכת ה-SDK של Line לא מספקת נכס של סמל אפליקציה. במקום זאת, מתאם Line מאכלס את סמל האפליקציה בתמונה שקופה.

קודי שגיאה

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

GADMediationAdapterLine

אלה הקודים וההודעות שמופיעים במתאם Line כשמודעה לא נטענת:

קוד שגיאה	דומיין	סיבה
1-10	נשלח על ידי Line SDK	ה-SDK של Line החזיר שגיאה ספציפית ל-SDK. פרטים נוספים זמינים במסמכי התיעוד של Line.
101	com.google.ads.mediation.line	פרמטרים לא חוקיים של שרת (למשל, חסר מזהה אפליקציה או מזהה משבצת).
102	com.google.ads.mediation.line	גודל המודעה המבוקש לא תואם לגודל מודעת הבאנר שנתמך ב-Line.
103	com.google.ads.mediation.line	לא ניתן לטעון נכס תמונה של סמל מידע במודעה רגילה.

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

גרסה 2.9.20241106.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.9.20241106.

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

• Google Mobile Ads SDK בגרסה 11.12.0.
• גרסת FiveAd SDK‏ 2.9.20241106.

גרסה 2.8.20240827.1

• עדכנו את CFBundleShortVersionString כך שיכלול שלושה רכיבים במקום ארבעה.

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

• Google Mobile Ads SDK בגרסה 11.10.0.
• גרסת FiveAd SDK‏ 2.8.20240827.

גרסה 2.8.20240827.0

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

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

• Google Mobile Ads SDK בגרסה 11.8.0.
• גרסת FiveAd SDK‏ 2.8.20240827.

גרסה 2.8.20240612.0

• הוספנו שליטה באודיו של מודעות מותאמות באמצעות GADVideoOptions.
• תאימות מאומתת ל-FiveAd SDK בגרסה 2.8.20240612.

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

• Google Mobile Ads SDK בגרסה 11.5.0.
• גרסת FiveAd SDK‏ 2.8.20240612.

גרסה 2.7.20240411.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240411.

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

• Google Mobile Ads SDK בגרסה 11.3.0.
• גרסת ה-SDK של FiveAd היא 2.7.20240411.

גרסה 2.7.20240318.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240318.

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

• Google Mobile Ads SDK בגרסה 11.2.0.
• גרסת ה-SDK של FiveAd היא 2.7.20240318.

גרסה 2.7.20240214.1

• עכשיו נדרשת גרסת iOS מגרסה 12.0 ואילך.
• מעכשיו נדרשת גרסה 11.0 ואילך של Google Mobile Ads SDK.
• Info.plist נכלל במסגרות שב-LineAdapter.xcframework.

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

• Google Mobile Ads SDK בגרסה 11.0.1.
• גרסת ה-SDK של FiveAd היא 2.7.20240214.

גרסה 2.7.20240214.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240214.

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

• Google Mobile Ads SDK בגרסה 11.0.1.
• גרסת ה-SDK של FiveAd היא 2.7.20240214.

גרסה 2.7.20240126.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20240126.
• עדכנו את הטמעת המתאם עם פרוטוקולים חדשים של FiveAd SDK.

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

• Google Mobile Ads SDK בגרסה 10.14.0.
• גרסת ה-SDK של FiveAd היא 2.7.20240126.

גרסה 2.7.20231115.0

• תאימות מאומתת ל-FiveAd SDK בגרסה 2.7.20231115.
• הכותרת GADMediationAdapterLineExtras כלולה ב-modulemap.

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

• Google Mobile Ads SDK בגרסה 10.14.0.
• גרסת FiveAd SDK‏ 2.7.20231115.

גרסה 2.6.20230609.1

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

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

• Google Mobile Ads SDK בגרסה 10.14.0.
• גרסת FiveAd SDK‏ 2.6.20230609.

גרסה 2.6.20230609.0

• זו הגרסה הראשונה
• הוספנו תמיכה ב-Waterfall לפורמטים של מודעות באנר, מודעות מעברון, מודעות מתגמלות ומודעות מותאמות.
• תאימות מאומתת ל-FiveAd SDK בגרסה 2.6.20230609.

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

• Google Mobile Ads SDK בגרסה 10.9.0.
• גרסת FiveAd SDK‏ 2.6.20230609.