Ödeme ayarlarını yönetme

Doğrudan ödeme sayfasına yönlendirme özelliği, satın almaya hazır olan 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 kolaylaşabilir.

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

Bu kılavuzda, doğrudan ödeme sayfasına yönlendirme özelliği programına kaydınızı programatik olarak oluşturmak ve yönetmek için Merchant API'nin nasıl kullanılacağı 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 checkout_uri_template veya cart_uri_template ve seçilen eligible_destinations'ü ekleyin.

Örnek bir istek:

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} yerine Merchant Center hesabınızın benzersiz tanımlayıcısını girin.

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.

Örnek bir istek:

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 isteği aşağıda bulabilirsiniz:

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, ödeme programından kaydınızı siler ve ödeme bağlantılarının ücretsiz listelemelerdeki ve Alışveriş reklamlarındaki ürünlerinizde görünmesini durdurur.

Örnek bir istek:

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üzeyinde geçersiz kılma (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 alan adı olmalıdır.

Alt API'yi kullanarak ödeme bağlantıları oluşturduğunuzda 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, sitenizde kayıtlı alan adınızla eşleşen, HTTP GET yöntemiyle çalışan ve müşterinin oturum açmasını gerektirmeyen geçerli bir sayfaya yönlendirmelidir.
  • Sağlanan ödeme şablonundaki alan adı, ürün alanıyla eşleşmelidir.

Daha fazla bilgi