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

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

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

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

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 (מזהה מילת המפתח) של ההמרה

נקודות הקצה (endpoints) עדיין ללא שינוי. צריך לציין את המזהה של הממשק החדש של 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"
    }
  ]
}
    

ציון הזמינות

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

POST  https://www.googleapis.com/doubleclicksearch/v2/conversion/updateAvailability
{
  "availabilities": [
    {
      "customerId": "123-123-1234"
      "segmentationType": "FLOODLIGHT",
      "segmentationName": "Test",
      "availabilityTimestamp": "1389348800000"
    }
  ]
}