สร้าง App Campaign ด้วย Google Ads API เพื่อโปรโมตแอปบนมือถือใน Search, Google Play, YouTube, AdMob, Discover และเครือข่าย Display ของ Google เพิ่มประสิทธิภาพแคมเปญเพื่อการติดตั้ง การกระทำในแอป มูลค่า Conversion หรือการลงทะเบียนล่วงหน้าใน Android แคมเปญที่เปิดใช้จะมีการเรียกเก็บค่าบริการแสดงโฆษณา Google Ads มาตรฐานตามงบประมาณของคุณ
การเตรียมพร้อม
เป้าหมายแคมเปญ ไม่ว่าจะเป็นต้นทุนต่อการติดตั้งแอปหนึ่งครั้ง (CPI), ต้นทุนต่อหนึ่งการกระทำ (CPA), ผลตอบแทนจากค่าโฆษณา (ROAS) หรือการลงทะเบียนล่วงหน้า จะเป็นตัวกำหนดการตั้งค่า API ค้นหาเป้าหมายในตารางต่อไปนี้ก่อนทําตามขั้นตอนการสร้าง หากต้องการค้นหาตัวควบคุม UI ของ Google Ads โปรดดูแมปการตั้งค่า UI ของ Google Ads กับช่อง API หรือดูเกี่ยวกับ App Campaign
| การเลือกเป้าหมายและ UI ของ Google Ads | Enum ประเภทย่อยและเป้าหมาย | กลยุทธ์การเสนอราคา | การตั้งค่า Conversion (conversion_actions) |
|---|---|---|---|
|
การติดตั้งมากขึ้น (CPI เป้าหมาย) จำนวนการติดตั้ง > ผู้ใช้ทั้งหมด, เลือกกำหนดต้นทุนที่ตั้งไว้ต่อการติดตั้งแอปหนึ่งครั้ง (ไม่บังคับ) |
APP_CAMPAIGNOPTIMIZE_INSTALLS_TARGET_INSTALL_COST
|
target_cpa
(target_cpa_micros
= CPI เป้าหมาย)
|
ไม่บังคับ การดำเนินการ DOWNLOAD สูงสุด 1 รายการใน conversion_actions
|
|
การติดตั้งมากขึ้นโดยไม่มี CPI เป้าหมาย ปริมาณการติดตั้ง > ผู้ใช้ทั้งหมด กำหนดต้นทุนที่ตั้งไว้ต่อการติดตั้งแอปหนึ่งครั้ง (ไม่บังคับ) ล้างแล้ว |
APP_CAMPAIGNOPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST
|
maximize_conversions
(ไม่มี target_cpa_micros)
|
ไม่บังคับ การดำเนินการ DOWNLOAD สูงสุด 1 รายการ
|
|
การติดตั้งที่มีการกระทำในแอป (CPI เป้าหมาย) ปริมาณการติดตั้ง > ผู้ใช้ที่มีแนวโน้มจะดำเนินการกระทำในแอป, ต้นทุนที่ตั้งไว้ต่อการติดตั้งแอปหนึ่งครั้ง |
APP_CAMPAIGNOPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST
|
target_cpa (target_cpa_micros = CPI เป้าหมาย)
|
ต้องระบุ การกระทำในแอป 1 รายการ และการดำเนินการ DOWNLOAD ที่ไม่บังคับ
|
|
การกระทำในแอป (CPA ที่ตั้งไว้) เลือกการกระทำในแอป, กำหนดต้นทุนต่อหนึ่งการกระทำในแอปเป้าหมาย (ไม่บังคับ) (หรือ ต้นทุนที่ตั้งไว้ต่อหนึ่งการกระทำสำหรับการมีส่วนร่วม) |
APP_CAMPAIGN หรือ
APP_CAMPAIGN_FOR_ENGAGEMENTOPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST
|
target_cpa (target_cpa_micros = CPA ที่ตั้งไว้)
|
ต้องระบุ การดำเนินการหลังการติดตั้ง ไม่บังคับ
DOWNLOAD ใน APP_CAMPAIGN (ไม่มีในการมีส่วนร่วม)
|
|
การกระทำในแอปที่ไม่มี CPA ที่ตั้งไว้ การกระทำในแอป, กำหนดต้นทุนต่อหนึ่งการกระทำในแอปเป้าหมาย (ไม่บังคับ) ล้างแล้ว |
APP_CAMPAIGNOPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA
|
maximize_conversions (ไม่มี
target_cpa_micros)
|
ต้องระบุ การดำเนินการหลังการติดตั้ง รวมถึงการดำเนินการ DOWNLOAD ที่ไม่บังคับ
|
|
มูลค่าการกระทำในแอป (ROAS เป้าหมาย) มูลค่าการกระทำในแอป, เลือกกำหนดผลตอบแทนเป้าหมายจากค่าโฆษณา (ไม่บังคับ) (หรือ ผลตอบแทนเป้าหมายจากค่าโฆษณาสำหรับการมีส่วนร่วม) |
APP_CAMPAIGN หรือ
APP_CAMPAIGN_FOR_ENGAGEMENTOPTIMIZE_RETURN_ON_ADVERTISING_SPEND
|
target_roas
(target_roas
= ROAS เป้าหมาย)
|
ต้องระบุ การดำเนินการของค่า (เช่น Firebase หรือ GOOGLE_PLAY_IN_APP_PURCHASE) ไม่บังคับ DOWNLOAD ใน APP_CAMPAIGN เท่านั้น
|
|
มูลค่าการกระทำในแอปที่ไม่มี ROAS เป้าหมาย มูลค่าการกระทำในแอป, กำหนดผลตอบแทนเป้าหมายจากค่าโฆษณา (ไม่บังคับ) ล้างแล้ว |
APP_CAMPAIGNOPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS
|
maximize_conversion_value
(ไม่มี target_roas)
|
ต้องระบุ การดำเนินการที่มีมูลค่า (เช่น Firebase หรือ GOOGLE_PLAY_IN_APP_PURCHASE) รวมถึงการดำเนินการ DOWNLOAD (ไม่บังคับ)
|
|
การลงทะเบียนใช้แอปล่วงหน้า (Android เท่านั้น) การลงทะเบียนล่วงหน้า (ต้นทุนที่ตั้งไว้ต่อการลงทะเบียนแอปล่วงหน้า) |
APP_CAMPAIGN_FOR_PRE_REGISTRATION
(GOOGLE_APP_STORE เท่านั้น)OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME
|
target_cpa (target_cpa_micros = ต้นทุนที่ตั้งไว้ต่อการลงทะเบียนแอปล่วงหน้า)
|
ปล่อย selective_optimization ไว้โดยไม่ตั้งค่า เพิ่ม APP_PRE_REGISTRATION ลงใน optimization_goal_types
|
ขั้นตอน
สร้างทรัพยากรทั้งหมดแบบแยกส่วนในคำขอ GoogleAdsService.Mutate รายการเดียวโดยใช้รหัสชั่วคราวเชิงลบ หรือเรียกใช้ CampaignService.MutateCampaigns
กำหนดค่าและสร้างแคมเปญ
กำหนดค่าทรัพยากร Campaign ดังนี้
สร้าง
CampaignBudgetรายวันสำหรับcampaign_budgetโดยตั้งค่าamount_microsและexplicitly_sharedเป็นfalse(ค่าเริ่มต้นคือtrueงบประมาณที่ใช้ร่วมกันและงบประมาณCUSTOM_PERIODจะไม่สำเร็จ) ดูสร้างงบประมาณแคมเปญตั้งค่า
nameและตั้งค่าstatusเป็นPAUSED(ไม่บังคับ) ขณะแนบโฆษณา (ค่าเริ่มต้นคือENABLED)ตั้งค่า
advertising_channel_typeที่เปลี่ยนแปลงไม่ได้เป็นMULTI_CHANNELและตั้งค่าadvertising_channel_sub_typeที่เปลี่ยนแปลงไม่ได้เป็นAPP_CAMPAIGN,APP_CAMPAIGN_FOR_ENGAGEMENTหรือAPP_CAMPAIGN_FOR_PRE_REGISTRATIONตั้งค่า
contains_eu_political_advertisingเป็นDOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISINGหรือCONTAINS_EU_POLITICAL_ADVERTISINGการเรียกMutateCampaignsแบบสแตนด์อโลนต้องมีการประกาศเกี่ยวกับสหภาพยุโรป (EU) นี้ (ไม่บังคับใน v26 ขึ้นไปเมื่อกำหนดเป้าหมายเฉพาะสถานที่ตั้งนอกสหภาพยุโรปเท่านั้น โปรดดูโฆษณาทางการเมืองในสหภาพยุโรป)ตั้งค่า
app_campaign_settingเป็นออบเจ็กต์AppCampaignSetting(app_storeและapp_idเปลี่ยนแปลงไม่ได้) ดังนี้app_store:AppCampaignAppStore(GOOGLE_APP_STOREหรือAPPLE_APP_STOREการลงทะเบียนล่วงหน้าต้องใช้GOOGLE_APP_STORE)app_id: ชื่อแพ็กเกจ Google Play (com.example.app) หรือรหัสตัวเลขของ Apple App Store การมีส่วนร่วมต้องมีการติดตั้งขั้นต่ำ การลงทะเบียนล่วงหน้าต้องใช้แอปที่ลงทะเบียนล่วงหน้าใน Play Console ที่ยังไม่ได้เผยแพร่ (ไม่มีสิทธิ์ใช้APP_CAMPAIGNจนกว่าจะเปิดตัว)bidding_strategy_goal_type:AppCampaignBiddingStrategyGoalTypeสำหรับเป้าหมาย (เปลี่ยนแปลงได้)
ตั้งค่ากลยุทธ์การเสนอราคามาตรฐานใน
Campaign(ไม่รองรับทรัพยากรBiddingStrategyของพอร์ตโฟลิโอ) การสลับเป้าหมาย UI ที่ไม่บังคับจะเปลี่ยนทั้งbidding_strategy_goal_typeและช่องoneofของการเสนอราคา- CPI, CPA หรือการลงทะเบียนล่วงหน้าที่ตั้งไว้: ตั้งค่า
target_cpaด้วยtarget_cpa_microsที่เป็นบวกในหน่วยไมโครของสกุลเงินของบัญชี (1500000= 1.50 หน่วย เช่น 1.50 USD) - ROAS เป้าหมาย: ตั้งค่า
target_roasด้วยtarget_roasจาก0.01เป็น1000.0(3.0= ROAS 300%) - เพิ่มประสิทธิภาพสูงสุดโดยไม่มีเป้าหมาย (
APP_CAMPAIGNเท่านั้น): ตั้งค่าmaximize_conversionsหรือmaximize_conversion_valueเป็นค่าว่าง อย่าตั้งค่าmaximize_conversions.target_cpa_micros(ถูกปฏิเสธเมื่อMULTI_CHANNEL) หรือmaximize_conversion_value.target_roas
- CPI, CPA หรือการลงทะเบียนล่วงหน้าที่ตั้งไว้: ตั้งค่า
กำหนดค่าเป้าหมาย Conversion หรือการลงทะเบียนล่วงหน้า
APP_CAMPAIGNและAPP_CAMPAIGN_FOR_ENGAGEMENT: เพิ่มชื่อทรัพยากรConversionActionที่ตรงกับapp_idลงในselective_optimization.conversion_actions(ไม่ใช่CampaignConversionGoalหรือoptimization_goal_settingโปรดดูเป้าหมาย Conversion ของแคมเปญ) ในAPP_CAMPAIGNให้รวมการกระทำDOWNLOADไว้ไม่เกิน 1 รายการ เช่นGOOGLE_PLAY_DOWNLOADหรือfirst_openของ Firebase (ต้องใช้ UI, ไม่บังคับให้ใช้ API, ห้ามใช้กับการมีส่วนร่วม)APP_CAMPAIGN_FOR_PRE_REGISTRATION: ปล่อยให้selective_optimizationไม่ได้ตั้งค่า และเพิ่มAPP_PRE_REGISTRATIONลงในoptimization_goal_setting.optimization_goal_types
ไม่บังคับ: ตั้งแต่ v24 เป็นต้นไป ให้ตั้งค่า
view_through_conversion_optimization_enabledเป็นtrueในแคมเปญ AndroidAPP_CAMPAIGNสําหรับการเสนอราคา Conversion การดูผ่าน (VTC) (ค่าเริ่มต้นของ UI คือtrue, ค่าเริ่มต้นของ API คือfalse)ไม่บังคับ: ตั้งค่า
start_date_time(00:00:00, วันนี้หรือหลังจากนั้น) และend_date_time(23:59:59) ในเขตเวลาของบัญชี (yyyy-MM-dd HH:mm:ss) โทรMutateCampaignsหรือGoogleAdsService.Mutate
ไม่บังคับ: เพิ่มการกำหนดเป้าหมายและการยกเว้นแคมเปญ
ปรับแต่งการกำหนดเป้าหมายหลังจากสร้างหรือในคำขอ GoogleAdsService.Mutate เดียวกัน
- สถานที่ตั้งและภาษา: เพิ่มทรัพยากร
CampaignCriterionด้วยCampaignCriterionService.MutateCampaignCriteriaเช่น เกณฑ์languageและlocation(ดูเกณฑ์) - รายการคีย์เวิร์ดเชิงลบ: ลิงก์
CampaignSharedSetกับNEGATIVE_KEYWORDSSharedSet(ดูชุดที่ใช้ร่วมกัน) - กลุ่มเป้าหมาย: แนบเกณฑ์
UserListInfoที่จำเป็น (APP_CAMPAIGN_FOR_ENGAGEMENT) หรือสัญญาณAudienceInfo(APP_CAMPAIGN) ที่ไม่บังคับในกลุ่มโฆษณา (ดูสร้างกลุ่มโฆษณาแอปและโฆษณา)
แมปการตั้งค่า UI ของ Google Ads กับช่อง API
ใช้ตารางนี้เพื่อแมปตัวควบคุม UI ของ Google Ads กับช่อง Google Ads API (การเสนอราคาและงบประมาณสําหรับการติดตั้งแอป หรืองบประมาณและการเสนอราคาสําหรับการมีส่วนร่วมและการลงทะเบียนล่วงหน้า)
| ส่วนและป้ายกำกับ UI ของ Google Ads | ทรัพยากรและฟิลด์ API | รายละเอียด |
|---|---|---|
| แอป > เลือกประเภทย่อยของแคมเปญ (การติดตั้งแอป, การมีส่วนร่วมในแอป, การลงทะเบียนแอปล่วงหน้า (Android เท่านั้น)) |
Campaign.advertising_channel_type
Campaign.advertising_channel_sub_type
|
ไม่เปลี่ยนรูป: MULTI_CHANNEL ที่มี APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT หรือ APP_CAMPAIGN_FOR_PRE_REGISTRATION
|
| การตั้งค่าแคมเปญ > ชื่อแคมเปญ |
Campaign.name
|
ชื่อที่แสดงที่จำเป็นในบัญชีลูกค้า |
| การตั้งค่าแคมเปญ > แอปบนมือถือ |
Campaign.app_campaign_setting.app_store
Campaign.app_campaign_setting.app_id
|
ไม่สามารถเปลี่ยนแปลงได้: GOOGLE_APP_STORE (ชื่อแพ็กเกจ ต้องระบุสำหรับการลงทะเบียนล่วงหน้า) หรือ APPLE_APP_STORE (รหัสที่เป็นตัวเลข)
|
| การตั้งค่าแคมเปญ > สถานที่ตั้งและภาษา |
CampaignCriterion (location, language)
|
เพิ่มด้วย MutateCampaignCriteria หรือ GoogleAdsService.Mutate แบบอะตอม
|
| การตั้งค่าแคมเปญ > การเพิ่มประสิทธิภาพ Conversion การดูผ่าน > เปิด Conversion การดูผ่าน |
Campaign.view_through_conversion_optimization_enabled
|
Android APP_CAMPAIGN เท่านั้น (v24 ขึ้นไป) ค่าเริ่มต้นคือ true ใน UI และ false ใน API
|
| การตั้งค่าแคมเปญ > โฆษณาทางการเมืองในสหภาพยุโรป (แคมเปญของคุณมีโฆษณาทางการเมืองในสหภาพยุโรปหรือไม่) |
Campaign.contains_eu_political_advertising
|
แมปใช่ แคมเปญนี้มีโฆษณาทางการเมืองในสหภาพยุโรป และไม่ แคมเปญนี้ไม่มีโฆษณาทางการเมืองในสหภาพยุโรป |
| การตั้งค่าแคมเปญ > วันที่เริ่มต้นและวันที่สิ้นสุด |
Campaign.start_date_time
Campaign.end_date_time
|
การประทับเวลาเขตเวลาของบัญชีที่ไม่บังคับ (00:00:00 วันนี้หรือหลังจากนั้น และ 23:59:59)
|
| การเสนอราคาและงบประมาณ > งบประมาณ |
CampaignBudget.amount_micros
Campaign.campaign_budget
|
ไมโครรายวันในสกุลเงินของบัญชีโดยตั้งค่า CampaignBudget.explicitly_shared เป็น false
|
|
การเสนอราคาและงบประมาณ > การเสนอราคา > คุณต้องการมุ่งเน้นที่สิ่งใด และคุณต้องการกำหนดเป้าหมายผู้ใช้ประเภทใด กำหนดต้นทุนที่ตั้งไว้ต่อการติดตั้งแอปหนึ่งครั้ง (ไม่บังคับ) กำหนดต้นทุนต่อหนึ่งการกระทำในแอปเป้าหมาย (ไม่บังคับ) และ กำหนดผลตอบแทนเป้าหมายจากค่าโฆษณา (ไม่บังคับ) ต้นทุนที่ตั้งไว้ต่อการติดตั้งแอปหนึ่งครั้ง, ต้นทุนที่ตั้งไว้ต่อหนึ่งการกระทำ และผลตอบแทนเป้าหมายจากค่าโฆษณา |
Campaign.app_campaign_setting.bidding_strategy_goal_type,
Campaign.target_cpa.target_cpa_micros,
Campaign.target_roas.target_roas,
Campaign.maximize_conversions,
Campaign.maximize_conversion_value
|
ตั้งค่าทั้ง enum เป้าหมายและช่อง oneof ของการเสนอราคา (ดูการเตรียมพร้อม) กลยุทธ์ที่ไม่ใช่เป้าหมายจะมีผลกับ APP_CAMPAIGN เท่านั้น ใน iOS เพิ่มประสิทธิภาพเพื่อมูลค่า Conversion ของ SKAdNetwork จะเป็น UI เท่านั้น (อ่านสคีมาด้วย CustomerSkAdNetworkConversionValueSchema)
|
|
การเสนอราคาและงบประมาณ > การเสนอราคา > คุณต้องการติดตามจำนวนการติดตั้งอย่างไร การกระทำใดสำคัญต่อคุณที่สุด และ การกระทำใดบ้างที่สำคัญต่อคุณที่สุด |
Campaign.selective_optimization.conversion_actions
|
เครื่องมือเลือกการติดตั้งจะเพิ่มการดำเนินการ DOWNLOAD ได้สูงสุด 1 รายการ (APP_CAMPAIGN เท่านั้น) เครื่องมือเลือกการดำเนินการจะเพิ่มการดำเนินการ 1 รายการ (เอกพจน์) หรือหลายรายการ (พหูพจน์) ที่ตรงกับ app_id
|
| งบประมาณและการเสนอราคา > การเสนอราคา > การลงทะเบียนล่วงหน้าและต้นทุนที่ตั้งไว้ต่อการลงทะเบียนแอปล่วงหน้า |
Campaign.target_cpa.target_cpa_micros
Campaign.optimization_goal_setting.optimization_goal_types
|
ใช้ OPTIMIZE_PRE_REGISTRATION_CONVERSION_VOLUME และ APP_PRE_REGISTRATION (ปล่อย selective_optimization ไว้โดยไม่ต้องตั้งค่า)
|
ตัวอย่างโค้ดและขั้นตอนถัดไป
แนบกลุ่มโฆษณาและชิ้นงานครีเอทีฟโฆษณาเพื่อให้แคมเปญแสดงโฆษณาได้ โดยทำดังนี้
- สร้างกลุ่มโฆษณาแอปและโฆษณาแอป: เพิ่มทรัพยากร
AdGroup(พร้อมเกณฑ์UserListInfoที่จำเป็นในAPP_CAMPAIGN_FOR_ENGAGEMENT) และโฆษณาแอป - ตัวอย่างโค้ด App Campaign: ตรวจสอบตัวอย่าง
AddAppCampaignหลายภาษาที่สร้างงบประมาณ แคมเปญ เกณฑ์ กลุ่มโฆษณา และโฆษณา - การรายงาน App Campaign: ค้นหาแคมเปญ ชิ้นงาน การติดตั้ง และเมตริก SKAdNetwork ด้วย Google Ads Query Language