נתוני גרסה

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

‫30.07.2026 גרסה 1.8

• הוספנו את השיטה RemoveAllAudienceMembers ל-IngestionService כדי להסיר או להחליף את כל חברי הקהל ברשימות המשתמשים שצוינו.
  • כדי להתחיל, כדאי לעיין במדריך להסרת כל החברים מקהל עבור השילוב הספציפי שלכם. לדוגמה, אפשר לעיין במדריכים בנושא התאמה ללקוחות ב-Google Ads או ב-Display & Video 360.
• הוספנו תמיכה בהחזרת אזהרות מפורטות במהלך הטמעה של אירועים וקהלים.
  • הוספנו את השדה field_warnings ל-IngestEventsResponse ול-IngestAudienceMembersResponse, שמכיל רשימה של אובייקטים מסוג FieldWarning.
  • נוסף מקור המידע FieldWarning שכולל נתיב reason (WarningReason ),‏ description ו-field.
  • נוסף ה-enum‏ WarningReason כדי להגדיר סיבות לאזהרות, כמו משתנים מותאמים אישית שלא הופעלו או מזהי מוֹכרים שחסרים בנתוני עגלת הקניות.
• נוספה תמיכה בשליחת שדות נוספים של כתובות לצורך הטמעה של אירועים ב-Google Analytics.
  • הוספנו את השדות address_line,‏ city ו-administrative_area אל AddressInfo (בשימוש ב-UserData).
• נוספו הסיבות לשגיאה INVALID_REMOVE_AS_OF_TIME ו-REQUIRED_PREREQUISITE_LINK_MISSING ל-enum‏ ErrorReason.

‫28.05.2026 גרסה 1.7

• הוספנו תמיכה בשליחת אירועי המרה אופליין למוצרי Google Marketing Platform, כולל Campaign Manager 360,‏ Search Ads 360 ו-Display & Video 360, באמצעות IngestEventsRequest.

  • הוספנו את FLOODLIGHT_CONFIG ל-enum‏ AccountType כדי לתמוך ביעדים של Floodlight.
  • הוספנו את השדות dclid,‏ impression_id,‏ match_id ו-encrypted_user_ids ל-AdIdentifiers.
  • הוספנו את השדה conversion_count למשאב Event כדי לתמוך במעקב אחר כמויות המרות.

  כדי להתחיל, אפשר לעיין במדריך לשליחת אירועים או לקרוא איך לשדרג מ-Campaign Manager 360 API.

• הוספנו את השדה composite_data למשאב AudienceMember, שמקבל אובייקט CompositeData ומאפשר לשלב כמה סוגים של מזהים, כמו UserData ו-IpData. מידע נוסף זמין במאמר בנושא נתונים מורכבים.

  • נוספו סטטוסים חדשים IngestCompositeDataStatus ו-RemoveCompositeDataStatus שכוללים אבחון (record_count ו-data_type_counts) לבקשות של משתמשים מקהל היעד שמשתמשים ב-CompositeData.

• נוספה תמיכה בהעברה של כתובות IP לצורך התאמה ללקוחות ב-Google Ads על ידי שליחת IpData בנתונים מורכבים.

• נוספו סיבות חדשות לשגיאה FIELD_VALUE_TOO_SHORT,‏ TOO_FEW_ELEMENTS,‏ BASELINE_LOCATION_AUTO_DETECTION_FAILED ו-INSIGHTS_MISSING_FOR_DIMENSION ל-enum‏ ErrorReason.

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

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 Ads
    • שליחת אירועים
• הוספנו תמיכה בשליחת אירועים מאתרים או מאפליקציות אל Google Analytics, שלא מוגדרים כאירועים שמורים.
  • השדה app_instance_id נוסף למשאב Event.
  • נוספו שדות ל-DeviceInfo כדי לספק מטא-נתונים על המכשיר של המשתמש.
  • נוסף השדה mobile_device_id אל AdIdentifiers.
  • הוספנו את השדה event_location אל Event כדי לתעד שדות כמו city,‏ subdivision_code,‏ region_code,‏ subcontinent_code ו-continent_code.
  • כדי להתחיל, מומלץ לעיין במדריכים הבאים:
    • שליחת אירועים מומלצים ואירועים בהתאמה אישית
    • שדרוג מ-Measurement Protocol
    • מקורות מידע מומלצים לגבי אירועים
• הוספנו תמיכה בשליחה של כל אירוע עם מזהה עסקה לזרמי נתונים של אתרים ואפליקציות כמקור נתונים נוסף להטמעות של תג או של 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, לשיטות שקשורות ליצירה, לחיפוש ולמחיקה של קישורים לשותפים.
• נוספו ערכים חדשים ל-enum‏ ErrorReason כדי לתמוך באימות מפורט של מכירות בחנות פיזית ושל הטמעה של אירועים ב-Google Analytics.
• הוספנו את השדות youtube_members_count ו-gmail_members_count למשאב SizeInfo.

2026-03-26

• הוספנו את EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED ל-enum‏ ErrorReason.

  כדי לעמוד בדרישות של התקנות של האיחוד האירופי בנושא מודעות שקשורות לפוליטיקה באיחוד האירופי (EU PAR), Google מחייבת את כל הלקוחות להצהיר בעצמם אם המודעות שלהם נחשבות פוליטיות בהתאם לתקנות האלה. מה ההגדרה של מודעה שקשורה לפוליטיקה באיחוד האירופי ומה ההגבלות של Google על מודעות שקשורות לפוליטיקה באיחוד האירופי

  החל מ-1 באפריל 2026, יכול להיות שנחול הגבלות על הפעולות הבאות בחשבונות שבהם לא מופיעה ההצהרה הזו, או שהפעולות ייכשלו עם השגיאה EU_POLITICAL_ADVERTISING_DECLARATION_REQUIRED.

  • ‪UserListService (create, update, and delete)
  • IngestionService (ingestAudienceMembers)

  כדי לפתור את השגיאה, המפרסמים צריכים לספק את ההצהרה הנדרשת בממשק המשתמש של Google Ads. איך מצהירים לגבי חשבון

• הוספנו את INVALID_MERCHANT_ID ל-enum‏ ErrorReason.

‫2026-02-17 גרסה 1.5

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

• נוספו המשאבים UserList ו-UserListService כדי לאפשר יצירה, אחזור, עדכון ומחיקה של רשימות משתמשים.
  • במדריכים של Google Ads או של Display & Video 360 מוסבר איך ליצור קהלים מסוג התאמה ללקוחות, לאכלס אותם ולאמת אותם באמצעות Data Manager API.
  • שלבי ההעברה מפורטים במדריכי השדרוג של Google Ads או של Display & Video 360.
• הוספנו תמיכה בשליחת מזהה משתמש באמצעות הטמעה של משתמשים מקהל היעד, כך שאפשר להשתמש בו עם התאמה ללקוחות ב-Google Ads.
  • הוספת את UserIdData אל AudienceMember.
  • נוספו IngestUserIdDataStatus ו-RemoveUserIdDataStatus לסטטוסים שמוחזרים על ידי method‏ RetrieveRequestStatus. אפשר להשתמש בשדות האלה כדי לאחזר מידע אבחוני על הטמעה והסרה של מזהה משתמש.
• נוספו המשאבים PartnerLink ו-PartnerLinkService כדי ליצור ולנהל קישורים בין חשבונות של מפרסמים ושל שותפי נתונים.
  • כדי להתחיל, כדאי לעיין במדריכים בנושא קישורי שותפים.

2026-02-10

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

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

‫2025-11-05 גרסה 1.4

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

  • הוספנו את GOOGLE_ANALYTICS_PROPERTY לספירה 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

‫25.06.2025 גרסה 1.1

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

‫2025-04-02 v1.0

• הגרסה הראשונה של Data Manager API, עם תמיכה בשליחת נתוני קהלים אל Google Ads ו-Display & Video 360.
• הוספנו תמיכה ב-gRPC וב-REST.
• הוספנו את IngestionService עם השיטות IngestAudienceMembers ו-RemoveAudienceMembers לניהול חברי קהל באמצעות סוגי הנתונים הבאים:
  • פרטים ליצירת קשר
  • תעודות מזהות בנייד
  • מזהי זוגות
• קהלים שמנוהלים באמצעות Data Manager API עומדים בדרישות לטירגוט רק אם יש בהם לפחות 1,000 חברים.