צדדים שלישיים אינם משתמשים ישירים של Ad Manager, בכך שייתכן שאין להם רשת Ad Manager משלהם. במקום זאת, הם יוצרים שירותים או שילובים עם Ad Manager עבור הלקוחות שלהם שהם לקוחות Ad Manager. במדריך הזה נסביר על העקרונות הבסיסיים של שילובים עם צד שלישי, באמצעות שיטות מומלצות, טיפים וטריקים.
המדריך הזה מבוסס על ההנחה שיש לך ידע מעשי ב-Ad Manager API. אם אתם לא מכירים את Ad Manager API, מומלץ לעיין במסמכי התיעוד לתחילת העבודה.
תחילת העבודה כצד שלישי
כדי להשתמש ב-Ad Manager API ולגשת לרשת של לקוח Ad Manager, צריך לפעול לפי ההנחיות הבאות. לא נדרש אישור נוסף מ-Google, אבל חשוב לזכור ששימוש ב-Ad Manager API ו/או שימוש בו מבטאים את ההסכמה שלך לתנאים ולהגבלות של Ad Manager API.
איך לבדוק את השילוב של Ad Manager כצד שלישי
בתור צד שלישי, ייתכן שתהיתם איך לבדוק את השילוב של Ad Manager לפני שאתם מריצים אותו מול רשתות הייצור של הלקוחות שלכם. הגישה המומלצת היא ליצור רשת בדיקה. אתם לא צריכים להיות לקוחות של Ad Manager כדי לעשות זאת. כל מי שיש לו חשבון Google יכול ליצור רשת בדיקה.
עם זאת, חשוב לשים לב להבדלים בין רשתות הבדיקה לבין רשתות הייצור. רשתות הבדיקה לא יכולות להציג מודעות. כמו כן, רשתות בדיקה לא בהכרח יכילו את כל התכונות שללקוחות שלכם יהיו זמינות ברשתות הייצור שלהם. אם אתם צריכים לבדוק תכונות של Ad Manager שלא זמינות ברשת הבדיקות, אפשרות אחת היא לרכוש דרך מפיץ של Ad Manager גישה לרשת שאינה משמשת לבדיקה.
בנוסף, חשוב להבהיר ללקוחות באילו תכונות הם צריכים להשתמש ברשת הייצור כדי שהאפליקציה תפעל כמו שצריך. כדי לטפל במקרים שבהם התכונות לא קיימות באפליקציה, צריך לזהות חריגים ולהיכשל בחינניות, או לשמור רשימה של הלקוחות ושל התכונות שאין בכל אחד מהם. באחריות הלקוח לעבוד עם איש הקשר שלו ב-Google כדי לנהל את התכונות ברשת שלו.
אימות: איך נכנסים בצורה תקינה לרשת Ad Manager של לקוח
כדי שהאפליקציה שלכם תוכל לגשת לרשת Ad Manager של הלקוח, צריך להגדיר את תהליך האימות באופן מאובטח.
התהליך הזה כולל שני שלבים:
- יוצרים כתובת אימייל של חשבון Google ומשתמשים בה כדי לגשת לרשת של הלקוח.
- הלקוח צריך להוסיף את החשבון הזה כמשתמש לרשת Ad Manager שלו.
בשלב 1, תוכלו ליצור חשבון Google נפרד לכל לקוח, או חשבון ראשי שישמש לכל הלקוחות. האפשרות הראשונה מאובטחת יותר אם אחד מהחשבונות שלכם נפרץ. לאחר מכן, צריך לבצע את השלב הראשון רק פעם אחת.
לא משנה מה תעשו בשלב 1, בשלב 2 תצטרכו לבקש מכל לקוח חדש להוסיף את חשבון Google המתאים שיצרתם עבורו כמשתמש לרשת Ad Manager שלו.
1. יצירת חשבון Google
יש כמה דרכים ליצור חשבון Google שאפשר להוסיף לרשת של Ad Manager.
אפשרות 1: יוצרים חשבון שירות OAuth2, שיוצר עבורכם כתובת אימייל של חשבון שירות שמתפקד כחשבון Google. הוראות ליצירת חשבון שירות חדש
אפשרות 2: אפשר ליצור חשבון Google רגיל (חשבון Gmail) על ידי הרשמה כמשתמש חדש. אם כבר יש לכם חשבון Google, השלימו את ההרשמה בחלון פרטי או בסשן חדש בדפדפן. לחלופין, אם החברה שלכם משתמשת ב-Google Workspace, אתם יכולים ליצור חשבון Google בדומיין של החברה ולהשתמש בו במקום זאת. למטרות מדריך זה, נתייחס לשני החשבונות כאל חשבון Google "רגיל".
2. מבקשים מהלקוח להוסיף את חשבון Google שלך לרשת שלו
אחרי שמקבלים חשבון Google כדי לגשת לרשת של הלקוח, מבקשים ממנו להוסיף את החשבון כמשתמש חדש ברשת Ad Manager שלו.
אם אתם מספקים להם כתובת אימייל של חשבון שירות OAuth2, צריך להוסיף אותה לרשת שלהם.
אם אתם מספקים לו חשבון Google רגיל, בקשו ממנו להוסיף את החשבון שלכם כמשתמש ברשת שלו.
לא משנה באיזה מסלול תבחרו, חשוב לברר עם הלקוח מהם התפקידים וההרשאות שצריך להקצות לחשבון כדי שהאפליקציה תוכל לגשת לנתונים הדרושים לו ברשת של הלקוח.
עכשיו אפשר להתחיל לבצע קריאות ל-API לרשת Ad Manager של הלקוח. חשוב לוודא שהגדרתם את כותרת ה-SOAP של הרשת לקוד הרשת של הלקוח שמולו אתם מבצעים את הקריאה ל-API. כל ספריות הלקוח שלנו מאפשרות לבצע את ההגדרה באופן פרוגרמטי. לדוגמה, בספריית הלקוח של ads Java, תוכלו להגדיר באופן פרוגרמטי את קוד הרשת כשיוצרים מכונה של DfpSession.
שמירה על עדכניות ה-API
חשוב להתעדכן לגבי גרסאות ה-API שהוצאו משימוש או שיוצאו משימוש, ומתי גרסאות חדשות מתפרסמות. אתם לא רוצים להישמר מפני שגרסה מסוימת נסגרת ולא לשבור את הלקוחות שלכם. לא תמיד אנחנו יכולים לפנות לצדדים שלישיים לגבי הוצאה משימוש וסגירה צפויים, כפי שאנחנו עושים עבור הלקוחות שלנו. לכן מוטלת עליכם האחריות להירשם לאחד משלושת הערוצים העיקריים שלנו לקבלת עדכונים של ה-API, ולשנות את הגדרות ההתראות:
בנוסף, אנחנו מספקים לוח זמנים להוצאה משימוש באתר למפתחים, וכדאי לעקוב אחריו באופן קבוע.
קבלת תמיכה
אם תיתקלו בבעיות בשילוב Ad Manager, אנחנו מציעים את ערוצי התמיכה הבאים בהתאם לבעיה. אם יש לכם שאלה ברמת המוצר, תוכלו להשיב עליה בפורומי המוצרים של Ad Manager. אם יש לכם שאלה ספציפית ל-API, תוכלו לקרוא אותה בפורומים של Ad Manager API. עיינו בפוסט בבלוג הזה כדי לקבל טיפים שיעזרו לכם להבחין אם שאלה מסוימת ברמת המוצר או שאלה ספציפית ל-API.