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

Search Ads 360 Reporting API החדש זמין עכשיו. ה-API החדש מספק גמישות משופרת ליצירה של דוחות בהתאמה אישית ולשילוב הנתונים באפליקציות הדיווח ותהליכים. מידע נוסף על המעבר לממשק החדש של Search Ads 360 ועל השימוש בו 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"
}
קריטריון מיפוי מזהים עבור: 
adGroupTarget and negativeAdGroupTarget:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "adGroupTargetId": "46700015332504045"
}

keyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "criterionId": "46700015332504045"
}

negativeAdGroupKeyword:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "negativeAdGroupCriterionId": "46700015332504045"
}

productGroup:
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "campaignId": "71700000068948065",
  "adGroupId": "58700006123995025",
  "productGroupId": "92700000508010025"
}
          
{
  "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) הוא ייחודי באופן גלובלי.
מזהה AdGroupCriterion קבוצת מודעות הצמד מספר (AdGroupId, CriterionId) הוא ייחודי באופן גלובלי.
מזהה CampaignCriterion קמפיין הצמד מספר (CampaignId, CriterionId) הוא ייחודי באופן גלובלי.
תוספים למודעות קמפיין הצמד מספר (CampaignId, AdExtensionId) הוא ייחודי באופן גלובלי.
מזהה העדכון גלובלי כן
מזהה הפריט בפיד גלובלי כן
מזהה מאפיין הפיד פיד לא
מזהה מיפוי פידים גלובלי כן
קוד זיהוי תווית גלובלי כן
מזהה של רשימת משתמשים גלובלי כן