دریافت اعلان‌های نمایش

هر زمان که گوگل تشخیص دهد بخش‌های داده شما در یک پیشنهاد برنده در حراج پیشنهادهای آنی استفاده شده‌اند و منجر به نمایش آگهی شده‌اند، می‌توانید اعلان‌های نمایش آگهی دریافت کنید. گوگل توصیه می‌کند که برای کسب اطلاعات بیشتر در مورد نحوه استفاده از بخش‌های داده خود، اعلان‌های نمایش آگهی را با هم ادغام کنید. برای فعال کردن اعلان‌های نمایش آگهی با مدیر حساب خود تماس بگیرید.

نقطه پایانی اعلان نمایش خود را پیکربندی کنید

برای دریافت اعلان‌های نمایش تبلیغ، باید یک نقطه پایانی HTTP ایجاد کنید و URL آن را با گوگل به اشتراک بگذارید. می‌توانید URL ای را که اعلان‌های نمایش تبلیغ به آن ارسال می‌شوند، با یکی از گزینه‌های زیر تنظیم کنید:

  1. برای هر فراخوان گزینش بلادرنگ، نشانی اینترنتی (URL) نقطه پایانی اعلان نمایش را تنظیم کنید.
    • شما می‌توانید به صورت پویا URL مورد استفاده برای اعلان‌های نمایش را برای هر فراخوان Curation بلادرنگ که دریافت می‌کنید، با پر کردن فیلد SegmentResponse.burl تنظیم کنید.
    • برای یک فراخوانی Curation در لحظه، باید فیلد SegmentResponse.burl را طوری تنظیم کنید که برای آن فراخوانی، اعلان نمایش (impression notification) دریافت کند. اگر فیلد SegmentResponse.burl پر نشده باشد، هیچ اعلانی برای آن فراخوانی ارسال نخواهد شد، حتی اگر فیلد SegmentResponse.burl در فراخوانی‌های قبلی تنظیم شده باشد.
  2. یک URL نقطه پایانی اعلان نمایش در سطح حساب تنظیم کنید.
    • شما می‌توانید با تماس با مدیر حساب خود، یک آدرس اینترنتی (URL) برای اعلان نمایش در سطح حساب کاربری خود تنظیم کنید. این گزینه در صورتی ایده‌آل است که آدرس اینترنتی (URL) نقطه پایانی شما به ندرت تغییر کند.
    • تمام فراخوان‌های گزینش بلادرنگ از آدرس اینترنتی اعلان نمایش در سطح حساب که برای حساب خود پیکربندی می‌کنید استفاده می‌کنند، مگر اینکه با تنظیم فیلد SegmentResponse.burl برای یک فراخوان گزینش بلادرنگ فردی، آدرس اینترنتی سطح حساب را لغو کنید.

تجزیه اعلان نمایش

اطلاعات ارسال شده در اعلان نمایش آگهی به پیکربندی URL نقطه پایانی اعلان نمایش آگهی شما بستگی دارد. URL نقطه پایانی شما می‌تواند شامل پارامترهای پرس‌وجو باشد و از ماکروها برای درج اطلاعات بیشتر در مورد نحوه استفاده از بخش‌های داده شما توسط پیشنهاد برنده که منجر به نمایش آگهی شده است، استفاده کند.

درک نحوه گسترش ماکروها

اگر آدرس اینترنتی (URL) نقطه پایانی خود را طوری پیکربندی کنید که شامل یک یا چند پارامتر پرس‌وجو باشد که روی یک ماکرو تنظیم شده‌اند، اعلان‌های نمایش که به نقطه پایانی شما ارسال می‌شوند، آن ماکروها را گسترش می‌دهند و ماکروها را با مقادیر مربوطه جایگزین می‌کنند.

برای مثال، می‌توانید یک URL نقطه پایانی اعلان نمایش را طوری پیکربندی کنید که شبیه به شکل زیر باشد:

https://testendpoint.com/impressions?segmentReqId=${SR_ID}&segmentIds=${SEGMENT_IDS}

هنگام دریافت اعلان نمایش، ماکروها جایگزین می‌شوند و باعث می‌شوند URL به شکل زیر درآید:

https://testendpoint.com/impressions?segmentReqId=8Mbl39sMOX5yg1NZgS35ET&segmentIds=test-ds-1|test-ds-2

آشنایی با ماکروهای پشتیبانی‌شده

موارد زیر ماکروهایی هستند که می‌توانید در پارامترهای کوئری URL نقطه پایانی اعلان نمایش قرار دهید. این ماکروها با مقادیری مربوط به پیشنهاد برنده که یک یا چند بخش از داده‌های شما در آن نقش داشته‌اند، جایگزین می‌شوند.

ماکرو توضیحات
${SR_ID} یک شناسه رشته‌ای منحصر به فرد معادل فیلد SegmentRequest.segment_request_id برای فراخوانی Real-time Curation مربوطه. این به درخواست قطعه‌ای اشاره دارد که شما با یک یا چند شناسه قطعه داده که در برنده شدن پیشنهاد نقش داشته‌اند، به آن پاسخ داده‌اید.
${SEGMENT_IDS} فهرستی از شناسه‌های رشته‌ای بخش‌های داده که در برنده شدن پیشنهاد نقش داشته‌اند. هر مورد در فهرست با کاراکتر "|" از هم جدا شده است. برای مثال، این می‌تواند به فهرستی از مقادیر مانند: "segmentId1|segmentId2|segmentId3" گسترش یابد. شناسه هر بخش داده که در فهرست قرار دارد، به شناسه منبع منبع curators.dataSegments مربوطه در API بازار اشاره دارد.
${AUCTION_PRICE} رشته‌ای که قیمت برنده حراج را نشان می‌دهد. این قیمت، هزینه یک نمایش (CPI) است که به صورت میکرو دلار آمریکا بیان می‌شود. برای مثال، پیشنهاد قیمت 5 دلار آمریکا به ازای هر نمایش (CPM) در مزایده آنی، منجر به افزایش ماکروی ${AUCTION_PRICE} به 5000 میکرو دلار آمریکا در اعلان نمایش آنی می‌شود.
${DEAL_ID} شناسه معامله یا بسته‌ای که در مزایده برنده شده است. این یک معامله یا بسته است که یک یا چند شناسه بخش داده شما را هدف قرار می‌دهد، که می‌توان آنها را با ماکروی ${SEGMENT_IDS} شناسایی کرد.
${BUYER_SEAT_ID} شناسه جایگاه خریداری که نمایش را برنده شده است، همانطور که توسط پیشنهاد دهنده در پیشنهاد برنده مشخص شده است. به عنوان مثال، جایگاه‌های خریدار می‌توانند آژانس‌ها یا تبلیغ‌کنندگان باشند.

مراحل بعدی