נתוני גרסה

כאן אפשר לקרוא על השינויים בכל גרסה של Data Manager API.

‫2026-05-07 v1.6

  • נוספה תמיכה בשליחת המרות למכירות בחנות פיזית ב-Google Ads באמצעות IngestEventsRequest. כדי להשתמש בתכונה הזו, חשבון Google Ads שלכם צריך לעמוד בדרישות הסף מסוימות.
    • נוסף השדה event_location אל Event, שמאפשר לספק store_id.
    • הוספנו את השדה third_party_user_data אל Event, כדי לאפשר סימון מפורש של נתונים שהועברו כנתונים בבעלות של צד שלישי.
    • הוספנו את השדות הבאים למשאב Item:
      • merchant_id
      • merchant_feed_label
      • merchant_feed_language_code
      • conversion_value
      • ‫custom_variables (מקבל רשימה של אובייקטים ItemCustomVariable)
    • כדי להתחיל, מומלץ לעיין במדריכים הבאים:
  • הוספנו תמיכה בשליחת אירועים מאתרים או מאפליקציות אל Google Analytics, שלא מוגדרים כאירועים שמורים.
  • הוספנו תמיכה בשליחה של כל אירוע עם מזהה עסקה למקורות נתונים של אתרים ואפליקציות כמקור נתונים נוסף להטמעות של תג או של Google Analytics for Firebase ‏(GA4F) SDK.
    • התכונה הזו מוגבלת לנכסים ב-Google Analytics שנכללים ברשימת ההיתרים. אם אתם רוצים להוסיף את הנכס שלכם לרשימת ההיתרים, אתם יכולים למלא את הטופס הזה.
  • הוספנו את השדה coupon_codes ל-CartData כדי לעקוב אחרי כל קודי השוברים שמוחלים על עגלת הקניות עבור אירועים שנשלחים ל-Google Ads ול-Google Analytics.
    • לתרחישי שימוש במימוש שוברים ב-Google Ads, משתמשים בסוג ההמרה OFFLINE_PROMOTION_REDEMPTION.
  • הוספנו היקף OAuth חדש,‏ https://www.googleapis.com/auth/datamanager.partnerlink, לשיטות שקשורות ליצירה, לחיפוש ולמחיקה של קישורים לשותפים.
  • נוספו ערכים חדשים לספירה ErrorReason כדי לתמוך באימות מפורט של מכירות בחנות פיזית ושל הטמעה של אירועים ב-Google Analytics.
  • נוספו השדות youtube_members_count ו-gmail_members_count למשאב SizeInfo.

2026-03-26

‫2026-02-17 גרסה 1.5

ה-Data Manager API תומך עכשיו בכל תהליך העבודה מקצה לקצה לניהול קהלים, כולל יצירה, הטמעה ואחזור של קהלים.

2026-02-10

האפשרות לשלוח המרות עם מספר מקורות נתונים כדי לשפר את הביצועים ואת חוזק הנתונים זמינה עכשיו לכל חשבונות Google Ads.

התכונה הזו עדיין זמינה רק בנכסי Google Analytics שנכללים ברשימת ההיתרים. אם אתם מעוניינים להוסיף את נכס Google Analytics שלכם לרשימת ההיתרים, מלאו את הטופס.

‫2025-11-05 גרסה 1.4

  • הוספנו תמיכה בשליחת אירועים של Google Analytics purchase כמקור נתונים נוסף להמרות של התג, כדי למקסם את האותות של האינטראקציות עם המודעות ולשפר את הנתונים והביצועים הכוללים.

    • הוספתי את GOOGLE_ANALYTICS_PROPERTY ל-enum‏ AccountType.
    • הוספת כמה שדות ל-Event:
      • event_name
      • client_id
      • user_id
      • additional_event_parameters
    • הוספת את additional_user_properties אל UserProperties.

    במדריך האירועים יש מידע נוסף על שליחת אירועים של Google Analytics purchase ועל מיפוי פרמטרים של אירועים ומאפייני משתמש ב-Google Analytics למקבילים שלהם ב-API של המרכז לניהול נתונים.

  • נוסף AwsWrappedKeyInfo כדי לתמוך בשימוש במפתחות הצפנה מ-AWS Key Management Service.

  • נוספו ערכי ה-enum הבאים אל ErrorReason:

    • EVENT_TIME_INVALID
    • FIELD_VALUE_TOO_LONG
    • INVALID_EVENT_NAME
    • INVALID_PROPERTY_TYPE
    • INVALID_REQUEST_ID
    • INVALID_STREAM_TYPE
    • LINKED_ACCOUNT_ONLY_ALLOWED_WITH_DATA_PARTNER_LOGIN_ACCOUNT
    • MULTIPLE_DESTINATIONS_FOR_GOOGLE_ANALYTICS_EVENT
    • NOT_ALLOWLISTED
    • OPERATING_ACCOUNT_LOGIN_ACCOUNT_MISMATCH
    • RESERVED_NAME_USED
    • TOO_MANY_ELEMENTS
    • UNSUPPORTED_LINKED_ACCOUNT_FOR_DATA_PARTNER
    • UNSUPPORTED_OPERATING_ACCOUNT_FOR_DATA_PARTNER

‫2025-10-06 גרסה 1.3

  • ה-Data Manager API זמין עכשיו לכל המשתמשים.

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

    כדי להביע עניין בהצטרפות כשותף נתונים, ממלאים את טופס ההתעניינות בשותפות.

  • הוספנו את השיטה RetrieveRequestStatus כדי לאחזר מידע אבחוני לבקשות להעברת אירועים וקהלים.

  • השדה product של ProductAccount וה-enum‏ Product הוצאו משימוש. במקום זאת, משתמשים בשדה account_type ובסוג ה-enum החדש AccountType.

  • הוספנו תמיכה בציון destination לכל AudienceMember ב-IngestAudienceMembersRequest. אפשר להשתמש בתכונה הזו כדי לשלוח נתוני קהלים לכמה יעדים שונים בבקשה אחת.

  • קהלים שמיובאים באמצעות ה-API עומדים עכשיו בדרישות לטירגוט אחרי שיש בהם לפחות 100 חברים. בעבר, סף החברים היה אלף חברים.

  • השדה transaction_id של Event הוא עכשיו אופציונלי כששולחים המרות אופליין או המרות משופרות לצורך שיוך ללידים. עדיין צריך את transaction_id כששולחים המרות אופליין כמקור נתונים נוסף כדי לשפר את הביצועים ואת איכות הנתונים.

‫2025-08-06 גרסה 1.2

  • הוספנו תמיכה בשליחת נתוני המרות אופליין והמרות משופרות לצורך שיוך ללידים ליעדים ב-Google Ads באמצעות השיטה IngestEvents. במדריך המעודכן בנושא הצפנה מוסבר איך להגדיר הצפנה להמרות האלה.
  • הוספנו את הערכים APP,‏ IN_STORE,‏ PHONE ו-OTHER ל-enum‏ EventSource. event_source נדרש כדי להשתמש בהמרות אופליין ובהמרות משופרות לצורך שיוך ללידים.
  • השדה user_properties נוסף אל Event. מגדירים את השדה הזה לאובייקט UserProperties כדי להוסיף מידע על משתמש שהמפרסם העריך בזמן שהאירוע התרחש.
  • נוסף שדה חוזר destination_references אל CustomVariable. בשדה הזה אפשר להזין ערך של משתנה מותאם אישית שיוחל רק על קבוצת משנה של יעדים של Event.
  • הוספנו את השגיאות הבאות שקשורות להמרות אופליין ולהמרות משופרות לצורך שיוך ללידים:
    • DESTINATION_ACCOUNT_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS
    • DESTINATION_ACCOUNT_DATA_POLICY_PROHIBITS_ENHANCED_CONVERSIONS
    • DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED

‫2025-06-25 גרסה 1.1

  • הוספנו את ה-method‏ IngestEvents ל-IngestionService. כדאי להשתמש ב-IngestEvents כמקור נתונים נוסף להמרות של התג, כדי למקסם את האותות של האינטראקציות עם המודעות ולשפר את הנתונים והביצועים הכוללים.

‫2025-04-02 גרסה 1.0