تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

إحالة التطبيق المتوافق مع الخصوصية

ملخّص

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

تطبيقات Android

النطاق

تثبيت التطبيق &التفاعل مع التطبيق عبر جميع حملات "إعلانات Google"

الخلفية

في الوقت الحالي، لا يمكن تتبُّع مستخدمي Android الذين أوقفوا ميزة تخصيص الإعلانات باستخدام المعرّف الإعلاني على Android (وفقًا لسياسة Google). بدلاً من ذلك، يستخدم محرّك بحث Google gclid، وهي معلّمة عنوان URL للنقرة لا تواصل مع الجهاز.

التوجيه

واجهة برمجة تطبيقات تتبع الإحالات الناجحة وتجديد النشاط التسويقي للتطبيقات يجب أن يتأكد المستهلكون من تخزين gclid واجتيازها بشكل صحيح.

السيناريوهات المتوافقة

السيناريو المتوافق: التثبيت (لم يثبِّت المستخدم التطبيق من قبل)

عندما يتم تشغيل تثبيت تطبيق من خلال رابط لصفحة في التطبيق يؤدي إلى إعادة التوجيه إلى متجر Google Play، وعندما يفتح المستخدم التطبيق لأول مرة، حلّل قيمة gclid من واجهة برمجة التطبيقات لمُحيل التثبيت في Play install_referrer. يجب تخزين gclid هذا لمدة 180 يومًا، أو إلى أن يحل محله مُحيل تثبيت Play آخر مؤخرًا gclid.يمكن تمرير gclid هذا عبر حقل طلب الإحالة الناجحة في market_referrer_gclid.

المعرِّف الإعلاني متوفّر

عندما يكون معرّف إعلانات Android متاحًا، يجب إرسال market_referrer_gclid مع الحدث first_open المقابل له. يمكن إرسال market_referrer_gclid مع جلسات البث المباشر والأحداث، (مثل session_start وadd_to_cart وin_app_purchase وما إلى ذلك).

مثال: الفتح الأول

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

مثال: أحداث الجلسات والتطبيقات

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

المعرّف الإعلاني غير متوفّر.

في حال عدم توفّر المعرّف الإعلاني على Android، يجب إرسال market_referrer_gclid مع الحدث first_open المقابل، وجميع جلسات البث المباشر بالإضافة إلى أحداث التطبيق (أي session_start وadd_to_cart وin_app_purchase وما إلى ذلك)، بالإضافة إلى الحقل/القيمة الإضافية gclid_only_request=1. ملاحظة: يجب أن تكون القيمة rdid هي جميع الأصفار (لأن المستخدم غير موافق عليه).

مثال: الفتح الأول

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=first_open
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

مثال: أحداث &amp؛ جلسات التطبيق

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

السيناريو المتوافق: التفاعل مع التطبيق (سبق أن ثبّت المستخدم التطبيق)

عندما يتم تشغيل جلسة تطبيق من خلال رابط لموضع معيّن، يمكنك تحليل قيمة gclid وتخزينها إما على الجهاز أو من جانب الخادم باستخدام معرّف الطرف الأول.
يجب أن يتم تخزين gclid لمدة 180 يومًا، أو حتى يحل محله المزيد من gclid الأحدث. ويمكن بعد ذلك تمرير هذه القيمة عبر حقل طلب الإحالة الناجحة gclid.

المعرِّف الإعلاني متوفّر

عندما يكون معرّف إعلانات Android متاحًا، يجب إرسال gclid مع حدث session_start المقابل. يمكن إرسال gclid مع أحداث التطبيق (أي add_to_cart و in_app_purchase وما إلى ذلك). يجب عدم تمرير gclid مع أحداث session_start المضمّنة.

مثال: جلسة رابط لموضع معيّن

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

مثال: أحداث التطبيق

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

مثال: الجلسة اللاحقة/المجانية

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M

المعرّف الإعلاني غير متوفّر.

في حال عدم توفّر المعرّف الإعلاني على Android، يجب إرسال gclid مع الحدث session_start المقابل وجميع جلسات البث وأحداث الأحداث (مثل session_start وadd_to_cart وin_app_purchase وما إلى ذلك). ملاحظة: يجب أن تكون القيمة rdid صفرًا (بسبب إيقاف المستخدم لتخصيص الإعلانات).

مثال: جلسة رابط لموضع معيّن

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1

مثال: أحداث التطبيق

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1

مثال: الجلسة اللاحقة/المجانية

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1

السيناريو المتوافق: التثبيت + التفاعل

عندما يتم تثبيت تطبيق من خلال رابط لصفحة في التطبيق على "متجر Google Play"، متبوعًا بجلسة تطبيق مستنِدة إلى رابط لموضع معيّن في التطبيق، حلِّل كلاً من قيم واجهة برمجة تطبيقات المُحيل في Play gclid والرابط لموضع معيّن gclid وخزِّنها إما على الجهاز أو من جهة الخادم بواسطة معرّف الطرف الأول. يجب تخزين هذه القيم gclid لمدة 180 يومًا، أو إلى أن يحل رابط آخر لصفحة في التطبيق أحدث رابط لموضع معيّن gclid. يجب تمرير واجهة برمجة التطبيقات لمُحيل Play gclid عبر market_referrer_gclid field، ويجب تمرير الرابط لموضع معيّن gclid عبر الحقل gclid.

المعرِّف الإعلاني متوفّر

عندما يكون معرّف إعلانات Android متاحًا، يجب إرسال كلٍ من market_referrer_gclid وgclid مع حدث session_start وتطبيقات الحدث المقابلَين (add_to_cart وin_app_purchase وما إلى ذلك). بالنسبة إلى أحداث Hangout_start، مرِّر market_referrer_gclid، ولكن يجب تمرير <br class="link-1 gclid ليس.

مثال: جلسة رابط لموضع معيّن

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

مثال: أحداث التطبيق

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

مثال: الجلسة اللاحقة/المجانية

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=advertisingid
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u

المعرّف الإعلاني غير متوفّر.

في حال عدم توفّر معرِّف Android الإعلاني، يجب إرسال كلٍ من market_referrer_gclid وgclid مع الحدث session_start المقابل، وجميع البث المباشر والأحداث في التطبيق (مثل session_start و add_to_cart وin_app_purchase وما إلى ذلك). ملاحظة: يجب أن تكون قيمة rdid هي أصفار كاملة (بما أن المستخدم أوقف ميزة تخصيص الإعلانات).

مثال: جلسة رابط لموضع معيّن

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

مثال: أحداث التطبيق

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

مثال: الجلسة اللاحقة/المجانية

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=00000000-0000-0000-0000-000000000000
       &id_type=advertisingid
       &lat=1
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1

ملاحظة مهمة: واجهة برمجة التطبيقات لمُحيل التثبيت في Play gclid (التي تم تمريرها كـ market_referrer_gclid) والرابط لموضع معيّن gclid (تم تمريرها كـ gclid) هما مصدران منفصلان لـ gclid ويجب عدم استخدامهما بالتبادل. للتذكير، يجب تخزين قِيَم gclid هذه لمدة 180 يومًا، أو إلى أن يتم استبدال رابط لموضع معيّن آخر مؤخرًا gclid محلّ الرابط الحالي لصفحة في التطبيق gclid، أو تحلّ واجهة برمجة التطبيقات المُحيلة لتثبيت Play gclid محل gclid واجهة برمجة تطبيقات المُحيل "التثبيت" من gclid.

تطبيقات iOS

النطاق

التفاعل مع التطبيق من خلال "إعلانات Google" على شبكة البحث والتسوّق وamp؛ حملات التطبيقات لجذب عمليات التثبيت على نظام التشغيل iOS + الروابط لصفحات في التطبيق

الخلفية

لا يمكن تتبُّع مستخدمي الإصدار 14.5 من نظام التشغيل iOS الذين لم يشتركوا في تتبُّع التطبيق باستخدام معرّف المعلِنين (IDFA) (وفقًا لسياسة ATT من Apple). بدلاً من ذلك، يستخدم محرّك بحث Google gbraid، وهي معلمة عنوان URL مجمّعة للنقر.

التوجيه

واجهة برمجة تطبيقات تتبع الإحالات الناجحة وتجديد النشاط التسويقي للتطبيقات يجب أن يتأكد المستهلكون من تمرير جميع معلمات النقر بشكل صحيح، بما في ذلك gclid وgbraid.

السيناريوهات المتوافقة

السيناريو المتوافق: التفاعل مع التطبيق (سبق أن ثبّت المستخدم التطبيق)

عندما تكون جلسة التطبيق مستندة إلى رابط لموضع معيّن، حلِّل قيمتَي gclid وgbraid، وخزّنها إما على الجهاز أو من جانب الخادم باستخدام معرّف الطرف الأول. ويجب تخزين هذه القيم لمدة 180 يومًا، أو إلى أن يتم استبدالها بقيمة أحدث. ويمكن بعد ذلك تمرير القيمة gclid عبر حقل طلب الإحالة الناجحة gclid، ويمكن بعد ذلك تمرير القيمة gbraid عبر حقل gbraid طلب الإحالة الناجحة.

معرّف المعلِنين (IDFA) متوفّر

عندما يكون معرّف المعلِنين (IDFA) متاحًا، يجب إرسال كلٍ من gclid و gbraid مع الحدث session_start المقابل، إلى جانب حقل/قيمة إضافية، app_open_source=ad_click. يمكن إرسال gclid وgbraid مع جلسات البث المباشر بالإضافة إلى أحداث التطبيق (أي session_start وadd_to_cart وin_app_purchase وما إلى ذلك). بالنسبة إلى جلسات البث المباشر اللاحقة، عليك تضمين حقل/قيمة إضافية، app_open_source=organic.

مثال: جلسة رابط لموضع معيّن

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=BX3QojHp4mY5MrJtFM_d1u
       &gbraid=Cj0KEQjw0dy4BRCuuL_e5M
       &app_open_source=ad_click

مثال: حدث التطبيق

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=in_app_purchase
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u

مثال: الجلسة اللاحقة/المجانية

POST /pagead/conversion/app/1.0
       ?dev_token=Z_eErE4DkvcKjDM1OVE4c4
       &link_id=31FF8D67E5BB5DD5029DCC2734C2F884
       &app_event_type=session_start
       &rdid=0F7AB11F-DA50-498E-B225-21AC1977A85D
       &id_type=idfa
       &lat=0
       &app_version=1.2.4
       &os_version=9.3.2
       &sdk_version=1.9.5r6
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=BX3QojHp4mY5MrJtFM_d1u
       &app_open_source=organic

معرّف المعلِنين (IDFA) غير متاح.

عندما يكون معرّف المعلِنين (IDFA) غير متاح، يجب إرسال gbraid مع حدث session_start المقابل، بالإضافة إلى حقل/قيمة إضافية app_open_source=ad_click. وجميع أحداث البث المباشر للتطبيق (أي add_to_cart، وin_app_purchase، وما إلى ذلك). ملاحظة: يجب حذف الحقل gclid، ويجب أن تكون قيمة rdid صفرًا (لأنّ المستخدم لم يوافق على المكالمة). يجب إرسال gbraid ALSO أثناء جلسات البث وأحداث التطبيق المتوافقة (مثل session_start add_to_cart وin_app_purchase، وما إلى ذلك). بالنسبة إلى جلسات البث اللاحقة، يمكنك تضمين حقل/قيمة إضافية، app_open_source=organic.

مثال: جلسة رابط لموضع معيّن

POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=idfa &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 &timestamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=ad_click

مثال: حدث التطبيق

POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=in_app_purchase &rdid=00000000-0000-0000-0000-000000000000 &id_type=idfa &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 &timestamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M

مثال: الجلسة اللاحقة/المجانية

POST /pagead/conversion/app/1.0 ?dev_token=Z_eErE4DkvcKjDM1OVE4c4 &link_id=31FF8D67E5BB5DD5029DCC2734C2F884 &app_event_type=session_start &rdid=00000000-0000-0000-0000-000000000000 &id_type=idfa &lat=1 &app_version=1.2.4 &os_version=9.3.2 &sdk_version=1.9.5r6 &timestamp=1432681913.123456 &gbraid=Cj0KEQjw0dy4BRCuuL_e5M &app_open_source=organic

ملاحظة: لا يمكن الاستفادة من gbraid في سيناريوهات التثبيت لأنّه تتم إعادة توجيه المستخدمين إلى iTunes أولاً.