تعيين رقم التعريف لتجربة "إعلانات شبكة البحث 360" الجديدة

أصبحت Search Ads 360 Reporting API الجديدة متاحة الآن. توفّر واجهة برمجة التطبيقات الجديدة مرونة محسّنة لإنشاء تقارير مخصّصة ودمج البيانات في تطبيقات وعمليات إعداد التقارير. اطّلِع على مزيد من المعلومات عن نقل البيانات إلى Search Ads 360 Reporting API الجديدة وكيفية استخدامها.

تختلف مساحة التعريفات في التجربة الجديدة من "إعلانات شبكة البحث 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"
}
المعيار ربط الأرقام التعريفية للمعايير على مستوى المجموعة الإعلانية: 
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 تعيين أرقام التعريف لعنصر feedItem 
{
  "agencyId": "20700000000000125",
  "advertiserId": "2170000012345",
  "engineAccountId": "700000000042205",
  "feedTableId": "32700014854183375",
  "feedItemRowId": "33700014854183415"
}
          
{
  "customerId": "200001235",
  "feedId": "377982485",
  "feedItemId": "235028589065"
}

الأسباب الشائعة لعدم توفّر الكيانات

على الرغم من أنّ ملف الربط الخاص بالمعلِن سيتضمّن معظم كيانات المعلِن، ستظلّ هناك بعض الحالات التي لن تتوفّر فيها الكيانات. إليك بعض الأسباب الأكثر شيوعًا:

  • يتم تعديل كل ملف ربط كل 3 أيام. إذا تم تنزيل ملفّ ربط على الفور بعد إنشاء عنصر جديد، من المرجّح ألا يكون العنصر مضمّنًا في ملفّ الربط. من المرجّح أن يتم تضمين المحتوى بعد الانتظار لمدة تصل إلى 3 أيام.
  • تتم إزالة الحساب الذي ينتمي إليه الكيان. لا نتيح ربط الأرقام التعريفية في هذه الحالة.
  • لا تتوفّر إمكانية إجراء تعديل في عنصر (مثل الحملة) من جانب المحرّك في التجربة الجديدة من "إعلانات شبكة البحث 360". تمّت معالجة التعديلات من خلال إنشاء كيان جديد في "إعلانات شبكة البحث 360"، مع إجراء التعديل وإزالة الكيان السابق في "إعلانات شبكة البحث 360" لاحقًا.
  • من المحتمل أنّه تمت إزالة عمليات الربط السابقة نتيجة المزامنة بين التجربتَين القديمة والجديدة من "إعلانات شبكة البحث 360"، حيث يتم الاحتفاظ بآخر عملية ربط فقط. يتمّ حلّ عمليات الربط المتعدّدة بين رقم تعريف قديم واحد وأرقام تعريف جديدة متعددة في "إعلانات شبكة البحث 360"، مع الاحتفاظ برقم التعريف الذي يتضمّن الطابع الزمني الأخير.
  • لا تتم مزامنة حساب محرّك البحث بسبب أخطاء في المزامنة بين التجربتَين القديمة والجديدة من "إعلانات شبكة البحث 360".
  • تتم إزالة الحساب أو إيقافه.

تنزيل التقرير

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) هما رقمان فريدان على مستوى العالم.
رقم تعريف CampaignCriterion الحملة رقمَا (CampaignId، CriterionId) هما رقمان فريدان على مستوى العالم.
معلومات الإعلان الإضافية الحملة رقمَا (CampaignId، AdExtensionId) هما رقمان فريدان على مستوى العالم.
الرقم التعريفي للخلاصة عالمي نعم
الرقم التعريفي لعنصر الخلاصة عالمي نعم
رقم تعريف سمة الخلاصة الخلاصة لا
رقم تعريف تعيين الخلاصة عالمي نعم
الرقم التعريفي للتصنيف عالمي نعم
رقم تعريف قائمة المستخدمين عالمي نعم