תחילת העבודה עם Google Publisher Tag

תג Google לבעלי תוכן דיגיטלי (GPT) הוא ספריית תיוג של מודעות עבור Google Ad Manager.

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

לפרטים נוספים על GPT, ראו את מרכז העזרה של Ad Manager.

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

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

הדוגמה הבאה מלמדת איך ליצור דף בדיקה משתמשת ב-GPT כדי לטעון מודעה גנרית מרשת הבדיקה של Google.

ניתן למצוא את הקוד המלא עבור הדוגמה הזו בקטע להציג דף לדוגמה של מודעת בדיקה.

יצירת מסמך HTML בסיסי

בכלי לעריכת טקסט, יוצרים מסמך HTML בסיסי בשם hello-gpt.html.

<!doctype html>
<html>
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta name="description" content="Display a fixed-sized test ad." />
    <title>Display a test ad</title>
    <style></style>
  </head>
  <body>
  </body>
</html>

טעינת ספריית GPT

טוענים את ספריית ה-GPT על ידי הוספת הפרטים הבאים אל <head> של מסמך ה-HTML.

הקוד הזה טוען את ספריית ה-GPT מ- https://securepubads.g.doubleclick.net/tag/js/gpt.js. אחרי שהספרייה מלאה, היא מעבדת את כל הפקודות שממתינות בתור אובייקט googletag.

חשוב: צריך לטעון GPT מדומיין של Google בלבד.
```
<head>
  <meta charset="utf-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <meta name="description" content="Display a fixed-sized test ad." />
  <title>Display a test ad</title>
  <script
    async
    src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"
    crossorigin="anonymous"
  ></script>
  <style></style>
</head>
```
הגדרה של מיקום מודעה בדף

מגדירים מיקום מודעה ומפעילים GPT באמצעות googletag.enableServices().

הקוד הזה מבטיח שאובייקט googletag יהיה זמין, ואז מוסיף שבונה מיקום מודעה ומפעילה GPT.

מיקום המודעה בדוגמה הזו יטען מודעה בגודל 300x250 מהמודעה יחידה שצוינה באמצעות נתיב /6355419/Travel/Europe/France/Paris. המודעה תהיה מוצגת ברכיב <div id="banner-ad"> בגוף הדף, יתווסף בשלב הבא.
הנתיב של יחידת המודעות תואם לפורמט /network-code/[parent-ad-unit-code/.../]ad-unit-code, איפה:
- network-code הוא מזהה ייחודי של רשת Ad Manager שאליה שייכת יחידת המודעות
- parent-ad-unit-code הם הקודים של כל יחידות המודעות הראשיות (רק חל על יחידות מודעות שאינן ברמה העליונה)
- ad-unit-code הוא הקוד של יחידת המודעות להצגה
שימו לב שכל הקודים של יחידות המודעות בנתיב של יחידת המודעות חייבים לעמוד בדרישות של כללי הפורמט שצוינו על ידי Ad Manager.
```
<head>
  <meta charset="utf-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <meta name="description" content="Display a fixed-sized test ad." />
  <title>Display a test ad</title>
  <script
    async
    src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"
    crossorigin="anonymous"
  ></script>
  <script>
    window.googletag = window.googletag || { cmd: [] };

    googletag.cmd.push(() => {
      // Define an ad slot for div with id "banner-ad".
      googletag
        .defineSlot("/6355419/Travel/Europe/France/Paris", [300, 250], "banner-ad")
        .addService(googletag.pubads());

      // Enable the PubAdsService.
      googletag.enableServices();
    });
  </script>
  <style></style>
</head>
```
ציון המיקום שבו המודעה תוצג

יש לציין איפה המודעה תופיע בדף. לשם כך, יש להוסיף את הקוד הבא: <body> של מסמך ה-HTML.

חשוב לשים לב שהמזהה של ה<div> הזה תואם למזהה שצוין כשהגדרת את מיקום המודעה בדף.
```
<body>
  <div id="banner-ad" style="width: 300px; height: 250px"></div>
  <script>
    googletag.cmd.push(() => {
      // Request and render an ad for the "banner-ad" slot.
      googletag.display("banner-ad");
    });
  </script>
</body>
```
תצוגה מקדימה של דף הבדיקה

שומרים את הקובץ hello-gpt.html ופותחים אותו בדפדפן אינטרנט. לאחר הטעינה, הדף יציג מודעת בדיקה בגוף דף האינטרנט.

זהירות: אם לא מופיעה מודעה, צריך לוודא שמזהה ה-div שצוין <head> מהדף תואם למזהה של הרכיב <div> שהוספת אליו <body> בדף.

הצגת מודעה משלכם

כדי להציג מודעה משלך, אפשר להשתמש בקובץ hello-gpt.html מהקטע הצגת בדיקה מודעה, ואז מחליפים את הקוד שבכותרת בקוד שמציין מלאי שטחי פרסום מרשת Ad Manager שלכם.

ליצור תג מודעה עבור יחידת המודעות שרוצים להציג. מידע נוסף על שיצרה תגי מודעות מרכז העזרה של Ad Manager.

מעתיקים את הקוד של תג המודעה שמופיע בקטע כותרת המסמך ומשתמשים בו כדי להחליף את הקוד התואם ב-<head> של מסמך ה-HTML.

<head>
  <meta charset="utf-8">
  <title>Hello GPT</title>
  <script src="https://securepubads.g.doubleclick.net/tag/js/gpt.js" crossorigin="anonymous" async></script>
  <script>
    window.googletag = window.googletag || {cmd: []};
    googletag.cmd.push(function() {
      googletag
          .defineSlot("ad-unit-path", [width, height], "div-id")
          .addService(googletag.pubads());
      googletag.enableServices();
    });
  </script>
</head>

שומרים את הקובץ hello-gpt.html המעודכן ופותחים אותו בדפדפן אינטרנט.

העקרונות הבסיסיים