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

סיכום

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

אפליקציות Android

היקף

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

רקע

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

הנחיות

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

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

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

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

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

כאשר מזהה הפרסום של Android זמין, יש לשלוח את market_referrer_gclid עם האירוע התואם first_open. אפשר לשלוח את ה-market_referrer_gclid עם פעילויות ב-downstream &אירועי אפליקציה (כלומר 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 הרלוונטי, וכל ההפעלות ב-downstream &אירועי אפליקציה (כלומר 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באירועים בהמשך 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 וכו'). הערה: הערך האדום צריך להיות אפס (כי המשתמש ביטל את הסכמתו להתאמה אישית של מודעות).

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, ואז על סשן של אפליקציה שמבוסס על קישור עומק לאפליקציה, מנתחים את הערכים של Replayer API gclid ואת קישור העומק gclid של חנות. בנוסף, אפשר לנתח את הערכים האלה במכשיר או במכשיר בצד השרת לפי מזהה של צד ראשון. צריך לשמור את הערכים האלה של gclid למשך 180 יום, או עד שקישור העומק gclid החדש יחליף את קישור העומק הקיים gclid או שממשק ה-API המפנה של Play gclid יחליף את ה-API של ההפניה האוטומטית ל-Play gclid. יש להעביר את ה-API של הגורם המפנה של Play gclid דרך market_referrer_gclid field, וגם צריך להעביר את קישור העומק gclid דרך השדה gclid.

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

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

יישומי iOS

היקף

אינטראקציה עם אפליקציה דרך חיפוש Google , Google שופינג ו-& iOS ACi + קישורי עומק

רקע

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

הנחיות

צרכנים במעקב המרות באפליקציות וברימרקטינג צריכים לוודא שכל הפרמטרים של הקליקים מועברים בצורה נכונה, כולל 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 נדרש גם כדי לקבל סשנים במורד הנהר ואירועי AMP תואמים (כלומר 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