تحديد مصدر عمليات التثبيت على أجهزة iOS باستخدام SKAdNetwork

يتيح Google Ad Exchange استخدام الإشارات التي تستخدمها حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" لبدء تحديد المصدر في SKAdNetwork من خلال واجهة برمجة التطبيقات SKAdNetwork من Apple. يمكنك التكامل مع إشارات SKAdNetwork للسماح للمعلنين بقياس مدى نجاح حملات إعلانات تثبيت التطبيقات على أجهزة iOS مع الحفاظ على خصوصية المستخدمين.

توضّح القائمة التالية كيفية تغيُّر سلوك تحديد مصدر تثبيت التطبيق حسب إصدار SKAdNetwork:

  • الإصداران 2.0 و2.1: يتم تحديد مصدر تثبيت التطبيق المُعلَن عنه من خلال صفحة المنتج في "متجر التطبيقات" التي يعرضها StoreKit عندما ينقر المستخدم على إعلانك، ما يؤدي إلى تثبيت المستخدم للتطبيق.
  • الإصدار 2.2 والإصدارات الأحدث: دعم إضافي لإعلانات المشاهدة المكتملة، حيث يتم تحديد مصدر تثبيت التطبيق المُعلَن عنه عندما يثبّت المستخدم التطبيق بعد مشاهدة إعلانك.

لمزيد من المعلومات عن الاختلافات في إصدارات SKAdNetwork، يُرجى الاطّلاع على ملاحظات إصدار SKAdNetwork.

ضبط معرّفات SKAdNetwork في واجهة المستخدم

لتلقّي طلبات عروض أسعار تحتوي على معرّفات SKAdNetwork، عليك تحديد معرّفات SKAdNetwork في واجهة مستخدم "الشراة المعتمَدون" أو "عرض الأسعار المفتوح". على سبيل المثال، قد يكون لمعرّف SKAdNetwork قيمة مثل a1b2c3d4e5.skadnetwork.

لتحديد معرّف SKAdNetwork في واجهة مستخدم "الشراة المعتمَدون" أو "عرض الأسعار المفتوح"، اتّبِع الخطوات التالية:

  1. في قائمة التنقّل إعدادات مقدِّم عرض السعر، انقر على إعدادات عروض الأسعار في الوقت الفعلي. ستظهر لك صفحة إعدادات RTB.
  2. انتقِل إلى مربّع معرّفات SKAdNetwork المسموح بها على iOS لعرض معرّفات SKAdNetwork وضبطها.

تعرض الصورة التالية مثالاً على معرّف SKADNetwork في مربّع معرّفات SKAdNetwork المسموح بها على iOS:

إعداد "أرقام تعريف SKAdNetwork المسموح بها في iOS" ضمن إعدادات "عرض الأسعار في الوقت الفعلي"

ضبط تصاميم الإعلانات لتحديد المصدر

تبدأ حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" عملية تحديد مصدر الإحالة الناجحة في SKAdNetwork فقط إذا كان عنوان URL للنقرة يؤدي إلى متجر تطبيقات Apple. عند إرسال تصاميم الإعلانات للمراجعة باستخدام واجهة برمجة التطبيقات لعرض الأسعار في الوقت الفعلي، يجب أن تستخدم تصاميم الإعلانات عنوان URL للنقرة يكون إما رابطًا مباشرًا إلى التطبيق المُعلن عنه في App Store، أو يستخدم عمليات إعادة توجيه HTTP حيث تكون الوجهة النهائية هي التطبيق المُعلن عنه في App Store. تبدأ حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" عملية تحديد المصدر إذا كانت الوجهة النهائية لعنوان URL للنقرة في تصميم إعلانك تبدأ بأي من البادئات التالية:

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

إذا كانت الوجهة النهائية لعنوان URL للنقرة في تصميم إعلانك لا تتطابق مع هذه البادئات، أو إذا كان عنوان URL للنقرة يستخدم أي طرق أخرى لإعادة التوجيه من جهة العميل لا تؤدي إلى متجر التطبيقات، قد لا تبدأ حزمة "SDK لإعلانات Google على الأجهزة الجوّالة" عملية تحديد المصدر في SKAdNetwork. تغطي القائمة التالية أمثلة على الحالات التي قد تنطبق عليها هذه العملية:

  • صفحة HTML تتطلّب من المستخدم اتّخاذ إجراء لإعادة التوجيه إلى متجر التطبيقات
  • صفحة HTML تحتوي على نص برمجي آلي لإعادة التوجيه إلى متجر التطبيقات، ويستند هذا النص إلى JavaScript.
  • علامات إعادة التحميل الوصفية

بدء تحديد المصدر حسب نوع التصميم

يمكن إعداد إجراء النقر لبدء تحديد المصدر في SKAdNetwork لأنواع التصاميم المختلفة على النحو التالي:

HTML
يمكن إعداد ذلك كعنوان URL المقصود في علامات الارتساء المحيطة بالعنصر القابل للنقر، أو كعنوان URL المستهدف لعمليات window.location من الأحداث الناتجة عن النقر المستندة إلى JavaScript.
MRAID
يجب أن يستدعي إجراء النقر Mraid.open() لبدء تحديد مصدر SKAdNetwork.
فيديو VAST
يجب ضبط عنوان URL لمتجر التطبيقات في العنصر ClickThrough في ملف XML الخاص بنموذج عرض إعلانات الفيديو (VAST).
مدمج مع المحتوى
يجب ضبط عنوان URL لمتجر التطبيقات في الحقل BidResponse.seatbid.bid.{adm/adm_native}.link.url.

تحديد إشارات BidRequest

يمكنك العثور على معلومات حول معرّفات SKAdNetwork المسجّلة التي يتيحها تطبيق الناشر في الحقل BidRequest.imp.ext.skadn. في حال تحديد الحقل skadn، يمكنك استخدام السمات لإنشاء استجابة لإعلان تثبيت تطبيق أو إعلان إعادة تفاعل يربط عملية تثبيت أو إحالة ناجحة بأحد معرّفات SKAdNetwork المضمّنة. الحقل skadn هو عنصر SKAdNetworkRequest يتضمّن السمات التالية:

اسم السمة الوصف
sourceapp معرّف سلسلة لتطبيق الناشر في متجر تطبيقات Apple. لتحديد تطبيق الناشر، استخدِم هذه السمة.
skadnetids قائمة بالسلاسل التي تمثّل معرّفات SKAdNetwork التي يتيحها تطبيق الناشر يمكنك الرجوع إلى هذه القائمة عند إنشاء الردّ لاختيار معرّف SKAdNetwork يتيحه الناشر لتحديده في الحقل BidResponse.seatbid.bid.ext.skadn.network.
versions قائمة بالسلاسل التي تمثّل إصدارات SKAdNetwork التي يتيحها الناشر يجب أن يكون إصدار SKAdNetwork الذي تحدّده في ردّك باستخدام الحقل BidResponse.seatbid.bid.ext.skadn.version أحد الإصدارات التي يحدّدها هذا الحقل.
fidelities قائمة بقيم تعداد SKAdNetworkFidelityType التي تمثّل أنواع الدقة التي يتيحها الناشر في ما يلي وصف لقيم التعداد هذه لنقاط نهاية عروض الأسعار التي تم ضبطها لاستخدام OpenRTB بتنسيقَي Protobuf وJSON:
  • ‫VIEW_THROUGH_ADS (Protobuf) / 0 (JSON): عندما تفوز في المزاد وتعرض إعلانًا، يمكن تلقّي مصدر الظهور خلال 24 ساعة، وذلك عندما تتم مشاهدة الإعلان لمدة ثلاث ثوانٍ على الأقل. يجب بشكل عام عرض SKOverlay إذا كان متاحًا للمعلن من أجل تلقّي هذا الشكل من تحديد المصدر.
  • ‫STOREKIT_RENDERED_ADS (Protobuf) / 1 (JSON): عندما تفوز في المزاد وتعرض إعلانًا، يتم تحديد مصدر تثبيت التطبيق أو الإحالة الناجحة من خلال صفحة المنتج في متجر التطبيقات التي يعرضها StoreKit عندما ينقر المستخدم على الإعلان.
skoverlay قيمة منطقية عند تمثيلها بتنسيق OpenRTB Protobuf، أو عدد صحيح عند تمثيلها بتنسيق OpenRTB JSON. يمكنك استخدام هذه القيمة المنطقية لتحديد ما إذا كان SKOverlay متاحًا. تتيح Google استخدام SKOverlay فقط لمقتطفات الفيديو وHTML الموضوعة على المساحات الإعلانية المتاحة لـ "الإعلانات البينية" أو "الإعلانات مقابل مكافأة".

يوضّح المثال التالي طلب عرض سعر لمساحة إعلانية متاحة على الأجهزة الجوّالة حيث يتوافق تطبيق الناشر مع معرّفات 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 يتضمّن السمات التالية:

اسم السمة الوصف
version سلسلة تمثّل إصدار SKAdNetwork متوافق مع المعلِن. يجب تحديد أحد إصدارات SKAdNetwork التي يتيحها الناشر، والمحدّدة في BidRequest.imp.ext.skadn.versions.
network معرّف SKAdNetwork نصي للمعلِن. يجب تحديد أحد معرّفات SKAdNetwork المضمّنة في BidRequest.imp.ext.skadn.skadnetids.
campaign معرّف سلسلة رقمية مكوّن من رقمَين يمثّل الحملة الإعلانية للمعلِن. يجب تحديد هذه السمة بدلاً من sourceidentifier إذا كانت الاستجابة لعرض السعر تتضمّن معلومات تحديد المصدر باستخدام الإصدار 3.0 من SKAdNetwork أو الإصدارات الأقدم.
sourceidentifier ‫ID سلسلة رقمية مكوّنة من أربعة أرقام تمثّل الحملة الإعلانية للمعلِن يجب تحديد هذه السمة بدلاً من campaign إذا كانت الاستجابة لعرض السعر تتضمّن معلومات تحديد المصدر باستخدام الإصدارات 4.0 أو الأحدث من SKAdNetwork.
itunesitem رقم تعريف سلسلة لتطبيق المعلِن في متجر تطبيقات Apple. يجب أن تكون هذه القيمة متوافقة مع القيمة المحدّدة في BidResponse.seatbid.bid.bundle.
productpageid معرّف سلسلة اختياري يمثّل صفحة منتج مخصّصة لعرضها على الأجهزة التي تعمل بنظام التشغيل iOS 15 أو الإصدارات الأحدث. لمزيد من المعلومات حول صفحات المنتجات المخصّصة، يُرجى الاطّلاع على صفحات المنتجات المخصّصة على متجر التطبيقات. وفي حال عدم تحديدها، سيتم عرض صفحة المنتج التلقائية.
fidelities قائمة بعناصر Fidelity تحدّد أنواع الدقة التي تنطبق على الإعلان المعروض، وتوفّر توقيعات تشفيرية تُستخدَم لتحديد حملة المعلِن عندما يتلقّى المعلِن إشعارًا بتسجيل الإحالات الناجحة. يجب تحديد سمة fidelity فقط باستخدام القيم المضمّنة في BidRequest.imp.ext.skadn.fidelities.
sourceapp سلسلة تمثّل تطبيق الناشر في Apple App Store. يجب تحديد ذلك باستخدام المعرّف المتوفّر في BidRequest.imp.ext.skadn.sourceapp.
skoverlay عنصر SKOverlay يمثّل كيفية عرض التطبيق المُعلَن عنه في SKOverlay. لا يمكنك تحديد هذه السمة إلا عند ضبط BidRequest.imp.ext.skadn.skoverlay على true لنقاط نهاية عروض الأسعار التي تستخدم تنسيق OpenRTB Protobuf، أو 1 عند استخدام تنسيق OpenRTB JSON.

يعرض المثال التالي استجابة لعرض سعر تتضمّن معلومات تحديد مصدر تثبيت التطبيق:

{
  "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 وفقًا للاستجابة لعرض السعر:

  • عندما يتم تثبيت التطبيق المُعلَن عنه خلال 24 ساعة من مشاهدة الإعلان لمدة ثلاث ثوانٍ على الأقل، يتم إرسال إشعار تسجيل الإحالات الناجحة بعد المشاهدة المكتملة في SKAdNetwork إلى المعلِن.
  • عند النقر على الإعلان، يظهر تراكب متجر مضمّن للتطبيق المُعلن عنه، ويتم إرسال إشعار تسجيل الإحالات الناجحة من خلال النقر على SKAdNetwork إلى المعلن إذا قام المستخدم بتثبيت التطبيق المُعلن عنه وفتحه.

زيادة نسبة تحديد المصدر باستخدام SKOverlay

يمكنك زيادة نسبة الإسهام للإعلانات التي يتم عرضها من خلال StoreKit من خلال عرض SKOverlay عندما يكون SKOverlay متاحًا. تتيح SKOverlay لتطبيق الناشر عرض تراكب يتيح للمستخدمين تنزيل التطبيق المُعلن عنه بدون مغادرة تطبيق الناشر. لمزيد من المعلومات حول SKOverlay، يُرجى الاطّلاع على SKOverlay.

عند استيفاء جميع الشروط التالية، يتم تحديد مصدر تثبيت التطبيق المُعلَن عنه:

  • يتم عرض SKOverlay لمدة ثلاث ثوانٍ أو أكثر.
  • يتم تثبيت التطبيق المُعلَن عنه خلال 30 يومًا من عرض SKOverlay.
  • كان SKOverlay آخر ما تم عرضه قبل تثبيت التطبيق المُعلن عنه.

تتيح Google استخدام SKOverlay لمقتطفات HTML وتصاميم إعلانات فيديو VAST التي يتم وضعها في الإعلانات البينية أو الإعلانات التي تضم مكافأة.

تحديد ما إذا كانت SKOverlay متاحة

عند تلقّي طلب عرض سعر، يمكنك معرفة ما إذا كان SKOverlay متاحًا من خلال التحقّق من قيمة الحقل BidRequest.imp.ext.skadn.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)، عندما ينقر المستخدم على تراكب حزمة تطوير البرامج (SDK)، يتم إرسال إشعار إلى عناوين URL الخاصة بنسبة النقر إلى الظهور وعناوين URL للتتبع.

  • بالنسبة إلى تصاميم إعلانات الفيديو التي تستخدم نموذج عرض إعلانات فيديو (VAST)، حتى إذا أغلق المستخدم SKOverlay أثناء عرض الفيديو، سيظلّ SKOverlay يظهر بعد بطاقة النهاية في حال ضبط الحقل BidResponse.seatbid.bid.ext.skadn.skoverlay.endcarddelay.