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

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

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

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

למתאם התהליך של LINE Ads Network יש את היכולות הבאות:

שילוב
בידינג  1
מפל  2
פורמטים
מודעת באנר  3
מעברון  3
ההטבה הופעלה
מותאם
1 Integration of bidding is in closed beta, reach out to your account manager to request access.

2 השילוב של Waterfall נמצא בגרסת בטא פתוחה.

3 הפורמט הזה נתמך רק בשילוב של רשימת רשתות.

דרישות

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

שלב 1: הגדרת ההגדרות בממשק המשתמש של LINE Ads Network

נכנסים לחשבון LINE Ads Network.

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

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

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

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

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

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

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

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

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

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

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

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

הוספת LINE Ads Network ב'חברות'

בידינג

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

מפל

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

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

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

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

בידינג

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

מפל

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

הגדרת בידינג ב-LINE Ads Network

בידינג

עוברים אל Delivery (הצגה) > Bidders (מגישי הצעות מחיר), ולוחצים על New bidder (מגיש הצעות מחיר חדש) בכרטיסייה SDK Bidding (בידינג באמצעות SDK).

בוחרים ב-LINE Ads Network בתור המגיש/ת הצעות המחיר.

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

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

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

מפל

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

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

בידינג

עוברים אל Delivery (הצגת מודעות) > Bidders (מגישי הצעות מחיר), ובוחרים את החברה של LINE Ads Network בכרטיסייה SDK Bidding (בידינג באמצעות SDK).

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

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

מפל

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

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

בוחרים את החברה שיצרתם ל-LINE Ads Network בקטע הקודם. בוחרים באפשרות Mobile SDK mediation בתור Integration type (סוג השילוב), באפשרות iOS בתור Platform (פלטפורמה) ובאפשרות Active בתור Status (סטטוס).

מזינים את Application ID (מזהה האפליקציה) ו-Slot ID (מזהה המיקום) שהתקבלו בקטע הקודם, ואת הערך של Default CPM (עלות לכל אלף חשיפות שמוגדרת כברירת מחדל). לוחצים על שמירה.

שלב 3: מייבאים את ה-SDK ואת המתאם של LINE Ads Network

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

pod 'GoogleMobileAdsMediationLine'

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

pod install --repo-update

שילוב ידני

  • מורידים את הגרסה העדכנית ביותר של LINE Ads Network SDK ומקשרים את FiveAd.framework בפרויקט.
  • מורידים את הגרסה האחרונה של מתאם LINE Ads Network מהקישור להורדה ביומן השינויים ומקשרים את LineAdapter.framework בפרויקט.

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

שילוב עם SKAdNetwork

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

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

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

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

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

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

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

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

מתאם LINE Ads Network תומך בפרמטר בקשה נוסף שאפשר להעביר למתאם באמצעות הכיתה 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];

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

רינדור מודעות

מתאם LINE Ads Network מאכלס את השדות הבאים עבור GADNativeAd.

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

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

קודי שגיאה

אם המתאם לא מצליח לקבל מודעה מרשת LINE Ads Network, תוכלו לבדוק את השגיאה הבסיסית בתשובה מהמודעה באמצעות GADResponseInfo.adNetworkInfoArray בקטגוריות הבאות:

GADMediationAdapterLine

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

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

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

הגרסה הבאה

  • הוסרה הלוגיקה שבדקה אם FAD SDK רשום בהגדרת המתאם.
  • עדכנו את ממשק ה-API של 'הצגה' של מודעות מעברון ומודעות מתגמלות באמצעות ממשק ה-API החדש 'showWithViewController:‎'.
  • הסרת הבדיקה של סטטוס המודעה המותאמת לפני הורדת נכסי מודעות מותאמות, כי היא הוצאה משימוש ואין לה תחליף.

גרסה 2.9.20241106.1

  • עדכנו את המתאם כך שישתמש ב-API העדכני ביותר לטעינה של מודעות לבידינג במודעות באנר.
  • תוקנה בעיה שמונעת העברה נכונה של אירועי מודעות לבידינג של מודעות מעברון.

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

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

גרסה 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.
  • גרסת ה-SDK של FiveAd היא 2.6.20230609.

גרסה 2.6.20230609.0

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

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

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