تحتوي الكيانات في التجربة الجديدة من "إعلانات شبكة البحث 360" على مساحة أرقام تعريف مختلفة عن تلك التي تحتوي عليها التجربة السابقة من "إعلانات شبكة البحث 360".
لربط رقم التعريف بين التجربتَين السابقة والجديدة من "إعلانات شبكة البحث 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 لمسار الكيان الكامل في التجربة السابقة من "إعلانات شبكة البحث 360"New IDs
: سلسلة JSON لمسار الكيان الكامل في التجربة الجديدة من "إعلانات شبكة البحث 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()
تفرد رقم تعريف العنصر
يتم التعرّف على كل عنصر في تجربة "إعلانات شبكة البحث 360" الجديدة من خلال رقم تعريفه. وتكون بعض أرقام التعريف هذه فريدة على المستوى العالمي في جميع الحسابات في التجربة الجديدة من "إعلانات شبكة البحث 360"، في حين تكون أرقام تعريف أخرى فريدة ضمن نطاق محدود. على سبيل المثال، عليك استخدام كلٍّ من أرقام تعريف المجموعات الإعلانية وأرقام تعريف الإعلانات لتحديد الإعلانات بشكلٍ فريد، لأنّه يتم تخصيص أرقام تعريف الإعلانات بشكلٍ فريد لكل مجموعة إعلانية، وليس على مستوى المجموعات الإعلانية. في ما يلي توضيح لمدى التفرّد في كل رقم تعريف عنصر ضمن التجربة الجديدة من "إعلانات شبكة البحث 360". ويمكن أن تكون قواعد المعرّف هذه مفيدة عند تصميم مساحة تخزين محلية لعناصر التجربة الجديدة من "إعلانات شبكة البحث 360".
رقم تعريف العنصر | نطاق التفرّد | هل هي فريدة من نوعها عالميًا؟ |
---|---|---|
معرِّف الميزانية | البلدان المتحدثة | نعم |
معرّف الحملة | البلدان المتحدثة | نعم |
معرف المجموعة الإعلانية | البلدان المتحدثة | نعم |
الرقم التعريفي للإعلان | المجموعة الإعلانية | لا. الزوج (AdGroupId ، AdId ) فريد عالميًا. |
الرقم التعريفي لمعيار المجموعة الإعلانية | المجموعة الإعلانية | لا. الزوج (AdGroupId ، CriterionId ) فريد عالميًا. |
الرقم التعريفي لمعيار الحملة | الحملة | لا. الزوج (CampaignId ، CriterionId ) فريد عالميًا. |
معلومات الإعلان الإضافية | الحملة | لا. الزوج (CampaignId ، AdExtensionId ) فريد عالميًا. |
الرقم التعريفي للخلاصة | البلدان المتحدثة | نعم |
الرقم التعريفي لعنصر الخلاصة | البلدان المتحدثة | نعم |
الرقم التعريفي لسمة الخلاصة | الخلاصة | لا |
رقم تعريف تخطيط الخلاصة | البلدان المتحدثة | نعم |
الرقم التعريفي للتصنيف | البلدان المتحدثة | نعم |
رقم تعريف UserList | البلدان المتحدثة | نعم |