نسبت دادن نصب‌های iOS با SKAdNetwork

Google Exchange از سیگنال‌هایی پشتیبانی می‌کند که «کیت توسعه نرم‌افزار آگهی‌های Google Mobile» برای شروع اسناد SKAdNetwork با میانای برنامه‌سازی کاربردی SKAdNetwork Apple استفاده می‌کند. می‌توانید با سیگنال‌های SKAdNetwork ادغام کنید تا به تبلیغ‌کنندگان اجازه دهید موفقیت پویش‌های «آگهی نصب برنامه» را برای دستگاه‌های iOS اندازه‌گیری کنند و درعین‌حال حریم خصوصی کاربر را حفظ کنند.

فهرست زیر نحوه تغییر رفتار اسناد نصب برنامه را بسته به نسخه SKAdNetwork پوشش می‌دهد:

• ۲.۰-۲.۱: ارجاع برای نصب برنامه تبلیغ‌شده توسط صفحه محصول App Store ارائه‌شده توسط StoreKit هدایت می‌شود، وقتی کاربر روی آگهی شما کلیک می‌کند، منجر به نصب برنامه توسط کاربر می‌شود.
• نسخه ۲.۲ و بالاتر: پشتیبانی بیشتر از آگهی‌های مشاهده‌ای که در آن، ارجاع نصب برنامه تبلیغ‌شده زمانی انجام می‌شود که کاربر برنامه را پس‌از مشاهده آگهی شما نصب کند.

برای کسب اطلاعات بیشتر درباره تفاوت‌های نسخه‌های SKAdNetwork، به یادداشت‌های انتشار SKAdNetwork مراجعه کنید.

پیکربندی شناسه‌های SKAdNetwork در واسط کاربر

برای دریافت درخواست‌های پیشنهاد قیمت حاوی شناسه‌های SKAdNetwork، باید شناسه‌های SKAdNetwork خود را در واسط کاربر «خریداران مجاز» یا «مناقصه باز» مشخص کنید. برای مثال، شناسه SKAdNetwork ممکن است مقداری مثل a1b2c3d4e5.skadnetwork داشته باشد.

برای مشخص کردن شناسه SKAdNetwork در «خریداران مجاز» یا میانای کاربر «مناقصه باز»، کارهای زیر را انجام دهید:

1. در منو پیمایش تنظیمات مناقصه‌گر، روی تنظیمات مناقصه هم‌زمان کلیک کنید. صفحه تنظیمات مناقصه هم‌زمان ظاهر می‌شود.
2. برای مشاهده و پیکربندی شناسه‌های SKAdNetwork، به چارگوش شناسه‌های مجاز SKAdNetwork در iOS بروید.

تصویر زیر نمونه‌ای از شناسه SKADNetwork را در چارگوش شناسه‌های مجاز SKAdNetwork در iOS نشان می‌دهد:

پیکربندی طرح‌آگهی‌ها برای ارجاع

«کیت توسعه نرم‌افزار آگهی‌های Google Mobile» فقط درصورتی ارجاع SKAdNetwork را آغاز می‌کند که نشانی وب کلیک‌گذری در Apple App Store فرود آید. وقتی بااستفاده از Real-time Bidding API طرح‌های آگهی را برای بازبینی ارسال می‌کنید، طرح‌های آگهی باید از نشانی وب کلیک‌گذری استفاده کنند که یا پیوند مستقیم به برنامه تبلیغ‌شده در App Store باشد یا از تغییرمسیرهای HTTP استفاده کند که مقصد نهایی آن برنامه تبلیغ‌شده در App Store باشد. اگر مقصد نهایی نشانی وب کلیک‌گذری طرح آگهی شما با هریک از پیشوندهای زیر شروع شود، «کیت توسعه نرم‌افزار تبلیغات تلفن همراه Google» اسناد را آغاز می‌کند:

• https://apps.apple.com
• https://itunes.apple.com
• itms-apps://
• itms://

اگر مقصد نهایی نشانی وب کلیک‌گذری طرح آگهی شما با این پیشوندها مطابقت نداشته باشد، یا نشانی وب کلیک‌گذری شما از روش‌های تغییرمسیر سمت مشتری دیگری استفاده کند که به App Store منتهی نمی‌شود، ممکن است کیت توسعه نرم‌افزار Google Mobile Ads اسناد SKAdNetwork را آغاز نکند. فهرست زیر شامل نمونه‌هایی است که ممکن است این فرایند در آن‌ها اعمال شود:

• صفحه HTML که برای هدایت به فروشگاه برنامه به کنش کاربر نیاز دارد.
• صفحه HTML که دارای دستورگان هدایت خودکار مبتنی بر جاوا اسکریپت به فروشگاه برنامه است.
• برچسب‌های بازآوری متا.

شروع اسناد براساس نوع طرح‌آگهی

کنش کلیک برای شروع اسناد SKAdNetwork را می‌توان برای انواع مختلف طرح‌آگهی به‌صورت زیر راه‌اندازی کرد:

HTML

این نشانی وب را می‌توان به‌عنوان نشانی وب مقصد در برچسب‌های لنگر اطراف عنصر کلیک‌کردنی، یا به‌عنوان نشانی وب هدف عملیات window.location از رویدادهای کلیک‌کردنی مبتنی بر جاوا اسکریپت تنظیم کرد.

MRAID

کنش کلیک باید Mraid.open() را فراخوانی کند تا اسناد SKAdNetwork آغاز شود.

ویدیو VAST

نشانی وب فروشگاه برنامه باید در عنصر ClickThrough در VAST XML تنظیم شود.

بومی

نشانی وب فروشگاه برنامه باید در فیلد BidResponse.seatbid.bid.{adm/adm_native}.link.url تنظیم شود.

شناسایی BidRequest نشان

می‌توانید اطلاعات مربوط به شناسه‌های SKAdNetwork ثبت‌شده‌تان را که برنامه ناشر با فیلد BidRequest.imp.ext.skadn پشتیبانی می‌کند پیدا کنید. اگر فیلد skadn مشخص شده باشد، می‌توانید از مشخصه‌ها برای ساختن پاسخ برای آگهی نصب برنامه یا آگهی تعامل مجدد استفاده کنید که نصب یا تبدیل را با یکی از شناسه‌های SKAdNetwork موجود مرتبط می‌کند. فیلد skadn یک شیء SKAdNetworkRequest با مشخصه‌های زیر است:

مثال زیر درخواست قیمت پیشنهادی برای فضای آگهی تلفن همراه را نشان می‌دهد که در آن برنامه ناشر از شناسه‌های SKAdNetwork شما پشتیبانی می‌کند:

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "imp": [
    {
      "id": "1",
      // OMITTED...
      "ext": {
        // OMITTED...
        "skadn": {
          "sourceapp": "com.google.testapp",
          "skadnetids": [
            "cF58w81X"
          ],
          "versions": [
            "2.0",
            "2.1",
            "4.0"
          ],
          "fidelities": [
            1,
            0
          ]
        }
        // OMITTED...
      }
    }
  ],
  "app": {
    "name": "Test App",
    "ver": "5.6.0",
    "bundle": "com.google.testapp",
    "publisher": {
      "id": "pub-6156239328255091",
      "ext": {
        "country": "JP"
      }
    },
    "content": {
      "url": "https://www.google.com",
      "livestream": 0,
      "language": "ja"
    },
    "storeurl": "https://www.google.com"
  }
  // OMITTED...
}

پر کردن BidResponse فیلد

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

باید اطلاعات ارجاعی را که با آنچه در درخواست پیشنهاد قیمت گنجانده شده است مطابقت دارد ارسال کنید. اطلاعات ارجاع در فیلد BidResponse.seatbid.bid.ext.skadn مشخص شده است که یک شیء SKAdNetworkResponse با مشخصه‌های زیر است:

نمونه زیر پاسخ پیشنهادی را نشان می‌دهد که شامل اطلاعات اسناد نصب برنامه است:

{
  "id": "9NaI48SmPW7Zf3MAHR43DY",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9NaI48SmPW7Zf3MAHR43DY",
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              "version": "4.0",
              "network": "cF58w81X",
              "itunesitem": "788729094",
              "sourceapp": "1422994973",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "11iF1L96q2cw8tu790p301c10530ogr7h250k1P9pLxqcJ2qe37klG8xB3M592YbpafQ9861493838C521XA6AEF4A40DK8X"
                },
                {
                  "fidelity": 1,
                  "nonce": "017e597c-3c7d-4a44-afeb-41cd9a17066f",
                  "timestamp": "1757235407882",
                  "signature": "f67L3C138Y6XB7940141011Pd58AZbdBk9Xo1Mlf1973706DsB5808ILLKumU2ic9fr72b9bSs3CD25CCZo8DJB65JB0615L"
                }
              ],
              "sourceidentifier": "5507"
            },
            "app_promotion_type": 1
            // OMITTED...
          }
        }
      ]
      // OMITTED...
    }
  ]
  // OMITTED...
}

فهرست زیر رفتار موردانتظار SKAdNetwork را در پاسخ به پیشنهاد قیمت نشان می‌دهد:

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

افزایش ارجاع با SKOverlay

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

وقتی همه شرایط زیر برآورده شود، ارجاع نصب برنامه تبلیغ‌شده را دریافت می‌کنید:

• SKOverlay شما برای سه ثانیه یا بیشتر نمایش داده می‌شود.
• برنامه تبلیغ‌شده ظرف ۳۰ روز پس‌از نمایش SKOverlay شما نصب شده باشد.
• SKOverlay شما آخرین موردی بود که قبل‌از نصب برنامه تبلیغ‌شده نمایش داده شد.

Google از SKOverlay برای قطعه HTML و طرح‌آگهی‌های ویدیویی VAST که در آگهی‌های تمام‌صفحه یا پاداشی قرار داده شده‌اند پشتیبانی می‌کند.

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

وقتی درخواست پیشنهاد قیمت دریافت می‌کنید، می‌توانید با بررسی مقدار فیلد BidRequest.imp.ext.skadn.skoverlay ببینید آیا SKOverlay پشتیبانی می‌شود یا نه. SKOverlay در مواردی پشتیبانی می‌شود که فیلد skoverlay روی true برای نقاط پایانی پیشنهاد قیمت بااستفاده از قالب OpenRTB Protobuf، یا 1 برای نقاط پایانی پیشنهاد قیمت بااستفاده از قالب OpenRTB JSON تنظیم شده باشد.

آگهی‌تان را با SKOverlay قرار دهید

وقتی SKOverlay پشتیبانی می‌شود، می‌توانید فیلد BidResponse.seatbid.bid.ext.skadn.skoverlay را مشخص کنید تا نشان دهید می‌خواهید SKOverlay نمایش داده شود. فیلد skoverlay دارای مشخصه‌های زیر است:

• delay: عدد صحیحی که نشان‌دهنده تأخیر برحسب ثانیه بین زمان نمایش آگهی و زمان نمایش SKOverlay است. برای طرح‌آگهی‌های ویدیویی، زمان نمایش زمانی است که ویدیو شروع به پخش می‌کند. اگر این فیلد تنظیم نشده باشد، SKOverlay نشان داده نمی‌شود.
• endcarddelay: عدد صحیحی که نشان‌دهنده تأخیر (به ثانیه) بین زمان نمایش کارت پایان طرح آگهی ویدیویی و زمان نمایش SKOverlay است. اگر این فیلد تنظیم نشده باشد، SKOverlay پس‌از کارت پایان نشان داده نخواهد شد. فقط برای طرح‌آگهی‌های ویدیویی VAST که در آگهی‌های بینابینی یا پاداشی قرار داده شده‌اند قابل‌اجرا است.
• dismissible: بولی نشان‌دهنده اینکه آیا SKOverlay می‌تواند توسط کاربر بسته شود یا نه.

مثال زیر پاسخ قیمت پیشنهادی را نشان می‌دهد:

{
  // OMITTED...
  "seatbid": [
    {
      "bid": [
        {
          // OMITTED...
          "ext": {
            // OMITTED...
            "skadn": {
              // OMITTED...
              "itunesitem": "422689480",
              "skoverlay": {
                "delay": 5,
                "endcarddelay": 0
              },
              "productpageid": "some_id"
            }
          }
        }
      ]
    }
  ]
}

مرور رفتار موردانتظار SKOverlay

در اینجا رفتار موردانتظار SKOverlay مربوط به پاسخ درخواست قیمت قبلی آمده است:

• SKOverlay را پنج ثانیه پس‌از شروع ویدیو نشان دهید.
• SKOverlay را بلافاصله پس‌از کارت پایان نشان دهید.

• وقتی کاربر روی SKOverlay کلیک می‌کند، فروشگاه برنامه را باز کنید.

• اگر BidResponse.seatbid.bid.ext.skadn.productpageid مشخص شده باشد، داده‌های فهرستگان برنامه در SKOverlay همان نماد موجود در صفحه محصول سفارشی است.

• برای طرح‌آگهی‌های ویدیویی VAST، وقتی کاربر روی SDKoverlay کلیک می‌کند، نشانی‌های وب کلیک مستقیم و ردیابی کلیک پینگ می‌شوند.

• برای طرح‌های آگهی ویدیویی VAST، حتی اگر کاربر SKOverlay را درطول ویدیو ببندد، اگر فیلد BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay تنظیم شده باشد، SKOverlay همچنان پس‌از کارت پایان نشان داده می‌شود.