ضبط عنوان URL لميزة شفافية الإعلانات

يتيح لك عنوان URL الخاص بشفافية الإعلانات تخصيص رمز AdChoices الذي يظهر في إعلانات معيّنة. يظهر هذا الرمز تلقائيًا للمستخدمين من خلال تجربة "الشفافية والتحكّم في الإعلانات" (AT&C) التي تعرضها Google، والتي تتضمّن معلومات مثل المعلِن والإعلان نفسه.

يمكنك الحصول على عنوان URL الخاص بشفافية الإعلان من خلال تقديم طلب عرض الإعلان إلى "SDK لإعلانات Google على الأجهزة الجوّالة"، وتلقّي ردّ يتضمّن عنوان URL الخاص بشفافية الإعلان. بعد تلقّي عنوان URL داخل تطبيقك، يمكنك دمج رمز مخصّص يتوافق مع تصميم إعلاناتك وتقديم تجربة "الموافقة على الإعلانات المخصّصة" الخاصة بك للمستخدمين.

تتناول هذه الصفحة كيفية طلب عنوان URL الخاص بشفافية الإعلان وتحليله والتحقّق من صحته.

المتطلبات الأساسية

قبل المتابعة، تأكَّد من إكمال ما يلي:

  • إعداد "الإعلانات المدمجة مع المحتوى" في تطبيقك، وللحصول على تفاصيل حول هذا النوع من الإعلانات، يُرجى الاطّلاع على مقالة الإعلانات المدمجة مع المحتوى
  • يُرجى طلب الوصول إلى هذه الميزة من خلال قائمة السماح. لطلب إذن الوصول، يُرجى التواصل مع مدير حسابك.
    • إذا لم يكن لديك إذن الوصول، لن تعرض ردودك عنوان URL الخاص بشفافية الإعلان، وسيتم عرض الرمز التلقائي على النحو المنشود.

طلب عنوان URL

لكي تعرض GMA Next-Gen SDK عنوان URL الخاص بشفافية الإعلان، عليك إضافة مَعلمة طلب إضافية في طلبات الإعلانات المدمجة مع المحتوى. تشير هذه المَعلمة إلى أنّ تطبيقك جاهز ومعدّ للتعامل مع رمز مخصّص.

في طلبك، يجب إضافة المفتاح "ad_transparency_url_requested" مع القيمة "1" إلى حزمة تفاصيل إضافية خاصة بالشبكة. لمعرفة تفاصيل حول الميزات الإضافية في الشبكة، يُرجى الاطّلاع على setGoogleExtrasBundle .

يضبط المثال التالي هذا المفتاح والقيمة لطلب عنوان URL الخاص بشفافية الإعلان:

جافا 

private void loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation.
  Bundle extras = new Bundle();
  extras.putString("ad_transparency_url_requested", "1");
  NativeAdRequest adRequest = new NativeAdRequest.Builder("AD_UNIT_ID", List.of(NativeAdType.NATIVE))
      .setGoogleExtrasBundle(extras)
      .build();
}

Kotlin 

private fun loadNativeAd() {
  // Create an extra parameter that signals your AT&C implementation
  val extras = Bundle()
  extras.putString("ad_transparency_url_requested", "1");
  val adRequest = NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
}

استبدِل AD_UNIT_ID برقم تعريف وحدتك الإعلانية. على سبيل المثال، ca-app-pub-3940256099942544/2247696110، بالنسبة إلى "الإعلانات المدمجة مع المحتوى".

تحليل عنوان URL

بعد طلب عنوان URL، تتلقّى استجابة الإعلان التي تتضمّن عنوان URL الخاص بمعلومات الشفافية في الإعلان ضمن عنصر معلومات الرد. للحصول على تفاصيل حول عنصر معلومات الردّ، يُرجى الاطّلاع على معلومات الردّ.

يمكنك الوصول إلى عنوان URL الخاص بالشفافية عن الإعلانات ضمن المفتاح "ad_transparency_url" من تفاصيل إضافية مع الرد. يحصل المثال التالي على عنوان URL الخاص بتقرير الشفافية عن الإعلانات في عنصر معلومات الردّ:

جافا 

nativeAd.getResponseInfo().getResponseExtras().getString("ad_transparency_url");

Kotlin 

nativeAd.getResponseInfo().responseExtras.getString("ad_transparency_url")

التحقّق من صحة عنوان URL

لاختبار عنوان URL الخاص بشفافية الإعلان والتحقّق من صحته، تأكَّد من عدم ظهور الرمز التلقائي الذي توفّره Google في إعلانك المدمج مع المحتوى، بل ظهور الرمز المخصّص. انقر على الرمز لعرض تجربة "الموافقة على الإعلانات المخصّصة".

بالإضافة إلى ذلك، تأكَّد من ظهور عنوان URL الخاص بشفافية الإعلان من الإضافات في الرد ضمن عنصر معلومات الرد. إذا لم يظهر عنوان URL الخاص بشفافية الإعلان، سيتم عرض رمز Google التلقائي بدلاً من الرمز المخصّص. في ما يلي مثال على عنوان URL لتقرير الشفافية عن الإعلانات:

https://adssettings.google.com/whythisad?source=display&reasons=REASON_ID