דף זה תורגם על ידי Cloud Translation API.

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

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

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

המפרסם מגדיר אירוע המרה ב-DDM כדי לייצג את ההתקנה או ההמרה (רק ב-Bid Manager – פיקסל המרה) (Campaign Manager – פעילות Floodlight).
המפרסם 'מקשר' אירוע המרה ב-DDM בממשק של צד שלישי ומספק משתנים מרכזיים שמזהים מפרסם וקבוצת פעילויות המרה.
- ‫src הוא מזהה המפרסם שמשמש כמקור לפעילות של Floodlight.
- ‫cat היא מחרוזת תג הפעילות, שמשמשת את השרתים של Floodlight לזיהוי קבוצת הפעילות שאליה משתייכת הפעילות.
- ‫type היא מחרוזת תג הקבוצה שמשמשת לזיהוי של קבוצת הפעילות שאליה משויכת הפעילות של Floodlight.
- ‫u1, u2, ... (אם זמין) הם זוגות של מפתח וערך של משתנה מותאם אישית ב-Floodlight.
המפרסם מוסיף משתנים לציון איסוף הסכמה לצורך עמידה בדרישות ה-DMA.
- ‫eea משמש לזיהוי משתמשים באזור הכלכלי האירופי.
  - ‫eea=0 מציין שהמשתמש לא נמצא באזור הכלכלי האירופי.
  - ‫eea=1 מציין שהמשתמש מגיע מהאזור הכלכלי האירופי.
- ‫ad_user_data הוא דגל ההסכמה לשימוש בנתוני משתמשים למטרות פרסום.
  - צריך להגדיר את הערך הזה רק אם eea=1
  - ‫ad_user_data=0 מציין שהמשתמש סירב להסכים להעברת נתונים ברמת המשתמש אל Google למטרות פרסום.
  - ‫ad_user_data=1 מציין שהמשתמש העניק הסכמה להעברה של נתונים ברמת המשתמש אל Google למטרות פרסום.
- האפליקציה npa משמשת להתאמה אישית של תוכן מודעות.
  - ‫npa=0 מציין שהמשתמש הסכים להתאמה אישית.
  - npa=1 מציין שהמשתמש לא הסכים להתאמה אישית.
- אפשר להשתמש ב-test_request_reason=dma כדי לבדוק פרמטרים של DMA
  - הפונקציה מאמתת את כל הפרמטרים של DMA ומחזירה אזהרות.
  - מחזירה תגובה מרובה עם קליקים מזויפים.
  - המערכת מתעדת את ההמרות כהמרות לבדיקה.
בנוסף, המפרסם צריך לספק לצדדים שלישיים את אסימון ההרשאה הספציפי שלו:

‫token היא מחרוזת אלפאנומרית ספציפית למפרסם שצריך להעביר אותה עם כל בקשה לשרת DDM.
מפרסם מפעיל קמפיין של מודעות באפליקציה עם תגי מודעות שמוצגים על ידי DBM בבורסות לבידינג בזמן אמת או שמוצגים על ידי DCM במדיה שנרכשה ישירות.
משתמש קצה רואה מודעות ולוחץ עליהן, והפעולות האלה מתועדות ב-DDM.
כשמשתמש קצה מתקין את האפליקציה או משלים אירוע המרה, כמו 'משחק', שרתי צד שלישי שולחים פינג ל-DDM על כל פעילות באפליקציה:

דוגמה לכתובת URL למשתמש שלא נמצא באזור הכלכלי האירופי
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=0;npa=0
```
דוגמה לכתובת URL למשתמש באזור הכלכלי האירופי
```
https://ad.doubleclick.net/ddm/s2s/appactivity/src=1234567;cat=fghij456;type=abcde123;u1=[friendlyname1];ord=1312312312;eea=1;ad_user_data=1;npa=0
```
where:‎
- ‫src הוא מזהה המפרסם שמשמש כמקור לפעילות של Floodlight.
- ‫cat היא מחרוזת תג הפעילות, שמשמשת את השרתים של Floodlight לזיהוי קבוצת הפעילות שאליה משתייכת הפעילות.
- ‫type היא מחרוזת תג הקבוצה שמשמשת לזיהוי של קבוצת הפעילות שאליה משויכת הפעילות של Floodlight.
- ‫ord הוא מספר אקראי שמשמש להפיכת תג Floodlight לייחודי.
- ‫u1, u2, ... (אם זמין) הם זוגות של מפתח וערך של משתנה מותאם אישית ב-Floodlight.
- ‫eea מציין אם המשתמש נמצא ב-EEA.
- הפרמטר ad_user_data מציין אם המשתמש מסכים לשימוש בקובצי Cookie ובכלי המדידה.
- ‫npa מציין אם המשתמש הסכים להתאמה אישית.
עם פרמטרים נוספים שנשלחים דרך מטען ייעודי (payload) של JSON ב-HTTP POST:
```
{
  "app": {
    "bundle": "com.rovio.angrybirds"
  },
  "device": {
    "ua": "Mozilla/5.0 (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]"
```
where:‎
- ‫app (חובה) הוא אובייקט JSON שמייצג את האפליקציה שבה התרחשה פעילות ההמרה. משתמשים ב-app: {} אם האפליקציה שבה התרחשה פעילות ההמרה לא זמינה.
- ‫bundle (אם זמין) הוא שדה של אובייקט האפליקציה שמכיל ערך מחרוזת של שם החבילה בחנות Play או מזהה ב-App Store.
- ‫device הוא אובייקט JSON שמייצג את המכשיר שבו התרחשה פעילות ההמרה.
- ‫ua הוא שדה של אובייקט המכשיר שמייצג את מחרוזת סוכן המשתמש של האפליקציה שבה נרשמה פעילות. חובה לכלול את הפרמטר הזה.
- ‫ip (אם זמין) היא כתובת ה-IPv4 של המכשיר שהוקצתה למכשיר. חובה לכלול את הפרמטר הזה.
- ‫didmd5 היא מחרוזת גיבוב MD5 של ערך ה-IDFA או מזהה הפרסום ב-Google Play באותיות רישיות.
- ‫lmt הוא מספר שלם, עם הערך 1 אם המשתמש הפעיל את האפשרות 'הגבלת מעקב מודעות' עם IDFA או מזהה הפרסום, או 0 אם לא הוגדר.
מערכת DDM תגיב בתשובת JSON שתציין אם אירוע ההמרה משויך לצפייה או לקליק שהוצגו על ידי DCM. אם התשובה היא 'כן', יופיע מידע נוסף על האירוע (הצפייה או הקליק האחרונים):
- מזהה המודעה
- מזהה האתר
- המזהה של מיקום המודעה
- מזהה הקריאייטיב
- חותמת זמן
תגובת 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",
  "cps": <cps>,
  "ad_events": [
    <ad event objects>
  ],
  "warnings": [<warning strings>],
  "errors": [<error strings>],
}
```
where:‎
- ‫attributed הוא ערך 1 (אם אפשר לשייך את ההמרה לחשיפה או לקליק) או 0 (אם אי אפשר לשייך אותה).
- ‫last_impression_ad_id (if attributed = 1) הוא מזהה המודעה של החשיפה האחרונה.
- ‫last_impression_site_id (if attributed = 1) is the site ID for the last impression.
- ‫last_impression_placement_id (if attributed = 1) הוא מזהה מיקום המודעה של החשיפה האחרונה.
- ‫last_impression_creative_id (אם ערך המאפיין attributed = 1) הוא מזהה הקריאייטיב של החשיפה האחרונה.
- ‫last_click_ad_id (אם הערך של attributed הוא 1 והקליק שויך) הוא מזהה המודעה של הקליק האחרון.
- ‫last_click_site_id (אם הערך הוא 1 והקליק שויך) הוא מזהה האתר של הקליק האחרון.
- ‫last_click_placement_id (if attributed = 1 and a click was attributed) is the placement ID for the last click.
- ‫last_click_creative_id (אם הערך של המאפיין 'ייחוס' הוא 1 ובוצע ייחוס לקליק) הוא מזהה הקריאייטיב של הקליק האחרון.
- ‫last_click_exclid תואם למזהה קליק ייחודי שמאוכלס באמצעות פקודת המאקרו %eiid!
החל מאכיפת ה-DMA במרץ 2024, השדות הבאים יהיו זמינים גם כן:
- ‫cps מציין לאיזה שירות פלטפורמה מרכזי האירוע שייך
  - ‫a : מודעות
  - ‫m : מפות
  - ‫p : חנות Play
  - s : חיפוש
  - ‫h : שופינג
  - ‫y : YouTube
- ‫ad_events הוא מערך של אובייקטים מסוג ad_event שמכילים את כל אירועי ההמרה.
  - לאובייקט ad_event יש את השדות הבאים:
  - ‫product_type היא מחרוזת שמדווחת על המוצר שאחראי להמרה. הערך יהיה DCM או DBM.
  - ‫interaction_type הוא סוג האינטראקציה שהובילה לאירוע. impression או click.
  - ‫conversion_metric הוא מדד ההמרה שמשמש לשיוך (Attribution). conversion או view_through_conversion.
  - ‫timestamp היא חותמת הזמן של מערכת UNIX שבה התרחש אירוע המודעה, ברמת דיוק של מיקרו-שנייה. צריך להשתמש בערך הזה לשיוך לקליק האחרון.
  - ‫campaign_type מזהה את סוג הקמפיין שיצר את אירוע הצפייה במודעה.
  - ‫line_item_id (DBM בלבד) הוא מזהה פריט ב-DBM שיצר את אירוע הצפייה במודעה.
  - ‫line_item_name (DBM בלבד) הוא השם של פריט ב-DBM שיצר את אירוע הצפייה במודעה.
  - ‫placement_id (DCM בלבד) הוא מזהה תג המיקום ב-DCM שיצר את אירוע המודעה.
  - ‫placement_name (DCM בלבד) הוא השם של תג המיקום ב-DCM שיצר את אירוע המודעה.
  - ‫external_customer_id הוא מזהה המפרסם שבבעלותו הקמפיין שיצר את אירוע הצפייה במודעה.
    - אם הערך של product הוא DBM, השדה הזה מייצג את מזהה המפרסם ב-DBM.
    - אם הערך של product הוא DCM, השדה הזה מייצג את מזהה המפרסם ב-DCM.
  - ‫creative_id הוא המזהה של יחידת המודעות הקריאייטיבית שיצרה את אירוע המודעה.
    - אם הערך של product הוא DBM, השדה הזה מייצג את מזהה הקריאייטיב ב-DBM.
    - אם הערך של product הוא DCM, השדה הזה מייצג את מזהה הקריאייטיב ב-DCM.
  - ‫exchange_id (DBM בלבד) הוא המזהה של בורסת הפרסום שדרכה הוצגה המודעה ב-DBM.
  - ‫insertion_order_id (DBM בלבד) הוא מזהה סדר ההזמנה ב-DBM.
  - ‫site_id (DCM בלבד) הוא מזהה האתר ב-DCM של אירוע הצגת המודעה.
  - ‫cps מציין לאיזה שירות של פלטפורמת הליבה שייך אירוע המודעה. לפרטים נוספים, אפשר לעיין בהסבר המלא על השדה cps שמופיע בחלק הקודם של מסמכי התיעוד.
- ‫warnings הוא מערך של אזהרות שנוצרו על ידי אירוע ההמרה.
- ‫errors הוא מערך של שגיאות שנוצרו על ידי אירוע ההמרה עם קודי שגיאות HTTP, בתרחישים הבאים:
  - ‫HTTP 204 אם חרגתם ממכסת הבקשות.
  - ‫HTTP 400 כשהבקשה נחשבת לא חוקית – לדוגמה, חסרים פרמטרים נדרשים, והשרת חזר למעקב באמצעות פיקסלים.
  - ‫HTTP 401 אם טוקן ההרשאה לא תקין.
  - ‫HTTP 404 לכל בקשה שגויה.
המפרסם יוכל לראות דוחות קמפיין במערכת שלכם, וגם דוחות המרות ב-DCM עם אותם פרמטרים.

דוגמאות נוספות לתשובות אחרי שה-DMA ייכנס לתוקף במרץ 2024

דוגמה לתגובה של מעקב המרות עם שיוך, שבה ההמרה משויכת לאינטראקציות עם מודעות ברשת החיפוש וב-YouTube, אבל נדחתה הסכמה לשימוש חוצה לפי סעיף 5(2)(ב) + 5(2)(ג) בין מערכות ה-CPS של רשת החיפוש ושל YouTube:
```
{
  attributed: 1,
  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: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A",
  cps: "s",
  ad_events: [{
      cps : "s",
      product_type: "DCM",
      interaction_type: "click",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647655.123456,
      site_id: 1408067,
      }, {
      cps : "s",
      product_type:"DCM",
      interaction_type: "impression",
      ad_event_type: "impression",
      campaign_type: "Display",
      placement_id: 107616368,
      placement_name: "TEST PLACEMENT NAME",
      external_customer_id: 7480542,
      creative_id: 60162352,
      timestamp: 1415647607.123456,
      site_id: 1408067
      },{
      cps : "y",
      product_type: "DCM",
      ad_event_type: "click",
      campaign_type: "Display",
      placement_id: 107616370,
      placement_name: "Placement on Youtube",
      external_customer_id: 7480542,
      creative_id: 6016444,
      timestamp: 14344344.123456,
      site_id: 140806
      },
  ]}
```
דוגמה לתשובה חיובית לגבי מעקב המרות בקמפיין DBM:
```
{
  attributed: 1,
  last_click_ad_id: 283641088,
  last_click_site_id: 1408067,
  last_click_placement_id: 107616368,
  last_click_creative_id :60162352,
  last_click_timestamp: 1415647655,
  last_click_exclid: "CKm0nLKhyssCFceH2wod8l4I4A"
  cps: "y",
  ad_events: [{
    product_type: "DBM",
    interaction_type: "click",
    ad_event_type: "click",
    campaign_type: "Display",
    line_item_id: 123456789,
    line_item_name: "TEST LINE ITEM NAME",
    external_customer_id: 2550,
    creative_id: 512333,
    exchange_id: 132,
    insertion_order_id: 523423,
    timestamp: 1432681913.123456
    cps: "y"
  },
  {
    product_type: "DCM",
    interaction_type: "click",
    campaign_type: "Display",
    placement_id: 9342323,
    placement_name: "TEST PLACEMENT NAME",
    external_customer_id: 7480542,
    creative_id: 8234234,
    timestamp: 1432681913.123456,
    cps: "y"
  }
]}
```

שילוב של DDM למעקב אחר אפליקציות של צד שלישי קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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