Ödeme ayarlarını yönetme

Doğrudan ödeme sayfasına yönlendirme özelliği, satın almaya hazır müşterilerin Google ürün listelemelerinden doğrudan web sitenizin alışveriş sepeti veya ödeme sayfasına gitmesine olanak tanıyarak satın alma sürecini hızlandırır. Bu sayede dönüşüm oranları artabilir ve alışveriş deneyimi sorunsuz hale gelebilir.

Merchant API ile bu özelliğin ayarlarını CheckoutSettings kaynağını kullanarak yönetebilirsiniz.

Bu kılavuzda, doğrudan ödeme sayfasına yönlendirme özelliğine kaydınızı programatik olarak oluşturmak ve yönetmek için Merchant API'yi nasıl kullanacağınız açıklanmaktadır.

Daha fazla bilgi için Ürünleriniz için ödeme bağlantısı ekleme başlıklı makaleyi inceleyin.

Ön koşullar

CheckoutSettings kaynağını ve ilişkili yöntemleri kullanmak için aşağıdakileri yaptığınızdan emin olun:

  • Alışveriş reklamları, ücretsiz listelemeler veya her ikisi için de onaylanmış olmanız ve bu özelliklerden yararlanıyor olmanız gerekir.
  • Satış yaptığınız ülke ABD olmalıdır.

Yöntemler

Ödeme ayarlarını oluşturmak, almak, güncellemek ve silmek için aşağıdaki yöntemleri kullanabilirsiniz:

Ödeme ayarları oluşturma

Ödeme ayarı oluşturmak için checkoutSettings.create yöntemini kullanın. İstek gövdesine uri_settings ile birlikte checkout_uri_template veya cart_uri_template ve seçilen eligible_destinations öğesini ekleyin.

Aşağıda örnek bir istek verilmiştir:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

{
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ]
}

{ACCOUNT_ID} kısmını Merchant Center hesabınızın benzersiz tanımlayıcısıyla değiştirin.

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Ödeme ayarlarını alma

URL şablonu, seçilen hedefler, kayıt durumu ve URL inceleme durumu dahil olmak üzere ödeme ayarlarınızı almak için checkoutSettings.get yöntemini kullanın.

Aşağıda örnek bir istek verilmiştir:

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS",
    "SHOPPING_ADS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "APPROVED",
  "effective_uri_settings": {
    "checkout_uri_template": "https://www.your-store.com/checkout?item_id={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "APPROVED"
}

Ödeme ayarlarını güncelleme

Ödeme ayarlarınızı güncellemek için checkoutSettings.update yöntemini kullanın. İstek gövdesine değiştirmek istediğiniz alanları ekleyin ve bu alanları update_mask sorgu parametresinde belirtin.

update_mask aşağıdaki alanları destekler:

  • eligible_destinations
  • uri_settings

URL'yi güncelleyen ve reklam hedefinin kaldırıldığı örnek bir istek aşağıda verilmiştir:

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings?update_mask=uri_settings,eligible_destinations

{
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ]
}

Başarılı bir çağrıdan alınan örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings",
  "uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "eligible_destinations": [
    "FREE_LISTINGS"
  ],
  "enrollment_state": "ENROLLED",
  "review_state": "IN_REVIEW", // Review state will always be set to "IN_REVIEW" after URL update
  "effective_uri_settings": {
    "cart_uri_template": "https://shop.your-store.com/add_to_cart?sku={id}"
  },
  "effective_enrollment_state": "ENROLLED",
  "effective_review_state": "IN_REVIEW"
}

Sil

Ödeme ayarlarını silmek için checkoutSettings.delete yöntemini kullanın.

Bu işlem, hesap düzeyindeki yapılandırmanızı kaldırır, sizi ödeme programından çıkarır ve ödeme bağlantılarının ücretsiz listelemelerdeki ve Alışveriş reklamlarındaki ürünlerinizde görünmesini durdurur.

Aşağıda örnek bir istek verilmiştir:

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/checkout/checkoutSettings

Başarılı bir çağrı, boş bir yanıt gövdesi döndürür.

Ürünleriniz için ödeme URL'leri sağlamanın iki yolu vardır:

  • Hesap düzeyi (alt API veya Merchant Center): Tek bir URL şablonu tanımlamak için checkout_uri_template veya cart_uri_template alt API'yi ya da Merchant Center ayarlarını kullanabilirsiniz. Bu şablon, uygun tüm ürünlerinize uygulanır. Ürünlerinizde tutarlı bir URL kullanmanızı öneririz. Örneğin, yourstore.com/checkout?id={id}.

  • Ürün düzeyi (Feed): Tek tek ürünler için belirli bir ödeme URL'si sağlamak istiyorsanız ürün feed'inizde checkout_link_template özelliğini kullanın. Bu sayede ürün başına özelleştirilmiş URL'ler kullanabilir veya envanterinizin yalnızca bir alt kümesi için ödeme sunabilirsiniz.

  • Bu alt API'yi kullanarak hesap düzeyinde bir URL şablonu ayarlarsanız söz konusu ürünler için feed'inizde checkout_link_template özelliğiyle ilgili değer göndermediğinizden emin olun.

  • checkout_link_template feed özelliğini kullanıyorsanız alt API'yi veya Merchant Center ayarlarını kullanarak hesap düzeyinde bir URL şablonu ayarlamadığınızdan emin olun. URL'leri yalnızca feed üzerinden yönetiyorsanız uri_settings sağlamadan eligible_destinations seçmek için alt API'yi kullanmaya devam edebilirsiniz.

Ödeme URL'si şablonu

Ödeme URL'si şablonu, ürün verilerinize ödeme URL'si eklemenize olanak tanır. Bu URL'leri kullanarak internetten alışveriş yapan müşterileri listelemelerinizden doğrudan ödeme sayfanıza yönlendirebilirsiniz. {ID} parametre yer tutucusunu içermeli ve eşleşen bir alana sahip olmalıdır.

Alt API'yi kullanarak ödeme bağlantılarını ayarladığınızda uri_settings alanını kullanın. Bu alan, iki şablondan birini kabul eder:

  • checkout_uri_template: Yer tutucu doldurulduğunda kullanıcıyı belirli bir öğe satın alınmaya hazır şekilde ödeme sayfanıza yönlendiren bir URL şablonu.
  • cart_uri_template: Kullanıcıyı, alışveriş sepetinize eklenen belirli bir öğeyle birlikte alışveriş sepeti sayfanıza yönlendiren bir URL şablonu.

Örnek şablonlar

  • Ödeme: https://www.your-store.com/checkout?item_id={id}
  • Alışveriş sepeti: https://shop.your-store.com/add_to_cart?product_sku={id}

Aşağıdaki koşulları karşıladığınızdan emin olun:

  • URL şablonunuz, kayıtlı alan adınızla eşleşen, HTTP GET yöntemiyle çalışan ve müşterinin oturum açmasını gerektirmeyen sitenizdeki geçerli bir sayfaya yönlendirmelidir.
  • Sağlanan ödeme şablonundaki alan, ürün alanıyla eşleşmelidir.

Daha fazla bilgi