بدء استخدام علامة "ناشر Google"

إنّ علامة "ناشر Google" (GPT) هي مكتبة لوضع علامات على الإعلانات في "مدير إعلانات Google".

يمكنك استخدام علامة "ناشر Google" لإنشاء طلبات الإعلانات ديناميكيًا. تأخذ علامة GPT التفاصيل الرئيسية، مثل رمز الوحدة الإعلانية، وحجم الإعلان، والاستهداف المخصّص، وتُنشئ الطلب، وتعرض الإعلان على صفحات الويب.

للحصول على مزيد من التفاصيل عن GPT، يمكنك الاطّلاع على مركز مساعدة "مدير الإعلانات".

في ما يلي بعض النماذج التي يمكنك استخدامها لبدء استخدام GPT. إذا كنت بحاجة إلى مزيد من المساعدة بشأن علامة GPT، يُرجى الاطّلاع على خيارات الدعم.

عرض إعلان اختباري

يرشدك المثال التالي خلال عملية إنشاء صفحة اختبارية تستخدم علامة "ناشر Google" لتحميل إعلان عام من شبكة اختبار Google.

يمكن العثور على الرمز الكامل لهذا المثال في نموذج صفحة عرض إعلان اختباري.

  1. إنشاء مستند 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>
        <script>
          googletag.cmd.push(() => {
            // Request and render an ad for the "banner-ad" slot.
            googletag.display("banner-ad");
          });
        </script>
      </body>
    </html>
    
  2. تحميل مكتبة علامة "ناشر Google"

    حمِّل مكتبة GPT بإضافة ما يلي إلى <head> في مستند HTML.

    يُحمِّل هذا الرمز مكتبة GPT من https://securepubads.g.doubleclick.net/tag/js/gpt.js. بعد تحميل المكتبة بالكامل، تعالج المكتبة أي أوامر في قائمة الانتظار في الكائن googletag.

    <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"></script>
      <style></style>
    </head>
    
  3. تحديد شريحة إعلانية

    حدِّد شريحة إعلانية واضبط جدول تقسيم المعرّف الفريد العمومي باستخدام طريقة googletag.enableServices().

    يضمن هذا الرمز أولاً توفُّر كائن googletag، ثم يضع الأمر في قائمة انتظار لإنشاء خانة إعلانية وتفعيل GPT.

    ستقوم الشريحة الإعلانية في هذا المثال بتحميل إعلان بحجم 300x250 من الوحدة الإعلانية المحددة في المسار /6355419/Travel/Europe/France/Paris. سيتم عرض الإعلان في عنصر <div id="banner-ad"> في النص الأساسي للصفحة، وستتم إضافته بعد ذلك.

    <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"></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>
    
  4. تحديد مكان ظهور الإعلان

    حدِّد مكان ظهور الإعلان على الصفحة عن طريق إضافة الرمز التالي إلى <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>
    
  5. معاينة الصفحة التجريبية

    احفظ ملف hello-gpt.html وافتحه في متصفّح ويب. بعد تحميل الصفحة، ستعرض إعلانًا تجريبيًا في النص الأساسي لصفحة الويب.

عرض إعلانك

لعرض إعلانك الخاص، استخدِم الملف hello-gpt.html من عرض إعلان اختباري، ثم استبدل الرمز الوارد في العنوان برمز يحدّد المستودع الإعلاني من شبكة "مدير الإعلانات" الخاصة بك.

  1. أنشئ علامة إعلان للوحدة الإعلانية التي تريد عرضها. اطّلِع على مزيد من المعلومات عن إنشاء علامات الإعلانات في مركز مساعدة "مدير الإعلانات".

  2. انسخ رمز علامة الإعلان المقدَّم في قسم عنوان المستند واستخدِمه لاستبدال الرمز المقابل في <head> من مستند HTML.

    <head>
     <meta charset="utf-8">
     <title>Hello GPT</title>
     <script async src="https://securepubads.g.doubleclick.net/tag/js/gpt.js"></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>
    
  3. احفظ ملف hello-gpt.html المعدّل وافتحه في متصفّح ويب.