Bağlılık programlarına genel bakış

Bağlılık programlarını kullanarak mağazanızın avantajlarını Google'da sergileyin. Ücretsiz kargo, puanlar ve üyelere özel fiyatlandırma gibi çeşitli avantajlar gönderebilirsiniz. Bağlılık programınızın avantajları Google Arama, Alışveriş sekmesi ve Google Cüzdan dahil olmak üzere Google platformlarındaki ücretsiz listelemelerde, Alışveriş reklamlarında ve yerel envanter reklamlarında gösterilebilir.

Merchant API ile satıcılar ve satıcılar adına hareket eden üçüncü taraf bağlılık programı sağlayıcıları, LoyaltyProgramService kullanarak bağlılık programlarını programatik olarak yapılandırıp sürdürebilir. Bu hizmet, bağlılık programları oluşturmanıza, almanıza, listelemenize, güncellemenize ve silmenize olanak tanır.

Önemli: Bu hizmet yalnızca belirli satıcılar tarafından kullanılabilir. Katılım isteğinde bulunmak için destek ekibiyle iletişime geçin. İzin verilenler listesine ekleme isteğini Sorun/soru nedir?bölümündeki Shopping API Destek Formu üzerinden gönderin. > İzin verilenler listesi isteği > Diğer'i seçin.

İşletme şartları ve politika yönergeleri hakkında daha fazla bilgi için Merchant Center Yardım Merkezi'ndeki Satıcı bağlılık programı hakkında başlıklı makaleyi inceleyin.

Temel kavramlar

Sadakat programlarıyla çalışırken aşağıdaki kavramları ve sınırlamaları göz önünde bulundurun:

• Hesap düzeyinde tanımlayıcı: Merchant API, bağlılık programlarını sahibi olan Merchant Center hesabı kimliğine göre tanımlar.
• Tek program sınırı: Merchant API, satıcı hesabı başına yalnızca bir bağlılık programını destekler.
• Doğrudan hesap sahipliği: Bağlılık programları doğrudan hedef satıcı hesabında (accounts/{ACCOUNT_ID}) yapılandırılmalıdır. Hizmet, bağlılık programlarının alt hesaplar için gelişmiş hesap düzeyinde yönetilmesini desteklemez. Bir satıcının hesabına yetkili erişimi olan üçüncü taraf bağlılık sağlayıcılar, programı satıcı adına yönetebilir.
• İçerik incelemesi: Bağlılık programı oluşturulduktan veya güncellendikten sonra incelemeye tabi tutulur. review_result.review_status alanı, programın UNDER_REVIEW, APPROVED veya REJECTED olup olmadığını gösterir.
• Desteklenen bölgeler: Satıcı bağlılık programları; ABD, Almanya, Avustralya, Birleşik Krallık, Brezilya, Fransa, Güney Kore, Hindistan, Hollanda, İspanya, İtalya, Kanada ve Meksika dahil olmak üzere desteklenen ülkelerde kullanılabilir.
• Katman koşulları: Katmanlara katılmak ücretsiz olabilir, üyelik ücreti gerektirebilir, harcama eşiği gerektirebilir veya satıcı markalı kredi kartı gerektirebilir. Mesleğe dayalı katmanlar (ör. öğrenci veya asker katmanları) desteklenmez.
• Ayrıcalıklar ve avantajlar: Programlar; ücretsiz kargo, kullanılabilir puanlar ve üyelere özel fiyatlandırmayı destekler. Reklamlarda üyelere özel fiyatlandırma için normal fiyat veya indirimli fiyat üzerinden en az% 5 ya da 5 para birimi indirim uygulanması gerekir.

Ön koşullar

Merchant API ile bağlılık programlarını yönetmeden önce aşağıdaki koşulları karşıladığınızdan emin olun:

• Etkin bir Merchant Center hesabınız olmalıdır (veya üçüncü taraf bir bağlılık programı sağlayıcısıysanız satıcının hesabına yetkili erişiminiz olmalıdır).
• Hesabınız için Bağlılık programı eklentisini etkinleştirin. Aşağıdaki seçeneklerden birini kullanarak eklentiyi etkinleştirebilirsiniz:
  • Merchant Center kullanıcı arayüzü: Merchant Center Yardım Merkezi'ndeki Bağlılık programı oluşturma başlıklı makaledeki talimatları uygulayın.
  • Programs alt API'si: Programı, Programs alt API'sinde programları etkinleştirme başlıklı makalede açıklandığı şekilde programatik olarak etkinleştirin.

Programs alt API'sini kullanarak bağlılık programı eklentisini etkinleştirmeye yönelik örnek bir isteği aşağıda bulabilirsiniz:

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable

cURL

curl --request POST \
  'https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty:enable?key={YOUR_API_KEY}' \
  --header 'Authorization: Bearer {YOUR_ACCESS_TOKEN}' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

Yöntemler

Aşağıdaki yöntemleri kullanarak bağlılık programlarını yönetin:

• loyaltyPrograms.create
• loyaltyPrograms.get
• loyaltyPrograms.list
• loyaltyPrograms.update
• loyaltyPrograms.delete

Bağlılık programı oluşturma

Bir hesap için yeni bir bağlılık programı oluşturmak üzere loyaltyPrograms.create yöntemini kullanın. Program açıklamaları, kayıt URL'si ve benzersiz avantajları ve koşulları olan program katmanları gibi ayrıntıları belirtin.

Zorunlu program_label, bağlılık programının benzersiz tanımlayıcısını ayarlar. Örneğin, my-rewards etiketini sağlamak accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards name kaynağıyla sonuçlanır.

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

HTTP

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

{
  "programLabel": "my-rewards",
  "loyaltyProgram": {
    "programName": "my rewards",
    "tiers": [
      {
        "tierName": "gold",
        "tierLabel": "gold",
        "tierBenefits": [
          {
            "otherBenefit": "free gift on your birthday"
          },
          {
            "structuredBenefit": {
              "pointsEarningBenefit": {
                "minimumMoneySpent": {
                  "currencyCode": "USD",
                  "units": "25"
                },
                "pointsEarningBenefitAnnotation": {
                  "pointsEarned": 1.0,
                  "amountSpent": {
                    "currencyCode": "USD",
                    "units": "1"
                  }
                }
              }
            }
          }
        ],
        "requirements": {
          "freeToJoin": true
        }
      }
    ],
    "programDescriptions": [
      "earn rewards buying products you love"
    ],
    "signupUrl": "https://www.example.com/my_rewards_signup",
    "regionCodes": [
      "US"
    ]
  }
}

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

Başarılı bir isteğin örnek yanıtını aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Bağlılık programını alma

Belirli bir bağlılık programının ayrıntılarını almak için loyaltyPrograms.get yöntemini kullanın.

Not: Bağlılık programı eklentisi etkinleştirilmemiş olsa bile bu uç nokta, hata döndürmeden eşleşen bir bağlılık programıyla yanıt vermeye devam eder.

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

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{ACCOUNT_ID} yerine hesap kimliğinizi, {PROGRAM_LABEL} yerine ise bağlılık programının benzersiz etiketini (örneğin, my-rewards) girin.

Başarılı bir isteğin örnek yanıtını aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "earn rewards buying products you love"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Bağlılık programlarını listeleme

Hesabınızla ilişkili tüm bağlılık programlarını listelemek için loyaltyPrograms.list yöntemini kullanın.

Not: Bu yöntemde yalnızca belirtilen hesaba doğrudan ait olan bağlılık programları listelenir. Alt hesaplarla ilişkili programlar listelenmez. Bağlılık programı eklentisi devre dışı olsa bile bu uç nokta, hata döndürmeden mevcut programlarla yanıt verir.

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

HTTP

GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms

Başarılı bir isteğin örnek yanıtını aşağıda bulabilirsiniz:

{
  "loyaltyPrograms": [
    {
      "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
      "programName": "my rewards",
      "tiers": [
        {
          "tierName": "gold",
          "tierLabel": "gold",
          "tierBenefits": [
            {
              "otherBenefit": "free gift on your birthday"
            },
            {
              "structuredBenefit": {
                "pointsEarningBenefit": {
                  "minimumMoneySpent": {
                    "currencyCode": "USD",
                    "units": "25"
                  },
                  "pointsEarningBenefitAnnotation": {
                    "pointsEarned": 1.0,
                    "amountSpent": {
                      "currencyCode": "USD",
                      "units": "1"
                    }
                  }
                }
              }
            }
          ],
          "requirements": {
            "freeToJoin": true
          },
          "signupUrl": "https://www.example.com/my-rewards/gold"
        }
      ],
      "programDescriptions": [
        "earn rewards buying products you love"
      ],
      "signupUrl": "https://www.example.com/my_rewards_signup",
      "reviewResult": {
        "reviewStatus": "UNDER_REVIEW"
      },
      "regionCodes": [
        "US"
      ]
    }
  ]
}

Bağlılık programını güncelleme

Mevcut bir bağlılık programını güncellemek için loyaltyPrograms.update yöntemini kullanın. update_mask kullanarak kısmi güncelleme yapın veya maskeyi atlayarak tam değiştirme gerçekleştirin.

Önemli: Bir bağlılık programı güncellenirken yinelenen alanlar (ör. programDescriptions ve tiers) yerinde güncellenemez. Güncellemeye dahil edilen tüm tekrarlanan alanlar, mevcut listenin tamamının yerini alır. İstenmeyen veri kaybını önlemek için, tekrarlanan alanları güncellemeden önce get mevcut değerleri almak üzere istek gönderin.

Güncelleme maskesiyle kısmi güncelleme

update_mask, güncellenecek alanları tam olarak belirtmenize olanak tanır. Yalnızca maskede listelenen alanlar değiştirilirken listelenmeyen alanlar değişmeden kalır. Güncelleme maskesinde atlanan tüm alanlar, istek gövdesinde sağlansa bile yoksayılır.

Aşağıdaki örnek istek yalnızca programDescriptions ve advancedSettings için güncellemeler yapar:

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}?update_mask=program_descriptions,advanced_settings

{
  "programDescriptions": [
    "a new description of the program"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  },
  "signupUrl": "https://www.example.com"
}

Bu örnekte hizmet, signupUrl öğesini update_mask içinde yer almadığı için yoksayar. programDescriptions alanı, daha önce yapılandırılmış tüm açıklamaların yerini tamamen alır.

Başarılı bir isteğe verilen örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "my rewards",
  "tiers": [
    {
      "tierName": "gold",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "free gift on your birthday"
        },
        {
          "structuredBenefit": {
            "pointsEarningBenefit": {
              "minimumMoneySpent": {
                "currencyCode": "USD",
                "units": "25"
              },
              "pointsEarningBenefitAnnotation": {
                "pointsEarned": 1.0,
                "amountSpent": {
                  "currencyCode": "USD",
                  "units": "1"
                }
              }
            }
          }
        }
      ],
      "requirements": {
        "freeToJoin": true
      },
      "signupUrl": "https://www.example.com/my-rewards/gold"
    }
  ],
  "programDescriptions": [
    "a new description of the program"
  ],
  "signupUrl": "https://www.example.com/my_rewards_signup",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ],
  "advancedSettings": {
    "hideDisplayFromNonMembers": true
  }
}

Güncelleme maskesi olmadan tam değiştirme

update_mask parametresini atladığınızda istek, bağlılık programı yapılandırmasının tamamen değiştirilmesini sağlar.

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

HTTP

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

{
  "programName": "Updated Program",
  "signupUrl": "https://example.com/updated",
  "programDescriptions": [
    "Updated description"
  ],
  "regionCodes": [
    "US"
  ],
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ]
}

Başarılı bir isteğe verilen örnek yanıtı aşağıda bulabilirsiniz:

{
  "name": "accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/my-rewards",
  "programName": "Updated Program",
  "tiers": [
    {
      "tierName": "Gold Tier",
      "tierLabel": "gold",
      "tierBenefits": [
        {
          "otherBenefit": "Free shipping"
        }
      ],
      "requirements": {
        "freeToJoin": true
      }
    }
  ],
  "programDescriptions": [
    "Updated description"
  ],
  "signupUrl": "https://example.com/updated",
  "reviewResult": {
    "reviewStatus": "UNDER_REVIEW"
  },
  "regionCodes": [
    "US"
  ]
}

Bağlılık programını silme

Hesabınızdan bir bağlılık programını silmek için loyaltyPrograms.delete yöntemini kullanın.

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

HTTP

DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/programs/loyalty/loyaltyPrograms/{PROGRAM_LABEL}

Başarılı olursa yanıt gövdesi boş olur.

Sonraki adımlar

• Google Arama'da organik kişiselleştirme için tek tek alışveriş yapan kullanıcıları bağlılık programı katmanlarınızla ilişkilendirmek istiyorsanız Bağlılık Müşteri Eşleştirme Hizmeti kılavuzuna bakın.
• Hesabınız için alışveriş programlarını etkinleştirmek veya devre dışı bırakmak istiyorsanız Programlar alt API kılavuzuna bakın.
• İşletme kurulumu ayrıntıları, editoryal politikalar ve raporlama hakkında bilgi edinmek için Merchant Center Yardım Merkezi'ndeki Satıcı bağlılık programı hakkında başlıklı makaleyi inceleyin.
• API yöntemlerini ve kaynak tanımlarını incelemek için Merchant API referansına bakın.