ייחוס אפליקציות שתואם למדיניות הפרטיות

סיכום

צרכני API שמשתמשים ב-API לרימרקטינג ולמעקב המרות באפליקציות של Google Ads כדי להעביר המרות באפליקציות באופן ישיר צריכים לפעול לפי ההנחיות הבאות ל-Android ול-iOS. כך תבטיחו שהקליקים ממשתמשים שמבטלים את ההסכמה למעקב אחרי מודעות או להתאמה אישית של מודעות ישויכו רק באמצעות תהליכי עבודה שתואמים לדרישות בנושא פרטיות. מידע נוסף על הגדרות הפרמטרים והערכים הצפויים זמין במאמר סקירה כללית בנושא מפרטי בקשות ותגובות.

יישומי Android

היקף

התקנות של אפליקציות ומעורבות באפליקציות דרך כל הקמפיינים ב-Google Ads

רקע

נכון לעכשיו, אי אפשר לעקוב אחרי משתמשי Android שהשביתו את ההתאמה האישית של מודעות באמצעות מזהה הפרסום של Android (בהתאם למדיניות של Google). במקום זאת, Google משתמשת בפרמטר gclid, פרמטר של כתובת URL לקליק שלא נשמר במכשיר. בנוסף, Google עשויה להשתמש ב-gbraid, פרמטר מצטבר של כתובת URL של קליק, בתרחישים אחרים שבהם לא התקבלה הסכמה ברמת המשתמש.

הדרכה

משתמשים ב-API לרימרקטינג ולמעקב המרות באפליקציות צריכים לוודא שהערכים gclid ו-gbraid מאוחסנים ומועברים בצורה נכונה.

תרחישים נתמכים

תרחיש נתמך: התקנה (המשתמש לא התקין את האפליקציה בעבר)

כשמשתמש מתקין אפליקציה בעקבות לחיצה על קישור לדף באפליקציה שמפנה לחנות Google Play, והמשתמש פותח את האפליקציה בפעם הראשונה, צריך לנתח את הערך gclid מהשדה install_referrer של Play Install Referrer API ולאחסן אותו במכשיר או בצד השרת, כשהוא ממופתח לפי מזהה מאינטראקציה ישירה. כל ערך צריך להיות מאוחסן למשך 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
       &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
       &eea=0
       &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
       &eea=0
       &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
       &eea=0
       &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 ו-gbraid מכתובת ה-URL המפנה ולאחסן אותם במכשיר או בצד השרת, עם מפתח שהוא מזהה מהדומיין הנוכחי. כל ערך צריך להיות מאוחסן למשך 180 ימים, או עד שהוא מוחלף בערך עדכני יותר. צריך להעביר את הערך של הקישור העמוק gclid דרך שדה בקשת ההמרה gclid, ואת הערך של הקישור העמוק gbraid דרך שדה בקשת ההמרה gbraid.

מזהה הפרסום זמין

כשמזהה הפרסום של Android זמין, חובה לשלוח את הפרמטרים gclid ו-gbraid עם האירוע session_start המתאים ועם כל האירועים הבאים באפליקציה (כלומר,session_start,‏ add_to_cart, ‏ in_app_purchase וכו').

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
       &timestamp=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
       &timestamp=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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
מזהה הפרסום לא זמין

כשמזהה הפרסום של 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
       &eea=0
       &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
       &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
       &timestamp=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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

תרחיש נתמך: התקנה + מעורבות

כשמשתמש מתקין אפליקציה בעקבות לחיצה על קישור עומק לחנות Google Play, ואז מתחיל סשן באפליקציה בעקבות לחיצה על קישור עומק לאפליקציה, צריך לנתח את הערך של gclid משדה install_referrer ב-Play Install Referrer API, ואת הערכים של gclid ו-gbraid מכתובת האתר המפנה, ולשמור אותם במכשיר או בצד השרת עם מפתח שהוא מזהה צד ראשון. כל ערך צריך להיות מאוחסן למשך 180 ימים, או עד שהוא מוחלף בערך עדכני יותר. אחר כך צריך להעביר את הערך של מפנה ההתקנה gclid דרך שדה בקשת ההמרה market_referrer_gclid, את הערך של הקישור העמוק gclid דרך שדה בקשת ההמרה gclid, ואת הערך של הקישור העמוק gbraid דרך שדה בקשת ההמרה gbraid.

מזהה הפרסום זמין

כשמזהה הפרסום ב-Android זמין, צריך לשלוח גם את market_referrer_gclid וגם את gclid עם אירוע session_start ואירועים באפליקציה (כלומר add_to_cart, in_app_purchase וכו'). באירועי session_start במורד הזרם, צריך להעביר את market_referrer_gclid, אבל אסור להעביר את (קישור העומק) 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
       &eea=0
       &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
       &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
       &timestamp=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
       &timestamp=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 צריך להיות אפסים (כי המשתמש ביטל את ההסכמה להצגת מודעות מותאמות אישית).

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
       &timestamp=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
       &timestamp=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
       &timestamp=1432681913.123456
       &gclid=Cj0KEQjw0dy4BRCuuL_e5M
       &market_referrer_gclid=BX3QojHp4mY5MrJtFM_d1u
       &gclid_only_request=1
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O

יישומי iOS

היקף

עידוד השימוש באפליקציה באמצעות קמפיינים לרשת החיפוש, קמפיינים לקניות וקמפיינים להתקנת אפליקציות ב-iOS ב-Google Ads + קישורי עומק

רקע

אי אפשר לעקוב אחרי משתמשים ב-iOS מגרסה 14.5 ואילך שלא הביעו הסכמה למעקב באפליקציות באמצעות IDFA (בהתאם למדיניות ATT של Apple). במקום זאת, Google משתמשת בפרמטר gbraid, שהוא פרמטר נצבר של כתובת URL של קליק. בנוסף, Google עשויה להשתמש ב-gbraid בתרחישים אחרים שבהם לא התקבלה הסכמה ברמת המשתמש.

הדרכה

צרכני App Conversion Tracking and Remarketing 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.

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
       &timestamp=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
       &timestamp=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
       &timestamp=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.

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
       &timestamp=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
       &timestamp=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
       &timestamp=1432681913.123456
       &gbraid=ChEI8IixhgYQrufHkIjz3YWRARIzALev_G_O
       &app_open_source=organic