این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

با برچسب ناشر Google شروع کنید

Google Publisher Tag (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 را بارگیری کنید
با افزودن موارد زیر به <head> سند HTML، کتابخانه GPT را بارگیری کنید.
این کد کتابخانه 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>
```
یک جایگاه تبلیغاتی را تعریف کنید
با استفاده از متد googletag.enableServices() یک اسلات تبلیغاتی تعریف کنید و GPT را مقداردهی کنید.
این کد ابتدا اطمینان می‌دهد که شی 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 از Display a test ad استفاده کنید، سپس کد موجود در سربرگ را با کد مشخص کننده موجودی از شبکه 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 به روز شده را ذخیره کرده و در یک مرورگر وب باز کنید.