สร้าง App Campaign

สร้าง 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_CAMPAIGN
OPTIMIZE_INSTALLS_TARGET_INSTALL_COST
target_cpa (target_cpa_micros = CPI เป้าหมาย) ไม่บังคับ การดำเนินการ DOWNLOAD สูงสุด 1 รายการใน conversion_actions
การติดตั้งมากขึ้นโดยไม่มี CPI เป้าหมาย
ปริมาณการติดตั้ง > ผู้ใช้ทั้งหมด กำหนดต้นทุนที่ตั้งไว้ต่อการติดตั้งแอปหนึ่งครั้ง (ไม่บังคับ) ล้างแล้ว
APP_CAMPAIGN
OPTIMIZE_INSTALLS_WITHOUT_TARGET_INSTALL_COST
maximize_conversions (ไม่มี target_cpa_micros) ไม่บังคับ การดำเนินการ DOWNLOAD สูงสุด 1 รายการ
การติดตั้งที่มีการกระทำในแอป (CPI เป้าหมาย)
ปริมาณการติดตั้ง > ผู้ใช้ที่มีแนวโน้มจะดำเนินการกระทำในแอป, ต้นทุนที่ตั้งไว้ต่อการติดตั้งแอปหนึ่งครั้ง
APP_CAMPAIGN
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_INSTALL_COST
target_cpa (target_cpa_micros = CPI เป้าหมาย) ต้องระบุ การกระทำในแอป 1 รายการ และการดำเนินการ DOWNLOAD ที่ไม่บังคับ
การกระทำในแอป (CPA ที่ตั้งไว้)
เลือกการกระทำในแอป, กำหนดต้นทุนต่อหนึ่งการกระทำในแอปเป้าหมาย (ไม่บังคับ) (หรือ ต้นทุนที่ตั้งไว้ต่อหนึ่งการกระทำสำหรับการมีส่วนร่วม)
APP_CAMPAIGN หรือ APP_CAMPAIGN_FOR_ENGAGEMENT
OPTIMIZE_IN_APP_CONVERSIONS_TARGET_CONVERSION_COST
target_cpa (target_cpa_micros = CPA ที่ตั้งไว้) ต้องระบุ การดำเนินการหลังการติดตั้ง ไม่บังคับ DOWNLOAD ใน APP_CAMPAIGN (ไม่มีในการมีส่วนร่วม)
การกระทำในแอปที่ไม่มี CPA ที่ตั้งไว้
การกระทำในแอป, กำหนดต้นทุนต่อหนึ่งการกระทำในแอปเป้าหมาย (ไม่บังคับ) ล้างแล้ว
APP_CAMPAIGN
OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA
maximize_conversions (ไม่มี target_cpa_micros) ต้องระบุ การดำเนินการหลังการติดตั้ง รวมถึงการดำเนินการ DOWNLOAD ที่ไม่บังคับ
มูลค่าการกระทำในแอป (ROAS เป้าหมาย)
มูลค่าการกระทำในแอป, เลือกกำหนดผลตอบแทนเป้าหมายจากค่าโฆษณา (ไม่บังคับ) (หรือ ผลตอบแทนเป้าหมายจากค่าโฆษณาสำหรับการมีส่วนร่วม)
APP_CAMPAIGN หรือ APP_CAMPAIGN_FOR_ENGAGEMENT
OPTIMIZE_RETURN_ON_ADVERTISING_SPEND
target_roas (target_roas = ROAS เป้าหมาย) ต้องระบุ การดำเนินการของค่า (เช่น Firebase หรือ GOOGLE_PLAY_IN_APP_PURCHASE) ไม่บังคับ DOWNLOAD ใน APP_CAMPAIGN เท่านั้น
มูลค่าการกระทำในแอปที่ไม่มี ROAS เป้าหมาย
มูลค่าการกระทำในแอป, กำหนดผลตอบแทนเป้าหมายจากค่าโฆษณา (ไม่บังคับ) ล้างแล้ว
APP_CAMPAIGN
OPTIMIZE_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 ดังนี้

  1. สร้าง CampaignBudget รายวันสำหรับ campaign_budget โดยตั้งค่า amount_micros และ explicitly_shared เป็น false (ค่าเริ่มต้นคือ true งบประมาณที่ใช้ร่วมกันและงบประมาณ CUSTOM_PERIOD จะไม่สำเร็จ) ดูสร้างงบประมาณแคมเปญ

  2. ตั้งค่า name และตั้งค่า status เป็น PAUSED (ไม่บังคับ) ขณะแนบโฆษณา (ค่าเริ่มต้นคือ ENABLED)

  3. ตั้งค่า advertising_channel_type ที่เปลี่ยนแปลงไม่ได้เป็น MULTI_CHANNEL และตั้งค่า advertising_channel_sub_type ที่เปลี่ยนแปลงไม่ได้เป็น APP_CAMPAIGN, APP_CAMPAIGN_FOR_ENGAGEMENT หรือ APP_CAMPAIGN_FOR_PRE_REGISTRATION

  4. ตั้งค่า contains_eu_political_advertising เป็น DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING หรือ CONTAINS_EU_POLITICAL_ADVERTISING การเรียก MutateCampaigns แบบสแตนด์อโลนต้องมีการประกาศเกี่ยวกับสหภาพยุโรป (EU) นี้ (ไม่บังคับใน v26 ขึ้นไปเมื่อกำหนดเป้าหมายเฉพาะสถานที่ตั้งนอกสหภาพยุโรปเท่านั้น โปรดดูโฆษณาทางการเมืองในสหภาพยุโรป)

  5. ตั้งค่า 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 สำหรับเป้าหมาย (เปลี่ยนแปลงได้)
  6. ตั้งค่ากลยุทธ์การเสนอราคามาตรฐานใน 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
  7. กำหนดค่าเป้าหมาย Conversion หรือการลงทะเบียนล่วงหน้า

  8. ไม่บังคับ: ตั้งแต่ v24 เป็นต้นไป ให้ตั้งค่า view_through_conversion_optimization_enabled เป็น true ในแคมเปญ Android APP_CAMPAIGN สําหรับการเสนอราคา Conversion การดูผ่าน (VTC) (ค่าเริ่มต้นของ UI คือ true, ค่าเริ่มต้นของ API คือ false)

  9. ไม่บังคับ: ตั้งค่า start_date_time (00:00:00, วันนี้หรือหลังจากนั้น) และ end_date_time (23:59:59) ในเขตเวลาของบัญชี (yyyy-MM-dd HH:mm:ss) โทร MutateCampaigns หรือ GoogleAdsService.Mutate

ไม่บังคับ: เพิ่มการกำหนดเป้าหมายและการยกเว้นแคมเปญ

ปรับแต่งการกำหนดเป้าหมายหลังจากสร้างหรือในคำขอ GoogleAdsService.Mutate เดียวกัน

แมปการตั้งค่า 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 ไว้โดยไม่ต้องตั้งค่า)

ตัวอย่างโค้ดและขั้นตอนถัดไป

แนบกลุ่มโฆษณาและชิ้นงานครีเอทีฟโฆษณาเพื่อให้แคมเปญแสดงโฆษณาได้ โดยทำดังนี้