این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

منبع برنامه سازگار با حریم خصوصی

خلاصه

مصرف کنندگان API که از API ردیابی تبدیل برنامه و بازاریابی مجدد Google Ads برای انتقال مستقیم تبدیل برنامه استفاده می کنند، باید دستورالعمل Android و iOS زیر را دنبال کنند. این اطمینان حاصل می‌کند که کلیک‌های کاربرانی که از ردیابی تبلیغات یا شخصی‌سازی تبلیغات منصرف می‌شوند فقط با استفاده از گردش‌های کاری مطابق با حریم خصوصی نسبت داده می‌شوند. لطفاً برای اطلاعات بیشتر در مورد تعاریف پارامترها و مقادیر مورد انتظار، به نمای کلی مشخصات درخواست و پاسخ مراجعه کنید.

برنامه های اندروید

محدوده

نصب برنامه و تعامل برنامه از طریق همه کمپین‌های تبلیغات Google

زمینه

در حال حاضر، کاربران Android که از شخصی‌سازی تبلیغات منصرف شده‌اند، نمی‌توانند با استفاده از شناسه تبلیغاتی Android (طبق خط‌مشی Google) ردیابی شوند. در عوض، Google از gclid استفاده می‌کند، یک پارامتر کلیکی url که در دستگاه باقی نمی‌ماند.

راهنمایی

مصرف کنندگان API ردیابی و بازاریابی مجدد برنامه باید اطمینان حاصل کنند که gclid به درستی ذخیره و ارسال شده است.

سناریوهای پشتیبانی شده

سناریوی پشتیبانی شده: نصب (کاربر قبلاً برنامه را نصب نکرده است)

وقتی نصب برنامه توسط پیوند عمیقی هدایت می‌شود که به فروشگاه Google Play هدایت می‌شود، و کاربر ابتدا برنامه را باز می‌کند، مقدار gclid را از قسمت Play Install Referrer API install_referrer تجزیه کنید و آن را در دستگاه یا سمت سرور ذخیره کنید. شناسه شخص 1. این gclid باید به مدت 180 روز ذخیره شود، یا تا زمانی که gclid جدیدتر Play Install Referrer جایگزین آن شود. این 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

مثال: رویدادهای جلسه و برنامه

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 نباید با رویدادهای downstream session_start منتقل شود.

مثال: 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
       &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 باید همه صفر باشد (زیرا کاربر از شخصی سازی تبلیغات منصرف شده است).

مثال: 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
       &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

سناریوی پشتیبانی شده: Install + Engagement

هنگامی که نصب برنامه توسط یک پیوند عمیق به فروشگاه Google Play هدایت می‌شود، و به دنبال آن یک جلسه برنامه توسط پیوند عمیق به برنامه هدایت می‌شود، هم مقادیر gclid و هم مقادیر gclid Referrer API Play Install را تجزیه کنید و آنها را در دستگاه یا سمت سرور ذخیره کنید. توسط یک شناسه شخص اول کلید خورده است. این مقادیر gclid باید به مدت 180 روز ذخیره شوند، یا تا زمانی که یک gclid deeplink جدیدتر جایگزین gclid deeplink موجود gclid ، یا یک Play Install Referrer API gclid جایگزین Play Install Referrer API gclid موجود شود. gclid Play Install Referrer API باید از طریق market_referrer_gclid field و gclid deeplink باید از طریق فیلد gclid شود.

شناسه تبلیغات موجود است

وقتی شناسه تبلیغات 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
       &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 باید همه صفر باشد (زیرا کاربر از شخصی سازی تبلیغات منصرف شده است).

مثال: 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
       &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 Install Referrer API gclid (به عنوان market_referrer_gclid ) و deeplink gclid (به عنوان gclid ) دو منبع مجزا برای gclid و نباید به جای هم استفاده شوند. به عنوان یادآوری، این مقادیر gclid باید به مدت 180 روز ذخیره شوند، یا تا زمانی که gclid deeplink جدیدتر جایگزین gclid deeplink موجود gclid یا یک Play Install Referrer API gclid جایگزین Play Install Referrer API gclid موجود شود.

برنامه های iOS

محدوده

تعامل با برنامه از طریق جستجوی Google Ads، خرید، و iOS ACi + Deeplinks

زمینه

کاربران iOS14.5+ که در ردیابی برنامه شرکت نکرده اند، نمی توانند با استفاده از IDFA (طبق خط مشی ATT اپل) ردیابی شوند. در عوض، گوگل از gbraid استفاده می‌کند که یک پارامتر url کلیک کل است.

راهنمایی

مصرف‌کنندگان API ردیابی و بازاریابی مجدد برنامه باید اطمینان حاصل کنند که همه پارامترهای کلیک، از جمله 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 را اضافه کنید.

مثال: 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
       &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 همچنین باید با جلسات پایین دستی و رویدادهای برنامه مربوطه ارسال شود (به عنوان مثال 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
       &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

توجه: از آنجایی که کاربران ابتدا به iTunes هدایت می شوند، نمی توان از gbraid در سناریوهای نصب استفاده کرد.