שילוב DDM למעקב אחר אפליקציות של צד שלישי

התהליך המפורט כאן מתאר הגדרת מפרסמים והטמעת צד שלישי, לפי הצורך, כדי להפעיל קמפיין על מוצרים של DoubleClick בצד הקנייה באמצעות פתרון מעקב של צד שלישי לאפליקציה. למידע נוסף על DoubleClick Digital Marketing וכן סקירה כללית על הפונקציונליות של ייחוס בתוך האפליקציה, ראה דף הרקע של DoubleClick Digital Marketing .

1. המפרסם מגדיר אירוע המרה ב-DDM כדי לייצג את ההתקנה/המרה (ב-Display Manager בלבד – פיקסל המרה) (Campaign Manager – פעילות Floodlight).

2. "links" ; אירוע המרה ב-DDM בממשק של צד שלישי ומספק משתנים עיקריים שמזהים את המפרסם ואת קבוצת פעילות ההמרה.

   • src הוא מזהה המפרסם שהוא המקור לפעילות ב-Floodlight.
   • cat היא מחרוזת תג הפעילות, ששרתי Floodlight משתמשים בה כדי לזהות את קבוצת הפעילות שאליה הפעילות שייכת.
   • type היא מחרוזת תג הקבוצה, שמזהה את קבוצת הפעילות שאליה משויכת הפעילות ב-Floodlight.
   • u1, u2, ... (אם זמינים) הם ערכי המפתח של משתנה Floodlight מותאם אישית.

3. בנוסף, המפרסם צריך לספק לצדדים שלישיים הרשאה ספציפית באסימון: token היא מחרוזת אלפאנומרית ספציפית למפרסם, שצריך להעביר יחד עם כל בקשת שרת ל-DDM.

4. המפרסם מפעיל קמפיין לקידום אפליקציה עם תגי מודעות שהוצגו על ידי DBM בבורסות של בידינג בזמן אמת או שמוצגות על ידי DCM במדיה שנרכשה ישירות.

5. משתמש הקצה רואה את המודעות שמתועדות ב-DDM ו/או לוחץ עליהן.

6. כשמשתמש קצה מתקין את האפליקציה ו/או משלים אירוע המרה ("gameplay" וכו'), שרתים של צד שלישי "ping" DDM בכל פעילות באפליקציה

   https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312
   

   איפה:

   • src הוא מזהה המפרסם שהוא המקור לפעילות ב-Floodlight.
   • cat היא מחרוזת תג הפעילות, ששרתי Floodlight משתמשים בה כדי לזהות את קבוצת הפעילות שאליה הפעילות שייכת.
   • type היא מחרוזת תג הקבוצה, שמזהה את קבוצת הפעילות שאליה משויכת הפעילות ב-Floodlight.
   • ord הוא מספר אקראי המשמש ליצירת תג Floodlight ייחודי.
   • u1, u2, ... (אם זמינים) הם ערכי המפתח של משתנה Floodlight המותאם אישית.

   עם פרמטרים נוספים שנשלחו דרך מטען ייעודי של JSON ב-HTTP POST:

   {
     "app": {
       "bundle": "com.rovio.angrybirds"
     },
     "device": {
       "ua": "Mozilla/5.0 (iPhone; CPU iPhone OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Version/6.0 Mobile/10A5376e Safari/8536.25",
       "ip": "108.176.57.230",
       "didmd5": "A2D2DA47AC2DE1BCA16883BD5CAA6F2F",
       "lmt": 1
     }
   }
   

   ואסימון ההרשאה של המפרסם מועבר בכותרת הרשאת ה-HTTP:

   Authorization: Token token="[advertiser authorization token string]"
   

   איפה:

   • app (חובה) הוא אובייקט JSON המייצג את האפליקציה שבה התרחשה פעילות ההמרה. יש להשתמש ב-app: {} אם האפליקציה שבה בוצעה פעולת ההמרה לא זמינה.
   • bundle (אם זמין) הוא השדה של אובייקט האפליקציה שמכיל ערך מחרוזת של שם החבילה בחנות Play או של מזהה App Store.
   • device הוא אובייקט JSON המייצג את המכשיר שבו התרחשה פעילות ההמרה.
   • ua הוא שדה האובייקט של המכשיר שמייצג את מחרוזת סוכן המשתמש של האפליקציה, שבה תועדה פעילות. הפרמטר הזה נדרש.
   • הכתובת ip (אם זמינה) היא כתובת ה-IPv4 של המכשיר המוקצית. הפרמטר הזה נדרש.
   • didmd5 היא מחרוזת MD5 גיבוב (hash) של ה-IDFA באותיות גדולות או Google Play ערך של מזהה פרסום.
   • lmt הוא מספר שלם, שבו ערך של 1 יאפשר למשתמש להפעיל את האפשרות "הגבלת מעקב&מירכאות; עם IDFA/AdID, או את הערך 0, אם הוא לא מוגדר.

   DDM יגיב עם תגובת JSON אם אירוע ההמרה ישויך לתצוגה או לקליק שהוצגו על ידי DCM, ואם "YES", מידע נוסף לגבי האירוע (תצוגה אחרונה או קליק):

   - Ad ID
   - Site ID
   - Placement ID
   - Creative ID
   - Timestamp
   

   דוגמה של תגובת JSON עשויה להיראות כך:

   {"attributed": 1,  // Whether the conversion can be attributed to a DCM event.
    "last_impression_ad_id":283641088,
    "last_impression_site_id":1408067,
    "last_impression_placement_id":107616368,
    "last_impression_creative_id":60162352,
    "last_impression_timestamp":1415647607,
    "last_click_ad_id":283641088,
    "last_click_site_id":1408067,
    "last_click_placement_id":107616368,
    "last_click_creative_id":60162352,
    "last_click_timestamp":1415647657,
    "last_click_exclid":"CKm0nLKhyssCFceH2wod8l4I4A"}
   

   איפה:

   • attributed הוא ערך 1 (אם אפשר לשייך את ההמרה לחשיפה או לקליק) או 0 (אם לא ניתן לשייך אותם).
   • last_impression_ad_id (אם משויך = 1) הוא מזהה המודעה של החשיפה האחרונה.
   • last_impression_site_id (אם השיוך = 1) הוא מזהה האתר לחשיפה האחרונה.
   • last_impression_placement_id (אם משויך = 1) הוא מזהה המיקום של החשיפה האחרונה.
   • last_impression_creative_id (אם משויך = 1) הוא מזהה הקריאייטיב לחשיפה האחרונה.
   • last_click_ad_id (אם השיוך = 1 וקליק שויך) הוא מזהה המודעה לקליק האחרון.
   • last_click_site_id (אם השיוך = 1 וקליק שויך) הוא מזהה האתר עבור הקליק האחרון.
   • last_click_placement_id (אם השיוך = 1 וקליק שויך) הוא המזהה של הקליק האחרון.
   • last_click_creative_id (אם השיוך = 1 וקליק שויך) הוא מזהה הקריאייטיב עבור הקליק האחרון.
   • last_click_exclid תואם למזהה קליק ייחודי שמאוכלס באמצעות מאקרו %eiid!

   עם קודי שגיאה של HTTP, בתרחישים הבאים:

   • HTTP 204 אם חריגה ממכסת הבקשות.
   • HTTP 400 כשהבקשה נחשבת לא חוקית (למשל, חסרים פרמטרים נדרשים) והשרת חזר למעקב אחר פיקסלים.
   • HTTP 401 אם אסימון ההרשאה לא חוקי.
   • HTTP 404 עבור כל בקשה שגויה.

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