نهادهای موجود در 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" } |
پس از میلاد | نقشه برداری شناسه برای تبلیغات | { "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 | نقشه برداری شناسه برای خوراک آیتم . | { "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
پایتون
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 جدید شما مفید باشد.
شناسه شی | دامنه منحصر به فرد بودن | در سطح جهانی منحصر به فرد؟ |
---|---|---|
شناسه بودجه | جهانی | بله |
شناسه کمپین | جهانی | بله |
شناسه AdGroup | جهانی | بله |
شناسه آگهی | گروه تبلیغات | شماره ( AdGroupId ، AdId ) در سطح جهانی منحصر به فرد است. |
AdGroupCriterion ID | گروه تبلیغات | شماره ( AdGroupId , CriterionId ) در سطح جهانی منحصر به فرد است. |
CampaignCriterion ID | کمپین | جفت ( CampaignId , CriterionId ) در سطح جهانی منحصر به فرد است. |
پسوندهای تبلیغاتی | کمپین | خیر. جفت ( CampaignId , AdExtensionId ) در سطح جهانی منحصر به فرد است. |
شناسه فید | جهانی | بله |
شناسه مورد فید | جهانی | بله |
شناسه ویژگی فید | خوراک | خیر |
شناسه نقشهبرداری فید | جهانی | بله |
شناسه برچسب | جهانی | بله |
شناسه لیست کاربری | جهانی | بله |