خلاصه
مصرف کنندگان 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