خلاصه
مصرف کنندگان API که از API ردیابی تبدیل برنامه و بازاریابی مجدد Google Ads برای انتقال مستقیم تبدیل برنامه استفاده می کنند، باید دستورالعمل Android و iOS زیر را دنبال کنند. این اطمینان حاصل میکند که کلیکهای کاربرانی که از ردیابی تبلیغات یا شخصیسازی تبلیغات منصرف میشوند فقط با استفاده از گردشهای کاری مطابق با حریم خصوصی نسبت داده میشوند. لطفاً برای اطلاعات بیشتر در مورد تعاریف پارامترها و مقادیر مورد انتظار، به نمای کلی مشخصات درخواست و پاسخ مراجعه کنید.
برنامه های اندروید
دامنه
نصب برنامه و تعامل برنامه از طریق همه کمپینهای تبلیغات Google
پس زمینه
در حال حاضر، کاربران Android که از شخصیسازی تبلیغات منصرف شدهاند، نمیتوانند با استفاده از شناسه تبلیغاتی Android (طبق خطمشی Google) ردیابی شوند. در عوض، Google از gclid استفاده میکند، یک پارامتر URL کلیکی که در دستگاه باقی نمیماند. علاوه بر این، Google ممکن است از gbraid، یک پارامتر url کلیک انبوه، در سناریوهای دیگری که رضایت در سطح کاربر اعطا نشده است استفاده کند.
راهنمایی
مصرف کنندگان API ردیابی و بازاریابی مجدد برنامه باید اطمینان حاصل کنند که gclid و gbraid به درستی ذخیره و ارسال شده اند.
سناریوهای پشتیبانی شده
سناریوی پشتیبانی شده: نصب (کاربر قبلاً برنامه را نصب نکرده است)
وقتی نصب برنامه توسط پیوند عمیقی هدایت میشود که به فروشگاه Google Play هدایت میشود و کاربر ابتدا برنامه را باز میکند، مقدار gclid را از قسمت Play Install Referrer API install_referrer تجزیه کنید و آن را در دستگاه یا سمت سرور ذخیره کنید که توسط یک شناسه شخص اول کلید شده است. هر مقدار باید به مدت 180 روز یا تا زمانی که با یک مقدار جدیدتر جایگزین شود ذخیره شود. مقدار gclid باید از طریق فیلد درخواست تبدیل market_referrer_gclid ارسال شود.
شناسه تبلیغات موجود است
هنگامی که شناسه تبلیغات Android در دسترس است ، market_referrer_gclid باید همراه با رویداد first_open مربوطه و همه جلسات پاییندستی و رویدادهای برنامه (مانند 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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1سناریوی پشتیبانی شده: تعامل با برنامه (کاربر قبلاً برنامه را نصب کرده است)
هنگامی که یک جلسه برنامه توسط یک پیوند عمیق هدایت می شود، مقادیر gclid و gbraid را از نشانی اینترنتی ارجاع شده تجزیه کنید و آنها را در دستگاه یا سمت سرور ذخیره کنید که توسط یک شناسه شخص اول کلید شده است. هر مقدار باید به مدت 180 روز یا تا زمانی که با یک مقدار جدیدتر جایگزین شود ذخیره شود. مقدار gclid deeplink باید از طریق فیلد درخواست تبدیل gclid و مقدار deeplink gbraid باید از طریق قسمت درخواست تبدیل gbraid منتقل شود.
شناسه تبلیغات موجود است
وقتی شناسه تبلیغات Android در دسترس است ، gclid و gbraid باید همراه با رویداد session_start مربوطه و همه جلسات پاییندستی و رویدادهای برنامه (مانند session_start ، add_to_cart ، in_app_purchase ، و غیره) ارسال شوند.
مثال: Deeplink Session
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: رویدادهای برنامه
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: جلسه بعدی/ارگانیک
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
شناسه تبلیغاتی موجود نیست
وقتی شناسه تبلیغاتی Android در دسترس نیست ، gclid باید با رویداد session_start مربوطه و همه جلسات پاییندستی و رویدادهای برنامه (یعنی session_start ، add_to_cart ، in_app_purchase ، و غیره) ارسال شود. توجه: مقدار rdid باید همه صفر باشد (زیرا کاربر از شخصی سازی تبلیغات منصرف شده است).
مثال: Deeplink Session
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: رویدادهای برنامه
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: جلسه بعدی/ارگانیک
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
سناریوی پشتیبانی شده: Install + Engagement
هنگامی که نصب برنامه توسط یک پیوند عمیق به فروشگاه Google Play هدایت میشود، و سپس یک جلسه برنامه توسط پیوند عمیق به برنامه هدایت میشود، هم مقدار gclid را از قسمت Play Install Referrer API install_referrer و هم مقادیر gclid و gbraid را از نشانی اینترنتی ارجاعدهنده تجزیه و تحلیل کنید و آنها را در دستگاه یا در سمت سرور ذخیره کنید که توسط یک شخص اول کلید شده است. هر مقدار باید به مدت 180 روز یا تا زمانی که با یک مقدار جدیدتر جایگزین شود ذخیره شود. سپس مقدار gclid ارجاع دهنده نصب باید از طریق فیلد درخواست تبدیل market_referrer_gclid ، مقدار gclid deeplink از قسمت درخواست تبدیل gclid و مقدار gbraid deeplink باید از طریق فیلد درخواست تبدیل gbraid منتقل شود.
شناسه تبلیغات موجود است
وقتی شناسه تبلیغات Android در دسترس است ، هم market_referrer_gclid و هم gclid باید با رویداد session_start و رویدادهای برنامه مربوطه ارسال شوند (یعنی add_to_cart ، in_app_purchase ، و غیره). برای رویدادهای downstream session_start، market_referrer_gclid پاس کنید، اما gclid (پیوند عمیق) نباید پاس داده شود.
مثال: Deeplink Session
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: رویدادهای برنامه
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: جلسه بعدی/ارگانیک
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
<&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
شناسه تبلیغاتی موجود نیست
وقتی شناسه تبلیغات Android در دسترس نیست ، هم market_referrer_gclid و هم gclid باید با رویداد session_start مربوطه ارسال شوند، و همه رویدادهای نشست و برنامه پاییندست (یعنی session_start ، add_to_cart ، in_app_purchase ، و غیره). توجه: مقدار rdid باید همه صفر باشد (زیرا کاربر از شخصی سازی تبلیغات منصرف شده است).
مثال: Deeplink Session
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: رویدادهای برنامه
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: جلسه بعدی/ارگانیک
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
&gclid_only_request=1
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
برنامه های iOS
دامنه
تعامل با برنامه از طریق جستجوی Google Ads، خرید، و iOS ACi + Deeplinks
پس زمینه
کاربران iOS14.5+ که در ردیابی برنامه شرکت نکرده اند، نمی توانند با استفاده از IDFA (طبق خط مشی ATT اپل) ردیابی شوند. در عوض، گوگل از gbraid استفاده میکند که یک پارامتر url کلیک کل است. علاوه بر این، Google ممکن است از gbraid در سناریوهای دیگری که رضایت سطح کاربر اعطا نشده است استفاده کند.
راهنمایی
مصرفکنندگان API ردیابی و بازاریابی مجدد برنامه باید اطمینان حاصل کنند که همه پارامترهای کلیک، از جمله gclid و gbraid به درستی ارسال شدهاند.
سناریوهای پشتیبانی شده
سناریوی پشتیبانی شده: تعامل با برنامه (کاربر قبلاً برنامه را نصب کرده است)
هنگامی که یک جلسه برنامه توسط یک پیوند عمیق هدایت می شود، مقادیر gclid و gbraid را از URL ارجاع شده تجزیه کنید و آنها را در دستگاه یا سمت سرور ذخیره کنید که توسط یک شناسه شخص اول کلید شده است. هر مقدار باید به مدت 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 اضافه کنید.
مثال: Deeplink Session
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: جلسه بعدی/ارگانیک
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
&eea=0
&lat=0
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gclid=Cj0KEQjw0dy4BRCuuL_e5M
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&app_open_source=organic
IDFA در دسترس نیست
وقتی IDFA در دسترس نیست ، gbraid باید با رویداد session_start مربوطه به همراه فیلد/مقدار اضافی، app_open_source=ad_click ارسال شود. و همه رویدادهای برنامه پایین دستی (به عنوان مثال add_to_cart ، in_app_purchase ، و غیره). توجه : فیلد gclid باید حذف شود و مقدار rdid باید همه صفر باشد (چون کاربر رضایت ندارد). همچنین لازم است که gbraid با جلسات پایین دستی و رویدادهای برنامه مربوطه ارسال شود (یعنی session_start ، add_to_cart ، in_app_purchase ، و غیره). برای جلسات پایین دستی بعدی، فیلد/مقدار اضافی، app_open_source=organic اضافه کنید.
مثال: Deeplink Session
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
مثال: جلسه بعدی/ارگانیک
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
&eea=0
&lat=1
&app_version=1.2.4
&os_version=9.3.2
&sdk_version=1.9.5r6
×tamp=1432681913.123456
&gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
&app_open_source=organic