הממשק החדש של Search Ads 360

בממשק החדש של Search Ads 360, המערכת מקצה מזהים חדשים לחשבונות משתמשים, לקמפיינים, לקבוצות של מודעות, מילות מפתח (קריטריונים) ומודעות. יש שני שינויים נוספים בהתנהגות של המזהים האלה:

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

  • בממשק החדש של Search Ads 360, המערכת לא מקצה יותר מזהים ייחודיים למילות מפתח ולמודעות.

ה-Conversion API מקבל עכשיו מספרי לקוח של הממשק החדש של Search Ads 360, בכל מקום שבו מזהה הסוכנות מקבלים את מזהה המפרסם ואת המזהים של חשבונות המנוע. אם מציינים API ללקוח, ה-API מצפה שמזהה הקמפיין, מזהה קבוצת המודעות, מזהה מילת המפתח ומזהה המודעה יהיו מזהים של הממשק החדש של Search Ads 360. כשמשתמשים במזהי מילות מפתח או מודעות בממשק החדש של Search Ads 360, צריך לציין את מזהי הקמפיין וקבוצת המודעות בכל פעם שבבקשה נעשה שימוש במילת מפתח או במזהה מודעה.

כשנעשה שימוש במזהה חדש של Search Ads 360 בבקשה, התשובה תשתמש גם במזהה המזהים של הממשק החדש של Search Ads 360.

הצגת רשימה של המרות

יש נקודת קצה חדשה לבקשת הרשימה עם המזהה החדש של Search Ads 360. שלך צריך לספק מספר לקוח של חשבון לקוח. אפשר גם לציין את מזהה הקמפיין. ואת מזהה קבוצת המודעות להכללה בפרמטרים של שאילתה. וגם endDate, rowCount, startDate ו-startRow עדיין נדרשים.

בקשת HTTP

GET https://www.googleapis.com/doubleclicksearch/v2/customer/customerId/conversion

הוספה/עדכון של המרה

אנחנו תומכים בבקשה הבאה באמצעות המזהה החדש של Search Ads 360:

  • שיוך המרה למילת מפתח בלבד
  • עדכון ההמרה עם criterionId של ההמרה (מזהה מילת המפתח) צוין

נקודות הקצה לא השתנו. צריך לספק את הממשק החדש של Search Ads 360 מזהה בכל משאב המרה: במקום להגדיר agencyId, את advertiserId ואת engineAccountId, עליך לספק customerId, ומשתמשים במזהה החדש של Search Ads 360 campaignId, adGroupId, criterionId, adId במקרה הצורך.

דוגמה לבקשה שממחישה איך להשתמש במזהה החדש של Search Ads 360 כדי: לשייך המרה למילת מפתח.

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion
{
  "conversion" : [
    {
      "customerId": "123-123-1234"
      "campaignId": "10000001",
      "adGroupId": "20000001",
      "criterionId": "30000001",
      "conversionId": "floodlight conversion ID 1",
      "conversionTimestamp": "1660799917714",
      "type": "ACTION",
      "quantityMillis": "1000",
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test"
    }
  ]
}