מיפוי מזהים לממשק החדש של Search Ads 360

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

לישויות בממשק החדש של Search Ads 360 יש מרחב מזהים שונה מזה של הממשק הקודם של Search Ads 360. כדי לקבל את מיפוי המזהה בין הממשק הקודם לממשק החדש של Search Ads 360, צריך לשלוח בקשת Reports.getIdMappingFile() . התשובה כוללת מיפויים של מזהים לכל הישויות של מפרסם ספציפי.

דוגמה לקובץ שהוחזר (בפורמט CSV מקודד ב-UTF-8):

Entity Type,Legacy IDs,New IDs
CUSTOMER,"{""agencyId"":""20700000000000125"",""advertiserId"":""2170000012345"",""engineAccountId"":""700000000042205""}","{""customerId"":""200001235""}"

קובץ ה-CSV כולל 3 עמודות:

  • Entity Type: סוג הישות של השורה הזו.

  • Legacy IDs: מחרוזת JSON של נתיב הישות המלא בממשק הקודם של Search Ads 360

  • New IDs: מחרוזת JSON של נתיב הישות המלא בממשק החדש של Search Ads 360

בטבלה הבאה מוצגת רשימה של ישויות נתמכות ודוגמאות למיפויי מזהים:

סוג ישות תיאור מזהים מדור קודם מזהים חדשים
לקוח מיפוי מזהים של: 
advertiser:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345"
}

account:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205"
}
          
{
"customerId": "200001235"
}
קמפיין מיפוי מזהים עבור קמפיין. 
{
 "agencyId":"20700000000000125",
 "advertiserId":"2170000012345",
 "engineAccountId":"700000000042205",
 "campaignId":"71700000087192405"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555"
}
AD_GROUP מיפוי מזהים של adGroup. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084761225",
  "adGroupId": "58700007213529045"
}
          
{
  "customerId": "200001235",
  "campaignId": "13666840065",
  "adGroupId": "127701366165"
}
קריטריון מיפוי מזהים של: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "AdGroupCriterionId": "46700015332504045"
}
          
{
  "customerId": "200001235",
  "campaignId": "14660344555",
  "adGroupId":"105138634255",
  "criterionId":"948710340465"
}
AD מיפוי מזהה של מודעה. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000065395945",
  "adGroupId": "58700005797210525",
  "adId": "44700029299414085"
}
          
{
  "customerId": "200001235",
  "campaignId": "15314179325",
  "adGroupId": "131599768485",
  "adId": "562719339005"
}
CAMPAIGN_CRITERION מיפוי מזהים של: 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000084403015",
  "campaignTargetId": "38700011011700285"
}
          
{
  "customerId": "200001235",
  "campaignId": "13467100745",
  "campaignCriterionId": "2125"
}
CAMPAIGN_GROUP מיפוי מזהים לקבוצת הקמפיינים. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
}
CAMPAIGN_GROUP_PERFORMANCE_TARGET מיפוי מזהים ליעד הביצועים של קבוצת הקמפיינים. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "budgetGroupId": "87700002234256082",
  "budgetPlanId": "88700007187391026"
}
          
{
  "customerId": "200001235",
  "campaignGroupId": "1000665659"
  "campaignGroupPerformanceTargetId": "7624175"
}
FEED_TABLE מיפוי מזהים לטבלת הפידים. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700008040329135"
}
          
{
  "customerId": "200001235",
  "feedId": "207040045"
}
FEED_ITEM מיפוי מזהים של feedItem. 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

הורדת הדוח

JSON

GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/idmapping?alt=media

Python

def download_mapping_file(service, file_name, agency_id, advertiser_id):
  """Generate and save mapping file to a csv.

  Args:
    service: An authorized Doubleclicksearch service.
    file_name: Filename to write the ID mapping file.
    agency_id: DS ID of the agency.
    advertiser_id: DS ID of the advertiser.
  """
  request = service.reports().getIdMappingFile_media(agencyId=agency_id,
      advertiserId=advertiser_id)

  f = open(file_name + '.csv', 'w')
  f.write(request.execute().decode('utf-8'))
  f.close()

הייחודיות של מזהה האובייקט

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

מזהה אובייקט היקף הייחודיות ייחודי בכל העולם?
מזהה תקציב כל העולם כן
מזהה קמפיין כל העולם כן
קוד זיהוי של קבוצת מודעות כל העולם כן
קוד זיהוי מודעה קבוצת מודעות לא. (AdGroupId, AdId) הוא ייחודי באופן גלובלי.
מזהה GroupCriterion קבוצת מודעות לא. (AdGroupId, CriterionId) הוא ייחודי באופן גלובלי.
מזהה CampaignCriterion עדיפות לא. (CampaignId, CriterionId) הוא ייחודי באופן גלובלי.
תוספים למודעות עדיפות לא. (CampaignId, AdExtensionId) הוא ייחודי באופן גלובלי.
מזהה העדכון כל העולם כן
מזהה הפריט בפיד כל העולם כן
מזהה מאפיין פיד פיד לא
מזהה מיפוי עדכון כל העולם כן
קוד זיהוי תווית כל העולם כן
מזהה רשימת משתמשים כל העולם כן