การแมปรหัสสำหรับ 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"
}
ทดสอบ การแมปรหัสสําหรับเกณฑ์ระดับกลุ่มโฆษณา 
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 การแมปรหัสสําหรับ 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"
}

สาเหตุทั่วไปที่ทำให้เอนทิตีหายไป

แม้ว่าไฟล์การแมปของผู้ลงโฆษณาจะมีเอนทิตีส่วนใหญ่ แต่ก็ยังอาจมีบางกรณีที่ไม่มีเอนทิตี ซึ่งอาจเกิดจากสาเหตุที่พบบ่อยต่อไปนี้

  • ไฟล์การแมปแต่ละไฟล์จะอัปเดตทุก 3 วัน หากดาวน์โหลดไฟล์การแมปทันทีหลังจากสร้างเอนทิตีใหม่ เอนทิตีนั้นอาจไม่อยู่ในไฟล์การแมป รายการดังกล่าวมีแนวโน้มที่จะรวมอยู่ด้วยหลังจากรอไม่เกิน 3 วัน
  • ระบบจะนำบัญชีที่บุคคลนั้นเป็นเจ้าของออก เราไม่รองรับการแมปรหัสในกรณีนี้

ดาวน์โหลดรายงาน

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 เวอร์ชันใหม่

รหัสออบเจ็กต์ ขอบเขตของการไม่ซ้ำกัน ซ้ำกันทั่วโลกไหม
รหัสงบประมาณ ทั่วโลก ใช่
รหัสแคมเปญ ทั่วโลก ใช่
รหัส AdGroup ทั่วโลก ใช่
รหัสโฆษณา กลุ่มโฆษณา ไม่ คู่ (AdGroupId, AdId) ไม่ซ้ำกันทั่วโลก
รหัสเกณฑ์ของกลุ่มโฆษณา กลุ่มโฆษณา ไม่ คู่ (AdGroupId, CriterionId) แต่ละคู่จะซ้ำกันทั่วโลก
รหัสเกณฑ์แคมเปญ แคมเปญ ไม่ คู่ (CampaignId, CriterionId) แต่ละคู่จะซ้ำกันทั่วโลก
ส่วนขยายโฆษณา แคมเปญ ไม่ คู่ (CampaignId, AdExtensionId) แต่ละคู่จะซ้ำกันทั่วโลก
รหัสฟีด ทั่วโลก ใช่
รหัสรายการฟีด ทั่วโลก ใช่
รหัสแอตทริบิวต์ฟีด ฟีด ไม่ได้
รหัสการแมปฟีด ทั่วโลก ใช่
รหัสป้ายกำกับ ทั่วโลก ใช่
รหัส UserList ทั่วโลก ใช่