שלב 1: רושמים דיווחים חוזרים על המרות ב-SKAdNetwork לגרסאות iOS הרלוונטיות
מידע נוסף זמין במסמכי התיעוד של Apple. לקוחות שמשתמשים ב-Google Analytics for Firebase SDK יכולים לדלג על השלב הזה, כי הדיווחים האלה נרשמים אוטומטית על ידי ה-SDK בשם האפליקציה.
שלב 2: מוודאים שמקבלים דיווחים חוזרים על המרות ב-SKAdNetwork ומפענחים אותם
מידע נוסף זמין במסמכי התיעוד של Apple. אם לא הגדרתם נקודת קצה (endpoint) של SKAdNetwork, תצטרכו לעשות זאת לפי ההוראות במסמכי התיעוד של Apple.
אם כבר הגדרתם נקודת קצה (endpoint) באמצעות פתרון פנימי או דרך שותף דוחות שיוך לקמפיינים של אפליקציה (AAP) שאושר על ידי Google, אתם יכולים לדלג לשלב 3. שם מפורטות הנחיות לתהליך ההפניה של תוצאות אל Google Analytics באמצעות Measurement Protocol.
שלב 3: מפנים את התוצאות של הדיווחים החוזרים על המרות אל Google Analytics באמצעות Measurement Protocol
כדי לעשות זאת, שולחים אירוע campaign_details בהתאמה אישית אל Google Analytics דרך Measurement Protocol באמצעות הסכימה הבאה (דוגמה של Codelab).
הטמעת Measurement Protocol של SKAdNetwork ב-Google Analytics 4
פרמטרים ברמת הבקשה
| הפרמטר | מידע נוסף |
| firebase_app_id: {gmp_app_id} |
|
| api_secret: {api_secret} |
|
| timestamp_micros: {timestamp of received SKAN postback} |
|
| app_instance_id: {…} |
נדרש. יוצרים מחרוזת ייחודית של מספרים אקראיים. מחרוזת הזיהוי הספציפית הזו תימחק ממזהי מופע של אפליקציה בפועל אחרי שהמערכת תשתמש בנתונים האלה לבניית מודל המרות. |
אירוע Google Analytics
| האירוע | מידע נוסף |
| campaign_details | אירוע בהתאמה אישית. |
פרמטרים של Google Analytics (קיימים)
| הפרמטר | מידע נוסף |
| source: {source} |
אלה פרמטרים שנעשה בהם שימוש בתיוג ידני. הדיווח של Google Analytics 4 נוצר באמצעות קיבוצי הערוצים שמוגדרים כברירת מחדל ב-Google Analytics 4. אנחנו מציעים להשתמש בהם כקווים מנחים לסיווג של כל פרמטר. יש לשלוח את הפרמטרים האלה עבור כל הדיווחים החוזרים על המרות שאינם של Google. לדוגמה: דיווח חוזר על המרה ב-Facebook:
בדיווחים חוזרים על המרות ב-Google, המערכת תפענח קמפיינים על סמך השילוב של הנכס עם Google Ads. לכן, הפרמטרים שלמעלה הם אופציונליים בדיווחים חוזרים על המרות ב-Google. עליכם לוודא שנכס Google Analytics 4 מקושר לחשבונות הפרסום ב-Google Ads. הערה: חשוב לשלוח אל Google Analytics 4 את כל הדיווחים החוזרים על המרות ב-SKAdNetwork, ולא רק את הדיווחים שאינם של Google. |
| medium: {medium} | |
| term: {term} אופציונלי | |
| content: {content} אופציונלי | |
| campaign_id: {campaign_id} | ערך מדיווח חוזר על המרה ב-SKAdNetwork. |
| campaign: {campaign} אופציונלי, אבל בלעדיו יופיע הכיתוב '(לא מוגדר)' |
בקמפיינים ב-Google Ads, המערכת תפענח את המזהה ותספק את שם הקמפיין על סמך הקישור ל-Google Analytics ול-Google Ads, ותעדכן את הפרמטרים source ו-medium. אם החשבונות שלכם לא מקושרים, המערכת לא תפענח את מזהי הקמפיינים של Google, והיא תשתמש בפרמטרים source ו-medium המקוריים שצוינו. בקמפיינים שאינם של Google Ads, אפשר לפענח ולספק שמות של קמפיינים. אם השמות לא ידועים לכם, אפשר להעתיק את campaign_id ב-SKAdNetwork. הערה: אם לא מציינים את הפרמטר הזה, יופיע הכיתוב (לא מוגדר). |
| source_platform: "apple_skan" | חשוב: חובה לציין את המחרוזת הזו בדיוק, תוך שימוש מתאים באותיות רישיות ובסימן '_' (קו תחתון). |
| app_id: {app_id} |
ערך מדיווח חוזר על המרה ב-SKAdNetwork. זהו מזהה ה-App Bundle. |
| transaction_id: {transaction_id} | ערך מדיווח חוזר על המרה ב-SKAdNetwork. |
פרמטרים חדשים נדרשים
הערה: אפשר להגדיר את הפרמטרים החדשים האלה בממשק המשתמש של Google Analytics 4, אבל זו לא חובה. כדי לראות דיווח ספציפי על מאפיינים מותאמים אישית על סמך הפרמטרים האלה, הם צריכים להיות רשומים ב-Google Analytics 4.
| הפרמטר | מידע נוסף |
| version: {version} | ערך מדיווח חוזר על המרה ב-SKAdNetwork |
| conversion_value: {conversion_value} | ערך מדיווח חוזר על המרה ב-SKAdNetwork |
| fidelity_type: {fidelity_type} | ערך מדיווח חוזר על המרה ב-SKAdNetwork. |
| attribution_signature: {attribution_signature} |
ערך מדיווח חוזר על המרה ב-SKAdNetwork. הערה: זהו אמצעי אבטחה. הדיווחים החוזרים על המרות ב-SKAdNetwork חתומים באופן קריפטוגרפי. |
| redownload: {redownload} | ערך מדיווח חוזר על המרה ב-SKAdNetwork. |
| source_app_id: {source_app_id} |
ערך מדיווח חוזר על המרה ב-SKAdNetwork. הערה: זהו מזהה האפליקציה שבה התרחש הקליק על המודעה שהוביל להתקנה. |
| did_win: {did_win} |
ערך מדיווח חוזר על המרה ב-SKAdNetwork. הערה: מפרסמים מקבלים רק את הדיווחים החוזרים הזוכים על ההמרות. בפרסום דיגיטלי (AdTech) יתקבלו הדיווחים הזוכים ואלה שהגיעו למקום השני.
|
|
ad_network_id: {ad_network_id} הקטע {ad_network_id} מייצג את הערך בדיווח החוזר על ההמרה. |
ערך מדיווח חוזר על המרה ב-SKAdNetwork. כאן מוצגת רשת המודעות שבה הוצגה המודעה. המידע הזה שימושי גם למאפיין התנועה 'מקור'. |
שלב 4: מוודאים שמתקבלים היטים של Marketing Platform
אירועי campaign_details לא מוצגים ישירות ב-Google Analytics. במקום זאת, דיווחים חוזרים על המרות ב-SKAdNetwork הופכים לאירועים ומשולבים בדוחות על אירועים ואירועים מרכזיים מסוג first_open. אפשר לפלח את הדוחות על ידי הוספת פלטפורמת המקור של המאפיין (פלטפורמת המקור = SKAN).
כדי לוודא שההיטים נשלחים, מומלץ לתעד את אירועי הבדיקה על ידי שכפול של אירועי campaign_details ושימוש בשם אירוע אחר (למשל campaign_details_skan_test). לאחר מכן תוכלו לוודא שאירועי הבדיקה מופיעים בדוח זמן אמת של Google Analytics 4. אם רושמים את אירוע הבדיקה ואת הפרמטרים, הם יופיעו בדיווח אד-הוק בנוסף לדיווח בזמן אמת.
- כדי שכל הדיווחים החוזרים על המרות ב-SKAdNetwork יופיעו בדוחות, עליכם לרשום את האירוע והפרמטרים הכפולים כפי שמתואר למעלה, בנוסף לשליחה של כל אחד מהדיווחים האלה כאירוע
campaign.details. אם תבחרו לעשות זאת, עדיין תצטרכו לשלוח דיווחים חוזרים על המרות ב-SKAdNetwork באמצעות האירועcampaign.details. אחרת, מערכת Google Analytics לא תזהה את הנתונים האלה ולא תוכל לבנות מודלים של המרות כדי לשפר את הדיווח עלfirst_openב-iOS. - דיווחים חוזרים על המרות ב-SKAdNetwork צריכים להישלח תוך 4 ימים ממועד הקבלה שלהם כדי שמערכת Google Analytics תוכל להשתמש בהם בבניית מודלים של המרות ובדוחות.